@avijs/core 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Christopher Robin Chase
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,13 @@
-# Temporary Holding Version
+# @avijs/core
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+The Avi.js public API: createAvi, AviFactory, modules, controllers, decorators, middleware, guards and validation.
+
+```sh
+npm install @avijs/core
+```
+
+Part of [Avi.js](https://github.com/chrischase011/avi-js), a TypeScript framework for Node.js with
+modules, controllers and dependency injection, without `reflect-metadata`. See the
+[tutorial](https://github.com/chrischase011/avi-js/blob/main/docs/tutorial/README.md) to get started.
+
+Requires Node.js 22.12 or newer. MIT licensed.

package/dist/app.d.ts

@@ -0,0 +1,51 @@
+import { type Provider, type Token, type TokenType } from '@avijs/di';
+import { type HttpMethod, type ServerOptions } from '@avijs/http';
+import { type RouteSchema } from '@avijs/validation';
+import type { AddressInfo } from 'node:net';
+import { type AppDescription } from './describe.js';
+import { type ModuleOptions, type ModuleRef } from './module.js';
+import { type GuardRef, type MiddlewareRef, type RouteDocs } from './pipeline.js';
+export interface AviOptions extends ServerOptions {
+    /** Runs first, for every route. */
+    middleware?: readonly MiddlewareRef[];
+    /** Checked first, for every route. */
+    guards?: readonly GuardRef[];
+    /**
+     * A manifest from `describeApp()` or `avi-compile manifest`. `init()` fails if the app no longer
+     * matches it, so a stale build artifact cannot ship unnoticed.
+     */
+    manifest?: AppDescription;
+    /**
+     * Providers that replace the provider for the same token anywhere in the app, for tests.
+     * An override that matches no provider is an error.
+     */
+    overrides?: readonly Provider[];
+}
+export interface AviApp {
+    /** Adds a root module: `defineModule`, an `@Module` class or inline options. Checks run in `init()`. */
+    register(module: ModuleRef | ModuleOptions): this;
+    /** Validates the module graph and routes, then creates all singletons. `listen()` calls it. */
+    init(): Promise<void>;
+    /** Starts the server. Use port `0` for a random free port. */
+    listen(port: number, host?: string): Promise<AddressInfo>;
+    /** Resolves a provider visible to the root modules. For tests and scripts, not app code. */
+    get<K extends Token>(token: K): TokenType<K>;
+    /** Every registered route, including runtime-created ones. Available after `init()`. */
+    routes(): readonly RouteInfo[];
+    /** Stops accepting connections, waits for in-flight requests, then disposes providers. */
+    close(): Promise<void>;
+}
+export interface RouteInfo {
+    readonly method: HttpMethod;
+    readonly path: string;
+    readonly module: string;
+    readonly controller: string;
+    readonly schema: RouteSchema | undefined;
+    readonly openapi: RouteDocs | undefined;
+}
+export declare function createAvi(options?: AviOptions): AviApp;
+export declare const AviFactory: {
+    /** Registers `module` and runs `init()`. The returned app is ready to `listen()`. */
+    create(module: ModuleRef | ModuleOptions, options?: AviOptions): Promise<AviApp>;
+};
+//# sourceMappingURL=app.d.ts.map

package/dist/app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,KAAK,QAAQ,EAAE,KAAK,KAAK,EAAE,KAAK,SAAS,EAAE,MAAM,WAAW,CAAC;AACjF,OAAO,EAML,KAAK,UAAU,EAIf,KAAK,aAAa,EACnB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAkB,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAG5C,OAAO,EAAoC,KAAK,cAAc,EAAE,MAAM,eAAe,CAAC;AACtF,OAAO,EAIL,KAAK,aAAa,EAClB,KAAK,SAAS,EACf,MAAM,aAAa,CAAC;AACrB,OAAO,EAIL,KAAK,QAAQ,EAEb,KAAK,aAAa,EAClB,KAAK,SAAS,EACf,MAAM,eAAe,CAAC;AAGvB,MAAM,WAAW,UAAW,SAAQ,aAAa;IAC/C,mCAAmC;IACnC,UAAU,CAAC,EAAE,SAAS,aAAa,EAAE,CAAC;IACtC,sCAAsC;IACtC,MAAM,CAAC,EAAE,SAAS,QAAQ,EAAE,CAAC;IAC7B;;;OAGG;IACH,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B;;;OAGG;IACH,SAAS,CAAC,EAAE,SAAS,QAAQ,EAAE,CAAC;CACjC;AAED,MAAM,WAAW,MAAM;IACrB,wGAAwG;IACxG,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,aAAa,GAAG,IAAI,CAAC;IAClD,+FAA+F;IAC/F,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,8DAA8D;IAC9D,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAC1D,4FAA4F;IAC5F,GAAG,CAAC,CAAC,SAAS,KAAK,EAAE,KAAK,EAAE,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;IAC7C,wFAAwF;IACxF,MAAM,IAAI,SAAS,SAAS,EAAE,CAAC;IAC/B,0FAA0F;IAC1F,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,OAAO,EAAE,SAAS,GAAG,SAAS,CAAC;CACzC;AAED,wBAAgB,SAAS,CAAC,OAAO,GAAE,UAAe,GAAG,MAAM,CAE1D;AAED,eAAO,MAAM,UAAU;IACrB,qFAAqF;mBAChE,SAAS,GAAG,aAAa,YAAY,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;CAKvF,CAAC"}

package/dist/app.js

@@ -0,0 +1,215 @@
+import { Container } from '@avijs/di';
+import { HttpServer, Router, compose, } from '@avijs/http';
+import { withValidation } from '@avijs/validation';
+import { joinPath } from './controller.js';
+import { checkConsumers, injectOf } from './consumers.js';
+import { describeModules, firstDifference } from './describe.js';
+import { defineModule, toModule, } from './module.js';
+import { checkRefs, isClass, } from './pipeline.js';
+import { REQUEST, REQUEST_TOKENS } from './request.js';
+export function createAvi(options = {}) {
+    return new Application(options);
+}
+export const AviFactory = {
+    /** Registers `module` and runs `init()`. The returned app is ready to `listen()`. */
+    async create(module, options) {
+        const app = createAvi(options).register(module);
+        await app.init();
+        return app;
+    },
+};
+class Application {
+    #router = new Router();
+    #server;
+    #roots = [];
+    #middleware;
+    #guards;
+    #manifest;
+    #overrides;
+    #logger;
+    #container;
+    #routes;
+    #init;
+    constructor(options) {
+        this.#server = new HttpServer(this.#router, options);
+        this.#middleware = checkRefs(options.middleware, 'use', 'App middleware');
+        this.#guards = checkRefs(options.guards, 'canActivate', 'App guards');
+        this.#manifest = options.manifest;
+        this.#overrides = options.overrides ?? [];
+        this.#logger = options.logger ?? {
+            error(message, error) {
+                console.error(message, error);
+            },
+        };
+    }
+    register(module) {
+        if (this.#init)
+            throw new Error('Cannot register modules after init() or listen()');
+        if (typeof module === 'function' && !toModule(module)) {
+            throw new TypeError(`${module.name || 'This class'} is not a module: add @Module()`);
+        }
+        this.#roots.push(toModule(module) ?? defineModule(module));
+        return this;
+    }
+    init() {
+        return (this.#init ??= this.#start());
+    }
+    async listen(port, host) {
+        await this.init();
+        return this.#server.listen(port, host);
+    }
+    get(token) {
+        if (!this.#container)
+            throw new Error('Call await app.init() before app.get()');
+        return this.#container.get(token);
+    }
+    routes() {
+        if (!this.#routes)
+            throw new Error('Call await app.init() before app.routes()');
+        return this.#routes;
+    }
+    async close() {
+        await this.#server.close();
+        await this.#container?.dispose();
+    }
+    async #start() {
+        const container = new Container(this.#roots, {
+            overrides: this.#overrides,
+            requestTokens: REQUEST_TOKENS,
+        });
+        const modules = container.modules;
+        checkConsumers(container);
+        await container.init();
+        try {
+            const appScope = new Pipeline((token) => container.get(token));
+            const appMiddleware = appScope.middleware(this.#middleware);
+            const appGuards = appScope.guards(this.#guards);
+            const routes = [];
+            const infos = [];
+            for (const module of modules) {
+                const scope = new Pipeline((token) => container.resolve(module, token));
+                const moduleMiddleware = [...appMiddleware, ...scope.middleware(module.middleware)];
+                const moduleGuards = [...appGuards, ...scope.guards(module.guards)];
+                for (const controller of module.controllers) {
+                    const perRequest = container.needsRequest(module, controller.inject);
+                    const deps = controller.inject.map((token) => perRequest && container.needsRequest(module, [token])
+                        ? placeholder(token, controller.name)
+                        : container.resolve(module, token));
+                    const base = joinPath(module.prefix, controller.prefix);
+                    const middleware = [...moduleMiddleware, ...scope.middleware(controller.middleware)];
+                    const guards = [...moduleGuards, ...scope.guards(controller.guards)];
+                    for (const [index, route] of controller.createRoutes(deps).entries()) {
+                        const handler = perRequest
+                            ? this.#perRequest(container, module, controller, index)
+                            : route.handler;
+                        const path = joinPath(base, route.path);
+                        infos.push({
+                            method: route.method,
+                            path,
+                            module: module.name,
+                            controller: controller.name,
+                            schema: route.schema,
+                            openapi: route.openapi,
+                        });
+                        routes.push({
+                            method: route.method,
+                            path,
+                            handler: compose([...middleware, ...scope.middleware(route.middleware ?? [])], [...guards, ...scope.guards(route.guards ?? [])], route.schema ? withValidation(route.schema, handler) : handler),
+                        });
+                    }
+                }
+            }
+            this.#router.add(routes);
+            this.#routes = Object.freeze(infos);
+            if (this.#manifest) {
+                const difference = firstDifference(this.#manifest, describeModules(container));
+                if (difference) {
+                    throw new Error(`The app does not match its manifest (first difference at ${difference}). Regenerate the manifest.`);
+                }
+            }
+            this.#container = container;
+        }
+        catch (error) {
+            await container.dispose().catch(() => undefined);
+            throw error;
+        }
+    }
+    /** Builds the controller for each request, so its request-scoped dependencies are fresh. */
+    #perRequest(container, module, controller, index) {
+        return async (ctx) => {
+            const scope = container.requestScope(new Map([[REQUEST, ctx]]));
+            try {
+                const deps = controller.inject.map((token) => scope.resolve(module, token));
+                const route = controller.createRoutes(deps)[index];
+                if (!route) {
+                    throw new Error(`${controller.name} returned fewer routes for this request than at startup`);
+                }
+                return await route.handler(ctx);
+            }
+            finally {
+                await scope.dispose().catch((error) => {
+                    this.#logger.error(`Failed to dispose request-scoped providers: ${ctx.method} ${ctx.path}`, error);
+                });
+            }
+        };
+    }
+}
+function tokenLabel(token) {
+    return typeof token === 'function' ? token.name : token.description;
+}
+/** Stands in for request-scoped dependencies while a controller's routes are read at startup. */
+function placeholder(token, owner) {
+    const fail = () => {
+        throw new Error(`${owner} used request-scoped ${tokenLabel(token)} while being created at startup. Use it inside route handlers only.`);
+    };
+    return new Proxy(function placeholder() {
+        return undefined;
+    }, {
+        get: fail,
+        set: fail,
+        has: fail,
+        apply: fail,
+        construct: fail,
+        ownKeys: fail,
+        defineProperty: fail,
+        deleteProperty: fail,
+    });
+}
+/** Turns middleware and guard refs into functions, building each class once per scope. */
+class Pipeline {
+    resolve;
+    #instances = new Map();
+    constructor(resolve) {
+        this.resolve = resolve;
+    }
+    middleware(refs) {
+        return refs.map((ref) => {
+            if (!isClass(ref))
+                return ref;
+            const instance = this.#instance(ref);
+            return (ctx, next) => instance.use(ctx, next);
+        });
+    }
+    guards(refs) {
+        return refs.map((ref) => {
+            if (!isClass(ref))
+                return ref;
+            const instance = this.#instance(ref);
+            return (ctx) => instance.canActivate(ctx);
+        });
+    }
+    #instance(cls) {
+        let instance = this.#instances.get(cls);
+        if (!instance) {
+            const inject = injectOf(cls);
+            if (cls.length > inject.length) {
+                throw new TypeError(`${cls.name} takes ${String(cls.length)} constructor arguments but static inject lists ${String(inject.length)}`);
+            }
+            const Ctor = cls;
+            instance = new Ctor(...inject.map(this.resolve));
+            this.#instances.set(cls, instance);
+        }
+        return instance;
+    }
+}
+//# sourceMappingURL=app.js.map

package/dist/app.js.map

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

package/dist/consumers.d.ts

@@ -0,0 +1,10 @@
+import type { Container, Token } from '@avijs/di';
+/**
+ * Checks that controllers, middleware and guard classes can see what they inject, and that
+ * middleware and guards do not need a request scope.
+ */
+export declare function checkConsumers(container: Container): void;
+export declare function injectOf(cls: {
+    readonly inject?: readonly Token[];
+}): readonly Token[];
+//# sourceMappingURL=consumers.d.ts.map

package/dist/consumers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consumers.d.ts","sourceRoot":"","sources":["../src/consumers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAIlD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI,CAoBzD;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE;IAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,KAAK,EAAE,CAAA;CAAE,GAAG,SAAS,KAAK,EAAE,CAEtF"}

package/dist/consumers.js

@@ -0,0 +1,31 @@
+import { isClass } from './pipeline.js';
+/**
+ * Checks that controllers, middleware and guard classes can see what they inject, and that
+ * middleware and guards do not need a request scope.
+ */
+export function checkConsumers(container) {
+    for (const module of container.modules) {
+        const checkRef = (ref, label) => {
+            if (!isClass(ref))
+                return;
+            const cls = ref;
+            const inject = injectOf(cls);
+            container.check(module, inject, `${label} ${cls.name}`);
+            if (container.needsRequest(module, inject)) {
+                throw new Error(`${label} ${cls.name} depends on a request-scoped provider. Middleware and guards are created once; read per-request data from ctx or ctx.state instead.`);
+            }
+        };
+        for (const ref of [...module.middleware, ...module.guards])
+            checkRef(ref, module.name);
+        for (const controller of module.controllers) {
+            const label = `${module.name} controller ${controller.prefix}`;
+            container.check(module, controller.inject, label);
+            for (const ref of [...controller.middleware, ...controller.guards])
+                checkRef(ref, label);
+        }
+    }
+}
+export function injectOf(cls) {
+    return cls.inject ?? [];
+}
+//# sourceMappingURL=consumers.js.map

package/dist/consumers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consumers.js","sourceRoot":"","sources":["../src/consumers.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAsD,MAAM,eAAe,CAAC;AAE5F;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,SAAoB;IACjD,KAAK,MAAM,MAAM,IAAI,SAAS,CAAC,OAAsB,EAAE,CAAC;QACtD,MAAM,QAAQ,GAAG,CAAC,GAA6B,EAAE,KAAa,EAAE,EAAE;YAChE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC;gBAAE,OAAO;YAC1B,MAAM,GAAG,GAAG,GAAiB,CAAC;YAC9B,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;YAC7B,SAAS,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,KAAK,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;YACxD,IAAI,SAAS,CAAC,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC;gBAC3C,MAAM,IAAI,KAAK,CACb,GAAG,KAAK,IAAI,GAAG,CAAC,IAAI,qIAAqI,CAC1J,CAAC;YACJ,CAAC;QACH,CAAC,CAAC;QACF,KAAK,MAAM,GAAG,IAAI,CAAC,GAAG,MAAM,CAAC,UAAU,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC;YAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;QACvF,KAAK,MAAM,UAAU,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;YAC5C,MAAM,KAAK,GAAG,GAAG,MAAM,CAAC,IAAI,eAAe,UAAU,CAAC,MAAM,EAAE,CAAC;YAC/D,SAAS,CAAC,KAAK,CAAC,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;YAClD,KAAK,MAAM,GAAG,IAAI,CAAC,GAAG,UAAU,CAAC,UAAU,EAAE,GAAG,UAAU,CAAC,MAAM,CAAC;gBAAE,QAAQ,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC3F,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,GAA2C;IAClE,OAAO,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC;AAC1B,CAAC"}

package/dist/controller.d.ts

@@ -0,0 +1,36 @@
+import type { ResolveTokens, Token } from '@avijs/di';
+import type { HttpMethod } from '@avijs/http';
+import { type GuardRef, type MiddlewareRef, type Route } from './pipeline.js';
+export interface ControllerOptions<K extends readonly Token[] = []> {
+    /** Used in manifests and error messages. Default: 'controller <prefix>'. */
+    name?: string;
+    /** Path prefix for every route. Default: `/`. */
+    prefix?: string;
+    /** Dependencies passed to `routes`, in order. */
+    inject?: K;
+    /** Runs for every route in this controller, after app and module middleware. */
+    middleware?: readonly MiddlewareRef[];
+    /** Checked for every route in this controller, after app and module guards. */
+    guards?: readonly GuardRef[];
+    routes: readonly Route[] | ((...deps: ResolveTokens<K>) => readonly Route[]);
+}
+/** The normalized shape both controller styles produce. */
+export interface StaticRoute {
+    readonly method: HttpMethod;
+    readonly path: string;
+}
+export interface ControllerDefinition {
+    readonly name: string;
+    readonly prefix: string;
+    readonly inject: readonly Token[];
+    readonly middleware: readonly MiddlewareRef[];
+    readonly guards: readonly GuardRef[];
+    /** Routes known without creating the controller; 'dynamic' for a routes factory. */
+    readonly staticRoutes: readonly StaticRoute[] | 'dynamic';
+    createRoutes(deps: readonly unknown[]): readonly Route[];
+}
+export declare function defineController<const K extends readonly Token[] = []>(options: ControllerOptions<K>): ControllerDefinition;
+export declare function checkRoutes(value: unknown): readonly Route[];
+/** Joins a prefix and a route path, collapsing repeated slashes and dropping a trailing one. */
+export declare function joinPath(prefix: string, path: string): string;
+//# sourceMappingURL=controller.d.ts.map

package/dist/controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller.d.ts","sourceRoot":"","sources":["../src/controller.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AACtD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,OAAO,EAAa,KAAK,QAAQ,EAAE,KAAK,aAAa,EAAE,KAAK,KAAK,EAAE,MAAM,eAAe,CAAC;AAEzF,MAAM,WAAW,iBAAiB,CAAC,CAAC,SAAS,SAAS,KAAK,EAAE,GAAG,EAAE;IAChE,4EAA4E;IAC5E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iDAAiD;IACjD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,MAAM,CAAC,EAAE,CAAC,CAAC;IACX,gFAAgF;IAChF,UAAU,CAAC,EAAE,SAAS,aAAa,EAAE,CAAC;IACtC,+EAA+E;IAC/E,MAAM,CAAC,EAAE,SAAS,QAAQ,EAAE,CAAC;IAC7B,MAAM,EAAE,SAAS,KAAK,EAAE,GAAG,CAAC,CAAC,GAAG,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC,KAAK,SAAS,KAAK,EAAE,CAAC,CAAC;CAC9E;AAED,2DAA2D;AAC3D,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,CAAC;IAClC,QAAQ,CAAC,UAAU,EAAE,SAAS,aAAa,EAAE,CAAC;IAC9C,QAAQ,CAAC,MAAM,EAAE,SAAS,QAAQ,EAAE,CAAC;IACrC,oFAAoF;IACpF,QAAQ,CAAC,YAAY,EAAE,SAAS,WAAW,EAAE,GAAG,SAAS,CAAC;IAC1D,YAAY,CAAC,IAAI,EAAE,SAAS,OAAO,EAAE,GAAG,SAAS,KAAK,EAAE,CAAC;CAC1D;AAED,wBAAgB,gBAAgB,CAAC,KAAK,CAAC,CAAC,SAAS,SAAS,KAAK,EAAE,GAAG,EAAE,EACpE,OAAO,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAC5B,oBAAoB,CAsCtB;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,KAAK,EAAE,CAiB5D;AAED,gGAAgG;AAChG,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAG7D"}

package/dist/controller.js

@@ -0,0 +1,61 @@
+import { checkRouteSchema } from '@avijs/validation';
+import { checkRefs } from './pipeline.js';
+export function defineController(options) {
+    const prefix = options.prefix ?? '/';
+    if (!prefix.startsWith('/')) {
+        throw new TypeError(`Controller prefix must start with "/": ${prefix}`);
+    }
+    const inject = Object.freeze([...(options.inject ?? [])]);
+    const middleware = checkRefs(options.middleware, 'use', `Controller ${prefix} middleware`);
+    const guards = checkRefs(options.guards, 'canActivate', `Controller ${prefix} guards`);
+    const name = options.name ?? `controller ${prefix}`;
+    const { routes } = options;
+    if (typeof routes !== 'function') {
+        const fixed = checkRoutes(routes);
+        return Object.freeze({
+            name,
+            prefix,
+            inject,
+            middleware,
+            guards,
+            staticRoutes: Object.freeze(fixed.map(({ method, path }) => ({ method, path }))),
+            createRoutes: () => fixed,
+        });
+    }
+    if (routes.length > inject.length) {
+        throw new TypeError(`Controller ${prefix}: routes takes ${String(routes.length)} arguments but inject lists ${String(inject.length)}`);
+    }
+    const factory = routes;
+    return Object.freeze({
+        name,
+        prefix,
+        inject,
+        middleware,
+        guards,
+        staticRoutes: 'dynamic',
+        createRoutes: (deps) => checkRoutes(factory(...deps)),
+    });
+}
+export function checkRoutes(value) {
+    if (!Array.isArray(value))
+        throw new TypeError('Controller routes must be an array');
+    const routes = value;
+    return Object.freeze(routes.map((route) => {
+        if (route.path !== '' && !route.path.startsWith('/')) {
+            throw new TypeError(`Route path must be empty or start with "/": ${route.path}`);
+        }
+        const where = `Route ${route.method} ${route.path}`;
+        return Object.freeze({
+            ...route,
+            middleware: checkRefs(route.middleware, 'use', `${where} middleware`),
+            guards: checkRefs(route.guards, 'canActivate', `${where} guards`),
+            schema: checkRouteSchema(route.schema, where),
+        });
+    }));
+}
+/** Joins a prefix and a route path, collapsing repeated slashes and dropping a trailing one. */
+export function joinPath(prefix, path) {
+    const joined = `${prefix}/${path}`.replace(/\/{2,}/g, '/');
+    return joined.length > 1 && joined.endsWith('/') ? joined.slice(0, -1) : joined;
+}
+//# sourceMappingURL=controller.js.map

package/dist/controller.js.map

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

package/dist/decorators.d.ts

@@ -0,0 +1,52 @@
+import type { Class, ResolveTokens, Scope, Token } from '@avijs/di';
+import type { Context, NoInput } from '@avijs/http';
+import { type InputOf, type PathParams, type RouteSchema } from '@avijs/validation';
+import { type ModuleOptions } from './module.js';
+import { type GuardRef, type MiddlewareRef, type RouteDocs } from './pipeline.js';
+type InjectOf<C> = C extends {
+    inject: infer K extends readonly Token[];
+} ? K : [];
+interface InjectMismatch {
+    readonly 'static inject must list the constructor parameter types in order, declared `as const`': never;
+}
+/** Resolves to `unknown` when `static inject` fits the constructor, else to an error type. */
+export type CheckInject<C extends Class> = ResolveTokens<InjectOf<C>> extends ConstructorParameters<C> ? unknown : InjectMismatch;
+export declare function Controller(prefix?: string): <C extends Class & CheckInject<C>>(value: C, context: ClassDecoratorContext<C>) => void;
+/** Adds middleware to every route of a controller class, or to one route method. */
+export declare function UseMiddleware(...middleware: MiddlewareRef[]): (_value: unknown, context: ClassDecoratorContext | ClassMethodDecoratorContext) => void;
+/** Adds guards to every route of a controller class, or to one route method. */
+export declare function UseGuards(...guards: GuardRef[]): (_value: unknown, context: ClassDecoratorContext | ClassMethodDecoratorContext) => void;
+export declare function Injectable(options?: {
+    scope?: Scope;
+}): <C extends Class & CheckInject<C>>(value: C, context: ClassDecoratorContext<C>) => void;
+export declare function Module(options?: ModuleOptions): <C extends Class>(value: C, context: ClassDecoratorContext<C>) => void;
+export declare const Get: <const P extends string = "", S extends RouteSchema = NoInput>(path?: P, options?: {
+    schema?: S;
+    openapi?: RouteDocs;
+}) => <This, F extends (this: This, ctx: Context<InputOf<S>, PathParams<P>>) => unknown>(_value: F, context: ClassMethodDecoratorContext<This, F>) => void;
+export declare const Post: <const P extends string = "", S extends RouteSchema = NoInput>(path?: P, options?: {
+    schema?: S;
+    openapi?: RouteDocs;
+}) => <This, F extends (this: This, ctx: Context<InputOf<S>, PathParams<P>>) => unknown>(_value: F, context: ClassMethodDecoratorContext<This, F>) => void;
+export declare const Put: <const P extends string = "", S extends RouteSchema = NoInput>(path?: P, options?: {
+    schema?: S;
+    openapi?: RouteDocs;
+}) => <This, F extends (this: This, ctx: Context<InputOf<S>, PathParams<P>>) => unknown>(_value: F, context: ClassMethodDecoratorContext<This, F>) => void;
+export declare const Patch: <const P extends string = "", S extends RouteSchema = NoInput>(path?: P, options?: {
+    schema?: S;
+    openapi?: RouteDocs;
+}) => <This, F extends (this: This, ctx: Context<InputOf<S>, PathParams<P>>) => unknown>(_value: F, context: ClassMethodDecoratorContext<This, F>) => void;
+export declare const Delete: <const P extends string = "", S extends RouteSchema = NoInput>(path?: P, options?: {
+    schema?: S;
+    openapi?: RouteDocs;
+}) => <This, F extends (this: This, ctx: Context<InputOf<S>, PathParams<P>>) => unknown>(_value: F, context: ClassMethodDecoratorContext<This, F>) => void;
+export declare const Head: <const P extends string = "", S extends RouteSchema = NoInput>(path?: P, options?: {
+    schema?: S;
+    openapi?: RouteDocs;
+}) => <This, F extends (this: This, ctx: Context<InputOf<S>, PathParams<P>>) => unknown>(_value: F, context: ClassMethodDecoratorContext<This, F>) => void;
+export declare const Options: <const P extends string = "", S extends RouteSchema = NoInput>(path?: P, options?: {
+    schema?: S;
+    openapi?: RouteDocs;
+}) => <This, F extends (this: This, ctx: Context<InputOf<S>, PathParams<P>>) => unknown>(_value: F, context: ClassMethodDecoratorContext<This, F>) => void;
+export {};
+//# sourceMappingURL=decorators.d.ts.map

package/dist/decorators.d.ts.map

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