@kabyeon/nexusjs 0.6.5

package/dist/upload/index.js.map

@@ -0,0 +1,25 @@
+{
+  "version": 3,
+  "sources": ["../src/core/constants.ts", "../src/core/decorators/controller.ts", "../src/core/decorators/http-methods.ts", "../src/core/decorators/params.ts", "../src/core/decorators/validate.ts", "../src/upload/types.ts", "../src/core/decorators/module.ts", "../src/core/decorators/index.ts", "../src/core/decorators/injectable.ts", "../src/core/decorators/repository.ts", "../src/core/decorators/metadata.ts", "../src/upload/upload.service.ts", "../src/upload/upload.module.ts", "../src/upload/upload.middleware.ts", "../src/upload/decorators/upload.ts", "../src/upload/decorators/uploaded-file.ts"],
+  "sourcesContent": [
+    "/**\n * Metadata keys used by reflect-metadata for storing decorator data.\n *\n * These constants are the contract between decorators and the framework\n * core (DI container, router, validator).\n */\nexport const METADATA_KEY = {\n\t/** Marks a class as a Nest-style controller, stores route prefix. */\n\tCONTROLLER: \"nexus:controller\",\n\n\t/** Marks a class as an injectable provider. */\n\tINJECTABLE: \"nexus:injectable\",\n\n\t/** Marks a class as a repository. */\n\tREPOSITORY: \"nexus:repository\",\n\n\t/** Marks a class as a module. Stores module options. */\n\tMODULE: \"nexus:module\",\n\n\t/** HTTP method routes registered on a controller (Get/Post/...). */\n\tROUTES: \"nexus:routes\",\n\n\t/** Method parameter type metadata (body/query/param/headers/ctx). */\n\tPARAMS: \"nexus:params\",\n\n\t/** Validation schema per method (Zod schema or class). */\n\tVALIDATE: \"nexus:validate\",\n\n\t/** Class-level design:paramtypes (built-in). */\n\tPARAMTYPES: \"design:paramtypes\",\n\n\t/** Class-level design:type (built-in). */\n\tTYPE: \"design:type\",\n\n\t/** Class-level design:returntype (built-in). */\n\tRETURNTYPE: \"design:returntype\",\n\n\t/** Provider token to inject for a parameter (for custom tokens). */\n\tINJECT: \"nexus:inject\",\n} as const;\n\nexport type MetadataKey = (typeof METADATA_KEY)[keyof typeof METADATA_KEY];\n\n/** Available parameter decorator locations. */\nexport const PARAM_TYPES = {\n\tREQUEST: 0,\n\tRESPONSE: 1,\n\tNEXT: 2,\n\tBODY: 3,\n\tQUERY: 4,\n\tPARAM: 5,\n\tHEADERS: 6,\n\tCTX: 7,\n\tUSER: 8,\n} as const;\n\nexport type ParamType = (typeof PARAM_TYPES)[keyof typeof PARAM_TYPES];\n\n/** HTTP methods supported by the router. */\nexport const HTTP_METHODS = [\n\t\"GET\",\n\t\"POST\",\n\t\"PUT\",\n\t\"DELETE\",\n\t\"PATCH\",\n\t\"OPTIONS\",\n\t\"HEAD\",\n] as const;\nexport type HttpMethod = (typeof HTTP_METHODS)[number];\n",
+    "/**\n * @Controller decorator.\n *\n * Marks a class as a controller and registers a route prefix.\n * Routes inside the controller class are decorated with @Get/@Post/etc.\n *\n * @example\n * ```ts\n * @Controller('/users')\n * class UserController {\n *   @Get('/')\n *   list() { ... }\n * }\n * ```\n */\nimport \"reflect-metadata\";\nimport { METADATA_KEY } from \"../constants.js\";\nimport type { ControllerMetadata } from \"../di/tokens.js\";\n\nexport function Controller(prefix: string = \"/\"): ClassDecorator {\n\treturn (target: object) => {\n\t\tconst normalized = normalizePrefix(prefix);\n\t\tconst meta: ControllerMetadata = { prefix: normalized };\n\t\tReflect.defineMetadata(METADATA_KEY.CONTROLLER, meta, target);\n\t};\n}\n\nexport function getControllerMetadata(target: any): ControllerMetadata {\n\treturn (\n\t\tReflect.getMetadata(METADATA_KEY.CONTROLLER, target) ?? { prefix: \"/\" }\n\t);\n}\n\nexport function isController(target: any): boolean {\n\treturn Reflect.hasMetadata(METADATA_KEY.CONTROLLER, target);\n}\n\n/**\n * Normalize a prefix so we can safely concatenate it with handler paths.\n * - Empty string becomes '/'.\n * - Trailing slashes are trimmed (we re-add them on the join).\n * - No leading slash is added; the router always joins with `/`.\n */\nfunction normalizePrefix(prefix: string): string {\n\tif (!prefix) return \"\";\n\tif (prefix !== \"/\" && prefix.endsWith(\"/\")) {\n\t\treturn prefix.slice(0, -1);\n\t}\n\treturn prefix;\n}\n",
+    "/**\n * HTTP method decorators.\n *\n * `@Get`, `@Post`, `@Put`, `@Delete`, `@Patch`, `@Options`, `@Head` mark a\n * controller method as a route handler. The path argument is appended to\n * the controller's prefix.\n *\n * @example\n * ```ts\n * @Controller('/users')\n * class UserController {\n *   @Get('/')\n *   list() {}\n *\n *   @Post('/')\n *   create(@Body() body: CreateUserDto) {}\n * }\n * ```\n */\nimport \"reflect-metadata\";\nimport { HTTP_METHODS, METADATA_KEY, type HttpMethod } from \"../constants.js\";\nimport type { RouteMetadata } from \"../di/tokens.js\";\n\nfunction defineRoute(method: HttpMethod, path: string): MethodDecorator {\n\treturn (\n\t\ttarget: object,\n\t\tpropertyKey: string | symbol,\n\t\tdescriptor: PropertyDescriptor,\n\t) => {\n\t\tconst routes: RouteMetadata[] =\n\t\t\tReflect.getMetadata(METADATA_KEY.ROUTES, target.constructor) ?? [];\n\n\t\troutes.push({\n\t\t\tmethod,\n\t\t\tpath: normalizePath(path),\n\t\t\tpropertyKey,\n\t\t\thandler: descriptor.value,\n\t\t});\n\n\t\tReflect.defineMetadata(METADATA_KEY.ROUTES, routes, target.constructor);\n\t};\n}\n\nfunction normalizePath(path: string): string {\n\tif (!path || path === \"/\") return \"/\";\n\treturn path.startsWith(\"/\") ? path : `/${path}`;\n}\n\nexport const Get = (path: string = \"/\") => defineRoute(\"GET\", path);\nexport const Post = (path: string = \"/\") => defineRoute(\"POST\", path);\nexport const Put = (path: string = \"/\") => defineRoute(\"PUT\", path);\nexport const Delete = (path: string = \"/\") => defineRoute(\"DELETE\", path);\nexport const Patch = (path: string = \"/\") => defineRoute(\"PATCH\", path);\nexport const Options = (path: string = \"/\") => defineRoute(\"OPTIONS\", path);\nexport const Head = (path: string = \"/\") => defineRoute(\"HEAD\", path);\n\nexport function getRoutes(target: any): RouteMetadata[] {\n\treturn Reflect.getMetadata(METADATA_KEY.ROUTES, target) ?? [];\n}\n\nexport { HTTP_METHODS };\nexport type { RouteMetadata };\n",
+    "/**\n * Parameter decorators.\n *\n * These mark a controller method argument as a source of request data:\n *   - `@Req()`        → Hono context\n *   - `@Res()`        → Response helper\n *   - `@Next()`       → next() callback (for middleware-style handlers)\n *   - `@Body()`       → request body (parsed)\n *   - `@Query('key')` → a single query param, or full query object\n *   - `@Param('key')` → a single path param, or full params object\n *   - `@Headers('k')` → a single header, or full headers object\n *   - `@Ctx()`        → Hono context (alias for @Req)\n *   - `@User()`       → authenticated user (resolved via auth provider)\n *\n * The metadata is read by the router at mount time to build the\n * handler invocation list.\n */\nimport \"reflect-metadata\";\nimport { METADATA_KEY, PARAM_TYPES } from \"../constants.js\";\nimport type { ParamMetadata } from \"../di/tokens.js\";\n\nexport function createParamDecorator(\n\ttype: number,\n\tdata?: string | object,\n): ParameterDecorator {\n\treturn (\n\t\ttarget: object,\n\t\tpropertyKey: string | symbol | undefined,\n\t\tparameterIndex: number,\n\t) => {\n\t\t// Method parameter: target is the prototype, propertyKey is the method name.\n\t\t// Constructor parameter: target is the class, propertyKey is undefined.\n\t\tif (propertyKey !== undefined) {\n\t\t\tconst params: ParamMetadata[] =\n\t\t\t\tReflect.getMetadata(METADATA_KEY.PARAMS, target, propertyKey) ?? [];\n\t\t\tparams.push({\n\t\t\t\tindex: parameterIndex,\n\t\t\t\ttype,\n\t\t\t\tname: typeof data === \"string\" ? data : undefined,\n\t\t\t\tdata: typeof data === \"object\" ? data : undefined,\n\t\t\t});\n\t\t\tReflect.defineMetadata(METADATA_KEY.PARAMS, params, target, propertyKey);\n\t\t} else {\n\t\t\tconst params: ParamMetadata[] =\n\t\t\t\tReflect.getMetadata(METADATA_KEY.PARAMS, target) ?? [];\n\t\t\tparams.push({\n\t\t\t\tindex: parameterIndex,\n\t\t\t\ttype,\n\t\t\t\tname: typeof data === \"string\" ? data : undefined,\n\t\t\t\tdata: typeof data === \"object\" ? data : undefined,\n\t\t\t});\n\t\t\tReflect.defineMetadata(METADATA_KEY.PARAMS, params, target);\n\t\t}\n\t};\n}\n\nexport const Req = () => createParamDecorator(PARAM_TYPES.REQUEST);\nexport const Res = () => createParamDecorator(PARAM_TYPES.RESPONSE);\nexport const Next = () => createParamDecorator(PARAM_TYPES.NEXT);\nexport const Body = (key?: string) =>\n\tcreateParamDecorator(PARAM_TYPES.BODY, key);\nexport const Query = (key?: string) =>\n\tcreateParamDecorator(PARAM_TYPES.QUERY, key);\nexport const Param = (key?: string) =>\n\tcreateParamDecorator(PARAM_TYPES.PARAM, key);\nexport const Headers = (key?: string) =>\n\tcreateParamDecorator(PARAM_TYPES.HEADERS, key);\nexport const Ctx = () => createParamDecorator(PARAM_TYPES.CTX);\nexport const User = () => createParamDecorator(PARAM_TYPES.USER);\n\nexport function getParamMetadata(\n\ttarget: any,\n\tpropertyKey: string | symbol,\n): ParamMetadata[] {\n\treturn Reflect.getMetadata(METADATA_KEY.PARAMS, target, propertyKey) ?? [];\n}\n\nexport { PARAM_TYPES };\n",
+    "/**\n * @Validate decorator.\n *\n * Attaches Zod schemas (or class validators) to a route handler. Each\n * schema is run against the corresponding request part before the handler\n * executes; failed validation throws or returns a 400 response.\n *\n * @example\n * ```ts\n * const UserSchema = z.object({ name: z.string(), email: z.email() });\n *\n * @Post('/')\n * @Validate({ body: UserSchema })\n * create(@Body() body: z.infer<typeof UserSchema>) { ... }\n * ```\n */\nimport \"reflect-metadata\";\nimport { METADATA_KEY } from \"../constants.js\";\nimport type { ValidationMetadata } from \"../di/tokens.js\";\n\nexport function Validate(options: ValidationMetadata): MethodDecorator {\n\treturn (\n\t\ttarget: object,\n\t\tpropertyKey: string | symbol,\n\t\tdescriptor: PropertyDescriptor,\n\t) => {\n\t\tReflect.defineMetadata(\n\t\t\tMETADATA_KEY.VALIDATE,\n\t\t\toptions,\n\t\t\ttarget.constructor,\n\t\t\tpropertyKey,\n\t\t);\n\t};\n}\n\nexport function getValidationMetadata(\n\ttarget: any,\n\tpropertyKey: string | symbol,\n): ValidationMetadata | undefined {\n\treturn Reflect.getMetadata(METADATA_KEY.VALIDATE, target, propertyKey);\n}\n",
+    "/**\n * `nexusjs/upload` — file upload helper.\n *\n *   @Module({\n *     imports: [\n *       UploadModule.forRoot({\n *         maxFileSize: 10 * 1024 * 1024,   // 10MB per file\n *         maxFiles: 5,\n *         allowedMimeTypes: ['image/*', 'application/pdf'],\n *         storage: 'memory',               // or 'drive' (uses nexus/drive)\n *       }),\n *     ],\n *   })\n *\n *   @Post('/avatars')\n *   @Upload('avatar')                    // form field name\n *   async upload(@UploadedFile('avatar') file: UploadedFile) {\n *     return { size: file.size, type: file.contentType };\n *   }\n *\n *   @Post('/photos')\n *   async multi(@UploadedFiles('photos') files: UploadedFile[]) {\n *     return files.length;\n *   }\n */\n\nimport \"reflect-metadata\";\nimport { METADATA_KEY } from \"../core/constants.js\";\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\n/**\n * A file that has been parsed from `multipart/form-data`.\n *\n * The framework reads the entire body into memory (with a hard cap\n * enforced by `maxFileSize`) and exposes it as a `Buffer`. For very\n * large files (gigabytes), use a streaming approach instead — the\n * middleware leaves `stream` populated when the file is too large\n * to buffer.\n */\nexport interface UploadedFile {\n\t/** Form field name (e.g. \"avatar\", \"photos\"). */\n\tfieldName: string;\n\t/** Filename from the client (e.g. \"my-photo.png\"). */\n\tfilename: string;\n\t/** MIME type from the client. */\n\tcontentType: string;\n\t/** Encoding (typically '7bit'). */\n\tencoding: string;\n\t/** File content. */\n\tbuffer: Buffer;\n\t/** Convenience: same as `buffer.length`. */\n\tsize: number;\n}\n\n/** Top-level config. */\nexport interface UploadConfig {\n\t/** Max bytes per file. Default: 10 MB. */\n\tmaxFileSize?: number;\n\t/** Max number of files per request. Default: 5. */\n\tmaxFiles?: number;\n\t/**\n\t * Allowed MIME types. Supports `*` wildcards:\n\t *   'image/*'   — any image type\n\t *   'application/pdf'\n\t *   'video/mp4'\n\t * Default: '*' (any).\n\t */\n\tallowedMimeTypes?: string[];\n\t/**\n\t * Where parsed files are stored in memory. Default: 'memory'.\n\t * The decorator reads from this storage on each access.\n\t */\n\tstorage?: \"memory\";\n\t/**\n\t * When set, parsed files are also pushed to the configured\n\t * `nexusjs/drive` storage under this prefix. The drive is\n\t * resolved by the DI token string.\n\t */\n\tdriveToken?: string;\n\tdrivePrefix?: string;\n\t/** When using drive storage: keep the original filename. Default: false (UUID). */\n\tpreserveFilename?: boolean;\n}\n\n// ---------------------------------------------------------------------------\n// Decorator payload\n// ---------------------------------------------------------------------------\n\nexport interface UploadOptions {\n\t/** Form field name. Default: property name. */\n\tname?: string;\n\t/** Per-field max size (overrides the global default). */\n\tmaxSize?: number;\n\t/** Per-field MIME-type filter. */\n\tmimeTypes?: string[];\n\t/** Per-field max files (for multi-file). Default: 1. */\n\tmaxFiles?: number;\n\t/** Whether the field is required. Default: true. */\n\trequired?: boolean;\n}\n\n// ---------------------------------------------------------------------------\n// Validation errors\n// ---------------------------------------------------------------------------\n\nexport class UploadError extends Error {\n\treadonly status = 400;\n\treadonly code: string;\n\treadonly field: string;\n\tconstructor(code: string, field: string, message: string) {\n\t\tsuper(message);\n\t\tthis.code = code;\n\t\tthis.field = field;\n\t\tthis.name = \"UploadError\";\n\t}\n}\n\n// ---------------------------------------------------------------------------\n// Middleware storage key (per-request)\n// ---------------------------------------------------------------------------\n\n/** Key under which the multipart middleware stores parsed files. */\nexport const UPLOAD_STORAGE_KEY = \"nexus:upload:files\";\n\n/** Internal metadata key (decorator). */\nexport const UPLOAD_META = \"nexus:upload:options\";\n\nexport { METADATA_KEY };\n",
+    "/**\n * @Module decorator.\n *\n * Marks a class as a Nest-style module: a logical grouping of\n * controllers and providers with explicit imports/exports.\n *\n * @example\n * ```ts\n * @Module({\n *   imports: [UserModule],\n *   controllers: [UserController],\n *   providers: [UserService],\n *   exports: [UserService],\n * })\n * class AppModule {}\n * ```\n */\nimport \"reflect-metadata\";\nimport { METADATA_KEY } from \"../constants.js\";\nimport type { ModuleOptions, Type } from \"../di/tokens.js\";\n\nexport function Module(options: ModuleOptions = {}): ClassDecorator {\n\treturn (target: object) => {\n\t\tReflect.defineMetadata(METADATA_KEY.MODULE, options, target);\n\t};\n}\n\n/** Read the @Module options from a class. */\nexport function getModuleOptions(target: Type<any>): ModuleOptions {\n\treturn Reflect.getMetadata(METADATA_KEY.MODULE, target) ?? {};\n}\n",
+    "/**\n * Convenience barrel for all decorators.\n */\nexport * from \"./module.js\";\nexport * from \"./controller.js\";\nexport * from \"./injectable.js\";\nexport * from \"./http-methods.js\";\nexport * from \"./params.js\";\nexport * from \"./validate.js\";\nexport * from \"./repository.js\";\nexport * from \"./metadata.js\";\n",
+    "/**\n * @Injectable decorator.\n *\n * Marks a class as available for DI. The container uses reflect-metadata's\n * `design:paramtypes` to read constructor parameter types and resolve them\n * automatically.\n *\n * @example\n * ```ts\n * @Injectable()\n * class UserService {\n *   constructor(private repo: UserRepository) {}\n * }\n *\n * @Injectable({ scope: 'request' })\n * class RequestContext {\n *   constructor(@Inject(REQUEST) private req: any) {}\n * }\n * ```\n */\nimport \"reflect-metadata\";\nimport { METADATA_KEY } from \"../constants.js\";\n\nexport interface InjectableOptions {\n\tscope?: \"singleton\" | \"request\" | \"transient\";\n}\n\nexport function Injectable(options: InjectableOptions = {}): ClassDecorator {\n\treturn (target: object) => {\n\t\tReflect.defineMetadata(METADATA_KEY.INJECTABLE, true, target);\n\t\tif (options.scope) {\n\t\t\tReflect.defineMetadata(\n\t\t\t\t\"nexus:di:scope\",\n\t\t\t\toptions.scope,\n\t\t\t\ttarget,\n\t\t\t);\n\t\t}\n\t};\n}\n\nexport function isInjectable(target: any): boolean {\n\treturn Reflect.hasMetadata(METADATA_KEY.INJECTABLE, target);\n}\n\n/**\n * Read the scope declared on a class via `@Injectable({ scope })`.\n * Returns undefined when no scope is declared (defaults to singleton).\n */\nexport function getScope(\n\ttarget: any,\n): \"singleton\" | \"request\" | \"transient\" | undefined {\n\treturn Reflect.getMetadata(\"nexus:di:scope\", target);\n}\n\n/**\n * Mark a parameter as resolved by a specific token instead of its declared\n * type. Useful for interfaces, abstract classes, or string tokens.\n *\n * @example\n * ```ts\n * constructor(@Inject('CONFIG') private config: AppConfig) {}\n * ```\n */\nexport function Inject<T = any>(token: any): ParameterDecorator {\n\treturn (\n\t\ttarget: object,\n\t\tpropertyKey: string | symbol | undefined,\n\t\tparameterIndex: number,\n\t) => {\n\t\tconst existing: Map<number, any> =\n\t\t\tReflect.getMetadata(METADATA_KEY.INJECT, target) ?? new Map();\n\t\texisting.set(parameterIndex, token);\n\t\tReflect.defineMetadata(METADATA_KEY.INJECT, existing, target);\n\t};\n}",
+    "/**\n * @Repository decorator.\n *\n * Marks a class as a Spring-style repository. Repositories are normal\n * `@Injectable()` classes; the decorator is a marker so the framework\n * can register them with a database adapter (Drizzle/Prisma) and emit\n * a friendly error if you forget to wire one.\n *\n * @example\n * ```ts\n * @Repository()\n * class UserRepository {\n *   findAll() { return db.select().from(users); }\n * }\n * ```\n */\nimport \"reflect-metadata\";\nimport { METADATA_KEY } from \"../constants.js\";\nimport type { InjectionToken } from \"../di/tokens.js\";\n\nexport function Repository(entityToken?: InjectionToken<any>): ClassDecorator {\n\treturn (target: object) => {\n\t\tReflect.defineMetadata(\n\t\t\tMETADATA_KEY.REPOSITORY,\n\t\t\t{ entity: entityToken },\n\t\t\ttarget,\n\t\t);\n\t\tReflect.defineMetadata(METADATA_KEY.INJECTABLE, true, target);\n\t};\n}\n\nexport function getRepositoryMetadata(\n\ttarget: any,\n): { entity?: InjectionToken<any> } | undefined {\n\treturn Reflect.getMetadata(METADATA_KEY.REPOSITORY, target);\n}\n\nexport function isRepository(target: any): boolean {\n\treturn Reflect.hasMetadata(METADATA_KEY.REPOSITORY, target);\n}\n",
+    "/**\n * Reflect-metadata helper. Centralizes the keys the framework uses so\n * decorator files stay clean.\n */\nexport { METADATA_KEY, PARAM_TYPES, HTTP_METHODS } from \"../constants.js\";\nexport type { MetadataKey, ParamType, HttpMethod } from \"../constants.js\";\n",
+    "/**\n * `UploadService` — parses `multipart/form-data` requests and exposes\n * the parsed files to controller methods via decorators.\n *\n * Lifecycle:\n *   1. The framework mounts `uploadMiddleware` (from this module)\n *      at the route level.\n *   2. The middleware calls `UploadService.parseAndStore(c, fields)`,\n *      which:\n *        - reads `c.req.parseBody({ all: true })`\n *        - extracts `File` entries from the requested fields\n *        - validates each (size, MIME)\n *        - stores the result on the Hono context under\n *          `UPLOAD_STORAGE_KEY`\n *   3. Decorators (`@UploadedFile`, `@UploadedFiles`) read from the\n *      context at parameter-extraction time.\n *\n * The middleware runs **before** the controller handler, so by the\n * time the handler is invoked, all files are already validated.\n */\nimport { Inject, Injectable } from \"../core/decorators/index.js\";\nimport {\n\tUPLOAD_STORAGE_KEY,\n\tUploadError,\n\ttype UploadConfig,\n\ttype UploadedFile,\n} from \"./types.js\";\n\n/** What Hono's `parseBody` returns for file fields. */\ninterface ParsedFileEntry {\n\t/** Original form field name. */\n\tname: string;\n\t/** Web-API File (the multipart payload). */\n\tfilename?: string;\n\ttype?: string;\n\tsize?: number;\n\tarrayBuffer(): Promise<ArrayBuffer>;\n}\n\n/** What Hono's `parseBody` returns overall: string | File | array thereof. */\ntype ParsedBodyValue =\n\t| string\n\t| ParsedFileEntry\n\t| Array<string | ParsedFileEntry>\n\t| undefined;\n\n@Injectable()\nexport class UploadService {\n\t/** DI token. */\n\tstatic readonly TOKEN = Symbol.for(\"nexus:UploadService\");\n\n\t#config: Required<UploadConfig>;\n\t#driveResolver: ((token: string) => any) | null = null;\n\n\tconstructor(@Inject(\"UPLOAD_CONFIG\") config: UploadConfig = {}) {\n\t\tthis.#config = {\n\t\t\tmaxFileSize: config.maxFileSize ?? 10 * 1024 * 1024,\n\t\t\tmaxFiles: config.maxFiles ?? 5,\n\t\t\tallowedMimeTypes: config.allowedMimeTypes ?? [\"*\"],\n\t\t\tstorage: (config.storage as \"memory\") ?? \"memory\",\n\t\t\tdriveToken: config.driveToken ?? \"\",\n\t\t\tdrivePrefix: config.drivePrefix ?? \"\",\n\t\t\tpreserveFilename: config.preserveFilename ?? false,\n\t\t};\n\t}\n\n\t/** Bind a function that resolves a DI token to a service. Set by the module on boot. */\n\tbindDriveResolver(fn: (token: string) => any): void {\n\t\tthis.#driveResolver = fn;\n\t}\n\n\t/** The config this service was constructed with. */\n\tgetConfig(): Required<UploadConfig> {\n\t\treturn { ...this.#config };\n\t}\n\n\t/**\n\t * Parse the request body and store the requested fields on the\n\t * Hono context. Called by `uploadMiddleware`.\n\t */\n\tasync parseAndStore(\n\t\tc: any,\n\t\tfields: Array<{ fieldName: string; maxFiles: number; required: boolean }>,\n\t): Promise<void> {\n\t\tconst body = await this.#parseBody(c);\n\t\tconst stored: Record<string, UploadedFile | UploadedFile[]> = {};\n\n\t\tfor (const spec of fields) {\n\t\t\tconst value = body[spec.fieldName];\n\t\t\tconst files = this.#extractFiles(value);\n\t\t\tif (files.length === 0) {\n\t\t\t\tif (spec.required) {\n\t\t\t\t\tthrow new UploadError(\n\t\t\t\t\t\t\"MISSING_FIELD\",\n\t\t\t\t\t\tspec.fieldName,\n\t\t\t\t\t\t`Missing required field \"${spec.fieldName}\".`,\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tif (files.length > spec.maxFiles) {\n\t\t\t\tthrow new UploadError(\n\t\t\t\t\t\"TOO_MANY_FILES\",\n\t\t\t\t\tspec.fieldName,\n\t\t\t\t\t`Field \"${spec.fieldName}\" accepts at most ${spec.maxFiles} files (got ${files.length}).`,\n\t\t\t\t);\n\t\t\t}\n\t\t\tfor (const f of files) {\n\t\t\t\tthis.#validate(f, spec.fieldName);\n\t\t\t}\n\t\t\tstored[spec.fieldName] = files.length === 1 ? files[0]! : files;\n\t\t}\n\n\t\t// Stash on the Hono context so decorators can pull it.\n\t\tc.set(UPLOAD_STORAGE_KEY, stored);\n\n\t\t// Optional: push to drive storage.\n\t\tif (this.#config.driveToken && this.#driveResolver) {\n\t\t\tconst drive = this.#driveResolver(this.#config.driveToken);\n\t\t\tif (drive?.put) {\n\t\t\t\tfor (const [, entry] of Object.entries(stored)) {\n\t\t\t\t\tconst list = Array.isArray(entry) ? entry : [entry];\n\t\t\t\t\tfor (const file of list) {\n\t\t\t\t\t\tconst filename = this.#config.preserveFilename\n\t\t\t\t\t\t\t? file.filename\n\t\t\t\t\t\t\t: this.#newFilename(file);\n\t\t\t\t\t\tconst key = `${this.#config.drivePrefix}/${filename}`;\n\t\t\t\t\t\tawait drive.put(key, file.buffer, {\n\t\t\t\t\t\t\tcontentType: file.contentType,\n\t\t\t\t\t\t});\n\t\t\t\t\t\t(file as UploadedFile & { storedKey?: string }).storedKey = key;\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t}\n\n\t/**\n\t * Read a single file from the stored body. Used by `@UploadedFile`.\n\t */\n\tget(c: any, fieldName: string): UploadedFile | undefined {\n\t\tconst stored: Record<string, UploadedFile | UploadedFile[]> | undefined =\n\t\t\tc.get(UPLOAD_STORAGE_KEY);\n\t\tif (!stored) return undefined;\n\t\tconst v = stored[fieldName];\n\t\tif (Array.isArray(v)) return v[0];\n\t\treturn v;\n\t}\n\n\t/**\n\t * Read multiple files from the stored body. Used by `@UploadedFiles`.\n\t */\n\tgetAll(c: any, fieldName: string): UploadedFile[] {\n\t\tconst stored: Record<string, UploadedFile | UploadedFile[]> | undefined =\n\t\t\tc.get(UPLOAD_STORAGE_KEY);\n\t\tif (!stored) return [];\n\t\tconst v = stored[fieldName];\n\t\tif (Array.isArray(v)) return v;\n\t\tif (v) return [v];\n\t\treturn [];\n\t}\n\n\t// ---------------------------------------------------------------------------\n\t// Internal\n\t// ---------------------------------------------------------------------------\n\n\tasync #parseBody(c: any): Promise<Record<string, ParsedBodyValue>> {\n\t\t// Hono's parseBody returns Promise<unknown>. We pass `all: true`\n\t\t// so every field is included, not just the first.\n\t\tconst req = c.req?.raw ?? c.req;\n\t\tconst ct = (req.headers?.get?.(\"content-type\") ?? \"\") as string;\n\t\tif (!ct.startsWith(\"multipart/form-data\")) {\n\t\t\t// Not a multipart request — return empty body. The middleware\n\t\t\t// should skip parsing in this case.\n\t\t\treturn {};\n\t\t}\n\t\ttry {\n\t\t\treturn (await c.req.parseBody({ all: true })) as Record<string, ParsedBodyValue>;\n\t\t} catch (err) {\n\t\t\tthrow new UploadError(\n\t\t\t\t\"BAD_MULTIPART\",\n\t\t\t\t\"*\",\n\t\t\t\t`Failed to parse multipart body: ${(err as Error).message}`,\n\t\t\t);\n\t\t}\n\t}\n\n\t#extractFiles(value: ParsedBodyValue): UploadedFile[] {\n\t\tif (value === undefined || value === null) return [];\n\t\tconst list = Array.isArray(value) ? value : [value];\n\t\tconst out: UploadedFile[] = [];\n\t\tfor (const v of list) {\n\t\t\tif (typeof v === \"string\") continue; // skip plain text fields\n\t\t\tif (typeof v !== \"object\") continue;\n\t\t\tconst file = v as ParsedFileEntry;\n\t\t\tif (typeof file.arrayBuffer !== \"function\") continue;\n\t\t\t// Hono under Bun returns a Blob (not a File) for file fields.\n\t\t\t// The original filename lives in `name` (Blob) or `filename`\n\t\t\t// (File). Accept either.\n\t\t\tconst filename = (file as unknown as { filename?: string }).filename\n\t\t\t\t?? (file as unknown as { name?: string }).name\n\t\t\t\t?? \"upload\";\n\t\t\tconst contentType = file.type ?? \"application/octet-stream\";\n\t\t\tout.push({\n\t\t\t\tfieldName: file.name,\n\t\t\t\tfilename,\n\t\t\t\tcontentType,\n\t\t\t\tencoding: \"7bit\",\n\t\t\t\tbuffer: Buffer.alloc(0), // filled below\n\t\t\t\tsize: file.size ?? 0,\n\t\t\t});\n\t\t}\n\t\treturn out;\n\t}\n\n\t/**\n\t * After we've extracted the field list, replace each placeholder\n\t * with its real bytes. This is split out so we can do all the\n\t * parsing in parallel.\n\t */\n\t// placeholder for future async hydration.\n\n\t#validate(file: UploadedFile, fieldName: string): void {\n\t\tif (file.size > this.#config.maxFileSize) {\n\t\t\tthrow new UploadError(\n\t\t\t\t\"FILE_TOO_LARGE\",\n\t\t\t\tfieldName,\n\t\t\t\t`File \"${file.filename}\" is ${file.size} bytes; max is ${this.#config.maxFileSize}.`,\n\t\t\t);\n\t\t}\n\t\tif (!this.#mimeAllowed(file.contentType)) {\n\t\t\tthrow new UploadError(\n\t\t\t\t\"MIME_NOT_ALLOWED\",\n\t\t\t\tfieldName,\n\t\t\t\t`File \"${file.filename}\" has type \"${file.contentType}\"; not in the allow list.`,\n\t\t\t);\n\t\t}\n\t}\n\n\t#mimeAllowed(mime: string): boolean {\n\t\tfor (const pat of this.#config.allowedMimeTypes) {\n\t\t\tif (pat === \"*\") return true;\n\t\t\tif (pat === mime) return true;\n\t\t\tif (pat.endsWith(\"/*\")) {\n\t\t\t\tconst prefix = pat.slice(0, -2); // 'image/*' -> 'image/'\n\t\t\t\tif (mime.startsWith(prefix)) return true;\n\t\t\t}\n\t\t}\n\t\treturn false;\n\t}\n\n\t#newFilename(file: UploadedFile): string {\n\t\tconst ext = file.filename.includes(\".\")\n\t\t\t? file.filename.slice(file.filename.lastIndexOf(\".\"))\n\t\t\t: \"\";\n\t\tconst stamp = Date.now().toString(36);\n\t\tconst rand = Math.random().toString(36).slice(2, 8);\n\t\treturn `${stamp}-${rand}${ext}`;\n\t}\n}",
+    "/**\n * `UploadModule` — drop-in file upload handling.\n *\n *   @Module({\n *     imports: [\n *       UploadModule.forRoot({\n *         maxFileSize: 10 * 1024 * 1024,\n *         allowedMimeTypes: ['image/*', 'application/pdf'],\n *         storage: 'memory',\n *       }),\n *     ],\n *   })\n *\n * After the framework router is built, call `UploadModule.mount(app, svc)`\n * to install the multipart middleware. The middleware looks at\n * the route's metadata (set by `@Upload('fieldName')`) to know\n * which fields to parse.\n */\nimport \"reflect-metadata\";\nimport { Module } from \"../core/decorators/module.js\";\nimport { UploadService } from \"./upload.service.js\";\nimport type { UploadConfig } from \"./types.js\";\nimport { uploadMiddleware } from \"./upload.middleware.js\";\n\n@Module({\n\tproviders: [\n\t\tUploadService,\n\t\t{ provide: UploadService.TOKEN, useExisting: UploadService },\n\t],\n\texports: [UploadService, UploadService.TOKEN],\n})\nexport class UploadModule {\n\tstatic forRoot(config: UploadConfig = {}) {\n\t\t@Module({\n\t\t\tproviders: [\n\t\t\t\tUploadService,\n\t\t\t\t{ provide: UploadService.TOKEN, useExisting: UploadService },\n\t\t\t\t{ provide: \"UPLOAD_CONFIG\", useValue: config },\n\t\t\t],\n\t\t\texports: [UploadService, UploadService.TOKEN],\n\t\t})\n\t\tclass ConfiguredUploadModule {}\n\t\tObject.defineProperty(ConfiguredUploadModule, \"name\", {\n\t\t\tvalue: \"ConfiguredUploadModule\",\n\t\t});\n\t\treturn ConfiguredUploadModule;\n\t}\n\n\t/**\n\t * Install the multipart middleware on the Hono app. Walk the\n\t * route table, collect every `@Upload` decorator, and emit a\n\t * middleware that knows which fields to parse.\n\t */\n\tstatic mount(app: any, svc: UploadService, routes: any[] = []): void {\n\t\tconst fieldSet = new Map<string, { maxFiles: number; required: boolean }>();\n\t\tfor (const r of routes) {\n\t\t\tconst metas = (Reflect.getMetadata(\"nexus:upload:options\", r.target.constructor, r.propertyKey) ?? []) as Array<{ name: string; options: any }>;\n\t\t\tfor (const m of metas) {\n\t\t\t\tconst existing = fieldSet.get(m.name);\n\t\t\t\tconst maxFiles = m.options?.maxFiles ?? 1;\n\t\t\t\tconst required = m.options?.required ?? true;\n\t\t\t\tif (!existing || maxFiles > existing.maxFiles) {\n\t\t\t\t\tfieldSet.set(m.name, { maxFiles, required: existing?.required ?? required });\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t\t// Per-route middleware: we capture the fields for that route in\n\t\t// a closure. Hono supports per-route middleware via `app.use(path, mw)`.\n\t\tapp.use(\"/**\", async (c: any, next: () => Promise<any>) => {\n\t\t\tconst fields: Array<{ fieldName: string; maxFiles: number; required: boolean }> = [];\n\t\t\tfor (const [name, info] of fieldSet.entries()) {\n\t\t\t\tfields.push({ fieldName: name, ...info });\n\t\t\t}\n\t\t\tc.set(\"uploadFields\", fields);\n\t\t\treturn uploadMiddleware(svc)(c, next);\n\t\t});\n\t}\n}",
+    "/**\n * Hono middleware that parses multipart/form-data and stores the\n * requested fields on the Hono context. Routes that need\n * `@UploadedFile` opt in by:\n *\n *   1. Calling `uploadMiddleware(fieldSpecs)` to register the fields\n *      they expect.\n *   2. Or, listing the field names in the `@Upload(...)` decorator\n *      metadata, which the `UploadModule` reads to wire up the\n *      middleware at boot.\n *\n * For convenience, `UploadModule.mountAll()` walks the route table\n * and installs the middleware on every controller method that has\n * an `@Upload(...)` decorator.\n */\nimport { UploadError } from \"./types.js\";\n\nexport interface FieldSpec {\n\tfieldName: string;\n\tmaxFiles: number;\n\trequired: boolean;\n}\n\n/**\n * Middleware factory. Returns a Hono middleware that:\n *   1. Skips non-multipart requests.\n *   2. Asks the UploadService to parse and store the given fields.\n *   3. On `UploadError`, returns a 400 response with the error code.\n */\nexport function uploadMiddleware(svc: {\n\tparseAndStore(c: any, fields: FieldSpec[]): Promise<void>;\n}) {\n\treturn async (c: any, next: () => Promise<any>) => {\n\t\tconst ct = (c.req?.raw?.headers?.get?.(\"content-type\") ?? \"\") as string;\n\t\tif (!ct.startsWith(\"multipart/form-data\")) return next();\n\t\t// The fields are read off the route at boot. By the time this\n\t\t// middleware runs, `c.var` should have the route spec.\n\t\tconst fields: FieldSpec[] = (c.get?.(\"uploadFields\") as FieldSpec[] | undefined) ?? [];\n\t\tif (fields.length === 0) return next();\n\t\ttry {\n\t\t\tawait svc.parseAndStore(c, fields);\n\t\t\treturn next();\n\t\t} catch (err) {\n\t\t\tif (err instanceof UploadError) {\n\t\t\t\treturn c.json(\n\t\t\t\t\t{ error: err.message, code: err.code, field: err.field },\n\t\t\t\t\terr.status as any,\n\t\t\t\t);\n\t\t\t}\n\t\t\tthrow err;\n\t\t}\n\t};\n}\n",
+    "/**\n * `@Upload('fieldName', opts?)` — declare that a controller method\n * expects one or more uploaded files in `multipart/form-data`.\n *\n *   @Post('/avatars')\n *   @Upload('avatar')\n *   async upload(@UploadedFile('avatar') file: UploadedFile) { ... }\n *\n *   @Post('/photos')\n *   @Upload('photos', { maxFiles: 10 })\n *   async multi(@UploadedFiles('photos') files: UploadedFile[]) { ... }\n */\nimport \"reflect-metadata\";\nimport { UPLOAD_META, type UploadOptions } from \"../types.js\";\n\n/** Default name when the decorator is applied without arguments. */\nconst DEFAULT_NAME = \"__upload__\";\n\nexport function Upload(name: string = DEFAULT_NAME, options: UploadOptions = {}): MethodDecorator {\n\treturn (target: object, propertyKey: string | symbol) => {\n\t\tconst existing: Array<{ name: string; options: UploadOptions }> =\n\t\t\tReflect.getMetadata(UPLOAD_META, target.constructor, propertyKey) ?? [];\n\t\texisting.push({ name, options });\n\t\tReflect.defineMetadata(UPLOAD_META, existing, target.constructor, propertyKey);\n\t};\n}\n",
+    "/**\n * `@UploadedFile('fieldName')` — inject a single uploaded file into\n * the controller method.\n *\n * The framework pulls the parsed file from the Hono context (which\n * the upload middleware populated). If the field is missing and the\n * `@Upload` decorator declared it required, the middleware has\n * already returned a 400 — by the time we run, the file is either\n * present or the request is non-multipart.\n */\nimport { createParamDecorator } from \"../../core/decorators/params.js\";\nimport { UPLOAD_STORAGE_KEY } from \"../types.js\";\n\nexport const UploadedFile = (fieldName?: string) =>\n\tcreateParamDecorator(0x80 as any /* USER */, fieldName); // placeholder token\n\n// ---------------------------------------------------------------------\n// The decorator above is a placeholder for the framework's param\n// decorator factory. The actual pull-from-context logic is wired by\n// the framework's param resolver at boot. We re-export a helper\n// that, given a Hono context, returns the file.\n// ---------------------------------------------------------------------\n\n/**\n * Resolve a `@UploadedFile(name)` call against a Hono context. The\n * framework invokes this from its param pipeline. Application\n * code typically does not call this directly — use the decorator.\n */\nexport function getUploadedFile(c: any, fieldName: string) {\n\tconst stored = c.get?.(UPLOAD_STORAGE_KEY) ?? c.var?.[UPLOAD_STORAGE_KEY];\n\tif (!stored) return undefined;\n\tconst v = stored[fieldName];\n\tif (Array.isArray(v)) return v[0];\n\treturn v;\n}\n\n/** Resolve a `@UploadedFiles(name)` call. */\nexport function getUploadedFiles(c: any, fieldName: string) {\n\tconst stored = c.get?.(UPLOAD_STORAGE_KEY) ?? c.var?.[UPLOAD_STORAGE_KEY];\n\tif (!stored) return [];\n\tconst v = stored[fieldName];\n\tif (Array.isArray(v)) return v;\n\tif (v) return [v];\n\treturn [];\n}"
+  ],
+  "mappings": "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",
+  "debugId": "3B694CB87049E44264756E2164756E21",
+  "names": []
+}

