@kabyeon/nexusjs 0.6.5

package/dist/mail/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/mail/types.ts", "../src/mail/transports/null.ts", "../src/mail/transports/file.ts", "../src/mail/transports/smtp.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/mail/mail.service.ts", "../src/mail/mail.module.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/mail` — outbound email.\n *\n *   const mail = new MailService({ transport: new SmtpTransport({ host: 'smtp.gmail.com' }) });\n *   await mail.send({\n *     from: 'no-reply@example.com',\n *     to: 'user@example.com',\n *     subject: 'Welcome',\n *     html: '<h1>Hi</h1>',\n *   });\n *\n * Transports:\n *   - `SmtpTransport`  — SMTP via nodemailer (peer dep)\n *   - `FileTransport`  — write .eml files to a directory (dev/test)\n *   - `NullTransport`  — drop everything (tests)\n *\n *   mail.renderMjml('template', { name: 'Kim' })  // compile MJML to HTML\n */\nimport \"reflect-metadata\";\n\n/** A single recipient. */\nexport type MailAddress = string | { name?: string; address: string };\n\n/** A mail message. */\nexport interface MailMessage {\n\tfrom?: MailAddress;\n\tto: MailAddress | MailAddress[];\n\tcc?: MailAddress | MailAddress[];\n\tbcc?: MailAddress | MailAddress[];\n\treplyTo?: MailAddress;\n\tsubject: string;\n\ttext?: string;\n\thtml?: string;\n\t/** Attachments. */\n\tattachments?: MailAttachment[];\n\t/** Custom headers. */\n\theaders?: Record<string, string>;\n\t/** Priority: 1 (high), 3 (normal), 5 (low). */\n\tpriority?: \"high\" | \"normal\" | \"low\";\n}\n\nexport interface MailAttachment {\n\tfilename: string;\n\t/** File content (Buffer / string). */\n\tcontent: Buffer | string;\n\t/** MIME type. Default: 'application/octet-stream'. */\n\tcontentType?: string;\n\t/** Content-ID for inline images. */\n\tcid?: string;\n}\n\n/** Result returned by a transport after sending. */\nexport interface MailSendResult {\n\t/** Transport-specific ID (e.g. SMTP message-id). */\n\tid: string;\n\t/** When the message was sent (unix-ms). */\n\tsentAt: number;\n}\n\n/** Transport that knows how to deliver a message. */\nexport interface MailTransport {\n\treadonly kind: string;\n\tsend(msg: MailMessage): Promise<MailSendResult>;\n\tclose?(): Promise<void>;\n}\n\n/** Top-level config. */\nexport interface MailConfig {\n\t/** Transport backend. Default: NullTransport. */\n\ttransport?: MailTransport;\n\t/** Default `from` address. */\n\tdefaultFrom?: MailAddress;\n\t/** Whether to expose raw `nodemailer` (only if SmtpTransport is used). */\n\tdebug?: boolean;\n}\n",
+    "/**\n * Null mail transport. Drops every message. Useful in tests.\n */\nimport type { MailMessage, MailSendResult, MailTransport } from \"../types.js\";\n\nexport class NullTransport implements MailTransport {\n\treadonly kind = \"null\";\n\t/** Captured messages for inspection in tests. */\n\tsent: MailMessage[] = [];\n\n\tasync send(msg: MailMessage): Promise<MailSendResult> {\n\t\tthis.sent.push(msg);\n\t\treturn {\n\t\t\tid: `null-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`,\n\t\t\tsentAt: Date.now(),\n\t\t};\n\t}\n}\n",
+    "/**\n * File mail transport. Writes each outgoing message as a `.eml` file\n * under a directory. Useful for development and acceptance tests.\n *\n *   new FileTransport({ dir: './tmp/mail', pretty: true });\n */\nimport { mkdir, writeFile } from \"node:fs/promises\";\nimport { join } from \"node:path\";\nimport type { MailMessage, MailSendResult, MailTransport } from \"../types.js\";\n\nexport interface FileTransportOptions {\n\t/** Directory where `.eml` files are written. */\n\tdir: string;\n\t/** Format the .eml with proper headers (true) or just the body (false). Default: true. */\n\tincludeHeaders?: boolean;\n\t/** Pretty-print JSON content-type bodies. */\n\tpretty?: boolean;\n}\n\nexport class FileTransport implements MailTransport {\n\treadonly kind = \"file\";\n\tprivate opts: Required<FileTransportOptions>;\n\n\tconstructor(opts: FileTransportOptions) {\n\t\tthis.opts = {\n\t\t\tdir: opts.dir,\n\t\t\tincludeHeaders: opts.includeHeaders ?? true,\n\t\t\tpretty: opts.pretty ?? true,\n\t\t};\n\t}\n\n\tasync send(msg: MailMessage): Promise<MailSendResult> {\n\t\tawait mkdir(this.opts.dir, { recursive: true });\n\t\tconst id = `${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;\n\t\tconst filename = `${id}.eml`;\n\t\tconst body = this.opts.includeHeaders ? this.toEml(msg) : this.toBody(msg);\n\t\tawait writeFile(join(this.opts.dir, filename), body, \"utf-8\");\n\t\treturn { id, sentAt: Date.now() };\n\t}\n\n\tprivate toEml(msg: MailMessage): string {\n\t\tconst headers: string[] = [];\n\t\tif (msg.from) headers.push(`From: ${this.formatAddr(msg.from)}`);\n\t\theaders.push(`To: ${this.formatAddr(msg.to)}`);\n\t\tif (msg.cc) headers.push(`Cc: ${this.formatAddr(msg.cc)}`);\n\t\tif (msg.replyTo) headers.push(`Reply-To: ${this.formatAddr(msg.replyTo)}`);\n\t\theaders.push(`Subject: ${msg.subject}`);\n\t\theaders.push(`Date: ${new Date().toUTCString()}`);\n\t\theaders.push(`MIME-Version: 1.0`);\n\t\tif (msg.html) {\n\t\t\theaders.push(`Content-Type: text/html; charset=utf-8`);\n\t\t} else {\n\t\t\theaders.push(`Content-Type: text/plain; charset=utf-8`);\n\t\t}\n\t\tconst body = msg.html ?? msg.text ?? \"\";\n\t\treturn `${headers.join(\"\\r\\n\")}\\r\\n\\r\\n${body}`;\n\t}\n\n\tprivate toBody(msg: MailMessage): string {\n\t\treturn msg.html ?? msg.text ?? \"\";\n\t}\n\n\tprivate formatAddr(a: MailMessage[\"to\"]): string {\n\t\tif (Array.isArray(a)) return a.map((x) => this.formatAddr(x)).join(\", \");\n\t\tif (typeof a === \"string\") return a;\n\t\treturn a.name ? `${a.name} <${a.address}>` : a.address;\n\t}\n}\n",
+    "/**\n * SMTP mail transport. Uses `nodemailer` as an optional peer dep.\n *\n *   const transport = new SmtpTransport({\n *     host: 'smtp.gmail.com',\n *     port: 465,\n *     secure: true,\n *     auth: { user: '...', pass: '...' },\n *   });\n *   const mail = new MailService({ transport });\n */\nimport type { MailMessage, MailSendResult, MailTransport } from \"../types.js\";\n\nexport interface SmtpTransportOptions {\n\thost: string;\n\tport?: number;\n\tsecure?: boolean;\n\tauth?: { user: string; pass: string };\n\t/** Optional pool of pre-opened connections. */\n\tpool?: boolean;\n\t/** Maximum connections. */\n\tmaxConnections?: number;\n\t/** Sender override. */\n\tdefaultFrom?: string;\n\t/** `nodemailer` extra options. */\n\textras?: Record<string, any>;\n}\n\nexport class SmtpTransport implements MailTransport {\n\treadonly kind = \"smtp\";\n\tprivate opts: SmtpTransportOptions;\n\tprivate _transporter: any = null;\n\n\tconstructor(opts: SmtpTransportOptions) {\n\t\tthis.opts = opts;\n\t}\n\n\tprivate async transporter() {\n\t\tif (this._transporter) return this._transporter;\n\t\ttry {\n\t\t\tconst mod = await import(\"nodemailer\");\n\t\t\tthis._transporter = mod.default.createTransport({\n\t\t\t\thost: this.opts.host,\n\t\t\t\tport: this.opts.port,\n\t\t\t\tsecure: this.opts.secure,\n\t\t\t\tauth: this.opts.auth,\n\t\t\t\tpool: this.opts.pool,\n\t\t\t\tmaxConnections: this.opts.maxConnections,\n\t\t\t\t...this.opts.extras,\n\t\t\t});\n\t\t} catch (err) {\n\t\t\tthrow new Error(\n\t\t\t\t\"SmtpTransport requires nodemailer. Install it with: bun add nodemailer\",\n\t\t\t);\n\t\t}\n\t\treturn this._transporter;\n\t}\n\n\tasync send(msg: MailMessage): Promise<MailSendResult> {\n\t\tconst t = await this.transporter();\n\t\tconst from = this.formatAddr(msg.from ?? this.opts.defaultFrom);\n\t\tconst res = await t.sendMail({\n\t\t\tfrom,\n\t\t\tto: this.formatAddr(msg.to),\n\t\t\tcc: msg.cc ? this.formatAddr(msg.cc) : undefined,\n\t\t\tbcc: msg.bcc ? this.formatAddr(msg.bcc) : undefined,\n\t\t\treplyTo: msg.replyTo ? this.formatAddr(msg.replyTo) : undefined,\n\t\t\tsubject: msg.subject,\n\t\t\ttext: msg.text,\n\t\t\thtml: msg.html,\n\t\t\tattachments: msg.attachments?.map((a) => ({\n\t\t\t\tfilename: a.filename,\n\t\t\t\tcontent: a.content,\n\t\t\t\tcontentType: a.contentType,\n\t\t\t\tcid: a.cid,\n\t\t\t})),\n\t\t\theaders: msg.headers,\n\t\t\tpriority: msg.priority,\n\t\t});\n\t\treturn {\n\t\t\tid: res.messageId ?? `smtp-${Date.now()}`,\n\t\t\tsentAt: Date.now(),\n\t\t};\n\t}\n\n\tasync close(): Promise<void> {\n\t\tif (this._transporter) {\n\t\t\tawait this._transporter.close();\n\t\t\tthis._transporter = null;\n\t\t}\n\t}\n\n\tprivate formatAddr(a: MailMessage[\"to\"] | undefined): string {\n\t\tif (!a) return \"\";\n\t\tif (Array.isArray(a)) return a.map((x) => this.formatAddr(x)).join(\", \");\n\t\tif (typeof a === \"string\") return a;\n\t\treturn a.name ? `${a.name} <${a.address}>` : a.address;\n\t}\n}\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 * `MailService` — main entry point for outbound mail.\n *\n *   const mail = new MailService({ transport: new NullTransport() });\n *   await mail.send({ to: 'a@b.com', subject: 'hi', html: '<h1>hi</h1>' });\n *\n *   mail.renderMjml('<mjml>...</mjml>', { name: 'Kim' });\n */\nimport { Inject, Injectable } from \"../core/decorators/index.js\";\nimport { NullTransport } from \"./transports/null.js\";\nimport type {\n\tMailConfig,\n\tMailMessage,\n\tMailSendResult,\n\tMailTransport,\n} from \"./types.js\";\n\n@Injectable()\nexport class MailService {\n\t/** DI token. */\n\tstatic readonly TOKEN = Symbol.for(\"nexus:MailService\");\n\n\ttransport: MailTransport;\n\tdefaultFrom?: MailConfig[\"defaultFrom\"];\n\n\tconstructor(@Inject(\"MAIL_CONFIG\") config: MailConfig = {}) {\n\t\tthis.transport = config.transport ?? new NullTransport();\n\t\tthis.defaultFrom = config.defaultFrom;\n\t}\n\n\t/** Send a single message. */\n\tasync send(msg: MailMessage): Promise<MailSendResult> {\n\t\tconst full = { ...msg, from: msg.from ?? this.defaultFrom };\n\t\treturn this.transport.send(full);\n\t}\n\n\t/** Send the same message to many recipients (one envelope per call). */\n\tasync sendBatch(msg: Omit<MailMessage, \"to\">, recipients: string[]): Promise<MailSendResult[]> {\n\t\tconst results: MailSendResult[] = [];\n\t\tfor (const to of recipients) {\n\t\t\tresults.push(await this.send({ ...msg, to }));\n\t\t}\n\t\treturn results;\n\t}\n\n\t/**\n\t * Render an MJML template. The optional `mjml` peer dep is loaded lazily.\n\t * Throws a clear error if not installed.\n\t */\n\tasync renderMjml(template: string, _vars?: Record<string, unknown>): Promise<string> {\n\t\ttry {\n\t\t\tconst mod = await import(\"mjml\");\n\t\t\tconst { html } = mod.mjml2html(template);\n\t\t\treturn html;\n\t\t} catch (err) {\n\t\t\tthrow new Error(\n\t\t\t\t\"renderMjml requires the 'mjml' package. Install it with: bun add mjml\",\n\t\t\t);\n\t\t}\n\t}\n}\n",
+    "/**\n * `MailModule` — drop-in mail.\n *\n *   @Module({\n *     imports: [\n *       MailModule.forRoot({\n *         transport: new SmtpTransport({ host: 'smtp.example.com' }),\n *         defaultFrom: 'no-reply@example.com',\n *       }),\n *     ],\n *   })\n *   export class AppModule {}\n */\nimport \"reflect-metadata\";\nimport { Module } from \"../core/decorators/module.js\";\nimport { MailService } from \"./mail.service.js\";\nimport { NullTransport } from \"./transports/null.js\";\nimport type { MailConfig } from \"./types.js\";\n\n@Module({\n\tproviders: [\n\t\tMailService,\n\t\t{ provide: MailService.TOKEN, useExisting: MailService },\n\t],\n\texports: [MailService, MailService.TOKEN],\n})\nexport class MailModule {\n\tstatic forRoot(config: MailConfig = {}) {\n\t\tconst cfg: MailConfig = {\n\t\t\ttransport: new NullTransport(),\n\t\t\t...config,\n\t\t};\n\t\t@Module({\n\t\t\tproviders: [\n\t\t\t\tMailService,\n\t\t\t\t{ provide: MailService.TOKEN, useExisting: MailService },\n\t\t\t\t{ provide: \"MAIL_CONFIG\", useValue: cfg },\n\t\t\t],\n\t\t\texports: [MailService, MailService.TOKEN],\n\t\t})\n\t\tclass ConfiguredMailModule {}\n\t\tObject.defineProperty(ConfiguredMailModule, \"name\", {\n\t\t\tvalue: \"ConfiguredMailModule\",\n\t\t});\n\t\treturn ConfiguredMailModule;\n\t}\n}\n"
+  ],
+  "mappings": "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",
+  "debugId": "EF3070FAE1F17C4164756E2164756E21",
+  "names": []
+}

