@owlmeans/server-api 0.1.18-rc.50 → 0.1.18-rc.51

package/build/utils/payload.js

@@ -1,68 +1,48 @@
 import { EntrypointOutcome } from '@owlmeans/entrypoint';
 import { ACCEPTED, CREATED, OK } from '@owlmeans/api';
-import { handleError } from './error.js';
-export const provideRequest = (alias, req, provision) => {
-    provision = provision ?? false;
-    return {
-        alias,
-        auth: req._auth ?? undefined,
-        // Resolved once by `authorize` and carried by reference, exactly like `_auth`, so a handler
-        // reached through any path sees the same entity the guard admitted.
-        entity: req._entity ?? undefined,
-        params: req.params,
-        body: req.body,
-        headers: req.headers,
-        query: req.query,
-        path: req.url,
-        original: provision ? req : undefined
+import { httpErrorHelper } from './error.js';
+export const createPayloadHelper = () => {
+    const provideRequest = (alias, req, provision) => {
+        provision = provision ?? false;
+        return {
+            alias,
+            auth: req._auth ?? undefined,
+            // Resolved once by `authorize` and carried by reference, exactly like `_auth`, so a handler
+            // reached through any path sees the same entity the guard admitted.
+            entity: req._entity ?? undefined,
+            params: req.params,
+            body: req.body,
+            headers: req.headers,
+            query: req.query,
+            path: req.url,
+            original: provision ? req : undefined
+        };
     };
-};
-/**
- * Emits the response onto the fastify reply if the handler produced an
- * error or an outcome. Returns `true` when something was actually sent so
- * callers don't rely on `reply.sent`, which in fastify v5 only flips once
- * the raw socket finishes writing (asynchronously) and therefore reads
- * `false` synchronously right after `reply.send()`.
- *
- * @throws {Error}
- */
-export const executeResponse = (response, reply, throwOnError) => {
-    if (response.error != null) {
-        if (throwOnError ?? false) {
-            throw response.error;
-        }
-        handleError(response.error, reply);
-        return true;
-    }
-    else if (response.outcome != null) {
-        switch (response.outcome) {
-            case EntrypointOutcome.Accepted:
-                reply.code(ACCEPTED).send(response.value);
-                break;
-            case EntrypointOutcome.Created:
-                reply.code(CREATED).send(response.value);
-                break;
-            case EntrypointOutcome.Ok:
-            default:
-                reply.code(OK).send(response.value);
-        }
-        return true;
-    }
-    return false;
-};
-export const fixFormatDates = (schema) => {
-    if (schema.type === 'object') {
-        if (schema.format === 'date-time') {
-            schema.type = 'string';
-            schema.format = 'date-time';
-            if (schema.required != null) {
-                delete schema.required;
+    const executeResponse = (response, reply, throwOnError) => {
+        if (response.error != null) {
+            if (throwOnError ?? false) {
+                throw response.error;
             }
+            httpErrorHelper.handleError(response.error, reply);
+            return true;
         }
-        else if (schema.properties != null) {
-            schema.properties = Object.fromEntries(Object.entries(schema.properties).map(([key, value]) => [key, fixFormatDates(value)]));
+        else if (response.outcome != null) {
+            switch (response.outcome) {
+                case EntrypointOutcome.Accepted:
+                    reply.code(ACCEPTED).send(response.value);
+                    break;
+                case EntrypointOutcome.Created:
+                    reply.code(CREATED).send(response.value);
+                    break;
+                case EntrypointOutcome.Ok:
+                default:
+                    reply.code(OK).send(response.value);
+            }
+            return true;
         }
-    }
-    return schema;
+        return false;
+    };
+    return { provideRequest, executeResponse };
 };
+export const payloadHelper = createPayloadHelper();
 //# sourceMappingURL=payload.js.map

package/build/utils/payload.js.map

@@ -1 +1 @@
-{"version":3,"file":"payload.js","sourceRoot":"","sources":["../../src/utils/payload.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"payload.js","sourceRoot":"","sources":["../../src/utils/payload.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AAGxD,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,eAAe,CAAA;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAG5C,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAkB,EAAE;IACrD,MAAM,cAAc,GAAG,CAAC,KAAa,EAAE,GAAY,EAAE,SAAmB,EAAmB,EAAE;QAC3F,SAAS,GAAG,SAAS,IAAI,KAAK,CAAA;QAC9B,OAAO;YACL,KAAK;YACL,IAAI,EAAG,GAAW,CAAC,KAAK,IAAI,SAAS;YACrC,4FAA4F;YAC5F,oEAAoE;YACpE,MAAM,EAAG,GAAW,CAAC,OAAO,IAAI,SAAS;YACzC,MAAM,EAAE,GAAG,CAAC,MAA4D;YACxE,IAAI,EAAE,GAAG,CAAC,IAA2B;YACrC,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,KAAK,EAAE,GAAG,CAAC,KAA2D;YACtE,IAAI,EAAE,GAAG,CAAC,GAAG;YACb,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS;SACtC,CAAA;IACH,CAAC,CAAA;IAED,MAAM,eAAe,GAAG,CAAI,QAA6B,EAAE,KAAe,EAAE,YAAsB,EAAW,EAAE;QAC7G,IAAI,QAAQ,CAAC,KAAK,IAAI,IAAI,EAAE,CAAC;YAC3B,IAAI,YAAY,IAAI,KAAK,EAAE,CAAC;gBAC1B,MAAM,QAAQ,CAAC,KAAK,CAAA;YACtB,CAAC;YACD,eAAe,CAAC,WAAW,CAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,CAAA;YAClD,OAAO,IAAI,CAAA;QACb,CAAC;aAAM,IAAI,QAAQ,CAAC,OAAO,IAAI,IAAI,EAAE,CAAC;YACpC,QAAQ,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACzB,KAAK,iBAAiB,CAAC,QAAQ;oBAC7B,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;oBACzC,MAAK;gBACP,KAAK,iBAAiB,CAAC,OAAO;oBAC5B,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;oBACxC,MAAK;gBACP,KAAK,iBAAiB,CAAC,EAAE,CAAC;gBAC1B;oBACE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;YACvC,CAAC;YACD,OAAO,IAAI,CAAA;QACb,CAAC;QAED,OAAO,KAAK,CAAA;IACd,CAAC,CAAA;IAED,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,CAAA;AAC5C,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,aAAa,GAAG,mBAAmB,EAAE,CAAA"}

package/build/utils/schema.d.ts

@@ -0,0 +1,7 @@
+import type { AnySchemaObject } from 'ajv';
+/**
+ * A request schema Fastify can serve: a `date-time` object becomes a `date-time` string (and loses
+ * its `required` list), recursively through object properties. Mutates and returns `schema`.
+ */
+export declare const fixFormatDates: (schema: AnySchemaObject) => AnySchemaObject;
+//# sourceMappingURL=schema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/utils/schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,KAAK,CAAA;AAE1C;;;GAGG;AACH,eAAO,MAAM,cAAc,WAAY,eAAe,KAAG,eAgBxD,CAAA"}

package/build/utils/schema.js

@@ -0,0 +1,20 @@
+/**
+ * A request schema Fastify can serve: a `date-time` object becomes a `date-time` string (and loses
+ * its `required` list), recursively through object properties. Mutates and returns `schema`.
+ */
+export const fixFormatDates = (schema) => {
+    if (schema.type === 'object') {
+        if (schema.format === 'date-time') {
+            schema.type = 'string';
+            schema.format = 'date-time';
+            if (schema.required != null) {
+                delete schema.required;
+            }
+        }
+        else if (schema.properties != null) {
+            schema.properties = Object.fromEntries(Object.entries(schema.properties).map(([key, value]) => [key, fixFormatDates(value)]));
+        }
+    }
+    return schema;
+};
+//# sourceMappingURL=schema.js.map

package/build/utils/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/utils/schema.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,MAAuB,EAAmB,EAAE;IACzE,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;YAClC,MAAM,CAAC,IAAI,GAAG,QAAQ,CAAA;YACtB,MAAM,CAAC,MAAM,GAAG,WAAW,CAAA;YAC3B,IAAI,MAAM,CAAC,QAAQ,IAAI,IAAI,EAAE,CAAC;gBAC5B,OAAO,MAAM,CAAC,QAAQ,CAAA;YACxB,CAAC;QACH,CAAC;aAAM,IAAI,MAAM,CAAC,UAAU,IAAI,IAAI,EAAE,CAAC;YACrC,MAAM,CAAC,UAAU,GAAG,MAAM,CAAC,WAAW,CACpC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,cAAc,CAAC,KAAwB,CAAC,CAAC,CAAC,CACzG,CAAA;QACH,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC,CAAA"}

package/build/utils/server.js

@@ -3,8 +3,8 @@ import { provideResponse } from '@owlmeans/entrypoint';
 import { ResilientError } from '@owlmeans/error';
 import { OK } from '@owlmeans/api';
 import { logger } from '@owlmeans/log';
-import { errorExposure, handleError } from './error.js';
-import { executeResponse, provideRequest } from './payload.js';
+import { httpErrorHelper } from './error.js';
+import { payloadHelper } from './payload.js';
 import { authorize } from './guards.js';
 import { RouteProtocols } from '@owlmeans/route';
 export const canServeModule = (context, module) => {
@@ -29,12 +29,12 @@ export const createServerHandler = (module, location) => async (req, reply) => {
         context = authorized[0];
         module = authorized[1];
         const response = provideResponse(reply);
-        const request = provideRequest(module.alias, req, true);
+        const request = payloadHelper.provideRequest(module.alias, req, true);
         const gates = module.getGates();
         for (const [srv, params] of gates) {
             const gate = context.service(srv);
             await gate.assert(request, response, params);
-            executeResponse(response, reply, true);
+            payloadHelper.executeResponse(response, reply, true);
         }
         await module.handle(request, response);
         // Don't rely on `reply.sent` here: in fastify v5 it is backed by
@@ -43,7 +43,7 @@ export const createServerHandler = (module, location) => async (req, reply) => {
         // synchronously right after `reply.send()`. Track the emitted state
         // explicitly instead, and only fall back to a default response when
         // neither `executeResponse` nor the handler itself (hijack) replied.
-        const responded = executeResponse(response, reply, true);
+        const responded = payloadHelper.executeResponse(response, reply, true);
         if (!responded && !reply.sent) {
             logger('http').warn(`SENDS DEFAULT RESPONSE: ${module.alias}`);
             reply.code(OK).send(response.value);
@@ -55,7 +55,7 @@ export const createServerHandler = (module, location) => async (req, reply) => {
             fixer.handle(reply, ResilientError.ensure(error));
             return;
         }
-        handleError(error, reply, errorExposure(context.cfg));
+        httpErrorHelper.handleError(error, reply, httpErrorHelper.errorExposure(context.cfg));
     }
 };
 //# sourceMappingURL=server.js.map

package/build/utils/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/utils/server.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/utils/server.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@owlmeans/server-api",
-  "version": "0.1.18-rc.50",
+  "version": "0.1.18-rc.51",
   "license": "MIT",
   "type": "module",
   "scripts": {
@@ -33,16 +33,16 @@
     "@fastify/helmet": "^13.1.1",
     "@fastify/middie": "^9.3.4",
     "@fastify/multipart": "^10.1.2",
-    "@owlmeans/api": "^0.1.18-rc.46",
-    "@owlmeans/auth": "^0.1.18-rc.39",
-    "@owlmeans/auth-common": "^0.1.18-rc.46",
-    "@owlmeans/context": "^0.1.18-rc.33",
-    "@owlmeans/entrypoint": "^0.1.18-rc.40",
-    "@owlmeans/error": "^0.1.18-rc.37",
-    "@owlmeans/log": "^0.1.18-rc.1",
-    "@owlmeans/route": "^0.1.18-rc.34",
-    "@owlmeans/server-context": "^0.1.18-rc.42",
-    "@owlmeans/server-entrypoint": "^0.1.18-rc.39",
+    "@owlmeans/api": "^0.1.18-rc.47",
+    "@owlmeans/auth": "^0.1.18-rc.40",
+    "@owlmeans/auth-common": "^0.1.18-rc.47",
+    "@owlmeans/context": "^0.1.18-rc.34",
+    "@owlmeans/entrypoint": "^0.1.18-rc.41",
+    "@owlmeans/error": "^0.1.18-rc.38",
+    "@owlmeans/log": "^0.1.18-rc.2",
+    "@owlmeans/route": "^0.1.18-rc.35",
+    "@owlmeans/server-context": "^0.1.18-rc.43",
+    "@owlmeans/server-entrypoint": "^0.1.18-rc.40",
     "ajv-errors": "^3.0.0",
     "fastify": "^5.12.5",
     "fastify-raw-body": "^6.0.1",
@@ -54,7 +54,7 @@
   },
   "devDependencies": {
     "@owlmeans/dep-config": "workspace:*",
-    "@owlmeans/resource": "^0.1.18-rc.39",
+    "@owlmeans/resource": "^0.1.18-rc.40",
     "@types/bun": "^1.4.2",
     "@types/node": "^26.6.4",
     "nodemon": "^3.1.14",

package/src/server.ts

@@ -1,7 +1,7 @@
 import type { ServerContext } from '@owlmeans/server-context'
 import type { ApiServer, ApiServerAppend } from './types.js'
 import { assertContext, createService } from '@owlmeans/context'
-import { canServeModule, executeResponse, provideRequest, createServerHandler, fixFormatDates } from './utils/index.js'
+import { canServeModule, payloadHelper, createServerHandler, fixFormatDates } from './utils/index.js'
 import { DEFAULT_ALIAS, CLOSED_HOST, PORT, OPENED_HOST } from './consts.js'
 import type { ServerEntrypoint } from '@owlmeans/server-entrypoint'
 import { RouteMethod } from '@owlmeans/route'
@@ -144,13 +144,13 @@ export const createApiServer = (alias: string): ApiServer => {
         // An intermediate route can be created without a handler by the binding layer.
         if (module.route.match(request, module.mount()) && module.handle != null) {
           const response = provideResponse(reply)
-          const currentRequest = provideRequest(module.alias, request, true)
+          const currentRequest = payloadHelper.provideRequest(module.alias, request, true)
           currentRequest.original._ctx = context
           const result: Context = await module.handle(currentRequest, response)
           if (result != null) {
             context = result
           }
-          responded = executeResponse(response, reply, true) || responded
+          responded = payloadHelper.executeResponse(response, reply, true) || responded
         }
         return context
       }, Promise.resolve(context))

package/src/utils/context/types.ts

@@ -0,0 +1,13 @@
+import type { Config, Context } from '../../types.js'
+
+/** Carries the serving context on one raw request. */
+export interface RequestContextHelper {
+  /** Stores the context on the request. */
+  populateContext: <C extends Config, T extends Context<C>>(context: T) => void
+  /**
+   * The context stored on the request, else `ctx`.
+   *
+   * @throws {SyntaxError} when neither is there
+   */
+  extractContext: <C extends Config, T extends Context<C>>(ctx?: T, location?: string) => T
+}

package/src/utils/context.ts

@@ -1,9 +1,14 @@
 import { assertContext } from '@owlmeans/context'
 import type { Config, Context, Request } from '../types.js'
 import { DEFAULT_ALIAS } from '../consts.js'
+import type { RequestContextHelper } from './context/types.js'
 
-export const populateContext = <C extends Config, T extends Context<C>>(req: Request, context: T): void =>
-  void ((req as any)._ctx = context)
+export const makeRequestContextHelper = (req: Request): RequestContextHelper => {
+  const populateContext = <C extends Config, T extends Context<C>>(context: T): void =>
+    void ((req as any)._ctx = context)
 
-export const extractContext = <C extends Config, T extends Context<C>>(req: Request, ctx?: T, location?: string): T =>
-  assertContext<C, T>((req as any)._ctx ?? ctx, location ?? DEFAULT_ALIAS)
+  const extractContext = <C extends Config, T extends Context<C>>(ctx?: T, location?: string): T =>
+    assertContext<C, T>((req as any)._ctx ?? ctx, location ?? DEFAULT_ALIAS)
+
+  return { populateContext, extractContext }
+}

package/src/utils/error/types.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
+}