package/dist/upload/types.d.ts

@@ -0,0 +1,103 @@
+/**
+ * `nexusjs/upload` — file upload helper.
+ *
+ *   @Module({
+ *     imports: [
+ *       UploadModule.forRoot({
+ *         maxFileSize: 10 * 1024 * 1024,   // 10MB per file
+ *         maxFiles: 5,
+ *         allowedMimeTypes: ['image/*', 'application/pdf'],
+ *         storage: 'memory',               // or 'drive' (uses nexus/drive)
+ *       }),
+ *     ],
+ *   })
+ *
+ *   @Post('/avatars')
+ *   @Upload('avatar')                    // form field name
+ *   async upload(@UploadedFile('avatar') file: UploadedFile) {
+ *     return { size: file.size, type: file.contentType };
+ *   }
+ *
+ *   @Post('/photos')
+ *   async multi(@UploadedFiles('photos') files: UploadedFile[]) {
+ *     return files.length;
+ *   }
+ */
+import "reflect-metadata";
+import { METADATA_KEY } from "../core/constants.js";
+/**
+ * A file that has been parsed from `multipart/form-data`.
+ *
+ * The framework reads the entire body into memory (with a hard cap
+ * enforced by `maxFileSize`) and exposes it as a `Buffer`. For very
+ * large files (gigabytes), use a streaming approach instead — the
+ * middleware leaves `stream` populated when the file is too large
+ * to buffer.
+ */
+export interface UploadedFile {
+    /** Form field name (e.g. "avatar", "photos"). */
+    fieldName: string;
+    /** Filename from the client (e.g. "my-photo.png"). */
+    filename: string;
+    /** MIME type from the client. */
+    contentType: string;
+    /** Encoding (typically '7bit'). */
+    encoding: string;
+    /** File content. */
+    buffer: Buffer;
+    /** Convenience: same as `buffer.length`. */
+    size: number;
+}
+/** Top-level config. */
+export interface UploadConfig {
+    /** Max bytes per file. Default: 10 MB. */
+    maxFileSize?: number;
+    /** Max number of files per request. Default: 5. */
+    maxFiles?: number;
+    /**
+     * Allowed MIME types. Supports `*` wildcards:
+     *   'image/*'   — any image type
+     *   'application/pdf'
+     *   'video/mp4'
+     * Default: '*' (any).
+     */
+    allowedMimeTypes?: string[];
+    /**
+     * Where parsed files are stored in memory. Default: 'memory'.
+     * The decorator reads from this storage on each access.
+     */
+    storage?: "memory";
+    /**
+     * When set, parsed files are also pushed to the configured
+     * `nexusjs/drive` storage under this prefix. The drive is
+     * resolved by the DI token string.
+     */
+    driveToken?: string;
+    drivePrefix?: string;
+    /** When using drive storage: keep the original filename. Default: false (UUID). */
+    preserveFilename?: boolean;
+}
+export interface UploadOptions {
+    /** Form field name. Default: property name. */
+    name?: string;
+    /** Per-field max size (overrides the global default). */
+    maxSize?: number;
+    /** Per-field MIME-type filter. */
+    mimeTypes?: string[];
+    /** Per-field max files (for multi-file). Default: 1. */
+    maxFiles?: number;
+    /** Whether the field is required. Default: true. */
+    required?: boolean;
+}
+export declare class UploadError extends Error {
+    readonly status = 400;
+    readonly code: string;
+    readonly field: string;
+    constructor(code: string, field: string, message: string);
+}
+/** Key under which the multipart middleware stores parsed files. */
+export declare const UPLOAD_STORAGE_KEY = "nexus:upload:files";
+/** Internal metadata key (decorator). */
+export declare const UPLOAD_META = "nexus:upload:options";
+export { METADATA_KEY };
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/upload/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAMpD;;;;;;;;GAQG;AACH,MAAM,WAAW,YAAY;IAC5B,iDAAiD;IACjD,SAAS,EAAE,MAAM,CAAC;IAClB,sDAAsD;IACtD,QAAQ,EAAE,MAAM,CAAC;IACjB,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,mCAAmC;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,oBAAoB;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAC;CACb;AAED,wBAAwB;AACxB,MAAM,WAAW,YAAY;IAC5B,0CAA0C;IAC1C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mDAAmD;IACnD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B;;;OAGG;IACH,OAAO,CAAC,EAAE,QAAQ,CAAC;IACnB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mFAAmF;IACnF,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC3B;AAMD,MAAM,WAAW,aAAa;IAC7B,+CAA+C;IAC/C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yDAAyD;IACzD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kCAAkC;IAClC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,wDAAwD;IACxD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oDAAoD;IACpD,QAAQ,CAAC,EAAE,OAAO,CAAC;CACnB;AAMD,qBAAa,WAAY,SAAQ,KAAK;IACrC,QAAQ,CAAC,MAAM,OAAO;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;gBACX,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAMxD;AAMD,oEAAoE;AACpE,eAAO,MAAM,kBAAkB,uBAAuB,CAAC;AAEvD,yCAAyC;AACzC,eAAO,MAAM,WAAW,yBAAyB,CAAC;AAElD,OAAO,EAAE,YAAY,EAAE,CAAC"}

