stratal 0.0.13 → 0.0.15

package/dist/events/event-registry.js

@@ -1,156 +0,0 @@
-var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
-    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
-    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
-    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
-    return c > 3 && r && Object.defineProperty(target, key, r), r;
-};
-var __metadata = (this && this.__metadata) || function (k, v) {
-    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
-};
-var __param = (this && this.__param) || function (paramIndex, decorator) {
-    return function (target, key) { decorator(target, key, paramIndex); }
-};
-import { inject } from 'tsyringe';
-import { Transient } from '../di/decorators';
-import { DI_TOKENS } from '../di/tokens';
-import { LOGGER_TOKENS } from '../logger';
-let EventRegistry = class EventRegistry {
-    ctx;
-    logger;
-    handlers = new Map();
-    constructor(ctx, logger) {
-        this.ctx = ctx;
-        this.logger = logger;
-    }
-    on(event, handler, options) {
-        const registered = {
-            handler: handler,
-            priority: options?.priority ?? 0,
-            blocking: options?.blocking
-        };
-        const existingHandlers = this.handlers.get(event) ?? [];
-        existingHandlers.push(registered);
-        this.handlers.set(event, existingHandlers);
-        this.logger.debug('Event handler registered', {
-            event,
-            priority: registered.priority,
-            blocking: registered.blocking
-        });
-    }
-    async emit(event, context) {
-        // Build full context with caller-provided fields
-        const fullContext = {
-            ...context
-        };
-        // Find matching handlers using pattern matching
-        const matchingHandlers = this.findMatchingHandlers(event);
-        if (matchingHandlers.length === 0) {
-            return;
-        }
-        // Sort by priority (higher first)
-        const sortedHandlers = [...matchingHandlers].sort((a, b) => b.priority - a.priority);
-        // Determine if we should use waitUntil
-        const shouldUseWaitUntil = this.shouldUseWaitUntil(event, sortedHandlers);
-        // Execute handlers
-        const promises = sortedHandlers.map((registered) => this.executeHandler(registered.handler, fullContext, event));
-        if (shouldUseWaitUntil) {
-            // Non-blocking: use ctx.waitUntil
-            this.ctx.waitUntil(Promise.all(promises));
-        }
-        else {
-            // Blocking: await all handlers
-            await Promise.all(promises);
-        }
-    }
-    off(event, handler) {
-        const existingHandlers = this.handlers.get(event);
-        if (!existingHandlers)
-            return;
-        const filtered = existingHandlers.filter((h) => h.handler !== handler);
-        if (filtered.length > 0) {
-            this.handlers.set(event, filtered);
-        }
-        else {
-            this.handlers.delete(event);
-        }
-        this.logger.debug('Event handler unregistered', { event });
-    }
-    once(event, handler, options) {
-        const wrappedHandler = (async (context) => {
-            await handler(context);
-            this.off(event, wrappedHandler);
-        });
-        this.on(event, wrappedHandler, options);
-    }
-    /**
-     * Find all handlers matching the event using pattern matching.
-     * Order: exact match -> model wildcard -> operation wildcard -> global wildcard
-     */
-    findMatchingHandlers(event) {
-        const handlers = [];
-        const parts = event.split('.');
-        if (parts.length === 3) {
-            // Database event: "phase.model.operation"
-            const [phase, model, operation] = parts;
-            // 1. Exact match: "after.user.create"
-            handlers.push(...(this.handlers.get(event) ?? []));
-            // 2. Model wildcard: "after.user"
-            handlers.push(...(this.handlers.get(`${phase}.${model}`) ?? []));
-            // 3. Operation wildcard: "after.create"
-            handlers.push(...(this.handlers.get(`${phase}.${operation}`) ?? []));
-            // 4. Global wildcard: "after"
-            handlers.push(...(this.handlers.get(phase) ?? []));
-        }
-        else if (parts.length === 2) {
-            // Could be wildcard like "after.user" or custom event like "auth.verified"
-            handlers.push(...(this.handlers.get(event) ?? []));
-            if (parts[0] === 'before' || parts[0] === 'after') {
-                handlers.push(...(this.handlers.get(parts[0]) ?? []));
-            }
-        }
-        else {
-            handlers.push(...(this.handlers.get(event) ?? []));
-        }
-        return handlers;
-    }
-    /**
-     * Determine if we should use ctx.waitUntil (non-blocking) or await (blocking)
-     */
-    shouldUseWaitUntil(event, handlers) {
-        const hasBlockingHandler = handlers.some((h) => h.blocking === true);
-        if (hasBlockingHandler)
-            return false;
-        const hasNonBlockingHandler = handlers.some((h) => h.blocking === false);
-        if (hasNonBlockingHandler)
-            return true;
-        const phase = event.split('.')[0];
-        if (phase === 'before')
-            return false;
-        if (phase === 'after')
-            return true;
-        return false; // Custom events block by default
-    }
-    /**
-     * Execute a single handler with error isolation
-     */
-    async executeHandler(handler, context, event) {
-        try {
-            await handler(context);
-        }
-        catch (error) {
-            this.logger.error('Event handler error', {
-                event,
-                error: error instanceof Error ? error.message : String(error),
-                stack: error instanceof Error ? error.stack : undefined,
-            });
-        }
-    }
-};
-EventRegistry = __decorate([
-    Transient(),
-    __param(0, inject(DI_TOKENS.ExecutionContext)),
-    __param(1, inject(LOGGER_TOKENS.LoggerService)),
-    __metadata("design:paramtypes", [Object, Function])
-], EventRegistry);
-export { EventRegistry };
-//# sourceMappingURL=event-registry.js.map