package/dist/mail/mail.module.d.ts

@@ -0,0 +1,21 @@
+/**
+ * `MailModule` — drop-in mail.
+ *
+ *   @Module({
+ *     imports: [
+ *       MailModule.forRoot({
+ *         transport: new SmtpTransport({ host: 'smtp.example.com' }),
+ *         defaultFrom: 'no-reply@example.com',
+ *       }),
+ *     ],
+ *   })
+ *   export class AppModule {}
+ */
+import "reflect-metadata";
+import type { MailConfig } from "./types.js";
+export declare class MailModule {
+    static forRoot(config?: MailConfig): {
+        new (): {};
+    };
+}
+//# sourceMappingURL=mail.module.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mail.module.d.ts","sourceRoot":"","sources":["../../src/mail/mail.module.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,kBAAkB,CAAC;AAI1B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,qBAOa,UAAU;IACtB,MAAM,CAAC,OAAO,CAAC,MAAM,GAAE,UAAe;;;CAmBtC"}

package/dist/mail/mail.service.d.ts

@@ -0,0 +1,18 @@
+import type { MailConfig, MailMessage, MailSendResult, MailTransport } from "./types.js";
+export declare class MailService {
+    /** DI token. */
+    static readonly TOKEN: unique symbol;
+    transport: MailTransport;
+    defaultFrom?: MailConfig["defaultFrom"];
+    constructor(config?: MailConfig);
+    /** Send a single message. */
+    send(msg: MailMessage): Promise<MailSendResult>;
+    /** Send the same message to many recipients (one envelope per call). */
+    sendBatch(msg: Omit<MailMessage, "to">, recipients: string[]): Promise<MailSendResult[]>;
+    /**
+     * Render an MJML template. The optional `mjml` peer dep is loaded lazily.
+     * Throws a clear error if not installed.
+     */
+    renderMjml(template: string, _vars?: Record<string, unknown>): Promise<string>;
+}
+//# sourceMappingURL=mail.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mail.service.d.ts","sourceRoot":"","sources":["../../src/mail/mail.service.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EACX,UAAU,EACV,WAAW,EACX,cAAc,EACd,aAAa,EACb,MAAM,YAAY,CAAC;AAEpB,qBACa,WAAW;IACvB,gBAAgB;IAChB,MAAM,CAAC,QAAQ,CAAC,KAAK,gBAAmC;IAExD,SAAS,EAAE,aAAa,CAAC;IACzB,WAAW,CAAC,EAAE,UAAU,CAAC,aAAa,CAAC,CAAC;gBAEL,MAAM,GAAE,UAAe;IAK1D,6BAA6B;IACvB,IAAI,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,CAAC;IAKrD,wEAAwE;IAClE,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAQ9F;;;OAGG;IACG,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;CAWpF"}