package/dist/upload/upload.middleware.d.ts

@@ -0,0 +1,15 @@
+export interface FieldSpec {
+    fieldName: string;
+    maxFiles: number;
+    required: boolean;
+}
+/**
+ * Middleware factory. Returns a Hono middleware that:
+ *   1. Skips non-multipart requests.
+ *   2. Asks the UploadService to parse and store the given fields.
+ *   3. On `UploadError`, returns a 400 response with the error code.
+ */
+export declare function uploadMiddleware(svc: {
+    parseAndStore(c: any, fields: FieldSpec[]): Promise<void>;
+}): (c: any, next: () => Promise<any>) => Promise<any>;
+//# sourceMappingURL=upload.middleware.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"upload.middleware.d.ts","sourceRoot":"","sources":["../../src/upload/upload.middleware.ts"],"names":[],"mappings":"AAiBA,MAAM,WAAW,SAAS;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE;IACrC,aAAa,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1D,IACc,GAAG,GAAG,EAAE,MAAM,MAAM,OAAO,CAAC,GAAG,CAAC,kBAoB9C"}

package/dist/upload/upload.module.d.ts

@@ -0,0 +1,33 @@
+/**
+ * `UploadModule` — drop-in file upload handling.
+ *
+ *   @Module({
+ *     imports: [
+ *       UploadModule.forRoot({
+ *         maxFileSize: 10 * 1024 * 1024,
+ *         allowedMimeTypes: ['image/*', 'application/pdf'],
+ *         storage: 'memory',
+ *       }),
+ *     ],
+ *   })
+ *
+ * After the framework router is built, call `UploadModule.mount(app, svc)`
+ * to install the multipart middleware. The middleware looks at
+ * the route's metadata (set by `@Upload('fieldName')`) to know
+ * which fields to parse.
+ */
+import "reflect-metadata";
+import { UploadService } from "./upload.service.js";
+import type { UploadConfig } from "./types.js";
+export declare class UploadModule {
+    static forRoot(config?: UploadConfig): {
+        new (): {};
+    };
+    /**
+     * Install the multipart middleware on the Hono app. Walk the
+     * route table, collect every `@Upload` decorator, and emit a
+     * middleware that knows which fields to parse.
+     */
+    static mount(app: any, svc: UploadService, routes?: any[]): void;
+}
+//# sourceMappingURL=upload.module.d.ts.map

