@aws-amplify/cache 4.0.51-next.32 → 4.0.51-next.36

package/lib/AsyncStorageCache.d.ts

@@ -0,0 +1,155 @@
+import { StorageCache } from './StorageCache';
+import AsyncStorage from '@react-native-async-storage/async-storage';
+import { ICache } from './types';
+export declare class AsyncStorageCache extends StorageCache implements ICache {
+    /**
+     * initialize the cache
+     *
+     * @param {Object} config - the configuration of the cache
+     */
+    constructor(config?: any);
+    /**
+     * decrease current size of the cache
+     * @private
+     * @param amount - the amount of the cache size which needs to be decreased
+     */
+    _decreaseCurSizeInBytes(amount: any): Promise<void>;
+    /**
+     * increase current size of the cache
+     * @private
+     * @param amount - the amount of the cache szie which need to be increased
+     */
+    _increaseCurSizeInBytes(amount: any): Promise<void>;
+    /**
+     * update the visited time if item has been visited
+     * @private
+     * @param item - the item which need to be refreshed
+     * @param prefixedKey - the key of the item
+     *
+     * @return the refreshed item
+     */
+    _refreshItem(item: any, prefixedKey: any): Promise<any>;
+    /**
+     * check wether item is expired
+     * @private
+     * @param key - the key of the item
+     *
+     * @return true if the item is expired.
+     */
+    _isExpired(key: any): Promise<boolean>;
+    /**
+     * delete item from cache
+     * @private
+     * @param prefixedKey - the key of the item
+     * @param size - optional, the byte size of the item
+     */
+    _removeItem(prefixedKey: any, size?: any): Promise<void>;
+    /**
+     * put item into cache
+     * @private
+     * @param prefixedKey - the key of the item
+     * @param itemData - the value of the item
+     * @param itemSizeInBytes - the byte size of the item
+     */
+    _setItem(prefixedKey: any, item: any): Promise<void>;
+    /**
+     * total space needed when poping out items
+     * @private
+     * @param itemSize
+     *
+     * @return total space needed
+     */
+    _sizeToPop(itemSize: any): Promise<number>;
+    /**
+     * see whether cache is full
+     * @private
+     * @param itemSize
+     *
+     * @return true if cache is full
+     */
+    _isCacheFull(itemSize: any): Promise<boolean>;
+    /**
+     * scan the storage and find out all the keys owned by this cache
+     * also clean the expired keys while scanning
+     * @private
+     * @return array of keys
+     */
+    _findValidKeys(): Promise<any[]>;
+    /**
+     * get all the items we have, sort them by their priority,
+     * if priority is same, sort them by their last visited time
+     * pop out items from the low priority (5 is the lowest)
+     * @private
+     * @param keys - all the keys in this cache
+     * @param sizeToPop - the total size of the items which needed to be poped out
+     */
+    _popOutItems(keys: any, sizeToPop: any): Promise<void>;
+    /**
+     * Set item into cache. You can put number, string, boolean or object.
+     * The cache will first check whether has the same key.
+     * If it has, it will delete the old item and then put the new item in
+     * The cache will pop out items if it is full
+     * You can specify the cache item options. The cache will abort and output a warning:
+     * If the key is invalid
+     * If the size of the item exceeds itemMaxSize.
+     * If the value is undefined
+     * If incorrect cache item configuration
+     * If error happened with browser storage
+     *
+     * @param {String} key - the key of the item
+     * @param {Object} value - the value of the item
+     * @param {Object} [options] - optional, the specified meta-data
+     * @return {Prmoise}
+     */
+    setItem(key: any, value: any, options: any): Promise<void>;
+    /**
+     * Get item from cache. It will return null if item doesn’t exist or it has been expired.
+     * If you specified callback function in the options,
+     * then the function will be executed if no such item in the cache
+     * and finally put the return value into cache.
+     * Please make sure the callback function will return the value you want to put into the cache.
+     * The cache will abort output a warning:
+     * If the key is invalid
+     * If error happened with AsyncStorage
+     *
+     * @param {String} key - the key of the item
+     * @param {Object} [options] - the options of callback function
+     * @return {Promise} - return a promise resolves to be the value of the item
+     */
+    getItem(key: any, options: any): Promise<any>;
+    /**
+     * remove item from the cache
+     * The cache will abort output a warning:
+     * If error happened with AsyncStorage
+     * @param {String} key - the key of the item
+     * @return {Promise}
+     */
+    removeItem(key: any): Promise<void>;
+    /**
+     * clear the entire cache
+     * The cache will abort output a warning:
+     * If error happened with AsyncStorage
+     * @return {Promise}
+     */
+    clear(): Promise<void>;
+    /**
+     * return the current size of the cache
+     * @return {Promise}
+     */
+    getCacheCurSize(): Promise<number>;
+    /**
+     * Return all the keys in the cache.
+     * Will return an empty array if error happend.
+     * @return {Promise}
+     */
+    getAllKeys(): Promise<any[]>;
+    /**
+     * Return a new instance of cache with customized configuration.
+     * @param {Object} config - the customized configuration
+     * @return {Object} - the new instance of Cache
+     */
+    createInstance(config: any): ICache;
+}
+declare const instance: ICache;
+export { AsyncStorage, instance as Cache };
+export default instance;

