@bizjournals/js-storage 0.1.1 → 0.2.0

package/lib/storage.js

@@ -0,0 +1 @@
+const store={supported:null};class StorageAbstract{constructor(options={}){this.namespace=options.namespace||"bizj",this.expires=options.expires||3600,this.namespace=this.namespace.toLowerCase(),this.storage={}}getItem(key,parse=!0){let response;if(this.isSupported()&&!this.isItemExpired(key)){try{if(response=this.storage.getItem(this.namespaceKey(key)),null===response)return;response=parse?this.parser(response):response}catch(e){}return response}}parser(data){try{"string"==typeof data&&(data=JSON.parse(data))}catch(e){}return data}translator(value){return"string"==typeof value?value:JSON.stringify(value)}setItem(key,value,expires=!0){if(!this.isSupported())return;const generatedKey=this.namespaceKey(key);try{this.storage.setItem(generatedKey,this.translator(value)),expires&&this.storage.setItem(this.expirationKey(key),String(this.timestamp(this.expires)))}catch(e){}}removeItem(key){if(this.isSupported())try{this.storage.removeItem(this.namespaceKey(key)),this.storage.removeItem(this.expirationKey(key))}catch(e){}}clear(){try{this.storage.clear()}catch(e){}}hasItem(key){return void 0!==this.getItem(key,!1)}timestamp(offset=0){return Math.ceil(Date.now()/1e3)+offset}namespaceKey(key){if("string"!=typeof key)throw new Error("A key must be provided to obtain data from the store.");return 0===key.indexOf(`${this.namespace}.`)&&(key=key.slice(this.namespace.length+1)),`${this.namespace}.${key.toLowerCase()}`}expirationKey(key){return`${this.namespaceKey(key)}.expires`}isItemExpired(key){if(!this.isSupported())return!1;try{let value=this.storage.getItem(this.expirationKey(key));if("string"==typeof value&&value.length>0){if(parseInt(value,10)-this.timestamp()<=0)return this.removeItem(key),!0}}catch(e){}return!1}isSupported(){if("boolean"==typeof store.supported)return store.supported;const test="biz.storage.test";try{this.storage.setItem(test,"1"),this.storage.removeItem(test),store.supported=!0}catch(e){store.supported=e instanceof DOMException&&(22===e.code||1014===e.code||"QuotaExceededError"===e.name||"NS_ERROR_DOM_QUOTA_REACHED"===e.name)&&this.storage&&0!==this.storage.length}return store.supported}}class LocalStorage extends StorageAbstract{constructor(options={}){super(options),this.storage=window.localStorage}}class SessionStorage extends StorageAbstract{constructor(options){super(options),this.storage=window.sessionStorage}}class StorageReference{constructor(cacheKey,storageSystem){if("string"!=typeof cacheKey||!(storageSystem instanceof StorageAbstract))throw new Error("Invalid construction of cache system. Please refer to documentation.");this.cacheKey=cacheKey,this.storageSystem=storageSystem}obtain(){return this.storageSystem.getItem(this.cacheKey)}bust(){this.storageSystem.removeItem(this.cacheKey)}saveAs(data){return data&&this.storageSystem.setItem(this.cacheKey,data),this}}export{LocalStorage,SessionStorage,StorageReference};