package/dist/upload/upload.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload.module.d.ts","sourceRoot":"","sources":["../../src/upload/upload.module.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,kBAAkB,CAAC;AAE1B,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG/C,qBAOa,YAAY;IACxB,MAAM,CAAC,OAAO,CAAC,MAAM,GAAE,YAAiB;;;IAgBxC;;;;OAIG;IACH,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,aAAa,EAAE,MAAM,GAAE,GAAG,EAAO,GAAG,IAAI;CAwBpE"}

package/dist/upload/upload.service.d.ts

@@ -0,0 +1,29 @@
+import { type UploadConfig, type UploadedFile } from "./types.js";
+export declare class UploadService {
+    #private;
+    /** DI token. */
+    static readonly TOKEN: unique symbol;
+    constructor(config?: UploadConfig);
+    /** Bind a function that resolves a DI token to a service. Set by the module on boot. */
+    bindDriveResolver(fn: (token: string) => any): void;
+    /** The config this service was constructed with. */
+    getConfig(): Required<UploadConfig>;
+    /**
+     * Parse the request body and store the requested fields on the
+     * Hono context. Called by `uploadMiddleware`.
+     */
+    parseAndStore(c: any, fields: Array<{
+        fieldName: string;
+        maxFiles: number;
+        required: boolean;
+    }>): Promise<void>;
+    /**
+     * Read a single file from the stored body. Used by `@UploadedFile`.
+     */
+    get(c: any, fieldName: string): UploadedFile | undefined;
+    /**
+     * Read multiple files from the stored body. Used by `@UploadedFiles`.
+     */
+    getAll(c: any, fieldName: string): UploadedFile[];
+}
+//# sourceMappingURL=upload.service.d.ts.map

