stratal 0.0.13 → 0.0.14

package/dist/storage-dgi7MG6z.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-dgi7MG6z.mjs","names":[],"sources":["../src/storage/errors/disk-not-configured.error.ts","../src/storage/errors/file-not-found.error.ts","../src/storage/errors/file-too-large.error.ts","../src/storage/errors/invalid-disk.error.ts","../src/storage/errors/invalid-file-type.error.ts","../src/storage/errors/presigned-url-invalid-expiry.error.ts","../src/storage/errors/storage-provider-not-supported.error.ts","../src/storage/errors/storage-response-body-missing.error.ts","../src/storage/providers/s3-storage.provider.ts","../src/storage/storage.tokens.ts","../src/storage/services/storage-manager.service.ts","../src/storage/dom.polyfill.ts","../src/storage/services/storage.service.ts","../src/storage/storage.module.ts","../src/storage/contracts/delete-file.input.ts","../src/storage/contracts/file-exists.input.ts","../src/storage/contracts/get-presigned-url.input.ts","../src/storage/contracts/upload-file.input.ts"],"sourcesContent":["import { ApplicationError, ERROR_CODES } from '../../errors'\n\nexport class DiskNotConfiguredError extends ApplicationError {\n  constructor(disk: string) {\n    super('errors.storage.diskNotConfigured', ERROR_CODES.SYSTEM.CONFIGURATION_ERROR, { disk })\n  }\n}\n","import { ERROR_CODES } from '../../errors'\nimport { ApplicationError } from '../../errors'\n\nexport class FileNotFoundError extends ApplicationError {\n  constructor(path: string) {\n    super('errors.storage.fileNotFound', ERROR_CODES.RESOURCE.NOT_FOUND, { path })\n  }\n}\n","import { ERROR_CODES } from '../../errors'\nimport { ApplicationError } from '../../errors'\n\nexport class FileTooLargeError extends ApplicationError {\n  constructor(size: number, maxSize: number) {\n    super('errors.storage.fileTooLarge', ERROR_CODES.VALIDATION.INVALID_FORMAT, {\n      size,\n      maxSize,\n    })\n  }\n}\n","import { ERROR_CODES } from '../../errors'\nimport { ApplicationError } from '../../errors'\n\nexport class InvalidDiskError extends ApplicationError {\n  constructor(disk: string) {\n    super('errors.storage.invalidDisk', ERROR_CODES.SYSTEM.CONFIGURATION_ERROR, { disk })\n  }\n}\n","import { ERROR_CODES } from '../../errors'\nimport { ApplicationError } from '../../errors'\n\nexport class InvalidFileTypeError extends ApplicationError {\n  constructor(mimeType: string) {\n    super('errors.storage.invalidFileType', ERROR_CODES.VALIDATION.INVALID_FORMAT, {\n      mimeType,\n    })\n  }\n}\n","import { ERROR_CODES } from '../../errors'\nimport { ApplicationError } from '../../errors'\n\nexport class PresignedUrlInvalidExpiryError extends ApplicationError {\n  constructor(expiresIn: number, min: number, max: number) {\n    super('errors.storage.presignedUrlInvalidExpiry', ERROR_CODES.VALIDATION.INVALID_FORMAT, {\n      expiresIn,\n      min,\n      max,\n    })\n  }\n}\n","import { ERROR_CODES } from '../../errors'\nimport { ApplicationError } from '../../errors'\n\nexport class StorageProviderNotSupportedError extends ApplicationError {\n  constructor(provider: string) {\n    super('errors.storage.providerNotSupported', ERROR_CODES.SYSTEM.CONFIGURATION_ERROR, { provider })\n  }\n}\n","import { ERROR_CODES } from '../../errors'\nimport { ApplicationError } from '../../errors'\n\nexport class StorageResponseBodyMissingError extends ApplicationError {\n  constructor(path: string) {\n    super(\n      'errors.storage.responseBodyMissing',\n      ERROR_CODES.SYSTEM.INFRASTRUCTURE_ERROR,\n      { path }\n    )\n  }\n}\n","import {\n  AbortMultipartUploadCommand,\n  CompleteMultipartUploadCommand,\n  CreateMultipartUploadCommand,\n  DeleteObjectCommand,\n  DeleteObjectsCommand,\n  GetObjectCommand,\n  HeadObjectCommand,\n  ListMultipartUploadsCommand,\n  ListPartsCommand,\n  PutObjectCommand,\n  S3Client,\n  UploadPartCommand\n} from '@aws-sdk/client-s3'\nimport { Upload } from '@aws-sdk/lib-storage'\nimport { getSignedUrl } from '@aws-sdk/s3-request-presigner'\nimport type { StorageEntry } from '../types'\nimport type { DownloadResult, PresignedUrlResult, UploadOptions, UploadResult } from '../contracts'\nimport { StorageResponseBodyMissingError } from '../errors'\nimport type {\n  CompletedPart,\n  CompleteMultipartResult,\n  CreateMultipartOptions,\n  CreateMultipartResult,\n  DeleteObjectsResult,\n  HeadObjectResult,\n  IS3MultipartProvider,\n  ListMultipartUploadsResult,\n  ListPartsResult,\n  UploadPartResult,\n} from './s3-multipart-provider.interface'\nimport type { StreamingBlobPayloadInputTypes } from './storage-provider.interface'\n\n/**\n * S3 Storage Provider\n * Implements storage operations using AWS SDK for S3-compatible storage\n * Works with AWS S3, Cloudflare R2, MinIO, and other S3-compatible services\n *\n * Implements IS3MultipartProvider for multipart upload support needed by TUS\n */\nexport class S3StorageProvider implements IS3MultipartProvider {\n  private readonly client: S3Client\n  private readonly bucket: string\n  private readonly disk: string\n\n  constructor(config: StorageEntry) {\n    // Configure S3Client for S3-compatible storage\n    this.client = new S3Client({\n      region: config.region || 'auto',\n      endpoint: config.endpoint,\n      credentials: {\n        accessKeyId: config.accessKeyId,\n        secretAccessKey: config.secretAccessKey,\n      },\n      forcePathStyle: true,\n    })\n\n    this.bucket = config.bucket\n    this.disk = config.disk\n  }\n\n  async upload(\n    body: StreamingBlobPayloadInputTypes,\n    path: string,\n    options: UploadOptions\n  ): Promise<UploadResult> {\n    const command = new PutObjectCommand({\n      Bucket: this.bucket,\n      Key: path,\n      Body: body,\n      ContentType: options.mimeType,\n      ContentLength: options.size,\n      Metadata: options.metadata,\n      Tagging: options.tagging,\n    })\n\n    await this.client.send(command)\n\n    return {\n      path,\n      disk: this.disk,\n      fullPath: `${this.bucket}/${path}`,\n      size: options.size,\n      mimeType: options.mimeType ?? 'application/octet-stream',\n      uploadedAt: new Date(),\n    }\n  }\n\n  async download(path: string): Promise<DownloadResult> {\n    const command = new GetObjectCommand({\n      Bucket: this.bucket,\n      Key: path,\n    })\n\n    const response = await this.client.send(command)\n\n    if (!response.Body) {\n      throw new StorageResponseBodyMissingError(path)\n    }\n\n    return {\n      toStream: () => response.Body?.transformToWebStream(),\n      contentType: response.ContentType ?? 'application/octet-stream',\n      size: response.ContentLength ?? 0,\n      metadata: response.Metadata,\n      toString: () => response.Body?.transformToString(),\n      toArrayBuffer: () => response.Body?.transformToByteArray(),\n    }\n  }\n\n  async delete(path: string): Promise<void> {\n    const command = new DeleteObjectCommand({\n      Bucket: this.bucket,\n      Key: path,\n    })\n\n    await this.client.send(command)\n  }\n\n  async exists(path: string): Promise<boolean> {\n    try {\n      const command = new HeadObjectCommand({\n        Bucket: this.bucket,\n        Key: path,\n      })\n\n      await this.client.send(command)\n      return true\n    } catch {\n      // HeadObject throws error if file doesn't exist\n      return false\n    }\n  }\n\n  async getPresignedUrl(\n    path: string,\n    method: 'GET' | 'PUT' | 'DELETE' | 'HEAD',\n    expiresIn: number\n  ): Promise<PresignedUrlResult> {\n    // Select appropriate command based on method\n    let command\n    switch (method) {\n      case 'GET':\n        command = new GetObjectCommand({ Bucket: this.bucket, Key: path })\n        break\n      case 'PUT':\n        command = new PutObjectCommand({ Bucket: this.bucket, Key: path })\n        break\n      case 'DELETE':\n        command = new DeleteObjectCommand({ Bucket: this.bucket, Key: path })\n        break\n      case 'HEAD':\n        command = new HeadObjectCommand({ Bucket: this.bucket, Key: path })\n        break\n    }\n\n    const url = await getSignedUrl(this.client, command as GetObjectCommand, { expiresIn })\n\n    return {\n      url,\n      expiresIn,\n      expiresAt: new Date(Date.now() + expiresIn * 1000),\n      method,\n    }\n  }\n\n  /**\n   * Chunked upload for streaming data without known size\n   * Uses @aws-sdk/lib-storage for multipart upload handling\n   *\n   * Benefits:\n   * - Handles unknown Content-Length automatically\n   * - Automatic retry on transient failures\n   * - Cleanup of partial uploads on error\n   * - Works with S3-compatible storage (R2, MinIO, RustFS)\n   *\n   * @param body - Content to upload (stream or buffer)\n   * @param path - Full path including disk root\n   * @param options - Upload options (mimeType required, size optional)\n   * @returns Upload result with metadata\n   */\n  async chunkedUpload(\n    body: StreamingBlobPayloadInputTypes,\n    path: string,\n    options: Omit<UploadOptions, 'size'> & { size?: number }\n  ): Promise<UploadResult> {\n    const upload = new Upload({\n      client: this.client,\n      params: {\n        Bucket: this.bucket,\n        Key: path,\n        Body: body,\n        ContentType: options.mimeType,\n      },\n      // Concurrency configuration\n      queueSize: 4,\n      // Part size: 5MB minimum for S3\n      partSize: 5 * 1024 * 1024,\n      // Don't leave orphaned parts on error\n      leavePartsOnError: false,\n    })\n\n    await upload.done()\n\n    // Get the actual uploaded size via HeadObject\n    const headResponse = await this.client.send(\n      new HeadObjectCommand({\n        Bucket: this.bucket,\n        Key: path,\n      })\n    )\n\n    return {\n      path,\n      disk: this.disk,\n      fullPath: `${this.bucket}/${path}`,\n      size: headResponse.ContentLength ?? options.size ?? 0,\n      mimeType: options.mimeType ?? 'application/octet-stream',\n      uploadedAt: new Date(),\n    }\n  }\n\n  // ============================================\n  // IS3MultipartProvider - Multipart upload methods\n  // ============================================\n\n  /**\n   * Get the bucket name\n   */\n  getBucket(): string {\n    return this.bucket\n  }\n\n  /**\n   * Get object metadata without downloading the body\n   */\n  async headObject(key: string): Promise<HeadObjectResult | null> {\n    const response = await this.client.send(\n      new HeadObjectCommand({\n        Bucket: this.bucket,\n        Key: key,\n      })\n    )\n    return {\n      size: response.ContentLength ?? 0,\n      contentType: response.ContentType,\n      metadata: response.Metadata,\n    }\n  }\n\n  /**\n   * Delete multiple objects in a single request\n   */\n  async deleteObjects(keys: string[]): Promise<DeleteObjectsResult> {\n    if (keys.length === 0) {\n      return { deleted: 0, errors: [] }\n    }\n\n    const response = await this.client.send(\n      new DeleteObjectsCommand({\n        Bucket: this.bucket,\n        Delete: {\n          Objects: keys.map((key) => ({ Key: key })),\n        },\n      })\n    )\n\n    return {\n      deleted: response.Deleted?.length ?? 0,\n      errors: (response.Errors ?? []).map((e) => ({\n        key: e.Key ?? '',\n        code: e.Code ?? 'Unknown',\n        message: e.Message ?? 'Unknown error',\n      })),\n    }\n  }\n\n  /**\n   * Create a multipart upload\n   */\n  async createMultipartUpload(\n    key: string,\n    options?: CreateMultipartOptions\n  ): Promise<CreateMultipartResult> {\n    const response = await this.client.send(\n      new CreateMultipartUploadCommand({\n        Bucket: this.bucket,\n        Key: key,\n        ContentType: options?.contentType,\n        CacheControl: options?.cacheControl,\n        Metadata: options?.metadata,\n        Tagging: options?.tagging,\n      })\n    )\n\n    return {\n      uploadId: response.UploadId ?? '',\n      key: response.Key ?? '',\n    }\n  }\n\n  /**\n   * Upload a part to an existing multipart upload\n   */\n  async uploadPart(\n    key: string,\n    uploadId: string,\n    partNumber: number,\n    body: Uint8Array\n  ): Promise<UploadPartResult> {\n    const response = await this.client.send(\n      new UploadPartCommand({\n        Bucket: this.bucket,\n        Key: key,\n        UploadId: uploadId,\n        PartNumber: partNumber,\n        Body: body,\n        ContentLength: body.length,\n      })\n    )\n\n    return {\n      etag: response.ETag ?? '',\n      partNumber,\n    }\n  }\n\n  /**\n   * Complete a multipart upload\n   */\n  async completeMultipartUpload(\n    key: string,\n    uploadId: string,\n    parts: CompletedPart[]\n  ): Promise<CompleteMultipartResult> {\n    const response = await this.client.send(\n      new CompleteMultipartUploadCommand({\n        Bucket: this.bucket,\n        Key: key,\n        UploadId: uploadId,\n        MultipartUpload: {\n          Parts: parts.map((p) => ({\n            ETag: p.etag,\n            PartNumber: p.partNumber,\n          })),\n        },\n      })\n    )\n\n    return {\n      location: response.Location,\n      key: response.Key ?? '',\n    }\n  }\n\n  /**\n   * Abort a multipart upload\n   */\n  async abortMultipartUpload(key: string, uploadId: string): Promise<void> {\n    await this.client.send(\n      new AbortMultipartUploadCommand({\n        Bucket: this.bucket,\n        Key: key,\n        UploadId: uploadId,\n      })\n    )\n  }\n\n  /**\n   * List parts of a multipart upload\n   */\n  async listParts(\n    key: string,\n    uploadId: string,\n    partNumberMarker?: string\n  ): Promise<ListPartsResult> {\n    const response = await this.client.send(\n      new ListPartsCommand({\n        Bucket: this.bucket,\n        Key: key,\n        UploadId: uploadId,\n        PartNumberMarker: partNumberMarker,\n      })\n    )\n\n    return {\n      parts: (response.Parts ?? []).map((p) => ({\n        partNumber: p.PartNumber ?? 0,\n        etag: p.ETag ?? '',\n        size: p.Size ?? 0,\n      })),\n      isTruncated: response.IsTruncated ?? false,\n      nextPartNumberMarker: response.NextPartNumberMarker?.toString(),\n    }\n  }\n\n  /**\n   * List all in-progress multipart uploads\n   */\n  async listMultipartUploads(\n    keyMarker?: string,\n    uploadIdMarker?: string\n  ): Promise<ListMultipartUploadsResult> {\n    const response = await this.client.send(\n      new ListMultipartUploadsCommand({\n        Bucket: this.bucket,\n        KeyMarker: keyMarker,\n        UploadIdMarker: uploadIdMarker,\n      })\n    )\n\n    return {\n      uploads: (response.Uploads ?? []).map((u) => ({\n        key: u.Key ?? '',\n        uploadId: u.UploadId ?? '',\n        initiated: u.Initiated,\n      })),\n      isTruncated: response.IsTruncated ?? false,\n      nextKeyMarker: response.NextKeyMarker,\n      nextUploadIdMarker: response.NextUploadIdMarker,\n    }\n  }\n}\n","/**\n * Dependency injection tokens for the Storage module\n * Using Symbol-based tokens to avoid magic strings\n */\nexport const STORAGE_TOKENS = {\n  Options: Symbol.for('stratal:storage:options'),\n  StorageService: Symbol.for('stratal:storage:service'),\n  StorageManager: Symbol.for('stratal:storage:manager'),\n} as const\n","import { inject } from 'tsyringe'\nimport { Transient } from '../../di/decorators'\nimport { DiskNotConfiguredError, StorageProviderNotSupportedError } from '../errors'\nimport { S3StorageProvider } from '../providers/s3-storage.provider'\nimport type { IStorageProvider } from '../providers/storage-provider.interface'\nimport { STORAGE_TOKENS } from '../storage.tokens'\nimport type { StorageConfig, StorageEntry } from '../types'\n\n/**\n * Storage Manager Service\n * Manages multiple storage providers (one per disk)\n * Handles lazy initialization and caching of S3Clients\n */\n@Transient(STORAGE_TOKENS.StorageManager)\nexport class StorageManagerService {\n  private readonly providers = new Map<string, IStorageProvider>()\n  private readonly diskConfigs = new Map<string, StorageEntry>()\n\n  constructor(\n    @inject(STORAGE_TOKENS.Options)\n    private readonly options: StorageConfig\n  ) {\n    this.initializeDiskConfigs()\n  }\n\n  /**\n   * Initialize disk configurations from options\n   */\n  private initializeDiskConfigs(): void {\n    for (const entry of this.options.storage) {\n      this.diskConfigs.set(entry.disk, entry)\n    }\n  }\n\n  /**\n   * Get provider for a specific disk\n   * Lazily initializes provider on first access\n   * @param diskName - Name of the disk\n   * @returns Storage provider instance\n   */\n  getProvider(diskName: string): IStorageProvider {\n    // Return cached provider if exists\n    const cached = this.providers.get(diskName)\n    if (cached) {\n      return cached\n    }\n\n    // Get disk configuration\n    const diskConfig = this.diskConfigs.get(diskName)\n    if (!diskConfig) {\n      throw new DiskNotConfiguredError(diskName)\n    }\n\n    // Create provider based on configuration\n    const provider = this.createProvider(diskConfig)\n\n    // Cache provider\n    this.providers.set(diskName, provider)\n\n    return provider\n  }\n\n  /**\n   * Create a provider instance based on configuration\n   * @param config - Storage entry configuration\n   * @returns Storage provider instance\n   */\n  private createProvider(config: StorageEntry): IStorageProvider {\n    switch (config.provider) {\n      case 's3':\n        return new S3StorageProvider(config)\n      case 'gcs':\n        throw new StorageProviderNotSupportedError(config.provider)\n      default:\n        throw new StorageProviderNotSupportedError(config.provider)\n    }\n  }\n\n  /**\n   * Get disk configuration\n   * @param diskName - Name of the disk\n   * @returns Storage entry configuration\n   */\n  getDiskConfig(diskName: string): StorageEntry {\n    const config = this.diskConfigs.get(diskName)\n    if (!config) {\n      throw new DiskNotConfiguredError(diskName)\n    }\n    return config\n  }\n\n  /**\n   * Check if a disk exists\n   * @param diskName - Name of the disk\n   * @returns True if disk exists, false otherwise\n   */\n  hasDisk(diskName: string): boolean {\n    return this.diskConfigs.has(diskName)\n  }\n\n  /**\n   * Get all available disk names\n   * @returns Array of disk names\n   */\n  getAvailableDisks(): string[] {\n    return Array.from(this.diskConfigs.keys())\n  }\n}\n","/**\n * DOM polyfills for Cloudflare Workers\n *\n * AWS SDK v3 uses DOMParser and Node for XML parsing, which are not available in Workers.\n * This module must be imported BEFORE any AWS SDK imports (including transitive).\n *\n * @see https://github.com/aws/aws-sdk-js-v3/issues/7375\n */\nimport { DOMParser } from '@xmldom/xmldom'\n\n// DOMParser polyfill for XML response parsing\nglobalThis.DOMParser = DOMParser\n\n// Node interface polyfill with DOM node type constants\n// Required by AWS SDK for XML response parsing\nif (typeof globalThis.Node === 'undefined') {\n  globalThis.Node = {\n    ELEMENT_NODE: 1,\n    ATTRIBUTE_NODE: 2,\n    TEXT_NODE: 3,\n    CDATA_SECTION_NODE: 4,\n    ENTITY_REFERENCE_NODE: 5,\n    ENTITY_NODE: 6,\n    PROCESSING_INSTRUCTION_NODE: 7,\n    COMMENT_NODE: 8,\n    DOCUMENT_NODE: 9,\n    DOCUMENT_TYPE_NODE: 10,\n    DOCUMENT_FRAGMENT_NODE: 11,\n    NOTATION_NODE: 12,\n  } as unknown as typeof Node\n}\n","import '../dom.polyfill'\n\nimport { inject } from 'tsyringe'\nimport { Transient } from '../../di/decorators'\nimport type { DownloadResult, PresignedUrlResult, UploadOptions, UploadResult } from '../contracts'\nimport {\n  InvalidDiskError,\n  PresignedUrlInvalidExpiryError,\n} from '../errors'\nimport type { StreamingBlobPayloadInputTypes } from '../providers/storage-provider.interface'\nimport { STORAGE_TOKENS } from '../storage.tokens'\nimport type { StorageConfig } from '../types'\nimport { StorageManagerService } from './storage-manager.service'\n\n/**\n * Storage Service\n *\n * Main facade for storage operations.\n * Request-scoped for proper isolation.\n *\n * @example\n * ```typescript\n * @inject(STORAGE_TOKENS.StorageService)\n * private readonly storage: StorageService\n *\n * await this.storage.upload(file, 'documents/report.pdf')\n * ```\n */\n@Transient(STORAGE_TOKENS.StorageService)\nexport class StorageService {\n  constructor(\n    @inject(STORAGE_TOKENS.StorageManager)\n    protected readonly storageManager: StorageManagerService,\n    @inject(STORAGE_TOKENS.Options)\n    protected readonly options: StorageConfig\n  ) { }\n\n  /**\n   * Upload content to storage\n   * @param body - Content to upload (stream, buffer, or string)\n   * @param relativePath - Relative path within the disk\n   * @param options - Upload options including size and mime type\n   * @param disk - Optional disk name (uses default if not provided)\n   * @returns Upload result with metadata\n   */\n  async upload(\n    body: StreamingBlobPayloadInputTypes,\n    relativePath: string,\n    options: UploadOptions,\n    disk?: string\n  ): Promise<UploadResult> {\n    const diskName = this.resolveDisk(disk)\n    const provider = this.storageManager.getProvider(diskName)\n    const fullPath = this.buildFullPath(relativePath, diskName)\n\n    return provider.upload(body, fullPath, options)\n  }\n\n  /**\n   * Download a file from storage\n   * @param relativePath - Relative path within the disk\n   * @param disk - Optional disk name (uses default if not provided)\n   * @returns Download result with stream and metadata\n   */\n  async download(relativePath: string, disk?: string): Promise<DownloadResult> {\n    const diskName = this.resolveDisk(disk)\n    const provider = this.storageManager.getProvider(diskName)\n    const fullPath = this.buildFullPath(relativePath, diskName)\n\n    return provider.download(fullPath)\n  }\n\n  /**\n   * Delete a file from storage\n   * @param relativePath - Relative path within the disk\n   * @param disk - Optional disk name (uses default if not provided)\n   */\n  async delete(relativePath: string, disk?: string): Promise<void> {\n    const diskName = this.resolveDisk(disk)\n    const provider = this.storageManager.getProvider(diskName)\n    const fullPath = this.buildFullPath(relativePath, diskName)\n\n    await provider.delete(fullPath)\n  }\n\n  /**\n   * Check if a file exists in storage\n   * @param relativePath - Relative path within the disk\n   * @param disk - Optional disk name (uses default if not provided)\n   * @returns True if file exists, false otherwise\n   */\n  async exists(relativePath: string, disk?: string): Promise<boolean> {\n    const diskName = this.resolveDisk(disk)\n    const provider = this.storageManager.getProvider(diskName)\n    const fullPath = this.buildFullPath(relativePath, diskName)\n\n    return provider.exists(fullPath)\n  }\n\n  /**\n   * Generate a presigned download URL\n   * @param relativePath - Relative path within the disk\n   * @param expiresIn - Optional expiry time in seconds (uses default if not provided)\n   * @param disk - Optional disk name (uses default if not provided)\n   * @returns Presigned URL result\n   */\n  async getPresignedDownloadUrl(\n    relativePath: string,\n    expiresIn?: number,\n    disk?: string\n  ): Promise<PresignedUrlResult> {\n    return this.getPresignedUrl(relativePath, 'GET', expiresIn, disk)\n  }\n\n  /**\n   * Generate a presigned upload URL\n   * @param relativePath - Relative path within the disk\n   * @param expiresIn - Optional expiry time in seconds (uses default if not provided)\n   * @param disk - Optional disk name (uses default if not provided)\n   * @returns Presigned URL result\n   */\n  async getPresignedUploadUrl(\n    relativePath: string,\n    expiresIn?: number,\n    disk?: string\n  ): Promise<PresignedUrlResult> {\n    return this.getPresignedUrl(relativePath, 'PUT', expiresIn, disk)\n  }\n\n  /**\n   * Generate a presigned delete URL\n   * @param relativePath - Relative path within the disk\n   * @param expiresIn - Optional expiry time in seconds (uses default if not provided)\n   * @param disk - Optional disk name (uses default if not provided)\n   * @returns Presigned URL result\n   */\n  async getPresignedDeleteUrl(\n    relativePath: string,\n    expiresIn?: number,\n    disk?: string\n  ): Promise<PresignedUrlResult> {\n    return this.getPresignedUrl(relativePath, 'DELETE', expiresIn, disk)\n  }\n\n  /**\n   * Generate a presigned URL for any method\n   * @param relativePath - Relative path within the disk\n   * @param method - HTTP method (GET, PUT, DELETE, HEAD)\n   * @param expiresIn - Optional expiry time in seconds (uses default if not provided)\n   * @param disk - Optional disk name (uses default if not provided)\n   * @returns Presigned URL result\n   */\n  protected async getPresignedUrl(\n    relativePath: string,\n    method: 'GET' | 'PUT' | 'DELETE' | 'HEAD',\n    expiresIn?: number,\n    disk?: string\n  ): Promise<PresignedUrlResult> {\n    const diskName = this.resolveDisk(disk)\n    const provider = this.storageManager.getProvider(diskName)\n    const fullPath = this.buildFullPath(relativePath, diskName)\n    const validatedExpiresIn = this.validateExpiresIn(expiresIn)\n\n    return provider.getPresignedUrl(fullPath, method, validatedExpiresIn)\n  }\n\n  /**\n   * Resolve disk name (use default if not provided)\n   * @param disk - Optional disk name\n   * @returns Resolved disk name\n   */\n  protected resolveDisk(disk?: string): string {\n    const diskName = disk ?? this.options.defaultStorageDisk\n\n    if (!this.storageManager.hasDisk(diskName)) {\n      throw new InvalidDiskError(diskName)\n    }\n\n    return diskName\n  }\n\n  /**\n   * Build full path with disk root and path template substitution\n   * @param relativePath - Relative path within the disk\n   * @param diskName - Name of the disk\n   * @returns Full path including disk root\n   */\n  protected buildFullPath(relativePath: string, diskName: string): string {\n    const diskConfig = this.storageManager.getDiskConfig(diskName)\n    let root = diskConfig.root || ''\n\n    // Substitute template variables\n    root = this.substituteTemplateVariables(root)\n\n    // Combine root and relative path\n    const fullPath = `${root}/${relativePath}`.replace(/\\/+/g, '/').replace(/^\\//, '')\n\n    return fullPath\n  }\n\n  /**\n   * Substitute template variables in path\n   * Override this method in subclasses to add custom substitutions\n   *\n   * @param path - Path with template variables\n   * @returns Path with substituted variables\n   */\n  protected substituteTemplateVariables(path: string): string {\n    let result = path\n\n    // Substitute {date}, {year}, {month}\n    const now = new Date()\n    result = result.replace(/{date}/g, now.toISOString().split('T')[0])\n    result = result.replace(/{year}/g, now.getFullYear().toString())\n    result = result.replace(/{month}/g, (now.getMonth() + 1).toString().padStart(2, '0'))\n\n    return result\n  }\n\n  /**\n   * Validate expiry time for presigned URLs\n   * @param expiresIn - Optional expiry time in seconds\n   * @returns Validated expiry time\n   */\n  protected validateExpiresIn(expiresIn?: number): number {\n    const presignedUrlConfig = this.options.presignedUrl\n    const validatedExpiresIn = expiresIn ?? presignedUrlConfig.defaultExpiry\n\n    // S3 presigned URL limits: 1 second to 7 days (604800 seconds)\n    const minExpiry = 1\n    const maxExpiry = presignedUrlConfig.maxExpiry\n\n    if (validatedExpiresIn < minExpiry || validatedExpiresIn > maxExpiry) {\n      throw new PresignedUrlInvalidExpiryError(validatedExpiresIn, minExpiry, maxExpiry)\n    }\n\n    return validatedExpiresIn\n  }\n\n  /**\n   * Get all available disk names\n   * @returns Array of disk names\n   */\n  getAvailableDisks(): string[] {\n    return this.storageManager.getAvailableDisks()\n  }\n\n  /**\n   * Chunked upload for streaming data without known size\n   * Uses multipart upload under the hood - handles retries and large files\n   *\n   * Use this method when:\n   * - Content-Length is unknown or unreliable\n   * - Uploading from streams that can't be rewound\n   * - Need automatic retry handling for transient failures\n   *\n   * @param body - Content to upload (stream or buffer)\n   * @param relativePath - Relative path within the disk\n   * @param options - Upload options (mimeType required, size optional)\n   * @param disk - Optional disk name (uses default if not provided)\n   * @returns Upload result with metadata\n   */\n  async chunkedUpload(\n    body: StreamingBlobPayloadInputTypes,\n    relativePath: string,\n    options: Omit<UploadOptions, 'size'> & { size?: number },\n    disk?: string\n  ): Promise<UploadResult> {\n    const diskName = this.resolveDisk(disk)\n    const provider = this.storageManager.getProvider(diskName)\n    const fullPath = this.buildFullPath(relativePath, diskName)\n\n    return provider.chunkedUpload(body, fullPath, options)\n  }\n}\n","/**\n * Storage Module\n * Provides file storage capabilities using AWS S3\n * Supports multiple disk configurations with dynamic path templates\n */\n\nimport { Module } from '../module'\nimport type { AsyncModuleOptions, DynamicModule } from '../module/types'\nimport { StorageManagerService } from './services/storage-manager.service'\nimport { StorageService } from './services/storage.service'\nimport { STORAGE_TOKENS } from './storage.tokens'\nimport type { StorageConfig } from './types'\n\n/**\n * Storage module options\n * Same as StorageConfig from types.ts\n */\nexport type StorageModuleOptions = StorageConfig\n\n@Module({\n  providers: [{ provide: STORAGE_TOKENS.StorageManager, useClass: StorageManagerService },\n  { provide: STORAGE_TOKENS.StorageService, useClass: StorageService },],\n})\nexport class StorageModule {\n  /**\n   * Configure StorageModule with static options\n   *\n   * @param options - Storage configuration options\n   * @returns Dynamic module with storage infrastructure\n   *\n   * @example\n   * ```typescript\n   * StorageModule.forRoot({\n   *   storage: [{ disk: 'uploads', provider: 's3', ... }],\n   *   defaultStorageDisk: 'uploads',\n   *   presignedUrl: { defaultExpiry: 3600, maxExpiry: 86400 }\n   * })\n   * ```\n   */\n  static forRoot(options: StorageModuleOptions): DynamicModule {\n    return {\n      module: StorageModule,\n      providers: [\n        { provide: STORAGE_TOKENS.Options, useValue: options },\n      ],\n    }\n  }\n\n  /**\n   * Configure StorageModule with async factory\n   *\n   * Use when configuration depends on other services.\n   *\n   * @param options - Async configuration with factory and inject tokens\n   * @returns Dynamic module with storage infrastructure\n   *\n   * @example\n   * ```typescript\n   * StorageModule.forRootAsync({\n   *   inject: [storageConfig.KEY],\n   *   useFactory: (storage) => ({\n   *     storage: storage.storage,\n   *     defaultStorageDisk: storage.defaultStorageDisk,\n   *     presignedUrl: storage.presignedUrl\n   *   })\n   * })\n   * ```\n   */\n  static forRootAsync(options: AsyncModuleOptions<StorageModuleOptions>): DynamicModule {\n    return {\n      module: StorageModule,\n      providers: [\n        {\n          provide: STORAGE_TOKENS.Options,\n          useFactory: options.useFactory,\n          inject: options.inject,\n        },\n      ],\n    }\n  }\n}\n","import { z, withI18n } from '../../i18n/validation'\n\nexport const deleteFileInputSchema = z.object({\n  path: z.string().min(1, withI18n('zodI18n.errors.custom.filePathRequired')),\n  disk: z.string().optional(),\n})\n\nexport type DeleteFileInput = z.infer<typeof deleteFileInputSchema>\n","import { z, withI18n } from '../../i18n/validation'\n\nexport const fileExistsInputSchema = z.object({\n  path: z.string().min(1, withI18n('zodI18n.errors.custom.filePathRequired')),\n  disk: z.string().optional(),\n})\n\nexport type FileExistsInput = z.infer<typeof fileExistsInputSchema>\n","import { z, withI18n } from '../../i18n/validation'\n\nexport const getPresignedUrlInputSchema = z.object({\n  path: z.string().min(1, withI18n('zodI18n.errors.custom.filePathRequired')),\n  method: z.enum(['GET', 'PUT', 'DELETE', 'HEAD']).default('GET'),\n  expiresIn: z.number().int().min(1).max(604800).optional(),\n  disk: z.string().optional(),\n})\n\nexport type GetPresignedUrlInput = z.infer<typeof getPresignedUrlInputSchema>\n\nexport const presignedUrlResultSchema = z.object({\n  url: z.string().url(),\n  expiresIn: z.number(),\n  expiresAt: z.date(),\n  method: z.enum(['GET', 'PUT', 'DELETE', 'HEAD']),\n})\n\nexport type PresignedUrlResult = z.infer<typeof presignedUrlResultSchema>\n","import { z } from '../../i18n/validation'\n\n/**\n * Upload options for streaming uploads\n */\nexport interface UploadOptions {\n  /**\n   * Size of the content in bytes\n   */\n  size: number\n  /**\n   * MIME type of the content\n   */\n  mimeType?: string\n  /**\n   * Custom metadata to store with the object (S3-specific)\n   * Stored as S3 object metadata headers\n   */\n  metadata?: Record<string, string>\n  /**\n   * Object tagging for lifecycle policies (S3-specific)\n   * Format: key=value (e.g., \"Tus-Completed=true\")\n   */\n  tagging?: string\n}\n\nexport const uploadResultSchema = z.object({\n  path: z.string(),\n  disk: z.string(),\n  fullPath: z.string(),\n  size: z.number(),\n  mimeType: z.string(),\n  uploadedAt: z.date(),\n})\n\nexport type UploadResult = z.infer<typeof uploadResultSchema>\n"],"mappings":"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"}

package/dist/stratal-D4MS_7pI.mjs

@@ -0,0 +1,270 @@
+import { S as ApplicationError, c as Container, r as GlobalErrorHandler, t as StratalNotInitializedError } from "./errors-BRJgVd5-.mjs";
+import { g as DI_TOKENS, i as LoggerService, l as LogLevel, n as PrettyFormatter, r as JsonFormatter, t as ConsoleTransport, u as LOGGER_TOKENS } from "./logger-Bg-CuidS.mjs";
+import { t as ModuleRegistry } from "./module-Dvzm4dhS.mjs";
+import { r as getListenerHandlers, t as EventRegistry } from "./events-CQyvSyrQ.mjs";
+import { CacheModule } from "./cache/index.mjs";
+import { t as CronManager } from "./cron-manager-CpS_hrDD.mjs";
+import { g as OpenAPIModule, n as HonoApp, t as I18nModule } from "./i18n.module-C9wQr_2k.mjs";
+import { t as QueueModule } from "./queue.module-ZqaZ2iY0.mjs";
+import { container } from "tsyringe";
+import "reflect-metadata";
+//#region src/application.ts
+/**
+* Application
+*
+* Main application class managing the two-tier container hierarchy:
+* - Global Container: All services (singletons via tsyringe native)
+* - Request Container: Child of global, context-enriched instances per request
+*
+* @example
+* ```typescript
+* const app = new Application({ module: AppModule, env, ctx })
+* await app.initialize()
+*
+* // Access container via getter
+* const service = app.container.resolve(MY_TOKEN)
+*
+* // Handle HTTP request (via HonoApp)
+* // Handle queue batch
+* await app.handleQueue(batch, 'my-queue')
+* ```
+*/
+var Application = class {
+	/**
+	* Unified Container - manages all DI operations
+	*/
+	_container;
+	honoApp;
+	moduleRegistry;
+	consumerRegistry;
+	cronManager;
+	initialized = false;
+	env;
+	appConfig;
+	constructor({ env, ctx, ...config }) {
+		this.env = env;
+		this.appConfig = config;
+		ApplicationError.captureStackTraces = env.ENVIRONMENT !== "production";
+		this._container = new Container({ container: container.createChildContainer() });
+		this._container.registerValue(DI_TOKENS.Application, this);
+		this._container.registerValue(DI_TOKENS.CloudflareEnv, env);
+		this._container.registerValue(DI_TOKENS.ExecutionContext, ctx);
+		this.registerLoggerService();
+		this.registerCoreServices();
+		const logger = this._container.resolve(LOGGER_TOKENS.LoggerService);
+		this.moduleRegistry = new ModuleRegistry(this._container, logger);
+		this._container.registerValue(DI_TOKENS.ModuleRegistry, this.moduleRegistry);
+	}
+	/**
+	* Get the Container instance
+	*/
+	get container() {
+		return this._container;
+	}
+	/**
+	* Get the HonoApp instance
+	*/
+	get hono() {
+		return this.honoApp;
+	}
+	async initialize() {
+		if (this.initialized) return;
+		this.moduleRegistry.registerAll([
+			I18nModule,
+			OpenAPIModule,
+			QueueModule,
+			CacheModule
+		]);
+		this.moduleRegistry.register(this.appConfig.module);
+		await this.moduleRegistry.initialize();
+		this.consumerRegistry = this._container.resolve(DI_TOKENS.ConsumerRegistry);
+		this.cronManager = this._container.resolve(DI_TOKENS.Cron);
+		const logger = this._container.resolve(LOGGER_TOKENS.LoggerService);
+		this.honoApp = new HonoApp(this._container, logger);
+		const middlewareConfigs = this.moduleRegistry.getAllMiddlewareConfigs();
+		const controllers = this.moduleRegistry.getAllControllers();
+		await this.honoApp.configure(middlewareConfigs, controllers, this.appConfig.versioning);
+		this.registerQueueConsumers();
+		this.registerCronJobs();
+		this.registerEventListeners();
+		this.initialized = true;
+	}
+	/**
+	* Resolve a service from the container
+	*/
+	resolve(token) {
+		try {
+			return this._container.resolve(token);
+		} catch (error) {
+			throw this._container.resolve(DI_TOKENS.ErrorHandler).handle(error);
+		}
+	}
+	/**
+	* Handle queue batch processing
+	*/
+	async handleQueue(batch, queueName) {
+		const locale = (batch.messages[0]?.body)?.metadata?.locale ?? "en";
+		const mockRouterContext = this.createMockRouterContext(locale);
+		await this._container.runInRequestScope(mockRouterContext, async (requestContainer) => {
+			try {
+				await requestContainer.resolve(DI_TOKENS.Queue).processBatch(queueName, batch);
+			} catch (error) {
+				requestContainer.resolve(DI_TOKENS.ErrorHandler).handle(error);
+				throw error;
+			}
+		});
+	}
+	/**
+	* Handle scheduled cron trigger
+	*/
+	async handleScheduled(controller) {
+		const mockRouterContext = this.createMockRouterContext("en");
+		await this._container.runInRequestScope(mockRouterContext, async (requestContainer) => {
+			try {
+				await this.cronManager.executeScheduled(controller);
+			} catch (error) {
+				requestContainer.resolve(DI_TOKENS.ErrorHandler).handle(error);
+				throw error;
+			}
+		});
+	}
+	/**
+	* Create mock RouterContext for queue/cron/seeder processing
+	*/
+	createMockRouterContext(locale = "en") {
+		return {
+			getLocale: () => locale,
+			setLocale: () => {},
+			getContainer: () => this._container
+		};
+	}
+	async shutdown() {
+		if (!this.initialized) return;
+		this.initialized = false;
+		await this.moduleRegistry.shutdown();
+		this._container.resolve(LOGGER_TOKENS.LoggerService).info("Disposing container...");
+		await this._container.dispose();
+	}
+	registerQueueConsumers() {
+		for (const ConsumerClass of this.moduleRegistry.getAllConsumers()) {
+			const consumer = this._container.resolve(ConsumerClass);
+			this.consumerRegistry.register(consumer);
+		}
+	}
+	registerCronJobs() {
+		for (const JobClass of this.moduleRegistry.getAllJobs()) {
+			const job = this._container.resolve(JobClass);
+			this.cronManager.registerJob(job);
+		}
+	}
+	/**
+	* Auto-wire `@Listener()` classes with the EventRegistry.
+	*/
+	registerEventListeners() {
+		const listeners = this.moduleRegistry.getAllListeners();
+		if (listeners.length === 0) return;
+		const eventRegistry = this._container.resolve(DI_TOKENS.EventRegistry);
+		for (const ListenerClass of listeners) {
+			const instance = this._container.resolve(ListenerClass);
+			const handlers = getListenerHandlers(ListenerClass);
+			for (const { methodName, event, options } of handlers) eventRegistry.on(event, instance[methodName].bind(instance), options);
+		}
+	}
+	/**
+	* Register LoggerService and dependencies
+	*/
+	registerLoggerService() {
+		const logLevel = this.appConfig.logging?.level ?? LogLevel.INFO;
+		const formatter = this.appConfig.logging?.formatter ?? "json";
+		this._container.registerValue(LOGGER_TOKENS.LogLevelOptions, logLevel);
+		this._container.when(() => formatter === "pretty").use(LOGGER_TOKENS.Formatter).give(PrettyFormatter).otherwise(JsonFormatter);
+		this._container.registerSingleton(LOGGER_TOKENS.ConsoleTransport, ConsoleTransport);
+		this._container.registerFactory(LOGGER_TOKENS.Transports, (c) => [c.resolve(LOGGER_TOKENS.ConsoleTransport)]);
+		this._container.registerSingleton(LOGGER_TOKENS.LoggerService, LoggerService);
+	}
+	/**
+	* Register core services with explicit scope
+	*/
+	registerCoreServices() {
+		this._container.registerSingleton(DI_TOKENS.Cron, CronManager);
+		this._container.register(DI_TOKENS.ErrorHandler, GlobalErrorHandler);
+		this._container.registerSingleton(DI_TOKENS.EventRegistry, EventRegistry);
+	}
+};
+//#endregion
+//#region src/stratal.ts
+/**
+* Stratal — Hono-style entry point for Cloudflare Workers.
+*
+* Eagerly bootstraps the Application at construction time, dynamically
+* importing `cloudflare:workers` for env and waitUntil.
+*
+* @example
+* ```typescript
+* import { Stratal } from 'stratal'
+* import { AppModule } from './app.module'
+*
+* export default new Stratal({ module: AppModule })
+* ```
+*/
+var Stratal = class Stratal {
+	app = null;
+	initPromise;
+	static _application = null;
+	constructor(config) {
+		this.fetch = this.fetch.bind(this);
+		this.queue = this.queue.bind(this);
+		this.scheduled = this.scheduled.bind(this);
+		this.initPromise = this.prepareApp(config);
+		Stratal._application = this.initPromise;
+	}
+	async fetch(request, env, ctx) {
+		return (await this.ensureReady()).hono.fetch(request, env, ctx);
+	}
+	async queue(batch) {
+		return (await this.ensureReady()).handleQueue(batch, batch.queue);
+	}
+	async scheduled(controller) {
+		return (await this.ensureReady()).handleScheduled(controller);
+	}
+	get hono() {
+		return this.initPromise.then((app) => app.hono);
+	}
+	async shutdown() {
+		try {
+			this.app = await this.initPromise;
+		} catch {}
+		if (this.app) {
+			await this.app.shutdown();
+			this.app = null;
+		}
+	}
+	/**
+	* @internal
+	* Resolves the Application instance from the static singleton.
+	* Used by worker base classes (DurableObject, Workflow, WorkerEntrypoint)
+	* to access the DI container without going through Cloudflare RPC.
+	*/
+	static resolveApplication() {
+		if (!Stratal._application) throw new StratalNotInitializedError();
+		return Stratal._application;
+	}
+	async ensureReady() {
+		this.app ??= await this.initPromise;
+		return this.app;
+	}
+	async prepareApp(config) {
+		const { env, waitUntil } = await import("cloudflare:workers");
+		const app = new Application({
+			...config,
+			env,
+			ctx: { waitUntil }
+		});
+		await app.initialize();
+		return app;
+	}
+};
+//#endregion
+export { Application as n, Stratal as t };
+
+//# sourceMappingURL=stratal-D4MS_7pI.mjs.map

package/dist/stratal-D4MS_7pI.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"stratal-D4MS_7pI.mjs","names":["tsyringeRootContainer"],"sources":["../src/application.ts","../src/stratal.ts"],"sourcesContent":["import { container as tsyringeRootContainer } from 'tsyringe'\nimport { CacheModule } from './cache'\nimport type { CronJob } from './cron/cron-job'\nimport { CronManager } from './cron/cron-manager'\nimport { Container } from './di/container'\nimport { DI_TOKENS } from './di/tokens'\nimport { type StratalEnv } from './env'\nimport { ApplicationError, GlobalErrorHandler } from './errors'\nimport type { EventHandler } from './events'\nimport { EventRegistry, getListenerHandlers } from './events'\nimport type { StratalExecutionContext } from './execution-context'\nimport { I18nModule } from './i18n/i18n.module'\nimport { ConsoleTransport, JsonFormatter, LOGGER_TOKENS, LoggerService, LogLevel, PrettyFormatter } from './logger'\nimport { ModuleRegistry } from './module/module-registry'\nimport type { DynamicModule, ModuleClass } from './module/types'\nimport { OpenAPIModule } from './openapi'\nimport { type ConsumerRegistry } from './queue/consumer-registry'\nimport type { IQueueConsumer, QueueMessage } from './queue/queue-consumer'\nimport { type QueueManager } from './queue/queue-manager'\nimport { QueueModule } from './queue/queue.module'\nimport { type IController, type RouterContext } from './router'\nimport { HonoApp } from './router/hono-app'\nimport type { VersioningOptions } from './router/types'\nimport type { Constructor } from './types'\n\nexport interface ApplicationConfig {\n  /** Root application module */\n  module: ModuleClass | DynamicModule\n  /** Logging configuration. Defaults: level=INFO, formatter='json' */\n  logging?: {\n    level?: LogLevel\n    formatter?: 'json' | 'pretty'\n  }\n  /**\n   * API versioning configuration.\n   * When provided, enables URI-based versioning for controllers.\n   */\n  versioning?: VersioningOptions\n}\n\nexport interface ApplicationOptions extends ApplicationConfig {\n  env: StratalEnv\n  ctx: StratalExecutionContext\n}\n\n/**\n * Application\n *\n * Main application class managing the two-tier container hierarchy:\n * - Global Container: All services (singletons via tsyringe native)\n * - Request Container: Child of global, context-enriched instances per request\n *\n * @example\n * ```typescript\n * const app = new Application({ module: AppModule, env, ctx })\n * await app.initialize()\n *\n * // Access container via getter\n * const service = app.container.resolve(MY_TOKEN)\n *\n * // Handle HTTP request (via HonoApp)\n * // Handle queue batch\n * await app.handleQueue(batch, 'my-queue')\n * ```\n */\nexport class Application {\n  /**\n   * Unified Container - manages all DI operations\n   */\n  private _container: Container\n\n  private honoApp!: HonoApp\n  private moduleRegistry: ModuleRegistry\n  private consumerRegistry!: ConsumerRegistry\n  private cronManager!: CronManager\n  private initialized = false\n\n  readonly env: StratalEnv\n  private readonly appConfig: ApplicationConfig\n\n  constructor({ env, ctx, ...config }: ApplicationOptions) {\n    this.env = env\n    this.appConfig = config\n\n    ApplicationError.captureStackTraces = env.ENVIRONMENT !== 'production'\n\n    // Create unified Container with explicit child container\n    this._container = new Container({\n      container: tsyringeRootContainer.createChildContainer()\n    })\n\n    // Register globally — env and ctx always available\n    this._container.registerValue(DI_TOKENS.Application, this)\n    this._container.registerValue(DI_TOKENS.CloudflareEnv, env)\n    this._container.registerValue(DI_TOKENS.ExecutionContext, ctx)\n\n    // Register core infrastructure inline\n    this.registerLoggerService()\n    this.registerCoreServices()\n\n    // Create ModuleRegistry with our Container\n    const logger = this._container.resolve<LoggerService>(LOGGER_TOKENS.LoggerService)\n    this.moduleRegistry = new ModuleRegistry(this._container, logger)\n\n    // Register ModuleRegistry in container so modules can access it in onInitialize\n    this._container.registerValue(DI_TOKENS.ModuleRegistry, this.moduleRegistry)\n  }\n\n  /**\n   * Get the Container instance\n   */\n  get container(): Container {\n    return this._container\n  }\n\n  /**\n   * Get the HonoApp instance\n   */\n  get hono(): HonoApp {\n    return this.honoApp\n  }\n\n  async initialize(): Promise<void> {\n    if (this.initialized) {\n      return\n    }\n\n    // Phase 1: Register core infrastructure modules (internal)\n    this.moduleRegistry.registerAll([\n      I18nModule,\n      OpenAPIModule,\n      QueueModule,\n      CacheModule,\n    ])\n\n    // Phase 2: Register user's root module (traverses imports)\n    this.moduleRegistry.register(this.appConfig.module)\n\n    // Phase 3: Initialize all modules\n    await this.moduleRegistry.initialize()\n\n    // Phase 4: Resolve managers from container\n    this.consumerRegistry = this._container.resolve<ConsumerRegistry>(DI_TOKENS.ConsumerRegistry)\n    this.cronManager = this._container.resolve<CronManager>(DI_TOKENS.Cron)\n\n    // Phase 5: Create & configure HonoApp\n    const logger = this._container.resolve<LoggerService>(LOGGER_TOKENS.LoggerService)\n    this.honoApp = new HonoApp(this._container, logger)\n    const middlewareConfigs = this.moduleRegistry.getAllMiddlewareConfigs()\n    const controllers = this.moduleRegistry.getAllControllers() as Constructor<IController>[]\n    await this.honoApp.configure(middlewareConfigs, controllers, this.appConfig.versioning)\n\n    // Phase 6: Configure queues, cron, events\n    this.registerQueueConsumers()\n    this.registerCronJobs()\n    this.registerEventListeners()\n\n    this.initialized = true\n  }\n\n  /**\n   * Resolve a service from the container\n   */\n  resolve<T>(token: symbol): T {\n    try {\n      return this._container.resolve(token)\n    } catch (error) {\n      const errorHandler = this._container.resolve<GlobalErrorHandler>(DI_TOKENS.ErrorHandler)\n      const errorResponse = errorHandler.handle(error)\n      throw errorResponse as unknown as Error\n    }\n  }\n\n  /**\n   * Handle queue batch processing\n   */\n  async handleQueue(batch: MessageBatch, queueName: string): Promise<void> {\n    const firstMessage = batch.messages[0]?.body as QueueMessage | undefined\n    const locale = firstMessage?.metadata?.locale ?? 'en'\n    const mockRouterContext = this.createMockRouterContext(locale)\n\n    await this._container.runInRequestScope(mockRouterContext, async (requestContainer) => {\n      try {\n        const queueManager = requestContainer.resolve<QueueManager>(DI_TOKENS.Queue)\n        await queueManager.processBatch(queueName, batch)\n      } catch (error) {\n        const errorHandler = requestContainer.resolve<GlobalErrorHandler>(DI_TOKENS.ErrorHandler)\n        errorHandler.handle(error)\n        throw error\n      }\n    })\n  }\n\n  /**\n   * Handle scheduled cron trigger\n   */\n  async handleScheduled(controller: ScheduledController): Promise<void> {\n    const mockRouterContext = this.createMockRouterContext('en')\n\n    await this._container.runInRequestScope(mockRouterContext, async (requestContainer) => {\n      try {\n        await this.cronManager.executeScheduled(controller)\n      } catch (error) {\n        const errorHandler = requestContainer.resolve<GlobalErrorHandler>(DI_TOKENS.ErrorHandler)\n        errorHandler.handle(error)\n        throw error\n      }\n    })\n  }\n\n  /**\n   * Create mock RouterContext for queue/cron/seeder processing\n   */\n  createMockRouterContext(locale = 'en'): RouterContext {\n    return {\n      getLocale: () => locale,\n      setLocale: () => { /* no-op */ },\n      getContainer: () => this._container,\n    } as unknown as RouterContext\n  }\n\n  async shutdown(): Promise<void> {\n    if (!this.initialized) return\n    this.initialized = false\n\n    await this.moduleRegistry.shutdown()\n\n    const logger = this._container.resolve<LoggerService>(LOGGER_TOKENS.LoggerService)\n    logger.info('Disposing container...')\n\n    await this._container.dispose()\n  }\n\n  private registerQueueConsumers(): void {\n    for (const ConsumerClass of this.moduleRegistry.getAllConsumers()) {\n      const consumer = this._container.resolve(ConsumerClass) as IQueueConsumer\n      this.consumerRegistry.register(consumer)\n    }\n  }\n\n  private registerCronJobs(): void {\n    for (const JobClass of this.moduleRegistry.getAllJobs()) {\n      const job = this._container.resolve(JobClass) as CronJob\n      this.cronManager.registerJob(job)\n    }\n  }\n\n  /**\n   * Auto-wire `@Listener()` classes with the EventRegistry.\n   */\n  private registerEventListeners(): void {\n    const listeners = this.moduleRegistry.getAllListeners()\n    if (listeners.length === 0) {\n      return\n    }\n\n    const eventRegistry = this._container.resolve<EventRegistry>(DI_TOKENS.EventRegistry)\n\n    for (const ListenerClass of listeners) {\n      const instance = this._container.resolve(ListenerClass) as Record<string, ((...args: unknown[]) => unknown)>\n      const handlers = getListenerHandlers(ListenerClass)\n\n      for (const { methodName, event, options } of handlers) {\n        eventRegistry.on(event, instance[methodName].bind(instance) as EventHandler, options)\n      }\n    }\n  }\n\n  /**\n   * Register LoggerService and dependencies\n   */\n  private registerLoggerService(): void {\n    const logLevel = this.appConfig.logging?.level ?? LogLevel.INFO\n    const formatter = this.appConfig.logging?.formatter ?? 'json'\n\n    this._container.registerValue(LOGGER_TOKENS.LogLevelOptions, logLevel)\n\n    this._container\n      .when(() => formatter === 'pretty')\n      .use(LOGGER_TOKENS.Formatter)\n      .give(PrettyFormatter)\n      .otherwise(JsonFormatter)\n\n    this._container.registerSingleton(LOGGER_TOKENS.ConsoleTransport, ConsoleTransport)\n    this._container.registerFactory(LOGGER_TOKENS.Transports, (c) => [c.resolve(LOGGER_TOKENS.ConsoleTransport)])\n    this._container.registerSingleton(LOGGER_TOKENS.LoggerService, LoggerService)\n  }\n\n  /**\n   * Register core services with explicit scope\n   */\n  private registerCoreServices(): void {\n    this._container.registerSingleton(DI_TOKENS.Cron, CronManager)\n    this._container.register(DI_TOKENS.ErrorHandler, GlobalErrorHandler)\n    this._container.registerSingleton(DI_TOKENS.EventRegistry, EventRegistry)\n  }\n}\n","import 'reflect-metadata'\n\nimport { Application, type ApplicationConfig } from './application'\nimport type { StratalEnv } from './env'\nimport { StratalNotInitializedError } from './errors'\nimport type { HonoApp } from './router/hono-app'\n\n/**\n * Stratal — Hono-style entry point for Cloudflare Workers.\n *\n * Eagerly bootstraps the Application at construction time, dynamically\n * importing `cloudflare:workers` for env and waitUntil.\n *\n * @example\n * ```typescript\n * import { Stratal } from 'stratal'\n * import { AppModule } from './app.module'\n *\n * export default new Stratal({ module: AppModule })\n * ```\n */\nexport class Stratal<Env extends StratalEnv = StratalEnv> {\n  private app: Application | null = null\n  private initPromise: Promise<Application>\n\n  private static _application: Promise<Application> | null = null\n\n  constructor(config: ApplicationConfig) {\n    this.fetch = this.fetch.bind(this)\n    this.queue = this.queue.bind(this)\n    this.scheduled = this.scheduled.bind(this)\n\n    this.initPromise = this.prepareApp(config)\n    Stratal._application = this.initPromise\n  }\n\n  async fetch(request: Request, env: Env, ctx: ExecutionContext): Promise<Response> {\n    const app = await this.ensureReady()\n    return app.hono.fetch(request, env, ctx)\n  }\n\n  async queue(batch: MessageBatch): Promise<void> {\n    const app = await this.ensureReady()\n    return app.handleQueue(batch, batch.queue)\n  }\n\n  async scheduled(controller: ScheduledController): Promise<void> {\n    const app = await this.ensureReady()\n    return app.handleScheduled(controller)\n  }\n\n  get hono(): Promise<HonoApp> {\n    return this.initPromise.then(app => app.hono)\n  }\n\n  async shutdown(): Promise<void> {\n    try { this.app = await this.initPromise } catch { /* ignore */ }\n    if (this.app) {\n      await this.app.shutdown()\n      this.app = null\n    }\n  }\n\n  /**\n   * @internal\n   * Resolves the Application instance from the static singleton.\n   * Used by worker base classes (DurableObject, Workflow, WorkerEntrypoint)\n   * to access the DI container without going through Cloudflare RPC.\n   */\n  static resolveApplication(): Promise<Application> {\n    if (!Stratal._application) {\n      throw new StratalNotInitializedError()\n    }\n    return Stratal._application\n  }\n\n  private async ensureReady(): Promise<Application> {\n    this.app ??= await this.initPromise;\n    return this.app\n  }\n\n  private async prepareApp(config: ApplicationConfig): Promise<Application> {\n    const { env, waitUntil } = await import('cloudflare:workers')\n    const app = new Application({ ...config, env: env as Env, ctx: { waitUntil } })\n    await app.initialize()\n    return app\n  }\n}\n"],"mappings":"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"}

package/dist/{types.d.ts → types-JUIHSW_a.d.mts}

@@ -1,3 +1,4 @@
+//#region src/types.d.ts
 /**
  * Generic type for class constructors
  *
@@ -12,5 +13,7 @@
  * ]
  * ```
  */
-export type Constructor<T extends object = object> = new (...args: any[]) => T;
-//# sourceMappingURL=types.d.ts.map
+type Constructor<T extends object = object> = new (...args: any[]) => T;
+//#endregion
+export { Constructor as t };
+//# sourceMappingURL=types-JUIHSW_a.d.mts.map

package/dist/types-JUIHSW_a.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-JUIHSW_a.d.mts","names":[],"sources":["../src/types.ts"],"mappings":";;AAeA;;;;;;;;;;;;;KAAY,WAAA,sCAAiD,IAAA,YAAgB,CAAA"}

package/dist/validation-DA5nptIp.mjs

@@ -0,0 +1,194 @@
+import { n as __reExport, t as __exportAll } from "./chunk-D1SwGrFN.mjs";
+import { OpenAPIHono, z } from "@hono/zod-openapi";
+import { ZodError } from "zod";
+import { AsyncLocalStorage } from "node:async_hooks";
+//#region src/i18n/validation/validation.error-map.ts
+/**
+* Type guards for narrowing Zod v4 issue types
+*/
+function isInvalidType(issue) {
+	return issue.code === "invalid_type";
+}
+function isTooBig(issue) {
+	return issue.code === "too_big";
+}
+function isTooSmall(issue) {
+	return issue.code === "too_small";
+}
+function isInvalidFormat(issue) {
+	return issue.code === "invalid_format";
+}
+function isNotMultipleOf(issue) {
+	return issue.code === "not_multiple_of";
+}
+function isUnrecognizedKeys(issue) {
+	return issue.code === "unrecognized_keys";
+}
+function isInvalidUnion(issue) {
+	return issue.code === "invalid_union";
+}
+function isInvalidKey(issue) {
+	return issue.code === "invalid_key";
+}
+/**
+* Maps Zod issue codes to zodI18n message keys
+* Adapted for Zod v4's simpler issue code system
+*/
+function getMessageKey(issue) {
+	if (isInvalidType(issue)) {
+		if (issue.input === void 0) return "zodI18n.errors.required";
+		return "zodI18n.errors.invalid_type";
+	}
+	if (isTooSmall(issue)) return `zodI18n.errors.too_small.${issue.origin || "string"}.${issue.exact ? "exact" : issue.inclusive ? "inclusive" : "not_inclusive"}`;
+	if (isTooBig(issue)) return `zodI18n.errors.too_big.${issue.origin || "string"}.${issue.exact ? "exact" : issue.inclusive ? "inclusive" : "not_inclusive"}`;
+	if (isInvalidFormat(issue)) return `zodI18n.errors.invalid_string.${issue.format}`;
+	if (isNotMultipleOf(issue)) return "zodI18n.errors.not_multiple_of";
+	if (isUnrecognizedKeys(issue)) return "zodI18n.errors.unrecognized_keys";
+	if (isInvalidUnion(issue)) return "zodI18n.errors.invalid_union";
+	if (isInvalidKey(issue)) return "zodI18n.errors.invalid_enum_value";
+	return "zodI18n.errors.custom.default";
+}
+/**
+* Extracts interpolation parameters from Zod issue
+* Uses proper type narrowing for v4
+*/
+function getMessageParams(issue) {
+	const params = {};
+	if (isInvalidType(issue)) {
+		params.expected = issue.expected;
+		params.received = String(issue.input);
+		return params;
+	}
+	if (isUnrecognizedKeys(issue)) {
+		params.keys = issue.keys.join(", ");
+		return params;
+	}
+	if (isInvalidKey(issue)) return params;
+	if (isInvalidFormat(issue)) {
+		params.validation = issue.format;
+		if ("prefix" in issue) params.startsWith = issue.prefix;
+		if ("suffix" in issue) params.endsWith = issue.suffix;
+		if ("includes" in issue) params.includes = issue.includes;
+		if (issue.pattern) params.pattern = issue.pattern;
+		return params;
+	}
+	if (isTooSmall(issue)) {
+		params.minimum = issue.minimum;
+		params.type = issue.origin;
+		if (issue.origin === "date") params.minimum = new Date(Number(issue.minimum)).toLocaleDateString();
+		return params;
+	}
+	if (isTooBig(issue)) {
+		params.maximum = issue.maximum;
+		params.type = issue.origin;
+		if (issue.origin === "date") params.maximum = new Date(Number(issue.maximum)).toLocaleDateString();
+		return params;
+	}
+	if (isNotMultipleOf(issue)) {
+		params.multipleOf = issue.divisor;
+		return params;
+	}
+	return params;
+}
+/**
+* Creates a Zod error map that uses i18n for translation
+* Uses Zod v4 native $ZodErrorMap signature (no ctx parameter)
+*/
+function createI18nErrorMap(getContext) {
+	return (issue) => {
+		const messageKey = getMessageKey(issue);
+		const messageParams = getMessageParams(issue);
+		const context = getContext();
+		if (!context) return { message: "Invalid input" };
+		return { message: context.t(messageKey, messageParams) };
+	};
+}
+//#endregion
+//#region src/i18n/validation/validation.context.ts
+/**
+* AsyncLocalStorage for storing request-scoped ErrorMapContext
+* Allows error map to access I18nService without passing through function calls
+*/
+const errorMapContextStorage = new AsyncLocalStorage();
+/**
+* Gets the current error map context from AsyncLocalStorage
+*/
+function getErrorMapContext() {
+	return errorMapContextStorage.getStore();
+}
+/**
+* Backend error map that accesses I18nService from AsyncLocalStorage
+* Must be initialized in router middleware after locale detection
+*/
+const backendErrorMap = createI18nErrorMap(getErrorMapContext);
+/**
+* Runs a function within an error map context
+* Used by router middleware to provide I18nService to validation
+*
+* @example
+* ```typescript
+* router.use('*', async (c, next) => {
+*   const i18nService = c.get('i18nService')
+*   const locale = c.get('locale')
+*
+*   return runWithErrorMapContext(
+*     {
+*       t: (key, params) => i18nService.t(key, params),
+*       locale,
+*     },
+*     () => next()
+*   )
+* })
+* ```
+*/
+function runWithErrorMapContext(context, fn) {
+	return errorMapContextStorage.run(context, fn);
+}
+//#endregion
+//#region src/i18n/validation/with-i18n.ts
+/**
+* Type-safe helper for creating custom Zod error messages with i18n support (Backend)
+*
+* Usage with .refine():
+* ```typescript
+* const schema = z.string().refine(
+*   (val) => val.length > 5,
+*   withI18n('validation.minLength', { min: 5 })
+* )
+* ```
+*
+* Usage with built-in validators:
+* ```typescript
+* const schema = z.string().min(5, withI18n('validation.minLength', { min: 5 }))
+* const schema = z.string().email(withI18n('validation.email'))
+* ```
+*
+* Note: This is the backend version using AsyncLocalStorage.
+* For frontend, use withI18nFrontend from the frontend validation module
+*
+* @param key - Message key from shared i18n messages (type-safe via MessageKeys)
+* @param params - Optional interpolation parameters for the message
+* @returns Zod error configuration object with translated message
+*/
+function withI18n(key, params) {
+	return { error: () => {
+		const context = errorMapContextStorage.getStore();
+		return context ? context.t(key, params) : "Invalid input";
+	} };
+}
+//#endregion
+//#region src/i18n/validation/index.ts
+var validation_exports = /* @__PURE__ */ __exportAll({
+	OpenAPIHono: () => OpenAPIHono,
+	ZodError: () => ZodError,
+	backendErrorMap: () => backendErrorMap,
+	runWithErrorMapContext: () => runWithErrorMapContext,
+	withI18n: () => withI18n,
+	z: () => z
+});
+import * as import__hono_zod_openapi from "@hono/zod-openapi";
+__reExport(validation_exports, import__hono_zod_openapi);
+//#endregion
+export { withI18n as a, z as i, ZodError as n, backendErrorMap as o, validation_exports as r, runWithErrorMapContext as s, OpenAPIHono as t };
+
+//# sourceMappingURL=validation-DA5nptIp.mjs.map

package/dist/validation-DA5nptIp.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation-DA5nptIp.mjs","names":[],"sources":["../src/i18n/validation/validation.error-map.ts","../src/i18n/validation/validation.context.ts","../src/i18n/validation/with-i18n.ts","../src/i18n/validation/index.ts"],"sourcesContent":["import type {\n  $ZodErrorMap,\n  $ZodIssueInvalidKey,\n  $ZodIssueInvalidStringFormat,\n  $ZodIssueInvalidType,\n  $ZodIssueInvalidUnion,\n  $ZodIssueNotMultipleOf,\n  $ZodIssueTooBig,\n  $ZodIssueTooSmall,\n  $ZodIssueUnrecognizedKeys,\n  $ZodRawIssue,\n} from 'zod/v4/core'\nimport type { MessageKeys } from '../i18n.types'\nimport type { ErrorMapContext } from './validation.types'\n\n/**\n * Type guards for narrowing Zod v4 issue types\n */\nfunction isInvalidType(issue: $ZodRawIssue): issue is $ZodRawIssue<$ZodIssueInvalidType> {\n  return issue.code === 'invalid_type'\n}\n\nfunction isTooBig(issue: $ZodRawIssue): issue is $ZodRawIssue<$ZodIssueTooBig> {\n  return issue.code === 'too_big'\n}\n\nfunction isTooSmall(issue: $ZodRawIssue): issue is $ZodRawIssue<$ZodIssueTooSmall> {\n  return issue.code === 'too_small'\n}\n\nfunction isInvalidFormat(issue: $ZodRawIssue): issue is $ZodRawIssue<$ZodIssueInvalidStringFormat> {\n  return issue.code === 'invalid_format'\n}\n\nfunction isNotMultipleOf(issue: $ZodRawIssue): issue is $ZodRawIssue<$ZodIssueNotMultipleOf> {\n  return issue.code === 'not_multiple_of'\n}\n\nfunction isUnrecognizedKeys(issue: $ZodRawIssue): issue is $ZodRawIssue<$ZodIssueUnrecognizedKeys> {\n  return issue.code === 'unrecognized_keys'\n}\n\nfunction isInvalidUnion(issue: $ZodRawIssue): issue is $ZodRawIssue<$ZodIssueInvalidUnion> {\n  return issue.code === 'invalid_union'\n}\n\nfunction isInvalidKey(issue: $ZodRawIssue): issue is $ZodRawIssue<$ZodIssueInvalidKey> {\n  return issue.code === 'invalid_key'\n}\n\n/**\n * Maps Zod issue codes to zodI18n message keys\n * Adapted for Zod v4's simpler issue code system\n */\nfunction getMessageKey(issue: $ZodRawIssue): MessageKeys {\n  if (isInvalidType(issue)) {\n    if (issue.input === undefined) {\n      return 'zodI18n.errors.required'\n    }\n    return 'zodI18n.errors.invalid_type'\n  }\n\n  if (isTooSmall(issue)) {\n    const typeKey = issue.origin || 'string'\n    const exactKey = issue.exact\n      ? 'exact'\n      : issue.inclusive\n        ? 'inclusive'\n        : 'not_inclusive'\n    return `zodI18n.errors.too_small.${typeKey}.${exactKey}` as MessageKeys\n  }\n\n  if (isTooBig(issue)) {\n    const typeKey = issue.origin || 'string'\n    const exactKey = issue.exact\n      ? 'exact'\n      : issue.inclusive\n        ? 'inclusive'\n        : 'not_inclusive'\n    return `zodI18n.errors.too_big.${typeKey}.${exactKey}` as MessageKeys\n  }\n\n  if (isInvalidFormat(issue)) {\n    // Map v4's format to v3-style validation keys\n    return `zodI18n.errors.invalid_string.${issue.format}` as MessageKeys\n  }\n\n  if (isNotMultipleOf(issue)) {\n    return 'zodI18n.errors.not_multiple_of'\n  }\n\n  if (isUnrecognizedKeys(issue)) {\n    return 'zodI18n.errors.unrecognized_keys'\n  }\n\n  if (isInvalidUnion(issue)) {\n    return 'zodI18n.errors.invalid_union'\n  }\n\n  if (isInvalidKey(issue)) {\n    // v4: Replaces invalid_enum_value, invalid_literal\n    return 'zodI18n.errors.invalid_enum_value'\n  }\n\n  // invalid_element, invalid_value, or unknown codes\n  return 'zodI18n.errors.custom.default'\n}\n\n/**\n * Extracts interpolation parameters from Zod issue\n * Uses proper type narrowing for v4\n */\nfunction getMessageParams(issue: $ZodRawIssue): Record<string, unknown> {\n  const params: Record<string, unknown> = {}\n\n  if (isInvalidType(issue)) {\n    params.expected = issue.expected\n    params.received = String(issue.input)\n    return params\n  }\n\n  if (isUnrecognizedKeys(issue)) {\n    params.keys = issue.keys.join(', ')\n    return params\n  }\n\n  if (isInvalidKey(issue)) {\n    // v4: For enums and records\n    // Since v4 doesn't have options field, we'll use generic message\n    return params\n  }\n\n  if (isInvalidFormat(issue)) {\n    params.validation = issue.format\n\n    // Check for specific string format issues with additional fields\n    if ('prefix' in issue) {\n      params.startsWith = (issue as { prefix?: string }).prefix\n    }\n    if ('suffix' in issue) {\n      params.endsWith = (issue as { suffix?: string }).suffix\n    }\n    if ('includes' in issue) {\n      params.includes = (issue as { includes?: string }).includes\n    }\n    if (issue.pattern) {\n      params.pattern = issue.pattern\n    }\n\n    return params\n  }\n\n  if (isTooSmall(issue)) {\n    params.minimum = issue.minimum\n    params.type = issue.origin\n    if (issue.origin === 'date') {\n      params.minimum = new Date(Number(issue.minimum)).toLocaleDateString()\n    }\n    return params\n  }\n\n  if (isTooBig(issue)) {\n    params.maximum = issue.maximum\n    params.type = issue.origin\n    if (issue.origin === 'date') {\n      params.maximum = new Date(Number(issue.maximum)).toLocaleDateString()\n    }\n    return params\n  }\n\n  if (isNotMultipleOf(issue)) {\n    params.multipleOf = issue.divisor\n    return params\n  }\n\n  return params\n}\n\n/**\n * Creates a Zod error map that uses i18n for translation\n * Uses Zod v4 native $ZodErrorMap signature (no ctx parameter)\n */\nexport function createI18nErrorMap(getContext: () => ErrorMapContext | undefined): $ZodErrorMap {\n  return (issue: $ZodRawIssue): { message: string } => {\n    // Get message key and params for this issue\n    const messageKey = getMessageKey(issue)\n    const messageParams = getMessageParams(issue)\n\n    // Get translation context\n    const context = getContext()\n\n    if (!context) {\n      // Fallback: Use English messages directly\n      // This handles config validation at startup, tests, etc.\n      return { message: 'Invalid input' }\n    }\n\n    // Normal flow: Use context-aware i18n (respects user locale)\n    return {\n      message: context.t(messageKey, messageParams),\n    }\n  }\n}\n","import { AsyncLocalStorage } from 'node:async_hooks'\nimport type { ErrorMapContext } from './validation.types'\nimport { createI18nErrorMap } from './validation.error-map'\n\n/**\n * AsyncLocalStorage for storing request-scoped ErrorMapContext\n * Allows error map to access I18nService without passing through function calls\n */\nexport const errorMapContextStorage = new AsyncLocalStorage<ErrorMapContext>()\n\n/**\n * Gets the current error map context from AsyncLocalStorage\n */\nfunction getErrorMapContext(): ErrorMapContext | undefined {\n  return errorMapContextStorage.getStore()\n}\n\n/**\n * Backend error map that accesses I18nService from AsyncLocalStorage\n * Must be initialized in router middleware after locale detection\n */\nexport const backendErrorMap = createI18nErrorMap(getErrorMapContext)\n\n/**\n * Runs a function within an error map context\n * Used by router middleware to provide I18nService to validation\n *\n * @example\n * ```typescript\n * router.use('*', async (c, next) => {\n *   const i18nService = c.get('i18nService')\n *   const locale = c.get('locale')\n *\n *   return runWithErrorMapContext(\n *     {\n *       t: (key, params) => i18nService.t(key, params),\n *       locale,\n *     },\n *     () => next()\n *   )\n * })\n * ```\n */\nexport function runWithErrorMapContext<T>(\n  context: ErrorMapContext,\n  fn: () => T\n): T {\n  return errorMapContextStorage.run(context, fn)\n}\n","import type { MessageKeys } from '../i18n.types'\nimport { errorMapContextStorage } from './validation.context'\n\n/**\n * Type-safe helper for creating custom Zod error messages with i18n support (Backend)\n *\n * Usage with .refine():\n * ```typescript\n * const schema = z.string().refine(\n *   (val) => val.length > 5,\n *   withI18n('validation.minLength', { min: 5 })\n * )\n * ```\n *\n * Usage with built-in validators:\n * ```typescript\n * const schema = z.string().min(5, withI18n('validation.minLength', { min: 5 }))\n * const schema = z.string().email(withI18n('validation.email'))\n * ```\n *\n * Note: This is the backend version using AsyncLocalStorage.\n * For frontend, use withI18nFrontend from the frontend validation module\n *\n * @param key - Message key from shared i18n messages (type-safe via MessageKeys)\n * @param params - Optional interpolation parameters for the message\n * @returns Zod error configuration object with translated message\n */\nexport function withI18n(\n  key: MessageKeys,\n  params?: Record<string, unknown>\n): { error: () => string } {\n  return {\n    error: () => {\n      // Get i18n context from AsyncLocalStorage (backend)\n      // This is set by the router middleware before validation\n      const context = errorMapContextStorage.getStore()\n\n      // Translate using context if available, otherwise fallback to generic message\n      const message = context\n        ? context.t(key, params as Record<string, string | number> | undefined)\n        : 'Invalid input'\n\n      return message\n    },\n  }\n}\n","// Consolidated zod - single source from @hono/zod-openapi (superset of zod)\nexport { OpenAPIHono, z } from '@hono/zod-openapi'\nexport type * from 'zod'\nexport { ZodError } from 'zod'\n\n// OpenAPI utilities\nexport * from '@hono/zod-openapi'\nexport type { OpenAPIObject, PathItemObject } from 'openapi3-ts/oas30'\n\n// Helpers\nexport { withI18n } from './with-i18n'\n\n// Backend utilities\nexport { backendErrorMap, runWithErrorMapContext } from './validation.context'\n\n// Types\nexport type { ErrorMapContext, I18nErrorMetadata, LocaleProvider, ZodCustomIssue } from './validation.types'\n\n"],"mappings":"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"}