@marceloraineri/async-context 1.0.0 → 1.1.0

package/README.md

@@ -1 +1,118 @@
-# SyncContext
+# AsyncContext
+
+> Request-scoped context storage backed by Node.js `AsyncLocalStorage`, with first-class Express integration.
+
+AsyncContext is a tiny utility library that standardizes how you propagate contextual data across asynchronous flows. It offers a singleton `Context` wrapper around `AsyncLocalStorage` plus helpers to enrich the active store and an Express middleware that bootstraps a fresh context for every incoming request.
+
+## Why AsyncContext?
+
+- **Consistent async context** – Create one logical context per request, job, or background task without passing parameters through every function call.
+- **Drop-in API** – Call `Context.addValue` or `Context.addObjectValue` anywhere inside the active flow to append metadata.
+- **Observability ready** – Ship correlation IDs, tenant information, user data, or tracing metadata through your stack.
+- **Framework friendly** – Includes an `AsyncContextExpresssMiddleware` that assigns a unique `instance_id` to each Express request and runs all downstream handlers inside that context.
+
+## Installation
+
+```bash
+npm i @marceloraineri/async-context
+```
+
+When developing locally inside this repo, import from the relative `core` entry point instead.
+
+## Quick start
+
+```ts
+import { Context } from "@marceloraineri/async-context";
+  Context.addValue("user", { id: 42, name: "Ada" });
+
+  await Promise.resolve();
+
+  const store = Context.getInstance().getStore();
+  console.log(store.requestId); // 184fa9a3-f967-4a98-9d8f-57152e7cbe64
+  console.log(store.user); // { id: 42, name: "Ada" }
+```
+
+## Express middleware
+
+`AsyncContextExpresssMiddleware` (note the triple “s”) creates a new context for every Express request, seeds it with a UUID `instance_id`, and ensures the context is available throughout the request lifecycle.
+
+```ts
+import express from "express";
+import {
+  AsyncContextExpresssMiddleware,
+  Context,
+} from "@marceloraineri/async-context";
+
+const app = express();
+
+app.use(AsyncContextExpresssMiddleware);
+
+app.get("/ping", (_req, res) => {
+  const store = Context.getInstance().getStore();
+  res.json({ instanceId: store?.instance_id ?? null });
+});
+
+app.listen(3000, () => console.log("API listening on :3000"));
+```
+
+## Nest middleware
+
+`AsyncContextNestMiddleware` reuses the Express middleware so you can enable async context in Nest (default Express adapter).
+
+```ts
+import { MiddlewareConsumer, Module, NestModule } from "@nestjs/common";
+import { AsyncContextNestMiddleware } from "@marceloraineri/async-context";
+
+@Module({})
+export class AppModule implements NestModule {
+  configure(consumer: MiddlewareConsumer) {
+    consumer.apply(AsyncContextNestMiddleware).forRoutes("*");
+  }
+}
+```
+
+> Note: This middleware targets Nest's Express adapter. If you use the Fastify adapter, consider a custom interceptor that calls `Context.getInstance().run(...)` per request.
+
+## AdonisJS middleware
+
+`AsyncContextAdonisMiddleware` plugs into AdonisJS' middleware pipeline and initializes a new async context for each request.
+
+```ts
+// app/Http/Middleware/AsyncContext.ts
+import { AsyncContextAdonisMiddleware } from "@marceloraineri/async-context";
+
+export default AsyncContextAdonisMiddleware;
+```
+
+Register it as a global middleware in your AdonisJS kernel (per your Adonis version docs).
+
+## API reference
+
+### `Context.getInstance(): AsyncLocalStorage`
+Returns (and lazily instantiates) the singleton `AsyncLocalStorage` used by the library. You typically call `run(store, callback)` on this instance to spawn a new context.
+
+### `Context.addObjectValue(values: Record<string, unknown>): Record<string, unknown>`
+Merges the provided object into the active context. Also throws if no context is active.
+
+### `AsyncContextExpresssMiddleware(req, res, next)`
+Express middleware that:
+
+1. Generates a UUID via `crypto.randomUUID()`.
+2. Calls `Context.getInstance().run({ instance_id: uuid }, () => next())`.
+3. Makes the context (and `instance_id`) available to any downstream code.
+
+### `AsyncContextNestMiddleware`
+Nest middleware (Express adapter) that initializes a new async context per request by delegating to `AsyncContextExpresssMiddleware`.
+
+### `AsyncContextAdonisMiddleware`
+AdonisJS middleware that initializes a new async context per request using `Context.getInstance().run(...)`.
+
+## Best practices & caveats
+
+- Avoid replacing the entire store object manually; instead mutate it through `addValue`/`addObjectValue` to keep shared references intact.
+- `AsyncLocalStorage` state is scoped to a single Node.js process. If you spawn workers or separate processes, each will maintain its own context.
+- Be mindful of long-lived contexts: if you never exit a `run` callback (e.g., forgetting to call `next()` in Express), the store will never be released.
+
+## Contributing
+
+Issues and pull requests are welcome. Please include reproduction steps or tests whenever you propose a change to the async context behavior.

