fastify-wrap 0.1.0

package/dist/src/common/scanner/decorators.js

@@ -0,0 +1,158 @@
+import 'reflect-metadata';
+// Metadata keys
+export const CONTROLLER_PREFIX = Symbol('controller:prefix');
+export const ROUTES = Symbol('controller:routes');
+export const LOGIN_META = Symbol('route:login');
+export const PUBLIC_META = Symbol('route:public');
+export const VALID_META = Symbol('route:valid');
+export const STREAM_META = Symbol('route:stream');
+export const RPC_META = Symbol('controller:rpc');
+export const FILE_META = Symbol('route:file');
+export const MULTIPART_META = Symbol('route:multipart');
+/**
+ * Marks a class as a controller and sets the route prefix.
+ */
+export function Controller(prefix) {
+    return (target) => {
+        Reflect.defineMetadata(CONTROLLER_PREFIX, prefix, target);
+    };
+}
+/**
+ * Marks a controller class as RPC-style.
+ *
+ * RPC controllers differ from regular controllers:
+ * - All routes must use POST (JSON body)
+ * - URL must not contain path parameters (e.g. /user/:id)
+ * - Handler methods receive (body, user) instead of (request, reply)
+ * - Routes are auto-derived from module directory, controller name, and method name
+ *
+ * URL pattern: `/{module}/{controller}/{method}`
+ * - Module: folder name under src/modules/, overridable via route.config.ts
+ * - Controller: set via the `name` argument (defaults to class name)
+ * - Method name stays as-is in code
+ *
+ * Does not require @Controller — @Rpc() on its own is sufficient.
+ *
+ * @example
+ * ```ts
+ * @Rpc('users')
+ * class UserRpc {
+ *   list(body: { page: number }, user: User) { ... }
+ *   // → POST /{module}/users/list
+ * }
+ * ```
+ */
+export function Rpc(name) {
+    return (target) => {
+        const meta = name ? { name } : {};
+        Reflect.defineMetadata(RPC_META, meta, target);
+    };
+}
+function createRouteDecorator(method) {
+    return (path) => {
+        return (target, propertyKey) => {
+            const existingRoutes = Reflect.getMetadata(ROUTES, target.constructor) || [];
+            existingRoutes.push({ method, path, handlerName: propertyKey });
+            Reflect.defineMetadata(ROUTES, existingRoutes, target.constructor);
+        };
+    };
+}
+export const Get = createRouteDecorator('GET');
+export const Post = createRouteDecorator('POST');
+export const Put = createRouteDecorator('PUT');
+export const Delete = createRouteDecorator('DELETE');
+/**
+ * Requires login authentication for the route.
+ * Can be used as method decorator (on individual methods) or class decorator
+ * (applies to all methods in the controller, overridable by method-level @Login or @Public).
+ * @param module Required module (subsystem) e.g. 'admin', 'bd', 'merchant'. Checks against user.type in JWT.
+ */
+export function Login(module) {
+    return ((target, propertyKey) => {
+        const meta = {};
+        if (module)
+            meta.module = module;
+        if (propertyKey !== undefined) {
+            Reflect.defineMetadata(LOGIN_META, meta, target.constructor, propertyKey);
+        }
+        else {
+            Reflect.defineMetadata(LOGIN_META, meta, target);
+        }
+    });
+}
+/**
+ * Explicitly marks a route as public (no authentication).
+ */
+export function Public() {
+    return (target, propertyKey) => {
+        Reflect.defineMetadata(PUBLIC_META, true, target.constructor, propertyKey);
+    };
+}
+/**
+ * Attaches a JSON Schema for Fastify validation.
+ * @param schema A Fastify route schema object (body/query/params/headers).
+ */
+export function Valid(schema) {
+    return (target, propertyKey) => {
+        const existing = Reflect.getMetadata(VALID_META, target.constructor, propertyKey) || {};
+        Reflect.defineMetadata(VALID_META, { ...existing, ...schema }, target.constructor, propertyKey);
+    };
+}
+/**
+ * Marks a route that streams content as a downloadable file.
+ * The controller method must return `StreamResponse { name, content }`.
+ *
+ * @param description Optional OpenAPI description for the response.
+ */
+export function Stream(description) {
+    return (target, propertyKey) => {
+        Reflect.defineMetadata(STREAM_META, true, target.constructor, propertyKey);
+        if (description) {
+            const existing = Reflect.getMetadata(VALID_META, target.constructor, propertyKey) || {};
+            const responseEntry = {
+                description,
+                content: {
+                    'application/octet-stream': {
+                        schema: { type: 'string', format: 'binary' },
+                    },
+                },
+            };
+            Reflect.defineMetadata(VALID_META, { ...existing, response: { 200: responseEntry } }, target.constructor, propertyKey);
+        }
+    };
+}
+/**
+ * Marks a route that sends a file from the server filesystem as download.
+ * The controller method must return `FileResponse { name, path }`.
+ * The framework reads the file at `path` and sends it with the given filename.
+ *
+ * @param description Optional OpenAPI description for the response.
+ */
+export function File(description) {
+    return (target, propertyKey) => {
+        Reflect.defineMetadata(FILE_META, true, target.constructor, propertyKey);
+        if (description) {
+            const existing = Reflect.getMetadata(VALID_META, target.constructor, propertyKey) || {};
+            const responseEntry = {
+                description,
+                content: {
+                    'application/octet-stream': {
+                        schema: { type: 'string', format: 'binary' },
+                    },
+                },
+            };
+            Reflect.defineMetadata(VALID_META, { ...existing, response: { 200: responseEntry } }, target.constructor, propertyKey);
+        }
+    };
+}
+/**
+ * Marks a route that handles multipart/form-data file upload.
+ * No @Body is required — the file cannot be validated as JSON Schema.
+ * This is a pure marker; the framework does not attach any runtime behavior.
+ */
+export function Multipart() {
+    return (target, propertyKey) => {
+        Reflect.defineMetadata(MULTIPART_META, true, target.constructor, propertyKey);
+    };
+}
+//# sourceMappingURL=decorators.js.map

