@miiajs/core 0.1.0

package/dist/decorators/metadata.d.ts

@@ -0,0 +1,29 @@
+import '../polyfill.js';
+import type { Constructor, Scope } from '../types.js';
+export interface InjectableMeta {
+    scope: Scope;
+    token?: string;
+}
+export declare const INJECTABLE: unique symbol;
+export declare const MODULE: unique symbol;
+export declare const PREFIX: unique symbol;
+export declare const RESOLVED_PREFIX: unique symbol;
+export declare const ROUTES: unique symbol;
+export declare const CLASS_MW: unique symbol;
+export declare const METHOD_MW: unique symbol;
+export declare const STATUSES: unique symbol;
+export declare const CLASS_GUARDS: unique symbol;
+export declare const METHOD_GUARDS: unique symbol;
+export declare const SKIP_GUARDS: unique symbol;
+export declare const GUARD_FACTORY: unique symbol;
+export declare const BODY_SCHEMAS: unique symbol;
+export declare const QUERY_SCHEMAS: unique symbol;
+export declare const PARAMS_SCHEMAS: unique symbol;
+type Meta = Record<string | symbol, any>;
+export declare function getMeta<T>(ctor: Constructor, key: symbol): T | undefined;
+export declare function setMeta<T>(meta: Meta, key: symbol, value: T): void;
+export declare function pushMeta<T>(meta: Meta, key: symbol, item: T): void;
+export declare function addToMapMeta<T>(meta: Meta, key: symbol, name: string, items: T[]): void;
+export declare function setInMapMeta<T>(meta: Meta, key: symbol, name: string, value: T): void;
+export {};
+//# sourceMappingURL=metadata.d.ts.map

package/dist/decorators/metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../../src/decorators/metadata.ts"],"names":[],"mappings":"AAAA,OAAO,gBAAgB,CAAA;AACvB,OAAO,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AAIrD,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,KAAK,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAID,eAAO,MAAM,UAAU,eAAuB,CAAA;AAC9C,eAAO,MAAM,MAAM,eAAmB,CAAA;AACtC,eAAO,MAAM,MAAM,eAAmB,CAAA;AACtC,eAAO,MAAM,eAAe,eAA2B,CAAA;AACvD,eAAO,MAAM,MAAM,eAAmB,CAAA;AACtC,eAAO,MAAM,QAAQ,eAA6B,CAAA;AAClD,eAAO,MAAM,SAAS,eAA8B,CAAA;AACpD,eAAO,MAAM,QAAQ,eAAqB,CAAA;AAC1C,eAAO,MAAM,YAAY,eAAwB,CAAA;AACjD,eAAO,MAAM,aAAa,eAAyB,CAAA;AACnD,eAAO,MAAM,WAAW,eAAuB,CAAA;AAC/C,eAAO,MAAM,aAAa,eAAyB,CAAA;AACnD,eAAO,MAAM,YAAY,eAAwB,CAAA;AACjD,eAAO,MAAM,aAAa,eAAyB,CAAA;AACnD,eAAO,MAAM,cAAc,eAA0B,CAAA;AAIrD,KAAK,IAAI,GAAG,MAAM,CAAC,MAAM,GAAG,MAAM,EAAE,GAAG,CAAC,CAAA;AAExC,wBAAgB,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAExE;AAED,wBAAgB,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,CAElE;AAED,wBAAgB,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI,CAIlE;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,IAAI,CAKvF;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,CAIrF"}

package/dist/decorators/metadata.js

@@ -0,0 +1,40 @@
+import '../polyfill.js';
+// ─── Symbol keys ─────────────────────────────────────────────────
+export const INJECTABLE = Symbol('injectable');
+export const MODULE = Symbol('module');
+export const PREFIX = Symbol('prefix');
+export const RESOLVED_PREFIX = Symbol('resolvedPrefix');
+export const ROUTES = Symbol('routes');
+export const CLASS_MW = Symbol('classMiddlewares');
+export const METHOD_MW = Symbol('methodMiddlewares');
+export const STATUSES = Symbol('statuses');
+export const CLASS_GUARDS = Symbol('classGuards');
+export const METHOD_GUARDS = Symbol('methodGuards');
+export const SKIP_GUARDS = Symbol('skipGuards');
+export const GUARD_FACTORY = Symbol('guardFactory');
+export const BODY_SCHEMAS = Symbol('bodySchemas');
+export const QUERY_SCHEMAS = Symbol('querySchemas');
+export const PARAMS_SCHEMAS = Symbol('paramsSchemas');
+export function getMeta(ctor, key) {
+    return ctor[Symbol.metadata]?.[key];
+}
+export function setMeta(meta, key, value) {
+    meta[key] = value;
+}
+export function pushMeta(meta, key, item) {
+    const arr = meta[key] ?? [];
+    arr.push(item);
+    meta[key] = arr;
+}
+export function addToMapMeta(meta, key, name, items) {
+    const map = meta[key] ?? new Map();
+    const existing = map.get(name) ?? [];
+    map.set(name, [...existing, ...items]);
+    meta[key] = map;
+}
+export function setInMapMeta(meta, key, name, value) {
+    const map = meta[key] ?? new Map();
+    map.set(name, value);
+    meta[key] = map;
+}
+//# sourceMappingURL=metadata.js.map