package/dist/core/context.d.ts

@@ -0,0 +1,46 @@
+import { AsyncLocalStorage } from "node:async_hooks";
+/**
+ * Provides an application-wide asynchronous context using Node.js AsyncLocalStorage.
+ * Allows storing and retrieving key/value data within the active async execution flow.
+ */
+export declare class Context {
+    /**
+     * Singleton instance of AsyncLocalStorage.
+     * @type {AsyncLocalStorage<unknown>}
+     */
+    static asyncLocalStorageInstance: AsyncLocalStorage<unknown>;
+    /**
+     * Private constructor initializes the AsyncLocalStorage instance.
+     * Called automatically when the instance does not yet exist.
+     * @private
+     */
+    private constructor();
+    /**
+     * Returns the global AsyncLocalStorage instance, creating it if necessary.
+     *
+     * @returns {AsyncLocalStorage<unknown>} The AsyncLocalStorage singleton.
+     */
+    static getInstance(): AsyncLocalStorage<unknown>;
+    /**
+     * Adds a single key/value pair to the active asynchronous context.
+     *
+     * @param {string} key - Key to store inside the context.
+     * @param {*} value - Value to associate with the given key.
+     * @returns {Record<string, any>} The updated context object.
+     *
+     * @throws {Error} If called outside of an active `Context.getInstance().run()`.
+     */
+    static addValue(key: string, value: any): Record<string, any>;
+    /**
+     * Merges an object of values into the active asynchronous context.
+     *
+     * @param {Record<string, any>} object - Object containing key/value pairs to merge.
+     * @returns {Record<string, any>} The merged context object.
+     *
+     * @throws {Error} If called outside of an active `Context.getInstance().run()`.
+     */
+    static addObjectValue(object: Record<string, any>): Record<string, any>;
+    static remove(key: string): Record<string, any>;
+    static safeRemove(key: string): Record<string, any>;
+}
+//# sourceMappingURL=context.d.ts.map

package/dist/core/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../core/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAErD;;;GAGG;AACH,qBAAa,OAAO;IAClB;;;OAGG;IACH,OAAc,yBAAyB,EAAE,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAEpE;;;;OAIG;IACH,OAAO;IAIP;;;;OAIG;IACH,MAAM,CAAC,WAAW,IAAI,iBAAiB,CAAC,OAAO,CAAC;IAOhD;;;;;;;;OAQG;IACH,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAc7D;;;;;;;OAOG;IACH,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAUvE,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM;IAezB,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM;CAY9B"}