package/dist/src/common/scanner/decorators.js.map

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

package/dist/src/common/scanner/handler-factory.d.ts

@@ -0,0 +1,38 @@
+import type { FastifyRequest, FastifyReply } from 'fastify';
+export type RouteHandler<R = unknown> = (request: FastifyRequest, reply: FastifyReply) => R;
+export interface HandlerMeta {
+    /** Route belongs to an RPC controller */
+    isRpc: boolean;
+    /** Route has @File decorator */
+    isFile: boolean;
+    /** Route has @Stream decorator */
+    isStream: boolean;
+}
+export interface HandlerFactory {
+    /** Returns true if this factory can handle the given route metadata */
+    accept(meta: HandlerMeta): boolean;
+    /** Creates a Fastify route handler — call style is baked in at creation time */
+    create(boundHandler: (...args: unknown[]) => unknown, meta: HandlerMeta): RouteHandler;
+}
+/** Sends file from disk with Content-Disposition header */
+export declare class FileHandlerFactory implements HandlerFactory {
+    accept(meta: HandlerMeta): boolean;
+    create(boundHandler: (...args: unknown[]) => unknown, meta: HandlerMeta): RouteHandler;
+}
+/** Sends content with Content-Disposition header for streaming */
+export declare class StreamHandlerFactory implements HandlerFactory {
+    accept(meta: HandlerMeta): boolean;
+    create(boundHandler: (...args: unknown[]) => unknown, meta: HandlerMeta): RouteHandler;
+}
+/** Default handler: passes request & reply, returns result as-is */
+export declare class DefaultHandlerFactory implements HandlerFactory {
+    accept(meta: HandlerMeta): boolean;
+    create(boundHandler: (...args: unknown[]) => unknown, meta: HandlerMeta): RouteHandler;
+}
+/** Registry that holds HandlerFactory instances and delegates via first-match */
+export declare class HandlerFactoryRegistry {
+    private factories;
+    register(factory: HandlerFactory): void;
+    create(boundHandler: (...args: unknown[]) => unknown, meta: HandlerMeta): RouteHandler;
+}
+//# sourceMappingURL=handler-factory.d.ts.map