package/dist/decorators/metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.js","sourceRoot":"","sources":["../../src/decorators/metadata.ts"],"names":[],"mappings":"AAAA,OAAO,gBAAgB,CAAA;AAUvB,oEAAoE;AAEpE,MAAM,CAAC,MAAM,UAAU,GAAG,MAAM,CAAC,YAAY,CAAC,CAAA;AAC9C,MAAM,CAAC,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAA;AACtC,MAAM,CAAC,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAA;AACtC,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC,gBAAgB,CAAC,CAAA;AACvD,MAAM,CAAC,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAA;AACtC,MAAM,CAAC,MAAM,QAAQ,GAAG,MAAM,CAAC,kBAAkB,CAAC,CAAA;AAClD,MAAM,CAAC,MAAM,SAAS,GAAG,MAAM,CAAC,mBAAmB,CAAC,CAAA;AACpD,MAAM,CAAC,MAAM,QAAQ,GAAG,MAAM,CAAC,UAAU,CAAC,CAAA;AAC1C,MAAM,CAAC,MAAM,YAAY,GAAG,MAAM,CAAC,aAAa,CAAC,CAAA;AACjD,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC,cAAc,CAAC,CAAA;AACnD,MAAM,CAAC,MAAM,WAAW,GAAG,MAAM,CAAC,YAAY,CAAC,CAAA;AAC/C,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC,cAAc,CAAC,CAAA;AACnD,MAAM,CAAC,MAAM,YAAY,GAAG,MAAM,CAAC,aAAa,CAAC,CAAA;AACjD,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC,cAAc,CAAC,CAAA;AACnD,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC,eAAe,CAAC,CAAA;AAMrD,MAAM,UAAU,OAAO,CAAI,IAAiB,EAAE,GAAW;IACvD,OAAQ,IAAY,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,GAAG,CAAkB,CAAA;AAC/D,CAAC;AAED,MAAM,UAAU,OAAO,CAAI,IAAU,EAAE,GAAW,EAAE,KAAQ;IAC1D,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;AACnB,CAAC;AAED,MAAM,UAAU,QAAQ,CAAI,IAAU,EAAE,GAAW,EAAE,IAAO;IAC1D,MAAM,GAAG,GAAI,IAAI,CAAC,GAAG,CAAS,IAAI,EAAE,CAAA;IACpC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACd,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,CAAA;AACjB,CAAC;AAED,MAAM,UAAU,YAAY,CAAI,IAAU,EAAE,GAAW,EAAE,IAAY,EAAE,KAAU;IAC/E,MAAM,GAAG,GAAI,IAAI,CAAC,GAAG,CAAsB,IAAI,IAAI,GAAG,EAAe,CAAA;IACrE,MAAM,QAAQ,GAAG,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAA;IACpC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,GAAG,QAAQ,EAAE,GAAG,KAAK,CAAC,CAAC,CAAA;IACtC,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,CAAA;AACjB,CAAC;AAED,MAAM,UAAU,YAAY,CAAI,IAAU,EAAE,GAAW,EAAE,IAAY,EAAE,KAAQ;IAC7E,MAAM,GAAG,GAAI,IAAI,CAAC,GAAG,CAAoB,IAAI,IAAI,GAAG,EAAa,CAAA;IACjE,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;IACpB,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,CAAA;AACjB,CAAC"}

package/dist/decorators/middleware.d.ts