package/lib/storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.js","sources":["../src/abstract/constants/index.js","../src/abstract/exceptions/index.js","../src/abstract/store/index.js","../src/abstract/index.js","../src/local/index.js","../src/session/index.js","../src/reference/exceptions/index.js","../src/reference/index.js"],"sourcesContent":["export const DEFAULT_EXPIRATION = 3600;\nexport const DEFAULT_NAMESPACE = 'bizj';\nexport const EXPIRES_KEY_SUFFIX = 'expires';","export const KEY_IS_REQUIRED_TO_FETCH_DATA = 'A key must be provided to obtain data from the store.';\n","/**\n * The data store for global variables\n *\n */\nconst store = {\n  supported: null,\n}\n\n// --\nexport default store;","import { DEFAULT_EXPIRATION, DEFAULT_NAMESPACE, EXPIRES_KEY_SUFFIX } from './constants';\nimport { KEY_IS_REQUIRED_TO_FETCH_DATA } from './exceptions';\nimport store from './store';\n\n/*\n|--------------------------------------------------------------------------\n| Storage Abstract / Contract\n|--------------------------------------------------------------------------\n|\n| This is the base storage class that is extended for localStorage and\n| sessionStorage. In time we may look to use this for InnoDB as well.\n|\n|\n*/\nexport default class StorageAbstract {\n    /**\n     * Constructor takes in options for namespace and expiration.\n     * Session storage is the default storage type.\n     *\n     * @param {object} options\n     * @constructor\n     */\n    constructor (options = {}) {\n        this.namespace = options.namespace || DEFAULT_NAMESPACE;\n        this.expires = options.expires || DEFAULT_EXPIRATION;\n\n        this.namespace = this.namespace.toLowerCase();\n\n        this.storage = {};\n    }\n\n    /**\n     * Gets an item from storage and runs the parser unless explicitly\n     * disabled in the method request.\n     *\n     * @param {String} key\n     * @param {Boolean} parse\n     * @returns {(Array|Number|Object|String|Null)}\n     */\n    getItem (key, parse = true) {\n        let response;\n\n        if (! this.isSupported() || this.isItemExpired(key)) {\n            return undefined;\n        }\n\n        try {\n            response = this.storage.getItem(this.namespaceKey(key));\n\n            if (response === null) return undefined;\n\n            response = parse ? this.parser(response) : response;\n        } catch (e) {\n            // fall through\n        }\n\n        return response;\n    }\n\n    /**\n     * Parses the data returned from the storage system\n     *\n     * @param data\n     * @returns {*}\n     */\n    parser (data) {\n        try {\n            if (typeof data === 'string') {\n                data = JSON.parse(data);\n            }\n        } catch (e) {\n            // fall through\n        }\n\n        return data;\n    }\n\n    /**\n     * Translates the data before setting to the storage system\n     *\n     * @param value\n     * @returns {any}\n     */\n    translator (value) {\n        return typeof value === 'string' ? value : JSON.stringify(value);\n    }\n\n    /**\n     * Sets an item in the storage system.\n     *\n     * @param {string} key\n     * @param {(array|object|number|string)} value\n     * @param {boolean} expires\n     */\n    setItem (key, value, expires = true) {\n        if (! this.isSupported()) {\n            return;\n        }\n\n        const generatedKey = this.namespaceKey(key);\n\n        try {\n            this.storage.setItem(generatedKey, this.translator(value));\n\n            if (expires) {\n                this.storage.setItem(\n                    this.expirationKey(key),\n                    String(this.timestamp(this.expires)),\n                );\n            }\n        } catch (e) {\n            // fall through\n        }\n    }\n\n    /**\n     * Removes an item from the storage system.\n     *\n     * @param {string} key\n     */\n    removeItem (key) {\n        if (! this.isSupported()) {\n            return;\n        }\n\n        try {\n            this.storage.removeItem(this.namespaceKey(key));\n            this.storage.removeItem(this.expirationKey(key));\n        } catch (e) {\n            // fall through\n        }\n    }\n\n    /**\n     * Clears all items from storage.\n     */\n    clear () {\n        try {\n            this.storage.clear();\n        } catch (e) {\n            // fall through\n        }\n    }\n\n    /**\n     * Checks to see if an item exists in local storage.\n     *\n     * @param {string} key\n     * @returns {boolean}\n     */\n    hasItem (key) {\n        return this.getItem(key, false) !== undefined;\n    }\n\n    /**\n     * Calculates the expires for an item.\n     *\n     * @param {number} offset\n     * @returns {number}\n     */\n    timestamp (offset = 0) {\n        return Math.ceil(Date.now() / 1000) + offset;\n    }\n\n    /**\n     * Creates the key used for storing information in the storage\n     *\n     * @param {string} key\n     * @returns {string}\n     */\n    namespaceKey (key) {\n        if (typeof key !== 'string') {\n            throw new Error(KEY_IS_REQUIRED_TO_FETCH_DATA);\n        }\n\n        if (key.indexOf(`${ this.namespace }.`) === 0) {\n            key = key.slice(this.namespace.length + 1);\n        }\n\n        return `${ this.namespace }.${ key.toLowerCase() }`;\n    }\n\n    /**\n     * Creates the expires key used for testing storage usage\n     *\n     * @returns {string}\n     */\n    expirationKey (key) {\n        return `${ this.namespaceKey(key) }.${ EXPIRES_KEY_SUFFIX }`;\n    }\n\n    /**\n     * Checks to see if an item is expired and removes it if so.\n     *\n     * @param {string} key\n     * @returns {boolean}\n     */\n    isItemExpired (key) {\n        if (! this.isSupported()) {\n            return false;\n        }\n\n        try {\n            let value = this.storage.getItem(this.expirationKey(key));\n\n            if (typeof value === 'string' && value.length > 0) {\n                let expires = parseInt(value, 10);\n\n                if (expires - this.timestamp() <= 0) {\n                    this.removeItem(key);\n                    return true;\n                }\n            }\n        } catch (e) {\n            // fall through\n        }\n\n        return false;\n    }\n\n    /**\n     * Checks to see if the storage system is supported\n     *\n     * @returns {boolean}\n     */\n    isSupported () {\n        if (typeof store.supported === 'boolean') {\n            return store.supported;\n        }\n\n        const test = 'biz.storage.test';\n\n        try {\n            this.storage.setItem(test, '1');\n            this.storage.removeItem(test);\n\n            store.supported = true;\n        } catch (e) {\n            store.supported = e instanceof DOMException && (\n                // everything except Firefox\n                e.code === 22 ||\n                // Firefox\n                e.code === 1014 ||\n                // test name field too, because code might not be present\n                // everything except Firefox\n                e.name === 'QuotaExceededError' ||\n                // Firefox\n                e.name === 'NS_ERROR_DOM_QUOTA_REACHED'\n            ) && (this.storage && this.storage.length !== 0);\n        }\n\n        return store.supported;\n    }\n}\n","import StorageAbstract from \"../abstract\";\n\n/*\n|--------------------------------------------------------------------------\n| Local Storage\n|--------------------------------------------------------------------------\n| This is the base class for hooking into local storage. There isn't much\n| overlap here if you just keep instantiating, so there isn't much need\n| to singleton this.\n|\n|\n*/\nexport default class LocalStorage extends StorageAbstract {\n    /**\n     * Create a local storage adapter.\n     *\n     * @param {object} [options]\n     */\n    constructor(options = {}) {\n        super(options);\n\n        this.storage = window.localStorage;\n    }\n}\n","import StorageAbstract from \"../abstract\";\n\n/*\n|--------------------------------------------------------------------------\n| Session Storage\n|--------------------------------------------------------------------------\n| This is the base class for hooking into session storage. There isn't much\n| overlap here if you just keep instantiating, so there isn't much need\n| to singleton this.\n|\n|\n*/\nexport default class SessionStorage extends StorageAbstract {\n    /**\n     * Create a session storage adapter.\n     *\n     * @param {object} [options]\n     */\n    constructor(options) {\n        super(options);\n\n        this.storage = window.sessionStorage;\n    }\n}\n","export const INVALID_CONSTRUCTOR_PARAMETERS = 'Invalid construction of cache system. Please refer to documentation.';\n","import StorageAbstract from \"../abstract\";\nimport { INVALID_CONSTRUCTOR_PARAMETERS } from \"./exceptions\";\n\n/*\n|--------------------------------------------------------------------------\n| Storage Reference\n|--------------------------------------------------------------------------\n| This is a reference to something in storage. Each item has a key\n| belonging to a specific storage system. These storage systems have a\n| common abstract / contract that gives them the same expected pattern.\n| This is the adapter.\n|\n|\n*/\nexport default class StorageReference {\n    /**\n     * Creates an instance of a StorageReference system, which needs a cacheKey and\n     * a Storage system (StorageAbstract).\n     *\n     * @param {string} cacheKey\n     * @param {StorageAbstract} storageSystem\n     * @constructor\n     * @return {StorageReference}\n     */\n    constructor(cacheKey, storageSystem) {\n        if (typeof cacheKey !== \"string\" || !(storageSystem instanceof StorageAbstract)) {\n            throw new Error(INVALID_CONSTRUCTOR_PARAMETERS);\n        }\n\n        this.cacheKey = cacheKey;\n        this.storageSystem = storageSystem;\n    }\n\n    /**\n     * Pulls data from the local store or cached resource.\n     *\n     * @returns {*}\n     */\n    obtain() {\n        return this.storageSystem.getItem(this.cacheKey);\n    }\n\n    /**\n     * Destroys the cache reference with the cache key\n     *\n     * @returns {void}\n     */\n    bust() {\n        this.storageSystem.removeItem(this.cacheKey);\n    }\n\n    /**\n     * Saves the locally stored cache to the caching system. This is\n     * differed via a Promise because the timing of this can be\n     * performed asynchronously.\n     *\n     * @param data\n     * @returns {StorageReference}\n     */\n    saveAs(data) {\n        if (data) {\n            this.storageSystem.setItem(this.cacheKey, data);\n        }\n\n        return this;\n    }\n}\n"],"names":["DEFAULT_EXPIRATION","DEFAULT_NAMESPACE","EXPIRES_KEY_SUFFIX","KEY_IS_REQUIRED_TO_FETCH_DATA","store","supported","StorageAbstract","constructor","options","namespace","expires","toLowerCase","storage","getItem","key","parse","response","isSupported","isItemExpired","undefined","namespaceKey","parser","e","data","JSON","translator","value","stringify","setItem","generatedKey","expirationKey","String","timestamp","removeItem","clear","hasItem","offset","Math","ceil","Date","now","Error","indexOf","slice","length","parseInt","test","DOMException","code","name","LocalStorage","window","localStorage","SessionStorage","sessionStorage","INVALID_CONSTRUCTOR_PARAMETERS","StorageReference","cacheKey","storageSystem","obtain","bust","saveAs"],"mappings":"AAAO,MAAMA,kBAAkB,GAAG,IAA3B;AACA,MAAMC,iBAAiB,GAAG,MAA1B;AACA,MAAMC,kBAAkB,GAAG,SAA3B;;ACFA,MAAMC,6BAA6B,GAAG,uDAAtC;;ACAP;;;;AAIA,MAAMC,KAAK,GAAG;AACZC,EAAAA,SAAS,EAAE;AADC,CAAd;;ACAA;;;;;;;;;;;AAUe,MAAMC,eAAN,CAAsB;AACjC;;;;;;;AAOAC,EAAAA,WAAW,CAAEC,OAAO,GAAG,EAAZ,EAAgB;AACvB,SAAKC,SAAL,GAAiBD,OAAO,CAACC,SAAR,IAAqBR,iBAAtC;AACA,SAAKS,OAAL,GAAeF,OAAO,CAACE,OAAR,IAAmBV,kBAAlC;AAEA,SAAKS,SAAL,GAAiB,KAAKA,SAAL,CAAeE,WAAf,EAAjB;AAEA,SAAKC,OAAL,GAAe,EAAf;AACH;AAED;;;;;;;;;;AAQAC,EAAAA,OAAO,CAAEC,GAAF,EAAOC,KAAK,GAAG,IAAf,EAAqB;AACxB,QAAIC,QAAJ;;AAEA,QAAI,CAAE,KAAKC,WAAL,EAAF,IAAwB,KAAKC,aAAL,CAAmBJ,GAAnB,CAA5B,EAAqD;AACjD,aAAOK,SAAP;AACH;;AAED,QAAI;AACAH,MAAAA,QAAQ,GAAG,KAAKJ,OAAL,CAAaC,OAAb,CAAqB,KAAKO,YAAL,CAAkBN,GAAlB,CAArB,CAAX;AAEA,UAAIE,QAAQ,KAAK,IAAjB,EAAuB,OAAOG,SAAP;AAEvBH,MAAAA,QAAQ,GAAGD,KAAK,GAAG,KAAKM,MAAL,CAAYL,QAAZ,CAAH,GAA2BA,QAA3C;AACH,KAND,CAME,OAAOM,CAAP,EAAU;AAEX;;AAED,WAAON,QAAP;AACH;AAED;;;;;;;;AAMAK,EAAAA,MAAM,CAAEE,IAAF,EAAQ;AACV,QAAI;AACA,UAAI,OAAOA,IAAP,KAAgB,QAApB,EAA8B;AAC1BA,QAAAA,IAAI,GAAGC,IAAI,CAACT,KAAL,CAAWQ,IAAX,CAAP;AACH;AACJ,KAJD,CAIE,OAAOD,CAAP,EAAU;AAEX;;AAED,WAAOC,IAAP;AACH;AAED;;;;;;;;AAMAE,EAAAA,UAAU,CAAEC,KAAF,EAAS;AACf,WAAO,OAAOA,KAAP,KAAiB,QAAjB,GAA4BA,KAA5B,GAAoCF,IAAI,CAACG,SAAL,CAAeD,KAAf,CAA3C;AACH;AAED;;;;;;;;;AAOAE,EAAAA,OAAO,CAAEd,GAAF,EAAOY,KAAP,EAAchB,OAAO,GAAG,IAAxB,EAA8B;AACjC,QAAI,CAAE,KAAKO,WAAL,EAAN,EAA0B;AACtB;AACH;;AAED,UAAMY,YAAY,GAAG,KAAKT,YAAL,CAAkBN,GAAlB,CAArB;;AAEA,QAAI;AACA,WAAKF,OAAL,CAAagB,OAAb,CAAqBC,YAArB,EAAmC,KAAKJ,UAAL,CAAgBC,KAAhB,CAAnC;;AAEA,UAAIhB,OAAJ,EAAa;AACT,aAAKE,OAAL,CAAagB,OAAb,CACI,KAAKE,aAAL,CAAmBhB,GAAnB,CADJ,EAEIiB,MAAM,CAAC,KAAKC,SAAL,CAAe,KAAKtB,OAApB,CAAD,CAFV;AAIH;AACJ,KATD,CASE,OAAOY,CAAP,EAAU;AAEX;AACJ;AAED;;;;;;;AAKAW,EAAAA,UAAU,CAAEnB,GAAF,EAAO;AACb,QAAI,CAAE,KAAKG,WAAL,EAAN,EAA0B;AACtB;AACH;;AAED,QAAI;AACA,WAAKL,OAAL,CAAaqB,UAAb,CAAwB,KAAKb,YAAL,CAAkBN,GAAlB,CAAxB;AACA,WAAKF,OAAL,CAAaqB,UAAb,CAAwB,KAAKH,aAAL,CAAmBhB,GAAnB,CAAxB;AACH,KAHD,CAGE,OAAOQ,CAAP,EAAU;AAEX;AACJ;AAED;;;;;AAGAY,EAAAA,KAAK,GAAI;AACL,QAAI;AACA,WAAKtB,OAAL,CAAasB,KAAb;AACH,KAFD,CAEE,OAAOZ,CAAP,EAAU;AAEX;AACJ;AAED;;;;;;;;AAMAa,EAAAA,OAAO,CAAErB,GAAF,EAAO;AACV,WAAO,KAAKD,OAAL,CAAaC,GAAb,EAAkB,KAAlB,MAA6BK,SAApC;AACH;AAED;;;;;;;;AAMAa,EAAAA,SAAS,CAAEI,MAAM,GAAG,CAAX,EAAc;AACnB,WAAOC,IAAI,CAACC,IAAL,CAAUC,IAAI,CAACC,GAAL,KAAa,IAAvB,IAA+BJ,MAAtC;AACH;AAED;;;;;;;;AAMAhB,EAAAA,YAAY,CAAEN,GAAF,EAAO;AACf,QAAI,OAAOA,GAAP,KAAe,QAAnB,EAA6B;AACzB,YAAM,IAAI2B,KAAJ,CAAUtC,6BAAV,CAAN;AACH;;AAED,QAAIW,GAAG,CAAC4B,OAAJ,CAAa,GAAG,KAAKjC,SAAW,GAAhC,MAAwC,CAA5C,EAA+C;AAC3CK,MAAAA,GAAG,GAAGA,GAAG,CAAC6B,KAAJ,CAAU,KAAKlC,SAAL,CAAemC,MAAf,GAAwB,CAAlC,CAAN;AACH;;AAED,WAAQ,GAAG,KAAKnC,SAAW,IAAIK,GAAG,CAACH,WAAJ,EAAmB,EAAlD;AACH;AAED;;;;;;;AAKAmB,EAAAA,aAAa,CAAEhB,GAAF,EAAO;AAChB,WAAQ,GAAG,KAAKM,YAAL,CAAkBN,GAAlB,CAAwB,IAAIZ,kBAAoB,EAA3D;AACH;AAED;;;;;;;;AAMAgB,EAAAA,aAAa,CAAEJ,GAAF,EAAO;AAChB,QAAI,CAAE,KAAKG,WAAL,EAAN,EAA0B;AACtB,aAAO,KAAP;AACH;;AAED,QAAI;AACA,UAAIS,KAAK,GAAG,KAAKd,OAAL,CAAaC,OAAb,CAAqB,KAAKiB,aAAL,CAAmBhB,GAAnB,CAArB,CAAZ;;AAEA,UAAI,OAAOY,KAAP,KAAiB,QAAjB,IAA6BA,KAAK,CAACkB,MAAN,GAAe,CAAhD,EAAmD;AAC/C,YAAIlC,OAAO,GAAGmC,QAAQ,CAACnB,KAAD,EAAQ,EAAR,CAAtB;;AAEA,YAAIhB,OAAO,GAAG,KAAKsB,SAAL,EAAV,IAA8B,CAAlC,EAAqC;AACjC,eAAKC,UAAL,CAAgBnB,GAAhB;AACA,iBAAO,IAAP;AACH;AACJ;AACJ,KAXD,CAWE,OAAOQ,CAAP,EAAU;AAEX;;AAED,WAAO,KAAP;AACH;AAED;;;;;;;AAKAL,EAAAA,WAAW,GAAI;AACX,QAAI,OAAOb,KAAK,CAACC,SAAb,KAA2B,SAA/B,EAA0C;AACtC,aAAOD,KAAK,CAACC,SAAb;AACH;;AAED,UAAMyC,IAAI,GAAG,kBAAb;;AAEA,QAAI;AACA,WAAKlC,OAAL,CAAagB,OAAb,CAAqBkB,IAArB,EAA2B,GAA3B;AACA,WAAKlC,OAAL,CAAaqB,UAAb,CAAwBa,IAAxB;AAEA1C,MAAAA,KAAK,CAACC,SAAN,GAAkB,IAAlB;AACH,KALD,CAKE,OAAOiB,CAAP,EAAU;AACRlB,MAAAA,KAAK,CAACC,SAAN,GAAkBiB,CAAC,YAAYyB,YAAb;AAEdzB,MAAAA,CAAC,CAAC0B,IAAF,KAAW,EAAX;AAEA1B,MAAAA,CAAC,CAAC0B,IAAF,KAAW,IAFX;AAIA;AACA1B,MAAAA,CAAC,CAAC2B,IAAF,KAAW,oBALX;AAOA3B,MAAAA,CAAC,CAAC2B,IAAF,KAAW,4BATG,KAUZ,KAAKrC,OAAL,IAAgB,KAAKA,OAAL,CAAagC,MAAb,KAAwB,CAV9C;AAWH;;AAED,WAAOxC,KAAK,CAACC,SAAb;AACH;;AA9OgC;;ACZrC;;;;;;;;;;;AAUe,MAAM6C,YAAN,SAA2B5C,eAA3B,CAA2C;AACtD;;;;;AAKAC,EAAAA,WAAW,CAACC,OAAO,GAAG,EAAX,EAAe;AACtB,UAAMA,OAAN;AAEA,SAAKI,OAAL,GAAeuC,MAAM,CAACC,YAAtB;AACH;;AAVqD;;ACV1D;;;;;;;;;;;AAUe,MAAMC,cAAN,SAA6B/C,eAA7B,CAA6C;AACxD;;;;;AAKAC,EAAAA,WAAW,CAACC,OAAD,EAAU;AACjB,UAAMA,OAAN;AAEA,SAAKI,OAAL,GAAeuC,MAAM,CAACG,cAAtB;AACH;;AAVuD;;ACZrD,MAAMC,8BAA8B,GAAG,sEAAvC;;ACGP;;;;;;;;;;;;AAWe,MAAMC,gBAAN,CAAuB;AAClC;;;;;;;;;AASAjD,EAAAA,WAAW,CAACkD,QAAD,EAAWC,aAAX,EAA0B;AACjC,QAAI,OAAOD,QAAP,KAAoB,QAApB,IAAgC,EAAEC,aAAa,YAAYpD,eAA3B,CAApC,EAAiF;AAC7E,YAAM,IAAImC,KAAJ,CAAUc,8BAAV,CAAN;AACH;;AAED,SAAKE,QAAL,GAAgBA,QAAhB;AACA,SAAKC,aAAL,GAAqBA,aAArB;AACH;AAED;;;;;;;AAKAC,EAAAA,MAAM,GAAG;AACL,WAAO,KAAKD,aAAL,CAAmB7C,OAAnB,CAA2B,KAAK4C,QAAhC,CAAP;AACH;AAED;;;;;;;AAKAG,EAAAA,IAAI,GAAG;AACH,SAAKF,aAAL,CAAmBzB,UAAnB,CAA8B,KAAKwB,QAAnC;AACH;AAED;;;;;;;;;;AAQAI,EAAAA,MAAM,CAACtC,IAAD,EAAO;AACT,QAAIA,IAAJ,EAAU;AACN,WAAKmC,aAAL,CAAmB9B,OAAnB,CAA2B,KAAK6B,QAAhC,EAA0ClC,IAA1C;AACH;;AAED,WAAO,IAAP;AACH;;AAnDiC;;;;"}

