reqlocal 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 reqlocal contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,340 @@
+<div align="center">
+
+<br />
+
+<img src="./docs/logo-mark.svg" alt="reqlocal" width="72" height="72" />
+
+# reqlocal
+
+### Stop threading context. One middleware.
+
+[![npm](https://img.shields.io/npm/v/reqlocal?style=flat-square&color=2dd4bf&label=npm)](https://www.npmjs.com/package/reqlocal)
+[![downloads](https://img.shields.io/npm/dm/reqlocal?style=flat-square&color=34d399&label=downloads)](https://www.npmjs.com/package/reqlocal)
+[![minzipped size](https://img.shields.io/bundlephobia/minzip/reqlocal?style=flat-square&color=059669&label=minzipped%20size)](https://bundlephobia.com/package/reqlocal)
+[![license](https://img.shields.io/badge/license-MIT-34d399?style=flat-square)](./LICENSE)
+
+<br />
+
+Open-source **request-scoped context** for Node.js with **`AsyncLocalStorage`**: typed **`getCtx()`** anywhere in the request lifecycle, without passing bags of arguments through every helper.
+
+**Zero runtime dependencies.** TypeScript-first. Works with **Express** and **Fastify**.
+
+<br />
+
+[Repo](https://github.com/Abdul-Moiz31/reqlocal) · [Install](#install) · [Why this exists](#why-i-built-this) · [API](#api-reference)
+
+<br />
+
+---
+
+</div>
+
+## Why I built this
+
+This did not come from a toy example. It came from **adminIde-stack**, the big multi-tenant stack I work on: GraphQL, Auth0, billing, org and project context, subscriptions, and a `ServerContext` type that keeps growing because every package augments the same central context interface.
+
+In that codebase, a single request is not just headers and a body. You end up with account id, org id, tenant id, permissions, parsed URI segments for the current page, sometimes a WebSocket connection with `connectionParams` instead of a normal `req`, and special paths like secret API tokens. Middleware like `addUserContext` has to branch across HTTP, WebSocket, and token flows, and downstream code still expects something that looks like a request so helpers such as `getPermissionsFromContext` can read `context.req`, `context.userContext`, and `context.user` together. Plugins do the same kind of thing, for example resolving tenant off `requestContext.contextValue.req?.tenant` before an operation runs.
+
+So the "real time" problem was not only long parameter lists. It was that **everything interesting about the caller lived inside a fat GraphQL context and a stuffed `req`**, and serious logic could not run unless you threaded that whole picture through resolvers, middleware, and services. When subscriptions need a mock `req` so the same permission code can run, you feel how heavy that model is.
+
+**reqlocal** is what I wanted for the other end of the spectrum: small HTTP services, edge functions on the Node runtime, internal APIs, and tests. You define a **narrow** request-scoped object once at the edge. After that you call **`getCtx()`** instead of dragging a god object through every layer. It uses the same primitive Node gives you for async-safe isolation: **`AsyncLocalStorage`**. No extra runtime dependencies, just **`reqlocal`** middleware (or the Fastify plugin) plus **`runWithCtx`** when you are not inside Express.
+
+It does not replace a full Apollo `ServerContext` on its own. It is the distilled habit I wish I had everywhere: **establish scope once, read it anywhere in the async tree**, without inventing another global or another ten constructor arguments.
+
+If you have lived in a stack like adminIde-stack, you already know why that matters.
+
+## Install
+
+```bash
+npm install reqlocal
+```
+
+```bash
+pnpm add reqlocal
+```
+
+```bash
+yarn add reqlocal
+```
+
+For **`reqlocalPlugin`** (Fastify), add the optional peer:
+
+```bash
+npm install reqlocal fastify
+```
+
+## Usage
+
+```ts
+import express from 'express';
+import { reqlocal, getCtx } from 'reqlocal';
+
+const app = express();
+
+app.use(
+  reqlocal({
+    userId: (req) => String(req.headers['x-user-id'] ?? ''),
+  }),
+);
+
+app.get('/me', (_req, res) => {
+  const { userId } = getCtx<{ userId: string }>();
+  res.json({ userId });
+});
+```
+
+Typed context for the whole request, including after `await`, without threading arguments through every helper.
+
+## Before and after
+
+**Manual threading**
+
+```ts
+async function loadProfile(userId: string, traceId: string) {
+  return db.profiles.find({ userId, traceId });
+}
+
+app.get('/me', async (req, res) => {
+  const userId = req.headers['x-user-id'] as string;
+  const traceId = req.headers['x-trace-id'] as string;
+  const profile = await loadProfile(userId, traceId);
+  res.json(profile);
+});
+```
+
+**reqlocal**
+
+```ts
+async function loadProfile() {
+  const { userId, traceId } = getCtx<{ userId: string; traceId: string }>();
+  return db.profiles.find({ userId, traceId });
+}
+
+app.get('/me', async (_req, res) => {
+  const profile = await loadProfile();
+  res.json(profile);
+});
+```
+
+## TypeScript
+
+```ts
+import type { InferContext } from 'reqlocal';
+
+const contextConfig = {
+  userId: (req) => String(req.headers['x-user-id'] ?? ''),
+  traceId: (req) => String(req.headers['x-trace-id'] ?? ''),
+  requestStartedAt: () => Date.now(),
+} as const;
+
+type AppContext = InferContext<typeof contextConfig>;
+
+function audit(): AppContext {
+  return getCtx<AppContext>();
+}
+```
+
+## Background jobs and tests
+
+```ts
+import { runWithCtx, getCtx } from 'reqlocal';
+
+await runWithCtx({ jobId: '42', source: 'nightly' }, async () => {
+  const ctx = getCtx<{ jobId: string; source: string }>();
+  await doWork(ctx.jobId);
+});
+```
+
+Nested **`runWithCtx`** calls stack correctly with HTTP-bound context.
+
+## Framework integrations
+
+### Express (middleware)
+
+```ts
+import express from 'express';
+import { reqlocal, getCtx } from 'reqlocal';
+
+const app = express();
+
+app.use(
+  reqlocal({
+    userId: (req) => String(req.headers['x-user-id'] ?? ''),
+    traceId: (req) => String(req.headers['x-trace-id'] ?? ''),
+  }),
+);
+
+app.get('/api/hello', (_req, res) => {
+  res.json(getCtx<{ userId: string; traceId: string }>());
+});
+```
+
+Mount **`reqlocal`** **before** any route or middleware that calls **`getCtx()`**.
+
+### Fastify (plugin)
+
+```ts
+import Fastify from 'fastify';
+import { reqlocalPlugin, getCtx } from 'reqlocal';
+
+const app = Fastify();
+
+await app.register(reqlocalPlugin, {
+  config: {
+    userId: (req) => String(req.headers['x-user-id'] ?? ''),
+  },
+});
+
+app.get('/api/me', async () => getCtx<{ userId: string }>());
+```
+
+Config callbacks receive the Node **`IncomingMessage`** (`request.raw`).
+
+### Next.js (route handler, Node runtime)
+
+Use the **Node.js** runtime (not Edge). Establish context with **`runWithCtx`** when you are not behind Express:
+
+```ts
+import { NextResponse } from 'next/server';
+import { runWithCtx, getCtx } from 'reqlocal';
+
+export async function GET(request: Request) {
+  const userId = request.headers.get('x-user-id') ?? '';
+
+  return runWithCtx({ userId }, async () => {
+    const ctx = getCtx<{ userId: string }>();
+    return NextResponse.json({ ok: true, userId: ctx.userId });
+  });
+}
+```
+
+## How it works
+
+```
+HTTP request
+    │
+    ▼
+┌──────────────────┐     ┌────────────────────────────┐
+│ reqlocal         │────▶│ Build context object        │
+│ middleware       │     │ (headers, auth, traceId…)   │
+└────────┬─────────┘     └────────────────────────────┘
+         │
+         ▼
+┌──────────────────┐     ┌────────────────────────────┐
+│ AsyncLocalStorage │────▶│ One store per request       │
+│ .run(store, …)   │     │ Survives await / microtasks │
+└────────┬─────────┘     └────────────────────────────┘
+         │
+         ▼
+┌──────────────────┐     ┌────────────────────────────┐
+│ Route + services │────▶│ getCtx() / getCtxOrNull()   │
+└──────────────────┘     └────────────────────────────┘
+```
+
+Each concurrent request gets an isolated store. No `cls-hooked` and no extra npm runtime dependencies: only Node’s built-in ALS.
+
+## Comparison
+
+| | reqlocal | Manual threading | Implicit globals |
+| --- | :---: | :---: | :---: |
+| **Typed context** | ✅ | ✅ (verbose) | ❌ |
+| **Works after `await`** | ✅ | ✅ | ⚠️ error-prone |
+| **Zero extra runtime deps** | ✅ | ✅ | ✅ |
+| **Concurrent requests safe** | ✅ | ✅ | ❌ |
+| **Express / Fastify** | ✅ | ✅ | ⚠️ ad hoc |
+| **`fastify-plugin` wrapper** | ✅ | N/A | N/A |
+
+## API reference
+
+### `getCtx<T>(): T`
+
+Returns the current context object. **Throws** if called outside an active store:
+
+```txt
+[reqlocal] getCtx() called outside a request context. Make sure reqlocal middleware runs before your route handlers.
+```
+
+### `getCtxOrNull<T>(): T | null`
+
+Same as **`getCtx`**, but returns **`null`** when no store is active.
+
+### `runWithCtx(ctx, fn): Promise`
+
+Runs **`fn`** (must return a **`Promise`**) inside a new store. Use for workers, queues, and tests.
+
+### `reqlocal(config): Middleware`
+
+Express / Connect middleware. **`config`** maps string keys to **`(req: IncomingMessage) => value`**.
+
+### `reqlocalPlugin`
+
+Fastify plugin (via **`fastify-plugin`**). Register with **`{ config }`** in the same shape as Express.
+
+### Exported types
+
+| Type | Description |
+| --- | --- |
+| `ContextConfig` | Keys → `(req: IncomingMessage) => unknown` |
+| `InferContext<C>` | Inferred context shape from **`C`** |
+| `ReqlocalMiddleware` | Connect-compatible middleware type |
+| `ReqlocalFastifyOptions` | `{ config: ContextConfig }` |
+
+## Package exports
+
+Dual **ESM** (`.mjs`) and **CommonJS** (`.js`) with shared **`.d.ts`**:
+
+```json
+"exports": {
+  ".": {
+    "types": "./dist/index.d.ts",
+    "import": "./dist/index.mjs",
+    "require": "./dist/index.js"
+  }
+}
+```
+
+## Requirements
+
+- **Node.js ≥ 16.0.0** (`AsyncLocalStorage`)
+
+## Developing
+
+```bash
+npm install
+npm test
+npm run build
+```
+
+Tests: **Vitest** (`tests/context`, `concurrent`, `express`, `fastify`). Source: **`src/`** (tsup → **`dist/`**).
+
+## Publishing
+
+1. Set **`repository`**, **`author`**, and **`version`** in **`package.json`**
+2. **`npm test`** && **`npm run build`**
+3. **`npm publish`**
+
+Badges may show “package not found” until the first npm publish.
+
+## Contributing
+
+Issues and PRs welcome. Please run **`npm test`** before submitting.
+
+## Marketing site
+
+If you use the optional Next.js app in a monorepo (`Website/`), run `cd Website && npm install && npm run dev` and open **http://localhost:3000/docs**. This repository’s README is self-contained for npm and GitHub.
+
+## License
+
+MIT. Use it in any project, commercial or open-source. See **[LICENSE](./LICENSE)**.
+
+---
+
+<div align="center">
+
+<br />
+
+**Built by** [@Abdul-Moiz31](https://github.com/Abdul-Moiz31)
+
+<br />
+
+</div>

package/dist/index.d.cts

@@ -0,0 +1,23 @@
+import { IncomingMessage, ServerResponse } from 'node:http';
+import { FastifyPluginAsync } from 'fastify';
+
+declare function getCtx<T extends Record<string, unknown> = Record<string, unknown>>(): T;
+declare function getCtxOrNull<T extends Record<string, unknown> = Record<string, unknown>>(): T | null;
+declare function runWithCtx<TCtx extends Record<string, unknown>, TResult>(ctx: TCtx, fn: () => Promise<TResult>): Promise<TResult>;
+
+type ContextConfig = {
+    readonly [K: string]: (req: IncomingMessage) => unknown;
+};
+type InferContext<C extends ContextConfig> = {
+    [K in keyof C]: C[K] extends (req: IncomingMessage) => infer R ? R : never;
+};
+type ReqlocalMiddleware = (req: IncomingMessage, res: ServerResponse, next: (err?: unknown) => void) => void;
+
+declare function reqlocal<C extends ContextConfig>(config: C): (req: IncomingMessage, res: ServerResponse, next: (err?: unknown) => void) => void;
+
+type ReqlocalFastifyOptions = {
+    config: ContextConfig;
+};
+declare const reqlocalPlugin: FastifyPluginAsync<ReqlocalFastifyOptions>;
+
+export { type ContextConfig, type InferContext, type ReqlocalFastifyOptions, type ReqlocalMiddleware, getCtx, getCtxOrNull, reqlocal, reqlocalPlugin, runWithCtx };

package/dist/index.d.ts

@@ -0,0 +1,23 @@
+import { IncomingMessage, ServerResponse } from 'node:http';
+import { FastifyPluginAsync } from 'fastify';
+
+declare function getCtx<T extends Record<string, unknown> = Record<string, unknown>>(): T;
+declare function getCtxOrNull<T extends Record<string, unknown> = Record<string, unknown>>(): T | null;
+declare function runWithCtx<TCtx extends Record<string, unknown>, TResult>(ctx: TCtx, fn: () => Promise<TResult>): Promise<TResult>;
+
+type ContextConfig = {
+    readonly [K: string]: (req: IncomingMessage) => unknown;
+};
+type InferContext<C extends ContextConfig> = {
+    [K in keyof C]: C[K] extends (req: IncomingMessage) => infer R ? R : never;
+};
+type ReqlocalMiddleware = (req: IncomingMessage, res: ServerResponse, next: (err?: unknown) => void) => void;
+
+declare function reqlocal<C extends ContextConfig>(config: C): (req: IncomingMessage, res: ServerResponse, next: (err?: unknown) => void) => void;
+
+type ReqlocalFastifyOptions = {
+    config: ContextConfig;
+};
+declare const reqlocalPlugin: FastifyPluginAsync<ReqlocalFastifyOptions>;
+
+export { type ContextConfig, type InferContext, type ReqlocalFastifyOptions, type ReqlocalMiddleware, getCtx, getCtxOrNull, reqlocal, reqlocalPlugin, runWithCtx };

package/dist/index.js

@@ -0,0 +1,177 @@
+'use strict';
+
+var async_hooks = require('async_hooks');
+
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __commonJS = (cb, mod) => function __require() {
+  return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  __defProp(target, "default", { value: mod, enumerable: true }) ,
+  mod
+));
+
+// node_modules/fastify-plugin/lib/getPluginName.js
+var require_getPluginName = __commonJS({
+  "node_modules/fastify-plugin/lib/getPluginName.js"(exports$1, module) {
+    var fpStackTracePattern = /at\s{1}(?:.*\.)?plugin\s{1}.*\n\s*(.*)/;
+    var fileNamePattern = /(\w*(\.\w*)*)\..*/;
+    module.exports = function getPluginName(fn) {
+      if (fn.name.length > 0) return fn.name;
+      const stackTraceLimit = Error.stackTraceLimit;
+      Error.stackTraceLimit = 10;
+      try {
+        throw new Error("anonymous function");
+      } catch (e) {
+        Error.stackTraceLimit = stackTraceLimit;
+        return extractPluginName(e.stack);
+      }
+    };
+    function extractPluginName(stack) {
+      const m = stack.match(fpStackTracePattern);
+      return m ? m[1].split(/[/\\]/).slice(-1)[0].match(fileNamePattern)[1] : "anonymous";
+    }
+    module.exports.extractPluginName = extractPluginName;
+  }
+});
+
+// node_modules/fastify-plugin/lib/toCamelCase.js
+var require_toCamelCase = __commonJS({
+  "node_modules/fastify-plugin/lib/toCamelCase.js"(exports$1, module) {
+    module.exports = function toCamelCase(name) {
+      if (name[0] === "@") {
+        name = name.slice(1).replace("/", "-");
+      }
+      const newName = name.replace(/-(.)/g, function(match, g1) {
+        return g1.toUpperCase();
+      });
+      return newName;
+    };
+  }
+});
+
+// node_modules/fastify-plugin/plugin.js
+var require_plugin = __commonJS({
+  "node_modules/fastify-plugin/plugin.js"(exports$1, module) {
+    var getPluginName = require_getPluginName();
+    var toCamelCase = require_toCamelCase();
+    var count = 0;
+    function plugin(fn, options = {}) {
+      let autoName = false;
+      if (typeof fn.default !== "undefined") {
+        fn = fn.default;
+      }
+      if (typeof fn !== "function") {
+        throw new TypeError(
+          `fastify-plugin expects a function, instead got a '${typeof fn}'`
+        );
+      }
+      if (typeof options === "string") {
+        options = {
+          fastify: options
+        };
+      }
+      if (typeof options !== "object" || Array.isArray(options) || options === null) {
+        throw new TypeError("The options object should be an object");
+      }
+      if (options.fastify !== void 0 && typeof options.fastify !== "string") {
+        throw new TypeError(`fastify-plugin expects a version string, instead got '${typeof options.fastify}'`);
+      }
+      if (!options.name) {
+        autoName = true;
+        options.name = getPluginName(fn) + "-auto-" + count++;
+      }
+      fn[/* @__PURE__ */ Symbol.for("skip-override")] = options.encapsulate !== true;
+      fn[/* @__PURE__ */ Symbol.for("fastify.display-name")] = options.name;
+      fn[/* @__PURE__ */ Symbol.for("plugin-meta")] = options;
+      if (!fn.default) {
+        fn.default = fn;
+      }
+      const camelCase = toCamelCase(options.name);
+      if (!autoName && !fn[camelCase]) {
+        fn[camelCase] = fn;
+      }
+      return fn;
+    }
+    module.exports = plugin;
+    module.exports.default = plugin;
+    module.exports.fastifyPlugin = plugin;
+  }
+});
+var storage = new async_hooks.AsyncLocalStorage();
+function runInStore(store, fn) {
+  return storage.run(store, fn);
+}
+function getStore() {
+  return storage.getStore();
+}
+
+// src/context.ts
+var GET_CTX_ERROR = "[reqlocal] getCtx() called outside a request context. Make sure reqlocal middleware runs before your route handlers.";
+function getCtx() {
+  const store = getStore();
+  if (store === void 0) {
+    throw new Error(GET_CTX_ERROR);
+  }
+  return store;
+}
+function getCtxOrNull() {
+  const store = getStore();
+  return store ?? null;
+}
+function runWithCtx(ctx, fn) {
+  return runInStore(ctx, () => fn());
+}
+
+// src/middleware.ts
+function reqlocal(config) {
+  return (req, res, next) => {
+    const context = {};
+    for (const key of Object.keys(config)) {
+      context[key] = config[key](req);
+    }
+    runInStore(context, () => next());
+  };
+}
+
+// src/fastify.ts
+var import_fastify_plugin = __toESM(require_plugin());
+var reqlocalPluginImpl = async (fastify, opts) => {
+  const { config } = opts;
+  fastify.addHook("onRequest", (request, reply, done) => {
+    const context = {};
+    for (const key of Object.keys(config)) {
+      context[key] = config[key](request.raw);
+    }
+    runInStore(context, () => done());
+  });
+};
+var reqlocalPlugin = (0, import_fastify_plugin.default)(reqlocalPluginImpl, {
+  fastify: "4.x",
+  name: "reqlocal"
+});
+
+exports.getCtx = getCtx;
+exports.getCtxOrNull = getCtxOrNull;
+exports.reqlocal = reqlocal;
+exports.reqlocalPlugin = reqlocalPlugin;
+exports.runWithCtx = runWithCtx;
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../node_modules/fastify-plugin/lib/getPluginName.js","../node_modules/fastify-plugin/lib/toCamelCase.js","../node_modules/fastify-plugin/plugin.js","../src/store.ts","../src/context.ts","../src/middleware.ts","../src/fastify.ts"],"names":["exports","AsyncLocalStorage","fp"],"mappings":"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","file":"index.js","sourcesContent":["'use strict'\n\nconst fpStackTracePattern = /at\\s{1}(?:.*\\.)?plugin\\s{1}.*\\n\\s*(.*)/\nconst fileNamePattern = /(\\w*(\\.\\w*)*)\\..*/\n\nmodule.exports = function getPluginName (fn) {\n  if (fn.name.length > 0) return fn.name\n\n  const stackTraceLimit = Error.stackTraceLimit\n  Error.stackTraceLimit = 10\n  try {\n    throw new Error('anonymous function')\n  } catch (e) {\n    Error.stackTraceLimit = stackTraceLimit\n    return extractPluginName(e.stack)\n  }\n}\n\nfunction extractPluginName (stack) {\n  const m = stack.match(fpStackTracePattern)\n\n  // get last section of path and match for filename\n  return m ? m[1].split(/[/\\\\]/).slice(-1)[0].match(fileNamePattern)[1] : 'anonymous'\n}\nmodule.exports.extractPluginName = extractPluginName\n","'use strict'\n\nmodule.exports = function toCamelCase (name) {\n  if (name[0] === '@') {\n    name = name.slice(1).replace('/', '-')\n  }\n  const newName = name.replace(/-(.)/g, function (match, g1) {\n    return g1.toUpperCase()\n  })\n  return newName\n}\n","'use strict'\n\nconst getPluginName = require('./lib/getPluginName')\nconst toCamelCase = require('./lib/toCamelCase')\n\nlet count = 0\n\nfunction plugin (fn, options = {}) {\n  let autoName = false\n\n  if (typeof fn.default !== 'undefined') {\n    // Support for 'export default' behaviour in transpiled ECMAScript module\n    fn = fn.default\n  }\n\n  if (typeof fn !== 'function') {\n    throw new TypeError(\n      `fastify-plugin expects a function, instead got a '${typeof fn}'`\n    )\n  }\n\n  if (typeof options === 'string') {\n    options = {\n      fastify: options\n    }\n  }\n\n  if (\n    typeof options !== 'object' ||\n    Array.isArray(options) ||\n    options === null\n  ) {\n    throw new TypeError('The options object should be an object')\n  }\n\n  if (options.fastify !== undefined && typeof options.fastify !== 'string') {\n    throw new TypeError(`fastify-plugin expects a version string, instead got '${typeof options.fastify}'`)\n  }\n\n  if (!options.name) {\n    autoName = true\n    options.name = getPluginName(fn) + '-auto-' + count++\n  }\n\n  fn[Symbol.for('skip-override')] = options.encapsulate !== true\n  fn[Symbol.for('fastify.display-name')] = options.name\n  fn[Symbol.for('plugin-meta')] = options\n\n  // Faux modules support\n  if (!fn.default) {\n    fn.default = fn\n  }\n\n  // TypeScript support for named imports\n  // See https://github.com/fastify/fastify/issues/2404 for more details\n  // The type definitions would have to be update to match this.\n  const camelCase = toCamelCase(options.name)\n  if (!autoName && !fn[camelCase]) {\n    fn[camelCase] = fn\n  }\n\n  return fn\n}\n\nmodule.exports = plugin\nmodule.exports.default = plugin\nmodule.exports.fastifyPlugin = plugin\n","import { AsyncLocalStorage } from \"node:async_hooks\";\n\nconst storage = new AsyncLocalStorage<Record<string, unknown>>();\n\nexport function runInStore<T>(store: Record<string, unknown>, fn: () => T): T {\n  return storage.run(store, fn);\n}\n\nexport function getStore<\n  T extends Record<string, unknown> = Record<string, unknown>,\n>(): T | undefined {\n  return storage.getStore() as T | undefined;\n}\n","import { getStore, runInStore } from \"./store.js\";\n\nconst GET_CTX_ERROR =\n  \"[reqlocal] getCtx() called outside a request context. Make sure reqlocal middleware runs before your route handlers.\";\n\nexport function getCtx<\n  T extends Record<string, unknown> = Record<string, unknown>,\n>(): T {\n  const store = getStore<T>();\n  if (store === undefined) {\n    throw new Error(GET_CTX_ERROR);\n  }\n  return store;\n}\n\nexport function getCtxOrNull<\n  T extends Record<string, unknown> = Record<string, unknown>,\n>(): T | null {\n  const store = getStore<T>();\n  return store ?? null;\n}\n\nexport function runWithCtx<TCtx extends Record<string, unknown>, TResult>(\n  ctx: TCtx,\n  fn: () => Promise<TResult>,\n): Promise<TResult> {\n  return runInStore(ctx, () => fn());\n}\n","import type { IncomingMessage, ServerResponse } from \"node:http\";\nimport { runInStore } from \"./store.js\";\nimport type { ContextConfig, InferContext } from \"./types.js\";\n\nexport function reqlocal<C extends ContextConfig>(\n  config: C,\n): (\n  req: IncomingMessage,\n  res: ServerResponse,\n  next: (err?: unknown) => void,\n) => void {\n  return (req, res, next) => {\n    const context = {} as InferContext<C>;\n    for (const key of Object.keys(config) as Array<keyof C>) {\n      (context as Record<string, unknown>)[key as string] = config[key](req);\n    }\n    runInStore(context as Record<string, unknown>, () => next());\n  };\n}\n","import type { FastifyPluginAsync } from \"fastify\";\nimport fp from \"fastify-plugin\";\nimport { runInStore } from \"./store.js\";\nimport type { ContextConfig } from \"./types.js\";\n\nexport type ReqlocalFastifyOptions = {\n  config: ContextConfig;\n};\n\nconst reqlocalPluginImpl: FastifyPluginAsync<ReqlocalFastifyOptions> = async (\n  fastify,\n  opts,\n) => {\n  const { config } = opts;\n  fastify.addHook(\"onRequest\", (request, reply, done) => {\n    const context: Record<string, unknown> = {};\n    for (const key of Object.keys(config)) {\n      context[key] = config[key](request.raw);\n    }\n    runInStore(context, () => done());\n  });\n};\n\nexport const reqlocalPlugin = fp(reqlocalPluginImpl, {\n  fastify: \"4.x\",\n  name: \"reqlocal\",\n});\n"]}

package/dist/index.mjs

@@ -0,0 +1,171 @@
+import { AsyncLocalStorage } from 'async_hooks';
+
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __commonJS = (cb, mod) => function __require() {
+  return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  __defProp(target, "default", { value: mod, enumerable: true }) ,
+  mod
+));
+
+// node_modules/fastify-plugin/lib/getPluginName.js
+var require_getPluginName = __commonJS({
+  "node_modules/fastify-plugin/lib/getPluginName.js"(exports$1, module) {
+    var fpStackTracePattern = /at\s{1}(?:.*\.)?plugin\s{1}.*\n\s*(.*)/;
+    var fileNamePattern = /(\w*(\.\w*)*)\..*/;
+    module.exports = function getPluginName(fn) {
+      if (fn.name.length > 0) return fn.name;
+      const stackTraceLimit = Error.stackTraceLimit;
+      Error.stackTraceLimit = 10;
+      try {
+        throw new Error("anonymous function");
+      } catch (e) {
+        Error.stackTraceLimit = stackTraceLimit;
+        return extractPluginName(e.stack);
+      }
+    };
+    function extractPluginName(stack) {
+      const m = stack.match(fpStackTracePattern);
+      return m ? m[1].split(/[/\\]/).slice(-1)[0].match(fileNamePattern)[1] : "anonymous";
+    }
+    module.exports.extractPluginName = extractPluginName;
+  }
+});
+
+// node_modules/fastify-plugin/lib/toCamelCase.js
+var require_toCamelCase = __commonJS({
+  "node_modules/fastify-plugin/lib/toCamelCase.js"(exports$1, module) {
+    module.exports = function toCamelCase(name) {
+      if (name[0] === "@") {
+        name = name.slice(1).replace("/", "-");
+      }
+      const newName = name.replace(/-(.)/g, function(match, g1) {
+        return g1.toUpperCase();
+      });
+      return newName;
+    };
+  }
+});
+
+// node_modules/fastify-plugin/plugin.js
+var require_plugin = __commonJS({
+  "node_modules/fastify-plugin/plugin.js"(exports$1, module) {
+    var getPluginName = require_getPluginName();
+    var toCamelCase = require_toCamelCase();
+    var count = 0;
+    function plugin(fn, options = {}) {
+      let autoName = false;
+      if (typeof fn.default !== "undefined") {
+        fn = fn.default;
+      }
+      if (typeof fn !== "function") {
+        throw new TypeError(
+          `fastify-plugin expects a function, instead got a '${typeof fn}'`
+        );
+      }
+      if (typeof options === "string") {
+        options = {
+          fastify: options
+        };
+      }
+      if (typeof options !== "object" || Array.isArray(options) || options === null) {
+        throw new TypeError("The options object should be an object");
+      }
+      if (options.fastify !== void 0 && typeof options.fastify !== "string") {
+        throw new TypeError(`fastify-plugin expects a version string, instead got '${typeof options.fastify}'`);
+      }
+      if (!options.name) {
+        autoName = true;
+        options.name = getPluginName(fn) + "-auto-" + count++;
+      }
+      fn[/* @__PURE__ */ Symbol.for("skip-override")] = options.encapsulate !== true;
+      fn[/* @__PURE__ */ Symbol.for("fastify.display-name")] = options.name;
+      fn[/* @__PURE__ */ Symbol.for("plugin-meta")] = options;
+      if (!fn.default) {
+        fn.default = fn;
+      }
+      const camelCase = toCamelCase(options.name);
+      if (!autoName && !fn[camelCase]) {
+        fn[camelCase] = fn;
+      }
+      return fn;
+    }
+    module.exports = plugin;
+    module.exports.default = plugin;
+    module.exports.fastifyPlugin = plugin;
+  }
+});
+var storage = new AsyncLocalStorage();
+function runInStore(store, fn) {
+  return storage.run(store, fn);
+}
+function getStore() {
+  return storage.getStore();
+}
+
+// src/context.ts
+var GET_CTX_ERROR = "[reqlocal] getCtx() called outside a request context. Make sure reqlocal middleware runs before your route handlers.";
+function getCtx() {
+  const store = getStore();
+  if (store === void 0) {
+    throw new Error(GET_CTX_ERROR);
+  }
+  return store;
+}
+function getCtxOrNull() {
+  const store = getStore();
+  return store ?? null;
+}
+function runWithCtx(ctx, fn) {
+  return runInStore(ctx, () => fn());
+}
+
+// src/middleware.ts
+function reqlocal(config) {
+  return (req, res, next) => {
+    const context = {};
+    for (const key of Object.keys(config)) {
+      context[key] = config[key](req);
+    }
+    runInStore(context, () => next());
+  };
+}
+
+// src/fastify.ts
+var import_fastify_plugin = __toESM(require_plugin());
+var reqlocalPluginImpl = async (fastify, opts) => {
+  const { config } = opts;
+  fastify.addHook("onRequest", (request, reply, done) => {
+    const context = {};
+    for (const key of Object.keys(config)) {
+      context[key] = config[key](request.raw);
+    }
+    runInStore(context, () => done());
+  });
+};
+var reqlocalPlugin = (0, import_fastify_plugin.default)(reqlocalPluginImpl, {
+  fastify: "4.x",
+  name: "reqlocal"
+});
+
+export { getCtx, getCtxOrNull, reqlocal, reqlocalPlugin, runWithCtx };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../node_modules/fastify-plugin/lib/getPluginName.js","../node_modules/fastify-plugin/lib/toCamelCase.js","../node_modules/fastify-plugin/plugin.js","../src/store.ts","../src/context.ts","../src/middleware.ts","../src/fastify.ts"],"names":["exports","fp"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,IAAA,qBAAA,GAAA,UAAA,CAAA;AAAA,EAAA,kDAAA,CAAAA,SAAA,EAAA,MAAA,EAAA;AAEA,IAAA,IAAM,mBAAA,GAAsB,wCAAA;AAC5B,IAAA,IAAM,eAAA,GAAkB,mBAAA;AAExB,IAAA,MAAA,CAAO,OAAA,GAAU,SAAS,aAAA,CAAe,EAAA,EAAI;AAC3C,MAAA,IAAI,EAAA,CAAG,IAAA,CAAK,MAAA,GAAS,CAAA,SAAU,EAAA,CAAG,IAAA;AAElC,MAAA,MAAM,kBAAkB,KAAA,CAAM,eAAA;AAC9B,MAAA,KAAA,CAAM,eAAA,GAAkB,EAAA;AACxB,MAAA,IAAI;AACF,QAAA,MAAM,IAAI,MAAM,oBAAoB,CAAA;AAAA,MACtC,SAAS,CAAA,EAAG;AACV,QAAA,KAAA,CAAM,eAAA,GAAkB,eAAA;AACxB,QAAA,OAAO,iBAAA,CAAkB,EAAE,KAAK,CAAA;AAAA,MAClC;AAAA,IACF,CAAA;AAEA,IAAA,SAAS,kBAAmB,KAAA,EAAO;AACjC,MAAA,MAAM,CAAA,GAAI,KAAA,CAAM,KAAA,CAAM,mBAAmB,CAAA;AAGzC,MAAA,OAAO,IAAI,CAAA,CAAE,CAAC,CAAA,CAAE,KAAA,CAAM,OAAO,CAAA,CAAE,KAAA,CAAM,EAAE,CAAA,CAAE,CAAC,CAAA,CAAE,KAAA,CAAM,eAAe,CAAA,CAAE,CAAC,CAAA,GAAI,WAAA;AAAA,IAC1E;AACA,IAAA,MAAA,CAAO,QAAQ,iBAAA,GAAoB,iBAAA;AAAA,EAAA;AAAA,CAAA,CAAA;;;ACxBnC,IAAA,mBAAA,GAAA,UAAA,CAAA;AAAA,EAAA,gDAAA,CAAAA,SAAA,EAAA,MAAA,EAAA;AAEA,IAAA,MAAA,CAAO,OAAA,GAAU,SAAS,WAAA,CAAa,IAAA,EAAM;AAC3C,MAAA,IAAI,IAAA,CAAK,CAAC,CAAA,KAAM,GAAA,EAAK;AACnB,QAAA,IAAA,GAAO,KAAK,KAAA,CAAM,CAAC,CAAA,CAAE,OAAA,CAAQ,KAAK,GAAG,CAAA;AAAA,MACvC;AACA,MAAA,MAAM,UAAU,IAAA,CAAK,OAAA,CAAQ,OAAA,EAAS,SAAU,OAAO,EAAA,EAAI;AACzD,QAAA,OAAO,GAAG,WAAA,EAAY;AAAA,MACxB,CAAC,CAAA;AACD,MAAA,OAAO,OAAA;AAAA,IACT,CAAA;AAAA,EAAA;AAAA,CAAA,CAAA;;;ACVA,IAAA,cAAA,GAAA,UAAA,CAAA;AAAA,EAAA,uCAAA,CAAAA,SAAA,EAAA,MAAA,EAAA;AAEA,IAAA,IAAM,aAAA,GAAgB,qBAAA,EAAA;AACtB,IAAA,IAAM,WAAA,GAAc,mBAAA,EAAA;AAEpB,IAAA,IAAI,KAAA,GAAQ,CAAA;AAEZ,IAAA,SAAS,MAAA,CAAQ,EAAA,EAAI,OAAA,GAAU,EAAC,EAAG;AACjC,MAAA,IAAI,QAAA,GAAW,KAAA;AAEf,MAAA,IAAI,OAAO,EAAA,CAAG,OAAA,KAAY,WAAA,EAAa;AAErC,QAAA,EAAA,GAAK,EAAA,CAAG,OAAA;AAAA,MACV;AAEA,MAAA,IAAI,OAAO,OAAO,UAAA,EAAY;AAC5B,QAAA,MAAM,IAAI,SAAA;AAAA,UACR,CAAA,kDAAA,EAAqD,OAAO,EAAE,CAAA,CAAA;AAAA,SAChE;AAAA,MACF;AAEA,MAAA,IAAI,OAAO,YAAY,QAAA,EAAU;AAC/B,QAAA,OAAA,GAAU;AAAA,UACR,OAAA,EAAS;AAAA,SACX;AAAA,MACF;AAEA,MAAA,IACE,OAAO,YAAY,QAAA,IACnB,KAAA,CAAM,QAAQ,OAAO,CAAA,IACrB,YAAY,IAAA,EACZ;AACA,QAAA,MAAM,IAAI,UAAU,wCAAwC,CAAA;AAAA,MAC9D;AAEA,MAAA,IAAI,QAAQ,OAAA,KAAY,MAAA,IAAa,OAAO,OAAA,CAAQ,YAAY,QAAA,EAAU;AACxE,QAAA,MAAM,IAAI,SAAA,CAAU,CAAA,sDAAA,EAAyD,OAAO,OAAA,CAAQ,OAAO,CAAA,CAAA,CAAG,CAAA;AAAA,MACxG;AAEA,MAAA,IAAI,CAAC,QAAQ,IAAA,EAAM;AACjB,QAAA,QAAA,GAAW,IAAA;AACX,QAAA,OAAA,CAAQ,IAAA,GAAO,aAAA,CAAc,EAAE,CAAA,GAAI,QAAA,GAAW,KAAA,EAAA;AAAA,MAChD;AAEA,MAAA,EAAA,wBAAU,GAAA,CAAI,eAAe,CAAC,CAAA,GAAI,QAAQ,WAAA,KAAgB,IAAA;AAC1D,MAAA,EAAA,iBAAG,MAAA,CAAO,GAAA,CAAI,sBAAsB,CAAC,IAAI,OAAA,CAAQ,IAAA;AACjD,MAAA,EAAA,iBAAG,MAAA,CAAO,GAAA,CAAI,aAAa,CAAC,CAAA,GAAI,OAAA;AAGhC,MAAA,IAAI,CAAC,GAAG,OAAA,EAAS;AACf,QAAA,EAAA,CAAG,OAAA,GAAU,EAAA;AAAA,MACf;AAKA,MAAA,MAAM,SAAA,GAAY,WAAA,CAAY,OAAA,CAAQ,IAAI,CAAA;AAC1C,MAAA,IAAI,CAAC,QAAA,IAAY,CAAC,EAAA,CAAG,SAAS,CAAA,EAAG;AAC/B,QAAA,EAAA,CAAG,SAAS,CAAA,GAAI,EAAA;AAAA,MAClB;AAEA,MAAA,OAAO,EAAA;AAAA,IACT;AAEA,IAAA,MAAA,CAAO,OAAA,GAAU,MAAA;AACjB,IAAA,MAAA,CAAO,QAAQ,OAAA,GAAU,MAAA;AACzB,IAAA,MAAA,CAAO,QAAQ,aAAA,GAAgB,MAAA;AAAA,EAAA;AAAA,CAAA,CAAA;AChE/B,IAAM,OAAA,GAAU,IAAI,iBAAA,EAA2C;AAExD,SAAS,UAAA,CAAc,OAAgC,EAAA,EAAgB;AAC5E,EAAA,OAAO,OAAA,CAAQ,GAAA,CAAI,KAAA,EAAO,EAAE,CAAA;AAC9B;AAEO,SAAS,QAAA,GAEG;AACjB,EAAA,OAAO,QAAQ,QAAA,EAAS;AAC1B;;;ACVA,IAAM,aAAA,GACJ,sHAAA;AAEK,SAAS,MAAA,GAET;AACL,EAAA,MAAM,QAAQ,QAAA,EAAY;AAC1B,EAAA,IAAI,UAAU,MAAA,EAAW;AACvB,IAAA,MAAM,IAAI,MAAM,aAAa,CAAA;AAAA,EAC/B;AACA,EAAA,OAAO,KAAA;AACT;AAEO,SAAS,YAAA,GAEF;AACZ,EAAA,MAAM,QAAQ,QAAA,EAAY;AAC1B,EAAA,OAAO,KAAA,IAAS,IAAA;AAClB;AAEO,SAAS,UAAA,CACd,KACA,EAAA,EACkB;AAClB,EAAA,OAAO,UAAA,CAAW,GAAA,EAAK,MAAM,EAAA,EAAI,CAAA;AACnC;;;ACvBO,SAAS,SACd,MAAA,EAKQ;AACR,EAAA,OAAO,CAAC,GAAA,EAAK,GAAA,EAAK,IAAA,KAAS;AACzB,IAAA,MAAM,UAAU,EAAC;AACjB,IAAA,KAAA,MAAW,GAAA,IAAO,MAAA,CAAO,IAAA,CAAK,MAAM,CAAA,EAAqB;AACvD,MAAC,QAAoC,GAAa,CAAA,GAAI,MAAA,CAAO,GAAG,EAAE,GAAG,CAAA;AAAA,IACvE;AACA,IAAA,UAAA,CAAW,OAAA,EAAoC,MAAM,IAAA,EAAM,CAAA;AAAA,EAC7D,CAAA;AACF;;;ACjBA,IAAA,qBAAA,GAAe,OAAA,CAAA,cAAA,EAAA,CAAA;AAQf,IAAM,kBAAA,GAAiE,OACrE,OAAA,EACA,IAAA,KACG;AACH,EAAA,MAAM,EAAE,QAAO,GAAI,IAAA;AACnB,EAAA,OAAA,CAAQ,OAAA,CAAQ,WAAA,EAAa,CAAC,OAAA,EAAS,OAAO,IAAA,KAAS;AACrD,IAAA,MAAM,UAAmC,EAAC;AAC1C,IAAA,KAAA,MAAW,GAAA,IAAO,MAAA,CAAO,IAAA,CAAK,MAAM,CAAA,EAAG;AACrC,MAAA,OAAA,CAAQ,GAAG,CAAA,GAAI,MAAA,CAAO,GAAG,CAAA,CAAE,QAAQ,GAAG,CAAA;AAAA,IACxC;AACA,IAAA,UAAA,CAAW,OAAA,EAAS,MAAM,IAAA,EAAM,CAAA;AAAA,EAClC,CAAC,CAAA;AACH,CAAA;AAEO,IAAM,cAAA,GAAA,IAAiB,qBAAA,CAAAC,OAAAA,EAAG,kBAAA,EAAoB;AAAA,EACnD,OAAA,EAAS,KAAA;AAAA,EACT,IAAA,EAAM;AACR,CAAC","file":"index.mjs","sourcesContent":["'use strict'\n\nconst fpStackTracePattern = /at\\s{1}(?:.*\\.)?plugin\\s{1}.*\\n\\s*(.*)/\nconst fileNamePattern = /(\\w*(\\.\\w*)*)\\..*/\n\nmodule.exports = function getPluginName (fn) {\n  if (fn.name.length > 0) return fn.name\n\n  const stackTraceLimit = Error.stackTraceLimit\n  Error.stackTraceLimit = 10\n  try {\n    throw new Error('anonymous function')\n  } catch (e) {\n    Error.stackTraceLimit = stackTraceLimit\n    return extractPluginName(e.stack)\n  }\n}\n\nfunction extractPluginName (stack) {\n  const m = stack.match(fpStackTracePattern)\n\n  // get last section of path and match for filename\n  return m ? m[1].split(/[/\\\\]/).slice(-1)[0].match(fileNamePattern)[1] : 'anonymous'\n}\nmodule.exports.extractPluginName = extractPluginName\n","'use strict'\n\nmodule.exports = function toCamelCase (name) {\n  if (name[0] === '@') {\n    name = name.slice(1).replace('/', '-')\n  }\n  const newName = name.replace(/-(.)/g, function (match, g1) {\n    return g1.toUpperCase()\n  })\n  return newName\n}\n","'use strict'\n\nconst getPluginName = require('./lib/getPluginName')\nconst toCamelCase = require('./lib/toCamelCase')\n\nlet count = 0\n\nfunction plugin (fn, options = {}) {\n  let autoName = false\n\n  if (typeof fn.default !== 'undefined') {\n    // Support for 'export default' behaviour in transpiled ECMAScript module\n    fn = fn.default\n  }\n\n  if (typeof fn !== 'function') {\n    throw new TypeError(\n      `fastify-plugin expects a function, instead got a '${typeof fn}'`\n    )\n  }\n\n  if (typeof options === 'string') {\n    options = {\n      fastify: options\n    }\n  }\n\n  if (\n    typeof options !== 'object' ||\n    Array.isArray(options) ||\n    options === null\n  ) {\n    throw new TypeError('The options object should be an object')\n  }\n\n  if (options.fastify !== undefined && typeof options.fastify !== 'string') {\n    throw new TypeError(`fastify-plugin expects a version string, instead got '${typeof options.fastify}'`)\n  }\n\n  if (!options.name) {\n    autoName = true\n    options.name = getPluginName(fn) + '-auto-' + count++\n  }\n\n  fn[Symbol.for('skip-override')] = options.encapsulate !== true\n  fn[Symbol.for('fastify.display-name')] = options.name\n  fn[Symbol.for('plugin-meta')] = options\n\n  // Faux modules support\n  if (!fn.default) {\n    fn.default = fn\n  }\n\n  // TypeScript support for named imports\n  // See https://github.com/fastify/fastify/issues/2404 for more details\n  // The type definitions would have to be update to match this.\n  const camelCase = toCamelCase(options.name)\n  if (!autoName && !fn[camelCase]) {\n    fn[camelCase] = fn\n  }\n\n  return fn\n}\n\nmodule.exports = plugin\nmodule.exports.default = plugin\nmodule.exports.fastifyPlugin = plugin\n","import { AsyncLocalStorage } from \"node:async_hooks\";\n\nconst storage = new AsyncLocalStorage<Record<string, unknown>>();\n\nexport function runInStore<T>(store: Record<string, unknown>, fn: () => T): T {\n  return storage.run(store, fn);\n}\n\nexport function getStore<\n  T extends Record<string, unknown> = Record<string, unknown>,\n>(): T | undefined {\n  return storage.getStore() as T | undefined;\n}\n","import { getStore, runInStore } from \"./store.js\";\n\nconst GET_CTX_ERROR =\n  \"[reqlocal] getCtx() called outside a request context. Make sure reqlocal middleware runs before your route handlers.\";\n\nexport function getCtx<\n  T extends Record<string, unknown> = Record<string, unknown>,\n>(): T {\n  const store = getStore<T>();\n  if (store === undefined) {\n    throw new Error(GET_CTX_ERROR);\n  }\n  return store;\n}\n\nexport function getCtxOrNull<\n  T extends Record<string, unknown> = Record<string, unknown>,\n>(): T | null {\n  const store = getStore<T>();\n  return store ?? null;\n}\n\nexport function runWithCtx<TCtx extends Record<string, unknown>, TResult>(\n  ctx: TCtx,\n  fn: () => Promise<TResult>,\n): Promise<TResult> {\n  return runInStore(ctx, () => fn());\n}\n","import type { IncomingMessage, ServerResponse } from \"node:http\";\nimport { runInStore } from \"./store.js\";\nimport type { ContextConfig, InferContext } from \"./types.js\";\n\nexport function reqlocal<C extends ContextConfig>(\n  config: C,\n): (\n  req: IncomingMessage,\n  res: ServerResponse,\n  next: (err?: unknown) => void,\n) => void {\n  return (req, res, next) => {\n    const context = {} as InferContext<C>;\n    for (const key of Object.keys(config) as Array<keyof C>) {\n      (context as Record<string, unknown>)[key as string] = config[key](req);\n    }\n    runInStore(context as Record<string, unknown>, () => next());\n  };\n}\n","import type { FastifyPluginAsync } from \"fastify\";\nimport fp from \"fastify-plugin\";\nimport { runInStore } from \"./store.js\";\nimport type { ContextConfig } from \"./types.js\";\n\nexport type ReqlocalFastifyOptions = {\n  config: ContextConfig;\n};\n\nconst reqlocalPluginImpl: FastifyPluginAsync<ReqlocalFastifyOptions> = async (\n  fastify,\n  opts,\n) => {\n  const { config } = opts;\n  fastify.addHook(\"onRequest\", (request, reply, done) => {\n    const context: Record<string, unknown> = {};\n    for (const key of Object.keys(config)) {\n      context[key] = config[key](request.raw);\n    }\n    runInStore(context, () => done());\n  });\n};\n\nexport const reqlocalPlugin = fp(reqlocalPluginImpl, {\n  fastify: \"4.x\",\n  name: \"reqlocal\",\n});\n"]}

package/docs/logo-mark.svg

@@ -0,0 +1,18 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" fill="none">
+  <rect width="64" height="64" rx="16" fill="#0d1512"/>
+  <rect x="1" y="1" width="62" height="62" rx="15" stroke="url(#b)" stroke-opacity="0.35" stroke-width="2"/>
+  <path
+    d="M18 22h28v5H18v-5zm0 11h18v5H18v-5zm0 11h24v5H18v-5z"
+    fill="url(#g)"
+  />
+  <defs>
+    <linearGradient id="g" x1="18" y1="22" x2="46" y2="44" gradientUnits="userSpaceOnUse">
+      <stop stop-color="#2dd4bf"/>
+      <stop offset="1" stop-color="#34d399"/>
+    </linearGradient>
+    <linearGradient id="b" x1="0" y1="0" x2="64" y2="64" gradientUnits="userSpaceOnUse">
+      <stop stop-color="#2dd4bf"/>
+      <stop offset="1" stop-color="#34d399"/>
+    </linearGradient>
+  </defs>
+</svg>

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "reqlocal",
+  "version": "0.1.0",
+  "description": "Request-scoped context for Node.js via AsyncLocalStorage — access typed context anywhere in the request lifecycle without parameter threading.",
+  "license": "MIT",
+  "author": "Abdul-Moiz31 (https://github.com/Abdul-Moiz31)",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Abdul-Moiz31/reqlocal.git"
+  },
+  "keywords": [
+    "async-local-storage",
+    "request-context",
+    "express",
+    "fastify",
+    "typescript"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "docs/logo-mark.svg",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "peerDependencies": {
+    "fastify": "^4.0.0"
+  },
+  "peerDependenciesMeta": {
+    "fastify": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/express": "^4.17.21",
+    "@types/node": "^20.14.10",
+    "@types/supertest": "^6.0.2",
+    "express": "^4.19.2",
+    "fastify": "^4.28.1",
+    "fastify-plugin": "^4.5.1",
+    "supertest": "^7.0.0",
+    "tsup": "^8.1.0",
+    "typescript": "^5.5.3",
+    "vitest": "^2.0.3"
+  }
+}