@intelligo-dev/core 1.0.0-beta.2 → 1.0.0-beta.5

package/dist/request-context.js

@@ -0,0 +1,99 @@
+/**
+ * Where request-scoped context comes from.
+ *
+ * `@intelligo-dev/auth` needs the incoming request's headers to resolve
+ * a session, and it got them by importing `next/headers` directly in
+ * five files. That made a package whose subject is authentication —
+ * not rendering — unusable outside Next: a queue worker that wants to
+ * check a session, a Hono API, a product on another framework, a test
+ * that is not running inside a request. ADR-0005 named the fix in its
+ * consequences; this is it.
+ *
+ * The framework asks for headers through `getRequestHeaders()`. The
+ * application says where they come from, once, from its composition
+ * root:
+ *
+ *     import { setRequestContextSource } from "@intelligo-dev/core/request-context";
+ *     import { nextRequestContext } from "@intelligo-dev/next";
+ *
+ *     setRequestContextSource(nextRequestContext);
+ *
+ * `@intelligo-dev/next` is the only package in the framework that
+ * imports `next/*`, and an architecture test keeps it that way. This
+ * module imports nothing but `./registry`, so the contract is reachable
+ * from any runtime the adapter is not.
+ *
+ * Nothing self-registers. An unbound source throws where the headers
+ * are needed, naming the two lines that fix it — the alternative is a
+ * framework that guesses at the request, which is how a session gets
+ * read from the wrong one.
+ */
+import { createRegistryRef } from "./registry.js";
+export class RequestContextUnavailableError extends Error {
+    constructor() {
+        super("No request context source is bound. Call setRequestContextSource() " +
+            "from your composition root — `nextRequestContext` from " +
+            "@intelligo-dev/next in a Next.js app — or wrap the call in " +
+            "withRequestHeaders() outside a request.");
+        this.code = "request_context_unavailable";
+        this.name = "RequestContextUnavailableError";
+    }
+}
+/**
+ * Held in the cross-instance registry rather than a module variable
+ * for the same reason every other framework registry is: a bundler
+ * that duplicates this module would otherwise give the composition
+ * root one copy and the request path another.
+ */
+const source = createRegistryRef("core/request-context-source", undefined);
+/** Explicitly bound headers, for a call that is not inside a request. */
+const override = createRegistryRef("core/request-headers-override", undefined);
+export function setRequestContextSource(next) {
+    source.set(next);
+}
+/** Forget the bound source. For tests composing a fresh root. */
+export function clearRequestContextSource() {
+    source.set(undefined);
+    override.set(undefined);
+}
+export function hasRequestContextSource() {
+    return source.get() !== undefined || override.get() !== undefined;
+}
+/**
+ * The current request's headers.
+ *
+ * @throws {RequestContextUnavailableError} when nothing is bound.
+ */
+export async function getRequestHeaders() {
+    const explicit = override.get();
+    if (explicit)
+        return explicit;
+    const resolve = source.get();
+    if (!resolve)
+        throw new RequestContextUnavailableError();
+    return await resolve();
+}
+/**
+ * Run `fn` with these headers, whatever the ambient source says.
+ *
+ * For the callers that have a request but are not inside the
+ * framework's request scope: a background job replaying a webhook, a
+ * script acting as a user, an integration test that wants a real
+ * session without a server. Restores the previous value afterwards, so
+ * nesting behaves.
+ *
+ * Not `AsyncLocalStorage`: the value is set and restored around one
+ * awaited call, and ALS would make the package require a Node built-in
+ * that Edge runtimes only partly provide.
+ */
+export async function withRequestHeaders(headers, fn) {
+    const previous = override.get();
+    override.set(headers);
+    try {
+        return await fn();
+    }
+    finally {
+        override.set(previous);
+    }
+}
+//# sourceMappingURL=request-context.js.map

