@webpieces/core-context 0.1.0

package/README.md

@@ -0,0 +1,19 @@
+# @webpieces/core-context
+
+> AsyncLocalStorage-based context management for request-scoped data
+
+Part of the [WebPieces TypeScript](https://github.com/deanhiller/webpieces-ts) framework.
+
+## Installation
+
+```bash
+npm install @webpieces/core-context
+```
+
+## Documentation
+
+See the main [WebPieces README](https://github.com/deanhiller/webpieces-ts#readme) for complete documentation and examples.
+
+## License
+
+Apache-2.0

package/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "@webpieces/core-context",
+  "version": "0.1.0",
+  "description": "AsyncLocalStorage-based context management for request-scoped data",
+  "type": "commonjs",
+  "main": "./src/index.js",
+  "types": "./src/index.d.ts",
+  "author": "Dean Hiller",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/deanhiller/webpieces-ts.git",
+    "directory": "packages/core/core-context"
+  },
+  "keywords": [
+    "webpieces",
+    "context",
+    "async",
+    "request-scoped"
+  ],
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/Context.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Context management using AsyncLocalStorage.
+ * Similar to Java WebPieces Context class that uses ThreadLocal.
+ *
+ * This allows storing request-scoped data that is automatically available
+ * throughout the async call chain, similar to MDC (Mapped Diagnostic Context).
+ *
+ * Example usage:
+ * ```typescript
+ * Context.put('REQUEST_ID', '12345');
+ * await someAsyncOperation();
+ * const id = Context.get('REQUEST_ID'); // Still available!
+ * ```
+ */
+declare class ContextManager {
+    private storage;
+    constructor();
+    /**
+     * Run a function with a new context.
+     * This is typically called at the beginning of a request.
+     */
+    run<T>(fn: () => T): T;
+    /**
+     * Run a function with a specific context.
+     */
+    runWithContext<T>(context: Map<string, any>, fn: () => T): T;
+    /**
+     * Store a value in the current context.
+     */
+    put(key: string, value: any): void;
+    /**
+     * Retrieve a value from the current context.
+     */
+    get<T = any>(key: string): T | undefined;
+    /**
+     * Remove a value from the current context.
+     */
+    remove(key: string): void;
+    /**
+     * Clear all values from the current context.
+     */
+    clear(): void;
+    /**
+     * Copy the current context to a new Map.
+     * Used by XPromise to preserve context across async boundaries.
+     */
+    copyContext(): Map<string, any>;
+    /**
+     * Set the entire context from a Map.
+     * Used by XPromise to restore context.
+     */
+    setContext(context: Map<string, any>): void;
+    /**
+     * Get all context entries.
+     */
+    getAll(): Map<string, any>;
+    /**
+     * Check if a key exists in the context.
+     */
+    has(key: string): boolean;
+}
+/**
+ * Global singleton instance of ContextManager.
+ * Use this throughout your application.
+ */
+export declare const Context: ContextManager;
+export {};

package/src/Context.js

@@ -0,0 +1,113 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Context = void 0;
+const async_hooks_1 = require("async_hooks");
+/**
+ * Context management using AsyncLocalStorage.
+ * Similar to Java WebPieces Context class that uses ThreadLocal.
+ *
+ * This allows storing request-scoped data that is automatically available
+ * throughout the async call chain, similar to MDC (Mapped Diagnostic Context).
+ *
+ * Example usage:
+ * ```typescript
+ * Context.put('REQUEST_ID', '12345');
+ * await someAsyncOperation();
+ * const id = Context.get('REQUEST_ID'); // Still available!
+ * ```
+ */
+class ContextManager {
+    constructor() {
+        this.storage = new async_hooks_1.AsyncLocalStorage();
+    }
+    /**
+     * Run a function with a new context.
+     * This is typically called at the beginning of a request.
+     */
+    run(fn) {
+        const store = new Map();
+        return this.storage.run(store, fn);
+    }
+    /**
+     * Run a function with a specific context.
+     */
+    runWithContext(context, fn) {
+        return this.storage.run(context, fn);
+    }
+    /**
+     * Store a value in the current context.
+     */
+    put(key, value) {
+        const store = this.storage.getStore();
+        if (!store) {
+            throw new Error('No context available. Did you call Context.run() first?');
+        }
+        store.set(key, value);
+    }
+    /**
+     * Retrieve a value from the current context.
+     */
+    get(key) {
+        const store = this.storage.getStore();
+        return store?.get(key);
+    }
+    /**
+     * Remove a value from the current context.
+     */
+    remove(key) {
+        const store = this.storage.getStore();
+        store?.delete(key);
+    }
+    /**
+     * Clear all values from the current context.
+     */
+    clear() {
+        const store = this.storage.getStore();
+        store?.clear();
+    }
+    /**
+     * Copy the current context to a new Map.
+     * Used by XPromise to preserve context across async boundaries.
+     */
+    copyContext() {
+        const store = this.storage.getStore();
+        if (!store) {
+            return new Map();
+        }
+        return new Map(store);
+    }
+    /**
+     * Set the entire context from a Map.
+     * Used by XPromise to restore context.
+     */
+    setContext(context) {
+        const store = this.storage.getStore();
+        if (!store) {
+            throw new Error('No context available. Did you call Context.run() first?');
+        }
+        store.clear();
+        context.forEach((value, key) => {
+            store.set(key, value);
+        });
+    }
+    /**
+     * Get all context entries.
+     */
+    getAll() {
+        const store = this.storage.getStore();
+        return store ? new Map(store) : new Map();
+    }
+    /**
+     * Check if a key exists in the context.
+     */
+    has(key) {
+        const store = this.storage.getStore();
+        return store?.has(key) ?? false;
+    }
+}
+/**
+ * Global singleton instance of ContextManager.
+ * Use this throughout your application.
+ */
+exports.Context = new ContextManager();
+//# sourceMappingURL=Context.js.map

package/src/Context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Context.js","sourceRoot":"","sources":["../../../../../packages/core/core-context/src/Context.ts"],"names":[],"mappings":";;;AAAA,6CAAgD;AAEhD;;;;;;;;;;;;;GAaG;AACH,MAAM,cAAc;IAGlB;QACE,IAAI,CAAC,OAAO,GAAG,IAAI,+BAAiB,EAAoB,CAAC;IAC3D,CAAC;IAED;;;OAGG;IACH,GAAG,CAAI,EAAW;QAChB,MAAM,KAAK,GAAG,IAAI,GAAG,EAAe,CAAC;QACrC,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACrC,CAAC;IAED;;OAEG;IACH,cAAc,CAAI,OAAyB,EAAE,EAAW;QACtD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IACvC,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,GAAW,EAAE,KAAU;QACzB,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;QACtC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;QAC7E,CAAC;QACD,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACxB,CAAC;IAED;;OAEG;IACH,GAAG,CAAU,GAAW;QACtB,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;QACtC,OAAO,KAAK,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,GAAW;QAChB,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;QACtC,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;IACrB,CAAC;IAED;;OAEG;IACH,KAAK;QACH,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;QACtC,KAAK,EAAE,KAAK,EAAE,CAAC;IACjB,CAAC;IAED;;;OAGG;IACH,WAAW;QACT,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;QACtC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,IAAI,GAAG,EAAE,CAAC;QACnB,CAAC;QACD,OAAO,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;IACxB,CAAC;IAED;;;OAGG;IACH,UAAU,CAAC,OAAyB;QAClC,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;QACtC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;QAC7E,CAAC;QACD,KAAK,CAAC,KAAK,EAAE,CAAC;QACd,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;YAC7B,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACxB,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,MAAM;QACJ,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;QACtC,OAAO,KAAK,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,EAAE,CAAC;IAC5C,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,GAAW;QACb,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;QACtC,OAAO,KAAK,EAAE,GAAG,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC;IAClC,CAAC;CACF;AAED;;;GAGG;AACU,QAAA,OAAO,GAAG,IAAI,cAAc,EAAE,CAAC"}

package/src/index.d.ts

@@ -0,0 +1 @@
+export { Context } from './Context';

package/src/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Context = void 0;
+var Context_1 = require("./Context");
+Object.defineProperty(exports, "Context", { enumerable: true, get: function () { return Context_1.Context; } });
+//# sourceMappingURL=index.js.map

package/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/core/core-context/src/index.ts"],"names":[],"mappings":";;;AAAA,qCAAoC;AAA3B,kGAAA,OAAO,OAAA"}