package/package.json

@@ -1,25 +1,40 @@
 {
-    "name": "@bizjournals/js-storage",
-    "version": "0.1.1",
-    "description": "ACBJ javascript storage classes",
-    "repository": {
-        "git": "https://gitlab.bizjournals.com/bizjournals/js-storage"
-    },
-    "main": "main.js",
-    "type": "module",
-    "sideEffects": false,
-    "scripts": {
-        "test": "jest",
-        "preversion": "npm test",
-        "postversion": "git push && git push --tags && npm publish"
-    },
-    "keywords": [],
-    "author": "DPD",
-    "license": "UNLICENSED",
-    "devDependencies": {
-        "@babel/preset-env": "^7.10.3",
-        "babel-jest": "^25.4.0",
-        "jest": "^25.4.0"
-    },
-    "dependencies": {}
+  "name": "@bizjournals/js-storage",
+  "version": "0.2.0",
+  "description": "ACBJ javascript storage classes",
+  "repository": {
+    "git": "https://gitlab.bizjournals.com/bizjournals/js-storage"
+  },
+  "main": "lib/storage.js",
+  "sideEffects": false,
+  "files": [
+    "lib/**"
+  ],
+  "scripts": {
+    "test": "jest",
+    "dev": "npm-run-all --parallel link watch",
+    "link": "npm link",
+    "build": "rollup -c",
+    "watch": "rollup -c -w",
+    "preversion": "npm test",
+    "version": "npm run build",
+    "postversion": "git push && git push --tags && npm publish"
+  },
+  "keywords": [],
+  "author": "DPD",
+  "license": "UNLICENSED",
+  "devDependencies": {
+    "@babel/preset-env": "^7.10.3",
+    "@rollup/plugin-babel": "^5.3.0",
+    "@rollup/plugin-commonjs": "^17.0.0",
+    "@rollup/plugin-node-resolve": "^11.1.0",
+    "babel-jest": "^25.4.0",
+    "jest": "^25.4.0",
+    "npm-run-all": "^4.1.5",
+    "rollup": "^2.36.2",
+    "rollup-plugin-delete": "^2.0.0",
+    "rollup-plugin-terser": "^7.0.2",
+    "serve": "^11.3.2"
+  },
+  "dependencies": {}
 }