package/dist/core/context.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Context = void 0;
+const node_async_hooks_1 = require("node:async_hooks");
+/**
+ * Provides an application-wide asynchronous context using Node.js AsyncLocalStorage.
+ * Allows storing and retrieving key/value data within the active async execution flow.
+ */
+class Context {
+    /**
+     * Private constructor initializes the AsyncLocalStorage instance.
+     * Called automatically when the instance does not yet exist.
+     * @private
+     */
+    constructor() {
+        Context.asyncLocalStorageInstance = new node_async_hooks_1.AsyncLocalStorage();
+    }
+    /**
+     * Returns the global AsyncLocalStorage instance, creating it if necessary.
+     *
+     * @returns {AsyncLocalStorage<unknown>} The AsyncLocalStorage singleton.
+     */
+    static getInstance() {
+        if (!Context.asyncLocalStorageInstance) {
+            new Context();
+        }
+        return Context.asyncLocalStorageInstance;
+    }
+    /**
+     * Adds a single key/value pair to the active asynchronous context.
+     *
+     * @param {string} key - Key to store inside the context.
+     * @param {*} value - Value to associate with the given key.
+     * @returns {Record<string, any>} The updated context object.
+     *
+     * @throws {Error} If called outside of an active `Context.getInstance().run()`.
+     */
+    static addValue(key, value) {
+        const contextObject = Context.getInstance().getStore();
+        if (!contextObject)
+            throw new Error("No active context found. Use Context.getInstance().run() or use the context middleware.");
+        contextObject[key] = value;
+        return contextObject;
+    }
+    /**
+     * Merges an object of values into the active asynchronous context.
+     *
+     * @param {Record<string, any>} object - Object containing key/value pairs to merge.
+     * @returns {Record<string, any>} The merged context object.
+     *
+     * @throws {Error} If called outside of an active `Context.getInstance().run()`.
+     */
+    static addObjectValue(object) {
+        const contextObject = Context.getInstance().getStore();
+        if (!contextObject)
+            throw new Error("No active context found. Use Context.getInstance().run() or use the context middleware.");
+        return Object.assign(contextObject, object);
+    }
+    static remove(key) {
+        const contextObject = Context.getInstance().getStore();
+        if (contextObject[key])
+            delete contextObject[key];
+        if (!contextObject)
+            throw new Error("No active context found. Use Context.getInstance().run() or use the context middleware.");
+        return contextObject;
+    }
+    static safeRemove(key) {
+        const contextObject = Context.getInstance().getStore();
+        if (!contextObject[key])
+            throw new Error("You are trying to remove something that does not exist.");
+        return Context.remove(key);
+    }
+}
+exports.Context = Context;
+//# sourceMappingURL=context.js.map

package/dist/core/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../core/context.ts"],"names":[],"mappings":";;;AAAA,uDAAqD;AAErD;;;GAGG;AACH,MAAa,OAAO;IAOlB;;;;OAIG;IACH;QACE,OAAO,CAAC,yBAAyB,GAAG,IAAI,oCAAiB,EAAE,CAAC;IAC9D,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,WAAW;QAChB,IAAI,CAAC,OAAO,CAAC,yBAAyB,EAAE,CAAC;YACvC,IAAI,OAAO,EAAE,CAAC;QAChB,CAAC;QACD,OAAO,OAAO,CAAC,yBAAyB,CAAC;IAC3C,CAAC;IAED;;;;;;;;OAQG;IACH,MAAM,CAAC,QAAQ,CAAC,GAAW,EAAE,KAAU;QACrC,MAAM,aAAa,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,QAAQ,EAGnD,CAAC;QACF,IAAI,CAAC,aAAa;YAChB,MAAM,IAAI,KAAK,CACb,yFAAyF,CAC1F,CAAC;QAEJ,aAAa,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QAC3B,OAAO,aAAa,CAAC;IACvB,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,cAAc,CAAC,MAA2B;QAC/C,MAAM,aAAa,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE,CAAC;QACvD,IAAI,CAAC,aAAa;YAChB,MAAM,IAAI,KAAK,CACb,yFAAyF,CAC1F,CAAC;QAEJ,OAAO,MAAM,CAAC,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;IAC9C,CAAC;IAED,MAAM,CAAC,MAAM,CAAC,GAAW;QACvB,MAAM,aAAa,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,QAAQ,EAGnD,CAAC;QAEF,IAAI,aAAa,CAAC,GAAG,CAAC;YAAE,OAAO,aAAa,CAAC,GAAG,CAAC,CAAC;QAClD,IAAI,CAAC,aAAa;YAChB,MAAM,IAAI,KAAK,CACb,yFAAyF,CAC1F,CAAC;QAEJ,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,MAAM,CAAC,UAAU,CAAC,GAAW;QAC3B,MAAM,aAAa,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,QAAQ,EAGnD,CAAC;QAEF,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC;YACrB,MAAM,IAAI,KAAK,CACb,yDAAyD,CAC1D,CAAC;QACJ,OAAO,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;CACF;AAhGD,0BAgGC"}