package/dist/mail/transports/file.d.ts

@@ -0,0 +1,19 @@
+import type { MailMessage, MailSendResult, MailTransport } from "../types.js";
+export interface FileTransportOptions {
+    /** Directory where `.eml` files are written. */
+    dir: string;
+    /** Format the .eml with proper headers (true) or just the body (false). Default: true. */
+    includeHeaders?: boolean;
+    /** Pretty-print JSON content-type bodies. */
+    pretty?: boolean;
+}
+export declare class FileTransport implements MailTransport {
+    readonly kind = "file";
+    private opts;
+    constructor(opts: FileTransportOptions);
+    send(msg: MailMessage): Promise<MailSendResult>;
+    private toEml;
+    private toBody;
+    private formatAddr;
+}
+//# sourceMappingURL=file.d.ts.map

package/dist/mail/transports/file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.d.ts","sourceRoot":"","sources":["../../../src/mail/transports/file.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE9E,MAAM,WAAW,oBAAoB;IACpC,gDAAgD;IAChD,GAAG,EAAE,MAAM,CAAC;IACZ,0FAA0F;IAC1F,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,6CAA6C;IAC7C,MAAM,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,qBAAa,aAAc,YAAW,aAAa;IAClD,QAAQ,CAAC,IAAI,UAAU;IACvB,OAAO,CAAC,IAAI,CAAiC;gBAEjC,IAAI,EAAE,oBAAoB;IAQhC,IAAI,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,CAAC;IASrD,OAAO,CAAC,KAAK;IAkBb,OAAO,CAAC,MAAM;IAId,OAAO,CAAC,UAAU;CAKlB"}

