@owlmeans/server-api 0.1.18-rc.8 → 0.1.18

package/build/utils/context/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/utils/context/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAA;AAErD,sDAAsD;AACtD,MAAM,WAAW,oBAAoB;IACnC,yCAAyC;IACzC,eAAe,EAAE,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,KAAK,IAAI,CAAA;IAC7E;;;;OAIG;IACH,cAAc,EAAE,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,EAAE,QAAQ,CAAC,EAAE,MAAM,KAAK,CAAC,CAAA;CAC1F"}

package/build/utils/context/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build/utils/context/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/utils/context/types.ts"],"names":[],"mappings":""}

package/build/utils/context.d.ts

@@ -1,4 +1,4 @@
-import type { Config, Context, Request } from '../types.js';
-export declare const populateContext: <C extends Config, T extends Context<C>>(req: Request, context: T) => void;
-export declare const extractContext: <C extends Config, T extends Context<C>>(req: Request, ctx?: T, location?: string) => T;
+import type { Request } from '../types.js';
+import type { RequestContextHelper } from './context/types.js';
+export declare const makeRequestContextHelper: (req: Request) => RequestContextHelper;
 //# sourceMappingURL=context.d.ts.map

package/build/utils/context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/utils/context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAG3D,eAAO,MAAM,eAAe,GAAI,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,OAAO,EAAE,SAAS,CAAC,KAAG,IAC/D,CAAA;AAEpC,eAAO,MAAM,cAAc,GAAI,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,OAAO,EAAE,MAAM,CAAC,EAAE,WAAW,MAAM,KAAG,CACxC,CAAA"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/utils/context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAmB,OAAO,EAAE,MAAM,aAAa,CAAA;AAE3D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AAE9D,eAAO,MAAM,wBAAwB,QAAS,OAAO,KAAG,oBAQvD,CAAA"}

package/build/utils/context.js

@@ -1,5 +1,8 @@
 import { assertContext } from '@owlmeans/context';
 import { DEFAULT_ALIAS } from '../consts.js';
-export const populateContext = (req, context) => void (req._ctx = context);
-export const extractContext = (req, ctx, location) => assertContext(req._ctx ?? ctx, location ?? DEFAULT_ALIAS);
+export const makeRequestContextHelper = (req) => {
+    const populateContext = (context) => void (req._ctx = context);
+    const extractContext = (ctx, location) => assertContext(req._ctx ?? ctx, location ?? DEFAULT_ALIAS);
+    return { populateContext, extractContext };
+};
 //# sourceMappingURL=context.js.map

package/build/utils/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/utils/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAEjD,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAE5C,MAAM,CAAC,MAAM,eAAe,GAAG,CAAyC,GAAY,EAAE,OAAU,EAAQ,EAAE,CACxG,KAAK,CAAE,GAAW,CAAC,IAAI,GAAG,OAAO,CAAC,CAAA;AAEpC,MAAM,CAAC,MAAM,cAAc,GAAG,CAAyC,GAAY,EAAE,GAAO,EAAE,QAAiB,EAAK,EAAE,CACpH,aAAa,CAAQ,GAAW,CAAC,IAAI,IAAI,GAAG,EAAE,QAAQ,IAAI,aAAa,CAAC,CAAA"}
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/utils/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAEjD,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAG5C,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,GAAY,EAAwB,EAAE;IAC7E,MAAM,eAAe,GAAG,CAAyC,OAAU,EAAQ,EAAE,CACnF,KAAK,CAAE,GAAW,CAAC,IAAI,GAAG,OAAO,CAAC,CAAA;IAEpC,MAAM,cAAc,GAAG,CAAyC,GAAO,EAAE,QAAiB,EAAK,EAAE,CAC/F,aAAa,CAAQ,GAAW,CAAC,IAAI,IAAI,GAAG,EAAE,QAAQ,IAAI,aAAa,CAAC,CAAA;IAE1E,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,CAAA;AAC5C,CAAC,CAAA"}

package/build/utils/error/types.d.ts