package/dist/events/event-registry.js.map

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

package/dist/events/index.d.ts

@@ -1,5 +0,0 @@
-export { LISTENER_METADATA_KEYS } from './constants';
-export { Listener, isListener, On, getListenerHandlers } from './decorators';
-export { EventRegistry } from './event-registry';
-export type { CustomEventContext, CustomEventRegistry, EventContext, EventHandler, EventName, EventOptions, IEventRegistry, ListenerHandlerMetadata, RegisteredHandler, } from './types';
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/events/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAA;AACpD,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAC5E,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAChD,YAAY,EACV,kBAAkB,EAClB,mBAAmB,EACnB,YAAY,EACZ,YAAY,EACZ,SAAS,EACT,YAAY,EACZ,cAAc,EACd,uBAAuB,EACvB,iBAAiB,GAClB,MAAM,SAAS,CAAA"}

package/dist/events/index.js

@@ -1,4 +0,0 @@
-export { LISTENER_METADATA_KEYS } from './constants';
-export { Listener, isListener, On, getListenerHandlers } from './decorators';
-export { EventRegistry } from './event-registry';
-//# sourceMappingURL=index.js.map

package/dist/events/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/events/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAA;AACpD,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAC5E,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA"}

package/dist/events/types.d.ts

@@ -1,116 +0,0 @@
-/**
- * Core Event System Types
- *
- * Provides a generic, augmentable event system for Stratal.
- * Core owns the base types; framework's database module augments
- * `CustomEventRegistry` with richly typed database event contexts.
- *
- * ## Custom Events
- *
- * Custom application events can be added via module augmentation:
- *
- * @example
- * ```typescript
- * declare module 'stratal/events' {
- *   interface CustomEventRegistry {
- *     'user.verified': CustomEventContext<{ userId: string; email: string }>
- *     'email.sent': CustomEventContext<{ to: string; subject: string }>
- *   }
- * }
- * ```
- */
-/**
- * Augmentable event registry.
- * Maps event name -> full context type.
- *
- * Framework's database module augments this with `DatabaseEvents`.
- * Users augment for custom events using `CustomEventContext<TData>`.
- *
- * @example
- * ```typescript
- * declare module 'stratal/events' {
- *   interface CustomEventRegistry {
- *     'user.verified': CustomEventContext<{ userId: string; email: string }>
- *   }
- * }
- * ```
- */
-export interface CustomEventRegistry {
-}
-/**
- * All valid event names.
- * Falls back to `string` when no events are registered in CustomEventRegistry.
- */
-export type EventName = keyof CustomEventRegistry extends never ? string : Extract<keyof CustomEventRegistry, string>;
-/**
- * Helper for user-defined custom events.
- *
- * @example
- * ```typescript
- * declare module 'stratal/events' {
- *   interface CustomEventRegistry {
- *     'user.verified': CustomEventContext<{ userId: string; email: string }>
- *   }
- * }
- * ```
- */
-export interface CustomEventContext<TData = unknown> {
-    data: TData;
-    metadata?: Record<string, unknown>;
-}
-/**
- * Event context — looks up the full context type from CustomEventRegistry.
- * For database events, this includes typed data and result from ZenStack schema.
- * Falls back to a generic context shape for unregistered events.
- */
-export type EventContext<E extends EventName = EventName> = E extends keyof CustomEventRegistry ? CustomEventRegistry[E] : {
-    data?: unknown;
-    result?: unknown;
-};
-/**
- * Options for registering event handlers
- */
-export interface EventOptions {
-    /** Handler execution priority. Higher values execute first. @default 0 */
-    priority?: number;
-    /**
-     * Whether to force blocking (await) vs non-blocking (waitUntil) behavior.
-     *
-     * Default behavior:
-     * - `before.*` events: Always blocking (true)
-     * - `after.*` events: Non-blocking via waitUntil (false)
-     * - Custom events: Blocking (true)
-     */
-    blocking?: boolean;
-}
-/**
- * Event handler function signature with typed context
- */
-export type EventHandler<E extends EventName = EventName> = (context: EventContext<E>) => Promise<void> | void;
-/**
- * Internal structure for storing registered handlers
- * @internal
- */
-export interface RegisteredHandler {
-    handler: EventHandler;
-    priority: number;
-    blocking?: boolean;
-}
-/**
- * EventRegistry interface — main API for event system
- */
-export interface IEventRegistry {
-    on<E extends EventName>(event: E, handler: EventHandler<E>, options?: EventOptions): void;
-    emit<E extends EventName>(event: E, context?: Partial<EventContext<E>>): Promise<void>;
-    off<E extends EventName>(event: E, handler: EventHandler<E>): void;
-    once<E extends EventName>(event: E, handler: EventHandler<E>, options?: EventOptions): void;
-}
-/**
- * Metadata stored by `@On()` decorator for each handler method
- */
-export interface ListenerHandlerMetadata {
-    methodName: string;
-    event: string;
-    options?: EventOptions;
-}
-//# sourceMappingURL=types.d.ts.map