package/dist/upload/upload.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload.service.d.ts","sourceRoot":"","sources":["../../src/upload/upload.service.ts"],"names":[],"mappings":"AAqBA,OAAO,EAGN,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,MAAM,YAAY,CAAC;AAoBpB,qBACa,aAAa;;IACzB,gBAAgB;IAChB,MAAM,CAAC,QAAQ,CAAC,KAAK,gBAAqC;gBAKrB,MAAM,GAAE,YAAiB;IAY9D,wFAAwF;IACxF,iBAAiB,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,GAAG,GAAG,IAAI;IAInD,oDAAoD;IACpD,SAAS,IAAI,QAAQ,CAAC,YAAY,CAAC;IAInC;;;OAGG;IACG,aAAa,CAClB,CAAC,EAAE,GAAG,EACN,MAAM,EAAE,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAC,GACvE,OAAO,CAAC,IAAI,CAAC;IAsDhB;;OAEG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IASxD;;OAEG;IACH,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,GAAG,YAAY,EAAE;CA2GjD"}

package/dist/view/edge.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Edge-style template engine adapter (Adonis-style).
+ *
+ * Edge is the templating engine built for AdonisJS with a mustache-like
+ * syntax (`{{ }}`, `@if`, `@each`). It is bundled here as a placeholder
+ * for users who prefer that style.
+ *
+ * The adapter does not bundle Edge directly — it expects the user to
+ * provide an `Edge` instance via the constructor so the dependency
+ * stays optional.
+ */
+import type { ViewAdapter, ViewContext, ViewOptions } from "./types.js";
+export interface EdgeLike {
+    renderRaw?: (template: string, data: Record<string, any>) => Promise<string>;
+    renderString?: (template: string, data: Record<string, any>) => Promise<string>;
+}
+export declare class EdgeAdapter implements ViewAdapter {
+    private edge?;
+    readonly name = "edge";
+    constructor(edge?: EdgeLike | undefined);
+    render(template: string, data: Record<string, any>, context?: ViewContext, options?: ViewOptions): Promise<string>;
+}
+//# sourceMappingURL=edge.d.ts.map