package/dist/mail/transports/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Transports barrel.
+ */
+export { NullTransport } from "./null.js";
+export { FileTransport } from "./file.js";
+export type { FileTransportOptions } from "./file.js";
+export { SmtpTransport } from "./smtp.js";
+export type { SmtpTransportOptions } from "./smtp.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/mail/transports/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/mail/transports/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,YAAY,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,YAAY,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC"}

package/dist/mail/transports/null.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Null mail transport. Drops every message. Useful in tests.
+ */
+import type { MailMessage, MailSendResult, MailTransport } from "../types.js";
+export declare class NullTransport implements MailTransport {
+    readonly kind = "null";
+    /** Captured messages for inspection in tests. */
+    sent: MailMessage[];
+    send(msg: MailMessage): Promise<MailSendResult>;
+}
+//# sourceMappingURL=null.d.ts.map

package/dist/mail/transports/null.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"null.d.ts","sourceRoot":"","sources":["../../../src/mail/transports/null.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE9E,qBAAa,aAAc,YAAW,aAAa;IAClD,QAAQ,CAAC,IAAI,UAAU;IACvB,iDAAiD;IACjD,IAAI,EAAE,WAAW,EAAE,CAAM;IAEnB,IAAI,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,CAAC;CAOrD"}

package/dist/mail/transports/smtp.d.ts

@@ -0,0 +1,40 @@
+/**
+ * SMTP mail transport. Uses `nodemailer` as an optional peer dep.
+ *
+ *   const transport = new SmtpTransport({
+ *     host: 'smtp.gmail.com',
+ *     port: 465,
+ *     secure: true,
+ *     auth: { user: '...', pass: '...' },
+ *   });
+ *   const mail = new MailService({ transport });
+ */
+import type { MailMessage, MailSendResult, MailTransport } from "../types.js";
+export interface SmtpTransportOptions {
+    host: string;
+    port?: number;
+    secure?: boolean;
+    auth?: {
+        user: string;
+        pass: string;
+    };
+    /** Optional pool of pre-opened connections. */
+    pool?: boolean;
+    /** Maximum connections. */
+    maxConnections?: number;
+    /** Sender override. */
+    defaultFrom?: string;
+    /** `nodemailer` extra options. */
+    extras?: Record<string, any>;
+}
+export declare class SmtpTransport implements MailTransport {
+    readonly kind = "smtp";
+    private opts;
+    private _transporter;
+    constructor(opts: SmtpTransportOptions);
+    private transporter;
+    send(msg: MailMessage): Promise<MailSendResult>;
+    close(): Promise<void>;
+    private formatAddr;
+}
+//# sourceMappingURL=smtp.d.ts.map