package/dist/events/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/events/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAMH;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,mBAAmB;CAAI;AAExC;;;GAGG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,mBAAmB,SAAS,KAAK,GAC3D,MAAM,GACN,OAAO,CAAC,MAAM,mBAAmB,EAAE,MAAM,CAAC,CAAA;AAM9C;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,kBAAkB,CAAC,KAAK,GAAG,OAAO;IACjD,IAAI,EAAE,KAAK,CAAA;IACX,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACnC;AAED;;;;GAIG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,SAAS,GAAG,SAAS,IACtD,CAAC,SAAS,MAAM,mBAAmB,GACjC,mBAAmB,CAAC,CAAC,CAAC,GACtB;IAAE,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,CAAA;AAMxC;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED;;GAEG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,SAAS,GAAG,SAAS,IAAI,CAC1D,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,KACrB,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;AAEzB;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,YAAY,CAAA;IACrB,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,EAAE,CAAC,CAAC,SAAS,SAAS,EACpB,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,EACxB,OAAO,CAAC,EAAE,YAAY,GACrB,IAAI,CAAA;IAEP,IAAI,CAAC,CAAC,SAAS,SAAS,EACtB,KAAK,EAAE,CAAC,EACR,OAAO,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,GACjC,OAAO,CAAC,IAAI,CAAC,CAAA;IAEhB,GAAG,CAAC,CAAC,SAAS,SAAS,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI,CAAA;IAElE,IAAI,CAAC,CAAC,SAAS,SAAS,EACtB,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,EACxB,OAAO,CAAC,EAAE,YAAY,GACrB,IAAI,CAAA;CACR;AAMD;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,YAAY,CAAA;CACvB"}

package/dist/events/types.js

@@ -1,23 +0,0 @@
-/**
- * Core Event System Types
- *
- * Provides a generic, augmentable event system for Stratal.
- * Core owns the base types; framework's database module augments
- * `CustomEventRegistry` with richly typed database event contexts.
- *
- * ## Custom Events
- *
- * Custom application events can be added via module augmentation:
- *
- * @example
- * ```typescript
- * declare module 'stratal/events' {
- *   interface CustomEventRegistry {
- *     'user.verified': CustomEventContext<{ userId: string; email: string }>
- *     'email.sent': CustomEventContext<{ to: string; subject: string }>
- *   }
- * }
- * ```
- */
-export {};
-//# sourceMappingURL=types.js.map

package/dist/events/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/events/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG"}

package/dist/execution-context.d.ts

@@ -1,4 +0,0 @@
-export interface StratalExecutionContext {
-    waitUntil(promise: Promise<unknown>): void;
-}
-//# sourceMappingURL=execution-context.d.ts.map

package/dist/execution-context.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"execution-context.d.ts","sourceRoot":"","sources":["../src/execution-context.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,uBAAuB;IACtC,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI,CAAA;CAC3C"}

