@bluemarblepayroll/short-term-memory
v1.0.0
Published
Isomorphic Session Storage
Downloads
1
Readme
Short Term Memory
Isomorphic Session Storage
Very small library that places a layer of abstraction over the browsers built in Session Storage API. This means you can program to this library and it will ensure you do not make any hard links between your application and the browser. When this is ran outside of a browser then it will polyfill the storage with an in-memory key-value store.
Note that this library only deals with short-lived storage (Session Storage) and does not currently deal with longer term storage (i.e. Local Storage).
Installation
This library could be consumed as either a pure TypeScript library or as its trans-compiled ES2015 JavaScript counterpart.
To install through NPM:
npm install --save @bluemarblepayroll/short-term-memory
To install through Yarn:
yarn add @bluemarblepayroll/short-term-memory
Examples
The Store API is meant to implement the main SessionStorage API methods:
- getItem
- setItem
- removeItem
- clear
The other methods, such as key and length, were purposely omitted from the initial implementation. These methods can be added later should the need arise.
Storing & Retrieving Values
import StorageManager from "@bluemarblepayroll/short-term-memory";
StorageManager.setItem('Iron Man', 'Tony Stark');
let ironMansName = StorageManager.getItem('Iron Man'); // returns 'Tony Stark'
Removing Values
import StorageManager from "@bluemarblepayroll/short-term-memory";
StorageManager.setItem('Iron Man', 'Tony Stark');
StorageManager.removeItem('Iron Man');
let ironMansName = StorageManager.getItem('Iron Man'); // returns null
Clearing
import StorageManager from "@bluemarblepayroll/short-term-memory";
StorageManager.setItem('Iron Man', 'Tony Stark');
StorageManager.setItem('Hulk', 'Bruce Banner');
StorageManager.clear();
let ironMansName = StorageManager.getItem('Iron Man'); // returns null
let hulksName = StorageManager.getItem('Hulk'); // returns null
Contributing
Development Environment Configuration
Basic steps to take to get this repository compiling:
- Install Node.js (check package.json for versions supported.)
- Install Yarn package manager:
npm install -g yarn
- Clone the repository:
git clone [email protected]:bluemarblepayroll/short-term-memory.git
- Navigate to the root folder:
cd short-term-memory
- Install dependencies:
yarn
Compiling
To compile the TypeScript source down to native JavaScript, run:
yarn run build
Running Tests
To execute the test suite run:
yarn run test
Linting
yarn run lint
Publishing
Note: ensure you have proper authorization before trying to publish new versions.
After code changes have successfully gone through the Pull Request review process then the following steps should be followed for publishing new versions:
- Merge Pull Request into master
- Update package.json version number
- Update CHANGELOG.md
- Push master to remote and ensure CI builds master successfully
- Build the project locally:
yarn run build
- Perform a dry run:
npm publish --access public --dry-run
. Inspect packaging, ensure all files (including dist) are included. - Publish package to NPM:
npm publish --access public
- Tag master with new version:
git tag <version>
- Push tags remotely:
git push origin --tags
License
This project is MIT Licensed.