@@ -0,0 +1,9 @@
+import type { Guard, Middleware, ZodLike } from '../types.js';
+export declare const Use: (...args: Middleware[]) => (target: any, context: ClassDecoratorContext | ClassMethodDecoratorContext) => any;
+export declare const UseGuard: (...args: Guard[]) => (target: any, context: ClassDecoratorContext | ClassMethodDecoratorContext) => any;
+export declare const SkipGuard: (first: Function | Guard, ...rest: (Function | Guard)[]) => (target: any, context: ClassDecoratorContext | ClassMethodDecoratorContext) => any;
+export declare const ValidateBody: (schema: ZodLike<any>) => (target: Function, context: ClassMethodDecoratorContext) => void;
+export declare const ValidateQuery: (schema: ZodLike<any>) => (target: Function, context: ClassMethodDecoratorContext) => void;
+export declare const ValidateParams: (schema: ZodLike<any>) => (target: Function, context: ClassMethodDecoratorContext) => void;
+export declare const Status: (code: number) => (target: Function, context: ClassMethodDecoratorContext) => void;
+//# sourceMappingURL=middleware.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../src/decorators/middleware.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAqB7D,eAAO,MAAM,GAAG,+GAOd,CAAA;AAIF,eAAO,MAAM,QAAQ,0GAOnB,CAAA;AAIF,eAAO,MAAM,SAAS,gJASrB,CAAA;AAID,eAAO,MAAM,YAAY,4FAevB,CAAA;AAIF,eAAO,MAAM,aAAa,4FAWxB,CAAA;AAIF,eAAO,MAAM,cAAc,4FAWzB,CAAA;AAIF,eAAO,MAAM,MAAM,oFAEjB,CAAA"}

package/dist/decorators/middleware.js

@@ -0,0 +1,82 @@
+import { CLASS_MW, METHOD_MW, CLASS_GUARDS, METHOD_GUARDS, STATUSES, SKIP_GUARDS, BODY_SCHEMAS, QUERY_SCHEMAS, PARAMS_SCHEMAS, addToMapMeta, setMeta, setInMapMeta, } from './metadata.js';
+import { UnprocessableException } from '../exceptions.js';
+import { createMethodDecorator } from './create-decorator.js';
+import { createDecorator } from './create-decorator.js';
+// ─── @Use ────────────────────────────────────────────────────────
+export const Use = createDecorator((context, ...middlewares) => {
+    if (context.kind === 'class') {
+        const existing = context.metadata[CLASS_MW] ?? [];
+        setMeta(context.metadata, CLASS_MW, [...existing, ...middlewares]);
+    }
+    else {
+        addToMapMeta(context.metadata, METHOD_MW, String(context.name), middlewares);
+    }
+});
+// ─── @UseGuard ───────────────────────────────────────────────────
+export const UseGuard = createDecorator((context, ...guards) => {
+    if (context.kind === 'class') {
+        const existing = context.metadata[CLASS_GUARDS] ?? [];
+        setMeta(context.metadata, CLASS_GUARDS, [...existing, ...guards]);
+    }
+    else {
+        addToMapMeta(context.metadata, METHOD_GUARDS, String(context.name), guards);
+    }
+});
+// ─── @SkipGuard ─────────────────────────────────────────────────
+export const SkipGuard = createDecorator((context, ...guards) => {
+    const name = context.kind === 'class' ? '*' : String(context.name);
+    const map = context.metadata[SKIP_GUARDS] ?? new Map();
+    const existing = map.get(name) ?? new Set();
+    for (const g of guards)
+        existing.add(g);
+    map.set(name, existing);
+    context.metadata[SKIP_GUARDS] = map;
+});
+// ─── @ValidateBody ───────────────────────────────────────────────
+export const ValidateBody = createMethodDecorator((_target, context, schema) => {
+    const mw = async (ctx, next) => {
+        // .catch(() => null) intentionally swallows both fresh req.json() rejections
+        // (malformed body) and cached rejections from prior ctx.json() calls in other
+        // middleware - null then flows through safeParse and becomes an UnprocessableException.
+        const body = await ctx.json().catch(() => null);
+        const result = schema.safeParse(body);
+        if (!result.success) {
+            throw new UnprocessableException('Body validation failed', result.error.issues);
+        }
+        ctx._setBody(result.data);
+        await next();
+    };
+    setInMapMeta(context.metadata, BODY_SCHEMAS, String(context.name), schema);
+    addToMapMeta(context.metadata, METHOD_MW, String(context.name), [mw]);
+});
+// ─── @ValidateQuery ──────────────────────────────────────────────
+export const ValidateQuery = createMethodDecorator((_target, context, schema) => {
+    const mw = async (ctx, next) => {
+        const result = schema.safeParse(ctx.query);
+        if (!result.success) {
+            throw new UnprocessableException('Query validation failed', result.error.issues);
+        }
+        ctx.query = result.data;
+        await next();
+    };
+    setInMapMeta(context.metadata, QUERY_SCHEMAS, String(context.name), schema);
+    addToMapMeta(context.metadata, METHOD_MW, String(context.name), [mw]);
+});
+// ─── @ValidateParams ─────────────────────────────────────────────
+export const ValidateParams = createMethodDecorator((_target, context, schema) => {
+    const mw = async (ctx, next) => {
+        const result = schema.safeParse(ctx.params);
+        if (!result.success) {
+            throw new UnprocessableException('Params validation failed', result.error.issues);
+        }
+        ctx.params = result.data;
+        await next();
+    };
+    setInMapMeta(context.metadata, PARAMS_SCHEMAS, String(context.name), schema);
+    addToMapMeta(context.metadata, METHOD_MW, String(context.name), [mw]);
+});
+// ─── @Status ─────────────────────────────────────────────────────
+export const Status = createMethodDecorator((_target, context, code) => {
+    setInMapMeta(context.metadata, STATUSES, String(context.name), code);
+});
+//# sourceMappingURL=middleware.js.map