package/dist/execution-context.js

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=execution-context.js.map

package/dist/execution-context.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"execution-context.js","sourceRoot":"","sources":["../src/execution-context.ts"],"names":[],"mappings":""}

package/dist/guards/guard-execution.service.d.ts

@@ -1,37 +0,0 @@
-import type { Container } from '../di';
-import type { LoggerService } from '../logger';
-import type { RouterContext } from '../router';
-import type { Guard } from './types';
-/**
- * Guard Execution Service
- *
- * Executes guards for a route and determines if the request should proceed.
- * Guards are executed in order; all must pass for the request to proceed.
- */
-export declare class GuardExecutionService {
-    private readonly logger;
-    constructor(logger: LoggerService);
-    /**
-     * Execute all guards for a route
-     *
-     * @param guards - Array of guards (classes or instances)
-     * @param context - Router context
-     * @param container - Request-scoped DI container
-     * @returns true if all guards pass
-     * @throws Error from first failing guard
-     */
-    executeGuards(guards: Guard[], context: RouterContext, container: Container): Promise<boolean>;
-    /**
-     * Resolve a guard to an instance
-     *
-     * @param guard - Guard class or instance
-     * @param container - Request-scoped DI container
-     * @returns Guard instance
-     */
-    private resolveGuard;
-    /**
-     * Type guard to check if value is a guard instance
-     */
-    private isGuardInstance;
-}
-//# sourceMappingURL=guard-execution.service.d.ts.map

package/dist/guards/guard-execution.service.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"guard-execution.service.d.ts","sourceRoot":"","sources":["../../src/guards/guard-execution.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AACtC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AAC9C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AAC9C,OAAO,KAAK,EAAe,KAAK,EAAE,MAAM,SAAS,CAAA;AAEjD;;;;;GAKG;AACH,qBAAa,qBAAqB;IACpB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,aAAa;IAElD;;;;;;;;OAQG;IACG,aAAa,CACjB,MAAM,EAAE,KAAK,EAAE,EACf,OAAO,EAAE,aAAa,EACtB,SAAS,EAAE,SAAS,GACnB,OAAO,CAAC,OAAO,CAAC;IAiCnB;;;;;;OAMG;IACH,OAAO,CAAC,YAAY;IAUpB;;OAEG;IACH,OAAO,CAAC,eAAe;CASxB"}

package/dist/guards/guard-execution.service.js

@@ -1,74 +0,0 @@
-/**
- * Guard Execution Service
- *
- * Executes guards for a route and determines if the request should proceed.
- * Guards are executed in order; all must pass for the request to proceed.
- */
-export class GuardExecutionService {
-    logger;
-    constructor(logger) {
-        this.logger = logger;
-    }
-    /**
-     * Execute all guards for a route
-     *
-     * @param guards - Array of guards (classes or instances)
-     * @param context - Router context
-     * @param container - Request-scoped DI container
-     * @returns true if all guards pass
-     * @throws Error from first failing guard
-     */
-    async executeGuards(guards, context, container) {
-        if (guards.length === 0) {
-            return true;
-        }
-        this.logger.debug('Executing guards', {
-            guardCount: guards.length,
-            path: context.c.req.path,
-            method: context.c.req.method,
-        });
-        for (const guard of guards) {
-            const guardInstance = this.resolveGuard(guard, container);
-            const canActivate = await guardInstance.canActivate(context);
-            if (!canActivate) {
-                this.logger.debug('Guard denied access', {
-                    // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- guard.constructor may be null at runtime
-                    guard: guard.constructor?.name || 'AnonymousGuard',
-                    path: context.c.req.path,
-                });
-                return false;
-            }
-        }
-        this.logger.debug('All guards passed', {
-            guardCount: guards.length,
-            path: context.c.req.path,
-        });
-        return true;
-    }
-    /**
-     * Resolve a guard to an instance
-     *
-     * @param guard - Guard class or instance
-     * @param container - Request-scoped DI container
-     * @returns Guard instance
-     */
-    resolveGuard(guard, container) {
-        // If already an instance (has canActivate method), use directly
-        if (this.isGuardInstance(guard)) {
-            return guard;
-        }
-        // Otherwise, resolve from container
-        return container.resolve(guard);
-    }
-    /**
-     * Type guard to check if value is a guard instance
-     */
-    isGuardInstance(guard) {
-        return (typeof guard === 'object' &&
-            // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- typeof null === 'object', null check is required
-            guard !== null &&
-            'canActivate' in guard &&
-            typeof guard.canActivate === 'function');
-    }
-}
-//# sourceMappingURL=guard-execution.service.js.map