package/.gitlab-ci.yml

@@ -1,15 +0,0 @@
-npmrunner:
-  tags:
-    - php73
-  script:
-    - date
-    - node --version
-    - npm --version
-    - rm -f .npmrc
-    - mv build/.npmrc .npmrc
-    - npm install --loglevel=error
-    - npm test
-    - rm -rf node_modules
-    - rm -f .npmrc
-  except:
-    - tags

package/babel.config.cjs

@@ -1,12 +0,0 @@
-module.exports = {
-    presets: [
-        [
-            "@babel/preset-env",
-            {
-                targets: {
-                    node: "current",
-                },
-            },
-        ],
-    ],
-};

package/jest.config.cjs

@@ -1,3 +0,0 @@
-module.exports = {
-    transformIgnorePatterns: ["/node_modules/(?!(@bizjournals))/"]
-};

package/lib/abstract/__mocks__/mock-storage.js

@@ -1,19 +0,0 @@
-let store = {};
-
-export default {
-    clear: jest.fn().mockImplementation(() => {
-        store = {};
-    }),
-
-    getItem: jest.fn().mockImplementation((key) => {
-        return store[key];
-    }),
-
-    setItem: jest.fn().mockImplementation((key, value) => {
-        store[key] = value;
-    }),
-
-    removeItem: jest.fn().mockImplementation((key) => {
-        delete store[key];
-    })
-};

package/lib/abstract/__tests__/storage.clear.spec.js

@@ -1,25 +0,0 @@
-import StorageAbstract from '../';
-
-describe('core:class >> storageabstract:clear', () => {
-    let storageAbstract;
-
-    beforeAll(() => {
-        storageAbstract = new StorageAbstract();
-    });
-
-    it('never fails or throws when storage is not set', () => {
-        delete storageAbstract.storage;
-        expect(() => {
-            storageAbstract.clear();
-        }).not.toThrow();
-    });
-
-    it('runs the clear method on the storage system when defined', () => {
-        storageAbstract.storage = {
-            clear: jest.fn()
-        };
-
-        storageAbstract.clear();
-        expect(storageAbstract.storage.clear).toHaveBeenCalledTimes(1);
-    });
-});

package/lib/abstract/__tests__/storage.constructor.spec.js