package/dist/decorators/middleware.js.map

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

package/dist/di-container.d.ts

@@ -0,0 +1,52 @@
+import type { Constructor, Resolve, Scope } from './types.js';
+export declare class Container {
+    /** @internal */
+    static activeContainer: Container | null;
+    private registry;
+    private requestInstances;
+    private resolving;
+    register<T>(token: Constructor<T> | string, factory: ((resolve: Resolve) => T) | (() => T), scope?: Scope): void;
+    registerClass<T>(cls: Constructor<T>, scope?: Scope): void;
+    resolve<T>(token: Constructor<T> | string): T;
+    resolveOptional<T>(token: Constructor<T> | string): T | null;
+    has(token: Constructor | string): boolean;
+    clearRequestScope(): void;
+    initAll(): Promise<void>;
+    /**
+     * Phase 3 of init: invoke onReady() on all singletons that define it.
+     * Called by Miia.doInit() after initAll() and compilePipelines().
+     *
+     * Guarantees:
+     * - By the time any onReady() runs, all onInit() hooks have completed.
+     *
+     * Caveats:
+     * - Order of onReady() calls is registration order (same as initAll()).
+     *   Avoid inter-onReady dependencies - if provider A's onReady() relies on
+     *   provider B's onReady() having run first, the result is order-fragile.
+     * - Lazy-registered providers (e.g. global guards added via app.useGuard()
+     *   after initAll() - see compilePipelines() in app.ts) will receive
+     *   onReady() but may not have received onInit(). This mirrors the existing
+     *   pre-existing quirk with onDestroy() and is not introduced by this change.
+     */
+    bootstrapAll(): Promise<void>;
+    /**
+     * Returns all singleton instances currently registered in the container.
+     * Filters out string-token registrations (only class-keyed entries) and
+     * entries that have not yet been instantiated.
+     *
+     * Used by DiscoveryService for ambient method-decorator discovery.
+     */
+    getSingletonInstances(): Array<{
+        ctor: Constructor;
+        instance: object;
+    }>;
+    destroyAll(): Promise<void>;
+    private instantiate;
+    private callFactory;
+}
+export declare function inject<T>(token: Constructor<T>): T;
+export declare function inject<T>(token: string): T;
+export declare function injectOptional<T>(token: Constructor<T>): T | null;
+export declare function injectOptional<T>(token: string): T | null;
+export declare function runInContainerContext<T>(container: Container, fn: () => T): T;
+//# sourceMappingURL=di-container.d.ts.map