package/dist/core/index.d.ts

@@ -0,0 +1,5 @@
+export { Context } from './context';
+export { AsyncContextExpresssMiddleware } from './integrations/express';
+export { AsyncContextNestMiddleware } from './integrations/nest';
+export { AsyncContextAdonisMiddleware } from './integrations/adonis';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,8BAA8B,EAAE,MAAM,wBAAwB,CAAC;AACxE,OAAO,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/core/index.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AsyncContextAdonisMiddleware = exports.AsyncContextNestMiddleware = exports.AsyncContextExpresssMiddleware = exports.Context = void 0;
+var context_1 = require("./context");
+Object.defineProperty(exports, "Context", { enumerable: true, get: function () { return context_1.Context; } });
+var express_1 = require("./integrations/express");
+Object.defineProperty(exports, "AsyncContextExpresssMiddleware", { enumerable: true, get: function () { return express_1.AsyncContextExpresssMiddleware; } });
+var nest_1 = require("./integrations/nest");
+Object.defineProperty(exports, "AsyncContextNestMiddleware", { enumerable: true, get: function () { return nest_1.AsyncContextNestMiddleware; } });
+var adonis_1 = require("./integrations/adonis");
+Object.defineProperty(exports, "AsyncContextAdonisMiddleware", { enumerable: true, get: function () { return adonis_1.AsyncContextAdonisMiddleware; } });
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../core/index.ts"],"names":[],"mappings":";;;AAAA,qCAAoC;AAA3B,kGAAA,OAAO,OAAA;AAChB,kDAAwE;AAA/D,yHAAA,8BAA8B,OAAA;AACvC,4CAAiE;AAAxD,kHAAA,0BAA0B,OAAA;AACnC,gDAAqE;AAA5D,sHAAA,4BAA4B,OAAA"}

package/dist/core/integrations/adonis.d.ts

@@ -0,0 +1,14 @@
+type NextFunction = () => Promise<unknown>;
+type AdonisContext = Record<string, unknown>;
+/**
+ * AdonisJS middleware that initializes a new asynchronous context
+ * for each incoming request.
+ *
+ * Compatible with AdonisJS' middleware signature:
+ * `async handle(ctx, next)`.
+ */
+export declare class AsyncContextAdonisMiddleware {
+    handle(_ctx: AdonisContext, next: NextFunction): Promise<unknown>;
+}
+export {};
+//# sourceMappingURL=adonis.d.ts.map

package/dist/core/integrations/adonis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adonis.d.ts","sourceRoot":"","sources":["../../../core/integrations/adonis.ts"],"names":[],"mappings":"AAGA,KAAK,YAAY,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;AAC3C,KAAK,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE7C;;;;;;GAMG;AACH,qBAAa,4BAA4B;IACjC,MAAM,CAAC,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,YAAY;CAMrD"}

package/dist/core/integrations/adonis.js

@@ -0,0 +1,24 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AsyncContextAdonisMiddleware = void 0;
+const node_crypto_1 = __importDefault(require("node:crypto"));
+const context_1 = require("../context");
+/**
+ * AdonisJS middleware that initializes a new asynchronous context
+ * for each incoming request.
+ *
+ * Compatible with AdonisJS' middleware signature:
+ * `async handle(ctx, next)`.
+ */
+class AsyncContextAdonisMiddleware {
+    async handle(_ctx, next) {
+        const uuid = node_crypto_1.default.randomUUID();
+        const localStorageInstance = context_1.Context.getInstance();
+        return localStorageInstance.run({ instance_id: uuid }, () => next());
+    }
+}
+exports.AsyncContextAdonisMiddleware = AsyncContextAdonisMiddleware;
+//# sourceMappingURL=adonis.js.map