@@ -1,46 +0,0 @@
-import StorageAbstract from '../';
-import { DEFAULT_EXPIRATION, DEFAULT_NAMESPACE } from '../constants';
-
-describe('core:class >> storageabstract:constructor', () => {
-    it('defaults to constant as it\'s namespace when none provided', () => {
-        const storageAbstract = new StorageAbstract();
-        expect(storageAbstract.namespace).toMatch(DEFAULT_NAMESPACE);
-    });
-
-    it('accepts an object parameter with key namespace and sets it to this.namespace', () => {
-        const namespace = 'test';
-        const storageAbstract = new StorageAbstract({ namespace });
-        expect(storageAbstract.namespace).toMatch(namespace);
-    });
-
-    it('coercies the namespace to lower case before setting', () => {
-        const namespace = 'TeSt';
-        const storageAbstract = new StorageAbstract({ namespace });
-        expect(storageAbstract.namespace).toMatch(namespace.toLowerCase());
-    });
-
-    it('throws error when namespace provided is not a string', () => {
-        const namespaces = [true, {}, [], 12];
-        for (const namespace of namespaces) {
-            expect(() => {
-                new StorageAbstract({ namespace });
-            }).toThrow();
-        }
-    });
-
-    it('defaults to constant as it\'s expiration when none provided', () => {
-        const storageAbstract = new StorageAbstract();
-        expect(storageAbstract.expires).toEqual(DEFAULT_EXPIRATION);
-    });
-
-    it('accepts an object parameter with key expires and sets it to this.expires', () => {
-        const expires = 3600 * 4;
-        const storageAbstract = new StorageAbstract({ expires });
-        expect(storageAbstract.expires).toEqual(expires);
-    });
-
-    it('sets the storage to a default of null', () => {
-        const storageAbstract = new StorageAbstract();
-        expect(storageAbstract.storage).toEqual({});
-    });
-});

package/lib/abstract/__tests__/storage.expirationkey.spec.js

@@ -1,22 +0,0 @@
-import StorageAbstract from '../';
-import { EXPIRES_KEY_SUFFIX } from '../constants';
-
-describe('core:class >> storageabstract:namespacekey', () => {
-    let storageAbstract;
-
-    beforeEach(() => {
-        storageAbstract = new StorageAbstract();
-    });
-
-    it('calls the namespaceKey to generate the prefix', () => {
-        storageAbstract.namespaceKey = jest.fn();
-        storageAbstract.expirationKey('hey');
-        expect(storageAbstract.namespaceKey).toHaveBeenCalledTimes(1);
-    });
-
-    it('returns a concatenated variation of the namespace and string key', () => {
-        let key = 'key';
-        expect(storageAbstract.expirationKey(key))
-            .toEqual(`${ storageAbstract.namespaceKey(key) }.${ EXPIRES_KEY_SUFFIX }`);
-    });
-});

package/lib/abstract/__tests__/storage.getitem.spec.js

@@ -1,80 +0,0 @@
-import StorageAbstract from '../';
-
-describe('core:class >> storageabstract:getitem', () => {
-    let storageClassMock, mockStorage, key = 'test';
-
-    beforeAll(() => {
-        storageClassMock = new StorageAbstract();
-    });
-
-    beforeEach(() => {
-        storageClassMock.namespaceKey = jest.fn().mockImplementation(key => key);
-        storageClassMock.parser = jest.fn().mockImplementation(data => data);
-        storageClassMock.cache = jest.fn().mockImplementation(data => data);
-        storageClassMock.isSupported = jest.fn().mockImplementation(() => true);
-        storageClassMock.isItemExpired = jest.fn().mockImplementation(() => false);
-
-        mockStorage = {
-            getItem: jest.fn()
-        };
-
-        storageClassMock.storage = mockStorage;
-        StorageAbstract.supported = undefined;
-    });
-
-    it('returns undefined when it is not supported', () => {
-        storageClassMock.isSupported = jest.fn().mockImplementation(() => false);
-
-        expect(storageClassMock.getItem()).toEqual(undefined);
-        expect(storageClassMock.namespaceKey).not.toHaveBeenCalled();
-    });
-
-    it('returns undefined when the item is expired', () => {
-        storageClassMock.isItemExpired = jest.fn().mockImplementation(() => true);
-
-        expect(storageClassMock.getItem()).toEqual(undefined);
-        expect(storageClassMock.namespaceKey).not.toHaveBeenCalled();
-    });
-
-    it('calls `namespace` key to get a dynamically generated key', () => {
-        storageClassMock.namespaceKey = jest.fn().mockImplementation(() => {
-            throw new Error('Just a test fall through.');
-        });
-
-        storageClassMock.getItem();
-        expect(storageClassMock.namespaceKey).toHaveBeenCalledTimes(1);
-    });
-
-    it('calls getItem on the storage system when suspended data not available', () => {
-        storageClassMock.getItem(key);
-        expect(storageClassMock.storage.getItem).toHaveBeenCalledTimes(1);
-        expect(storageClassMock.storage.getItem).toHaveBeenCalledWith(key);
-    });
-
-    it('calls the `parser` method with the data fetched from suspend or getItem', () => {
-        const data = { hey: 'you' };
-
-        const localStorage = {
-            getItem: jest.fn().mockImplementation(() => data)
-        };
-
-        storageClassMock.storage = localStorage;
-
-        storageClassMock.getItem(key);
-        expect(storageClassMock.parser).toHaveBeenCalled();
-        expect(storageClassMock.parser).toHaveBeenCalledWith(data);
-    });
-
-    it('does not call the `parser` method with the data fetched from suspend or getItem', () => {
-        const data = { hey: 'you' };
-
-        const localStorage = {
-            getItem: jest.fn().mockImplementation(() => data)
-        };
-
-        storageClassMock.storage = localStorage;
-
-        storageClassMock.getItem(key, false);
-        expect(storageClassMock.parser).not.toHaveBeenCalled();
-    });
-});

package/lib/abstract/__tests__/storage.hasitem.spec.js

@@ -1,25 +0,0 @@
-import StorageAbstract from '../';
-
-describe('core:class >> storageabstract:hasitem', () => {
-    let storageClassMock, key = 'test';
-
-    beforeAll(() => {
-        storageClassMock = new StorageAbstract();
-    });
-
-    beforeEach(() => {
-        storageClassMock.getItem = jest.fn().mockImplementation(key => key);
-    });
-
-    it('calls getItem to fetch the item from the storage system', () => {
-        storageClassMock.hasItem(key);
-
-        expect(storageClassMock.getItem).toHaveBeenCalledTimes(1);
-    });
-
-    it('returns false when the obtained item is undefined', () => {
-        storageClassMock.getItem = jest.fn().mockImplementation(() => undefined);
-
-        expect(storageClassMock.hasItem(key)).toBeFalsy();
-    });
-});

package/lib/abstract/__tests__/storage.issupported.spec.js

@@ -1,36 +0,0 @@
-import StorageAbstract from '../';
-import mockStorage from '../__mocks__/mock-storage';
-import store from '../store';
-
-describe('core:class >> storageabstract:issupported', () => {
-    let storageAbstract;
-
-    beforeEach(() => {
-        storageAbstract = new StorageAbstract();
-        mockStorage.setItem.mockClear();
-        mockStorage.removeItem.mockClear();
-
-        storageAbstract.storage = mockStorage;
-        store.supported = undefined;
-    });
-
-    it('returns false when the storage system is defaulted', () => {
-        storageAbstract.storage = {};
-        expect(storageAbstract.isSupported()).toBeFalsy();
-    });
-
-    it('returns true when the storage system is valid and usable', () => {
-        storageAbstract.storage = mockStorage;
-        expect(storageAbstract.isSupported()).toBeTruthy();
-        expect(mockStorage.setItem).toHaveBeenCalledTimes(1);
-        expect(mockStorage.removeItem).toHaveBeenCalledTimes(1);
-    });
-
-    it('returns a stored answer once the storage system has been checked', () => {
-        storageAbstract.storage = mockStorage;
-        let isSupported = storageAbstract.isSupported();
-        isSupported = storageAbstract.isSupported();
-        expect(mockStorage.setItem).toHaveBeenCalledTimes(1);
-        expect(mockStorage.removeItem).toHaveBeenCalledTimes(1);
-    });
-});

package/lib/abstract/__tests__/storage.namespacekey.spec.js