package/lib/AsyncStorageCache.js

@@ -1,6 +1,6 @@
 "use strict";
 /*
- * Copyright 2017-2017 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * Copyright 2017-2022 Amazon.com, Inc. or its affiliates. All Rights Reserved.
  *
  * Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance with
  * the License. A copy of the License is located at

package/lib/BrowserStorageCache.d.ts

@@ -0,0 +1,165 @@
+import { StorageCache } from './StorageCache';
+import { ICache, CacheConfig, CacheItemOptions } from './types';
+/**
+ * Customized storage based on the SessionStorage or LocalStorage with LRU implemented
+ */
+export declare class BrowserStorageCacheClass extends StorageCache implements ICache {
+    /**
+     * initialize the cache
+     * @param config - the configuration of the cache
+     */
+    constructor(config?: CacheConfig);
+    /**
+     * decrease current size of the cache
+     *
+     * @private
+     * @param amount - the amount of the cache size which needs to be decreased
+     */
+    private _decreaseCurSizeInBytes;
+    /**
+     * increase current size of the cache
+     *
+     * @private
+     * @param amount - the amount of the cache szie which need to be increased
+     */
+    private _increaseCurSizeInBytes;
+    /**
+     * update the visited time if item has been visited
+     *
+     * @private
+     * @param item - the item which need to be refreshed
+     * @param prefixedKey - the key of the item
+     *
+     * @return the refreshed item
+     */
+    private _refreshItem;
+    /**
+     * check wether item is expired
+     *
+     * @private
+     * @param key - the key of the item
+     *
+     * @return true if the item is expired.
+     */
+    private _isExpired;
+    /**
+     * delete item from cache
+     *
+     * @private
+     * @param prefixedKey - the key of the item
+     * @param size - optional, the byte size of the item
+     */
+    private _removeItem;
+    /**
+     * put item into cache
+     *
+     * @private
+     * @param prefixedKey - the key of the item
+     * @param itemData - the value of the item
+     * @param itemSizeInBytes - the byte size of the item
+     */
+    private _setItem;
+    /**
+     * total space needed when poping out items
+     *
+     * @private
+     * @param itemSize
+     *
+     * @return total space needed
+     */
+    private _sizeToPop;
+    /**
+     * see whether cache is full
+     *
+     * @private
+     * @param itemSize
+     *
+     * @return true if cache is full
+     */
+    private _isCacheFull;
+    /**
+     * scan the storage and find out all the keys owned by this cache
+     * also clean the expired keys while scanning
+     *
+     * @private
+     *
+     * @return array of keys
+     */
+    private _findValidKeys;
+    /**
+     * get all the items we have, sort them by their priority,
+     * if priority is same, sort them by their last visited time
+     * pop out items from the low priority (5 is the lowest)
+     *
+     * @private
+     * @param keys - all the keys in this cache
+     * @param sizeToPop - the total size of the items which needed to be poped out
+     */
+    private _popOutItems;
+    /**
+     * Set item into cache. You can put number, string, boolean or object.
+     * The cache will first check whether has the same key.
+     * If it has, it will delete the old item and then put the new item in
+     * The cache will pop out items if it is full
+     * You can specify the cache item options. The cache will abort and output a warning:
+     * If the key is invalid
+     * If the size of the item exceeds itemMaxSize.
+     * If the value is undefined
+     * If incorrect cache item configuration
+     * If error happened with browser storage
+     *
+     * @param key - the key of the item
+     * @param value - the value of the item
+     * @param {Object} [options] - optional, the specified meta-data
+     */
+    setItem(key: string, value: object | number | string | boolean, options?: CacheItemOptions): void;
+    /**
+     * Get item from cache. It will return null if item doesn’t exist or it has been expired.
+     * If you specified callback function in the options,
+     * then the function will be executed if no such item in the cache
+     * and finally put the return value into cache.
+     * Please make sure the callback function will return the value you want to put into the cache.
+     * The cache will abort output a warning:
+     * If the key is invalid
+     * If error happened with browser storage
+     *
+     * @param key - the key of the item
+     * @param {Object} [options] - the options of callback function
+     *
+     * @return - return the value of the item
+     */
+    getItem(key: string, options?: CacheItemOptions): any;
+    /**
+     * remove item from the cache
+     * The cache will abort output a warning:
+     * If error happened with browser storage
+     * @param key - the key of the item
+     */
+    removeItem(key: string): void;
+    /**
+     * clear the entire cache
+     * The cache will abort output a warning:
+     * If error happened with browser storage
+     */
+    clear(): void;
+    /**
+     * Return all the keys in the cache.
+     *
+     * @return - all keys in the cache
+     */
+    getAllKeys(): string[];
+    /**
+     * return the current size of the cache
+     *
+     * @return - current size of the cache
+     */
+    getCacheCurSize(): number;
+    /**
+     * Return a new instance of cache with customized configuration.
+     * @param config - the customized configuration
+     *
+     * @return - new instance of Cache
+     */
+    createInstance(config: CacheConfig): ICache;
+}
+export declare const BrowserStorageCache: ICache;