package/dist/di-container.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"di-container.d.ts","sourceRoot":"","sources":["../src/di-container.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAQ7D,qBAAa,SAAS;IACpB,gBAAgB;IAChB,MAAM,CAAC,eAAe,EAAE,SAAS,GAAG,IAAI,CAAO;IAE/C,OAAO,CAAC,QAAQ,CAAkD;IAClE,OAAO,CAAC,gBAAgB,CAA2C;IACnE,OAAO,CAAC,SAAS,CAAkC;IAEnD,QAAQ,CAAC,CAAC,EACR,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,MAAM,EAC9B,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,OAAO,KAAK,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,EAC9C,KAAK,GAAE,KAAmB,GACzB,IAAI;IAIP,aAAa,CAAC,CAAC,EAAE,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,KAAK,GAAE,KAAmB,GAAG,IAAI;IAOvE,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,MAAM,GAAG,CAAC;IAQ7C,eAAe,CAAC,CAAC,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,MAAM,GAAG,CAAC,GAAG,IAAI;IAM5D,GAAG,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,GAAG,OAAO;IAIzC,iBAAiB,IAAI,IAAI;IAInB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAiB9B;;;;;;;;;;;;;;;OAeG;IACG,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAWnC;;;;;;OAMG;IACH,qBAAqB,IAAI,KAAK,CAAC;QAAE,IAAI,EAAE,WAAW,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAejE,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAajC,OAAO,CAAC,WAAW;IA6BnB,OAAO,CAAC,WAAW;CAYpB;AAcD,wBAAgB,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;AACnD,wBAAgB,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,CAAC,CAAA;AAK3C,wBAAgB,cAAc,CAAC,CAAC,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,IAAI,CAAA;AAClE,wBAAgB,cAAc,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,CAAA;AAM1D,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAQ7E"}

package/dist/di-container.js

@@ -0,0 +1,177 @@
+export class Container {
+    /** @internal */
+    static activeContainer = null;
+    registry = new Map();
+    requestInstances = new Map();
+    resolving = new Set();
+    register(token, factory, scope = 'singleton') {
+        this.registry.set(token, { factory, scope });
+    }
+    registerClass(cls, scope = 'singleton') {
+        this.registry.set(cls, {
+            factory: () => new cls(),
+            scope,
+        });
+    }
+    resolve(token) {
+        const entry = this.registry.get(token);
+        if (!entry) {
+            throw new Error(`[Miia] No provider found for token: ${String(token)}`);
+        }
+        return this.instantiate(token, entry);
+    }
+    resolveOptional(token) {
+        const entry = this.registry.get(token);
+        if (!entry)
+            return null;
+        return this.instantiate(token, entry);
+    }
+    has(token) {
+        return this.registry.has(token);
+    }
+    clearRequestScope() {
+        if (this.requestInstances.size > 0)
+            this.requestInstances.clear();
+    }
+    async initAll() {
+        // Phase 1: instantiate all singletons (runs all factories)
+        const singletons = [];
+        for (const [token, entry] of this.registry) {
+            if (entry.scope === 'singleton') {
+                singletons.push(this.instantiate(token, entry));
+            }
+        }
+        // Phase 2: lifecycle hooks
+        for (const instance of singletons) {
+            const onInit = instance?.onInit;
+            if (typeof onInit === 'function') {
+                await onInit.call(instance);
+            }
+        }
+    }
+    /**
+     * Phase 3 of init: invoke onReady() on all singletons that define it.
+     * Called by Miia.doInit() after initAll() and compilePipelines().
+     *
+     * Guarantees:
+     * - By the time any onReady() runs, all onInit() hooks have completed.
+     *
+     * Caveats:
+     * - Order of onReady() calls is registration order (same as initAll()).
+     *   Avoid inter-onReady dependencies - if provider A's onReady() relies on
+     *   provider B's onReady() having run first, the result is order-fragile.
+     * - Lazy-registered providers (e.g. global guards added via app.useGuard()
+     *   after initAll() - see compilePipelines() in app.ts) will receive
+     *   onReady() but may not have received onInit(). This mirrors the existing
+     *   pre-existing quirk with onDestroy() and is not introduced by this change.
+     */
+    async bootstrapAll() {
+        for (const [, entry] of this.registry) {
+            if (entry.scope === 'singleton' && entry.instance) {
+                const onReady = entry.instance.onReady;
+                if (typeof onReady === 'function') {
+                    await onReady.call(entry.instance);
+                }
+            }
+        }
+    }
+    /**
+     * Returns all singleton instances currently registered in the container.
+     * Filters out string-token registrations (only class-keyed entries) and
+     * entries that have not yet been instantiated.
+     *
+     * Used by DiscoveryService for ambient method-decorator discovery.
+     */
+    getSingletonInstances() {
+        const result = [];
+        for (const [token, entry] of this.registry) {
+            if (entry.scope === 'singleton' &&
+                typeof entry.instance === 'object' &&
+                entry.instance !== null &&
+                typeof token === 'function') {
+                result.push({ ctor: token, instance: entry.instance });
+            }
+        }
+        return result;
+    }
+    async destroyAll() {
+        for (const [, entry] of this.registry) {
+            if (entry.scope === 'singleton' && entry.instance) {
+                const onDestroy = entry.instance.onDestroy;
+                if (typeof onDestroy === 'function') {
+                    await onDestroy.call(entry.instance);
+                }
+            }
+        }
+        this.registry.clear();
+        this.requestInstances.clear();
+    }
+    instantiate(token, entry) {
+        if (entry.scope === 'singleton' && entry.instance !== undefined)
+            return entry.instance;
+        if (this.resolving.has(token)) {
+            throw new Error(`[Miia] Circular dependency detected: ${String(token)}`);
+        }
+        this.resolving.add(token);
+        try {
+            if (entry.scope === 'singleton') {
+                const instance = this.callFactory(entry);
+                entry.instance = instance;
+                return instance;
+            }
+            if (entry.scope === 'request') {
+                const cached = this.requestInstances.get(token);
+                if (cached !== undefined)
+                    return cached;
+                const instance = this.callFactory(entry);
+                this.requestInstances.set(token, instance);
+                return instance;
+            }
+            // transient - always new
+            return this.callFactory(entry);
+        }
+        finally {
+            this.resolving.delete(token);
+        }
+    }
+    callFactory(entry) {
+        const prev = Container.activeContainer;
+        Container.activeContainer = this;
+        try {
+            const fn = entry.factory;
+            if (fn.length === 0)
+                return fn();
+            const resolve = (t) => this.resolve(t);
+            return fn(resolve);
+        }
+        finally {
+            Container.activeContainer = prev;
+        }
+    }
+}
+// ─── inject / injectOptional ─────────────────────────────────────
+function getActiveContainer() {
+    if (!Container.activeContainer) {
+        throw new Error('[Miia] inject() called outside of container context. ' +
+            'Ensure inject() is used inside a class field initializer or factory function within the DI system.');
+    }
+    return Container.activeContainer;
+}
+export function inject(token) {
+    return getActiveContainer().resolve(token);
+}
+export function injectOptional(token) {
+    return getActiveContainer().resolveOptional(token);
+}
+// ─── runInContainerContext ───────────────────────────────────────
+export function runInContainerContext(container, fn) {
+    const prev = Container.activeContainer;
+    Container.activeContainer = container;
+    try {
+        return fn();
+    }
+    finally {
+        Container.activeContainer = prev;
+    }
+}
+//# sourceMappingURL=di-container.js.map