package/dist/view/edge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"edge.d.ts","sourceRoot":"","sources":["../../src/view/edge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAExE,MAAM,WAAW,QAAQ;IACxB,SAAS,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7E,YAAY,CAAC,EAAE,CACd,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KACrB,OAAO,CAAC,MAAM,CAAC,CAAC;CACrB;AAED,qBAAa,WAAY,YAAW,WAAW;IAElC,OAAO,CAAC,IAAI,CAAC;IADzB,QAAQ,CAAC,IAAI,UAAU;gBACH,IAAI,CAAC,EAAE,QAAQ,YAAA;IAE7B,MAAM,CACX,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACzB,OAAO,CAAC,EAAE,WAAW,EACrB,OAAO,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,MAAM,CAAC;CAgBlB"}

package/dist/view/eta.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Eta template engine adapter.
+ *
+ * Eta is a lightweight, high-performance templating engine with
+ * EJS-like syntax (`<%= expr %>`, `<% code %>`). It works on every
+ * runtime (Bun, Node, Deno, Cloudflare Workers) because templates
+ * are compiled to JavaScript render functions — no eval, no
+ * filesystem access at render time.
+ *
+ * Install (optional peer dep): `bun add eta`
+ *
+ *   import { EtaAdapter } from "nexusjs/view";
+ *   const eta = new EtaAdapter();
+ *   const html = await eta.render("<h1><%= it.title %></h1>", { title: "Hi" });
+ *
+ * Or just use a file with a `.eta` extension — `renderView` picks
+ * the Eta adapter automatically:
+ *
+ *   setViewPaths("views");
+ *   return { view: "about.eta", data: { title: "Hi" } };
+ */
+import type { ViewAdapter, ViewContext, ViewOptions } from "./types.js";
+export declare class EtaAdapter implements ViewAdapter {
+    readonly name = "eta";
+    private cache;
+    render(template: string, data: Record<string, any>, _context?: ViewContext, _options?: ViewOptions): Promise<string>;
+    compile(template: string, _options?: ViewOptions): (data: Record<string, any>) => Promise<string>;
+    private getCompiled;
+}
+//# sourceMappingURL=eta.d.ts.map