package/lib/BrowserStorageCache.js

@@ -1,6 +1,6 @@
 "use strict";
 /*
- * Copyright 2017-2017 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * Copyright 2017-2022 Amazon.com, Inc. or its affiliates. All Rights Reserved.
  *
  * Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance with
  * the License. A copy of the License is located at

package/lib/InMemoryCache.d.ts

@@ -0,0 +1,131 @@
+import { StorageCache } from './StorageCache';
+import { ICache, CacheConfig, CacheItemOptions } from './types';
+/**
+ * Customized in-memory cache with LRU implemented
+ * @member cacheObj - object which store items
+ * @member cacheList - list of keys in the cache with LRU
+ * @member curSizeInBytes - current size of the cache
+ * @member maxPriority - max of the priority
+ * @member cacheSizeLimit - the limit of cache size
+ */
+export declare class InMemoryCacheClass extends StorageCache implements ICache {
+    private cacheList;
+    private curSizeInBytes;
+    private maxPriority;
+    private cacheSizeLimit;
+    /**
+     * initialize the cache
+     *
+     * @param config - the configuration of the cache
+     */
+    constructor(config?: CacheConfig);
+    /**
+     * decrease current size of the cache
+     *
+     * @param amount - the amount of the cache size which needs to be decreased
+     */
+    private _decreaseCurSizeInBytes;
+    /**
+     * increase current size of the cache
+     *
+     * @param amount - the amount of the cache szie which need to be increased
+     */
+    private _increaseCurSizeInBytes;
+    /**
+     * check whether item is expired
+     *
+     * @param key - the key of the item
+     *
+     * @return true if the item is expired.
+     */
+    private _isExpired;
+    /**
+     * delete item from cache
+     *
+     * @param prefixedKey - the key of the item
+     * @param listIdx - indicates which cache list the key belongs to
+     */
+    private _removeItem;
+    /**
+     * put item into cache
+     *
+     * @param prefixedKey - the key of the item
+     * @param itemData - the value of the item
+     * @param itemSizeInBytes - the byte size of the item
+     * @param listIdx - indicates which cache list the key belongs to
+     */
+    private _setItem;
+    /**
+     * see whether cache is full
+     *
+     * @param itemSize
+     *
+     * @return true if cache is full
+     */
+    private _isCacheFull;
+    /**
+     * check whether the cache contains the key
+     *
+     * @param key
+     */
+    private containsKey;
+    /**
+     * * Set item into cache. You can put number, string, boolean or object.
+     * The cache will first check whether has the same key.
+     * If it has, it will delete the old item and then put the new item in
+     * The cache will pop out items if it is full
+     * You can specify the cache item options. The cache will abort and output a warning:
+     * If the key is invalid
+     * If the size of the item exceeds itemMaxSize.
+     * If the value is undefined
+     * If incorrect cache item configuration
+     * If error happened with browser storage
+     *
+     * @param key - the key of the item
+     * @param value - the value of the item
+     * @param options - optional, the specified meta-data
+     *
+     * @throws if the item is too big which exceeds the limit of single item size
+     * @throws if the key is invalid
+     */
+    setItem(key: string, value: object | string | number | boolean, options?: CacheItemOptions): void;
+    /**
+     * Get item from cache. It will return null if item doesn’t exist or it has been expired.
+     * If you specified callback function in the options,
+     * then the function will be executed if no such item in the cache
+     * and finally put the return value into cache.
+     * Please make sure the callback function will return the value you want to put into the cache.
+     * The cache will abort output a warning:
+     * If the key is invalid
+     *
+     * @param key - the key of the item
+     * @param options - the options of callback function
+     */
+    getItem(key: string, options?: CacheItemOptions): any;
+    /**
+     * remove item from the cache
+     *
+     * @param key - the key of the item
+     */
+    removeItem(key: string): void;
+    /**
+     * clear the entire cache
+     */
+    clear(): void;
+    /**
+     * Return all the keys in the cache.
+     */
+    getAllKeys(): string[];
+    /**
+     * return the current size of the cache
+     *
+     * @return the current size of the cache
+     */
+    getCacheCurSize(): number;
+    /**
+     * Return a new instance of cache with customized configuration.
+     * @param config - the customized configuration
+     */
+    createInstance(config: CacheConfig): ICache;
+}
+export declare const InMemoryCache: ICache;

package/lib/InMemoryCache.js