@@ -1,54 +0,0 @@
-import StorageAbstract from '../';
-import { KEY_IS_REQUIRED_TO_FETCH_DATA } from '../exceptions';
-
-describe('core:class >> storageabstract:namespacekey', () => {
-    let storageAbstract;
-
-    beforeEach(() => {
-        storageAbstract = new StorageAbstract();
-    });
-
-    it('throws an exception when a non-string is passed', () => {
-        let keys = [true, [], {}, 1];
-        for (const key of keys) {
-            expect(() => {
-                storageAbstract.namespaceKey(key);
-            }).toThrow(KEY_IS_REQUIRED_TO_FETCH_DATA);
-        }
-    });
-
-    it('returns a concatenated variation of the namespace and string key', () => {
-        let key = 'key';
-        expect(storageAbstract.namespaceKey(key))
-            .toEqual(`${ storageAbstract.namespace }.${ key }`);
-    });
-
-    it('coerces the key to lower case before returning', () => {
-        let key = 'KEy';
-        expect(storageAbstract.namespaceKey(key))
-            .toEqual(`${ storageAbstract.namespace }.${ key.toLowerCase() }`);
-    });
-
-    it('extracts the namespace and key separator when present at the beginning of the string', () => {
-        const theRealKey = 'myrealkey';
-        let key = `${ storageAbstract.namespace }.${ theRealKey }`;
-        expect(storageAbstract.namespaceKey(key))
-            .toEqual(`${ storageAbstract.namespace }.${ theRealKey.toLowerCase() }`);
-    });
-
-    it('does not extract the namespace and key separator when present anywhere else in the string', () => {
-        const theRealKey = 'myrealkey';
-        let key = `a${ storageAbstract.namespace }.${ theRealKey }`;
-        expect(storageAbstract.namespaceKey(key))
-            .not.toEqual(`${ storageAbstract.namespace }.${ theRealKey.toLowerCase() }`);
-        expect(storageAbstract.namespaceKey(key))
-            .toEqual(`${ storageAbstract.namespace }.${ key.toLowerCase() }`);
-    });
-
-    it('does not extract the namespace when missing the key separator', () => {
-        const theRealKey = 'myrealkey';
-        let key = `${ storageAbstract.namespace }${ theRealKey }`;
-        expect(storageAbstract.namespaceKey(key))
-            .toEqual(`${ storageAbstract.namespace }.${ key.toLowerCase() }`);
-    });
-});

package/lib/abstract/__tests__/storage.parser.spec.js

@@ -1,40 +0,0 @@
-import StorageAbstract from '../';
-
-describe('core:class >> storageabstract:parser', () => {
-    let storageAbstract;
-    const copyParse = JSON.parse;
-    delete JSON.parse;
-
-    beforeEach(() => {
-        storageAbstract = new StorageAbstract();
-        JSON.parse = jest.fn();
-        JSON.parse.mockClear();
-    });
-
-    it('returns the raw data when not a string', () => {
-        const data = {
-            my: 'value'
-        };
-
-        expect(storageAbstract.parser(data)).toEqual(data);
-        expect(JSON.parse).not.toBeCalled();
-    });
-
-    it('attempts to parse the item when it is a string', () => {
-        const data = 'somestuff';
-
-        storageAbstract.parser(data);
-        expect(JSON.parse).toHaveBeenCalledTimes(1);
-    });
-
-    it('returns the provided string if it could not be JSON parsed', () => {
-        JSON.parse = copyParse;
-        let response;
-
-        expect(() => {
-            response = storageAbstract.parser('wowowow');
-        }).not.toThrow();
-
-        expect(response).toEqual('wowowow');
-    });
-});

package/lib/abstract/__tests__/storage.removeitem.spec.js

@@ -1,63 +0,0 @@
-import StorageAbstract from '../';
-
-import store from '../store';
-
-describe('core:class >> storageabstract:removeitem', () => {
-    let storageClassMock, mockStorage, key = 'test';
-
-    beforeAll(() => {
-        storageClassMock = new StorageAbstract();
-    });
-
-    beforeEach(() => {
-        storageClassMock.isSupported = jest.fn().mockImplementation(() => true);
-        storageClassMock.namespaceKey = jest.fn().mockImplementation(key => key);
-        storageClassMock.expirationKey = jest.fn().mockImplementation(key => `${key}.expires`);
-        storageClassMock.resetAttempts = jest.fn().mockImplementation(() => {
-            storageClassMock.attempts = 0;
-        });
-
-        mockStorage = {
-            removeItem: jest.fn()
-        };
-
-        storageClassMock.storage = mockStorage;
-        store.supported = undefined;
-    });
-
-    it('halts when it is not supported', () => {
-        storageClassMock.isSupported = jest.fn().mockImplementation(() => false);
-
-        storageClassMock.removeItem(key);
-
-        expect(storageClassMock.isSupported).toHaveBeenCalledTimes(1);
-        expect(storageClassMock.storage.removeItem).not.toHaveBeenCalled();
-    });
-
-    it('falls through when encountering an exception', () => {
-        store.supported = true;
-
-        const badStorage = {
-            removeItem: jest.fn().mockImplementation(() => {
-                throw new Error('testing code');
-            })
-        };
-
-        storageClassMock.storage = badStorage;
-
-        expect(() => {
-            storageClassMock.removeItem();
-        }).not.toThrow();
-
-        expect(storageClassMock.storage.removeItem).toHaveBeenCalledTimes(1);
-    });
-
-    it('removes both the item at namespace and expiration keys', () => {
-        store.supported = true;
-        storageClassMock.removeItem();
-
-        expect(storageClassMock.namespaceKey).toHaveBeenCalledTimes(1);
-        expect(storageClassMock.expirationKey).toHaveBeenCalledTimes(1);
-        expect(storageClassMock.storage.removeItem).toHaveBeenCalledTimes(2);
-    });
-});

package/lib/abstract/__tests__/storage.setitem.spec.js

@@ -1,75 +0,0 @@
-import StorageAbstract from '../';
-import store from '../store';
-
-describe('core:class >> storageabstract:setitem', () => {
-    let storageClassMock, mockStorage, key = 'test';
-
-    beforeAll(() => {
-        storageClassMock = new StorageAbstract();
-    });
-
-    beforeEach(() => {
-        storageClassMock.isSupported = jest.fn().mockImplementation(() => true);
-        storageClassMock.namespaceKey = jest.fn().mockImplementation(key => key);
-        storageClassMock.expirationKey = jest.fn().mockImplementation(key => key);
-        storageClassMock.translator = jest.fn().mockImplementation(data => data);
-        storageClassMock.timestamp = jest.fn().mockImplementation(() => 12345);
-        storageClassMock.cache = jest.fn().mockImplementation(data => data);
-        storageClassMock.clear = jest.fn().mockImplementation(() => storageClassMock);
-        storageClassMock.resetAttempts = jest.fn().mockImplementation(() => {
-            storageClassMock.attempts = 0;
-            return storageClassMock;
-        });
-
-        mockStorage = {
-            setItem: jest.fn()
-        };
-
-        storageClassMock.attempts = 0;
-        storageClassMock.storage = mockStorage;
-        store.supported = undefined;
-    });
-
-    it('resets the attempts and returns when it is not supported without continuing', () => {
-        storageClassMock.isSupported = jest.fn().mockImplementation(() => false);
-        storageClassMock.setItem();
-
-        expect(storageClassMock.isSupported).toHaveBeenCalledTimes(1);
-        expect(storageClassMock.namespaceKey).not.toHaveBeenCalled();
-        expect(mockStorage.setItem).not.toHaveBeenCalled();
-    });
-
-    it('uses a dynamically generated namespaceKey to set the item', () => {
-        storageClassMock.setItem(key, { data: true });
-        expect(storageClassMock.namespaceKey).toHaveBeenCalledTimes(1);
-    });
-
-    it('calls the translator prior to attempting to set the item', () => {
-        storageClassMock.translator = jest.fn().mockImplementation(() => {
-            throw new Error('testing script error');
-        });
-
-        storageClassMock.setItem(key, { data: true });
-        expect(storageClassMock.translator).toHaveBeenCalled();
-        expect(storageClassMock.storage.setItem).not.toHaveBeenCalled();
-    });
-
-    it('calls to set the item one time when not expiring', () => {
-        const data = { it: true };
-
-        storageClassMock.setItem(key, data, false);
-
-        expect(storageClassMock.storage.setItem).toHaveBeenCalledTimes(1);
-        expect(storageClassMock.storage.setItem).toHaveBeenCalledWith(key, data);
-        expect(storageClassMock.expirationKey).not.toHaveBeenCalled();
-    });
-
-    it('calls set item again with the expiration key if defaulted to expire', () => {
-        const data = { it: true };
-
-        storageClassMock.setItem(key, data);
-
-        expect(storageClassMock.storage.setItem).toHaveBeenCalledTimes(2);
-        expect(storageClassMock.expirationKey).toHaveBeenCalledTimes(1);
-    });
-});