package/dist/core/integrations/adonis.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adonis.js","sourceRoot":"","sources":["../../../core/integrations/adonis.ts"],"names":[],"mappings":";;;;;;AAAA,8DAAiC;AACjC,wCAAqC;AAKrC;;;;;;GAMG;AACH,MAAa,4BAA4B;IACvC,KAAK,CAAC,MAAM,CAAC,IAAmB,EAAE,IAAkB;QAClD,MAAM,IAAI,GAAG,qBAAM,CAAC,UAAU,EAAE,CAAC;QACjC,MAAM,oBAAoB,GAAG,iBAAO,CAAC,WAAW,EAAE,CAAC;QAEnD,OAAO,oBAAoB,CAAC,GAAG,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;IACvE,CAAC;CACF;AAPD,oEAOC"}

package/dist/core/integrations/express.d.ts

@@ -0,0 +1,44 @@
+import type * as http from "node:http";
+/**
+ * Express middleware that initializes a new asynchronous context
+ * for each incoming request.
+ *
+ * This middleware assigns a unique `instance_id` (UUID) to the
+ * request lifecycle and stores it inside AsyncLocalStorage,
+ * allowing the application to later retrieve per-request data
+ * without passing parameters through function calls.
+ *
+ * It is designed to simplify building request-scoped state,
+ * such as logging correlation IDs or storing metadata across
+ * asynchronous operations.
+ *
+ * @function AsyncContextExpressMiddleware
+ *
+ * @param {http.IncomingMessage} req - The current HTTP request.
+ * @param {http.ServerResponse} res - The current HTTP response.
+ * @param {Function} next - Express continuation callback.
+ *
+ * @example
+ * // Usage in an Express application
+ * import express from "express";
+ * import { AsyncContextExpressMiddleware } from "@marceloraineri/async-context";
+ *
+ * const app = express();
+ *
+ * app.use(AsyncContextExpressMiddleware);
+ *
+ * app.get("/test", (req, res) => {
+ *   const context = Context.getInstance().getStore();
+ *   console.log(context.instance_id); // Unique per request
+ *   res.send("OK");
+ * });
+ *
+ * @description
+ * A new asynchronous context is created via:
+ * `Context.getInstance().run({ instance_id: <uuid> }, ...)`
+ *
+ * This ensures that all async operations inside the request
+ * share the same context object until the request completes.
+ */
+export declare function AsyncContextExpresssMiddleware(req: http.IncomingMessage, res: http.ServerResponse, next: () => void): void;
+//# sourceMappingURL=express.d.ts.map

package/dist/core/integrations/express.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"express.d.ts","sourceRoot":"","sources":["../../../core/integrations/express.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,IAAI,MAAM,WAAW,CAAC;AAIvC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAEH,wBAAgB,8BAA8B,CAC5C,GAAG,EAAE,IAAI,CAAC,eAAe,EACzB,GAAG,EAAE,IAAI,CAAC,cAAc,EACxB,IAAI,EAAE,MAAM,IAAI,QAMjB"}

package/dist/core/integrations/express.js

@@ -0,0 +1,55 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AsyncContextExpresssMiddleware = AsyncContextExpresssMiddleware;
+const node_crypto_1 = __importDefault(require("node:crypto"));
+const context_1 = require("../context");
+/**
+ * Express middleware that initializes a new asynchronous context
+ * for each incoming request.
+ *
+ * This middleware assigns a unique `instance_id` (UUID) to the
+ * request lifecycle and stores it inside AsyncLocalStorage,
+ * allowing the application to later retrieve per-request data
+ * without passing parameters through function calls.
+ *
+ * It is designed to simplify building request-scoped state,
+ * such as logging correlation IDs or storing metadata across
+ * asynchronous operations.
+ *
+ * @function AsyncContextExpressMiddleware
+ *
+ * @param {http.IncomingMessage} req - The current HTTP request.
+ * @param {http.ServerResponse} res - The current HTTP response.
+ * @param {Function} next - Express continuation callback.
+ *
+ * @example
+ * // Usage in an Express application
+ * import express from "express";
+ * import { AsyncContextExpressMiddleware } from "@marceloraineri/async-context";
+ *
+ * const app = express();
+ *
+ * app.use(AsyncContextExpressMiddleware);
+ *
+ * app.get("/test", (req, res) => {
+ *   const context = Context.getInstance().getStore();
+ *   console.log(context.instance_id); // Unique per request
+ *   res.send("OK");
+ * });
+ *
+ * @description
+ * A new asynchronous context is created via:
+ * `Context.getInstance().run({ instance_id: <uuid> }, ...)`
+ *
+ * This ensures that all async operations inside the request
+ * share the same context object until the request completes.
+ */
+function AsyncContextExpresssMiddleware(req, res, next) {
+    const uuid = node_crypto_1.default.randomUUID();
+    const LocalStorageInstance = context_1.Context.getInstance();
+    LocalStorageInstance.run({ instance_id: uuid }, () => next());
+}
+//# sourceMappingURL=express.js.map