package/dist/mail/transports/smtp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smtp.d.ts","sourceRoot":"","sources":["../../../src/mail/transports/smtp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE9E,MAAM,WAAW,oBAAoB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACtC,+CAA+C;IAC/C,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,2BAA2B;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,uBAAuB;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kCAAkC;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC7B;AAED,qBAAa,aAAc,YAAW,aAAa;IAClD,QAAQ,CAAC,IAAI,UAAU;IACvB,OAAO,CAAC,IAAI,CAAuB;IACnC,OAAO,CAAC,YAAY,CAAa;gBAErB,IAAI,EAAE,oBAAoB;YAIxB,WAAW;IAqBnB,IAAI,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,CAAC;IA2B/C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAO5B,OAAO,CAAC,UAAU;CAMlB"}

package/dist/mail/types.d.ts

@@ -0,0 +1,73 @@
+/**
+ * `nexusjs/mail` — outbound email.
+ *
+ *   const mail = new MailService({ transport: new SmtpTransport({ host: 'smtp.gmail.com' }) });
+ *   await mail.send({
+ *     from: 'no-reply@example.com',
+ *     to: 'user@example.com',
+ *     subject: 'Welcome',
+ *     html: '<h1>Hi</h1>',
+ *   });
+ *
+ * Transports:
+ *   - `SmtpTransport`  — SMTP via nodemailer (peer dep)
+ *   - `FileTransport`  — write .eml files to a directory (dev/test)
+ *   - `NullTransport`  — drop everything (tests)
+ *
+ *   mail.renderMjml('template', { name: 'Kim' })  // compile MJML to HTML
+ */
+import "reflect-metadata";
+/** A single recipient. */
+export type MailAddress = string | {
+    name?: string;
+    address: string;
+};
+/** A mail message. */
+export interface MailMessage {
+    from?: MailAddress;
+    to: MailAddress | MailAddress[];
+    cc?: MailAddress | MailAddress[];
+    bcc?: MailAddress | MailAddress[];
+    replyTo?: MailAddress;
+    subject: string;
+    text?: string;
+    html?: string;
+    /** Attachments. */
+    attachments?: MailAttachment[];
+    /** Custom headers. */
+    headers?: Record<string, string>;
+    /** Priority: 1 (high), 3 (normal), 5 (low). */
+    priority?: "high" | "normal" | "low";
+}
+export interface MailAttachment {
+    filename: string;
+    /** File content (Buffer / string). */
+    content: Buffer | string;
+    /** MIME type. Default: 'application/octet-stream'. */
+    contentType?: string;
+    /** Content-ID for inline images. */
+    cid?: string;
+}
+/** Result returned by a transport after sending. */
+export interface MailSendResult {
+    /** Transport-specific ID (e.g. SMTP message-id). */
+    id: string;
+    /** When the message was sent (unix-ms). */
+    sentAt: number;
+}
+/** Transport that knows how to deliver a message. */
+export interface MailTransport {
+    readonly kind: string;
+    send(msg: MailMessage): Promise<MailSendResult>;
+    close?(): Promise<void>;
+}
+/** Top-level config. */
+export interface MailConfig {
+    /** Transport backend. Default: NullTransport. */
+    transport?: MailTransport;
+    /** Default `from` address. */
+    defaultFrom?: MailAddress;
+    /** Whether to expose raw `nodemailer` (only if SmtpTransport is used). */
+    debug?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/mail/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,kBAAkB,CAAC;AAE1B,0BAA0B;AAC1B,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtE,sBAAsB;AACtB,MAAM,WAAW,WAAW;IAC3B,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,EAAE,EAAE,WAAW,GAAG,WAAW,EAAE,CAAC;IAChC,EAAE,CAAC,EAAE,WAAW,GAAG,WAAW,EAAE,CAAC;IACjC,GAAG,CAAC,EAAE,WAAW,GAAG,WAAW,EAAE,CAAC;IAClC,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mBAAmB;IACnB,WAAW,CAAC,EAAE,cAAc,EAAE,CAAC;IAC/B,sBAAsB;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;CACrC;AAED,MAAM,WAAW,cAAc;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,sCAAsC;IACtC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,sDAAsD;IACtD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oCAAoC;IACpC,GAAG,CAAC,EAAE,MAAM,CAAC;CACb;AAED,oDAAoD;AACpD,MAAM,WAAW,cAAc;IAC9B,oDAAoD;IACpD,EAAE,EAAE,MAAM,CAAC;IACX,2CAA2C;IAC3C,MAAM,EAAE,MAAM,CAAC;CACf;AAED,qDAAqD;AACrD,MAAM,WAAW,aAAa;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAChD,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,wBAAwB;AACxB,MAAM,WAAW,UAAU;IAC1B,iDAAiD;IACjD,SAAS,CAAC,EAAE,aAAa,CAAC;IAC1B,8BAA8B;IAC9B,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,0EAA0E;IAC1E,KAAK,CAAC,EAAE,OAAO,CAAC;CAChB"}

package/dist/metrics/controller.d.ts

@@ -0,0 +1,27 @@
+/**
+ * `MetricsController` — exposes `GET /metrics` for Prometheus
+ * scrapers. Supports content negotiation: the response format is
+ * `text/plain` (Prometheus 0.0.4) by default, or
+ * `application/openmetrics-text` if the request asks for it.
+ *
+ * The controller is auto-mounted by `MetricsModule.forRoot()`. If
+ * you want to mount it manually (e.g. on a different path), call
+ * `MetricsController.handler(service)` and wire it up yourself.
+ */
+import type { Context } from "hono";
+import type { MetricsService } from "./service.js";
+export declare class MetricsController {
+    static readonly PATH = "/metrics";
+    /**
+     * Returns a Hono handler that serves the /metrics endpoint.
+     *
+     * @example
+     *   app.get("/metrics", MetricsController.handler(svc));
+     */
+    static handler(service: MetricsService): (c: Context) => Response & import("hono").TypedResponse<string, 200, "body">;
+    /** Mount the controller on the given Hono app at `path`. */
+    static mount(app: {
+        get: (path: string, ...handlers: unknown[]) => unknown;
+    }, service: MetricsService, path?: string): void;
+}
+//# sourceMappingURL=controller.d.ts.map

package/dist/metrics/controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller.d.ts","sourceRoot":"","sources":["../../src/metrics/controller.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACpC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,qBAAa,iBAAiB;IAC7B,MAAM,CAAC,QAAQ,CAAC,IAAI,cAAc;IAElC;;;;;OAKG;IACH,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,cAAc,IAC7B,GAAG,OAAO;IAWnB,4DAA4D;IAC5D,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE;QAAE,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,QAAQ,EAAE,OAAO,EAAE,KAAK,OAAO,CAAA;KAAE,EAAE,OAAO,EAAE,cAAc,EAAE,IAAI,GAAE,MAA+B,GAAG,IAAI;CAGnJ"}

package/dist/metrics/counter.d.ts

@@ -0,0 +1,36 @@
+/**
+ * `Counter` — monotonically increasing value.
+ *
+ * Counters can only go up (use `Gauge` for values that can decrease).
+ * They're ideal for: request counts, error counts, bytes sent, etc.
+ *
+ * The standard Prometheus naming convention is to suffix counters
+ * with `_total`.
+ *
+ * Example:
+ *   const c = new Counter({ name: "http_requests_total" });
+ *   c.inc();
+ *   c.incBy(5, { method: "GET" });
+ */
+import type { CounterOptions, Counter as ICounter, MetricSample } from "./types.js";
+/** Internal helper used by all metric types. */
+export declare function renderLabels(declared: string[], values: Record<string, string>): string;
+export declare class CounterImpl implements ICounter {
+    readonly name: string;
+    readonly help?: string;
+    readonly labelNames: string[];
+    /** Map from "label1=value1,label2=value2" -> value. */
+    private values;
+    constructor(opts: CounterOptions);
+    inc(labels?: Record<string, string>): void;
+    incBy(n: number, labels?: Record<string, string>): void;
+    reset(): void;
+    getSamples(): MetricSample[];
+    /** Render this counter in Prometheus exposition format. */
+    renderPrometheus(): string;
+    private assertLabels;
+    private key;
+    private parseKey;
+}
+export declare function escapeLabelValue(v: string): string;
+//# sourceMappingURL=counter.d.ts.map

package/dist/metrics/counter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"counter.d.ts","sourceRoot":"","sources":["../../src/metrics/counter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,OAAO,IAAI,QAAQ,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAEpF,gDAAgD;AAChD,wBAAgB,YAAY,CAC3B,QAAQ,EAAE,MAAM,EAAE,EAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC5B,MAAM,CAKR;AAED,qBAAa,WAAY,YAAW,QAAQ;IAC3C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC;IAC9B,uDAAuD;IACvD,OAAO,CAAC,MAAM,CAA6B;gBAE/B,IAAI,EAAE,cAAc;IAMhC,GAAG,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAI1C,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IASvD,KAAK,IAAI,IAAI;IAIb,UAAU,IAAI,YAAY,EAAE;IAQ5B,2DAA2D;IAC3D,gBAAgB,IAAI,MAAM;IAY1B,OAAO,CAAC,YAAY;IAepB,OAAO,CAAC,GAAG;IAKX,OAAO,CAAC,QAAQ;CAShB;AAED,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAElD"}

package/dist/metrics/decorators/counted.d.ts

@@ -0,0 +1,26 @@
+/**
+ * `@Counted()` — class-method decorator that increments a counter
+ * on each call.
+ *
+ * Usage:
+ *   class UserController {
+ *     @Counted('http_requests_total', { labels: () => ({ method: 'GET' }) })
+ *     list() { ... }
+ *   }
+ *
+ * The decorator reads the `MetricsService` from the global registry
+ * (set by `MetricsModule.forRoot()`). When no service is registered
+ * the decorator is a pass-through.
+ */
+export interface CountedOptions {
+    /** Optional label values, computed at call time. */
+    labels?: () => Record<string, string>;
+}
+/**
+ * Method decorator: increment a counter on each invocation.
+ *
+ * The counter is registered lazily the first time the method is
+ * called, using the service from the global registry.
+ */
+export declare function Counted(metricName: string, options?: CountedOptions): (_target: object, _propertyKey: string | symbol, descriptor: PropertyDescriptor) => PropertyDescriptor;
+//# sourceMappingURL=counted.d.ts.map

package/dist/metrics/decorators/counted.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"counted.d.ts","sourceRoot":"","sources":["../../../src/metrics/decorators/counted.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,MAAM,WAAW,cAAc;IAC9B,oDAAoD;IACpD,MAAM,CAAC,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACtC;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,IACtD,SAAS,MAAM,EAAE,cAAc,MAAM,GAAG,MAAM,EAAE,YAAY,kBAAkB,wBAqC/F"}

package/dist/metrics/decorators/index.d.ts

@@ -0,0 +1,3 @@
+export { Counted, type CountedOptions } from "./counted.js";
+export { Timed, type TimedOptions } from "./timed.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/metrics/decorators/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/metrics/decorators/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,EAAE,KAAK,EAAE,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC"}