package/lib/abstract/__tests__/storage.translator.spec.js

@@ -1,24 +0,0 @@
-import StorageAbstract from '../';
-
-describe('core:class >> storageabstract:translator', () => {
-    let storageAbstract;
-
-    beforeEach(() => {
-        storageAbstract = new StorageAbstract();
-    });
-
-    it('calls json stringify when passed an object', () => {
-        const data = {
-            my: 'value'
-        };
-
-        expect(storageAbstract.translator(data))
-            .toEqual(JSON.stringify(data));
-    });
-
-    it('returns a string back exactly as is', () => {
-        const data = 'somestuff';
-
-        expect(storageAbstract.translator(data)).toEqual(data);
-    });
-});

package/lib/abstract/constants/index.js

@@ -1,3 +0,0 @@
-export const DEFAULT_EXPIRATION = 3600;
-export const DEFAULT_NAMESPACE = 'bizj';
-export const EXPIRES_KEY_SUFFIX = 'expires';

package/lib/abstract/exceptions/index.js

@@ -1 +0,0 @@
-export const KEY_IS_REQUIRED_TO_FETCH_DATA = 'A key must be provided to obtain data from the store.';

package/lib/abstract/index.js

@@ -1,255 +0,0 @@
-import { DEFAULT_EXPIRATION, DEFAULT_NAMESPACE, EXPIRES_KEY_SUFFIX } from "./constants";
-import { KEY_IS_REQUIRED_TO_FETCH_DATA } from "./exceptions";
-import store from './store';
-
-/*
-|--------------------------------------------------------------------------
-| Storage Abstract / Contract
-|--------------------------------------------------------------------------
-|
-| This is the base storage class that is extended for localStorage and
-| sessionStorage. In time we may look to use this for InnoDB as well.
-|
-|
-*/
-export default class StorageAbstract {
-    /**
-     * Constructor takes in options for namespace and expiration.
-     * Session storage is the default storage type.
-     *
-     * @param {object} options
-     * @constructor
-     */
-    constructor (options = {}) {
-        this.namespace = options.namespace || DEFAULT_NAMESPACE;
-        this.expires = options.expires || DEFAULT_EXPIRATION;
-
-        this.namespace = this.namespace.toLowerCase();
-
-        this.storage = {};
-    }
-
-    /**
-     * Gets an item from storage and runs the parser unless explicitly
-     * disabled in the method request.
-     *
-     * @param {String} key
-     * @param {Boolean} parse
-     * @returns {(Array|Number|Object|String|Null)}
-     */
-    getItem (key, parse = true) {
-        let response;
-
-        if (!this.isSupported() || this.isItemExpired(key)) {
-            return response;
-        }
-
-        try {
-            response = this.storage.getItem(this.namespaceKey(key));
-
-            if (response === null) return undefined;
-
-            response = parse ? this.parser(response) : response;
-        } catch (e) {
-            // fall through
-        }
-
-        return response;
-    }
-
-    /**
-     * Parses the data returned from the storage system
-     *
-     * @param data
-     * @returns {*}
-     */
-    parser (data) {
-        try {
-            if (typeof data === "string") {
-                data = JSON.parse(data);
-            }
-        } catch (e) {
-            // fall through
-        }
-
-        return data;
-    }
-
-    /**
-     * Translates the data before setting to the storage system
-     *
-     * @param value
-     * @returns {any}
-     */
-    translator (value) {
-        return typeof value === 'string' ? value : JSON.stringify(value);
-    }
-
-    /**
-     * Sets an item in the storage system.
-     *
-     * @param {string} key
-     * @param {(array|object|number|string)} value
-     * @param {boolean} expires
-     */
-    setItem (key, value, expires = true) {
-        if (!this.isSupported()) {
-            return;
-        }
-
-        const generatedKey = this.namespaceKey(key);
-
-        try {
-            this.storage.setItem(generatedKey, this.translator(value));
-
-            if (expires) {
-                this.storage.setItem(
-                  this.expirationKey(key),
-                  String(this.timestamp(this.expires))
-                );
-            }
-        } catch (e) {
-            // fall through
-        }
-    }
-
-    /**
-     * Removes an item from the storage system.
-     *
-     * @param {string} key
-     */
-    removeItem (key) {
-        if (!this.isSupported()) {
-            return;
-        }
-
-        try {
-            this.storage.removeItem(this.namespaceKey(key));
-            this.storage.removeItem(this.expirationKey(key));
-        } catch (e) {
-            // fall through
-        }
-    }
-
-    /**
-     * Clears all items from storage.
-     */
-    clear () {
-        try {
-            this.storage.clear();
-        } catch (e) {
-            // fall through
-        }
-    }
-
-    /**
-     * Checks to see if an item exists in local storage.
-     *
-     * @param {string} key
-     * @returns {boolean}
-     */
-    hasItem (key) {
-        return this.getItem(key, false) !== undefined;
-    }
-
-    /**
-     * Calculates the expires for an item.
-     *
-     * @param {number} offset
-     * @returns {number}
-     */
-    timestamp (offset = 0) {
-        return Math.ceil(Date.now() / 1000) + offset;
-    }
-
-    /**
-     * Creates the key used for storing information in the storage
-     *
-     * @param {string} key
-     * @returns {string}
-     */
-    namespaceKey (key) {
-        if (typeof key !== "string") {
-            throw new Error(KEY_IS_REQUIRED_TO_FETCH_DATA);
-        }
-
-        if (key.indexOf(`${ this.namespace }.`) === 0) {
-            key = key.slice(this.namespace.length + 1);
-        }
-
-        return `${ this.namespace }.${ key.toLowerCase() }`;
-    }
-
-    /**
-     * Creates the expires key used for testing storage usage
-     *
-     * @returns {string}
-     */
-    expirationKey (key) {
-        return `${ this.namespaceKey(key) }.${ EXPIRES_KEY_SUFFIX }`;
-    }
-
-    /**
-     * Checks to see if an item is expired and removes it if so.
-     *
-     * @param {string} key
-     * @returns {boolean}
-     */
-    isItemExpired (key) {
-        if (!this.isSupported()) {
-            return false;
-        }
-
-        try {
-            let value = this.storage.getItem(this.expirationKey(key));
-
-            if (value && "length" in value && value.length) {
-                let expires = parseInt(value, 10);
-
-                if (expires - this.timestamp() <= 0) {
-                    this.removeItem(key);
-                    return true;
-                }
-            }
-        } catch (e) {
-            // fall through
-        }
-
-        return false;
-    }
-
-    /**
-     * Checks to see if the storage system is supported
-     *
-     * @returns {boolean}
-     */
-    isSupported () {
-        if (typeof store.supported === "boolean") {
-            return store.supported;
-        }
-
-        const test = 'biz.storage.test';
-
-        try {
-            this.storage.setItem(test, '1');
-            this.storage.removeItem(test);
-
-            store.supported = true;
-        } catch (e) {
-            store.supported = e instanceof DOMException &&
-              (
-                // everything except Firefox
-                e.code === 22 ||
-                // Firefox
-                e.code === 1014 ||
-                // test name field too, because code might not be present
-                // everything except Firefox
-                e.name === 'QuotaExceededError' ||
-                // Firefox
-                e.name === 'NS_ERROR_DOM_QUOTA_REACHED'
-              ) && (this.storage && this.storage.length !== 0);
-        }
-
-        return store.supported;
-    }
-}