@@ -0,0 +1,52 @@
+import type { FastifyReply } from 'fastify';
+import type { Config, HttpErrorExposure } from '../../types.js';
+import type { SerializedHttpError } from '../types.js';
+/** How the HTTP boundary answers a thrown error: its status, its wire body, its headers and its log entry. */
+export interface HttpErrorHelper {
+    /**
+     * The HTTP status an error's class declares, or `null` when it declares none that may be honoured.
+     *
+     * Read through the constructor chain — a static property is inherited, so a subclass answers what
+     * its nearest declaring ancestor says, and redeclares to change it. An integer 4xx is honoured
+     * directly. A 5xx is honoured only with `allowServerErrorStatus = true`, so a domain class must
+     * explicitly opt in to exposing a precise availability response. The read is structural, so a
+     * class from a duplicate module copy declares exactly what the imported one does.
+     */
+    declaredErrorStatus: (error: unknown) => number | null;
+    /**
+     * The HTTP status an error is answered with, read off the error exactly as given.
+     *
+     * Two families reach here and both must be recognised. `AuthFailedError` / `AccessError` are this
+     * package's own, raised by the request pipeline itself. `AuthorizationError` / `AuthForbidden`
+     * come from `@owlmeans/auth` and are what the guards and gates actually throw — an unrecognised
+     * one answers 500, which reports a refused request as a crashed server: the client cannot tell
+     * "sign in again" from "the service is broken", and a consumer watching statuses concludes the
+     * application fell over. A family member is recognised by class OR by registered type name, so a
+     * class from a duplicate module copy answers the same status.
+     *
+     * **Order matters.** `AuthForbidden extends AuthorizationError`, so the 403 branch has to be
+     * tested first or every refusal of a permission is reported as a failure to authenticate. Both
+     * auth branches come before a class's own declaration, so an auth refusal can never be restated
+     * as something else. Everything that is neither an auth error nor a class declaring an allowed
+     * {@link HttpErrorHelper.declaredErrorStatus} answers 500.
+     */
+    errorStatus: (error: unknown) => number;
+    /** Invalid or absent configuration always resolves to the production-safe policy. */
+    errorExposure: (config?: Pick<Config, 'http'>) => HttpErrorExposure;
+    /** One central wire shape for every server error. */
+    serializeError: (error: Error, exposure?: HttpErrorExposure) => SerializedHttpError;
+    /** Apply safe response metadata carried by an error without coupling its package to Fastify. */
+    applyErrorHeaders: (error: unknown, reply: FastifyReply) => void;
+    /**
+     * Answer a thrown error: a status, and the marshalled `ResilientError` as the body.
+     *
+     * The status is resolved in two steps. The error AS THROWN comes first: it is the one object whose
+     * class is certainly the class that was raised, while `ResilientError.ensure` rebuilds through the
+     * registry of whichever `@owlmeans/error` copy this module loaded — under duplicate module copies
+     * that turns a perfectly recognisable auth refusal into a plain `ResilientError` answering 500.
+     * Only when the thrown error answers 500 is the ENSURED error asked, because the rebuild is what
+     * gives a status to a marshalled error that crossed a hop as a plain `Error`.
+     */
+    handleError: (error: Error, reply: FastifyReply, exposure?: HttpErrorExposure) => void;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/utils/error/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/utils/error/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAC3C,OAAO,KAAK,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAC/D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAEtD,8GAA8G;AAC9G,MAAM,WAAW,eAAe;IAC9B;;;;;;;;OAQG;IACH,mBAAmB,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,GAAG,IAAI,CAAA;IACtD;;;;;;;;;;;;;;;;OAgBG;IACH,WAAW,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,CAAA;IACvC,qFAAqF;IACrF,aAAa,EAAE,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,iBAAiB,CAAA;IACnE,qDAAqD;IACrD,cAAc,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,CAAC,EAAE,iBAAiB,KAAK,mBAAmB,CAAA;IACnF,gGAAgG;IAChG,iBAAiB,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,YAAY,KAAK,IAAI,CAAA;IAChE;;;;;;;;;OASG;IACH,WAAW,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,QAAQ,CAAC,EAAE,iBAAiB,KAAK,IAAI,CAAA;CACvF"}

package/build/utils/error/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build/utils/error/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/utils/error/types.ts"],"names":[],"mappings":""}

package/build/utils/error.d.ts

@@ -1,16 +1,6 @@
-import type { FastifyReply } from 'fastify';
-/**
- * Map a thrown error onto an HTTP status.
- *
- * Two families reach here and both must be recognised. `AuthFailedError` / `AccessError` are this
- * package's own, raised by the request pipeline itself. `AuthorizationError` / `AuthForbidden`
- * come from `@owlmeans/auth` and are what the guards and gates actually throw — an unrecognised
- * one answers 500, which reports a refused request as a crashed server: the client cannot tell
- * "sign in again" from "the service is broken", and a consumer watching statuses concludes the
- * application fell over.
- *
- * **Order matters.** `AuthForbidden extends AuthorizationError`, so the 403 branch has to be
- * tested first or every refusal of a permission is reported as a failure to authenticate.
- */
-export declare const handleError: (error: Error, reply: FastifyReply) => void;
+import type { HttpErrorHelper } from './error/types.js';
+export declare const createHttpErrorHelper: () => HttpErrorHelper;
+export declare const httpErrorHelper: HttpErrorHelper;
+/** @deprecated compat:factory-refactor — use `httpErrorHelper.errorStatus(…)` */
+export declare const errorStatus: (error: unknown) => number;
 //# sourceMappingURL=error.d.ts.map

package/build/utils/error.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../src/utils/error.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAK3C;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,WAAW,GAAI,OAAO,KAAK,EAAE,OAAO,YAAY,SAe5D,CAAA"}
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../src/utils/error.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAEvD,eAAO,MAAM,qBAAqB,QAAO,eA6IxC,CAAA;AAED,eAAO,MAAM,eAAe,iBAA0B,CAAA;AAEtD,iFAAiF;AACjF,eAAO,MAAM,WAAW,UAAW,OAAO,KAAG,MAA4C,CAAA"}

package/build/utils/error.js

@@ -1,33 +1,138 @@
-import { FORBIDDEN_ERROR, SERVER_ERROR, UNAUTHORIZED_ERROR } from '@owlmeans/api';
+import { FORBIDDEN_ERROR, SERVER_ERROR, UNAUTHORIZED_ERROR, DENIAL_KIND_HEADER, ACCESS_DENIED_KIND, } from '@owlmeans/api';
 import { AccessError, AuthFailedError } from '../errors.js';
 import { AuthForbidden, AuthorizationError } from '@owlmeans/auth';
-import { ResilientError } from '@owlmeans/error';
-/**
- * Map a thrown error onto an HTTP status.
- *
- * Two families reach here and both must be recognised. `AuthFailedError` / `AccessError` are this
- * package's own, raised by the request pipeline itself. `AuthorizationError` / `AuthForbidden`
- * come from `@owlmeans/auth` and are what the guards and gates actually throw — an unrecognised
- * one answers 500, which reports a refused request as a crashed server: the client cannot tell
- * "sign in again" from "the service is broken", and a consumer watching statuses concludes the
- * application fell over.
- *
- * **Order matters.** `AuthForbidden extends AuthorizationError`, so the 403 branch has to be
- * tested first or every refusal of a permission is reported as a failure to authenticate.
- */
-export const handleError = (error, reply) => {
-    let code = SERVER_ERROR;
-    if (error instanceof AuthForbidden || error instanceof AccessError) {
-        // An established identity that lacks the permission. Re-authenticating changes nothing.
-        code = FORBIDDEN_ERROR;
-    }
-    else if (error instanceof AuthorizationError || error instanceof AuthFailedError) {
-        // No usable credential — absent, expired, revoked, or naming a session this server no longer
-        // holds. The caller is told to sign in, not that signing in would not help.
-        code = UNAUTHORIZED_ERROR;
-    }
-    if (!reply.sent) {
-        reply.code(code).send(ResilientError.marshal(ResilientError.ensure(error)).message);
-    }
+import { isResilientError, ResilientError, SEPARATOR } from '@owlmeans/error';
+import { randomUUID } from 'node:crypto';
+import { fastifyLogUtils } from './log.js';
+import { CLIENT_ERROR_FIRST, CLIENT_ERROR_LAST, SERVER_ERROR_FIRST, SERVER_ERROR_LAST } from './consts.local.js';
+import { INCIDENT_ID_HEADER } from './consts.js';
+export const createHttpErrorHelper = () => {
+    const declaredErrorStatus = (error) => {
+        if (error == null || typeof error !== 'object') {
+            return null;
+        }
+        const declaration = error.constructor;
+        const status = declaration?.httpStatus;
+        if (typeof status !== 'number' || !Number.isInteger(status)) {
+            return null;
+        }
+        if (status >= CLIENT_ERROR_FIRST && status <= CLIENT_ERROR_LAST)
+            return status;
+        if (status >= SERVER_ERROR_FIRST && status <= SERVER_ERROR_LAST
+            && declaration?.allowServerErrorStatus === true)
+            return status;
+        return null;
+    };
+    /**
+     * The registered type names an error carries: its own `type`, and the static `typeName` of every
+     * class on its constructor chain.
+     *
+     * This is how a class is recognised when `instanceof` cannot see it. A process that loads a package
+     * twice — `bun --preserve-symlinks` over a linked workspace resolves one package through several
+     * `node_modules` paths — holds several copies of every error class, and an error built by one copy
+     * is not an instance of another. The registered names are the same in every copy. A subclass's
+     * `typeName` does not reliably embed its parent's (`EntitlementRefusal` extends `AuthForbidden`), so
+     * a family is recognised by walking the chain and matching names exactly, never by a substring.
+     */
+    const typeNamesOf = (error) => {
+        const names = new Set();
+        const type = error.type;
+        if (typeof type === 'string') {
+            names.add(type);
+        }
+        let ctor = error.constructor;
+        while (typeof ctor === 'function') {
+            const name = ctor.typeName;
+            if (typeof name === 'string') {
+                names.add(name);
+            }
+            ctor = Object.getPrototypeOf(ctor);
+        }
+        return names;
+    };
+    const isOfFamily = (names, family) => family.some(typeName => names.has(typeName));
+    const errorStatus = (error) => {
+        if (error == null || typeof error !== 'object') {
+            return SERVER_ERROR;
+        }
+        const names = typeNamesOf(error);
+        if (error instanceof AuthForbidden || error instanceof AccessError
+            || isOfFamily(names, [AuthForbidden.typeName, AccessError.typeName])) {
+            // An established identity that lacks the permission. Re-authenticating changes nothing.
+            return FORBIDDEN_ERROR;
+        }
+        if (error instanceof AuthorizationError || error instanceof AuthFailedError
+            || isOfFamily(names, [AuthorizationError.typeName, AuthFailedError.typeName])) {
+            // No usable credential — absent, expired, revoked, or naming a session this server no longer
+            // holds. The caller is told to sign in, not that signing in would not help.
+            return UNAUTHORIZED_ERROR;
+        }
+        return declaredErrorStatus(error) ?? SERVER_ERROR;
+    };
+    const errorExposure = (config) => config?.http?.errors?.exposure === 'development' ? 'development' : 'production';
+    /**
+     * Preserve a typed/marshalled error when possible without asking `ensure` to convert a plain
+     * error. In particular, `ensure` deliberately rethrows SyntaxError; an HTTP boundary still has
+     * to serialize it safely and let the incident log retain the original object.
+     */
+    const normalizeForWire = (error) => {
+        if (error instanceof SyntaxError || isResilientError(error)) {
+            return error;
+        }
+        if (error.message.includes(SEPARATOR)) {
+            const ensured = ResilientError.ensure(error);
+            // The catch-all converter's legacy constructor shape shifts an ordinary error's fields.
+            // Only keep `ensure`'s result when a registered wire prefix actually rebuilt something.
+            if (ensured.type !== error.message || ensured.message !== error.stack) {
+                return ensured;
+            }
+        }
+        return error;
+    };
+    const serializeError = (error, exposure = 'production') => {
+        const normalized = normalizeForWire(error);
+        const thrown = errorStatus(error);
+        const status = thrown !== SERVER_ERROR ? thrown : errorStatus(normalized);
+        const incidentId = randomUUID();
+        // The server log owns every diagnostic. Production callers receive only its correlation key;
+        // development keeps the typed wire form so local clients can retain their usual error details.
+        Object.assign(error, { incidentId });
+        if (isResilientError(normalized))
+            normalized.incidentId = incidentId;
+        const body = exposure === 'production'
+            ? incidentId
+            : ResilientError.marshal(normalized, { includeStack: true, incidentId }).message;
+        return { status, body, incidentId };
+    };
+    const applyErrorHeaders = (error, reply) => {
+        if (error == null || typeof error !== 'object') {
+            return;
+        }
+        const retryAfter = error.retryAfter;
+        if (typeof retryAfter === 'number' && Number.isFinite(retryAfter) && retryAfter > 0) {
+            reply.header('Retry-After', String(Math.ceil(retryAfter)));
+        }
+        // Match exact registered types. EntitlementRefusal also extends AuthForbidden but is a plan
+        // decision, not a person's IAM permission denial.
+        const type = error.type;
+        if (type === AuthForbidden.typeName || type === AccessError.typeName) {
+            reply.header(DENIAL_KIND_HEADER, ACCESS_DENIED_KIND);
+        }
+    };
+    const handleError = (error, reply, exposure = 'production') => {
+        if (!reply.sent) {
+            const serialized = serializeError(error, exposure);
+            applyErrorHeaders(error, reply);
+            // The one record of a failed request: method, path and status — never what the caller sent.
+            fastifyLogUtils.failure(error, reply.request, serialized.status, serialized.incidentId);
+            reply.header(INCIDENT_ID_HEADER, serialized.incidentId)
+                .code(serialized.status)
+                .send(serialized.body);
+        }
+    };
+    return { declaredErrorStatus, errorStatus, errorExposure, serializeError, applyErrorHeaders, handleError };
 };
+export const httpErrorHelper = createHttpErrorHelper();
+/** @deprecated compat:factory-refactor — use `httpErrorHelper.errorStatus(…)` */
+export const errorStatus = (error) => httpErrorHelper.errorStatus(error);
 //# sourceMappingURL=error.js.map

package/build/utils/error.js.map

@@ -1 +1 @@
-{"version":3,"file":"error.js","sourceRoot":"","sources":["../../src/utils/error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAEjF,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAC3D,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAEhD;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,KAAY,EAAE,KAAmB,EAAE,EAAE;IAC/D,IAAI,IAAI,GAAW,YAAY,CAAA;IAC/B,IAAI,KAAK,YAAY,aAAa,IAAI,KAAK,YAAY,WAAW,EAAE,CAAC;QACnE,wFAAwF;QACxF,IAAI,GAAG,eAAe,CAAA;IACxB,CAAC;SAAM,IAAI,KAAK,YAAY,kBAAkB,IAAI,KAAK,YAAY,eAAe,EAAE,CAAC;QACnF,6FAA6F;QAC7F,4EAA4E;QAC5E,IAAI,GAAG,kBAAkB,CAAA;IAC3B,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QAChB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CACnB,cAAc,CAAC,OAAO,CAAC,cAAc,CAAC,MAAM,CAAC,KAAc,CAAC,CAAC,CAAC,OAAO,CACtE,CAAA;IACH,CAAC;AACH,CAAC,CAAA"}
+{"version":3,"file":"error.js","sourceRoot":"","sources":["../../src/utils/error.ts"],"names":[],"mappings":"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"}

package/build/utils/guards.d.ts

@@ -1,9 +1,5 @@
 import type { FastifyReply, FastifyRequest } from 'fastify';
 import type { ServerEntrypoint } from '@owlmeans/server-entrypoint';
-import type { ServerConfig, ServerContext } from '@owlmeans/server-context';
-type Config = ServerConfig;
-interface Context<C extends Config = Config> extends ServerContext<C> {
-}
+import type { Config, Context } from './types.local.js';
 export declare const authorize: <C extends Config, T extends Context<C>>(context: T, module: ServerEntrypoint<FastifyRequest>, req: FastifyRequest, reply: FastifyReply) => Promise<[T, ServerEntrypoint<FastifyRequest>]>;
-export {};
 //# sourceMappingURL=guards.d.ts.map

package/build/utils/guards.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"guards.d.ts","sourceRoot":"","sources":["../../src/utils/guards.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAC3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAA;AAGnE,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AAK3E,KAAK,MAAM,GAAG,YAAY,CAAA;AAC1B,UAAU,OAAO,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,CAAE,SAAQ,aAAa,CAAC,CAAC,CAAC;CAAI;AAEzE,eAAO,MAAM,SAAS,GAAU,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,OAAO,CAAC,CAAC,CAAC,EACpE,SAAS,CAAC,EAAE,QAAQ,gBAAgB,CAAC,cAAc,CAAC,EACpD,KAAK,cAAc,EAAE,OAAO,YAAY,KACvC,OAAO,CAAC,CAAC,CAAC,EAAE,gBAAgB,CAAC,cAAc,CAAC,CAAC,CA0D/C,CAAA"}
+{"version":3,"file":"guards.d.ts","sourceRoot":"","sources":["../../src/utils/guards.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAC3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAA;AAKnE,OAAO,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAA;AAIvD,eAAO,MAAM,SAAS,GAAU,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,OAAO,CAAC,CAAC,CAAC,WAC3D,CAAC,UAAU,gBAAgB,CAAC,cAAc,CAAC,OAC/C,cAAc,SAAS,YAAY,KACvC,OAAO,CAAC,CAAC,CAAC,EAAE,gBAAgB,CAAC,cAAc,CAAC,CAAC,CAmD/C,CAAA"}

package/build/utils/guards.js

@@ -1,19 +1,19 @@
-import { isContextWithoutIds, Layer } from '@owlmeans/context';
 import { provideResponse } from '@owlmeans/entrypoint';
-import { executeResponse, provideRequest } from './payload.js';
+import { payloadHelper } from './payload.js';
 import { AuthFailedError } from '../errors.js';
+import { makeEntityScope } from '@owlmeans/auth-common';
 export const authorize = async (context, module, req, reply) => {
     const guards = module.getGuards();
     if (guards.length > 0) {
         const response = provideResponse(reply);
-        const request = provideRequest(module.alias, req);
+        const request = payloadHelper.provideRequest(module.alias, req);
         let guard = undefined;
         for (const alias of guards) {
             const _guard = context.service(alias);
             if (await _guard.match(request, response)) {
                 guard = _guard;
             }
-            executeResponse(response, reply, true);
+            payloadHelper.executeResponse(response, reply, true);
             if (guard != null) {
                 break;
             }
@@ -25,7 +25,7 @@ export const authorize = async (context, module, req, reply) => {
         if (!await guard.handle(request, authResponse)) {
             throw new AuthFailedError(guard.alias);
         }
-        executeResponse(authResponse, reply, true);
+        payloadHelper.executeResponse(authResponse, reply, true);
         // Guard that returns true and does not provide an error is an optional guard
         // if (authResponse.value == null) {
         //   throw SyntaxError(`Guard that returns true and does not provide an error, should provide authorization`)
@@ -34,20 +34,16 @@ export const authorize = async (context, module, req, reply) => {
         if (request.auth != null) {
             req._auth = request.auth;
         }
-        if (request.auth?.entityId != null) {
-            // @TODO Probably we need to downgrade context in this case
-            if (!isContextWithoutIds(context)) {
-                throw SyntaxError(`Context should be without ids during authorization ${context.cfg.layer}:${context.cfg.layerId}`);
-            }
-            if (isContextWithoutIds(context) && context.cfg.layer !== Layer.Service) {
-                context = await context.updateContext(undefined, Layer.Service);
-                await context.waitForInitialized();
-            }
-            context = await context.updateContext(request.auth.entityId, Layer.Entity);
-            await context.waitForInitialized();
-            // We elevate module to the context level if it was changed
-            module = context.entrypoint(module.alias);
-            await module.resolve();
+        // The token names the organization by slug; everything downstream — grants, records, minted
+        // infrastructure names — keys on the entity's stable id. Resolving here, once, is what keeps a
+        // rename from being a sweep of every handler: the id arrives on the request, and a slug that
+        // has since been retired still resolves to the entity that retired it.
+        const entity = await makeEntityScope(request).attachEntity(context);
+        if (entity != null) {
+            // Carried on the raw request the same way `_auth` is, so the request the handler is given
+            // later — a different object, built after this runs — sees the same resolution.
+            ;
+            req._entity = entity;
         }
     }
     // Update context in request object

package/build/utils/guards.js.map

@@ -1 +1 @@
-{"version":3,"file":"guards.js","sourceRoot":"","sources":["../../src/utils/guards.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"guards.js","sourceRoot":"","sources":["../../src/utils/guards.ts"],"names":[],"mappings":"AAEA,OAAO,EAAqB,eAAe,EAAE,MAAM,sBAAsB,CAAA;AACzE,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAG9C,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAGvD,MAAM,CAAC,MAAM,SAAS,GAAG,KAAK,EAC5B,OAAU,EAAE,MAAwC,EACpD,GAAmB,EAAE,KAAmB,EACQ,EAAE;IAClD,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,EAAE,CAAA;IACjC,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,QAAQ,GAAG,eAAe,CAAC,KAAK,CAAC,CAAA;QACvC,MAAM,OAAO,GAAG,aAAa,CAAC,cAAc,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,CAAA;QAE/D,IAAI,KAAK,GAA6B,SAAS,CAAA;QAC/C,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,MAAM,MAAM,GAAiB,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;YACnD,IAAI,MAAM,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,CAAC;gBAC1C,KAAK,GAAG,MAAM,CAAA;YAChB,CAAC;YACD,aAAa,CAAC,eAAe,CAAC,QAAQ,EAAE,KAAK,EAAE,IAAI,CAAC,CAAA;YACpD,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;gBAClB,MAAK;YACP,CAAC;QACH,CAAC;QAED,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;YAClB,MAAM,IAAI,eAAe,EAAE,CAAA;QAC7B,CAAC;QAED,MAAM,YAAY,GAAG,eAAe,CAAO,KAAK,CAAC,CAAA;QACjD,IAAI,CAAC,MAAM,KAAK,CAAC,MAAM,CAAU,OAAO,EAAE,YAAY,CAAC,EAAE,CAAC;YACxD,MAAM,IAAI,eAAe,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;QACxC,CAAC;QACD,aAAa,CAAC,eAAe,CAAC,YAAY,EAAE,KAAK,EAAE,IAAI,CAAC,CAAA;QACxD,6EAA6E;QAC7E,oCAAoC;QACpC,6GAA6G;QAC7G,IAAI;QACJ,OAAO,CAAC,IAAI,GAAG,YAAY,CAAC,KAAK,CAAC;QAClC,IAAI,OAAO,CAAC,IAAI,IAAI,IAAI,EAAE,CAAC;YACxB,GAAW,CAAC,KAAK,GAAG,OAAO,CAAC,IAAI,CAAA;QACnC,CAAC;QAED,4FAA4F;QAC5F,+FAA+F;QAC/F,6FAA6F;QAC7F,uEAAuE;QACvE,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,OAAO,CAAC,CAAA;QACnE,IAAI,MAAM,IAAI,IAAI,EAAE,CAAC;YACnB,0FAA0F;YAC1F,gFAAgF;YAChF,CAAC;YAAC,GAAW,CAAC,OAAO,GAAG,MAAM,CAAA;QAChC,CAAC;IACH,CAAC;IACD,mCAAmC;IAClC,GAAW,CAAC,IAAI,GAAG,OAAO,CAAA;IAE3B,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;AAC1B,CAAC,CAAA"}

package/build/utils/index.d.ts

@@ -1,7 +1,12 @@
 export * from './error.js';
+export * from './consts.js';
+export type * from './types.js';
+export type * from './error/types.js';
+export type * from './payload/types.js';
+export type * from './context/types.js';
 export * from './server.js';
 export * from './payload.js';
-export * from './server.js';
+export * from './schema.js';
 export * from './guards.js';
 export * from './context.js';
 //# sourceMappingURL=index.d.ts.map

package/build/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AACA,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AACA,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA;AAC3B,mBAAmB,YAAY,CAAA;AAC/B,mBAAmB,kBAAkB,CAAA;AACrC,mBAAmB,oBAAoB,CAAA;AACvC,mBAAmB,oBAAoB,CAAA;AACvC,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA"}

package/build/utils/index.js

@@ -1,7 +1,8 @@
 export * from './error.js';
+export * from './consts.js';
 export * from './server.js';
 export * from './payload.js';
-export * from './server.js';
+export * from './schema.js';
 export * from './guards.js';
 export * from './context.js';
 //# sourceMappingURL=index.js.map

package/build/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AACA,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AACA,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA;AAK3B,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA"}

package/build/utils/log/consts.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Keys of a Fastify log record that carry what a caller sent. They are dropped at every depth: a
+ * request body and its raw form (`rawBody`), multipart fields and file buffers, headers (with the
+ * authorization and cookie values), cookies and the parsed query string.
+ */
+export declare const UNSAFE_LOG_KEYS: ReadonlySet<string>;
+/** Deepest nesting `safeData` walks; anything below is one marker. */
+export declare const SAFE_DATA_DEPTH = 4;
+/**
+ * The query string of a path or URL inside free text (a Fastify warning names `"/x?token=…"`): the
+ * path is kept (`$1`), the query is cut.
+ */
+export declare const QUERY_IN_TEXT: RegExp;
+//# sourceMappingURL=consts.d.ts.map

package/build/utils/log/consts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consts.d.ts","sourceRoot":"","sources":["../../../src/utils/log/consts.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,eAAe,EAAE,WAAW,CAAC,MAAM,CAG9C,CAAA;AAEF,sEAAsE;AACtE,eAAO,MAAM,eAAe,IAAI,CAAA;AAEhC;;;GAGG;AACH,eAAO,MAAM,aAAa,QAAgC,CAAA"}

package/build/utils/log/consts.js

@@ -0,0 +1,17 @@
+/**
+ * Keys of a Fastify log record that carry what a caller sent. They are dropped at every depth: a
+ * request body and its raw form (`rawBody`), multipart fields and file buffers, headers (with the
+ * authorization and cookie values), cookies and the parsed query string.
+ */
+export const UNSAFE_LOG_KEYS = new Set([
+    'body', 'rawBody', 'payload', 'files', 'file', 'headers', 'rawHeaders', 'trailers', 'rawTrailers',
+    'query', 'querystring', 'cookies', 'cookie', 'authorization',
+]);
+/** Deepest nesting `safeData` walks; anything below is one marker. */
+export const SAFE_DATA_DEPTH = 4;
+/**
+ * The query string of a path or URL inside free text (a Fastify warning names `"/x?token=…"`): the
+ * path is kept (`$1`), the query is cut.
+ */
+export const QUERY_IN_TEXT = /(\/[^\s?"'`]*)\?[^\s"'`)]+/g;
+//# sourceMappingURL=consts.js.map

package/build/utils/log/consts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consts.js","sourceRoot":"","sources":["../../../src/utils/log/consts.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAwB,IAAI,GAAG,CAAC;IAC1D,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,YAAY,EAAE,UAAU,EAAE,aAAa;IACjG,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,QAAQ,EAAE,eAAe;CAC7D,CAAC,CAAA;AAEF,sEAAsE;AACtE,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAA;AAEhC;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,6BAA6B,CAAA"}

package/build/utils/log/types.d.ts

@@ -0,0 +1,42 @@
+import type { FastifyBaseLogger, LogController } from 'fastify';
+import type { Logger } from '@owlmeans/log';
+/** All a log record may say about a request: its method and its path — never the query string. */
+export interface RequestSummary {
+    method?: string;
+    path?: string;
+}
+/**
+ * How the API server's Fastify instance logs: through `@owlmeans/log`, and never with what a caller
+ * sent — a body, a raw body, multipart bytes, headers, cookies or a query string.
+ */
+export interface FastifyLogUtils {
+    /**
+     * A pino-shaped logger over `log` (scope `http` by default), handed to Fastify as its
+     * `loggerInstance`. Every record's data — Fastify's own and any plugin's — passes `safeData`.
+     */
+    logger: (log?: Logger, bindings?: Record<string, unknown>) => FastifyBaseLogger;
+    /**
+     * The `logController` Fastify writes its own request lines through: no per-request pair (the
+     * server writes one debug record from `onResponse`), a request the default error handler answers
+     * is `failure`, a missing route is one debug line without its query.
+     */
+    controller: () => LogController;
+    /**
+     * A copy of a record's data that is safe to write: a request becomes its `RequestSummary`, a reply
+     * its status, bytes their size, any other class instance its name; the keys that carry what a
+     * caller sent (`body`, `rawBody`, `headers`, `query`, `cookies`, files…) are dropped at every depth
+     * (a number or boolean under them stays: a count, a flag), and any string loses the query of a URL
+     * it names. An `Error` passes as it is (a copy, when its message names a URL with a query) — the
+     * log writes only its name, message, code and stack.
+     */
+    safeData: (data: unknown) => unknown;
+    /** The method and the path, without the query string, of a Fastify or Node request. */
+    requestOf: (request: unknown) => RequestSummary;
+    /**
+     * The one record of a failed request, by what its status means: 5xx `error` with the error,
+     * 403 `warn` `access.forbidden`, 401 `debug` `auth.refused`, any other 4xx `debug` with the error's
+     * code and message. Method, path and status only — never the request's content.
+     */
+    failure: (error: Error, request: unknown, status: number, incidentId?: string) => void;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/utils/log/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/utils/log/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAC/D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAE3C,kGAAkG;AAClG,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,iBAAiB,CAAA;IAC/E;;;;OAIG;IACH,UAAU,EAAE,MAAM,aAAa,CAAA;IAC/B;;;;;;;OAOG;IACH,QAAQ,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAA;IACpC,uFAAuF;IACvF,SAAS,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,cAAc,CAAA;IAC/C;;;;OAIG;IACH,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;CACvF"}

package/build/utils/log/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build/utils/log/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/utils/log/types.ts"],"names":[],"mappings":""}

package/build/utils/log.d.ts

@@ -0,0 +1,4 @@
+import type { FastifyLogUtils } from './log/types.js';
+export declare const createFastifyLogUtils: () => FastifyLogUtils;
+export declare const fastifyLogUtils: FastifyLogUtils;
+//# sourceMappingURL=log.d.ts.map

package/build/utils/log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.d.ts","sourceRoot":"","sources":["../../src/utils/log.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,eAAe,EAAkB,MAAM,gBAAgB,CAAA;AA4BrE,eAAO,MAAM,qBAAqB,QAAO,eA4JxC,CAAA;AAED,eAAO,MAAM,eAAe,iBAA0B,CAAA"}