@marceloraineri/async-context 1.0.1 → 1.1.0

package/README.md

@@ -14,7 +14,7 @@ AsyncContext is a tiny utility library that standardizes how you propagate conte
 ## Installation
 
 ```bash
-npm i @marceloraineri/a@marceloraineri/async-context
+npm i @marceloraineri/async-context
 ```
 
 When developing locally inside this repo, import from the relative `core` entry point instead.
@@ -55,6 +55,37 @@ app.get("/ping", (_req, res) => {
 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`
@@ -63,13 +94,19 @@ Returns (and lazily instantiates) the singleton `AsyncLocalStorage` used by the
 ### `Context.addObjectValue(values: Record<string, unknown>): Record<string, unknown>`
 Merges the provided object into the active context. Also throws if no context is active.
 
-### `AAsyncContextExpresssMiddleware(req, res, next)`
+### `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.
@@ -79,7 +116,3 @@ Express middleware that:
 ## Contributing
 
 Issues and pull requests are welcome. Please include reproduction steps or tests whenever you propose a change to the async context behavior.
-
-## License
-
-Specify the desired license (e.g., MIT) here.

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/{core/integrations/express.ts → dist/core/integrations/express.d.ts}

@@ -1,10 +1,7 @@
 import type * as http from "node:http";
-import crypto from "node:crypto";
-import { Context } from "../..";
-
 /**
  * Express middleware that initializes a new asynchronous context
- * for each incoming request.  
+ * for each incoming request.
  *
  * This middleware assigns a unique `instance_id` (UUID) to the
  * request lifecycle and stores it inside AsyncLocalStorage,
@@ -43,14 +40,5 @@ import { Context } from "../..";
  * This ensures that all async operations inside the request
  * share the same context object until the request completes.
  */
-
-export function AsyncContextExpresssMiddleware(
-  req: http.IncomingMessage,
-  res: http.ServerResponse,
-  next: () => void
-) {
-  const uuid = crypto.randomUUID();
-  const LocalStorageInstance = Context.getInstance();
-
-  LocalStorageInstance.run({ instance_id: uuid }, () => next());
-}
+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,12 +1,26 @@
 {
   "name": "@marceloraineri/async-context",
-  "version": "1.0.1",
+  "version": "1.1.0",
   "description": "",
-  "main": "core/index.ts",
+  "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",
     "dev": "tsx watch --inspect core/index.ts",
-    "build": "tsc"
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
   },
   "repository": {
     "type": "git",
@@ -21,8 +35,6 @@
   "devDependencies": {
     "@types/node": "^24.10.1",
     "eslint": "^9.39.1",
-    "ts-node": "^10.9.2",
-    "ts-node-dev": "^2.0.0",
     "tsx": "^4.20.6",
     "typescript": "^5.9.3"
   }

package/core/context.ts

@@ -1,76 +0,0 @@
-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 class Context {
-  /**
-   * Singleton instance of AsyncLocalStorage.
-   * @type {AsyncLocalStorage<unknown>}
-   */
-  public static asyncLocalStorageInstance: AsyncLocalStorage<unknown>;
-
-  /**
-   * Private constructor initializes the AsyncLocalStorage instance.
-   * Called automatically when the instance does not yet exist.
-   * @private
-   */
-  private constructor() {
-    Context.asyncLocalStorageInstance = new AsyncLocalStorage();
-  }
-
-  /**
-   * Returns the global AsyncLocalStorage instance, creating it if necessary.
-   *
-   * @returns {AsyncLocalStorage<unknown>} The AsyncLocalStorage singleton.
-   */
-  static getInstance(): AsyncLocalStorage<unknown> {
-    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: string, value: any) {
-    const contextObject = Context.getInstance().getStore() as Record<
-      string,
-      any
-    >;
-    if (!contextObject)
-      throw new Error(
-        "No active context found. Use Context.getInstance().run()."
-      );
-
-    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: Record<string, any>) {
-    const contextObject = Context.getInstance().getStore();
-    if (!contextObject)
-      throw new Error(
-        "No active context found. Use Context.getInstance().run()."
-      );
-
-    const merged = Object.assign(contextObject, object);
-    return merged;
-  }
-}

package/core/index.ts

@@ -1,2 +0,0 @@
-export { Context } from './context';
-export { AsyncContextExpresssMiddleware } from './integrations/express';