package/dist/di-container.js.map

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

package/dist/discovery/discovery-service.d.ts

@@ -0,0 +1,63 @@
+import type { Container } from '../di-container.js';
+import type { Constructor } from '../types.js';
+/**
+ * Base shape that discoverable method-decorator metadata must satisfy.
+ * Decorators should push items like `{ handlerName: ctx.name as string, ...userData }`
+ * into metadata so that DiscoveryService can bind them back to their method.
+ */
+export interface DiscoverableMethodMeta {
+    handlerName: string;
+}
+export interface DiscoveredMethod<T extends DiscoverableMethodMeta> {
+    instance: object;
+    ctor: Constructor;
+    methodName: string;
+    metadata: T;
+}
+/**
+ * Public facade over Container for ambient discovery of singleton instances
+ * and their method-level metadata. Auto-registered by Miia in its constructor.
+ *
+ * Use inside `onReady()` (not `onInit()`) to guarantee all providers have
+ * finished their own initialization before scanning.
+ *
+ * @example
+ * ```ts
+ * const ON = Symbol('on')
+ * export const On = createMethodDecorator<[event: string]>((_target, ctx, event) => {
+ *   pushMeta(ctx.metadata!, ON, { event, handlerName: ctx.name as string })
+ * })
+ *
+ * @Injectable()
+ * class EventBus {
+ *   private discovery = inject(DiscoveryService)
+ *   private handlers = new Map<string, Function[]>()
+ *
+ *   async onReady() {
+ *     for (const { instance, methodName, metadata } of
+ *          this.discovery.getMethodsWithMeta<{ event: string; handlerName: string }>(ON)) {
+ *       const list = this.handlers.get(metadata.event) ?? []
+ *       list.push((instance as any)[methodName].bind(instance))
+ *       this.handlers.set(metadata.event, list)
+ *     }
+ *   }
+ * }
+ * ```
+ */
+export declare class DiscoveryService {
+    private readonly container;
+    constructor(container: Container);
+    /** All singleton instances currently in the container (providers + controllers + guards). */
+    getSingletons(): Array<{
+        ctor: Constructor;
+        instance: object;
+    }>;
+    /**
+     * Scans every singleton for the given metadata key. The metadata under
+     * `key` must be an array of objects each containing `handlerName: string`.
+     *
+     * Returns one entry per discovered method, ready for binding.
+     */
+    getMethodsWithMeta<T extends DiscoverableMethodMeta>(key: symbol): DiscoveredMethod<T>[];
+}
+//# sourceMappingURL=discovery-service.d.ts.map