package/dist/src/common/scanner/handler-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler-factory.d.ts","sourceRoot":"","sources":["../../../../src/common/scanner/handler-factory.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAG5D,MAAM,MAAM,YAAY,CAAC,CAAC,GAAG,OAAO,IAAI,CAAC,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,YAAY,KAAK,CAAC,CAAC;AAE5F,MAAM,WAAW,WAAW;IAC1B,yCAAyC;IACzC,KAAK,EAAE,OAAO,CAAC;IACf,gCAAgC;IAChC,MAAM,EAAE,OAAO,CAAC;IAChB,kCAAkC;IAClC,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,uEAAuE;IACvE,MAAM,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC;IACnC,gFAAgF;IAChF,MAAM,CAAC,YAAY,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,EAAE,IAAI,EAAE,WAAW,GAAG,YAAY,CAAC;CACxF;AAYD,2DAA2D;AAC3D,qBAAa,kBAAmB,YAAW,cAAc;IACvD,MAAM,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO;IAGlC,MAAM,CAAC,YAAY,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,EAAE,IAAI,EAAE,WAAW,GAAG,YAAY;CAiBvF;AAED,kEAAkE;AAClE,qBAAa,oBAAqB,YAAW,cAAc;IACzD,MAAM,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO;IAGlC,MAAM,CAAC,YAAY,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,EAAE,IAAI,EAAE,WAAW,GAAG,YAAY;CAavF;AAED,oEAAoE;AACpE,qBAAa,qBAAsB,YAAW,cAAc;IAC1D,MAAM,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO;IAGlC,MAAM,CAAC,YAAY,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,EAAE,IAAI,EAAE,WAAW,GAAG,YAAY;CAGvF;AAED,iFAAiF;AACjF,qBAAa,sBAAsB;IACjC,OAAO,CAAC,SAAS,CAAwB;IAEzC,QAAQ,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IAIvC,MAAM,CAAC,YAAY,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,EAAE,IAAI,EAAE,WAAW,GAAG,YAAY;CAUvF"}

package/dist/src/common/scanner/handler-factory.js

@@ -0,0 +1,76 @@
+import { readFile } from 'node:fs/promises';
+function createCaller(boundHandler, meta) {
+    if (meta.isRpc) {
+        return (req) => boundHandler(req.body, req.user);
+    }
+    return boundHandler;
+}
+/** Sends file from disk with Content-Disposition header */
+export class FileHandlerFactory {
+    accept(meta) {
+        return meta.isFile;
+    }
+    create(boundHandler, meta) {
+        const caller = createCaller(boundHandler, meta);
+        return async (request, reply) => {
+            try {
+                const result = await caller(request, reply);
+                const fr = result;
+                if (typeof fr.path !== 'string' || typeof fr.name !== 'string') {
+                    throw new Error('@File must return FileResponse { name, path }');
+                }
+                const content = await readFile(fr.path);
+                reply.header('Content-Disposition', `attachment; filename*=UTF-8''${encodeURIComponent(fr.name)}`);
+                return reply.send(content);
+            }
+            catch (err) {
+                reply.status(500).send({ error: err instanceof Error ? err.message : 'Internal error' });
+            }
+        };
+    }
+}
+/** Sends content with Content-Disposition header for streaming */
+export class StreamHandlerFactory {
+    accept(meta) {
+        return meta.isStream;
+    }
+    create(boundHandler, meta) {
+        const caller = createCaller(boundHandler, meta);
+        return async (request, reply) => {
+            try {
+                const result = await caller(request, reply);
+                const sr = result;
+                reply.header('Content-Disposition', `attachment; filename*=UTF-8''${encodeURIComponent(sr.name)}`);
+                return reply.send(sr.content);
+            }
+            catch (err) {
+                reply.status(500).send({ error: err instanceof Error ? err.message : 'Internal error' });
+            }
+        };
+    }
+}
+/** Default handler: passes request & reply, returns result as-is */
+export class DefaultHandlerFactory {
+    accept(meta) {
+        return true;
+    }
+    create(boundHandler, meta) {
+        return createCaller(boundHandler, meta);
+    }
+}
+/** Registry that holds HandlerFactory instances and delegates via first-match */
+export class HandlerFactoryRegistry {
+    factories = [];
+    register(factory) {
+        this.factories.push(factory);
+    }
+    create(boundHandler, meta) {
+        for (const factory of this.factories) {
+            if (factory.accept(meta)) {
+                return factory.create(boundHandler, meta);
+            }
+        }
+        throw new Error(`No HandlerFactory found for meta: isRpc=${meta.isRpc}, isFile=${meta.isFile}, isStream=${meta.isStream}`);
+    }
+}
+//# sourceMappingURL=handler-factory.js.map