@@ -1,6 +1,6 @@
 "use strict";
 /*
- * Copyright 2017-2017 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * Copyright 2017-2022 Amazon.com, Inc. or its affiliates. All Rights Reserved.
  *
  * Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance with
  * the License. A copy of the License is located at

package/lib/StorageCache.d.ts

@@ -0,0 +1,31 @@
+import { CacheConfig, CacheItem, CacheItemOptions } from './types';
+/**
+ * Initialization of the cache
+ *
+ */
+export declare class StorageCache {
+    protected cacheCurSizeKey: string;
+    protected config: CacheConfig;
+    /**
+     * Initialize the cache
+     * @param config - the configuration of the cache
+     */
+    constructor(config: CacheConfig);
+    getModuleName(): string;
+    private checkConfig;
+    /**
+     * produce a JSON object with meta-data and data value
+     * @param value - the value of the item
+     * @param options - optional, the specified meta-data
+     *
+     * @return - the item which has the meta-data and the value
+     */
+    protected fillCacheItem(key: string, value: object | number | string | boolean, options: CacheItemOptions): CacheItem;
+    /**
+     * set cache with customized configuration
+     * @param config - customized configuration
+     *
+     * @return - the current configuration
+     */
+    configure(config?: CacheConfig): CacheConfig;
+}

package/lib/StorageCache.js

@@ -1,6 +1,6 @@
 "use strict";
 /*
- * Copyright 2017-2017 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * Copyright 2017-2022 Amazon.com, Inc. or its affiliates. All Rights Reserved.
  *
  * Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance with
  * the License. A copy of the License is located at

package/lib/Utils/CacheList.d.ts

@@ -0,0 +1,89 @@
+/**
+ * double linked list plus a hash table inside
+ * each key in the cache stored as a node in the list
+ * recently visited node will be rotated to the head
+ * so the Last Recently Visited node will be at the tail
+ *
+ * @member head - dummy head of the linked list
+ * @member tail - dummy tail of the linked list
+ * @member hashtable - the hashtable which maps cache key to list node
+ * @member length - length of the list
+ */
+export default class CacheList {
+    private head;
+    private tail;
+    private hashtable;
+    private length;
+    /**
+     * initialization
+     */
+    constructor();
+    /**
+     * insert node to the head of the list
+     *
+     * @param node
+     */
+    private insertNodeToHead;
+    /**
+     * remove node
+     *
+     * @param node
+     */
+    private removeNode;
+    /**
+     * @return true if list is empty
+     */
+    isEmpty(): boolean;
+    /**
+     * refresh node so it is rotated to the head
+     *
+     * @param key - key of the node
+     */
+    refresh(key: string): void;
+    /**
+     * insert new node to the head and add it in the hashtable
+     *
+     * @param key - the key of the node
+     */
+    insertItem(key: string): void;
+    /**
+     * @return the LAST Recently Visited key
+     */
+    getLastItem(): string;
+    /**
+     * remove the cache key from the list and hashtable
+     * @param key - the key of the node
+     */
+    removeItem(key: string): void;
+    /**
+     * @return length of the list
+     */
+    getSize(): number;
+    /**
+     * @return true if the key is in the hashtable
+     * @param key
+     */
+    containsKey(key: string): boolean;
+    /**
+     * clean up the list and hashtable
+     */
+    clearList(): void;
+    /**
+     * @return all keys in the hashtable
+     */
+    getKeys(): string[];
+    /**
+     * mainly for test
+     *
+     * @param key
+     * @return true if key is the head node
+     */
+    isHeadNode(key: string): boolean;
+    /**
+     * mainly for test
+     *
+     * @param key
+     * @return true if key is the tail node
+     */
+    isTailNode(key: string): boolean;
+}

package/lib/Utils/CacheList.js

@@ -1,6 +1,6 @@
 "use strict";
 /*
- * Copyright 2017-2017 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * Copyright 2017-2022 Amazon.com, Inc. or its affiliates. All Rights Reserved.
  *
  * Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance with
  * the License. A copy of the License is located at

package/lib/Utils/CacheUtils.d.ts

@@ -0,0 +1,24 @@
+import { CacheConfig } from '../types';
+/**
+ * Default cache config
+ */
+export declare const defaultConfig: CacheConfig;
+/**
+ * return the byte size of the string
+ * @param str
+ */
+export declare function getByteLength(str: string): number;
+/**
+ * get current time
+ */
+export declare function getCurrTime(): number;
+/**
+ * check if passed value is an integer
+ */
+export declare function isInteger(value: any): boolean;
+export declare class CacheObject {
+    static clear(): void;
+    static getItem(key: string): string | null;
+    static setItem(key: string, value: string): void;
+    static removeItem(key: string): void;
+}

package/lib/Utils/CacheUtils.js