package/dist/metrics/decorators/timed.d.ts

@@ -0,0 +1,25 @@
+/**
+ * `@Timed()` — class-method decorator that records a method's
+ * duration in a histogram.
+ *
+ * Usage:
+ *   class UserController {
+ *     @Timed('http_request_duration_seconds', { labels: () => ({ method: 'GET' }) })
+ *     list() { ... }
+ *   }
+ *
+ * The decorator reads the `MetricsService` from the global registry.
+ * When no service is registered the decorator is a pass-through.
+ */
+export interface TimedOptions {
+    /** Optional buckets override. */
+    buckets?: number[];
+    /** Optional label values, computed at call time. */
+    labels?: () => Record<string, string>;
+}
+/**
+ * Method decorator: observe a method's duration (in seconds) in a
+ * histogram. Async methods are timed across their full await.
+ */
+export declare function Timed(metricName: string, options?: TimedOptions): (_target: object, _propertyKey: string | symbol, descriptor: PropertyDescriptor) => PropertyDescriptor;
+//# sourceMappingURL=timed.d.ts.map

package/dist/metrics/decorators/timed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timed.d.ts","sourceRoot":"","sources":["../../../src/metrics/decorators/timed.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,MAAM,WAAW,YAAY;IAC5B,iCAAiC;IACjC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,oDAAoD;IACpD,MAAM,CAAC,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACtC;AAED;;;GAGG;AACH,wBAAgB,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB,IAClD,SAAS,MAAM,EAAE,cAAc,MAAM,GAAG,MAAM,EAAE,YAAY,kBAAkB,wBAiD/F"}