package/dist/request-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-context.js","sourceRoot":"","sources":["../src/request-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAU/C,MAAM,OAAO,8BAA+B,SAAQ,KAAK;IAEvD;QACE,KAAK,CACH,qEAAqE;YACnE,yDAAyD;YACzD,6DAA6D;YAC7D,yCAAyC,CAC5C,CAAC;QAPK,SAAI,GAAG,6BAA6B,CAAC;QAQ5C,IAAI,CAAC,IAAI,GAAG,gCAAgC,CAAC;IAC/C,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,MAAM,GAAG,iBAAiB,CAC9B,6BAA6B,EAC7B,SAAS,CACV,CAAC;AAEF,yEAAyE;AACzE,MAAM,QAAQ,GAAG,iBAAiB,CAChC,+BAA+B,EAC/B,SAAS,CACV,CAAC;AAEF,MAAM,UAAU,uBAAuB,CAAC,IAA0B;IAChE,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AACnB,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,yBAAyB;IACvC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACtB,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,uBAAuB;IACrC,OAAO,MAAM,CAAC,GAAG,EAAE,KAAK,SAAS,IAAI,QAAQ,CAAC,GAAG,EAAE,KAAK,SAAS,CAAC;AACpE,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB;IACrC,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,EAAE,CAAC;IAChC,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAE9B,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,EAAE,CAAC;IAC7B,IAAI,CAAC,OAAO;QAAE,MAAM,IAAI,8BAA8B,EAAE,CAAC;IACzD,OAAO,MAAM,OAAO,EAAE,CAAC;AACzB,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,OAAgB,EAChB,EAAwB;IAExB,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,EAAE,CAAC;IAChC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACtB,IAAI,CAAC;QACH,OAAO,MAAM,EAAE,EAAE,CAAC;IACpB,CAAC;YAAS,CAAC;QACT,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACzB,CAAC;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intelligo-dev/core",
-  "version": "1.0.0-beta.2",
+  "version": "1.0.0-beta.5",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
@@ -49,6 +49,18 @@
       "types": "./dist/env.d.ts",
       "default": "./dist/env.js"
     },
+    "./registry": {
+      "types": "./dist/registry.d.ts",
+      "default": "./dist/registry.js"
+    },
+    "./money": {
+      "types": "./dist/money.d.ts",
+      "default": "./dist/money.js"
+    },
+    "./request-context": {
+      "types": "./dist/request-context.d.ts",
+      "default": "./dist/request-context.js"
+    },
     "./logger": {
       "types": "./dist/logger.d.ts",
       "import": "./dist/logger.js",
@@ -59,16 +71,14 @@
     "@neondatabase/serverless": "^0.10.4",
     "@react-email/components": "^1.0.7",
     "dotenv": "^16.4.7",
-    "drizzle-orm": "^0.45.1",
     "pg": "^8.18.0",
     "pino": "^10.3.1",
-    "react": "^19.0.0",
-    "resend": "^6.9.1",
-    "server-only": "^0.0.1",
-    "zod": "^3.24.1"
+    "resend": "^6.9.1"
   },
   "peerDependencies": {
-    "next": "^15.0.0 || ^16.0.0"
+    "drizzle-orm": "^0.45.1",
+    "react": "^19.0.0",
+    "zod": "^3.24.1"
   },
   "devDependencies": {
     "@types/bcryptjs": "^3.0.0",
@@ -76,18 +86,33 @@
     "@types/react": "^19.0.10",
     "bcryptjs": "^3.0.3",
     "drizzle-kit": "^0.31.8",
+    "drizzle-orm": "^0.45.1",
     "next": "^16.0.7",
     "pino-pretty": "^13.1.3",
+    "react": "^19.0.0",
     "tsx": "^4.21.0",
-    "typescript": "^5.7.2"
+    "typescript": "^5.7.2",
+    "zod": "^3.24.1"
   },
   "files": [
     "dist",
-    "src/db/migrations"
+    "src/db/migrations",
+    "LICENSE",
+    "README.md",
+    "!dist/**/*.tsbuildinfo"
   ],
   "publishConfig": {
     "access": "public"
   },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    }
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "sideEffects": false,
   "scripts": {
     "type-check": "tsc --noEmit",
     "lint": "eslint .",
@@ -96,6 +121,6 @@
     "db:studio": "drizzle-kit studio",
     "db:push": "drizzle-kit push",
     "db:check": "tsx scripts/check-db.ts",
-    "build": "tsc -p tsconfig.build.json"
+    "build": "tsc -p tsconfig.build.json && node ../../scripts/fix-esm-extensions.mjs dist"
   }
 }