@@ -1,6 +1,6 @@
 "use strict";
 /*
- * Copyright 2017-2017 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * Copyright 2017-2022 Amazon.com, Inc. or its affiliates. All Rights Reserved.
  *
  * Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance with
  * the License. A copy of the License is located at

package/lib/Utils/index.d.ts

@@ -0,0 +1,2 @@
+export { CacheObject, defaultConfig, getByteLength, getCurrTime, isInteger, } from './CacheUtils';
+export { default as CacheList } from './CacheList';

package/lib/Utils/index.js

@@ -1,6 +1,6 @@
 "use strict";
 /*
- * Copyright 2017-2017 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * Copyright 2017-2022 Amazon.com, Inc. or its affiliates. All Rights Reserved.
  *
  * Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance with
  * the License. A copy of the License is located at
@@ -12,8 +12,12 @@
  * and limitations under the License.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-var tslib_1 = require("tslib");
-tslib_1.__exportStar(require("./CacheUtils"), exports);
+var CacheUtils_1 = require("./CacheUtils");
+exports.CacheObject = CacheUtils_1.CacheObject;
+exports.defaultConfig = CacheUtils_1.defaultConfig;
+exports.getByteLength = CacheUtils_1.getByteLength;
+exports.getCurrTime = CacheUtils_1.getCurrTime;
+exports.isInteger = CacheUtils_1.isInteger;
 var CacheList_1 = require("./CacheList");
 exports.CacheList = CacheList_1.default;
 //# sourceMappingURL=index.js.map

package/lib/Utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/Utils/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;;AAEH,uDAA6B;AAC7B,yCAAmD;AAA1C,gCAAA,OAAO,CAAa"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/Utils/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;AAEH,2CAMsB;AALrB,mCAAA,WAAW,CAAA;AACX,qCAAA,aAAa,CAAA;AACb,qCAAA,aAAa,CAAA;AACb,mCAAA,WAAW,CAAA;AACX,iCAAA,SAAS,CAAA;AAEV,yCAAmD;AAA1C,gCAAA,OAAO,CAAa"}

package/lib/index.d.ts

@@ -0,0 +1,5 @@
+import { BrowserStorageCache } from './BrowserStorageCache';
+import { InMemoryCache } from './InMemoryCache';
+import { CacheConfig } from './types';
+export { BrowserStorageCache, InMemoryCache, CacheConfig };
+export { BrowserStorageCache as Cache };

package/lib/index.js

@@ -1,6 +1,6 @@
 "use strict";
 /*
- * Copyright 2017-2017 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * Copyright 2017-2022 Amazon.com, Inc. or its affiliates. All Rights Reserved.
  *
  * Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance with
  * the License. A copy of the License is located at
@@ -15,6 +15,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 var core_1 = require("@aws-amplify/core");
 var BrowserStorageCache_1 = require("./BrowserStorageCache");
 exports.BrowserStorageCache = BrowserStorageCache_1.BrowserStorageCache;
+exports.Cache = BrowserStorageCache_1.BrowserStorageCache;
 var InMemoryCache_1 = require("./InMemoryCache");
 exports.InMemoryCache = InMemoryCache_1.InMemoryCache;
 core_1.Amplify.register(BrowserStorageCache_1.BrowserStorageCache);

package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;AAEH,0CAA4C;AAC5C,6DAA4D;AAInD,8BAJA,yCAAmB,CAIA;AAH5B,iDAAgD;AAGlB,wBAHrB,6BAAa,CAGqB;AAE3C,cAAO,CAAC,QAAQ,CAAC,yCAAmB,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;AAEH,0CAA4C;AAC5C,6DAA4D;AAInD,8BAJA,yCAAmB,CAIA;AAGI,gBAPvB,yCAAmB,CAOS;AANrC,iDAAgD;AAGlB,wBAHrB,6BAAa,CAGqB;AAK3C,cAAO,CAAC,QAAQ,CAAC,yCAAmB,CAAC,CAAC"}

package/lib/reactnative.d.ts

@@ -0,0 +1,3 @@
+import { Cache, AsyncStorageCache } from './AsyncStorageCache';
+export { AsyncStorageCache };
+export { Cache };

package/lib/reactnative.js

@@ -1,6 +1,6 @@
 "use strict";
 /*
- * Copyright 2017-2017 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * Copyright 2017-2022 Amazon.com, Inc. or its affiliates. All Rights Reserved.
  *
  * Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance with
  * the License. A copy of the License is located at

package/lib/reactnative.js.map

@@ -1 +1 @@
-{"version":3,"file":"reactnative.js","sourceRoot":"","sources":["../src/reactnative.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;AAEH,0CAA4C;AAC5C,yDAA+D;AAEtD,gBAFA,yBAAK,CAEA;AAAE,4BAFA,qCAAiB,CAEA;AAEjC,cAAO,CAAC,QAAQ,CAAC,yBAAK,CAAC,CAAC"}
+{"version":3,"file":"reactnative.js","sourceRoot":"","sources":["../src/reactnative.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;AAEH,0CAA4C;AAC5C,yDAA+D;AAKtD,gBALA,yBAAK,CAKA;AAHL,4BAFO,qCAAiB,CAEP;AAK1B,cAAO,CAAC,QAAQ,CAAC,yBAAK,CAAC,CAAC"}

package/lib/types/Cache.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Cache Interface
+ */
+export interface ICache {
+    /** Put item into cache */
+    setItem(key: string, value: any, options?: CacheItemOptions): void;
+    /** Get item from cache */
+    getItem(key: string, options?: CacheItemOptions): any;
+    /** Remove item from cache */
+    removeItem(key: string): void;
+    /** Remove all items from cache */
+    clear(): void;
+    /** Get all keys form cache */
+    getAllKeys(): string[] | Promise<string[]>;
+    /** Get current size of the cache */
+    getCacheCurSize(): number | Promise<number>;
+    /** create a new instance with customized config */
+    createInstance(config: CacheConfig): ICache;
+    /** change current configuration */
+    configure(config: CacheConfig): CacheConfig;
+}
+/**
+ * Cache instance options
+ */
+export interface CacheConfig {
+    /** Prepend to key to avoid conflicts */
+    keyPrefix?: string;
+    /** Cache capacity, in bytes */
+    capacityInBytes?: number;
+    /** Max size of one item */
+    itemMaxSize?: number;
+    /** Time to live, in milliseconds */
+    defaultTTL?: number;
+    /** Warn when over threshold percentage of capacity, maximum 1 */
+    warningThreshold?: number;
+    /** default priority number put on cached items */
+    defaultPriority?: number;
+    storage?: Storage;
+    Cache?: Cache;
+}
+export interface CacheItem {
+    key: string;
+    data: any;
+    timestamp: number;
+    visitedTime: number;
+    priority: number;
+    expires: number;
+    type: string;
+    byteSize: number;
+}
+export interface CacheItemOptions {
+    priority?: number;
+    expires?: number;
+    callback?: Function;
+}

