@c9up/ream 0.1.25 → 0.1.27

package/dist/index.js

@@ -6,17 +6,19 @@
 import 'reflect-metadata';
 // ─── Core ───────────────────────────────────────────────────
 export { Application } from './Application.js';
-export { ConfigStore, defineModuleConfig, env } from './ConfigLoader.js';
+export { ConfigStore, configProvider, defineModuleConfig, env } from './ConfigLoader.js';
 export { Container } from './container/Container.js';
 export { Env, EnvValidationException } from './env/Env.js';
 export { loadEnvFiles } from './env/loadEnvFiles.js';
+export { Secret } from './env/Secret.js';
 export { EnvVarError, } from './env/schema.js';
 // ─── HTTP (new — AdonisJS-compatible) ───────────────────────
-export { E_FORBIDDEN, E_HTTP_EXCEPTION, E_ROUTE_NOT_FOUND, E_ROW_NOT_FOUND, E_UNAUTHORIZED, E_VALIDATION_ERROR, Exception, ExceptionHandler, } from './http/Exception.js';
+export { createError, E_FORBIDDEN, E_HTTP_EXCEPTION, E_ROUTE_NOT_FOUND, E_ROW_NOT_FOUND, E_UNAUTHORIZED, E_VALIDATION_ERROR, Exception, ExceptionHandler, InvalidArgumentsException, RuntimeException, } from './http/Exception.js';
 export { HttpContext } from './http/HttpContext.js';
 export { RedirectBuilder } from './http/RedirectBuilder.js';
 export { Request } from './http/Request.js';
 export { Response } from './http/Response.js';
+export { Macroable } from './utils/Macroable.js';
 // ─── Session ────────────────────────────────────────────────
 export { CookieDriver as SessionCookieDriver } from './session/drivers/CookieDriver.js';
 export { MemoryDriver as SessionMemoryDriver } from './session/drivers/MemoryDriver.js';
@@ -39,13 +41,26 @@ export { CookieSigner } from './security/CookieSigner.js';
 export { constantTimeEq, hasNativeCrypto, hmacSign, hmacVerify, randomBytesBase64, randomHex, setNapi, } from './security/crypto.js';
 export { SignedUrl } from './security/SignedUrl.js';
 // ─── Decorators ─────────────────────────────────────────────
-export { createLazyProxy, getLazyParams, Lazy } from './decorators/Lazy.js';
 export { clearServiceRegistry, getServiceMetadata, getServiceRegistry, Inject, inject, Service, } from './decorators/Service.js';
 export { GroupBuilder, matchers, OnRouteBuilder, RouteBuilder, Router } from './router/Router.js';
 export { compose, MiddlewareRegistry } from './middleware/Pipeline.js';
 export { createHttpKernel } from './HttpKernel.js';
 export { resolveMiddlewareEntry, Server } from './server/Server.js';
-export { CommandRunner } from './console/CommandRunner.js';
+// ─── Ignitor ────────────────────────────────────────────────
+export { BaseCommand } from './console/BaseCommand.js';
+export { Logger, Ui } from './console/cliui.js';
+export { args, flags } from './console/decorators.js';
+// Renamed at the root: Ream already exports an HTTP `ExceptionHandler`, and
+// two different things under one name is worse than a longer one. It keeps its
+// Console name on the console entry point.
+export { ExceptionHandler as ConsoleExceptionHandler } from './console/ExceptionHandler.js';
+export { default as HelpCommand } from './console/HelpCommand.js';
+export { IndexGenerator } from './console/IndexGenerator.js';
+export { Kernel } from './console/Kernel.js';
+export { default as ListCommand } from './console/ListCommand.js';
+export { FsLoader, ListLoader } from './console/loaders.js';
+export { Parser } from './console/parser.js';
+export { Prompt, PromptTrap } from './console/prompts.js';
 export { ConsoleKernel, defineConfig, Ignitor, prettyPrintError } from './Ignitor.js';
 export { Provider } from './Provider.js';
 export { createCodemods } from './Codemods.js';
@@ -53,7 +68,7 @@ export { ErrorBoundary } from './ErrorBoundary.js';
 export { didYouMean, findClosestMatches, levenshtein } from './errors/FuzzyMatcher.js';
 export { AtlasError, ContainerError, EventsError, ForgeError, PipelineError, RouterError, RuneError, WardenError, } from './errors/ModuleErrors.js';
 export { createPipelineError, PIPELINE_STAGES, validatePipelineConfig, } from './errors/PipelineStageError.js';