package/dist/core/integrations/express.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"express.js","sourceRoot":"","sources":["../../../core/integrations/express.ts"],"names":[],"mappings":";;;;;AA8CA,wEASC;AAtDD,8DAAiC;AACjC,wCAAqC;AAErC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAEH,SAAgB,8BAA8B,CAC5C,GAAyB,EACzB,GAAwB,EACxB,IAAgB;IAEhB,MAAM,IAAI,GAAG,qBAAM,CAAC,UAAU,EAAE,CAAC;IACjC,MAAM,oBAAoB,GAAG,iBAAO,CAAC,WAAW,EAAE,CAAC;IAEnD,oBAAoB,CAAC,GAAG,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;AAChE,CAAC"}

package/dist/core/integrations/nest.d.ts

@@ -0,0 +1,12 @@
+type NextFunction = () => void;
+/**
+ * Nest middleware that reuses the Express integration to initialize
+ * a new asynchronous context for each incoming request.
+ *
+ * Works with the default Nest Express adapter.
+ */
+export declare class AsyncContextNestMiddleware {
+    use(req: unknown, res: unknown, next: NextFunction): void;
+}
+export {};
+//# sourceMappingURL=nest.d.ts.map

package/dist/core/integrations/nest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nest.d.ts","sourceRoot":"","sources":["../../../core/integrations/nest.ts"],"names":[],"mappings":"AAEA,KAAK,YAAY,GAAG,MAAM,IAAI,CAAC;AAE/B;;;;;GAKG;AACH,qBAAa,0BAA0B;IACrC,GAAG,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY;CAOnD"}

package/dist/core/integrations/nest.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AsyncContextNestMiddleware = void 0;
+const express_1 = require("./express");
+/**
+ * Nest middleware that reuses the Express integration to initialize
+ * a new asynchronous context for each incoming request.
+ *
+ * Works with the default Nest Express adapter.
+ */
+class AsyncContextNestMiddleware {
+    use(req, res, next) {
+        (0, express_1.AsyncContextExpresssMiddleware)(req, res, next);
+    }
+}
+exports.AsyncContextNestMiddleware = AsyncContextNestMiddleware;
+//# sourceMappingURL=nest.js.map

