stratal 0.0.1

package/dist/router/services/route-registration.service.js

@@ -0,0 +1,451 @@
+import { getMethodInjections } from '../../di';
+import { getControllerGuards, getMethodGuards, GuardExecutionService, } from '../../guards';
+import { createRoute } from '../../i18n/validation';
+import { HTTP_METHODS, METHOD_STATUS_CODES, SECURITY_SCHEMES } from '../constants';
+import { getControllerOptions, getControllerRoute, getDecoratedMethods, getRouteConfig } from '../decorators';
+import { ControllerMethodNotFoundError, ControllerRegistrationError, OpenAPIRouteRegistrationError, } from '../errors';
+import { RouterContext } from '../router-context';
+import { commonErrorSchemas } from '../schemas/common.schemas';
+/**
+ * Route registration service
+ * Manages controller and route registration with OpenAPI support
+ *
+ * Responsibilities:
+ * - Register RESTful controllers with OpenAPI metadata
+ * - Auto-derive HTTP methods/paths from controller method names
+ * - Build OpenAPI route configurations with guard execution
+ * - Validate all controllers have access decorators (strict mode)
+ * - Create controller handlers with DI resolution
+ */
+export class RouteRegistrationService {
+    logger;
+    controllerClasses = new Map();
+    constructor(logger) {
+        this.logger = logger;
+    }
+    /**
+     * Configure router with controllers
+     *
+     * @param app - OpenAPIHono application instance
+     * @param controllers - Array of controller classes from modules
+     */
+    configure(app, controllers) {
+        this.logger.info('Registering controllers', {
+            controllerCount: controllers.length,
+        });
+        // Sort controllers: specific routes first, wildcard handlers last
+        // This ensures more specific routes are matched before catch-all wildcards
+        // (e.g., /api/v1/auth/magic-link matches before /api/v1/auth/:path{.+})
+        const sortedControllers = [...controllers].sort((a, b) => {
+            const aHasHandle = 'handle' in a.prototype;
+            const bHasHandle = 'handle' in b.prototype;
+            if (aHasHandle && !bHasHandle)
+                return 1; // a goes after b
+            if (!aHasHandle && bHasHandle)
+                return -1; // a goes before b
+            return 0; // maintain relative order
+        });
+        // Register controllers
+        for (const ControllerClass of sortedControllers) {
+            this.registerController(app, ControllerClass);
+        }
+        this.logger.info('Controller registration complete');
+    }
+    /**
+     * Register a single controller with all its routes
+     * Validates that controller has access decorator (strict mode)
+     */
+    registerController(app, ControllerClass) {
+        const route = getControllerRoute(ControllerClass);
+        if (!route) {
+            throw new ControllerRegistrationError(ControllerClass.name, 'Missing @Controller decorator or route metadata');
+        }
+        const className = ControllerClass.name;
+        this.controllerClasses.set(className, ControllerClass);
+        const prototype = ControllerClass.prototype;
+        const controllerOpts = getControllerOptions(ControllerClass);
+        // Handle wildcard routes (non-RESTful controllers)
+        if (prototype.handle) {
+            this.registerWildcardRoute(app, ControllerClass, route);
+            return;
+        }
+        // Check for OpenAPI decorated methods
+        const decoratedMethods = getDecoratedMethods(ControllerClass);
+        if (decoratedMethods.length > 0) {
+            // Register OpenAPI routes
+            this.registerOpenAPIRoutes(app, ControllerClass, route, decoratedMethods, controllerOpts);
+        }
+        else {
+            // Fallback to traditional RESTful method registration (no OpenAPI)
+            this.registerRESTfulRoutes(app, ControllerClass, route, prototype);
+        }
+    }
+    /**
+     * Create a guard execution middleware
+     *
+     * This middleware executes all guards for a route before the handler.
+     * Guards are executed in order; all must pass for the request to proceed.
+     *
+     * @param guards - Array of guards to execute
+     * @returns Hono middleware function
+     */
+    createGuardMiddleware(guards) {
+        const guardService = new GuardExecutionService(this.logger);
+        return async (c, next) => {
+            const ctx = new RouterContext(c);
+            const container = ctx.getContainer();
+            // Execute all guards - throws on failure
+            await guardService.executeGuards(guards, ctx, container);
+            // All guards passed, continue to handler
+            await next();
+        };
+    }
+    /**
+     * Register wildcard route for non-RESTful controllers
+     */
+    registerWildcardRoute(app, ControllerClass, route) {
+        this.logger.info(`Registering wildcard route`, {
+            controller: ControllerClass.name,
+            route: `${route}/:path{.+}`,
+            method: 'ALL',
+        });
+        const handler = this.createControllerHandler(ControllerClass, 'handle');
+        // Match base route exactly
+        app.all(route, handler);
+        // Match all sub-paths using named regex wildcard
+        app.all(`${route}/:path{.+}`, handler);
+    }
+    /**
+     * Register OpenAPI routes with metadata
+     */
+    registerOpenAPIRoutes(app, ControllerClass, route, decoratedMethods, controllerOpts) {
+        const className = ControllerClass.name;
+        const prototype = ControllerClass.prototype;
+        // Check if entire controller is hidden from docs
+        const controllerHidden = controllerOpts?.hideFromDocs ?? false;
+        // Collect controller-level guards
+        const controllerGuards = getControllerGuards(ControllerClass)?.guards ?? [];
+        for (const methodName of decoratedMethods) {
+            const routeConfig = getRouteConfig(prototype, methodName);
+            if (!routeConfig)
+                continue;
+            const derived = this.deriveHttpMethodAndPath(methodName, route);
+            if (!derived) {
+                this.logger.warn(`Cannot derive HTTP method/path for ${className}.${methodName}`);
+                continue;
+            }
+            // Check if route is hidden (route-level overrides controller-level)
+            const hideFromDocs = routeConfig.hideFromDocs ?? controllerHidden;
+            if (hideFromDocs) {
+                // Register route handler without OpenAPI metadata
+                this.logger.info(`Registering hidden route (no OpenAPI)`, {
+                    controller: className,
+                    method: derived.method.toUpperCase(),
+                    path: derived.path,
+                    methodName,
+                });
+                this.registerRouteWithoutOpenAPI(app, ControllerClass, methodName, derived);
+                continue;
+            }
+            // Collect method-level guards
+            const methodGuards = getMethodGuards(prototype, methodName)?.guards ?? [];
+            // Combine controller and method guards
+            // Controller guards run first, then method guards
+            const allGuards = [...controllerGuards, ...methodGuards];
+            if (allGuards.length > 0) {
+                this.logger.info(`Route guards`, {
+                    controller: className,
+                    method: derived.method.toUpperCase(),
+                    path: derived.path,
+                    methodName,
+                    guardCount: allGuards.length,
+                });
+            }
+            // Build and register OpenAPI route
+            const metadata = this.mergeMetadata(controllerOpts, routeConfig, ControllerClass, methodName);
+            const openApiRoute = this.buildOpenAPIRoute(derived.method, derived.path, routeConfig, metadata, allGuards, methodName);
+            this.logger.info(`Registering OpenAPI route`, {
+                controller: className,
+                method: derived.method.toUpperCase(),
+                path: derived.path,
+                methodName,
+                tags: metadata.tags,
+            });
+            // Register OpenAPI route with handler
+            app.openapi(openApiRoute, async (c) => {
+                const ctx = new RouterContext(c);
+                const requestContainer = ctx.getContainer();
+                const controller = requestContainer.resolve(ControllerClass);
+                const method = controller[methodName];
+                if (typeof method === 'function') {
+                    const injectedArgs = this.resolveMethodInjections(prototype, methodName, requestContainer);
+                    return await method.call(controller, ctx, ...injectedArgs);
+                }
+                throw new ControllerMethodNotFoundError(methodName, className);
+            });
+        }
+    }
+    /**
+     * Register route without OpenAPI metadata (for hidden routes)
+     * Route is functional but won't appear in documentation
+     */
+    registerRouteWithoutOpenAPI(app, ControllerClass, methodName, derived) {
+        // Create handler function
+        const prototype = ControllerClass.prototype;
+        const handler = async (c) => {
+            const ctx = new RouterContext(c);
+            const requestContainer = ctx.getContainer();
+            const controller = requestContainer.resolve(ControllerClass);
+            const method = controller[methodName];
+            if (typeof method === 'function') {
+                const injectedArgs = this.resolveMethodInjections(prototype, methodName, requestContainer);
+                return await method.call(controller, ctx, ...injectedArgs);
+            }
+            throw new ControllerMethodNotFoundError(methodName, ControllerClass.name);
+        };
+        // Register route handler without OpenAPI metadata using type-safe method dispatch
+        // Note: Only common HTTP methods (get, post, put, patch, delete) are supported
+        // For other methods, we fall back to all() which accepts any HTTP method
+        switch (derived.method) {
+            case 'get':
+                app.get(derived.path, handler);
+                break;
+            case 'post':
+                app.post(derived.path, handler);
+                break;
+            case 'put':
+                app.put(derived.path, handler);
+                break;
+            case 'patch':
+                app.patch(derived.path, handler);
+                break;
+            case 'delete':
+                app.delete(derived.path, handler);
+                break;
+            default:
+                // For head, options, trace, or any other method, use all()
+                app.all(derived.path, handler);
+                break;
+        }
+    }
+    /**
+     * Register traditional RESTful routes without OpenAPI
+     */
+    registerRESTfulRoutes(app, ControllerClass, route, prototype) {
+        if (prototype.index) {
+            app.get(route, this.createControllerHandler(ControllerClass, 'index'));
+        }
+        if (prototype.show) {
+            app.get(`${route}/:id`, this.createControllerHandler(ControllerClass, 'show'));
+        }
+        if (prototype.create) {
+            app.post(route, this.createControllerHandler(ControllerClass, 'create'));
+        }
+        if (prototype.update) {
+            app.put(`${route}/:id`, this.createControllerHandler(ControllerClass, 'update'));
+        }
+        if (prototype.patch) {
+            app.patch(`${route}/:id`, this.createControllerHandler(ControllerClass, 'patch'));
+        }
+        if (prototype.destroy) {
+            app.delete(`${route}/:id`, this.createControllerHandler(ControllerClass, 'destroy'));
+        }
+    }
+    /**
+     * Auto-derive HTTP method and path from controller method name
+     * Uses HTTP_METHODS constant for RESTful convention mapping
+     */
+    deriveHttpMethodAndPath(methodName, basePath) {
+        if (!(methodName in HTTP_METHODS))
+            return null;
+        const mapping = HTTP_METHODS[methodName];
+        return {
+            method: mapping.method,
+            path: basePath + mapping.path,
+        };
+    }
+    /**
+     * Merge controller-level and route-level metadata
+     * Tags are merged (appended), security is merged (union)
+     * Guards automatically add sessionCookie security if present
+     */
+    mergeMetadata(controllerOpts, routeConfig, ControllerClass, methodName) {
+        const tags = [...(controllerOpts?.tags ?? []), ...(routeConfig.tags ?? [])];
+        // Check if guards are present (indicates authentication is required)
+        const prototype = ControllerClass.prototype;
+        const hasMethodGuards = (getMethodGuards(prototype, methodName)?.guards.length ?? 0) > 0;
+        const hasControllerGuards = (getControllerGuards(ControllerClass)?.guards.length ?? 0) > 0;
+        const requiresAuth = hasMethodGuards || hasControllerGuards;
+        // Merge security: if route explicitly sets security (even empty array), use it
+        // Otherwise inherit from controller
+        let security = [];
+        if (routeConfig.security !== undefined) {
+            // Route has explicit security (could be empty for public routes)
+            security = [...(controllerOpts?.security ?? []), ...routeConfig.security];
+        }
+        else if (controllerOpts?.security) {
+            // Inherit controller security
+            security = controllerOpts.security;
+        }
+        // Auto-add sessionCookie security if guards are present
+        if (requiresAuth && !security.includes(SECURITY_SCHEMES.SESSION_COOKIE)) {
+            security.push(SECURITY_SCHEMES.SESSION_COOKIE);
+        }
+        // Convert security array to OpenAPI security format
+        const securityArray = security.length > 0
+            ? (security.map((scheme) => ({ [scheme]: [] })))
+            : [];
+        return { tags, security: securityArray };
+    }
+    /**
+     * Build OpenAPI route configuration from metadata
+     * Creates a route definition compatible with @hono/zod-openapi
+     * Includes guard execution for proper access control
+     *
+     * Execution order: Global middlewares → Guards → Handler
+     */
+    buildOpenAPIRoute(method, path, routeConfig, metadata, guards, methodName) {
+        try {
+            const route = {
+                method,
+                path,
+                request: {},
+                responses: {},
+            };
+            // Add guard execution middleware using Hono's built-in middleware property
+            if (guards.length > 0) {
+                route.middleware = [this.createGuardMiddleware(guards)];
+            }
+            // Add request body if defined
+            if (routeConfig.body) {
+                route.request = {
+                    ...route.request,
+                    body: {
+                        content: {
+                            'application/json': {
+                                schema: routeConfig.body,
+                            },
+                        },
+                    },
+                };
+            }
+            // Add query parameters if defined
+            if (routeConfig.query) {
+                route.request = {
+                    ...route.request,
+                    query: routeConfig.query,
+                };
+            }
+            // Add URL parameters if defined
+            if (routeConfig.params) {
+                route.request = {
+                    ...route.request,
+                    params: routeConfig.params,
+                };
+            }
+            // Derive success status code from method name
+            const successStatus = (methodName && METHOD_STATUS_CODES[methodName]) ?? 200;
+            // Build responses object with auto-derived status
+            const responses = {};
+            // Add success response with derived status code
+            const responseDef = routeConfig.response;
+            // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- response may be undefined at runtime
+            if (responseDef) {
+                if (typeof responseDef === 'object' && 'schema' in responseDef) {
+                    responses[successStatus] = {
+                        content: {
+                            'application/json': { schema: responseDef.schema },
+                        },
+                        description: responseDef.description ?? `Response ${successStatus}`,
+                    };
+                }
+                else {
+                    responses[successStatus] = {
+                        content: {
+                            'application/json': { schema: responseDef },
+                        },
+                        description: `Response ${successStatus}`,
+                    };
+                }
+            }
+            // Auto-merge common error schemas (400, 401, 403, 404, 409, 500)
+            // Controllers only need to define success response; error responses are added automatically
+            for (const [statusStr, schema] of Object.entries(commonErrorSchemas)) {
+                const status = parseInt(statusStr);
+                // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- defensive: avoid overwriting success response status
+                responses[status] ??= schema;
+            }
+            route.responses = responses;
+            // Add tags if provided
+            if (metadata.tags.length > 0) {
+                route.tags = metadata.tags;
+            }
+            // Add security if provided
+            if (metadata.security.length > 0) {
+                route.security = metadata.security;
+            }
+            // Add description and summary
+            if (routeConfig.description) {
+                route.description = routeConfig.description;
+            }
+            if (routeConfig.summary) {
+                route.summary = routeConfig.summary;
+            }
+            return createRoute(route);
+        }
+        catch (error) {
+            throw new OpenAPIRouteRegistrationError(path, error instanceof Error ? error.message : String(error));
+        }
+    }
+    /**
+     * Resolve method parameter injections from the container
+     *
+     * @param prototype - Controller prototype
+     * @param methodName - Method name to get injections for
+     * @param container - Request-scoped container
+     * @returns Array of resolved dependencies in parameter order
+     */
+    resolveMethodInjections(prototype, methodName, container) {
+        const injections = getMethodInjections(prototype, methodName);
+        if (!injections.length)
+            return [];
+        return injections.map((inj) => container.resolve(inj.token));
+    }
+    /**
+     * Create controller handler that resolves controller from request-scoped container
+     * This ensures each request gets a fresh controller with request-scoped context
+     */
+    createControllerHandler(ControllerClass, methodName) {
+        return async (c) => {
+            this.logger.info('Handler invoked', {
+                path: c.req.path,
+                method: c.req.method,
+                controller: ControllerClass.name,
+                methodName: methodName,
+            });
+            try {
+                const ctx = new RouterContext(c);
+                const requestContainer = ctx.getContainer();
+                // Resolve controller from request-scoped container
+                // Controller will get request-scoped TenancyContext via DI
+                const controller = requestContainer.resolve(ControllerClass);
+                const method = controller[methodName];
+                if (typeof method === 'function') {
+                    const injectedArgs = this.resolveMethodInjections(ControllerClass.prototype, methodName, requestContainer);
+                    return await method.apply(controller, [ctx, ...injectedArgs]);
+                }
+                throw new ControllerMethodNotFoundError(methodName, ControllerClass.name);
+            }
+            catch (error) {
+                this.logger.error('Error in controller handler', {
+                    controller: ControllerClass.name,
+                    methodName: methodName,
+                    error: error instanceof Error ? error.message : String(error),
+                    stack: error instanceof Error ? error.stack : undefined,
+                });
+                throw error;
+            }
+        };
+    }
+}
+//# sourceMappingURL=route-registration.service.js.map