package/lib/types/Cache.js

@@ -1,6 +1,6 @@
 "use strict";
 /*
- * Copyright 2017-2017 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * Copyright 2017-2022 Amazon.com, Inc. or its affiliates. All Rights Reserved.
  *
  * Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance with
  * the License. A copy of the License is located at

package/lib/types/index.d.ts

@@ -0,0 +1 @@
+export * from './Cache';

package/lib/types/index.js

@@ -1,6 +1,6 @@
 "use strict";
 /*
- * Copyright 2017-2017 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * Copyright 2017-2022 Amazon.com, Inc. or its affiliates. All Rights Reserved.
  *
  * Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance with
  * the License. A copy of the License is located at

package/lib-esm/AsyncStorageCache.js

@@ -1,5 +1,5 @@
 /*
- * Copyright 2017-2017 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * Copyright 2017-2022 Amazon.com, Inc. or its affiliates. All Rights Reserved.
  *
  * Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance with
  * the License. A copy of the License is located at

package/lib-esm/BrowserStorageCache.js

@@ -1,5 +1,5 @@
 /*
- * Copyright 2017-2017 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * Copyright 2017-2022 Amazon.com, Inc. or its affiliates. All Rights Reserved.
  *
  * Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance with
  * the License. A copy of the License is located at

package/lib-esm/InMemoryCache.js

@@ -1,5 +1,5 @@
 /*
- * Copyright 2017-2017 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * Copyright 2017-2022 Amazon.com, Inc. or its affiliates. All Rights Reserved.
  *
  * Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance with
  * the License. A copy of the License is located at

package/lib-esm/StorageCache.js

@@ -1,5 +1,5 @@
 /*
- * Copyright 2017-2017 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * Copyright 2017-2022 Amazon.com, Inc. or its affiliates. All Rights Reserved.
  *
  * Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance with
  * the License. A copy of the License is located at

package/lib-esm/Utils/CacheList.js

@@ -1,5 +1,5 @@
 /*
- * Copyright 2017-2017 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * Copyright 2017-2022 Amazon.com, Inc. or its affiliates. All Rights Reserved.
  *
  * Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance with
  * the License. A copy of the License is located at

package/lib-esm/Utils/CacheUtils.js

@@ -1,5 +1,5 @@
 /*
- * Copyright 2017-2017 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * Copyright 2017-2022 Amazon.com, Inc. or its affiliates. All Rights Reserved.
  *
  * Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance with
  * the License. A copy of the License is located at

package/lib-esm/Utils/index.d.ts

@@ -1,2 +1,2 @@
-export * from './CacheUtils';
+export { CacheObject, defaultConfig, getByteLength, getCurrTime, isInteger, } from './CacheUtils';
 export { default as CacheList } from './CacheList';

package/lib-esm/Utils/index.js

@@ -1,5 +1,5 @@
 /*
- * Copyright 2017-2017 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * Copyright 2017-2022 Amazon.com, Inc. or its affiliates. All Rights Reserved.
  *
  * Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance with
  * the License. A copy of the License is located at
@@ -10,6 +10,6 @@
  * CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions
  * and limitations under the License.
  */