package/dist/metrics/gauge.d.ts

@@ -0,0 +1,38 @@
+/**
+ * `Gauge` — point-in-time value that can go up or down.
+ *
+ * Ideal for: queue size, memory usage, active connections, in-flight
+ * requests, etc.
+ *
+ * The value is stored per label combination. `inc()` and `dec()` are
+ * convenience helpers; `set()` replaces the value outright.
+ *
+ * Example:
+ *   const g = new Gauge({
+ *     name: "active_connections",
+ *     collect: () => { return; },
+ *   });
+ *   g.inc();
+ *   g.dec(2);
+ *   g.set(42);
+ */
+import type { GaugeOptions, Gauge as IGauge, MetricSample } from "./types.js";
+export declare class GaugeImpl implements IGauge {
+    readonly name: string;
+    readonly help?: string;
+    readonly labelNames: string[];
+    private values;
+    constructor(opts: GaugeOptions);
+    set(value: number, labels?: Record<string, string>): void;
+    inc(n?: number, labels?: Record<string, string>): void;
+    dec(n?: number, labels?: Record<string, string>): void;
+    setToCurrentTime(labels?: Record<string, string>): void;
+    reset(): void;
+    getSamples(): MetricSample[];
+    /** Render this gauge in Prometheus exposition format. */
+    renderPrometheus(): string;
+    private assertLabels;
+    private key;
+    private parseKey;
+}
+//# sourceMappingURL=gauge.d.ts.map

package/dist/metrics/gauge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gauge.d.ts","sourceRoot":"","sources":["../../src/metrics/gauge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,KAAK,IAAI,MAAM,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG9E,qBAAa,SAAU,YAAW,MAAM;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC;IAC9B,OAAO,CAAC,MAAM,CAA6B;gBAE/B,IAAI,EAAE,YAAY;IAM9B,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAKzD,GAAG,CAAC,CAAC,GAAE,MAAU,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAMzD,GAAG,CAAC,CAAC,GAAE,MAAU,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAMzD,gBAAgB,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAIvD,KAAK,IAAI,IAAI;IAIb,UAAU,IAAI,YAAY,EAAE;IAQ5B,yDAAyD;IACzD,gBAAgB,IAAI,MAAM;IAY1B,OAAO,CAAC,YAAY;IAepB,OAAO,CAAC,GAAG;IAKX,OAAO,CAAC,QAAQ;CAShB"}

package/dist/metrics/histogram.d.ts