package/dist/src/common/scanner/handler-factory.js.map

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

package/dist/src/common/scanner/index.d.ts

@@ -0,0 +1,16 @@
+import type { FastifyInstance } from 'fastify';
+import type { AuthStrategy } from '../auth/AuthStrategy';
+export { HandlerFactoryRegistry, FileHandlerFactory, StreamHandlerFactory, DefaultHandlerFactory } from './handler-factory';
+export type { HandlerFactory, HandlerMeta, RouteHandler } from './handler-factory';
+export { AuthHookFactoryRegistry, PublicAuthHookFactory, HmacAuthHookFactory, JwtAuthHookFactory, authLabel } from './auth-factory';
+export type { AuthHookFactory, AuthHook, AuthHookMeta } from './auth-factory';
+export interface ScanOptions {
+    /** Base directory for glob (absolute path to project root). */
+    cwd: string;
+    /** Auth strategy for signature verification (HMAC). */
+    signStrategy?: AuthStrategy;
+    /** Auth strategy for login (JWT). Only used when @Login is present. */
+    loginStrategy?: AuthStrategy;
+}
+export declare function scanControllers(fastify: FastifyInstance, options: ScanOptions): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/src/common/scanner/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/common/scanner/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAe/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAgBzD,OAAO,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC5H,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACnF,OAAO,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AACpI,YAAY,EAAE,eAAe,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAa9E,MAAM,WAAW,WAAW;IAC1B,+DAA+D;IAC/D,GAAG,EAAE,MAAM,CAAC;IACZ,uDAAuD;IACvD,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,uEAAuE;IACvE,aAAa,CAAC,EAAE,YAAY,CAAC;CAC9B;AAED,wBAAsB,eAAe,CAAC,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAqJnG"}

package/dist/src/common/scanner/index.js