package/dist/guards/guard-execution.service.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"guard-execution.service.js","sourceRoot":"","sources":["../../src/guards/guard-execution.service.ts"],"names":[],"mappings":"AAKA;;;;;GAKG;AACH,MAAM,OAAO,qBAAqB;IACH;IAA7B,YAA6B,MAAqB;QAArB,WAAM,GAAN,MAAM,CAAe;IAAI,CAAC;IAEvD;;;;;;;;OAQG;IACH,KAAK,CAAC,aAAa,CACjB,MAAe,EACf,OAAsB,EACtB,SAAoB;QAEpB,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,OAAO,IAAI,CAAA;QACb,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,kBAAkB,EAAE;YACpC,UAAU,EAAE,MAAM,CAAC,MAAM;YACzB,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI;YACxB,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM;SAC7B,CAAC,CAAA;QAEF,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,MAAM,aAAa,GAAG,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,SAAS,CAAC,CAAA;YACzD,MAAM,WAAW,GAAG,MAAM,aAAa,CAAC,WAAW,CAAC,OAAO,CAAC,CAAA;YAE5D,IAAI,CAAC,WAAW,EAAE,CAAC;gBACjB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,qBAAqB,EAAE;oBACvC,mHAAmH;oBACnH,KAAK,EAAE,KAAK,CAAC,WAAW,EAAE,IAAI,IAAI,gBAAgB;oBAClD,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI;iBACzB,CAAC,CAAA;gBACF,OAAO,KAAK,CAAA;YACd,CAAC;QACH,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,mBAAmB,EAAE;YACrC,UAAU,EAAE,MAAM,CAAC,MAAM;YACzB,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI;SACzB,CAAC,CAAA;QAEF,OAAO,IAAI,CAAA;IACb,CAAC;IAED;;;;;;OAMG;IACK,YAAY,CAAC,KAAY,EAAE,SAAoB;QACrD,gEAAgE;QAChE,IAAI,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC;YAChC,OAAO,KAAK,CAAA;QACd,CAAC;QAED,oCAAoC;QACpC,OAAO,SAAS,CAAC,OAAO,CAAc,KAAK,CAAC,CAAA;IAC9C,CAAC;IAED;;OAEG;IACK,eAAe,CAAC,KAAY;QAClC,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;YACzB,2HAA2H;YAC3H,KAAK,KAAK,IAAI;YACd,aAAa,IAAI,KAAK;YACtB,OAAO,KAAK,CAAC,WAAW,KAAK,UAAU,CACxC,CAAA;IACH,CAAC;CACF"}

package/dist/guards/index.d.ts

@@ -1,12 +0,0 @@
-/**
- * Guard utilities for route protection
- *
- * This module provides:
- * - Guard types and interfaces
- * - UseGuards decorator for applying guards to controllers/methods
- * - GuardExecutionService for executing guards
- */
-export * from './types';
-export * from './use-guards.decorator';
-export { GuardExecutionService } from './guard-execution.service';
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/guards/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,cAAc,SAAS,CAAA;AACvB,cAAc,wBAAwB,CAAA;AACtC,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAA"}

package/dist/guards/index.js

@@ -1,12 +0,0 @@
-/**
- * Guard utilities for route protection
- *
- * This module provides:
- * - Guard types and interfaces
- * - UseGuards decorator for applying guards to controllers/methods
- * - GuardExecutionService for executing guards
- */
-export * from './types';
-export * from './use-guards.decorator';
-export { GuardExecutionService } from './guard-execution.service';
-//# sourceMappingURL=index.js.map

package/dist/guards/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/guards/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,cAAc,SAAS,CAAA;AACvB,cAAc,wBAAwB,CAAA;AACtC,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAA"}

package/dist/guards/types.d.ts