package/dist/discovery/discovery-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery-service.d.ts","sourceRoot":"","sources":["../../src/discovery/discovery-service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAE9C;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,gBAAgB,CAAC,CAAC,SAAS,sBAAsB;IAChE,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,WAAW,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,CAAC,CAAA;CACZ;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,qBAAa,gBAAgB;IACf,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAAT,SAAS,EAAE,SAAS;IAEjD,6FAA6F;IAC7F,aAAa,IAAI,KAAK,CAAC;QAAE,IAAI,EAAE,WAAW,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAI/D;;;;;OAKG;IACH,kBAAkB,CAAC,CAAC,SAAS,sBAAsB,EAAE,GAAG,EAAE,MAAM,GAAG,gBAAgB,CAAC,CAAC,CAAC,EAAE;CAgBzF"}

package/dist/discovery/discovery-service.js

@@ -0,0 +1,65 @@
+import { getMeta } from '../decorators/metadata.js';
+/**
+ * Public facade over Container for ambient discovery of singleton instances
+ * and their method-level metadata. Auto-registered by Miia in its constructor.
+ *
+ * Use inside `onReady()` (not `onInit()`) to guarantee all providers have
+ * finished their own initialization before scanning.
+ *
+ * @example
+ * ```ts
+ * const ON = Symbol('on')
+ * export const On = createMethodDecorator<[event: string]>((_target, ctx, event) => {
+ *   pushMeta(ctx.metadata!, ON, { event, handlerName: ctx.name as string })
+ * })
+ *
+ * @Injectable()
+ * class EventBus {
+ *   private discovery = inject(DiscoveryService)
+ *   private handlers = new Map<string, Function[]>()
+ *
+ *   async onReady() {
+ *     for (const { instance, methodName, metadata } of
+ *          this.discovery.getMethodsWithMeta<{ event: string; handlerName: string }>(ON)) {
+ *       const list = this.handlers.get(metadata.event) ?? []
+ *       list.push((instance as any)[methodName].bind(instance))
+ *       this.handlers.set(metadata.event, list)
+ *     }
+ *   }
+ * }
+ * ```
+ */
+export class DiscoveryService {
+    container;
+    constructor(container) {
+        this.container = container;
+    }
+    /** All singleton instances currently in the container (providers + controllers + guards). */
+    getSingletons() {
+        return this.container.getSingletonInstances();
+    }
+    /**
+     * Scans every singleton for the given metadata key. The metadata under
+     * `key` must be an array of objects each containing `handlerName: string`.
+     *
+     * Returns one entry per discovered method, ready for binding.
+     */
+    getMethodsWithMeta(key) {
+        const result = [];
+        for (const { ctor, instance } of this.container.getSingletonInstances()) {
+            const items = getMeta(ctor, key);
+            if (!items || items.length === 0)
+                continue;
+            for (const metadata of items) {
+                result.push({
+                    instance,
+                    ctor,
+                    methodName: metadata.handlerName,
+                    metadata,
+                });
+            }
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=discovery-service.js.map

package/dist/discovery/discovery-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery-service.js","sourceRoot":"","sources":["../../src/discovery/discovery-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAA;AAoBnD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,OAAO,gBAAgB;IACE;IAA7B,YAA6B,SAAoB;QAApB,cAAS,GAAT,SAAS,CAAW;IAAG,CAAC;IAErD,6FAA6F;IAC7F,aAAa;QACX,OAAO,IAAI,CAAC,SAAS,CAAC,qBAAqB,EAAE,CAAA;IAC/C,CAAC;IAED;;;;;OAKG;IACH,kBAAkB,CAAmC,GAAW;QAC9D,MAAM,MAAM,GAA0B,EAAE,CAAA;QACxC,KAAK,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,IAAI,CAAC,SAAS,CAAC,qBAAqB,EAAE,EAAE,CAAC;YACxE,MAAM,KAAK,GAAG,OAAO,CAAM,IAAI,EAAE,GAAG,CAAC,CAAA;YACrC,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;gBAAE,SAAQ;YAC1C,KAAK,MAAM,QAAQ,IAAI,KAAK,EAAE,CAAC;gBAC7B,MAAM,CAAC,IAAI,CAAC;oBACV,QAAQ;oBACR,IAAI;oBACJ,UAAU,EAAE,QAAQ,CAAC,WAAW;oBAChC,QAAQ;iBACT,CAAC,CAAA;YACJ,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAA;IACf,CAAC;CACF"}

package/dist/discovery/index.d.ts

@@ -0,0 +1,3 @@
+export { DiscoveryService } from './discovery-service.js';
+export type { DiscoveredMethod, DiscoverableMethodMeta } from './discovery-service.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/discovery/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/discovery/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AACzD,YAAY,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAA"}

package/dist/discovery/index.js

@@ -0,0 +1,2 @@
+export { DiscoveryService } from './discovery-service.js';
+//# sourceMappingURL=index.js.map

package/dist/discovery/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/discovery/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA"}

package/dist/exceptions.d.ts

@@ -0,0 +1,28 @@
+export declare class HttpException extends Error {
+    statusCode: number;
+    details?: unknown | undefined;
+    constructor(statusCode: number, message: string, details?: unknown | undefined);
+    toJSON(): Record<string, unknown>;
+}
+export declare class BadRequestException extends HttpException {
+    constructor(message?: string, details?: unknown);
+}
+export declare class UnauthorizedException extends HttpException {
+    constructor(message?: string, details?: unknown);
+}
+export declare class ForbiddenException extends HttpException {
+    constructor(message?: string, details?: unknown);
+}
+export declare class NotFoundException extends HttpException {
+    constructor(message?: string, details?: unknown);
+}
+export declare class ConflictException extends HttpException {
+    constructor(message?: string, details?: unknown);
+}
+export declare class UnprocessableException extends HttpException {
+    constructor(message?: string, details?: unknown);
+}
+export declare class InternalServerException extends HttpException {
+    constructor(message?: string, details?: unknown);
+}
+//# sourceMappingURL=exceptions.d.ts.map

package/dist/exceptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exceptions.d.ts","sourceRoot":"","sources":["../src/exceptions.ts"],"names":[],"mappings":"AAcA,qBAAa,aAAc,SAAQ,KAAK;IAE7B,UAAU,EAAE,MAAM;IAElB,OAAO,CAAC,EAAE,OAAO;gBAFjB,UAAU,EAAE,MAAM,EACzB,OAAO,EAAE,MAAM,EACR,OAAO,CAAC,EAAE,OAAO,YAAA;IAM1B,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAQlC;AAED,qBAAa,mBAAoB,SAAQ,aAAa;gBACxC,OAAO,SAAgB,EAAE,OAAO,CAAC,EAAE,OAAO;CAGvD;AAED,qBAAa,qBAAsB,SAAQ,aAAa;gBAC1C,OAAO,SAAiB,EAAE,OAAO,CAAC,EAAE,OAAO;CAGxD;AAED,qBAAa,kBAAmB,SAAQ,aAAa;gBACvC,OAAO,SAAc,EAAE,OAAO,CAAC,EAAE,OAAO;CAGrD;AAED,qBAAa,iBAAkB,SAAQ,aAAa;gBACtC,OAAO,SAAc,EAAE,OAAO,CAAC,EAAE,OAAO;CAGrD;AAED,qBAAa,iBAAkB,SAAQ,aAAa;gBACtC,OAAO,SAAa,EAAE,OAAO,CAAC,EAAE,OAAO;CAGpD;AAED,qBAAa,sBAAuB,SAAQ,aAAa;gBAC3C,OAAO,SAAyB,EAAE,OAAO,CAAC,EAAE,OAAO;CAGhE;AAED,qBAAa,uBAAwB,SAAQ,aAAa;gBAC5C,OAAO,SAA0B,EAAE,OAAO,CAAC,EAAE,OAAO;CAGjE"}