@@ -0,0 +1,157 @@
+import path from 'node:path';
+import { pathToFileURL } from 'node:url';
+import fg from 'fast-glob';
+import { container } from '../container/index';
+import { CONTROLLER_PREFIX, ROUTES, LOGIN_META, PUBLIC_META, VALID_META, STREAM_META, RPC_META, FILE_META, } from './decorators';
+import { HandlerFactoryRegistry, FileHandlerFactory, StreamHandlerFactory, DefaultHandlerFactory, } from './handler-factory';
+import { AuthHookFactoryRegistry, PublicAuthHookFactory, HmacAuthHookFactory, JwtAuthHookFactory, authLabel, } from './auth-factory';
+export { HandlerFactoryRegistry, FileHandlerFactory, StreamHandlerFactory, DefaultHandlerFactory } from './handler-factory';
+export { AuthHookFactoryRegistry, PublicAuthHookFactory, HmacAuthHookFactory, JwtAuthHookFactory, authLabel } from './auth-factory';
+// Default registries — can be replaced or extended by callers
+const handlerRegistry = new HandlerFactoryRegistry();
+handlerRegistry.register(new FileHandlerFactory());
+handlerRegistry.register(new StreamHandlerFactory());
+handlerRegistry.register(new DefaultHandlerFactory());
+const authHookRegistry = new AuthHookFactoryRegistry();
+authHookRegistry.register(new PublicAuthHookFactory());
+authHookRegistry.register(new JwtAuthHookFactory());
+authHookRegistry.register(new HmacAuthHookFactory());
+export async function scanControllers(fastify, options) {
+    const pattern = 'src/modules/**/controller/*.{ts,js}';
+    const files = await fg(pattern, { cwd: options.cwd, absolute: true });
+    // Cache: module folder → resolved module config (nulls = use defaults)
+    const moduleConfigCache = new Map();
+    for (const file of files) {
+        const mod = await import(pathToFileURL(file).href);
+        for (const exportKey of Object.keys(mod)) {
+            const exported = mod[exportKey];
+            // Only process classes
+            if (typeof exported !== 'function' || !exported.prototype) {
+                continue;
+            }
+            const prefix = Reflect.getMetadata(CONTROLLER_PREFIX, exported);
+            const rpcMeta = Reflect.getMetadata(RPC_META, exported);
+            const isRpc = rpcMeta !== undefined;
+            // Skip if neither @Controller nor @Rpc
+            if (prefix === undefined && !isRpc) {
+                continue;
+            }
+            const routes = Reflect.getMetadata(ROUTES, exported) || [];
+            // RPC auto-scan: generate routes from all public methods
+            if (routes.length === 0 && isRpc) {
+                const proto = exported.prototype;
+                const methodNames = Object.getOwnPropertyNames(proto)
+                    .filter(n => n !== 'constructor' && typeof proto[n] === 'function');
+                for (const name of methodNames) {
+                    routes.push({ method: 'POST', path: '/' + name, handlerName: name });
+                }
+            }
+            if (routes.length === 0) {
+                continue;
+            }
+            // RPC path derivation: if no @Controller, derive from module directory + controller name
+            let effectivePrefix = prefix;
+            let moduleCfg;
+            if (isRpc && prefix === undefined && rpcMeta) {
+                const relativePath = path.relative(options.cwd, file).replace(/\\/g, '/');
+                const moduleMatch = relativePath.match(/src\/modules\/([^/]+)\/controller\//);
+                const moduleFolder = moduleMatch ? moduleMatch[1] : 'unknown';
+                // Resolve module config from route.config.ts (cached per module)
+                if (!moduleConfigCache.has(moduleFolder)) {
+                    moduleConfigCache.set(moduleFolder, await resolveModuleConfig(options.cwd, moduleFolder));
+                }
+                moduleCfg = moduleConfigCache.get(moduleFolder) ?? { urlPrefix: null, module: null };
+                const urlPrefix = moduleCfg.urlPrefix ?? moduleFolder;
+                const controllerName = rpcMeta.name ?? exportKey;
+                effectivePrefix = '/' + urlPrefix + '/' + controllerName;
+            }
+            // Instantiate controller via container (DI)
+            let instance;
+            try {
+                instance = container.resolve(exported);
+            }
+            catch {
+                // No explicit registration — try creating with default constructor
+                instance = new exported();
+            }
+            // Collect route info for logging
+            const routeDescs = [];
+            // Register each route
+            for (const route of routes) {
+                const handler = instance[route.handlerName];
+                if (typeof handler !== 'function') {
+                    throw new Error(`${exported.name}.${route.handlerName} is not a method`);
+                }
+                const loginMeta = Reflect.getMetadata(LOGIN_META, exported, route.handlerName);
+                const isPublic = Reflect.getMetadata(PUBLIC_META, exported, route.handlerName) === true;
+                // Build effective login meta: method-level → class-level → module-level
+                let effectiveLogin;
+                const classLoginMeta = loginMeta ?? Reflect.getMetadata(LOGIN_META, exported);
+                if (!isPublic) {
+                    const module = classLoginMeta?.module ?? moduleCfg?.module ?? undefined;
+                    if (module || classLoginMeta) {
+                        effectiveLogin = module ? { module } : {};
+                    }
+                }
+                const isStream = Reflect.getMetadata(STREAM_META, exported, route.handlerName) === true;
+                const isFile = Reflect.getMetadata(FILE_META, exported, route.handlerName) === true;
+                const schema = Reflect.getMetadata(VALID_META, exported, route.handlerName);
+                const fullPath = (effectivePrefix + route.path).replace(/\/$/, '') || '/';
+                // RPC constraints: POST only, no path params
+                if (isRpc) {
+                    if (route.method !== 'POST') {
+                        throw new Error(`RPC controller ${exported.name} only supports POST method, got ${route.method} on ${route.handlerName}`);
+                    }
+                    if (fullPath.includes(':')) {
+                        throw new Error(`RPC controller ${exported.name} does not support URL parameters, got ${fullPath} on ${route.handlerName}`);
+                    }
+                }
+                // Bind handler to instance
+                const boundHandler = handler.bind(instance);
+                // Delegate handler creation to factory registry
+                const handlerMeta = { isRpc, isFile, isStream };
+                const routeHandler = handlerRegistry.create(boundHandler, handlerMeta);
+                // Delegate auth hook creation to factory registry
+                const authMeta = { isPublic, loginMeta: effectiveLogin };
+                const preValidationHooks = authHookRegistry.create(authMeta, options);
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                const routeDef = {
+                    method: route.method,
+                    url: fullPath,
+                    handler: routeHandler,
+                };
+                if (schema) {
+                    routeDef.schema = schema;
+                }
+                if (preValidationHooks.length > 0) {
+                    routeDef.preValidation = preValidationHooks;
+                }
+                fastify.route(routeDef);
+                routeDescs.push(`${route.method} ${fullPath} [${authLabel(authMeta)}]`);
+            }
+            fastify.log.info({ controller: exported.name, routes: routeDescs }, 'Controller registered');
+        }
+    }
+}
+/**
+ * Try to load route.config.{ts,js} from the module directory.
+ * Returns { module, role } — null values mean "use defaults".
+ */
+async function resolveModuleConfig(cwd, moduleFolder) {
+    const base = path.join(cwd, 'src', 'modules', moduleFolder, 'route.config');
+    for (const ext of ['.ts', '.js']) {
+        try {
+            const mod = await import(pathToFileURL(base + ext).href);
+            const config = (mod.default ?? mod);
+            return {
+                urlPrefix: (config && typeof config.urlPrefix === 'string' && config.urlPrefix.length > 0) ? config.urlPrefix : null,
+                module: (config && typeof config.module === 'string' && config.module.length > 0) ? config.module : null,
+            };
+        }
+        catch {
+            // file doesn't exist or can't be imported, try next extension
+        }
+    }
+    return { urlPrefix: null, module: null };
+}
+//# sourceMappingURL=index.js.map

package/dist/src/common/scanner/index.js.map

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

package/dist/src/common/validation/decorators.d.ts

@@ -0,0 +1,28 @@
+import { type SchemaProp } from './schema';
+/** Accepts either @fastify-api/api SchemaProp map or a raw JSON Schema (e.g. from Typebox). */
+export type SchemaLike = Record<string, SchemaProp> | Record<string, unknown>;
+/** Declare request body validation schema. */
+export declare const Body: (def: SchemaLike) => MethodDecorator;
+/** Declare query string validation schema. */
+export declare const Query: (def: SchemaLike) => MethodDecorator;
+/** Declare path params validation schema. */
+export declare const Params: (def: SchemaLike) => MethodDecorator;
+/**
+ * Declare response schema for a given HTTP status code.
+ * Accepts @fastify-api/api SchemaProp map OR a raw JSON Schema (e.g. from Typebox).
+ *
+ * @param description Response description
+ * @param def Schema definition — either `{ token: Required(String) }` or a Typebox schema
+ * @param statusCode HTTP status code, default 200
+ *
+ * @example
+ * ```ts
+ * // @fastify-api/api style
+ * @Response('登录成功', { token: Required(String) })
+ *
+ * // Typebox style
+ * @Response('登录成功', Type.Object({ token: Type.String() }))
+ * ```
+ */
+export declare function Response(description: string, def: SchemaLike, statusCode?: number): MethodDecorator;
+//# sourceMappingURL=decorators.d.ts.map

package/dist/src/common/validation/decorators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../../../../src/common/validation/decorators.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,UAAU,EAAE,MAAM,UAAU,CAAC;AAG9D,+FAA+F;AAC/F,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAoB9E,8CAA8C;AAC9C,eAAO,MAAM,IAAI,QAlBF,UAAU,KAAG,eAkByB,CAAC;AAEtD,8CAA8C;AAC9C,eAAO,MAAM,KAAK,QArBH,UAAU,KAAG,eAqBiC,CAAC;AAE9D,6CAA6C;AAC7C,eAAO,MAAM,MAAM,QAxBJ,UAAU,KAAG,eAwB6B,CAAC;AAmB1D;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,UAAU,EAAE,UAAU,GAAE,MAAY,GAAG,eAAe,CAuBxG"}

package/dist/src/common/validation/decorators.js

@@ -0,0 +1,70 @@
+import { buildObjectSchema } from './schema';
+import { VALID_META } from '../scanner/decorators';
+function createValidationDecorator(targetKey) {
+    return (def) => {
+        return (target, propertyKey) => {
+            const schema = isRawJsonSchema(def)
+                ? def
+                : buildObjectSchema(def);
+            const existing = Reflect.getMetadata(VALID_META, target.constructor, propertyKey) || {};
+            Reflect.defineMetadata(VALID_META, { ...existing, [targetKey]: schema }, target.constructor, propertyKey);
+        };
+    };
+}
+/** Declare request body validation schema. */
+export const Body = createValidationDecorator('body');
+/** Declare query string validation schema. */
+export const Query = createValidationDecorator('querystring');
+/** Declare path params validation schema. */
+export const Params = createValidationDecorator('params');
+function isRawJsonSchema(def) {
+    return typeof def.type === 'string';
+}
+const DEFAULT_DESCRIPTIONS = {
+    200: 'OK',
+    201: 'Created',
+    204: 'No Content',
+    400: 'Bad Request',
+    401: 'Unauthorized',
+    403: 'Forbidden',
+    404: 'Not Found',
+    422: 'Unprocessable Entity',
+    429: 'Too Many Requests',
+    500: 'Internal Server Error',
+};
+/**
+ * Declare response schema for a given HTTP status code.
+ * Accepts @fastify-api/api SchemaProp map OR a raw JSON Schema (e.g. from Typebox).
+ *
+ * @param description Response description
+ * @param def Schema definition — either `{ token: Required(String) }` or a Typebox schema
+ * @param statusCode HTTP status code, default 200
+ *
+ * @example
+ * ```ts
+ * // @fastify-api/api style
+ * @Response('登录成功', { token: Required(String) })
+ *
+ * // Typebox style
+ * @Response('登录成功', Type.Object({ token: Type.String() }))
+ * ```
+ */
+export function Response(description, def, statusCode = 200) {
+    return (target, propertyKey) => {
+        const bodySchema = isRawJsonSchema(def)
+            ? def
+            : buildObjectSchema(def);
+        const desc = description || DEFAULT_DESCRIPTIONS[statusCode] || 'Unknown';
+        // OpenAPI 3 format: description + content.application/json.schema
+        const responseEntry = {
+            description: desc,
+            content: {
+                'application/json': { schema: bodySchema },
+            },
+        };
+        const responseWrapper = { [String(statusCode)]: responseEntry };
+        const existing = Reflect.getMetadata(VALID_META, target.constructor, propertyKey) || {};
+        Reflect.defineMetadata(VALID_META, { ...existing, response: responseWrapper }, target.constructor, propertyKey);
+    };
+}
+//# sourceMappingURL=decorators.js.map

package/dist/src/common/validation/decorators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.js","sourceRoot":"","sources":["../../../../src/common/validation/decorators.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAmB,MAAM,UAAU,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAKnD,SAAS,yBAAyB,CAAC,SAAiB;IAClD,OAAO,CAAC,GAAe,EAAmB,EAAE;QAC1C,OAAO,CAAC,MAAc,EAAE,WAA4B,EAAE,EAAE;YACtD,MAAM,MAAM,GAA4B,eAAe,CAAC,GAAG,CAAC;gBAC1D,CAAC,CAAE,GAA+B;gBAClC,CAAC,CAAC,iBAAiB,CAAC,GAAiC,CAAC,CAAC;YACzD,MAAM,QAAQ,GACZ,OAAO,CAAC,WAAW,CAAC,UAAU,EAAE,MAAM,CAAC,WAAW,EAAE,WAAW,CAAC,IAAI,EAAE,CAAC;YACzE,OAAO,CAAC,cAAc,CACpB,UAAU,EACV,EAAE,GAAG,QAAQ,EAAE,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,EACpC,MAAM,CAAC,WAAW,EAClB,WAAW,CACZ,CAAC;QACJ,CAAC,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC;AAED,8CAA8C;AAC9C,MAAM,CAAC,MAAM,IAAI,GAAG,yBAAyB,CAAC,MAAM,CAAC,CAAC;AAEtD,8CAA8C;AAC9C,MAAM,CAAC,MAAM,KAAK,GAAG,yBAAyB,CAAC,aAAa,CAAC,CAAC;AAE9D,6CAA6C;AAC7C,MAAM,CAAC,MAAM,MAAM,GAAG,yBAAyB,CAAC,QAAQ,CAAC,CAAC;AAE1D,SAAS,eAAe,CAAC,GAA4B;IACnD,OAAO,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,CAAC;AACtC,CAAC;AAED,MAAM,oBAAoB,GAA2B;IACnD,GAAG,EAAE,IAAI;IACT,GAAG,EAAE,SAAS;IACd,GAAG,EAAE,YAAY;IACjB,GAAG,EAAE,aAAa;IAClB,GAAG,EAAE,cAAc;IACnB,GAAG,EAAE,WAAW;IAChB,GAAG,EAAE,WAAW;IAChB,GAAG,EAAE,sBAAsB;IAC3B,GAAG,EAAE,mBAAmB;IACxB,GAAG,EAAE,uBAAuB;CAC7B,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,QAAQ,CAAC,WAAmB,EAAE,GAAe,EAAE,aAAqB,GAAG;IACrF,OAAO,CAAC,MAAc,EAAE,WAA4B,EAAE,EAAE;QACtD,MAAM,UAAU,GAA4B,eAAe,CAAC,GAAG,CAAC;YAC9D,CAAC,CAAE,GAA+B;YAClC,CAAC,CAAC,iBAAiB,CAAC,GAAiC,CAAC,CAAC;QACzD,MAAM,IAAI,GAAG,WAAW,IAAI,oBAAoB,CAAC,UAAU,CAAC,IAAI,SAAS,CAAC;QAC1E,kEAAkE;QAClE,MAAM,aAAa,GAA4B;YAC7C,WAAW,EAAE,IAAI;YACjB,OAAO,EAAE;gBACP,kBAAkB,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE;aAC3C;SACF,CAAC;QACF,MAAM,eAAe,GAA4B,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC;QACzF,MAAM,QAAQ,GACZ,OAAO,CAAC,WAAW,CAAC,UAAU,EAAE,MAAM,CAAC,WAAW,EAAE,WAAW,CAAC,IAAI,EAAE,CAAC;QACzE,OAAO,CAAC,cAAc,CACpB,UAAU,EACV,EAAE,GAAG,QAAQ,EAAE,QAAQ,EAAE,eAAe,EAAE,EAC1C,MAAM,CAAC,WAAW,EAClB,WAAW,CACZ,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC"}

package/dist/src/common/validation/errorRules.d.ts

@@ -0,0 +1,5 @@
+import type { ErrorObject } from 'ajv';
+export type RuleFormatter = (fieldName: string) => string;
+export declare function addRule(keyword: string, formatter: RuleFormatter): void;
+export declare function formatError(errors: ErrorObject[] | undefined, dataVar?: string): string;
+//# sourceMappingURL=errorRules.d.ts.map

package/dist/src/common/validation/errorRules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorRules.d.ts","sourceRoot":"","sources":["../../../../src/common/validation/errorRules.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,KAAK,CAAC;AAEvC,MAAM,MAAM,aAAa,GAAG,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,CAAC;AAI1D,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,aAAa,GAAG,IAAI,CAEvE;AAUD,wBAAgB,WAAW,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,SAAS,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAWvF"}