Add 'reset' method to store

Author: samirsilwal

README.md

@@ -342,6 +342,18 @@ Note: This is same as `getId();` the difference being it only returns the first
 const requestIdentifier = store.getShortId();
 ```
 
+### reset()
+
+Reset the store or a specific key of the global store.
+
+- `@returns {void}`
+
+```js
+store.reset(); // Reset the whole store
+
+store.reset('foo') // It will delete the key foo from store and get will result undefined
+```
+
 ## Example Projects
 
 1. [Node Web Server (TypeScript)](examples/node-http-server-ts)

src/AsyncStore.ts

@@ -13,6 +13,7 @@ interface AsyncStore {
   isInitialized: () => boolean;
   getId: () => string | undefined;
   getShortId: () => string | undefined;
+  reset: (key?: string) => void;
 }
 
 export default AsyncStore;

src/impl/domain.ts

@@ -99,6 +99,28 @@ export function set(properties: any) {
   throw new Error('Invalid arguments provided for asyncStore.set()');
 }
 
+/**
+ * Reset the store by removing all values or a specific value by key.
+ *
+ * @param {string} key
+ */
+export function reset(key?: string) {
+  const store = getStore();
+
+  if (key) {
+    logDomain(`Resetting ${key} in the domain store.`);
+
+    delete store[key];
+
+    return;
+  }
+
+  logDomain('Resetting the domain store.');
+
+  const activeDomain = getActiveDomain();
+  activeDomain[STORE_KEY] = null;
+}
+
 /**
  * Get a value by a key from the store.
  * Throws an error if anything fails while getting the value.

src/index.ts

@@ -115,6 +115,21 @@ export function initialize(adapter: AsyncStoreAdapter = AsyncStoreAdapter.DOMAIN
   };
 }
 
+/**
+ * Reset the store or a specific key.
+ *
+ * @param {string} [key]
+ */
+export function reset(key?: string) {
+  if (!isInitialized()) {
+    throw new Error('Async store not initialized.');
+  }
+
+  coreLog(`Resetting store or key = ${key}`);
+
+  getInstance(initializedAdapter).reset(key);
+}
+
 /**
  * Sets properties in the store.
  *

test/domain.test.ts

@@ -485,6 +485,37 @@ describe('store: [adapter=DOMAIN]', () => {
     });
   });
 
+  describe('Reset():', () => {
+    it('should reset the store by removing all values', (done) => {
+      const callback = () => {
+        globalStore.set({ foo: 'foo', bar: 'bar' });
+
+        globalStore.reset();
+
+        expect(globalStore.isInitialized()).to.equal(false);
+
+        done();
+      };
+
+      globalStore.initialize(adapter)(callback);
+    });
+
+    it('should reset the store by removing a specific value by key', (done) => {
+      const callback = () => {
+        globalStore.set({ foo: 'foo', bar: 'bar' });
+
+        globalStore.reset('foo');
+
+        expect(globalStore.get('foo')).to.equal(undefined);
+        expect(globalStore.get('bar')).to.equal('bar');
+
+        done();
+      };
+
+      globalStore.initialize(adapter)(callback);
+    });
+  });
+
   describe('Test Cases:', () => {
     it('should work with a chain of sequentially invoked callbacks (synchronous).', (done) => {
       const callback = () => {