@c9up/ream 0.1.24 → 0.1.26

package/dist/graphql/GraphQLProvider.js

@@ -19,6 +19,7 @@ import { Provider } from '../Provider.js';
 import { GraphQLEngine } from './GraphQLEngine.js';
 export class GraphQLProvider extends Provider {
     #engine;
+    #registered = false;
     constructor(app, options = {}) {
         super(app);
         this.#engine = options.engine;
@@ -34,9 +35,11 @@ export class GraphQLProvider extends Provider {
             return; // GraphQL not configured — opt-out.
         const container = this.app.container;
         if (container.has('graphql')) {
-            if (container.resolve('graphql') === engine) {
+            // Idempotent re-register: tracked with a flag rather than
+            // `container.resolve('graphql')` because resolution is now async.
+            if (this.#registered) {
                 this.#engine = engine;
-                return; // re-register is idempotent
+                return;
             }
             throw new ReamError('GRAPHQL_PROVIDER_ALREADY_REGISTERED', "Container token 'graphql' is already bound to a different instance", {
                 hint: 'Only one GraphQLProvider can own the graphql binding. Remove the duplicate provider from your reamrc.ts.',
@@ -45,12 +48,13 @@ export class GraphQLProvider extends Provider {
         engine.useContainer(container);
         this.#engine = engine;
         container.singleton('graphql', () => engine);
+        this.#registered = true;
     }
     async boot() {
         const engine = this.#engine;
         if (!engine)
             return;
-        const router = this.app.container.make('router');
+        const router = await this.app.container.make('router');
         // GraphQLEngine.handle() serves the playground on GET and executes queries
         // on POST, so mount the same path for both verbs.
         router.get(engine.path, (ctx) => engine.handle(ctx));

package/dist/graphql/GraphQLProvider.js.map

@@ -1 +1 @@
-{"version":3,"file":"GraphQLProvider.js","sourceRoot":"","sources":["../../src/graphql/GraphQLProvider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAA;AAElD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAEzC,OAAO,EAAsB,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAOtE,MAAM,OAAO,eAAgB,SAAQ,QAAQ;IAC3C,OAAO,CAAgB;IAEvB,YAAY,GAAe,EAAE,UAAkC,EAAE;QAC/D,KAAK,CAAC,GAAG,CAAC,CAAA;QACV,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,MAAM,CAAA;IAC/B,CAAC;IAED,qEAAqE;IACrE,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,OAAO,CAAA;IACrB,CAAC;IAEQ,QAAQ;QACf,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAgB,SAAS,CAAC,CAAA;QAC5D,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAA;QAC3F,IAAI,CAAC,MAAM;YAAE,OAAM,CAAC,oCAAoC;QACxD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,CAAA;QACpC,IAAI,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;YAC7B,IAAI,SAAS,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,MAAM,EAAE,CAAC;gBAC5C,IAAI,CAAC,OAAO,GAAG,MAAM,CAAA;gBACrB,OAAM,CAAC,4BAA4B;YACrC,CAAC;YACD,MAAM,IAAI,SAAS,CACjB,qCAAqC,EACrC,oEAAoE,EACpE;gBACE,IAAI,EAAE,0GAA0G;aACjH,CACF,CAAA;QACH,CAAC;QACD,MAAM,CAAC,YAAY,CAAC,SAAS,CAAC,CAAA;QAC9B,IAAI,CAAC,OAAO,GAAG,MAAM,CAAA;QACrB,SAAS,CAAC,SAAS,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,CAAA;IAC9C,CAAC;IAEQ,KAAK,CAAC,IAAI;QACjB,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAA;QAC3B,IAAI,CAAC,MAAM;YAAE,OAAM;QACnB,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAS,QAAQ,CAAC,CAAA;QACxD,2EAA2E;QAC3E,kDAAkD;QAClD,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAA;QACpD,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAA;IACvD,CAAC;CACF;AAED,2KAA2K;AAC3K,eAAe,eAAe,CAAA"}
+{"version":3,"file":"GraphQLProvider.js","sourceRoot":"","sources":["../../src/graphql/GraphQLProvider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAA;AAElD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAEzC,OAAO,EAAsB,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAOtE,MAAM,OAAO,eAAgB,SAAQ,QAAQ;IAC3C,OAAO,CAAgB;IACvB,WAAW,GAAG,KAAK,CAAA;IAEnB,YAAY,GAAe,EAAE,UAAkC,EAAE;QAC/D,KAAK,CAAC,GAAG,CAAC,CAAA;QACV,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,MAAM,CAAA;IAC/B,CAAC;IAED,qEAAqE;IACrE,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,OAAO,CAAA;IACrB,CAAC;IAEQ,QAAQ;QACf,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAgB,SAAS,CAAC,CAAA;QAC5D,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAA;QAC3F,IAAI,CAAC,MAAM;YAAE,OAAM,CAAC,oCAAoC;QACxD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,CAAA;QACpC,IAAI,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;YAC7B,0DAA0D;YAC1D,kEAAkE;YAClE,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;gBACrB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAA;gBACrB,OAAM;YACR,CAAC;YACD,MAAM,IAAI,SAAS,CACjB,qCAAqC,EACrC,oEAAoE,EACpE;gBACE,IAAI,EAAE,0GAA0G;aACjH,CACF,CAAA;QACH,CAAC;QACD,MAAM,CAAC,YAAY,CAAC,SAAS,CAAC,CAAA;QAC9B,IAAI,CAAC,OAAO,GAAG,MAAM,CAAA;QACrB,SAAS,CAAC,SAAS,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,CAAA;QAC5C,IAAI,CAAC,WAAW,GAAG,IAAI,CAAA;IACzB,CAAC;IAEQ,KAAK,CAAC,IAAI;QACjB,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAA;QAC3B,IAAI,CAAC,MAAM;YAAE,OAAM;QACnB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAS,QAAQ,CAAC,CAAA;QAC9D,2EAA2E;QAC3E,kDAAkD;QAClD,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAA;QACpD,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAA;IACvD,CAAC;CACF;AAED,2KAA2K;AAC3K,eAAe,eAAe,CAAA"}

package/dist/http/Exception.d.ts

@@ -5,6 +5,7 @@
  * - ExceptionHandler: global exception handler with content negotiation
  * - Built-in E_* exceptions
  */
+import { Macroable } from '../utils/Macroable.js';
 import type { HttpContext } from './HttpContext.js';
 /**
  * Base exception class. Extend this to create self-handling exceptions.
@@ -27,8 +28,12 @@ import type { HttpContext } from './HttpContext.js';
 export declare class Exception extends Error {
     static status: number;
     static code: string;
+    /** Optional static remediation hint, copied onto instances (AdonisJS `Exception.help`). */
+    static help?: string;
     status: number;
     code: string;
+    /** Human-readable remediation hint surfaced in debug output (AdonisJS `error.help`). */
+    help?: string;
     constructor(message: string, options?: {
         status?: number;
         code?: string;
@@ -38,6 +43,30 @@ export declare class Exception extends Error {
     /** Override to report the exception (logging, monitoring). Never send HTTP from here. */
     report?(error: this, ctx: HttpContext): Promise<void> | void;
 }
+/** A concrete Exception subclass produced by {@link createError}. */
+export interface ExceptionConstructor {
+    new (...args: unknown[]): Exception;
+    status: number;
+    code: string;
+}
+/**
+ * Build a reusable Exception subclass in one line (AdonisJS `createError`).
+ * `message` may contain `util.format` placeholders (`%s`, `%d`) filled by the
+ * constructor args:
+ *
+ *   const E_RESOURCE_MISSING = createError('Resource %s not found', 'E_RESOURCE_MISSING', 404)
+ *   throw new E_RESOURCE_MISSING('user-42')   // → "Resource user-42 not found"
+ */
+export declare function createError(message: string, code: string, status?: number): ExceptionConstructor;
+/** A generic 500 runtime error (AdonisJS `RuntimeException`). */
+export declare class RuntimeException extends Exception {
+    static status: number;
+    static code: string;
+}
+/** Raised when a function receives invalid arguments (AdonisJS `InvalidArgumentsException`). */
+export declare class InvalidArgumentsException extends RuntimeException {
+    static code: string;
+}
 export declare class E_ROUTE_NOT_FOUND extends Exception {
     static status: number;
     static code: string;
@@ -72,6 +101,18 @@ export declare class E_ROW_NOT_FOUND extends Exception {
 export declare class E_HTTP_EXCEPTION extends Exception {
     constructor(message: string, status: number);
 }
+/**
+ * Thrown by `response.abort()` / `response.abortIf()` (AdonisJS parity). Carries
+ * an arbitrary body that {@link handle} renders as-is — a string verbatim,
+ * anything else as JSON.
+ */
+export declare class E_HTTP_REQUEST_ABORTED extends Exception {
+    static status: number;
+    static code: string;
+    readonly body: unknown;
+    constructor(body: unknown, status?: number);
+    handle(_error: this, ctx: HttpContext): void;
+}
 /**
  * Global exception handler — catches all unhandled exceptions and converts
  * them to HTTP responses.
@@ -87,12 +128,32 @@ export declare class E_HTTP_EXCEPTION extends Exception {
  * 2. Else → this.handle() → content negotiation (JSON or HTML)
  * 3. Then → this.report() → logging/monitoring
  */
-export declare class ExceptionHandler {
+/** Renders an HTML error page for a status (AdonisJS `StatusPageRenderer`). */
+export type StatusPageRenderer = (error: unknown, ctx: HttpContext) => Promise<string> | string;
+/** A constructor usable in `instanceof` for {@link ExceptionHandler.ignoreExceptions}. */
+export type ExceptionClass = new (...args: never[]) => Error;
+/** Reporting log level, keyed to `console` (AdonisJS levels: error/warn/info). */
+type LogLevel = 'error' | 'warn' | 'info';
+export declare class ExceptionHandler extends Macroable {
     #private;
     protected debug: boolean;
+    /** Render `statusPages` (browser HTML). Defaults to production only (AdonisJS). */
+    protected renderStatusPages: boolean;
+    /** Status → HTML renderer, keys may be single codes or `'500..599'` ranges. */
+    protected statusPages: Record<string, StatusPageRenderer>;
+    /** Master reporting switch (AdonisJS `reportErrors`). */
+    protected reportErrors: boolean;
     protected ignoreStatuses: number[];
     protected ignoreCodes: string[];
+    /** Exception classes never reported (AdonisJS `ignoreExceptions`). */
+    protected ignoreExceptions: ExceptionClass[];
     constructor(debug?: boolean);
+    /** Whether debug detail is exposed for this request (AdonisJS — override per-ctx). */
+    protected isDebuggingEnabled(_ctx: HttpContext): boolean;
+    /** Log level for an error by status: 5xx→error, 4xx→warn, else info (AdonisJS). */
+    protected getErrorLogLevel(status: number): LogLevel;
+    /** Whether an error should be reported — honours every ignore list (AdonisJS `shouldReport`). */
+    protected shouldReport(error: unknown): boolean;
     /** Convert an exception to an HTTP response. */
     handle(error: unknown, ctx: HttpContext): Promise<void>;
     /** Log/report an exception. Override for custom monitoring. */
@@ -100,4 +161,5 @@ export declare class ExceptionHandler {
     /** Provide additional context for error reports. Override for custom data. */
     protected context(ctx: HttpContext): Record<string, unknown>;
 }
+export {};
 //# sourceMappingURL=Exception.d.ts.map

package/dist/http/Exception.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Exception.d.ts","sourceRoot":"","sources":["../../src/http/Exception.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAEnD;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,SAAU,SAAQ,KAAK;IAClC,MAAM,CAAC,MAAM,SAAM;IACnB,MAAM,CAAC,IAAI,SAAc;IAEzB,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;gBAEA,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE;IASzE,wEAAwE;IACxE,MAAM,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAE5D,yFAAyF;IACzF,MAAM,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;CAC7D;AAID,qBAAa,iBAAkB,SAAQ,SAAS;IAC9C,OAAgB,MAAM,SAAM;IAC5B,OAAgB,IAAI,SAAsB;gBAE9B,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;CAGzC;AAED,qBAAa,cAAe,SAAQ,SAAS;IAC3C,OAAgB,MAAM,SAAM;IAC5B,OAAgB,IAAI,SAAmB;gBAE3B,OAAO,SAA4B;IAItC,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,WAAW,GAAG,IAAI;CAGtD;AAED,qBAAa,WAAY,SAAQ,SAAS;IACxC,OAAgB,MAAM,SAAM;IAC5B,OAAgB,IAAI,SAAgB;IAEpC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;gBAEP,OAAO,SAA6B,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE;IAK5D,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,WAAW,GAAG,IAAI;CAStD;AAED,qBAAa,kBAAmB,SAAQ,SAAS;IAC/C,OAAgB,MAAM,SAAM;IAC5B,OAAgB,IAAI,SAAuB;IAE3C,MAAM,EAAE,OAAO,EAAE,CAAA;gBAEL,MAAM,EAAE,OAAO,EAAE;IAKpB,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,WAAW,GAAG,IAAI;CAGtD;AAED,qBAAa,eAAgB,SAAQ,SAAS;IAC5C,OAAgB,MAAM,SAAM;IAC5B,OAAgB,IAAI,SAAoB;gBAE5B,KAAK,CAAC,EAAE,MAAM;IAOjB,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,WAAW,GAAG,IAAI;CAGtD;AAED,qBAAa,gBAAiB,SAAQ,SAAS;gBACjC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAG5C;AAID;;;;;;;;;;;;;;GAcG;AACH,qBAAa,gBAAgB;;IAC3B,SAAS,CAAC,KAAK,EAAE,OAAO,CAAA;IACxB,SAAS,CAAC,cAAc,EAAE,MAAM,EAAE,CAAuB;IACzD,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,CAAK;gBAExB,KAAK,UAAQ;IAIzB,gDAAgD;IAC1C,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IA+C7D,+DAA+D;IACzD,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAqB7D,8EAA8E;IAC9E,SAAS,CAAC,OAAO,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAQ7D"}
+{"version":3,"file":"Exception.d.ts","sourceRoot":"","sources":["../../src/http/Exception.ts"],"names":[],"mappings":"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"}

package/dist/http/Exception.js

@@ -5,6 +5,8 @@
  * - ExceptionHandler: global exception handler with content negotiation
  * - Built-in E_* exceptions
  */
+import { format } from 'node:util';
+import { Macroable } from '../utils/Macroable.js';
 /**
  * Base exception class. Extend this to create self-handling exceptions.
  *
@@ -26,8 +28,12 @@
 export class Exception extends Error {
     static status = 500;
     static code = 'E_UNKNOWN';
+    /** Optional static remediation hint, copied onto instances (AdonisJS `Exception.help`). */
+    static help;
     status;
     code;
+    /** Human-readable remediation hint surfaced in debug output (AdonisJS `error.help`). */
+    help;
     constructor(message, options) {
         super(message);
         this.name = this.constructor.name;
@@ -35,8 +41,36 @@ export class Exception extends Error {
         const ctor = this.constructor;
         this.status = options?.status ?? ctor.status;
         this.code = options?.code ?? ctor.code;
+        if (ctor.help !== undefined)
+            this.help = ctor.help;
     }
 }
+/**
+ * Build a reusable Exception subclass in one line (AdonisJS `createError`).
+ * `message` may contain `util.format` placeholders (`%s`, `%d`) filled by the
+ * constructor args:
+ *
+ *   const E_RESOURCE_MISSING = createError('Resource %s not found', 'E_RESOURCE_MISSING', 404)
+ *   throw new E_RESOURCE_MISSING('user-42')   // → "Resource user-42 not found"
+ */
+export function createError(message, code, status = 500) {
+    return class extends Exception {
+        static status = status;
+        static code = code;
+        constructor(...args) {
+            super(format(message, ...args), { status, code });
+        }
+    };
+}
+/** A generic 500 runtime error (AdonisJS `RuntimeException`). */
+export class RuntimeException extends Exception {
+    static status = 500;
+    static code = 'E_RUNTIME_EXCEPTION';
+}
+/** Raised when a function receives invalid arguments (AdonisJS `InvalidArgumentsException`). */
+export class InvalidArgumentsException extends RuntimeException {
+    static code = 'E_INVALID_ARGUMENTS';
+}
 // ─── Built-in exceptions ──────────────────────────────────
 export class E_ROUTE_NOT_FOUND extends Exception {
     static status = 404;
@@ -103,61 +137,144 @@ export class E_HTTP_EXCEPTION extends Exception {
         super(message, { status, code: 'E_HTTP_EXCEPTION' });
     }
 }
-// ─── ExceptionHandler ─────────────────────────────────────
 /**
- * Global exception handler — catches all unhandled exceptions and converts
- * them to HTTP responses.
- *
- * Extend this in your app:
- *   export default class Handler extends ExceptionHandler {
- *     protected debug = app.inDev
- *     protected ignoreStatuses = [400, 401, 404, 422]
- *   }
- *
- * Flow:
- * 1. If exception has handle() → self-handled (bypass global)
- * 2. Else → this.handle() → content negotiation (JSON or HTML)
- * 3. Then → this.report() → logging/monitoring
+ * Thrown by `response.abort()` / `response.abortIf()` (AdonisJS parity). Carries
+ * an arbitrary body that {@link handle} renders as-is — a string verbatim,
+ * anything else as JSON.
  */
-export class ExceptionHandler {
+export class E_HTTP_REQUEST_ABORTED extends Exception {
+    static status = 400;
+    static code = 'E_HTTP_REQUEST_ABORTED';
+    body;
+    constructor(body, status = 400) {
+        super(typeof body === 'string' ? body : 'Request aborted', {
+            status,
+            code: 'E_HTTP_REQUEST_ABORTED',
+        });
+        this.body = body;
+    }
+    handle(_error, ctx) {
+        if (typeof this.body === 'string') {
+            ctx.response.status(this.status).send(this.body);
+        }
+        else {
+            ctx.response.status(this.status).json(this.body);
+        }
+    }
+}
+export class ExceptionHandler extends Macroable {
     debug;
+    /** Render `statusPages` (browser HTML). Defaults to production only (AdonisJS). */
+    renderStatusPages = process.env.NODE_ENV === 'production';
+    /** Status → HTML renderer, keys may be single codes or `'500..599'` ranges. */
+    statusPages = {};
+    /** Master reporting switch (AdonisJS `reportErrors`). */
+    reportErrors = true;
     ignoreStatuses = [400, 401, 404, 422];
     ignoreCodes = [];
+    /** Exception classes never reported (AdonisJS `ignoreExceptions`). */
+    ignoreExceptions = [];
+    #expandedStatusPages;
     constructor(debug = false) {
+        super();
         this.debug = debug;
     }
+    /** Whether debug detail is exposed for this request (AdonisJS — override per-ctx). */
+    isDebuggingEnabled(_ctx) {
+        return this.debug;
+    }
+    /** Log level for an error by status: 5xx→error, 4xx→warn, else info (AdonisJS). */
+    getErrorLogLevel(status) {
+        if (status >= 500)
+            return 'error';
+        if (status >= 400)
+            return 'warn';
+        return 'info';
+    }
+    /** Whether an error should be reported — honours every ignore list (AdonisJS `shouldReport`). */
+    shouldReport(error) {
+        if (!this.reportErrors)
+            return false;
+        const { status, code } = extractErrorMeta(error);
+        if (this.ignoreStatuses.includes(status))
+            return false;
+        if (this.ignoreCodes.includes(code))
+            return false;
+        if (this.ignoreExceptions.some((exception) => error instanceof exception))
+            return false;
+        return true;
+    }
+    /** Expand `statusPages` range keys (`'500..599'`) into a per-code lookup (cached). */
+    #expandStatusPages() {
+        if (!this.#expandedStatusPages) {
+            const expanded = {};
+            for (const range of Object.keys(this.statusPages)) {
+                Object.assign(expanded, parseStatusRange(range, this.statusPages[range]));
+            }
+            this.#expandedStatusPages = expanded;
+        }
+        return this.#expandedStatusPages;
+    }
     /** Convert an exception to an HTTP response. */
     async handle(error, ctx) {
-        // Self-handled exceptions take over entirely.
-        if (error instanceof Exception && typeof error.handle === 'function') {
+        // Self-handled errors take over entirely (duck-typed, per AdonisJS — any
+        // thrown value exposing a `handle()` method, not just `Exception` instances).
+        if (isSelfHandling(error)) {
             await error.handle(error, ctx);
             return;
         }
-        const { status, code } = extractErrorMeta(error);
-        const message = this.#errorMessage(error);
-        if (wantsJson(ctx)) {
-            this.#sendJsonError(ctx, status, code, message, error);
-        }
-        else {
-            this.#sendHtmlError(ctx, status, message);
+        // Negotiation. DEVIATION (named): ream lists `json` FIRST, so a request
+        // with no/`*/*` Accept defaults to JSON (API-first). AdonisJS lists `html`
+        // first (full-stack default). Explicit `text/html` / `vnd.api+json` are
+        // honoured identically.
+        switch (ctx.request.accepts(['json', 'html', 'application/vnd.api+json'])) {
+            case 'application/vnd.api+json':
+                this.#sendJsonApiError(error, ctx);
+                return;
+            case 'html':
+                await this.#sendHtmlError(error, ctx);
+                return;
+            default:
+                this.#sendJsonError(error, ctx);
         }
     }
     /** Pick the user-facing message — full detail only in debug mode. */
-    #errorMessage(error) {
-        if (this.debug && error instanceof Error)
+    #errorMessage(error, ctx) {
+        if (this.isDebuggingEnabled(ctx) && error instanceof Error)
             return error.message;
         if (error instanceof Exception)
             return error.message;
         return 'An internal error occurred';
     }
-    #sendJsonError(ctx, status, code, message, error) {
-        const errorPayload = { code, message };
-        if (this.debug && error instanceof Error && error.stack) {
-            errorPayload.stack = error.stack;
+    #sendJsonError(error, ctx) {
+        const { status, code } = extractErrorMeta(error);
+        const payload = { code, message: this.#errorMessage(error, ctx) };
+        if (error instanceof Exception && error.help)
+            payload.help = error.help;
+        if (this.isDebuggingEnabled(ctx) && error instanceof Error && error.stack) {
+            payload.stack = error.stack;
         }
-        ctx.response.status(status).json({ error: errorPayload });
+        ctx.response.status(status).json({ error: payload });
     }
-    #sendHtmlError(ctx, status, message) {
+    #sendJsonApiError(error, ctx) {
+        const { status, code } = extractErrorMeta(error);
+        ctx.response
+            .status(status)
+            .type('application/vnd.api+json')
+            .json({ errors: [{ title: this.#errorMessage(error, ctx), code, status: String(status) }] });
+    }
+    async #sendHtmlError(error, ctx) {
+        const { status } = extractErrorMeta(error);
+        // A registered status page wins (production browser error pages).
+        if (this.renderStatusPages) {
+            const renderer = this.#expandStatusPages()[status];
+            if (renderer) {
+                const html = await renderer(error, ctx);
+                ctx.response.status(status).type('text/html; charset=utf-8').send(html);
+                return;
+            }
+        }
+        const message = this.#errorMessage(error, ctx);
         ctx.response
             .status(status)
             .type('text/html; charset=utf-8')
@@ -166,24 +283,22 @@ export class ExceptionHandler {
     }
     /** Log/report an exception. Override for custom monitoring. */
     async report(error, ctx) {
-        if (error instanceof Exception) {
-            if (this.ignoreStatuses.includes(error.status))
-                return;
-            if (this.ignoreCodes.includes(error.code))
-                return;
-        }
-        // Self-reported exceptions
-        if (error instanceof Exception && typeof error.report === 'function') {
+        if (!this.shouldReport(error))
+            return;
+        // Self-reported exceptions handle their own reporting.
+        if (isSelfReporting(error)) {
             await error.report(error, ctx);
             return;
         }
-        // Default: log to stderr
+        // Default: log at the status-appropriate level.
+        const { status } = extractErrorMeta(error);
+        const level = this.getErrorLogLevel(status);
         const context = this.context(ctx);
         if (error instanceof Error) {
-            console.error(`[${new Date().toISOString()}] ${error.message}`, context, error.stack);
+            console[level](`[${new Date().toISOString()}] ${error.message}`, context, error.stack);
         }
         else {
-            console.error(`[${new Date().toISOString()}] Unknown error:`, error, context);
+            console[level](`[${new Date().toISOString()}] Unknown error:`, error, context);
         }
     }
     /** Provide additional context for error reports. Override for custom data. */
@@ -212,11 +327,33 @@ function extractErrorMeta(error) {
     }
     return { status, code };
 }
-/** Content negotiation: JSON unless the client explicitly prefers HTML. */
-function wantsJson(ctx) {
-    return (ctx.request.accepts(['json', 'html']) === 'json' ||
-        (ctx.request.header('accept')?.includes('application/json') ?? false) ||
-        !ctx.request.header('accept')?.includes('text/html'));
+/** True when a thrown value self-handles via a `handle()` method (AdonisJS duck-type). */
+function isSelfHandling(error) {
+    return (error !== null &&
+        typeof error === 'object' &&
+        'handle' in error &&
+        typeof error.handle === 'function');
+}
+/** True when a thrown value self-reports via a `report()` method. */
+function isSelfReporting(error) {
+    return (error !== null &&
+        typeof error === 'object' &&
+        'report' in error &&
+        typeof error.report === 'function');
+}
+/** Expand a status-page key into a per-code map: `'500..599'` → {500,…,599}, `'404'` → {404}. */
+function parseStatusRange(range, renderer) {
+    const parts = range.split('..');
+    const min = Number(parts[0]);
+    const max = Number(parts[1]);
+    if (parts.length === 1 && !Number.isNaN(min))
+        return { [min]: renderer };
+    if (Number.isNaN(min) || Number.isNaN(max))
+        return {};
+    const result = {};
+    for (let status = min; status <= max; status += 1)
+        result[status] = renderer;
+    return result;
 }
 function escapeHtml(str) {
     return str

package/dist/http/Exception.js.map

@@ -1 +1 @@
-{"version":3,"file":"Exception.js","sourceRoot":"","sources":["../../src/http/Exception.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Exception.js","sourceRoot":"","sources":["../../src/http/Exception.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAA;AAClC,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AAGjD;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,OAAO,SAAU,SAAQ,KAAK;IAClC,MAAM,CAAC,MAAM,GAAG,GAAG,CAAA;IACnB,MAAM,CAAC,IAAI,GAAG,WAAW,CAAA;IACzB,2FAA2F;IAC3F,MAAM,CAAC,IAAI,CAAS;IAEpB,MAAM,CAAQ;IACd,IAAI,CAAQ;IACZ,wFAAwF;IACxF,IAAI,CAAS;IAEb,YAAY,OAAe,EAAE,OAA4C;QACvE,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAA;QACjC,wHAAwH;QACxH,MAAM,IAAI,GAAG,IAAI,CAAC,WAAsC,CAAA;QACxD,IAAI,CAAC,MAAM,GAAG,OAAO,EAAE,MAAM,IAAI,IAAI,CAAC,MAAM,CAAA;QAC5C,IAAI,CAAC,IAAI,GAAG,OAAO,EAAE,IAAI,IAAI,IAAI,CAAC,IAAI,CAAA;QACtC,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS;YAAE,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAA;IACpD,CAAC;;AAgBH;;;;;;;GAOG;AACH,MAAM,UAAU,WAAW,CAAC,OAAe,EAAE,IAAY,EAAE,MAAM,GAAG,GAAG;IACrE,OAAO,KAAM,SAAQ,SAAS;QAC5B,MAAM,CAAU,MAAM,GAAG,MAAM,CAAA;QAC/B,MAAM,CAAU,IAAI,GAAG,IAAI,CAAA;QAC3B,YAAY,GAAG,IAAe;YAC5B,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAA;QACnD,CAAC;KACF,CAAA;AACH,CAAC;AAED,iEAAiE;AACjE,MAAM,OAAO,gBAAiB,SAAQ,SAAS;IAC7C,MAAM,CAAU,MAAM,GAAG,GAAG,CAAA;IAC5B,MAAM,CAAU,IAAI,GAAG,qBAAqB,CAAA;;AAG9C,gGAAgG;AAChG,MAAM,OAAO,yBAA0B,SAAQ,gBAAgB;IAC7D,MAAM,CAAU,IAAI,GAAG,qBAAqB,CAAA;;AAG9C,6DAA6D;AAE7D,MAAM,OAAO,iBAAkB,SAAQ,SAAS;IAC9C,MAAM,CAAU,MAAM,GAAG,GAAG,CAAA;IAC5B,MAAM,CAAU,IAAI,GAAG,mBAAmB,CAAA;IAE1C,YAAY,MAAc,EAAE,IAAY;QACtC,KAAK,CAAC,oBAAoB,MAAM,IAAI,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,mBAAmB,EAAE,CAAC,CAAA;IACzF,CAAC;;AAGH,MAAM,OAAO,cAAe,SAAQ,SAAS;IAC3C,MAAM,CAAU,MAAM,GAAG,GAAG,CAAA;IAC5B,MAAM,CAAU,IAAI,GAAG,gBAAgB,CAAA;IAEvC,YAAY,OAAO,GAAG,yBAAyB;QAC7C,KAAK,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,gBAAgB,EAAE,CAAC,CAAA;IACzD,CAAC;IAEQ,MAAM,CAAC,MAAY,EAAE,GAAgB;QAC5C,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC,CAAA;IAC7F,CAAC;;AAGH,MAAM,OAAO,WAAY,SAAQ,SAAS;IACxC,MAAM,CAAU,MAAM,GAAG,GAAG,CAAA;IAC5B,MAAM,CAAU,IAAI,GAAG,aAAa,CAAA;IAEpC,QAAQ,CAAW;IAEnB,YAAY,OAAO,GAAG,0BAA0B,EAAE,QAAmB;QACnE,KAAK,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC,CAAA;QACpD,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAA;IAC1B,CAAC;IAEQ,MAAM,CAAC,MAAY,EAAE,GAAgB;QAC5C,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;YAC5B,KAAK,EAAE;gBACL,IAAI,EAAE,aAAa;gBACnB,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACtD;SACF,CAAC,CAAA;IACJ,CAAC;;AAGH,MAAM,OAAO,kBAAmB,SAAQ,SAAS;IAC/C,MAAM,CAAU,MAAM,GAAG,GAAG,CAAA;IAC5B,MAAM,CAAU,IAAI,GAAG,oBAAoB,CAAA;IAE3C,MAAM,CAAW;IAEjB,YAAY,MAAiB;QAC3B,KAAK,CAAC,mBAAmB,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,oBAAoB,EAAE,CAAC,CAAA;QACvE,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;IACtB,CAAC;IAEQ,MAAM,CAAC,MAAY,EAAE,GAAgB;QAC5C,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAA;IACxD,CAAC;;AAGH,MAAM,OAAO,eAAgB,SAAQ,SAAS;IAC5C,MAAM,CAAU,MAAM,GAAG,GAAG,CAAA;IAC5B,MAAM,CAAU,IAAI,GAAG,iBAAiB,CAAA;IAExC,YAAY,KAAc;QACxB,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,YAAY,CAAC,CAAC,CAAC,oBAAoB,EAAE;YACzD,MAAM,EAAE,GAAG;YACX,IAAI,EAAE,iBAAiB;SACxB,CAAC,CAAA;IACJ,CAAC;IAEQ,MAAM,CAAC,MAAY,EAAE,GAAgB;QAC5C,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,iBAAiB,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC,CAAA;IAC9F,CAAC;;AAGH,MAAM,OAAO,gBAAiB,SAAQ,SAAS;IAC7C,YAAY,OAAe,EAAE,MAAc;QACzC,KAAK,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,EAAE,CAAC,CAAA;IACtD,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,OAAO,sBAAuB,SAAQ,SAAS;IACnD,MAAM,CAAU,MAAM,GAAG,GAAG,CAAA;IAC5B,MAAM,CAAU,IAAI,GAAG,wBAAwB,CAAA;IAEtC,IAAI,CAAS;IAEtB,YAAY,IAAa,EAAE,MAAM,GAAG,GAAG;QACrC,KAAK,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,iBAAiB,EAAE;YACzD,MAAM;YACN,IAAI,EAAE,wBAAwB;SAC/B,CAAC,CAAA;QACF,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;IAClB,CAAC;IAEQ,MAAM,CAAC,MAAY,EAAE,GAAgB;QAC5C,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAClC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAClD,CAAC;aAAM,CAAC;YACN,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAClD,CAAC;IACH,CAAC;;AA6BH,MAAM,OAAO,gBAAiB,SAAQ,SAAS;IACnC,KAAK,CAAS;IACxB,mFAAmF;IACzE,iBAAiB,GAAY,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,CAAA;IAC5E,+EAA+E;IACrE,WAAW,GAAuC,EAAE,CAAA;IAC9D,yDAAyD;IAC/C,YAAY,GAAG,IAAI,CAAA;IACnB,cAAc,GAAa,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAA;IAC/C,WAAW,GAAa,EAAE,CAAA;IACpC,sEAAsE;IAC5D,gBAAgB,GAAqB,EAAE,CAAA;IAEjD,oBAAoB,CAAqC;IAEzD,YAAY,KAAK,GAAG,KAAK;QACvB,KAAK,EAAE,CAAA;QACP,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;IACpB,CAAC;IAED,sFAAsF;IAC5E,kBAAkB,CAAC,IAAiB;QAC5C,OAAO,IAAI,CAAC,KAAK,CAAA;IACnB,CAAC;IAED,mFAAmF;IACzE,gBAAgB,CAAC,MAAc;QACvC,IAAI,MAAM,IAAI,GAAG;YAAE,OAAO,OAAO,CAAA;QACjC,IAAI,MAAM,IAAI,GAAG;YAAE,OAAO,MAAM,CAAA;QAChC,OAAO,MAAM,CAAA;IACf,CAAC;IAED,iGAAiG;IACvF,YAAY,CAAC,KAAc;QACnC,IAAI,CAAC,IAAI,CAAC,YAAY;YAAE,OAAO,KAAK,CAAA;QACpC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAA;QAChD,IAAI,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,MAAM,CAAC;YAAE,OAAO,KAAK,CAAA;QACtD,IAAI,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC;YAAE,OAAO,KAAK,CAAA;QACjD,IAAI,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,KAAK,YAAY,SAAS,CAAC;YAAE,OAAO,KAAK,CAAA;QACvF,OAAO,IAAI,CAAA;IACb,CAAC;IAED,sFAAsF;IACtF,kBAAkB;QAChB,IAAI,CAAC,IAAI,CAAC,oBAAoB,EAAE,CAAC;YAC/B,MAAM,QAAQ,GAAuC,EAAE,CAAA;YACvD,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;gBAClD,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,gBAAgB,CAAC,KAAK,EAAE,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;YAC3E,CAAC;YACD,IAAI,CAAC,oBAAoB,GAAG,QAAQ,CAAA;QACtC,CAAC;QACD,OAAO,IAAI,CAAC,oBAAoB,CAAA;IAClC,CAAC;IAED,gDAAgD;IAChD,KAAK,CAAC,MAAM,CAAC,KAAc,EAAE,GAAgB;QAC3C,yEAAyE;QACzE,8EAA8E;QAC9E,IAAI,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1B,MAAM,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,CAAA;YAC9B,OAAM;QACR,CAAC;QAED,wEAAwE;QACxE,2EAA2E;QAC3E,wEAAwE;QACxE,wBAAwB;QACxB,QAAQ,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,0BAA0B,CAAC,CAAC,EAAE,CAAC;YAC1E,KAAK,0BAA0B;gBAC7B,IAAI,CAAC,iBAAiB,CAAC,KAAK,EAAE,GAAG,CAAC,CAAA;gBAClC,OAAM;YACR,KAAK,MAAM;gBACT,MAAM,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,GAAG,CAAC,CAAA;gBACrC,OAAM;YACR;gBACE,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,GAAG,CAAC,CAAA;QACnC,CAAC;IACH,CAAC;IAED,qEAAqE;IACrE,aAAa,CAAC,KAAc,EAAE,GAAgB;QAC5C,IAAI,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,IAAI,KAAK,YAAY,KAAK;YAAE,OAAO,KAAK,CAAC,OAAO,CAAA;QAChF,IAAI,KAAK,YAAY,SAAS;YAAE,OAAO,KAAK,CAAC,OAAO,CAAA;QACpD,OAAO,4BAA4B,CAAA;IACrC,CAAC;IAED,cAAc,CAAC,KAAc,EAAE,GAAgB;QAC7C,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAA;QAChD,MAAM,OAAO,GAA4B,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,CAAA;QAC1F,IAAI,KAAK,YAAY,SAAS,IAAI,KAAK,CAAC,IAAI;YAAE,OAAO,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAA;QACvE,IAAI,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;YAC1E,OAAO,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAA;QAC7B,CAAC;QACD,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAA;IACtD,CAAC;IAED,iBAAiB,CAAC,KAAc,EAAE,GAAgB;QAChD,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAA;QAChD,GAAG,CAAC,QAAQ;aACT,MAAM,CAAC,MAAM,CAAC;aACd,IAAI,CAAC,0BAA0B,CAAC;aAChC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,CAAA;IAChG,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,KAAc,EAAE,GAAgB;QACnD,MAAM,EAAE,MAAM,EAAE,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAA;QAC1C,kEAAkE;QAClE,IAAI,IAAI,CAAC,iBAAiB,EAAE,CAAC;YAC3B,MAAM,QAAQ,GAAG,IAAI,CAAC,kBAAkB,EAAE,CAAC,MAAM,CAAC,CAAA;YAClD,IAAI,QAAQ,EAAE,CAAC;gBACb,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,CAAA;gBACvC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;gBACvE,OAAM;YACR,CAAC;QACH,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,GAAG,CAAC,CAAA;QAC9C,GAAG,CAAC,QAAQ;aACT,MAAM,CAAC,MAAM,CAAC;aACd,IAAI,CAAC,0BAA0B,CAAC;aAChC,IAAI,CACH,2CAA2C,MAAM,iBAAiB;YAChE,aAAa,MAAM,WAAW,UAAU,CAAC,OAAO,CAAC,oBAAoB,CACxE,CAAA;IACL,CAAC;IAED,+DAA+D;IAC/D,KAAK,CAAC,MAAM,CAAC,KAAc,EAAE,GAAgB;QAC3C,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC;YAAE,OAAM;QAErC,uDAAuD;QACvD,IAAI,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3B,MAAM,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,CAAA;YAC9B,OAAM;QACR,CAAC;QAED,gDAAgD;QAChD,MAAM,EAAE,MAAM,EAAE,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAA;QAC1C,MAAM,KAAK,GAAG,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAA;QAC3C,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;QACjC,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;YAC3B,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,KAAK,KAAK,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,CAAA;QACxF,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,kBAAkB,EAAE,KAAK,EAAE,OAAO,CAAC,CAAA;QAChF,CAAC;IACH,CAAC;IAED,8EAA8E;IACpE,OAAO,CAAC,GAAgB;QAChC,OAAO;YACL,SAAS,EAAE,GAAG,CAAC,EAAE;YACjB,MAAM,EAAE,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE;YAC5B,GAAG,EAAE,GAAG,CAAC,OAAO,CAAC,GAAG,EAAE;YACtB,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE;SAC1B,CAAA;IACH,CAAC;CACF;AAED,+EAA+E;AAC/E,SAAS,gBAAgB,CAAC,KAAc;IACtC,IAAI,MAAM,GAAG,GAAG,CAAA;IAChB,IAAI,IAAI,GAAG,WAAW,CAAA;IACtB,IAAI,KAAK,YAAY,SAAS,EAAE,CAAC;QAC/B,MAAM,GAAG,KAAK,CAAC,MAAM,CAAA;QACrB,IAAI,GAAG,KAAK,CAAC,IAAI,CAAA;IACnB,CAAC;SAAM,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvD,IAAI,QAAQ,IAAI,KAAK,IAAI,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ;YAAE,MAAM,GAAG,KAAK,CAAC,MAAM,CAAA;QAChF,IAAI,MAAM,IAAI,KAAK,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ;YAAE,IAAI,GAAG,KAAK,CAAC,IAAI,CAAA;IAC1E,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAA;AACzB,CAAC;AAED,0FAA0F;AAC1F,SAAS,cAAc,CACrB,KAAc;IAEd,OAAO,CACL,KAAK,KAAK,IAAI;QACd,OAAO,KAAK,KAAK,QAAQ;QACzB,QAAQ,IAAI,KAAK;QACjB,OAAO,KAAK,CAAC,MAAM,KAAK,UAAU,CACnC,CAAA;AACH,CAAC;AAED,qEAAqE;AACrE,SAAS,eAAe,CACtB,KAAc;IAEd,OAAO,CACL,KAAK,KAAK,IAAI;QACd,OAAO,KAAK,KAAK,QAAQ;QACzB,QAAQ,IAAI,KAAK;QACjB,OAAO,KAAK,CAAC,MAAM,KAAK,UAAU,CACnC,CAAA;AACH,CAAC;AAED,iGAAiG;AACjG,SAAS,gBAAgB,CACvB,KAAa,EACb,QAA4B;IAE5B,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IAC/B,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;IAC5B,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;IAC5B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,CAAA;IACxE,IAAI,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,CAAA;IACrD,MAAM,MAAM,GAAuC,EAAE,CAAA;IACrD,KAAK,IAAI,MAAM,GAAG,GAAG,EAAE,MAAM,IAAI,GAAG,EAAE,MAAM,IAAI,CAAC;QAAE,MAAM,CAAC,MAAM,CAAC,GAAG,QAAQ,CAAA;IAC5E,OAAO,MAAM,CAAA;AACf,CAAC;AAED,SAAS,UAAU,CAAC,GAAW;IAC7B,OAAO,GAAG;SACP,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC;SACtB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;AAC5B,CAAC"}

package/dist/http/HttpContext.d.ts

@@ -8,13 +8,21 @@
  */
 import type { ServiceToken } from '../container/types.js';
 import type { Emitter } from '../events/Emitter.js';
+import type { CookieSigner } from '../security/CookieSigner.js';
+import type { SignedUrl } from '../security/SignedUrl.js';
+import type { Session } from '../session/Session.js';
+import { Macroable } from '../utils/Macroable.js';
 import type { RouteUrlResolver } from './RedirectBuilder.js';
 import type { RawRequest } from './Request.js';
 import { Request } from './Request.js';
 import { Response } from './Response.js';
-import type { Session } from '../session/Session.js';
 export interface AuthState {
-    authenticated: boolean;
+    /**
+     * Whether the request carries an authenticated user (AdonisJS `auth.isAuthenticated`
+     * parity, renamed from `authenticated`). Always present — Ream defaults it to
+     * `false`; an auth provider (e.g. `@c9up/warden`'s Authenticator) sets it true.
+     */
+    isAuthenticated: boolean;
     user?: {
         id: string;
         email?: string;
@@ -24,6 +32,21 @@ export interface AuthState {
     };
     roles?: string[];
     permissions?: string[];
+    /**
+     * Optional AdonisJS `Authenticator` surface — present when an auth provider
+     * (Warden) fills the slot with a per-request authenticator, absent for the
+     * bare `{ isAuthenticated: false }` default. Methods are OPTIONAL so Ream stays
+     * agnostic: a non-Warden host, or the default state, remains a valid AuthState.
+     */
+    authenticate?(): Promise<void>;
+    check?(): Promise<boolean>;
+    authenticateUsing?(guards?: string[], options?: {
+        loginRoute?: string;
+    }): Promise<void>;
+    getUserOrFail?(): AuthState['user'];
+    use?(name: string): unknown;
+    readonly authenticationAttempted?: boolean;
+    readonly authenticatedViaGuard?: string;
 }
 /**
  * Per-request authorization entry point — populated by an authorization
@@ -54,9 +77,9 @@ export interface Authorizer {
  * exposing it under the Adonis name with `.make()` keeps the public contract
  * aligned so a future scoped resolver is a non-breaking swap.
  */
-export interface ContainerResolver {
-    /** Resolve/construct a service by token (class, string, or symbol). */
-    make<T>(token: ServiceToken): T;
+interface ContainerResolver {
+    /** Resolve/construct a service by token (class, string, or symbol). Async (AdonisJS parity). */
+    make<T>(token: ServiceToken): Promise<T>;
 }
 /**
  * Per-request logger contract (AdonisJS `ctx.logger`). Structural so Ream stays
@@ -71,6 +94,13 @@ export interface ContextLogger {
     error(message: string, data?: Record<string, unknown>): void;
     fatal(message: string, data?: Record<string, unknown>): void;
 }
+/** A logger that can spawn a request-scoped child (e.g. spectrum's `child()`). */
+export interface ChildLoggerSource extends ContextLogger {
+    child?(options: {
+        correlationId?: string;
+        module?: string;
+    }): ContextLogger;
+}
 export interface RouteInfo {
     pattern: string;
     name?: string;
@@ -86,7 +116,7 @@ export interface RouteInfo {
     controller?: object;
     action?: string;
 }
-export declare class HttpContext {
+export declare class HttpContext extends Macroable {
     #private;
     /**
      * @internal Run `fn` with `ctx` as the ambient HttpContext, so code deep in
@@ -99,6 +129,12 @@ export declare class HttpContext {
     static get(): HttpContext | undefined;
     /** The ambient HttpContext, or throw outside a request (AdonisJS `HttpContext.getOrFail()`). */
     static getOrFail(): HttpContext;
+    /**
+     * Run `fn` with the ambient HttpContext temporarily cleared (AdonisJS
+     * `HttpContext.runOutsideContext`) — e.g. to detach background work so it
+     * doesn't inherit and pin the request's context.
+     */
+    static runOutsideContext<T>(fn: () => T): T;
     /** Unique request/correlation ID. */
     readonly id: string;
     /** Typed HTTP request. */
@@ -147,13 +183,24 @@ export declare class HttpContext {
      */
     readonly containerResolver?: ContainerResolver;
     /**
-     * Per-request logger (AdonisJS `ctx.logger`). Resolves the container `'logger'`
-     * (e.g. `@c9up/spectrum`) child-scoped to this request's `id`, or falls back to
-     * a console logger when none is registered. Built once, on first access.
+     * Per-request logger (AdonisJS `ctx.logger`) — the injected app logger (e.g.
+     * `@c9up/spectrum`) child-scoped to this request's `id`, or a console logger
+     * when none is registered. Built once, on first access.
      */
     get logger(): ContextLogger;
+    /** @internal Inject the app base logger (resolved async by HttpKernel). */
+    setBaseLogger(logger: ChildLoggerSource): void;
+    /** @internal Inject the APP_KEY cookie signer into request + response (from HttpKernel). */
+    setCookieSigner(signer: CookieSigner): void;
+    /** @internal Inject the APP_KEY signed-URL helper into the request (from HttpKernel). */
+    setSignedUrl(signedUrl: SignedUrl): void;
+    /** Subdomains of the request host (AdonisJS `ctx.subdomains`). */
+    get subdomains(): string[];
+    /** Stable identifier for the matched route (`METHOD-pattern`) — AdonisJS `ctx.routeKey`. */
+    get routeKey(): string;
     constructor(id: string, rawRequest: RawRequest, params: Record<string, string>, route: RouteInfo, containerResolver?: ContainerResolver);
     /** @internal Set the route URL resolver (injected by HttpKernel from Router). */
     setRouteUrlResolver(resolver: RouteUrlResolver): void;
 }
+export {};
 //# sourceMappingURL=HttpContext.d.ts.map