package/dist/core/integrations/nest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nest.js","sourceRoot":"","sources":["../../../core/integrations/nest.ts"],"names":[],"mappings":";;;AAAA,uCAA2D;AAI3D;;;;;GAKG;AACH,MAAa,0BAA0B;IACrC,GAAG,CAAC,GAAY,EAAE,GAAY,EAAE,IAAkB;QAChD,IAAA,wCAA8B,EAC5B,GAA2D,EAC3D,GAA2D,EAC3D,IAAI,CACL,CAAC;IACJ,CAAC;CACF;AARD,gEAQC"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { Context } from "./core/context";
+export { AsyncContextExpresssMiddleware } from "./core/integrations/express";
+export { AsyncContextNestMiddleware } from "./core/integrations/nest";
+export { AsyncContextAdonisMiddleware } from "./core/integrations/adonis";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACzC,OAAO,EAAE,8BAA8B,EAAE,MAAM,6BAA6B,CAAC;AAC7E,OAAO,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,EAAE,4BAA4B,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/index.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AsyncContextAdonisMiddleware = exports.AsyncContextNestMiddleware = exports.AsyncContextExpresssMiddleware = exports.Context = void 0;
+var context_1 = require("./core/context");
+Object.defineProperty(exports, "Context", { enumerable: true, get: function () { return context_1.Context; } });
+var express_1 = require("./core/integrations/express");
+Object.defineProperty(exports, "AsyncContextExpresssMiddleware", { enumerable: true, get: function () { return express_1.AsyncContextExpresssMiddleware; } });
+var nest_1 = require("./core/integrations/nest");
+Object.defineProperty(exports, "AsyncContextNestMiddleware", { enumerable: true, get: function () { return nest_1.AsyncContextNestMiddleware; } });
+var adonis_1 = require("./core/integrations/adonis");
+Object.defineProperty(exports, "AsyncContextAdonisMiddleware", { enumerable: true, get: function () { return adonis_1.AsyncContextAdonisMiddleware; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":";;;AAAA,0CAAyC;AAAhC,kGAAA,OAAO,OAAA;AAChB,uDAA6E;AAApE,yHAAA,8BAA8B,OAAA;AACvC,iDAAsE;AAA7D,kHAAA,0BAA0B,OAAA;AACnC,qDAA0E;AAAjE,sHAAA,4BAA4B,OAAA"}

package/package.json

@@ -1,10 +1,26 @@
 {
   "name": "@marceloraineri/async-context",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "",
-  "main": "index.js",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "require": "./dist/index.js",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
   "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1"
+    "test": "echo \"Error: no test specified\" && exit 1",
+    "dev": "tsx watch --inspect core/index.ts",
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
   },
   "repository": {
     "type": "git",
@@ -18,6 +34,8 @@
   "homepage": "https://github.com/ohraineri/AsyncContext#readme",
   "devDependencies": {
     "@types/node": "^24.10.1",
+    "eslint": "^9.39.1",
+    "tsx": "^4.20.6",
     "typescript": "^5.9.3"
   }
 }

package/index.js

@@ -1,31 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Context = void 0;
-var node_async_hooks_1 = require("node:async_hooks");
-var Context = /** @class */ (function () {
-    function Context() {
-        Context.asyncLocalStorageInstance = new node_async_hooks_1.AsyncLocalStorage();
-    }
-    Context.getInstance = function () {
-        if (!Context.asyncLocalStorageInstance) {
-            new Context();
-        }
-        return Context.asyncLocalStorageInstance;
-    };
-    Context.addValue = function (key, value) {
-        var contextObject = Context.getInstance().getStore();
-        if (!contextObject)
-            throw new Error('Nenhum contexto ativo encontrado. Use Context.getInstance().run().');
-        contextObject[key] = value;
-        return contextObject;
-    };
-    Context.addObjectValue = function (object) {
-        var contextObject = Context.getInstance().getStore();
-        if (!contextObject)
-            throw new Error('Nenhum contexto ativo encontrado. Use Context.getInstance().run().');
-        var merged = Object.assign(contextObject, object);
-        return merged;
-    };
-    return Context;
-}());
-exports.Context = Context;

package/index.ts

@@ -1,38 +0,0 @@
-import { AsyncLocalStorage } from 'node:async_hooks';
-
-type objectStorageType = {
-    [key: string] : unknown
-}
-
-export class Context {
-  static asyncLocalStorageInstance: AsyncLocalStorage<unknown>;
-
-  private constructor() {
-    Context.asyncLocalStorageInstance = new AsyncLocalStorage();
-  }
-
-  static getInstance() {
-    if (!Context.asyncLocalStorageInstance) {
-      new Context();
-    }
-    return Context.asyncLocalStorageInstance;
-  }
-
-  static addValue(key: string, value: any) {
-    const contextObject = Context.getInstance().getStore() as Record<string, any>;
-    if (!contextObject)
-      throw new Error('Nenhum contexto ativo encontrado. Use Context.getInstance().run().');
-
-    contextObject[key] = value;
-    return contextObject;
-  }
-
-  static addObjectValue(object: Record<string, any>) {
-    const contextObject = Context.getInstance().getStore();
-    if (!contextObject)
-      throw new Error('Nenhum contexto ativo encontrado. Use Context.getInstance().run().');
-
-    const merged = Object.assign(contextObject, object);
-    return merged;
-  }
-}