package/lib/abstract/store/index.js

@@ -1,10 +0,0 @@
-/**
- * The data store for global variables
- *
- */
-const store = {
-  supported: null,
-}
-
-// --
-export default store;

package/lib/local/__mocks__/local-storage.js

@@ -1,28 +0,0 @@
-import StorageAbstract from '../../abstract';
-
-export default class LocalStorageMock extends StorageAbstract {
-    constructor (options) {
-        super(options);
-        this.store = {};
-    }
-
-    clear () {
-        this.store = {};
-    }
-
-    getItem (key) {
-        return this.store[key] || null;
-    }
-
-    setItem (key, value, expires = true) {
-        this.store[key] = value;
-        return this;
-    }
-
-    removeItem (key) {
-        delete this.store[key];
-        return this;
-    }
-}
-
-export class InvalidStorageMock {}

package/lib/local/__tests__/storage.local.spec.js

@@ -1,8 +0,0 @@
-import LocalStorage from '../';
-
-describe('bizjournals / core:class >> localstorage:constructor', () => {
-    it('builds the object with localStorage set as the storage system', () => {
-        const localStorage = new LocalStorage();
-        expect(localStorage.storage).toEqual(window.localStorage);
-    });
-});

package/lib/local/index.js

@@ -1,24 +0,0 @@
-import StorageAbstract from "../abstract";
-
-/*
-|--------------------------------------------------------------------------
-| Local Storage
-|--------------------------------------------------------------------------
-| This is the base class for hooking into local storage. There isn't much
-| overlap here if you just keep instantiating, so there isn't much need
-| to singleton this.
-|
-|
-*/
-export default class LocalStorage extends StorageAbstract {
-    /**
-     * Create a local storage adapter.
-     *
-     * @param {object} [options]
-     */
-    constructor(options = {}) {
-        super(options);
-
-        this.storage = window.localStorage;
-    }
-}

package/lib/reference/__tests__/storagereference.general.spec.js

@@ -1,47 +0,0 @@
-import StorageReference from '../';
-import LocalStorageMock, { InvalidStorageMock } from '../../local/__mocks__/local-storage';
-import { INVALID_CONSTRUCTOR_PARAMETERS } from '../exceptions';
-
-describe('bizjournals / core:class >> storagereference', () => {
-    it('throws error when the cachekey is not a string', () => {
-        expect(() => {
-            new StorageReference([], new LocalStorageMock());
-        }).toThrow(INVALID_CONSTRUCTOR_PARAMETERS);
-    });
-
-    it('throws an error when the storage system does not adhere to contract', () => {
-        expect(() => {
-            new StorageReference('astring', new InvalidStorageMock());
-        }).toThrow(INVALID_CONSTRUCTOR_PARAMETERS);
-    });
-
-    it('does not throw an error when constructor parameters are valid', () => {
-        expect(() => {
-            new StorageReference('astring', new LocalStorageMock());
-        }).not.toThrow();
-    });
-
-    it('assigns the constructor parameters to variables for reference', () => {
-        const cacheKey = 'astring';
-        const localStorage = new LocalStorageMock();
-
-        const storage = new StorageReference(cacheKey, localStorage);
-
-        expect(storage.cacheKey).toEqual(cacheKey);
-        expect(storage.storageSystem).toEqual(localStorage);
-    });
-
-    it('can save and obtain the data using the key from storage', () => {
-        const cacheKey = 'astring';
-        const localStorage = new LocalStorageMock();
-        const mockData = { luke: 'skywalker', plot: 'ruined' };
-
-        const storage = new StorageReference(cacheKey, localStorage);
-
-        expect(() => {
-            storage.saveAs(mockData);
-        }).not.toThrow();
-
-        expect(storage.obtain()).toEqual(mockData);
-    });
-});

package/lib/reference/exceptions/index.js

@@ -1 +0,0 @@
-export const INVALID_CONSTRUCTOR_PARAMETERS = 'Invalid construction of cache system. Please refer to documentation.';

package/lib/reference/index.js

@@ -1,67 +0,0 @@
-import StorageAbstract from "../abstract";
-import { INVALID_CONSTRUCTOR_PARAMETERS } from "./exceptions";
-
-/*
-|--------------------------------------------------------------------------
-| Storage Reference
-|--------------------------------------------------------------------------
-| This is a reference to something in storage. Each item has a key
-| belonging to a specific storage system. These storage systems have a
-| common abstract / contract that gives them the same expected pattern.
-| This is the adapter.
-|
-|
-*/
-export default class StorageReference {
-    /**
-     * Creates an instance of a StorageReference system, which needs a cacheKey and
-     * a Storage system (StorageAbstract).
-     *
-     * @param {string} cacheKey
-     * @param {StorageAbstract} storageSystem
-     * @constructor
-     * @return {StorageReference}
-     */
-    constructor(cacheKey, storageSystem) {
-        if (typeof cacheKey !== "string" || !(storageSystem instanceof StorageAbstract)) {
-            throw new Error(INVALID_CONSTRUCTOR_PARAMETERS);
-        }
-
-        this.cacheKey = cacheKey;
-        this.storageSystem = storageSystem;
-    }
-
-    /**
-     * Pulls data from the local store or cached resource.
-     *
-     * @returns {*}
-     */
-    obtain() {
-        return this.storageSystem.getItem(this.cacheKey);
-    }
-
-    /**
-     * Destroys the cache reference with the cache key
-     *
-     * @returns {void}
-     */
-    bust() {
-        this.storageSystem.removeItem(this.cacheKey);
-    }
-
-    /**
-     * Saves the locally stored cache to the caching system. This is
-     * differed via a Promise because the timing of this can be
-     * performed asynchronously.
-     *
-     * @param data
-     * @returns {StorageReference}
-     */
-    saveAs(data) {
-        if (data) {
-            this.storageSystem.setItem(this.cacheKey, data);
-        }
-
-        return this;
-    }
-}

package/lib/session/__tests__/storage.session.spec.js

@@ -1,8 +0,0 @@
-import SessionStorage from "../";
-
-describe("bizjournals / core:class >> sessionstorage:constructor", () => {
-    it("builds the object with sessionStorage set as the storage system", () => {
-        const sessionStorage = new SessionStorage();
-        expect(sessionStorage.storage).toEqual(window.sessionStorage);
-    });
-});

package/lib/session/index.js

@@ -1,24 +0,0 @@
-import StorageAbstract from "../abstract";
-
-/*
-|--------------------------------------------------------------------------
-| Session Storage
-|--------------------------------------------------------------------------
-| This is the base class for hooking into session storage. There isn't much
-| overlap here if you just keep instantiating, so there isn't much need
-| to singleton this.
-|
-|
-*/
-export default class SessionStorage extends StorageAbstract {
-    /**
-     * Create a session storage adapter.
-     *
-     * @param {object} [options]
-     */
-    constructor(options) {
-        super(options);
-
-        this.storage = window.sessionStorage;
-    }
-}

package/main.js

@@ -1,5 +0,0 @@
-import LocalStorage from "./lib/local";
-import SessionStorage from "./lib/session";
-import StorageReference from "./lib/reference";
-
-export { LocalStorage, SessionStorage, StorageReference };