-export { ReamError } from './errors/ReamError.js';
+export { isReamError, ReamError } from './errors/ReamError.js';
 export { installGracefulShutdown } from './GracefulShutdown.js';
 export { HealthCheck } from './HealthCheck.js';
 export { startHotReload } from './HotReload.js';

package/dist/index.js.map

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

package/dist/middleware/Pipeline.d.ts

@@ -12,18 +12,39 @@
  */
 import type { HttpContext } from '../http/HttpContext.js';
 export type MiddlewareFunction = (ctx: HttpContext, next: () => Promise<void>) => Promise<void> | void;
+/** What a route validator must hand back, whichever method it exposes. */
+export interface RuntimeValidationResult {
+    valid: boolean;
+    errors: unknown[];
+    data?: unknown;
+}
 /**
- * Structural contract for a route validator. A `@c9up/rune` schema matches this
- * shape, so ream stays decoupled from the validation engine — any object with a
- * `validate(data)` returning `{ valid, errors, data? }` works.
+ * Structural contract for a route validator. ream stays decoupled from the
+ * validation engine — any object exposing a result-returning check works.
+ *
+ * Three spellings are accepted because `@c9up/rune` follows VineJS: `validate()`
+ * is async and throws, `validateResult()` is synchronous and never throws, and
+ * `validateResultAsync()` is the async result-based form.
+ *
+ * `validateResultAsync` is preferred. The synchronous `validateResult()` cannot
+ * run async rules — with `unique`, `exists` or `useAsync` in the schema it
+ * throws a plain Error, which would surface as a 500 instead of a 422.
  */
 export interface RuntimeValidator {
-    validate(data: unknown): {
-        valid: boolean;
-        errors: unknown[];
-        data?: unknown;
-    };
+    validate?(data: unknown): RuntimeValidationResult | Promise<unknown>;
+    validateResult?(data: unknown): RuntimeValidationResult;
+    validateResultAsync?(data: unknown): Promise<RuntimeValidationResult>;
 }
