Merge branch 'main' into enhance-documentation

Author: coderhammer

package-lock.json

@@ -1,5 +1,12 @@
 # @backhooks/core
 
+## 0.2.1
+
+### Patch Changes
+
+- 386ea5d: Updated README with new resetGlobalContext function
+- ea23d07: Added the possibility to reset the global context
+
 ## 0.2.0
 
 ### Minor Changes

packages/core/CHANGELOG.md

@@ -14,33 +14,54 @@ npm install @backhooks/core
 
 This allows you to create a hook. Example of creating a simple hook:
 
-````ts
+```ts
 const [useCount, configureCountHook] = createHook({
-  data () {
+  data() {
     return {
-      count: 0
-    }
+      count: 0,
+    };
+  },
+  execute(state) {
+    state.count++;
+    return state.count;
   },
-  execute (state) {
-    state.count++
-    return state.count
-  }
-})
+});
+```
 
 `runHookContext: <T>(fn: () => T): Promise<T>`
 
 This allows you to run a hook context. Any hook called within the `runHookContext` callback will have a specific state attached to it:
 
 ```ts
 runHookContext(() => {
-  console.log(useCount()) // 1
-  console.log(useCount()) // 2
-  console.log(useCount()) // 3
-})
+  console.log(useCount()); // 1
+  console.log(useCount()); // 2
+  console.log(useCount()); // 3
+});
 
 runHookContext(() => {
-  console.log(useCount()) // 1
-  console.log(useCount()) // 2
-  console.log(useCount()) // 3
-})
-````
+  console.log(useCount()); // 1
+  console.log(useCount()); // 2
+  console.log(useCount()); // 3
+});
+```
+
+`resetGlobalContext()`
+
+This allows you to reset the global context. It can be very useful for testing purposes
+
+```ts
+beforeEach(() => {
+  resetGlobalContext();
+});
+
+test("it should count", async () => {
+  const count = useCount();
+  expect(count).toBe(1); // true
+});
+
+test("it should also count", async () => {
+  const count = useCount();
+  expect(count).toBe(1); // also true
+});
+```

packages/core/README.md

@@ -1,6 +1,6 @@
 {
   "name": "@backhooks/core",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "scripts": {
     "build": "tsc",
     "test": "jest"

packages/core/package.json

@@ -4,7 +4,7 @@ import type { Optional } from "utility-types";
 
 const asyncLocalStorage = new AsyncLocalStorage();
 
-const globalStore = {};
+let globalStore = {};
 
 interface CreateHookOptions<
   State extends Record<string, any>,
@@ -77,3 +77,7 @@ export const runHookContext = async <T>(
   const result = (await asyncLocalStorage.run({}, fn)) as T;
   return result;
 };
+
+export const resetGlobalContext = () => {
+  globalStore = {};
+};

packages/core/src/core.ts

@@ -1,4 +1,4 @@
-import { runHookContext, createHook } from "../src/index";
+import { runHookContext, createHook, resetGlobalContext } from "../src/index";
 
 const [useRandom, configureRandomHook] = createHook({
   data() {
@@ -103,3 +103,12 @@ test("it should be able to create a hook without name", async () => {
   const result = useHook();
   expect(result).toBe("ok");
 });
+
+test("it should be able to reset the global context", async () => {
+  const random = useRandom();
+  const random2 = useRandom();
+  expect(random).toBe(random2);
+  resetGlobalContext();
+  const random3 = useRandom();
+  expect(random).not.toBe(random3);
+});