-export * from './CacheUtils';
+export { CacheObject, defaultConfig, getByteLength, getCurrTime, isInteger, } from './CacheUtils';
 export { default as CacheList } from './CacheList';
 //# sourceMappingURL=index.js.map

package/lib-esm/Utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/Utils/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,cAAc,cAAc,CAAC;AAC7B,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/Utils/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EACN,WAAW,EACX,aAAa,EACb,aAAa,EACb,WAAW,EACX,SAAS,GACT,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,aAAa,CAAC"}

package/lib-esm/index.d.ts

@@ -2,3 +2,4 @@ import { BrowserStorageCache } from './BrowserStorageCache';
 import { InMemoryCache } from './InMemoryCache';
 import { CacheConfig } from './types';
 export { BrowserStorageCache, InMemoryCache, CacheConfig };
+export { BrowserStorageCache as Cache };

package/lib-esm/index.js

@@ -1,5 +1,5 @@
 /*
- * Copyright 2017-2017 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * Copyright 2017-2022 Amazon.com, Inc. or its affiliates. All Rights Reserved.
  *
  * Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance with
  * the License. A copy of the License is located at
@@ -14,5 +14,7 @@ import { Amplify } from '@aws-amplify/core';
 import { BrowserStorageCache } from './BrowserStorageCache';
 import { InMemoryCache } from './InMemoryCache';
 export { BrowserStorageCache, InMemoryCache };
+// Standard `Cache` export to maintain interoperability with React Native
+export { BrowserStorageCache as Cache };
 Amplify.register(BrowserStorageCache);
 //# sourceMappingURL=index.js.map

package/lib-esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGhD,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAe,CAAC;AAE3D,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGhD,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAe,CAAC;AAE3D,yEAAyE;AACzE,OAAO,EAAE,mBAAmB,IAAI,KAAK,EAAE,CAAC;AAExC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAC"}

package/lib-esm/reactnative.d.ts

@@ -1,2 +1,3 @@
 import { Cache, AsyncStorageCache } from './AsyncStorageCache';
-export { Cache, AsyncStorageCache };
+export { AsyncStorageCache };
+export { Cache };

package/lib-esm/reactnative.js

@@ -1,5 +1,5 @@
 /*
- * Copyright 2017-2017 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * Copyright 2017-2022 Amazon.com, Inc. or its affiliates. All Rights Reserved.
  *
  * Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance with
  * the License. A copy of the License is located at
@@ -12,6 +12,8 @@
  */
 import { Amplify } from '@aws-amplify/core';
 import { Cache, AsyncStorageCache } from './AsyncStorageCache';
-export { Cache, AsyncStorageCache };
+export { AsyncStorageCache };
+// Standard `Cache` export to maintain interoperability with React Native
+export { Cache };
 Amplify.register(Cache);
 //# sourceMappingURL=reactnative.js.map

package/lib-esm/reactnative.js.map

@@ -1 +1 @@
-{"version":3,"file":"reactnative.js","sourceRoot":"","sources":["../src/reactnative.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAE,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE/D,OAAO,EAAE,KAAK,EAAE,iBAAiB,EAAE,CAAC;AAEpC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC"}
+{"version":3,"file":"reactnative.js","sourceRoot":"","sources":["../src/reactnative.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAE,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE/D,OAAO,EAAE,iBAAiB,EAAE,CAAC;AAE7B,yEAAyE;AACzE,OAAO,EAAE,KAAK,EAAE,CAAC;AAEjB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC"}

package/lib-esm/types/Cache.js

@@ -1,5 +1,5 @@
 /*
- * Copyright 2017-2017 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * Copyright 2017-2022 Amazon.com, Inc. or its affiliates. All Rights Reserved.
  *
  * Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance with
  * the License. A copy of the License is located at

package/lib-esm/types/index.js

@@ -1,5 +1,5 @@
 /*
- * Copyright 2017-2017 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * Copyright 2017-2022 Amazon.com, Inc. or its affiliates. All Rights Reserved.
  *
  * Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance with
  * the License. A copy of the License is located at

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aws-amplify/cache",
-  "version": "4.0.51-next.32+4137aa79c",
+  "version": "4.0.51-next.36+580cda186",
   "description": "Cache category of aws-amplify",
   "main": "./lib/index.js",
   "module": "./lib-esm/index.js",
@@ -31,7 +31,8 @@
     "build": "npm run clean && npm run build:esm && npm run build:cjs",
     "clean": "rimraf lib-esm lib dist",
     "format": "echo \"Not implemented\"",
-    "lint": "tslint 'src/**/*.ts'"
+    "lint": "tslint 'src/**/*.ts' && npm run ts-coverage",
+    "ts-coverage": "typescript-coverage-report -p ./tsconfig.build.json -t 87.74"
   },
   "repository": {
     "type": "git",
@@ -49,7 +50,7 @@
     "src"
   ],
   "dependencies": {
-    "@aws-amplify/core": "4.6.2-next.32+4137aa79c",
+    "@aws-amplify/core": "4.6.2-next.36+580cda186",
     "tslib": "^2.0.0"
   },
   "jest": {
@@ -100,5 +101,5 @@
       "lib-esm"
     ]
   },