@@ -0,0 +1,52 @@
+/**
+ * `Histogram` — distribution of observed values into buckets.
+ *
+ * Each `observe()` adds the value to every bucket whose upper bound
+ * is >= value. The metric exposes:
+ *   - `<name>_bucket{le="..."}` — cumulative count per bucket
+ *   - `<name>_sum` — total sum of all observed values
+ *   - `<name>_count` — total count
+ *
+ * Default buckets (Prometheus convention): [0.005, 0.01, 0.025,
+ * 0.05, 0.1, 0.25, 0.5, 1, 2.5, 5, 10] seconds.
+ *
+ * Example:
+ *   const h = new Histogram({ name: "http_duration_seconds" });
+ *   h.observe(0.123);
+ *   await h.time(async () => fetch("/slow"));
+ */
+import type { HistogramOptions, Histogram as IHistogram, MetricSample } from "./types.js";
+/** Prometheus default buckets (seconds). */
+export declare const DEFAULT_BUCKETS: number[];
+interface HistogramState {
+    buckets: number[];
+    sum: number;
+    count: number;
+}
+export declare class HistogramImpl implements IHistogram {
+    readonly name: string;
+    readonly help?: string;
+    readonly labelNames: string[];
+    private readonly upperBounds;
+    /** Map from "label1=v1,label2=v2" -> state. */
+    private states;
+    constructor(opts: HistogramOptions);
+    observe(value: number, labels?: Record<string, string>): void;
+    time<T>(fn: (start: number) => Promise<T> | T, labels?: Record<string, string>): Promise<T>;
+    reset(): void;
+    getSamples(): MetricSample[];
+    /** Render this histogram in Prometheus exposition format. */
+    renderPrometheus(): string;
+    /** Internal: produce Prometheus-formatted lines for a single state. */
+    renderState(labels: Record<string, string>, state: HistogramState): string;
+    /** Internal: enumerate all states for the registry. */
+    enumerateStates(): Array<{
+        labels: Record<string, string>;
+        state: HistogramState;
+    }>;
+    private assertLabels;
+    private key;
+    private parseKey;
+}
+export {};
+//# sourceMappingURL=histogram.d.ts.map

package/dist/metrics/histogram.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"histogram.d.ts","sourceRoot":"","sources":["../../src/metrics/histogram.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,SAAS,IAAI,UAAU,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG1F,4CAA4C;AAC5C,eAAO,MAAM,eAAe,UAA4D,CAAC;AAEzF,UAAU,cAAc;IACvB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACd;AAED,qBAAa,aAAc,YAAW,UAAU;IAC/C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC;IAC9B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAW;IACvC,+CAA+C;IAC/C,OAAO,CAAC,MAAM,CAAqC;gBAEvC,IAAI,EAAE,gBAAgB;IAYlC,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAevD,IAAI,CAAC,CAAC,EACX,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,EACrC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC7B,OAAO,CAAC,CAAC,CAAC;IAUb,KAAK,IAAI,IAAI;IAIb,UAAU,IAAI,YAAY,EAAE;IAgB5B,6DAA6D;IAC7D,gBAAgB,IAAI,MAAM;IAU1B,uEAAuE;IACvE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,KAAK,EAAE,cAAc,GAAG,MAAM;IA2B1E,uDAAuD;IACvD,eAAe,IAAI,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,KAAK,EAAE,cAAc,CAAA;KAAE,CAAC;IAQnF,OAAO,CAAC,YAAY;IAepB,OAAO,CAAC,GAAG;IAKX,OAAO,CAAC,QAAQ;CAShB"}

package/dist/metrics/index.d.ts

@@ -0,0 +1,35 @@
+/**
+ * `nexusjs/metrics` — Prometheus-compatible metrics collection.
+ *
+ * Public API:
+ * - `MetricsService`        — main DI-friendly service
+ * - `MetricsModule.forRoot()` — wires up default metrics, mounts /metrics
+ * - `MetricsController.handler(service)` — Hono handler for /metrics
+ * - `MetricsService#counter/gauge/histogram/summary()` — register metrics
+ * - `@Counted()`, `@Timed()` decorators — auto-record on method calls
+ * - `MetricsService#expose()` — serialize to Prometheus / OpenMetrics
+ *
+ * Zero external dependencies. ~5kb gzipped.
+ *
+ *   @Module({
+ *     imports: [
+ *       MetricsModule.forRoot({
+ *         enableDefaultMetrics: true,
+ *         path: "/metrics",
+ *         globalLabels: { service: "my-app" },
+ *       }),
+ *     ],
+ *   })
+ *   class AppModule {}
+ */
+export { CounterImpl } from "./counter.js";
+export { GaugeImpl } from "./gauge.js";
+export { HistogramImpl, DEFAULT_BUCKETS } from "./histogram.js";
+export { SummaryImpl, DEFAULT_PERCENTILES } from "./summary.js";
+export { MetricsRegistry } from "./registry.js";
+export { MetricsService, METRICS_SERVICE_TOKEN, setMetricsService, getMetricsService, } from "./service.js";
+export { MetricsModule } from "./module.js";
+export { MetricsController } from "./controller.js";
+export { Counted, Timed, type CountedOptions, type TimedOptions } from "./decorators/index.js";
+export type { Counter, CounterOptions, Gauge, GaugeOptions, Histogram, HistogramOptions, Summary, SummaryOptions, MetricSample, MetricsConfig, ExpositionFormat, ExpositionResult, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/metrics/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EACN,cAAc,EACd,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,GACjB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,cAAc,EAAE,KAAK,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC/F,YAAY,EACX,OAAO,EACP,cAAc,EACd,KAAK,EACL,YAAY,EACZ,SAAS,EACT,gBAAgB,EAChB,OAAO,EACP,cAAc,EACd,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,gBAAgB,GAChB,MAAM,YAAY,CAAC"}