package/dist/router/services/route-registration.service.js.map

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

package/dist/router/types.d.ts

@@ -0,0 +1,130 @@
+import type { ZodObject, ZodPipe, ZodType, RouteConfig as OpenAPIRouteConfig } from '../i18n/validation';
+import { type StratalEnv } from '../env';
+import type { Container } from '../di';
+import { type HTTP_METHODS, type ROUTER_CONTEXT_KEYS, type SECURITY_SCHEMES } from './constants';
+/**
+ * Route parameter type for OpenAPI
+ * ZodObject or ZodPipe (piped validation)
+ */
+type ZodObjectWithEffect = ZodObject<any> | ZodPipe<any, any>;
+type RouteParameter = ZodObjectWithEffect | undefined;
+/**
+ * Hono context variables with type-safe keys
+ */
+export interface RouterVariables {
+    [ROUTER_CONTEXT_KEYS.REQUEST_CONTAINER]: Container;
+    [ROUTER_CONTEXT_KEYS.LOCALE]?: string;
+}
+/**
+ * Hono environment type for router
+ */
+export interface RouterEnv {
+    Bindings: StratalEnv;
+    Variables: RouterVariables;
+}
+/**
+ * Security scheme identifier type
+ * Matches the keys in SECURITY_SCHEMES constant
+ */
+export type SecurityScheme = typeof SECURITY_SCHEMES[keyof typeof SECURITY_SCHEMES];
+/**
+ * RESTful controller method name type
+ * Derived from HTTP_METHODS constant
+ */
+export type MethodName = keyof typeof HTTP_METHODS;
+/**
+ * HTTP method type from OpenAPI spec
+ */
+export type HttpMethod = 'get' | 'post' | 'put' | 'delete' | 'patch' | 'head' | 'options' | 'trace';
+/**
+ * Security scheme record for OpenAPI security array format
+ * Maps scheme names to scopes (empty array for no scopes)
+ */
+export type SecuritySchemeRecord = Record<SecurityScheme, string[]>;
+/**
+ * Re-export OpenAPI RouteConfig for internal use
+ */
+export type { OpenAPIRouteConfig };
+/**
+ * Single response definition for @Route() decorator
+ * Status code is auto-derived from method name (create->201, others->200)
+ */
+export type RouteResponse = ZodType | {
+    schema: ZodType;
+    description?: string;
+};
+/**
+ * Route configuration for @Route() decorator
+ * Defines OpenAPI metadata for a controller method
+ */
+export interface RouteConfig {
+    /**
+     * Request body schema (for POST, PUT, PATCH)
+     */
+    body?: ZodType;
+    /**
+     * URL parameters schema (e.g., { id: z.string().uuid() })
+     * Must be ZodObject or ZodPipe for OpenAPI compatibility
+     */
+    params?: RouteParameter;
+    /**
+     * Query parameters schema (e.g., pagination, filters)
+     * Must be ZodObject or ZodPipe for OpenAPI compatibility
+     */
+    query?: RouteParameter;
+    /**
+     * Response schema for success case
+     * Status code auto-derived: create()->201, others->200
+     * @example userSchema or { schema: userSchema, description: 'User details' }
+     */
+    response: RouteResponse;
+    /**
+     * OpenAPI tags for grouping endpoints
+     * Merged with controller-level tags
+     */
+    tags?: string[];
+    /**
+     * Security schemes required for this route
+     * Merged with controller-level security
+     * Empty array = public route (no auth)
+     */
+    security?: SecurityScheme[];
+    /**
+     * Human-readable description for OpenAPI docs
+     */
+    description?: string;
+    /**
+     * Detailed summary for OpenAPI docs
+     */
+    summary?: string;
+    /**
+     * Hide this route from OpenAPI documentation
+     * Route remains functional but won't appear in /api/docs or /api/openapi.json
+     * Useful for internal-only endpoints, debug routes, or work-in-progress features
+     */
+    hideFromDocs?: boolean;
+}
+/**
+ * Controller options for @Controller() decorator
+ * Provides default configuration for all routes in the controller
+ */
+export interface ControllerOptions {
+    /**
+     * Default tags applied to all routes in this controller
+     * Routes can append additional tags
+     */
+    tags?: string[];
+    /**
+     * Default security schemes applied to all routes
+     * Routes can add more schemes or override with empty array
+     */
+    security?: SecurityScheme[];
+    /**
+     * Hide all routes in this controller from OpenAPI documentation
+     * Routes remain functional but won't appear in /api/docs or /api/openapi.json
+     * Can be overridden at route level with hideFromDocs: false
+     * Useful for internal-only controllers, debug endpoints, or utilities
+     */
+    hideFromDocs?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/router/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,IAAI,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AACxG,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,QAAQ,CAAA;AACxC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AACtC,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,mBAAmB,EAAE,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAKhG;;;GAGG;AAEH,KAAK,mBAAmB,GAAG,SAAS,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAA;AAC7D,KAAK,cAAc,GAAG,mBAAmB,GAAG,SAAS,CAAA;AAErD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,CAAC,mBAAmB,CAAC,iBAAiB,CAAC,EAAE,SAAS,CAAA;IAClD,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,CAAA;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,UAAU,CAAA;IACpB,SAAS,EAAE,eAAe,CAAA;CAC3B;AAED;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,OAAO,gBAAgB,CAAC,MAAM,OAAO,gBAAgB,CAAC,CAAA;AAEnF;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,OAAO,YAAY,CAAA;AAElD;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAA;AAEnG;;;GAGG;AACH,MAAM,MAAM,oBAAoB,GAAG,MAAM,CAAC,cAAc,EAAE,MAAM,EAAE,CAAC,CAAA;AAEnE;;GAEG;AACH,YAAY,EAAE,kBAAkB,EAAE,CAAA;AAElC;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AAE/E;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,IAAI,CAAC,EAAE,OAAO,CAAA;IAEd;;;OAGG;IACH,MAAM,CAAC,EAAE,cAAc,CAAA;IAEvB;;;OAGG;IACH,KAAK,CAAC,EAAE,cAAc,CAAA;IAEtB;;;;OAIG;IACH,QAAQ,EAAE,aAAa,CAAA;IAEvB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IAEf;;;;OAIG;IACH,QAAQ,CAAC,EAAE,cAAc,EAAE,CAAA;IAE3B;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IAEpB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAEhB;;;;OAIG;IACH,YAAY,CAAC,EAAE,OAAO,CAAA;CACvB;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IAEf;;;OAGG;IACH,QAAQ,CAAC,EAAE,cAAc,EAAE,CAAA;IAE3B;;;;;OAKG;IACH,YAAY,CAAC,EAAE,OAAO,CAAA;CACvB"}

package/dist/router/types.js

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

package/dist/router/types.js.map

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

package/dist/storage/contracts/delete-file.input.d.ts

@@ -0,0 +1,7 @@
+import { z } from '../../i18n/validation';
+export declare const deleteFileInputSchema: z.ZodObject<{
+    path: z.ZodString;
+    disk: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type DeleteFileInput = z.infer<typeof deleteFileInputSchema>;
+//# sourceMappingURL=delete-file.input.d.ts.map

package/dist/storage/contracts/delete-file.input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete-file.input.d.ts","sourceRoot":"","sources":["../../../src/storage/contracts/delete-file.input.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAY,MAAM,uBAAuB,CAAA;AAEnD,eAAO,MAAM,qBAAqB;;;iBAGhC,CAAA;AAEF,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAA"}

package/dist/storage/contracts/delete-file.input.js

@@ -0,0 +1,6 @@
+import { z, withI18n } from '../../i18n/validation';
+export const deleteFileInputSchema = z.object({
+    path: z.string().min(1, withI18n('zodI18n.errors.custom.filePathRequired')),
+    disk: z.string().optional(),
+});
+//# sourceMappingURL=delete-file.input.js.map

package/dist/storage/contracts/delete-file.input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete-file.input.js","sourceRoot":"","sources":["../../../src/storage/contracts/delete-file.input.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAA;AAEnD,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,wCAAwC,CAAC,CAAC;IAC3E,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC5B,CAAC,CAAA"}