@@ -1,60 +0,0 @@
-import type { RouterContext } from '../router';
-import type { Constructor } from '../types';
-/**
- * Interface for guards that control access to routes
- *
- * Guards are executed after middlewares but before route handlers.
- * They determine if a request should be allowed to proceed.
- *
- * @example
- * ```typescript
- * class RoleGuard implements CanActivate {
- *   constructor(private readonly role: string) {}
- *
- *   async canActivate(context: RouterContext): Promise<boolean> {
- *     const user = context.getUser()
- *     return user?.roles.includes(this.role) ?? false
- *   }
- * }
- * ```
- */
-export interface CanActivate {
-    /**
-     * Determine if the request should be allowed
-     *
-     * @param context - Router context with request/response helpers
-     * @returns true to allow, false to deny (throws 403)
-     */
-    canActivate(context: RouterContext): boolean | Promise<boolean>;
-}
-/**
- * Type for guard class constructors
- */
-export type GuardClass = Constructor<CanActivate>;
-/**
- * Guard can be a class constructor or an instance
- * Instances are used for factory-created guards with configuration
- */
-export type Guard = GuardClass | CanActivate;
-/**
- * Options for AuthGuard factory
- */
-export interface AuthGuardOptions {
-    /**
-     * Required permissions (scopes) for authorization
-     * If provided, permission check is performed after authentication.
-     * If omitted, only authentication is required.
-     */
-    scopes?: string[];
-}
-/**
- * Metadata stored by `@UseGuards` decorator
- */
-export interface GuardMetadata {
-    guards: Guard[];
-}
-/**
- * Metadata key for guard storage
- */
-export declare const GUARD_METADATA_KEY: unique symbol;
-//# sourceMappingURL=types.d.ts.map

package/dist/guards/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/guards/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AAC9C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AAE3C;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;;OAKG;IACH,WAAW,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;CAChE;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,WAAW,CAAC,WAAW,CAAC,CAAA;AAEjD;;;GAGG;AACH,MAAM,MAAM,KAAK,GAAG,UAAU,GAAG,WAAW,CAAA;AAE5C;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,KAAK,EAAE,CAAA;CAChB;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB,eAA+B,CAAA"}

package/dist/guards/types.js

@@ -1,5 +0,0 @@
-/**
- * Metadata key for guard storage
- */
-export const GUARD_METADATA_KEY = Symbol.for('stratal:guards');
-//# sourceMappingURL=types.js.map

package/dist/guards/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/guards/types.ts"],"names":[],"mappings":"AA6DA;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAA"}

package/dist/guards/use-guards.decorator.d.ts

@@ -1,73 +0,0 @@
-import { type Guard, type GuardMetadata } from './types';
-/**
- * UseGuards Decorator
- *
- * Applies one or more guards to a controller or method.
- * Guards are executed in order and all must pass for the request to proceed.
- *
- * **Execution Order:**
- * 1. Request → Global Middlewares → Route Middlewares
- * 2. **Guards (controller-level, then method-level)**
- * 3. Route Handler
- *
- * **Guard Resolution:**
- * - Guard classes are resolved from the request-scoped DI container
- * - Guard instances (from factory functions) are used directly
- *
- * @param guards - Guard classes or instances to apply
- *
- * @example Authentication only
- * ```typescript
- * @Controller('/api/v1/profile')
- * @UseGuards(AuthGuard())
- * export class ProfileController {
- *   show() { } // Requires authentication
- * }
- * ```
- *
- * @example Authentication with permissions
- * ```typescript
- * @Controller('/api/v1/students')
- * @UseGuards(AuthGuard({ scopes: ['students:read'] }))
- * export class StudentsController {
- *   index() { } // Requires 'students:read' permission
- * }
- * ```
- *
- * @example Method-level guards
- * ```typescript
- * @Controller('/api/v1/students')
- * @UseGuards(AuthGuard()) // Controller-level: auth only
- * export class StudentsController {
- *   index() { } // Auth only (inherited)
- *
- *   @UseGuards(AuthGuard({ scopes: ['students:create'] }))
- *   create() { } // Auth + 'students:create' permission
- * }
- * ```
- *
- * @example Multiple guards
- * ```typescript
- * @UseGuards(AuthGuard(), RateLimitGuard(), CustomGuard())
- * export class SecureController {
- *   // All guards must pass
- * }
- * ```
- */
-export declare function UseGuards(...guards: Guard[]): ClassDecorator & MethodDecorator;
-/**
- * Get controller-level guard metadata
- *
- * @param target - Controller class
- * @returns Guard metadata or undefined if not decorated
- */
-export declare function getControllerGuards(target: object): GuardMetadata | undefined;
-/**
- * Get method-level guard metadata
- *
- * @param target - Controller prototype
- * @param propertyKey - Method name
- * @returns Guard metadata or undefined if not decorated
- */
-export declare function getMethodGuards(target: object, propertyKey: string | symbol): GuardMetadata | undefined;
-//# sourceMappingURL=use-guards.decorator.d.ts.map