-  "gitHead": "4137aa79c6c2362afc581d3915d77f5067ea6700"
+  "gitHead": "580cda186f10ead3bb99acb7a4825c435c657d33"
 }

package/src/AsyncStorageCache.ts

@@ -1,5 +1,5 @@
 /*
- * Copyright 2017-2017 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * Copyright 2017-2022 Amazon.com, Inc. or its affiliates. All Rights Reserved.
  *
  * Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance with
  * the License. A copy of the License is located at

package/src/BrowserStorageCache.ts

@@ -1,5 +1,5 @@
 /*
- * Copyright 2017-2017 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * Copyright 2017-2022 Amazon.com, Inc. or its affiliates. All Rights Reserved.
  *
  * Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance with
  * the License. A copy of the License is located at

package/src/InMemoryCache.ts

@@ -1,5 +1,5 @@
 /*
- * Copyright 2017-2017 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * Copyright 2017-2022 Amazon.com, Inc. or its affiliates. All Rights Reserved.
  *
  * Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance with
  * the License. A copy of the License is located at

package/src/StorageCache.ts

@@ -1,5 +1,5 @@
 /*
- * Copyright 2017-2017 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * Copyright 2017-2022 Amazon.com, Inc. or its affiliates. All Rights Reserved.
  *
  * Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance with
  * the License. A copy of the License is located at

package/src/Utils/CacheList.ts

@@ -1,5 +1,5 @@
 /*
- * Copyright 2017-2017 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * Copyright 2017-2022 Amazon.com, Inc. or its affiliates. All Rights Reserved.
  *
  * Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance with
  * the License. A copy of the License is located at

package/src/Utils/CacheUtils.ts

@@ -1,5 +1,5 @@
 /*
- * Copyright 2017-2017 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * Copyright 2017-2022 Amazon.com, Inc. or its affiliates. All Rights Reserved.
  *
  * Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance with
  * the License. A copy of the License is located at

package/src/Utils/index.ts

@@ -1,15 +1,21 @@
-/*
- * Copyright 2017-2017 Amazon.com, Inc. or its affiliates. All Rights Reserved.
- *
- * Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance with
- * the License. A copy of the License is located at
- *
- *     http://aws.amazon.com/apache2.0/
- *
- * or in the "license" file accompanying this file. This file is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
- * CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions
- * and limitations under the License.
- */
-
-export * from './CacheUtils';
-export { default as CacheList } from './CacheList';
+/*
+ * Copyright 2017-2022 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance with
+ * the License. A copy of the License is located at
+ *
+ *     http://aws.amazon.com/apache2.0/
+ *
+ * or in the "license" file accompanying this file. This file is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
+ * CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions
+ * and limitations under the License.
+ */
+
+export {
+	CacheObject,
+	defaultConfig,
+	getByteLength,
+	getCurrTime,
+	isInteger,
+} from './CacheUtils';
+export { default as CacheList } from './CacheList';

package/src/index.ts

@@ -1,5 +1,5 @@
 /*
- * Copyright 2017-2017 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * Copyright 2017-2022 Amazon.com, Inc. or its affiliates. All Rights Reserved.
  *
  * Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance with
  * the License. A copy of the License is located at
@@ -18,4 +18,7 @@ import { CacheConfig } from './types';
 
 export { BrowserStorageCache, InMemoryCache, CacheConfig };
 
+// Standard `Cache` export to maintain interoperability with React Native
+export { BrowserStorageCache as Cache };
+
 Amplify.register(BrowserStorageCache);

package/src/reactnative.ts

@@ -1,5 +1,5 @@
 /*
- * Copyright 2017-2017 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * Copyright 2017-2022 Amazon.com, Inc. or its affiliates. All Rights Reserved.
  *
  * Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance with
  * the License. A copy of the License is located at
@@ -14,6 +14,9 @@
 import { Amplify } from '@aws-amplify/core';
 import { Cache, AsyncStorageCache } from './AsyncStorageCache';
 
-export { Cache, AsyncStorageCache };
+export { AsyncStorageCache };
+
+// Standard `Cache` export to maintain interoperability with React Native
+export { Cache };
 
 Amplify.register(Cache);

package/src/types/Cache.ts

@@ -1,5 +1,5 @@
 /*
- * Copyright 2017-2017 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * Copyright 2017-2022 Amazon.com, Inc. or its affiliates. All Rights Reserved.
  *
  * Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance with
  * the License. A copy of the License is located at

package/src/types/index.ts

@@ -1,5 +1,5 @@
 /*
- * Copyright 2017-2017 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * Copyright 2017-2022 Amazon.com, Inc. or its affiliates. All Rights Reserved.
  *
  * Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance with
  * the License. A copy of the License is located at