+/**
+ * Run a validator whatever contract it exposes, and always come back with a
+ * result object.
+ *
+ * Order matters: the async result form first (it is the only one that can run
+ * `unique` / `exists`), then the synchronous one, then VineJS's throwing
+ * `validate()` — awaited, and with its `E_VALIDATION_ERROR` translated back
+ * into a result so callers keep a single shape to handle.
+ */
+export declare function runValidator(validator: RuntimeValidator, data: unknown): Promise<RuntimeValidationResult>;
 /** Named middleware registry. */
 export declare class MiddlewareRegistry {
     #private;

package/dist/middleware/Pipeline.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Pipeline.d.ts","sourceRoot":"","sources":["../../src/middleware/Pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AAEzD,MAAM,MAAM,kBAAkB,GAAG,CAC/B,GAAG,EAAE,WAAW,EAChB,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,KACtB,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;AAEzB;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,OAAO,EAAE,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,CAAA;CAC/E;AAED,iCAAiC;AACjC,qBAAa,kBAAkB;;IAI7B,4DAA4D;IAC5D,GAAG,CAAC,UAAU,EAAE,kBAAkB,GAAG,IAAI;IAIzC,mCAAmC;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,kBAAkB,GAAG,IAAI;IAI5D,8BAA8B;IAC9B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS;IAIjD,iCAAiC;IACjC,SAAS,IAAI,kBAAkB,EAAE;IAIjC,+CAA+C;IAC/C,UAAU,CACR,eAAe,EAAE,MAAM,EAAE,EACzB,gBAAgB,EAAE,kBAAkB,EAAE,EACtC,OAAO,EAAE,kBAAkB,EAC3B,OAAO,CAAC,EAAE;QACR,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;QACjB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;QAChB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;QACtB,UAAU,CAAC,EAAE,gBAAgB,EAAE,CAAA;KAChC,GACA,kBAAkB;CAoCtB;AAED,gEAAgE;AAChE,iBAAS,OAAO,CAAC,UAAU,EAAE,kBAAkB,EAAE,GAAG,kBAAkB,CAoBrE;AA8DD,OAAO,EAAE,OAAO,EAAE,CAAA"}
+{"version":3,"file":"Pipeline.d.ts","sourceRoot":"","sources":["../../src/middleware/Pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AAEzD,MAAM,MAAM,kBAAkB,GAAG,CAC/B,GAAG,EAAE,WAAW,EAChB,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,KACtB,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;AAEzB,0EAA0E;AAC1E,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,OAAO,CAAA;IACd,MAAM,EAAE,OAAO,EAAE,CAAA;IACjB,IAAI,CAAC,EAAE,OAAO,CAAA;CACf;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,CAAC,IAAI,EAAE,OAAO,GAAG,uBAAuB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IACpE,cAAc,CAAC,CAAC,IAAI,EAAE,OAAO,GAAG,uBAAuB,CAAA;IACvD,mBAAmB,CAAC,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAAA;CACtE;AAiBD;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CAChC,SAAS,EAAE,gBAAgB,EAC3B,IAAI,EAAE,OAAO,GACZ,OAAO,CAAC,uBAAuB,CAAC,CA0BlC;AAED,iCAAiC;AACjC,qBAAa,kBAAkB;;IAI7B,4DAA4D;IAC5D,GAAG,CAAC,UAAU,EAAE,kBAAkB,GAAG,IAAI;IAIzC,mCAAmC;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,kBAAkB,GAAG,IAAI;IAI5D,8BAA8B;IAC9B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS;IAIjD,iCAAiC;IACjC,SAAS,IAAI,kBAAkB,EAAE;IAIjC,+CAA+C;IAC/C,UAAU,CACR,eAAe,EAAE,MAAM,EAAE,EACzB,gBAAgB,EAAE,kBAAkB,EAAE,EACtC,OAAO,EAAE,kBAAkB,EAC3B,OAAO,CAAC,EAAE;QACR,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;QACjB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;QAChB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;QACtB,UAAU,CAAC,EAAE,gBAAgB,EAAE,CAAA;KAChC,GACA,kBAAkB;CAoCtB;AAED,gEAAgE;AAChE,iBAAS,OAAO,CAAC,UAAU,EAAE,kBAAkB,EAAE,GAAG,kBAAkB,CAoBrE;AA8DD,OAAO,EAAE,OAAO,EAAE,CAAA"}

package/dist/middleware/Pipeline.js

@@ -12,6 +12,44 @@
  */
 import { ReamError } from '../errors/ReamError.js';
 import { E_FORBIDDEN, E_UNAUTHORIZED, E_VALIDATION_ERROR } from '../http/Exception.js';
+function isThrownValidationFailure(value) {
+    return (value instanceof Error && 'messages' in value && Array.isArray(Reflect.get(value, 'messages')));
+}
+function isValidationResult(value) {
+    return typeof value === 'object' && value !== null && 'valid' in value;
+}
+/**
+ * Run a validator whatever contract it exposes, and always come back with a
+ * result object.
+ *
+ * Order matters: the async result form first (it is the only one that can run
+ * `unique` / `exists`), then the synchronous one, then VineJS's throwing
+ * `validate()` — awaited, and with its `E_VALIDATION_ERROR` translated back
+ * into a result so callers keep a single shape to handle.
+ */
+export async function runValidator(validator, data) {
+    if (typeof validator.validateResultAsync === 'function') {
+        return validator.validateResultAsync(data);
+    }
+    if (typeof validator.validateResult === 'function') {
+        return validator.validateResult(data);
+    }
+    if (typeof validator.validate === 'function') {
+        try {
+            const outcome = await validator.validate(data);
+            // A result-returning `validate()` (not the VineJS contract) is honoured
+            // as-is; the throwing contract resolves to the validated payload.
+            return isValidationResult(outcome) ? outcome : { valid: true, errors: [], data: outcome };
+        }
+        catch (err) {
+            if (isThrownValidationFailure(err)) {
+                return { valid: false, errors: err.messages };
+            }
+            throw err;
+        }
+    }
+    throw new TypeError('Route validator exposes none of validateResultAsync(), validateResult() or validate().');
+}
 /** Named middleware registry. */
 export class MiddlewareRegistry {
     #global = [];
@@ -93,7 +131,7 @@ function compose(middleware) {
 function createGuardMiddleware(guards, roles, permissions) {
     return async (ctx, next) => {
         const needsAuth = guards.length > 0 || (roles && roles.length > 0) || (permissions && permissions.length > 0);
-        if (needsAuth && !ctx.auth.authenticated) {
+        if (needsAuth && !ctx.auth.isAuthenticated) {
             throw new E_UNAUTHORIZED();
         }
         // Auth providers may expose roles/permissions at the top level OR nested
@@ -125,7 +163,7 @@ function createGuardMiddleware(guards, roles, permissions) {
 function createValidationMiddleware(validators) {
     return async (ctx, next) => {
         for (const validator of validators) {
-            const result = validator.validate(ctx.request.body());
+            const result = await runValidator(validator, ctx.request.body());
             if (!result.valid) {
                 throw new E_VALIDATION_ERROR(result.errors);
             }

package/dist/middleware/Pipeline.js.map

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

package/dist/openapi/OpenApiProvider.js

@@ -22,8 +22,8 @@ export class OpenApiProvider extends Provider {
         const config = this.app.config.get('openapi') ?? {};
         if (config.enabled === false)
             return;
-        const generator = this.#override ?? this.#buildGenerator(config);
-        const server = this.app.container.make('server');
+        const generator = this.#override ?? (await this.#buildGenerator(config));
+        const server = await this.app.container.make('server');
         const middleware = new OpenApiMiddleware({
             specPath: config.specPath,
             docsPath: config.docsPath,
@@ -31,8 +31,8 @@ export class OpenApiProvider extends Provider {
         });
         server.use([(ctx, next) => middleware.handle(ctx, next)]);
     }
-    #buildGenerator(config) {
-        const router = this.app.container.make('router');
+    async #buildGenerator(config) {
+        const router = await this.app.container.make('router');
         return new OpenApiGenerator(router, {
             title: config.title ?? 'API',
             version: config.version ?? '1.0.0',

package/dist/openapi/OpenApiProvider.js.map

@@ -1 +1 @@
-{"version":3,"file":"OpenApiProvider.js","sourceRoot":"","sources":["../../src/openapi/OpenApiProvider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAGzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAoB1D,MAAM,OAAO,eAAgB,SAAQ,QAAQ;IAClC,SAAS,CAAmB;IAErC,YAAY,GAAe,EAAE,UAAkC,EAAE;QAC/D,KAAK,CAAC,GAAG,CAAC,CAAA;QACV,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAA;IACpC,CAAC;IAEQ,KAAK,CAAC,IAAI;QACjB,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAoB,SAAS,CAAC,IAAI,EAAE,CAAA;QACtE,IAAI,MAAM,CAAC,OAAO,KAAK,KAAK;YAAE,OAAM;QAEpC,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,CAAA;QAChE,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAS,QAAQ,CAAC,CAAA;QACxD,MAAM,UAAU,GAAG,IAAI,iBAAiB,CAAC;YACvC,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,IAAI,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE;SACjC,CAAC,CAAA;QACF,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,CAAA;IAC3D,CAAC;IAED,eAAe,CAAC,MAAyB;QACvC,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAS,QAAQ,CAAC,CAAA;QACxD,OAAO,IAAI,gBAAgB,CAAC,MAAM,EAAE;YAClC,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,KAAK;YAC5B,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,OAAO;SACnC,CAAC,CAAA;IACJ,CAAC;CACF;AAED,2KAA2K;AAC3K,eAAe,eAAe,CAAA"}
+{"version":3,"file":"OpenApiProvider.js","sourceRoot":"","sources":["../../src/openapi/OpenApiProvider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAGzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAoB1D,MAAM,OAAO,eAAgB,SAAQ,QAAQ;IAClC,SAAS,CAAmB;IAErC,YAAY,GAAe,EAAE,UAAkC,EAAE;QAC/D,KAAK,CAAC,GAAG,CAAC,CAAA;QACV,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAA;IACpC,CAAC;IAEQ,KAAK,CAAC,IAAI;QACjB,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAoB,SAAS,CAAC,IAAI,EAAE,CAAA;QACtE,IAAI,MAAM,CAAC,OAAO,KAAK,KAAK;YAAE,OAAM;QAEpC,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,CAAC,MAAM,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAA;QACxE,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAS,QAAQ,CAAC,CAAA;QAC9D,MAAM,UAAU,GAAG,IAAI,iBAAiB,CAAC;YACvC,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,IAAI,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE;SACjC,CAAC,CAAA;QACF,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,CAAA;IAC3D,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,MAAyB;QAC7C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAS,QAAQ,CAAC,CAAA;QAC9D,OAAO,IAAI,gBAAgB,CAAC,MAAM,EAAE;YAClC,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,KAAK;YAC5B,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,OAAO;SACnC,CAAC,CAAA;IACJ,CAAC;CACF;AAED,2KAA2K;AAC3K,eAAe,eAAe,CAAA"}

package/dist/router/Router.d.ts

@@ -5,7 +5,18 @@
  */
 import type { HttpContext } from '../http/HttpContext.js';
 import type { MiddlewareFunction } from '../middleware/Pipeline.js';
+import type { SignedUrl } from '../security/SignedUrl.js';
 import type { MiddlewareEntry } from '../server/Server.js';
+import { Macroable } from '../utils/Macroable.js';
+/** Options for {@link Router.makeSignedUrl}. */
+export interface SignedUrlOptions {
+    /** Extra query-string params folded into the signature. */
+    qs?: Record<string, string>;
+    /** Lifetime before the link expires — seconds (number) or a `'30m'`/`'2h'`/`'1d'` string. */
+    expiresIn?: string | number;
+    /** Namespaces the signature so a URL signed for one purpose can't be reused for another. */
+    purpose?: string;
+}
 export type RouteHandlerFunction = (ctx: HttpContext) => Promise<void> | void;
 /**
  * Controller tuple: [ControllerClass, 'methodName'].
@@ -13,8 +24,20 @@ export type RouteHandlerFunction = (ctx: HttpContext) => Promise<void> | void;
  * same pattern as AdonisJS (@poppinss/utils Constructor type).
  */
 export type ControllerAction = [target: new (...args: any[]) => any, method: string];
-/** A route handler is either a closure or a controller tuple. */
-export type RouteHandler = RouteHandlerFunction | ControllerAction;
+/** Any controller class (derived from {@link ControllerAction} — no fresh `any`). */
+export type ControllerConstructor = ControllerAction[0];
+/** A lazy controller import: `() => import('#controllers/users_controller')`. */
+export type LazyControllerImport = () => Promise<{
+    default: ControllerConstructor;
+}>;
+/** Lazy controller tuple: [() => import(...), 'methodName']. */
+export type LazyControllerAction = [loader: LazyControllerImport, method: string];
+/**
+ * A route handler is a closure, a controller tuple, a lazy-import tuple, or a
+ * magic string reference `'ControllerName.method'` resolved through the
+ * router's controller registry ({@link Router.controllers}).
+ */
+export type RouteHandler = RouteHandlerFunction | ControllerAction | LazyControllerAction | string;
 /** Param matcher — regex or predefined matcher. */
 export type ParamMatcher = RegExp | {
     pattern: RegExp;
@@ -41,6 +64,33 @@ export interface RouteDefinition {
         version: string;
         sunset?: string;
     };
+    /**
+     * Soft-delete flag (AdonisJS `route.markAsDeleted()`). A resource's
+     * `.only()`/`.except()`/`.apiOnly()` mark filtered-out routes deleted rather
+     * than splicing them, so the builder chain stays intact. Deleted routes are
+     * skipped by the match index and `getRoutes()`.
+     */
+    deleted?: boolean;
+    /**
+     * Lazily-imported controller (from a `[() => import(...), 'method']` tuple or
+     * a resolved string reference). The HttpKernel awaits the loader on first
+     * request and promotes it to {@link controller}, so @Guard metadata + DI
+     * resolution flow through the normal controller path.
+     */
+    lazyController?: {
+        loader: LazyControllerImport;
+        method: string;
+    };
+    /**
+     * Unresolved `'ControllerName.method'` string reference. Resolved to
+     * {@link lazyController} against the router's controller registry when the
+     * route index is (re)built — a reference to an unregistered controller is a
+     * hard error there.
+     */
+    stringRef?: {
+        controller: string;
+        method: string;
+    };
 }
 export interface MatchResult {
     route: RouteDefinition;
@@ -54,12 +104,19 @@ export declare const matchers: {
     /** Match slug params only (lowercase alphanumeric + hyphens). */
     slug(): ParamMatcher;
 };
-/** Fluent route builder — mutates the already-registered route definition. */
-export declare class RouteBuilder {
+/**
+ * Fluent route builder — mutates the already-registered route definition(s).
+ * Backed by an array so a multi-verb `router.route(['GET','POST'], …)` returns
+ * ONE builder that fans every mutation across all its verbs; the single-verb
+ * helpers (`get`/`post`/…) back it with a one-element array.
+ */
+export declare class RouteBuilder extends Macroable {
     #private;
-    constructor(route: RouteDefinition);
+    constructor(routes: RouteDefinition | RouteDefinition[]);
     /** Name this route (for URL generation and redirects). */
     as(name: string): this;
+    /** Prepend a URL prefix to this single route (AdonisJS route-level `prefix`). */
+    prefix(prefix: string): this;
     /** Add named middleware. */
     middleware(...names: string[]): this;
     /** Add inline middleware functions. */
@@ -70,8 +127,8 @@ export declare class RouteBuilder {
     role(...roles: string[]): this;
     /** Require specific permissions. */
     permission(...permissions: string[]): this;
-    /** Add a param constraint. */
-    where(param: string, matcher: ParamMatcher | RegExp): this;
+    /** Add a param constraint — RegExp, predefined matcher, or a string pattern. */
+    where(param: string, matcher: ParamMatcher | RegExp | string): this;
     /**
      * Validate the request body against a named validator. At request time the
      * kernel resolves the validator from the IoC container under the token
@@ -96,11 +153,21 @@ export declare class RouteBuilder {
     deprecates(version: string, options?: {
         sunset?: string;
     }): this;
-    /** @internal Get the underlying definition. */
+    /** The route's name, or undefined when unnamed (AdonisJS `route.getName`). */
+    getName(): string | undefined;
+    /** The route's URL pattern (AdonisJS `route.getPattern`). */
+    getPattern(): string;
+    /** Replace the route's URL pattern (AdonisJS `route.setPattern`). */
+    setPattern(pattern: string): this;
+    /** Soft-delete this route so it stops matching (AdonisJS `route.markAsDeleted`). */
+    markAsDeleted(): this;
+    /** True when the route has been soft-deleted (AdonisJS `route.isDeleted`). */
+    isDeleted(): boolean;
+    /** @internal Get the underlying (primary) definition. */
     getDefinition(): RouteDefinition;
 }
 /** Fluent group builder — returned by router.group(callback). */
-export declare class GroupBuilder {
+export declare class GroupBuilder extends Macroable {
     #private;
     constructor(routes: RouteDefinition[]);
     /** Set URL prefix for all routes in the group. */
@@ -111,26 +178,88 @@ export declare class GroupBuilder {
     use(...mw: MiddlewareFunction[]): this;
     /** Add guards to all routes in the group. */
     guard(...guards: string[]): this;
-    /** Prefix route names for all routes in the group. */
+    /**
+     * Prefix route names for all routes in the group (AdonisJS `group.as`).
+     * Every route MUST already be named — prefixing an unnamed route is
+     * meaningless, so it throws rather than silently skipping (AdonisJS parity).
+     */
     as(namePrefix: string): this;
     /** Set domain for all routes in the group. */
     domain(d: string): this;
     /** Add param matcher to all routes in the group. */
-    where(param: string, matcher: ParamMatcher | RegExp): this;
+    where(param: string, matcher: ParamMatcher | RegExp | string): this;
 }
-/** Builder for on(path).render(view) and on(path).redirect(target). */
+/** Resourceful action names (AdonisJS resource). */
+export type ResourceAction = 'index' | 'create' | 'store' | 'show' | 'edit' | 'update' | 'destroy';
+/** Middleware accepted per-action on a resource: a named string or an inline fn. */
+type ResourceMiddleware = string | MiddlewareFunction;
+/**
+ * Resourceful route builder — returned by `router.resource()` /
+ * `router.shallowResource()` (AdonisJS `RouteResource` parity).
+ *
+ * Generates the seven RESTful routes (index, create, store, show, edit,
+ * update, destroy — `update` registered for both PUT and PATCH) and exposes
+ * the fluent filtering/config API: `only`/`except`/`apiOnly`/`params`/`tap`/
+ * `where`/`use`/`middleware`/`as`. Nested resources use dot-notation
+ * (`posts.comments` → `/posts/:post_id/comments/:id`).
+ */
+export declare class RouteResource extends Macroable {
+    #private;
+    /** The generated routes, in declaration order (AdonisJS `resource.routes`). */
+    readonly routes: RouteBuilder[];
+    constructor(options: {
+        resource: string;
+        controller: ControllerAction[0];
+        shallow: boolean;
+        register: (def: RouteDefinition) => void;
+        markDirty: () => void;
+    });
+    /** Keep only the given actions; soft-delete the rest (AdonisJS `only`). */
+    only(names: ResourceAction[]): this;
+    /** Register all actions except the given ones (AdonisJS `except`). */
+    except(names: ResourceAction[]): this;
+    /** Drop the form-rendering `create` + `edit` actions (AdonisJS `apiOnly`). */
+    apiOnly(): this;
+    /** Constrain a param across every action route (AdonisJS `resource.where`). */
+    where(key: string, matcher: ParamMatcher | RegExp | string): this;
+    /**
+     * Configure the resource's routes. `tap(cb)` runs `cb` for every non-deleted
+     * route; `tap(actions, cb)` only for routes matching `actions` (AdonisJS `tap`).
+     */
+    tap(callback: (route: RouteBuilder) => void): this;
+    tap(actions: ResourceAction | ResourceAction[], callback: (route: RouteBuilder) => void): this;
+    /** Rename the `:id` param of one or more resources (AdonisJS `params`). */
+    params(resources: Record<string, string>): this;
+    /**
+     * Attach middleware to specific actions (or `'*'` for all) — AdonisJS `use`.
+     * Named middleware are strings; inline middleware are functions.
+     */
+    use(actions: ResourceAction | ResourceAction[] | '*', middleware: ResourceMiddleware | ResourceMiddleware[]): this;
+    /** Alias for {@link RouteResource.use} (AdonisJS `middleware`). */
+    middleware(actions: ResourceAction | ResourceAction[] | '*', middleware: ResourceMiddleware | ResourceMiddleware[]): this;
+    /**
+     * Rename the base of every route name (AdonisJS `as`). `normalizeName`
+     * snake_cases the new base by default.
+     */
+    as(name: string, normalizeName?: boolean): this;
+}
+/** Builder for on(path).render(view) and on(path).redirect(namedRoute). */
 export declare class OnRouteBuilder {
     #private;
     constructor(router: Router, path: string);
     /** Render a view (requires Photon/view provider). */
     render(view: string, data?: Record<string, unknown>): RouteBuilder;
-    /** Redirect to a path. */
-    redirect(target: string, status?: number): RouteBuilder;
-    /** Redirect to a named route. */
-    redirectToRoute(name: string, params?: Record<string, string>, status?: number): RouteBuilder;
+    /**
+     * Redirect to a NAMED route (AdonisJS brisk `redirect`). Mirrors AdonisJS:
+     * the first argument is a route name, not a path — use {@link redirectToPath}
+     * for a fixed URL.
+     */
+    redirect(name: string, params?: Record<string, string>, status?: number): RouteBuilder;
+    /** Redirect to a fixed path/URL (AdonisJS brisk `redirectToPath`). */
+    redirectToPath(target: string, status?: number): RouteBuilder;
 }
 /** Main Router. */
-export declare class Router {
+export declare class Router extends Macroable {
     #private;
     /** Predefined param matchers. */
     readonly matchers: {
@@ -147,18 +276,42 @@ export declare class Router {
      */
     use(middleware: MiddlewareEntry[]): this;
     /**
-     * Register named middleware collection.
+     * Register a named middleware collection and return per-name FACTORIES
+     * (AdonisJS `defineNamedMiddleware`). Call a factory to bind per-route
+     * arguments, then attach the result inline:
+     *
      *   export const middleware = router.named({
      *     auth: () => import('#middleware/auth_middleware'),
      *   })
+     *   router.get('/admin', [AdminController, 'index']).use([middleware.auth({ guards: ['web'] })])
+     *
+     * By-name usage (`route.middleware('auth')`) still runs the middleware with
+     * no arguments — the factory form is only needed to pass `args` to `handle`.
+     */
+    named(collection: Record<string, MiddlewareEntry>): Record<string, (args?: unknown) => MiddlewareFunction>;
+    /**
+     * Register controllers for magic string handler references (AdonisJS lazy
+     * controller pattern). Each entry maps a controller name to a lazy import:
+     *
+     *   router.controllers({ UsersController: () => import('#controllers/users_controller') })
+     *   router.get('/users', 'UsersController.index')
+     *
+     * The class is imported on first request and resolved through the IoC
+     * container (so @inject + @Guard/@Role decorators work). A string reference
+     * to a name that was never registered fails loudly when the route index is
+     * built.
      */
-    named(collection: Record<string, MiddlewareEntry>): Record<string, MiddlewareFunction>;
+    controllers(map: Record<string, LazyControllerImport>): this;
     /** Get the router-level middleware stack. */
     getRouterMiddleware(): MiddlewareFunction[];
     /** Get a named middleware by name. */
     getNamedMiddleware(name: string): MiddlewareFunction | undefined;
-    /** Register a route with any HTTP method. */
-    route(method: string, path: string, handler: RouteHandler): RouteBuilder;
+    /**
+     * Register a route for one verb or several (AdonisJS `route(pattern, methods)`
+     * accepts an array). A multi-verb call returns a single builder that
+     * configures every verb at once.
+     */
+    route(method: string | string[], path: string, handler: RouteHandler): RouteBuilder;
     get(path: string, handler: RouteHandler): RouteBuilder;
     post(path: string, handler: RouteHandler): RouteBuilder;
     put(path: string, handler: RouteHandler): RouteBuilder;
@@ -169,18 +322,28 @@ export declare class Router {
     /** Register a route for all HTTP methods. */
     any(path: string, handler: RouteHandler): RouteBuilder;
     /**
-     * Register resourceful routes for a controller.
-     * Generates: index, store, show, update, destroy
+     * Register resourceful routes for a controller (AdonisJS `resource`).
+     *
+     * Generates index / create / store / show / edit / update / destroy —
+     * `update` for both PUT and PATCH. Returns a {@link RouteResource} for
+     * fluent filtering: `.only()`, `.except()`, `.apiOnly()`, `.params()`,
+     * `.tap()`, `.where()`, `.use()`, `.as()`.
+     *
+     * Nested resources use dot-notation (`posts.comments` →
+     * `/posts/:post_id/comments/:id`).
      *
      * Usage:
      *   router.resource('posts', PostsController)
-     *   // GET    /posts          → PostsController.index
-     *   // POST   /posts          → PostsController.store
-     *   // GET    /posts/:id      → PostsController.show
-     *   // PUT    /posts/:id      → PostsController.update
-     *   // DELETE /posts/:id      → PostsController.destroy
+     *   router.resource('posts', PostsController).apiOnly()
      */
-    resource(path: string, controller: new (...args: any[]) => any): GroupBuilder;
+    resource(path: string, controller: ControllerAction[0]): RouteResource;
+    /**
+     * Register a shallow resource (AdonisJS `shallowResource`). Member routes
+     * (show/edit/update/destroy) drop the parent prefix, since the record id
+     * alone identifies it: `posts.comments` → `/comments/:id` for members but
+     * `/posts/:post_id/comments` for the collection.
+     */
+    shallowResource(path: string, controller: ControllerAction[0]): RouteResource;
     /**
      * Create a route group with shared configuration.
      *
@@ -205,7 +368,7 @@ export declare class Router {
     /** Create a view/redirect route shortcut. */
     on(path: string): OnRouteBuilder;
     /** Set a global param matcher (applied to all routes). */
-    where(param: string, matcher: ParamMatcher | RegExp): this;
+    where(param: string, matcher: ParamMatcher | RegExp | string): this;
     /** Find a matching route, extracting :param values and validating matchers. */
     match(method: string, path: string, host?: string): MatchResult | undefined;
     /**
@@ -219,6 +382,17 @@ export declare class Router {
      * Retained as a thin alias so existing callers keep working.
      */
     makeUrl(name: string, params?: Record<string, string>): string;
+    /** @internal Inject the APP_KEY-backed signed-URL helper (wired by the Ignitor). */
+    setSignedUrl(signedUrl: SignedUrl): void;
+    /**
+     * Generate a tamper-proof signed URL for a named route (AdonisJS
+     * `makeSignedUrl`). Delegates to the {@link SignedUrl} helper: appends an HMAC
+     * `signature`, plus a signed `expires` timestamp when `expiresIn` is given.
+     * Verified on the request side by `request.hasValidSignature()`.
+     *
+     * Requires an APP_KEY-backed signer (registered when `APP_KEY` is set).
+     */
+    makeSignedUrl(name: string, params?: Record<string, string>, options?: SignedUrlOptions): string;
     /**
      * Map of every NAMED route's `name` → path pattern, e.g.
      * `{ 'users.show': '/users/:id' }`. Serialize this into a page so a
@@ -227,7 +401,24 @@ export declare class Router {
      * the server. Powers the aurora client URL helper.
      */
     namedManifest(): Record<string, string>;
-    /** Get all registered routes (for OpenAPI generation, introspection). */
+    /**
+     * Generate a TypeScript source string typing every named route and its
+     * params (AdonisJS `generateTypes`) — a `RouteName` union plus a
+     * `RouteParams` map inferred from each pattern's `:param` segments. Write it
+     * to a `.d.ts` so `urlFor(name, params)` is type-checked. Returns the source;
+     * the caller decides where to persist it.
+     */
+    generateTypes(): string;
+    /**
+     * Find a registered route by name or exact pattern (AdonisJS `router.find`).
+     * Returns null when nothing matches. Soft-deleted routes are ignored.
+     */
+    find(identifier: string): RouteDefinition | null;
+    /** Like {@link find} but throws when the route is absent (AdonisJS `findOrFail`). */
+    findOrFail(identifier: string): RouteDefinition;
+    /** True when a route with the given name or pattern exists (AdonisJS `router.has`). */
+    has(identifier: string): boolean;
+    /** Get all registered (non-deleted) routes (for OpenAPI generation, introspection). */
     getRoutes(): RouteDefinition[];
     /**
      * Clear all registered routes AND registries (used by hot-reload). Router
@@ -238,4 +429,5 @@ export declare class Router {
     clear(): void;
     get routeCount(): number;
 }
+export {};
 //# sourceMappingURL=Router.d.ts.map