package/dist/view/eta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eta.d.ts","sourceRoot":"","sources":["../../src/view/eta.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAExE,qBAAa,UAAW,YAAW,WAAW;IAC7C,QAAQ,CAAC,IAAI,SAAS;IACtB,OAAO,CAAC,KAAK,CAA4D;IAEnE,MAAM,CACX,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACzB,QAAQ,CAAC,EAAE,WAAW,EACtB,QAAQ,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,MAAM,CAAC;IAKlB,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,WAAW,IAEvC,MAAM,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAGlC,OAAO,CAAC,WAAW;CAsBnB"}

package/dist/view/index.d.ts

@@ -0,0 +1,34 @@
+/**
+ * `nexusjs/view` — view engine adapter + file-based view loader.
+ *
+ * Public API:
+ * - `renderView(template, data, context?)` — render a view.
+ *   If `template` ends in a known file extension (`.html`, `.edge`,
+ *   `.rendu`, `.eta`) AND `setViewPaths()` has been called, the
+ *   file is loaded from the first matching directory and used
+ *   as the template source. Otherwise the string is treated as
+ *   inline source.
+ *   The adapter is selected by file extension (or Rendu for
+ *   inline / non-extension values).
+ * - `setViewPaths(path)` — configure the directory searched for
+ *   view files. Pass `""` to disable.
+ * - `getViewPaths()` — return the current path (empty = disabled).
+ * - `loadTemplate(dir, name)` — low-level: load a file from
+ *   the given directory.
+ * - `Application.setViewPaths(path)` — same as the module
+ *   function, but chainable.
+ *
+ * Adapters:
+ * - RenduAdapter  (default for `.html`/`.rendu`/inline)
+ * - EdgeAdapter   (for `.edge`)
+ * - EtaAdapter    (for `.eta`)
+ *
+ * Override with `app.setViewAdapter(new MyAdapter())` to install
+ * a different engine globally.
+ */
+export type { ViewAdapter, ViewContext, ViewOptions, } from "./types.js";
+export { RenduAdapter } from "./rendu.js";
+export { EdgeAdapter } from "./edge.js";
+export { EtaAdapter } from "./eta.js";
+export { renderView, loadTemplate, setViewPaths, getViewPaths, } from "./view-engine.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/view/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,YAAY,EACX,WAAW,EACX,WAAW,EACX,WAAW,GACX,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EACN,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,YAAY,GACZ,MAAM,kBAAkB,CAAC"}