@webkrafters/universal-storage
TypeScript icon, indicating that this package has built-in type declarations

0.0.997 • Public • Published

Universal Storage

A persistent client-server coordinated storage based on client domain cookies with a local-storage fallback.

Name:

@webkrafters/universal-storage

Installation

npm install --save @webkrafters/universal-storage

Usage

In client-side code.

import { discardClientStorage, getClientStorage } from '@webkrafters/universal-storage';

let storage = getClientStorage(); // establishes a client storage singleton

storage.current.setItem( 'key', 'value' );
storage.current.getItem( 'key' ); // 'value'
storage.current.removeItem( 'key' );

storage.current.getItem( 'key' ); // undefined
storage.current.setItem( 'key', 'value2' );
storage.current.getItem( 'key' ); // 'value2'

discardClientStorage(); // destroys the current client storage singleton

storage.current.getItem( 'key' ); // error! cannot read getItem of undefined; reading 'storage.current'

storage = getClientStorage(); // reestablishes a client storage singleton

storage.current.getItem( 'key' ); // 'value2' 

In server-side code.

import { discardServerStorage, getServerStorage } from '@webkrafters/universal-storage';

let storage = getServerStorage(); // establishes a client storage singleton

storage.current.setItem( 'key', 'value', e.response );
storage.current.getItem( 'key', e.request ); // 'value'
storage.current.removeItem( 'key', 'value', e.response );

storage.current.getItem( 'key', e.request ); // undefined
storage.current.setItem( 'key', 'value2', e.response );
storage.current.getItem( 'key', e.request ); // 'value2'

discardServerStorage(); // destroys the current client storage singleton

storage.current.getItem( 'key', e.request ); // error! cannot read getItem of undefined; reading 'storage.current'

storage = getServerStorage(); // reestablishes a client storage singleton

storage.current.getItem( 'key', e.request ); // 'value2' 

License

MIT

Package Sidebar

Install

npm i @webkrafters/universal-storage

Weekly Downloads

46

Version

0.0.997

License

MIT

Unpacked Size

30.5 kB

Total Files

16

Last publish

Collaborators

  • webkrafters