alepha 0.20.4 → 0.20.6

package/dist/api/verifications/index.d.ts

@@ -90,16 +90,16 @@ declare module "alepha" {
 declare class VerificationParameters {
   protected readonly options: Readonly<{
     link: {
+      maxAttempts: number;
       codeExpiration: number;
       verificationCooldown: number;
-      maxAttempts: number;
       limitPerDay: number;
     };
     code: {
-      codeExpiration: number;
-      verificationCooldown: number;
       maxAttempts: number;
       codeLength: number;
+      codeExpiration: number;
+      verificationCooldown: number;
       limitPerDay: number;
     };
     purgeDays: number;

package/dist/api/verifications/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../src/api/verifications/schemas/requestVerificationCodeResponseSchema.ts","../../../src/api/verifications/schemas/validateVerificationCodeResponseSchema.ts","../../../src/api/verifications/schemas/verificationTypeEnumSchema.ts","../../../src/api/verifications/entities/verifications.ts","../../../src/api/verifications/schemas/verificationSettingsSchema.ts","../../../src/api/verifications/parameters/VerificationParameters.ts","../../../src/api/verifications/services/VerificationService.ts","../../../src/api/verifications/controllers/VerificationController.ts","../../../src/api/verifications/jobs/VerificationJobs.ts","../../../src/api/verifications/index.ts"],"sourcesContent":["import type { Static } from \"alepha\";\nimport { t } from \"alepha\";\n\nexport const requestVerificationCodeResponseSchema = t.object({\n  token: t.string({\n    description:\n      \"The verification token (6-digit code for phone, UUID for email). The caller should send this to the user via their preferred notification method.\",\n  }),\n  codeExpiration: t.integer({\n    description: \"Time in seconds before your verification token expires.\",\n  }),\n  verificationCooldown: t.integer({\n    description:\n      \"Cooldown period in seconds before you can request another verification.\",\n  }),\n  maxVerificationAttempts: t.integer({\n    description:\n      \"Maximum number of verification attempts allowed before the token is locked.\",\n  }),\n});\n\nexport type RequestVerificationResponse = Static<\n  typeof requestVerificationCodeResponseSchema\n>;\n","import type { Static } from \"alepha\";\nimport { t } from \"alepha\";\n\nexport const validateVerificationCodeResponseSchema = t.object({\n  ok: t.boolean({\n    description: \"Indicates whether the verification was successful.\",\n  }),\n  alreadyVerified: t.optional(\n    t.boolean({\n      description: \"Indicates whether the target was already verified.\",\n    }),\n  ),\n});\n\nexport type ValidateVerificationCodeResponse = Static<\n  typeof validateVerificationCodeResponseSchema\n>;\n","import type { Static } from \"alepha\";\nimport { t } from \"alepha\";\n\nexport const verificationTypeEnumSchema = t.enum([\"code\", \"link\"]);\nexport type VerificationTypeEnum = Static<typeof verificationTypeEnumSchema>;\n","import type { Static } from \"alepha\";\nimport { t } from \"alepha\";\nimport { $entity, db } from \"alepha/orm\";\nimport { verificationTypeEnumSchema } from \"../schemas/verificationTypeEnumSchema.ts\";\n\nexport const verifications = $entity({\n  name: \"verification\",\n  schema: t.object({\n    id: db.primaryKey(t.bigint()),\n\n    createdAt: db.createdAt(),\n\n    updatedAt: db.updatedAt(),\n\n    version: db.version(),\n\n    type: verificationTypeEnumSchema,\n\n    target: t.text({\n      description: \"Can be a phone (E.164 format) or email address\",\n    }),\n\n    code: t.text({\n      description: \"Hashed verification token (n-digit code or UUID)\",\n    }),\n\n    verifiedAt: t.optional(\n      t.datetime({\n        description: \"When it was successfully verified\",\n      }),\n    ),\n\n    attempts: db.default(\n      t.integer({\n        description: \"Number of failed attempts (to prevent brute-force)\",\n      }),\n      0,\n    ),\n  }),\n  indexes: [\n    \"createdAt\",\n    {\n      columns: [\"target\", \"code\"],\n    },\n  ],\n});\n\nexport const verificationEntitySchema = verifications.schema;\nexport const verificationEntityInsertSchema = verifications.insertSchema;\nexport type VerificationEntity = Static<typeof verifications.schema>;\n","import type { Static } from \"alepha\";\nimport { t } from \"alepha\";\n\nexport const verificationSettingsSchema = t.object({\n  code: t.object(\n    {\n      maxAttempts: t.integer({\n        description:\n          \"Maximum number of attempts before locking the verification.\",\n        minimum: 1,\n        maximum: 10,\n      }),\n      codeLength: t.integer({\n        description: \"Length of the verification code.\",\n        minimum: 4,\n        maximum: 12,\n      }),\n      codeExpiration: t.integer({\n        description: \"Time in seconds before the verification code expires.\",\n        minimum: 60, // 1 minute\n        maximum: 3600, // 1 hour\n      }),\n      verificationCooldown: t.integer({\n        description: \"Cooldown period in seconds after a request verification.\",\n        minimum: 0,\n        maximum: 3600, // 1 hour\n      }),\n      limitPerDay: t.integer({\n        description:\n          \"Maximum number of verification requests per day for one entry.\",\n        minimum: 1,\n        maximum: 100,\n      }),\n    },\n    {\n      description: \"Settings specific to code verifications.\",\n    },\n  ),\n  link: t.object(\n    {\n      maxAttempts: t.integer({\n        description:\n          \"Maximum number of attempts before locking the verification.\",\n        minimum: 1,\n        maximum: 10,\n      }),\n      codeExpiration: t.integer({\n        description: \"Time in seconds before the verification token expires.\",\n        minimum: 60, // 1 minute\n        maximum: 7200, // 2 hours\n      }),\n      verificationCooldown: t.integer({\n        description: \"Cooldown period in seconds after a request verification.\",\n        minimum: 0,\n        maximum: 3600, // 1 hour\n      }),\n      limitPerDay: t.integer({\n        description:\n          \"Maximum number of verification requests per day for one entry.\",\n        minimum: 1,\n        maximum: 100,\n      }),\n    },\n    {\n      description: \"Settings specific to link verifications.\",\n    },\n  ),\n  purgeDays: t.integer({\n    description:\n      \"Number of days after which expired verifications are automatically deleted. Set to 0 to disable auto-deletion.\",\n    minimum: 0,\n    maximum: 365,\n  }),\n});\n\nexport type VerificationSettings = Static<typeof verificationSettingsSchema>;\n","import { $atom, $state, type Static } from \"alepha\";\nimport {\n  type VerificationSettings,\n  verificationSettingsSchema,\n} from \"../schemas/verificationSettingsSchema.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Verification settings configuration atom\n */\nexport const verificationOptions = $atom({\n  name: \"alepha.api.verifications.options\",\n  schema: verificationSettingsSchema,\n  default: {\n    code: {\n      maxAttempts: 5,\n      codeLength: 6,\n      codeExpiration: 300, // 5 minutes\n      verificationCooldown: 90,\n      limitPerDay: 10,\n    },\n    link: {\n      maxAttempts: 3, // Lower since UUIDs are harder to guess\n      codeExpiration: 1800, // 30 minutes\n      verificationCooldown: 90,\n      limitPerDay: 10,\n    },\n    purgeDays: 1,\n  },\n});\n\nexport type VerificationOptions = Static<typeof verificationOptions.schema>;\n\ndeclare module \"alepha\" {\n  interface State {\n    [verificationOptions.key]: VerificationOptions;\n  }\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport class VerificationParameters {\n  protected readonly options = $state(verificationOptions);\n\n  public get<K extends keyof VerificationSettings>(\n    key: K,\n  ): VerificationSettings[K] {\n    return this.options[key];\n  }\n}\n","import { createHash, randomInt, randomUUID } from \"node:crypto\";\nimport { $inject } from \"alepha\";\nimport { DateTimeProvider } from \"alepha/datetime\";\nimport { $logger } from \"alepha/logger\";\nimport { $repository } from \"alepha/orm\";\nimport { BadRequestError, NotFoundError } from \"alepha/server\";\nimport {\n  type VerificationEntity,\n  verifications,\n} from \"../entities/verifications.ts\";\nimport { VerificationParameters } from \"../parameters/VerificationParameters.ts\";\nimport type { RequestVerificationResponse } from \"../schemas/requestVerificationCodeResponseSchema.ts\";\nimport type { ValidateVerificationCodeResponse } from \"../schemas/validateVerificationCodeResponseSchema.ts\";\nimport type { VerificationTypeEnum } from \"../schemas/verificationTypeEnumSchema.ts\";\n\nexport class VerificationService {\n  protected readonly log = $logger();\n  protected readonly dateTimeProvider = $inject(DateTimeProvider);\n  protected readonly verificationParameters = $inject(VerificationParameters);\n  protected readonly verificationRepository = $repository(verifications);\n\n  public async findByEntry(\n    entry: VerificationEntry,\n  ): Promise<VerificationEntity> {\n    this.log.trace(\"Finding verification by entry\", {\n      type: entry.type,\n      target: entry.target,\n    });\n\n    const results = await this.verificationRepository.findMany({\n      limit: 1, // only need the most recent entry\n      orderBy: {\n        column: \"createdAt\",\n        direction: \"desc\",\n      },\n      where: {\n        type: { eq: entry.type },\n        target: { eq: entry.target },\n      },\n    });\n\n    if (results.length === 0) {\n      this.log.debug(\"Verification entry not found\", {\n        type: entry.type,\n        target: entry.target,\n      });\n      throw new NotFoundError(\"Verification entry not found\");\n    }\n\n    this.log.debug(\"Verification entry found\", {\n      id: results[0].id,\n      type: entry.type,\n      target: entry.target,\n    });\n\n    return results[0];\n  }\n\n  public findRecentsByEntry(entry: VerificationEntry) {\n    this.log.trace(\"Finding recent verifications by entry\", {\n      type: entry.type,\n      target: entry.target,\n    });\n\n    return this.verificationRepository.findMany({\n      orderBy: {\n        column: \"createdAt\",\n        direction: \"desc\",\n      },\n      where: {\n        type: { eq: entry.type },\n        target: { eq: entry.target },\n        createdAt: {\n          gte: this.dateTimeProvider.now().startOf(\"day\").toISOString(),\n        },\n      },\n    });\n  }\n\n  /**\n   * Creates a verification entry and returns the token.\n   * The caller is responsible for sending notifications with the token.\n   * This allows for context-specific notifications (e.g., password reset vs email verification).\n   */\n  public async createVerification(\n    entry: VerificationEntry,\n  ): Promise<RequestVerificationResponse> {\n    this.log.trace(\"Creating verification\", {\n      type: entry.type,\n      target: entry.target,\n    });\n\n    const settings = this.verificationParameters.get(entry.type);\n\n    const recents = await this.findRecentsByEntry(entry);\n    if (recents.length >= settings.limitPerDay) {\n      this.log.warn(\"Daily verification limit reached\", {\n        type: entry.type,\n        target: entry.target,\n        limit: settings.limitPerDay,\n        count: recents.length,\n      });\n      throw new BadRequestError(\n        `Maximum number of verification requests per day reached (${settings.limitPerDay})`,\n      );\n    }\n\n    const existingVerification = recents[0];\n    if (existingVerification) {\n      const nowSec = this.dateTimeProvider.now().unix();\n      const createdAtSec = this.dateTimeProvider\n        .of(existingVerification.createdAt)\n        .unix();\n\n      const diffSec = nowSec - createdAtSec;\n      if (diffSec < settings.verificationCooldown) {\n        const remainingCooldown = Math.floor(\n          settings.verificationCooldown - diffSec,\n        );\n        this.log.debug(\"Verification on cooldown\", {\n          type: entry.type,\n          target: entry.target,\n          remainingSeconds: remainingCooldown,\n        });\n        throw new BadRequestError(\n          `Verification is on cooldown for ${remainingCooldown} seconds`,\n        );\n      }\n    }\n\n    const token = this.generateToken(entry.type);\n\n    const verification = await this.verificationRepository.create({\n      type: entry.type,\n      target: entry.target,\n      code: this.hashCode(token),\n      createdAt: this.dateTimeProvider.nowISOString(),\n    });\n\n    this.log.info(\"Verification created\", {\n      id: verification.id,\n      type: entry.type,\n      target: entry.target,\n      expiresInSeconds: settings.codeExpiration,\n    });\n\n    return {\n      token,\n      codeExpiration: settings.codeExpiration,\n      verificationCooldown: settings.verificationCooldown,\n      maxVerificationAttempts: settings.maxAttempts,\n    };\n  }\n\n  public async verifyCode(\n    entry: VerificationEntry,\n    code: string,\n  ): Promise<ValidateVerificationCodeResponse> {\n    this.log.trace(\"Verifying code\", {\n      type: entry.type,\n      target: entry.target,\n    });\n\n    const settings = this.verificationParameters.get(entry.type);\n\n    const verification = await this.findByEntry(entry);\n    if (verification.verifiedAt) {\n      this.log.debug(\"Verification already verified\", {\n        id: verification.id,\n        type: entry.type,\n        target: entry.target,\n        verifiedAt: verification.verifiedAt,\n      });\n      return { ok: true, alreadyVerified: true };\n    }\n\n    // DO NOT DELETE THE VERIFICATION WHEN IT IS REJECTED,\n    // or we won't be able to cooldown the verification\n\n    const now = this.dateTimeProvider.now();\n    const expirationDate = this.dateTimeProvider\n      .of(verification.createdAt)\n      .add(settings.codeExpiration, \"seconds\");\n\n    if (now > expirationDate) {\n      this.log.warn(\"Verification code expired\", {\n        id: verification.id,\n        type: entry.type,\n        target: entry.target,\n        createdAt: verification.createdAt,\n        expiredAt: expirationDate.toISOString(),\n      });\n      throw new BadRequestError(\"Verification code has expired\");\n    }\n\n    if (verification.attempts >= settings.maxAttempts) {\n      this.log.warn(\"Verification locked due to max attempts\", {\n        id: verification.id,\n        type: entry.type,\n        target: entry.target,\n        attempts: verification.attempts,\n        maxAttempts: settings.maxAttempts,\n      });\n      throw new BadRequestError(\n        \"Maximum number of attempts reached - verification is locked\",\n      );\n    }\n\n    if (verification.code !== this.hashCode(code)) {\n      const newAttempts = verification.attempts + 1;\n      this.log.warn(\"Invalid verification code\", {\n        id: verification.id,\n        type: entry.type,\n        target: entry.target,\n        attempts: newAttempts,\n        maxAttempts: settings.maxAttempts,\n      });\n      await this.verificationRepository.updateById(verification.id, {\n        attempts: newAttempts,\n      });\n      throw new BadRequestError(\"Invalid verification code\");\n    }\n\n    await this.verificationRepository.updateById(verification.id, {\n      verifiedAt: this.dateTimeProvider.nowISOString(),\n    });\n\n    this.log.info(\"Verification code verified\", {\n      id: verification.id,\n      type: entry.type,\n      target: entry.target,\n    });\n\n    return { ok: true };\n  }\n\n  public hashCode(code: string): string {\n    return createHash(\"sha256\").update(code).digest(\"hex\");\n  }\n\n  public generateToken(type: VerificationTypeEnum): string {\n    if (type === \"code\") {\n      const settings = this.verificationParameters.get(\"code\");\n      return randomInt(0, 1_000_000)\n        .toString()\n        .padStart(settings.codeLength, \"0\");\n    } else if (type === \"link\") {\n      return randomUUID();\n    }\n\n    throw new BadRequestError(`Invalid verification type: ${type}`);\n  }\n}\n\nexport interface VerificationEntry {\n  type: VerificationTypeEnum;\n  target: string;\n}\n","import { $inject, t } from \"alepha\";\nimport { $action } from \"alepha/server\";\nimport { requestVerificationCodeResponseSchema } from \"../schemas/requestVerificationCodeResponseSchema.ts\";\nimport { validateVerificationCodeResponseSchema } from \"../schemas/validateVerificationCodeResponseSchema.ts\";\nimport { verificationTypeEnumSchema } from \"../schemas/verificationTypeEnumSchema.ts\";\nimport { VerificationService } from \"../services/VerificationService.ts\";\n\nexport class VerificationController {\n  protected readonly verificationService = $inject(VerificationService);\n\n  public readonly url = \"/verifications\";\n  public readonly group = \"verifications\";\n\n  public readonly requestVerificationCode = $action({\n    path: `${this.url}/:type`,\n    group: this.group,\n    method: \"POST\",\n    schema: {\n      params: t.object({\n        type: verificationTypeEnumSchema,\n      }),\n      body: t.object({\n        target: t.text(),\n      }),\n      response: requestVerificationCodeResponseSchema,\n    },\n    handler: async ({ body, params }) => {\n      return await this.verificationService.createVerification({\n        type: params.type,\n        target: body.target,\n      });\n    },\n  });\n\n  public readonly validateVerificationCode = $action({\n    path: `${this.url}/:type/validate`,\n    group: this.group,\n    method: \"POST\",\n    schema: {\n      params: t.object({\n        type: verificationTypeEnumSchema,\n      }),\n      body: t.object({\n        target: t.text(),\n        token: t.text({\n          description:\n            \"The verification token (6-digit code for phone, UUID for email).\",\n        }),\n      }),\n      response: validateVerificationCodeResponseSchema,\n    },\n    handler: async ({ body, params }) => {\n      return this.verificationService.verifyCode(\n        {\n          type: params.type,\n          target: body.target,\n        },\n        body.token,\n      );\n    },\n  });\n}\n","import { $inject } from \"alepha\";\nimport { DateTimeProvider } from \"alepha/datetime\";\nimport { $repository } from \"alepha/orm\";\nimport { $scheduler } from \"alepha/scheduler\";\nimport { verifications } from \"../entities/verifications.ts\";\nimport { VerificationParameters } from \"../parameters/VerificationParameters.ts\";\n\nexport class VerificationJobs {\n  protected readonly verificationRepository = $repository(verifications);\n  protected readonly verificationParameters = $inject(VerificationParameters);\n  protected readonly dateTimeProvider = $inject(DateTimeProvider);\n\n  public readonly cleanExpired = $scheduler({\n    name: \"api:verifications:cleanExpired\",\n    cron: \"0 * * * *\", // Hourly at minute 0\n    description: \"Clean expired verifications\",\n    handler: async () => {\n      const purgeDays = this.verificationParameters.get(\"purgeDays\");\n      if (purgeDays <= 0) {\n        return; // Auto deletion is disabled\n      }\n\n      const dayMs = 24 * 60 * 60 * 1000;\n      const purgeThreshold =\n        this.dateTimeProvider.nowMillis() - purgeDays * dayMs;\n\n      await this.verificationRepository.deleteMany({\n        createdAt: {\n          lt: this.dateTimeProvider.of(purgeThreshold).toISOString(),\n        },\n      });\n    },\n  });\n}\n","import { $module } from \"alepha\";\nimport { VerificationController } from \"./controllers/VerificationController.ts\";\nimport { VerificationJobs } from \"./jobs/VerificationJobs.ts\";\nimport { VerificationParameters } from \"./parameters/VerificationParameters.ts\";\nimport { VerificationService } from \"./services/VerificationService.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport * from \"./controllers/VerificationController.ts\";\nexport * from \"./entities/verifications.ts\";\nexport * from \"./jobs/VerificationJobs.ts\";\nexport * from \"./parameters/VerificationParameters.ts\";\nexport * from \"./schemas/requestVerificationCodeResponseSchema.ts\";\nexport * from \"./schemas/validateVerificationCodeResponseSchema.ts\";\nexport * from \"./schemas/verificationTypeEnumSchema.ts\";\nexport * from \"./services/VerificationService.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Email and phone verification workflows.\n *\n * **Features:**\n * - Verification token generation\n * - Verification code sending\n * - Verification completion tracking\n * - Resend functionality\n *\n * @module alepha.api.verifications\n */\nexport const AlephaApiVerification = $module({\n  name: \"alepha.api.verifications\",\n  services: [\n    VerificationController,\n    VerificationJobs,\n    VerificationService,\n    VerificationParameters,\n  ],\n});\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/api/verifications/schemas/requestVerificationCodeResponseSchema.ts","../../../src/api/verifications/schemas/validateVerificationCodeResponseSchema.ts","../../../src/api/verifications/schemas/verificationTypeEnumSchema.ts","../../../src/api/verifications/entities/verifications.ts","../../../src/api/verifications/schemas/verificationSettingsSchema.ts","../../../src/api/verifications/parameters/VerificationParameters.ts","../../../src/api/verifications/services/VerificationService.ts","../../../src/api/verifications/controllers/VerificationController.ts","../../../src/api/verifications/jobs/VerificationJobs.ts","../../../src/api/verifications/index.ts"],"sourcesContent":["import type { Static } from \"alepha\";\nimport { t } from \"alepha\";\n\nexport const requestVerificationCodeResponseSchema = t.object({\n  token: t.string({\n    description:\n      \"The verification token (6-digit code for phone, UUID for email). The caller should send this to the user via their preferred notification method.\",\n  }),\n  codeExpiration: t.integer({\n    description: \"Time in seconds before your verification token expires.\",\n  }),\n  verificationCooldown: t.integer({\n    description:\n      \"Cooldown period in seconds before you can request another verification.\",\n  }),\n  maxVerificationAttempts: t.integer({\n    description:\n      \"Maximum number of verification attempts allowed before the token is locked.\",\n  }),\n});\n\nexport type RequestVerificationResponse = Static<\n  typeof requestVerificationCodeResponseSchema\n>;\n","import type { Static } from \"alepha\";\nimport { t } from \"alepha\";\n\nexport const validateVerificationCodeResponseSchema = t.object({\n  ok: t.boolean({\n    description: \"Indicates whether the verification was successful.\",\n  }),\n  alreadyVerified: t.optional(\n    t.boolean({\n      description: \"Indicates whether the target was already verified.\",\n    }),\n  ),\n});\n\nexport type ValidateVerificationCodeResponse = Static<\n  typeof validateVerificationCodeResponseSchema\n>;\n","import type { Static } from \"alepha\";\nimport { t } from \"alepha\";\n\nexport const verificationTypeEnumSchema = t.enum([\"code\", \"link\"]);\nexport type VerificationTypeEnum = Static<typeof verificationTypeEnumSchema>;\n","import type { Static } from \"alepha\";\nimport { t } from \"alepha\";\nimport { $entity, db } from \"alepha/orm\";\nimport { verificationTypeEnumSchema } from \"../schemas/verificationTypeEnumSchema.ts\";\n\nexport const verifications = $entity({\n  name: \"verification\",\n  schema: t.object({\n    id: db.primaryKey(t.bigint()),\n\n    createdAt: db.createdAt(),\n\n    updatedAt: db.updatedAt(),\n\n    version: db.version(),\n\n    type: verificationTypeEnumSchema,\n\n    target: t.text({\n      description: \"Can be a phone (E.164 format) or email address\",\n    }),\n\n    code: t.text({\n      description: \"Hashed verification token (n-digit code or UUID)\",\n    }),\n\n    verifiedAt: t.optional(\n      t.datetime({\n        description: \"When it was successfully verified\",\n      }),\n    ),\n\n    attempts: db.default(\n      t.integer({\n        description: \"Number of failed attempts (to prevent brute-force)\",\n      }),\n      0,\n    ),\n  }),\n  indexes: [\n    \"createdAt\",\n    {\n      columns: [\"target\", \"code\"],\n    },\n  ],\n});\n\nexport const verificationEntitySchema = verifications.schema;\nexport const verificationEntityInsertSchema = verifications.insertSchema;\nexport type VerificationEntity = Static<typeof verifications.schema>;\n","import type { Static } from \"alepha\";\nimport { t } from \"alepha\";\n\nexport const verificationSettingsSchema = t.object({\n  code: t.object(\n    {\n      maxAttempts: t.integer({\n        description:\n          \"Maximum number of attempts before locking the verification.\",\n        minimum: 1,\n        maximum: 10,\n      }),\n      codeLength: t.integer({\n        description: \"Length of the verification code.\",\n        minimum: 4,\n        maximum: 12,\n      }),\n      codeExpiration: t.integer({\n        description: \"Time in seconds before the verification code expires.\",\n        minimum: 60, // 1 minute\n        maximum: 3600, // 1 hour\n      }),\n      verificationCooldown: t.integer({\n        description: \"Cooldown period in seconds after a request verification.\",\n        minimum: 0,\n        maximum: 3600, // 1 hour\n      }),\n      limitPerDay: t.integer({\n        description:\n          \"Maximum number of verification requests per day for one entry.\",\n        minimum: 1,\n        maximum: 100,\n      }),\n    },\n    {\n      description: \"Settings specific to code verifications.\",\n    },\n  ),\n  link: t.object(\n    {\n      maxAttempts: t.integer({\n        description:\n          \"Maximum number of attempts before locking the verification.\",\n        minimum: 1,\n        maximum: 10,\n      }),\n      codeExpiration: t.integer({\n        description: \"Time in seconds before the verification token expires.\",\n        minimum: 60, // 1 minute\n        maximum: 7200, // 2 hours\n      }),\n      verificationCooldown: t.integer({\n        description: \"Cooldown period in seconds after a request verification.\",\n        minimum: 0,\n        maximum: 3600, // 1 hour\n      }),\n      limitPerDay: t.integer({\n        description:\n          \"Maximum number of verification requests per day for one entry.\",\n        minimum: 1,\n        maximum: 100,\n      }),\n    },\n    {\n      description: \"Settings specific to link verifications.\",\n    },\n  ),\n  purgeDays: t.integer({\n    description:\n      \"Number of days after which expired verifications are automatically deleted. Set to 0 to disable auto-deletion.\",\n    minimum: 0,\n    maximum: 365,\n  }),\n});\n\nexport type VerificationSettings = Static<typeof verificationSettingsSchema>;\n","import { $atom, $state, type Static } from \"alepha\";\nimport {\n  type VerificationSettings,\n  verificationSettingsSchema,\n} from \"../schemas/verificationSettingsSchema.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Verification settings configuration atom\n */\nexport const verificationOptions = $atom({\n  name: \"alepha.api.verifications.options\",\n  schema: verificationSettingsSchema,\n  default: {\n    code: {\n      maxAttempts: 5,\n      codeLength: 6,\n      codeExpiration: 300, // 5 minutes\n      verificationCooldown: 90,\n      limitPerDay: 10,\n    },\n    link: {\n      maxAttempts: 3, // Lower since UUIDs are harder to guess\n      codeExpiration: 1800, // 30 minutes\n      verificationCooldown: 90,\n      limitPerDay: 10,\n    },\n    purgeDays: 1,\n  },\n});\n\nexport type VerificationOptions = Static<typeof verificationOptions.schema>;\n\ndeclare module \"alepha\" {\n  interface State {\n    [verificationOptions.key]: VerificationOptions;\n  }\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport class VerificationParameters {\n  protected readonly options = $state(verificationOptions);\n\n  public get<K extends keyof VerificationSettings>(\n    key: K,\n  ): VerificationSettings[K] {\n    return this.options[key];\n  }\n}\n","import { createHash, randomInt, randomUUID } from \"node:crypto\";\nimport { $inject } from \"alepha\";\nimport { DateTimeProvider } from \"alepha/datetime\";\nimport { $logger } from \"alepha/logger\";\nimport { $repository } from \"alepha/orm\";\nimport { BadRequestError, NotFoundError } from \"alepha/server\";\nimport {\n  type VerificationEntity,\n  verifications,\n} from \"../entities/verifications.ts\";\nimport { VerificationParameters } from \"../parameters/VerificationParameters.ts\";\nimport type { RequestVerificationResponse } from \"../schemas/requestVerificationCodeResponseSchema.ts\";\nimport type { ValidateVerificationCodeResponse } from \"../schemas/validateVerificationCodeResponseSchema.ts\";\nimport type { VerificationTypeEnum } from \"../schemas/verificationTypeEnumSchema.ts\";\n\nexport class VerificationService {\n  protected readonly log = $logger();\n  protected readonly dateTimeProvider = $inject(DateTimeProvider);\n  protected readonly verificationParameters = $inject(VerificationParameters);\n  protected readonly verificationRepository = $repository(verifications);\n\n  public async findByEntry(\n    entry: VerificationEntry,\n  ): Promise<VerificationEntity> {\n    this.log.trace(\"Finding verification by entry\", {\n      type: entry.type,\n      target: entry.target,\n    });\n\n    const results = await this.verificationRepository.findMany({\n      limit: 1, // only need the most recent entry\n      orderBy: {\n        column: \"createdAt\",\n        direction: \"desc\",\n      },\n      where: {\n        type: { eq: entry.type },\n        target: { eq: entry.target },\n      },\n    });\n\n    if (results.length === 0) {\n      this.log.debug(\"Verification entry not found\", {\n        type: entry.type,\n        target: entry.target,\n      });\n      throw new NotFoundError(\"Verification entry not found\");\n    }\n\n    this.log.debug(\"Verification entry found\", {\n      id: results[0].id,\n      type: entry.type,\n      target: entry.target,\n    });\n\n    return results[0];\n  }\n\n  public findRecentsByEntry(entry: VerificationEntry) {\n    this.log.trace(\"Finding recent verifications by entry\", {\n      type: entry.type,\n      target: entry.target,\n    });\n\n    return this.verificationRepository.findMany({\n      orderBy: {\n        column: \"createdAt\",\n        direction: \"desc\",\n      },\n      where: {\n        type: { eq: entry.type },\n        target: { eq: entry.target },\n        createdAt: {\n          gte: this.dateTimeProvider.now().startOf(\"day\").toISOString(),\n        },\n      },\n    });\n  }\n\n  /**\n   * Creates a verification entry and returns the token.\n   * The caller is responsible for sending notifications with the token.\n   * This allows for context-specific notifications (e.g., password reset vs email verification).\n   */\n  public async createVerification(\n    entry: VerificationEntry,\n  ): Promise<RequestVerificationResponse> {\n    this.log.trace(\"Creating verification\", {\n      type: entry.type,\n      target: entry.target,\n    });\n\n    const settings = this.verificationParameters.get(entry.type);\n\n    const recents = await this.findRecentsByEntry(entry);\n    if (recents.length >= settings.limitPerDay) {\n      this.log.warn(\"Daily verification limit reached\", {\n        type: entry.type,\n        target: entry.target,\n        limit: settings.limitPerDay,\n        count: recents.length,\n      });\n      throw new BadRequestError(\n        `Maximum number of verification requests per day reached (${settings.limitPerDay})`,\n      );\n    }\n\n    const existingVerification = recents[0];\n    if (existingVerification) {\n      const nowSec = this.dateTimeProvider.now().unix();\n      const createdAtSec = this.dateTimeProvider\n        .of(existingVerification.createdAt)\n        .unix();\n\n      const diffSec = nowSec - createdAtSec;\n      if (diffSec < settings.verificationCooldown) {\n        const remainingCooldown = Math.floor(\n          settings.verificationCooldown - diffSec,\n        );\n        this.log.debug(\"Verification on cooldown\", {\n          type: entry.type,\n          target: entry.target,\n          remainingSeconds: remainingCooldown,\n        });\n        throw new BadRequestError(\n          `Verification is on cooldown for ${remainingCooldown} seconds`,\n        );\n      }\n    }\n\n    const token = this.generateToken(entry.type);\n\n    const verification = await this.verificationRepository.create({\n      type: entry.type,\n      target: entry.target,\n      code: this.hashCode(token),\n      createdAt: this.dateTimeProvider.nowISOString(),\n    });\n\n    this.log.info(\"Verification created\", {\n      id: verification.id,\n      type: entry.type,\n      target: entry.target,\n      expiresInSeconds: settings.codeExpiration,\n    });\n\n    return {\n      token,\n      codeExpiration: settings.codeExpiration,\n      verificationCooldown: settings.verificationCooldown,\n      maxVerificationAttempts: settings.maxAttempts,\n    };\n  }\n\n  public async verifyCode(\n    entry: VerificationEntry,\n    code: string,\n  ): Promise<ValidateVerificationCodeResponse> {\n    this.log.trace(\"Verifying code\", {\n      type: entry.type,\n      target: entry.target,\n    });\n\n    const settings = this.verificationParameters.get(entry.type);\n\n    const verification = await this.findByEntry(entry);\n    if (verification.verifiedAt) {\n      this.log.debug(\"Verification already verified\", {\n        id: verification.id,\n        type: entry.type,\n        target: entry.target,\n        verifiedAt: verification.verifiedAt,\n      });\n      return { ok: true, alreadyVerified: true };\n    }\n\n    // DO NOT DELETE THE VERIFICATION WHEN IT IS REJECTED,\n    // or we won't be able to cooldown the verification\n\n    const now = this.dateTimeProvider.now();\n    const expirationDate = this.dateTimeProvider\n      .of(verification.createdAt)\n      .add(settings.codeExpiration, \"seconds\");\n\n    if (now > expirationDate) {\n      this.log.warn(\"Verification code expired\", {\n        id: verification.id,\n        type: entry.type,\n        target: entry.target,\n        createdAt: verification.createdAt,\n        expiredAt: expirationDate.toISOString(),\n      });\n      throw new BadRequestError(\"Verification code has expired\");\n    }\n\n    if (verification.attempts >= settings.maxAttempts) {\n      this.log.warn(\"Verification locked due to max attempts\", {\n        id: verification.id,\n        type: entry.type,\n        target: entry.target,\n        attempts: verification.attempts,\n        maxAttempts: settings.maxAttempts,\n      });\n      throw new BadRequestError(\n        \"Maximum number of attempts reached - verification is locked\",\n      );\n    }\n\n    if (verification.code !== this.hashCode(code)) {\n      const newAttempts = verification.attempts + 1;\n      this.log.warn(\"Invalid verification code\", {\n        id: verification.id,\n        type: entry.type,\n        target: entry.target,\n        attempts: newAttempts,\n        maxAttempts: settings.maxAttempts,\n      });\n      await this.verificationRepository.updateById(verification.id, {\n        attempts: newAttempts,\n      });\n      throw new BadRequestError(\"Invalid verification code\");\n    }\n\n    await this.verificationRepository.updateById(verification.id, {\n      verifiedAt: this.dateTimeProvider.nowISOString(),\n    });\n\n    this.log.info(\"Verification code verified\", {\n      id: verification.id,\n      type: entry.type,\n      target: entry.target,\n    });\n\n    return { ok: true };\n  }\n\n  public hashCode(code: string): string {\n    return createHash(\"sha256\").update(code).digest(\"hex\");\n  }\n\n  public generateToken(type: VerificationTypeEnum): string {\n    if (type === \"code\") {\n      const settings = this.verificationParameters.get(\"code\");\n      return randomInt(0, 1_000_000)\n        .toString()\n        .padStart(settings.codeLength, \"0\");\n    } else if (type === \"link\") {\n      return randomUUID();\n    }\n\n    throw new BadRequestError(`Invalid verification type: ${type}`);\n  }\n}\n\nexport interface VerificationEntry {\n  type: VerificationTypeEnum;\n  target: string;\n}\n","import { $inject, t } from \"alepha\";\nimport { $action } from \"alepha/server\";\nimport { requestVerificationCodeResponseSchema } from \"../schemas/requestVerificationCodeResponseSchema.ts\";\nimport { validateVerificationCodeResponseSchema } from \"../schemas/validateVerificationCodeResponseSchema.ts\";\nimport { verificationTypeEnumSchema } from \"../schemas/verificationTypeEnumSchema.ts\";\nimport { VerificationService } from \"../services/VerificationService.ts\";\n\nexport class VerificationController {\n  protected readonly verificationService = $inject(VerificationService);\n\n  public readonly url = \"/verifications\";\n  public readonly group = \"verifications\";\n\n  public readonly requestVerificationCode = $action({\n    path: `${this.url}/:type`,\n    group: this.group,\n    method: \"POST\",\n    schema: {\n      params: t.object({\n        type: verificationTypeEnumSchema,\n      }),\n      body: t.object({\n        target: t.text(),\n      }),\n      response: requestVerificationCodeResponseSchema,\n    },\n    handler: async ({ body, params }) => {\n      return await this.verificationService.createVerification({\n        type: params.type,\n        target: body.target,\n      });\n    },\n  });\n\n  public readonly validateVerificationCode = $action({\n    path: `${this.url}/:type/validate`,\n    group: this.group,\n    method: \"POST\",\n    schema: {\n      params: t.object({\n        type: verificationTypeEnumSchema,\n      }),\n      body: t.object({\n        target: t.text(),\n        token: t.text({\n          description:\n            \"The verification token (6-digit code for phone, UUID for email).\",\n        }),\n      }),\n      response: validateVerificationCodeResponseSchema,\n    },\n    handler: async ({ body, params }) => {\n      return this.verificationService.verifyCode(\n        {\n          type: params.type,\n          target: body.target,\n        },\n        body.token,\n      );\n    },\n  });\n}\n","import { $inject } from \"alepha\";\nimport { DateTimeProvider } from \"alepha/datetime\";\nimport { $repository } from \"alepha/orm\";\nimport { $scheduler } from \"alepha/scheduler\";\nimport { verifications } from \"../entities/verifications.ts\";\nimport { VerificationParameters } from \"../parameters/VerificationParameters.ts\";\n\nexport class VerificationJobs {\n  protected readonly verificationRepository = $repository(verifications);\n  protected readonly verificationParameters = $inject(VerificationParameters);\n  protected readonly dateTimeProvider = $inject(DateTimeProvider);\n\n  public readonly cleanExpired = $scheduler({\n    name: \"api:verifications:cleanExpired\",\n    cron: \"0 * * * *\", // Hourly at minute 0\n    description: \"Clean expired verifications\",\n    handler: async () => {\n      const purgeDays = this.verificationParameters.get(\"purgeDays\");\n      if (purgeDays <= 0) {\n        return; // Auto deletion is disabled\n      }\n\n      const dayMs = 24 * 60 * 60 * 1000;\n      const purgeThreshold =\n        this.dateTimeProvider.nowMillis() - purgeDays * dayMs;\n\n      await this.verificationRepository.deleteMany({\n        createdAt: {\n          lt: this.dateTimeProvider.of(purgeThreshold).toISOString(),\n        },\n      });\n    },\n  });\n}\n","import { $module } from \"alepha\";\nimport { VerificationController } from \"./controllers/VerificationController.ts\";\nimport { VerificationJobs } from \"./jobs/VerificationJobs.ts\";\nimport { VerificationParameters } from \"./parameters/VerificationParameters.ts\";\nimport { VerificationService } from \"./services/VerificationService.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport * from \"./controllers/VerificationController.ts\";\nexport * from \"./entities/verifications.ts\";\nexport * from \"./jobs/VerificationJobs.ts\";\nexport * from \"./parameters/VerificationParameters.ts\";\nexport * from \"./schemas/requestVerificationCodeResponseSchema.ts\";\nexport * from \"./schemas/validateVerificationCodeResponseSchema.ts\";\nexport * from \"./schemas/verificationTypeEnumSchema.ts\";\nexport * from \"./services/VerificationService.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Email and phone verification workflows.\n *\n * **Features:**\n * - Verification token generation\n * - Verification code sending\n * - Verification completion tracking\n * - Resend functionality\n *\n * @module alepha.api.verifications\n */\nexport const AlephaApiVerification = $module({\n  name: \"alepha.api.verifications\",\n  services: [\n    VerificationController,\n    VerificationJobs,\n    VerificationService,\n    VerificationParameters,\n  ],\n});\n"],"mappings":"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"}

package/dist/batch/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../src/batch/providers/BatchProvider.ts","../../src/batch/primitives/$batch.ts","../../src/batch/index.ts"],"sourcesContent":["import { $hook, $inject, type Alepha, AlephaError } from \"alepha\";\nimport { DateTimeProvider, type DurationLike } from \"alepha/datetime\";\nimport { $logger } from \"alepha/logger\";\nimport { type RetryBackoffOptions, RetryProvider } from \"alepha/retry\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport interface BatchOptions<TItem, TResponse = any> {\n  /**\n   * The batch processing handler function that processes arrays of validated items.\n   */\n  handler: (items: TItem[]) => TResponse;\n\n  /**\n   * Maximum number of items to collect before automatically flushing the batch.\n   *\n   * @default 10\n   */\n  maxSize?: number;\n\n  /**\n   * Maximum number of items that can be queued in a single partition.\n   * If exceeded, push() will throw an error.\n   */\n  maxQueueSize?: number;\n\n  /**\n   * Maximum time to wait before flushing a batch, even if it hasn't reached maxSize.\n   *\n   * @default [1, \"second\"]\n   */\n  maxDuration?: DurationLike;\n\n  /**\n   * Function to determine partition keys for grouping items into separate batches.\n   */\n  partitionBy?: (item: TItem) => string;\n\n  /**\n   * Maximum number of batch handlers that can execute simultaneously.\n   *\n   * @default 1\n   */\n  concurrency?: number;\n\n  /**\n   * Retry configuration for failed batch processing operations.\n   */\n  retry?: {\n    /**\n     * The maximum number of attempts.\n     *\n     * @default 3\n     */\n    max?: number;\n\n    /**\n     * The backoff strategy for delays between retries.\n     * Can be a fixed number (in ms) or a configuration object for exponential backoff.\n     *\n     * @default { initial: 200, factor: 2, jitter: true }\n     */\n    backoff?: number | RetryBackoffOptions;\n\n    /**\n     * An overall time limit for all retry attempts combined.\n     *\n     * e.g., `[5, 'seconds']`\n     */\n    maxDuration?: DurationLike;\n\n    /**\n     * A function that determines if a retry should be attempted based on the error.\n     *\n     * @default (error) => true (retries on any error)\n     */\n    when?: (error: Error) => boolean;\n\n    /**\n     * A custom callback for when a retry attempt fails.\n     * This is called before the delay.\n     */\n    onError?: (error: Error, attempt: number) => void;\n  };\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport type BatchItemStatus = \"pending\" | \"processing\" | \"completed\" | \"failed\";\n\nexport interface BatchItemState<TItem, TResponse> {\n  id: string;\n  item: TItem;\n  partitionKey: string;\n  status: BatchItemStatus;\n  result?: TResponse;\n  error?: Error;\n  promise?: Promise<TResponse>;\n  resolve?: (value: TResponse) => void;\n  reject?: (error: Error) => void;\n}\n\nexport interface PartitionState {\n  itemIds: string[];\n  timeout?: { clear: () => void };\n  flushing: boolean;\n}\n\n/**\n * Context object that holds all state for a batch processor instance.\n */\nexport interface BatchContext<TItem, TResponse> {\n  options: BatchOptions<TItem, TResponse>;\n  itemStates: Map<string, BatchItemState<TItem, TResponse>>;\n  partitions: Map<string, PartitionState>;\n  activeHandlers: PromiseWithResolvers<void>[];\n  isShuttingDown: boolean;\n  isReady: boolean;\n  alepha: Alepha;\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Service for batch processing operations.\n * Provides methods to manage batches of items with automatic flushing based on size or time.\n */\nexport class BatchProvider {\n  protected readonly log = $logger();\n  protected readonly dateTime = $inject(DateTimeProvider);\n  protected readonly retryProvider = $inject(RetryProvider);\n\n  /**\n   * All active batch contexts managed by this provider.\n   */\n  protected readonly contexts = new Set<BatchContext<any, any>>();\n\n  /**\n   * Creates a new batch context with the given options.\n   */\n  createContext<TItem, TResponse>(\n    alepha: Alepha,\n    options: BatchOptions<TItem, TResponse>,\n  ): BatchContext<TItem, TResponse> {\n    const context: BatchContext<TItem, TResponse> = {\n      options,\n      itemStates: new Map(),\n      partitions: new Map(),\n      activeHandlers: [],\n      isShuttingDown: false,\n      isReady: false,\n      alepha,\n    };\n    this.contexts.add(context);\n    return context;\n  }\n\n  /**\n   * Shutdown hook - flushes all batch contexts on application stop.\n   */\n  protected readonly onStop = $hook({\n    on: \"stop\",\n    priority: \"first\",\n    handler: async () => {\n      if (this.contexts.size === 0) {\n        return;\n      }\n      this.log.debug(`Shutting down ${this.contexts.size} batch context(s)...`);\n      const promises: Promise<void>[] = [];\n      for (const context of this.contexts) {\n        promises.push(this.shutdown(context));\n      }\n      await Promise.all(promises);\n      this.log.debug(\"All batch contexts shut down\");\n    },\n  });\n\n  /**\n   * Get the effective maxSize for a context.\n   */\n  protected getMaxSize<TItem, TResponse>(\n    context: BatchContext<TItem, TResponse>,\n  ): number {\n    return context.options.maxSize ?? 10;\n  }\n\n  /**\n   * Get the effective concurrency for a context.\n   */\n  protected getConcurrency<TItem, TResponse>(\n    context: BatchContext<TItem, TResponse>,\n  ): number {\n    return context.options.concurrency ?? 1;\n  }\n\n  /**\n   * Get the effective maxDuration for a context.\n   */\n  protected getMaxDuration<TItem, TResponse>(\n    context: BatchContext<TItem, TResponse>,\n  ): DurationLike {\n    return context.options.maxDuration ?? [1, \"second\"];\n  }\n\n  /**\n   * Pushes an item into the batch and returns immediately with a unique ID.\n   * The item will be processed asynchronously with other items when the batch is flushed.\n   * Use wait(id) to get the processing result.\n   *\n   * @throws Error if maxQueueSize is exceeded\n   */\n  push<TItem, TResponse>(\n    context: BatchContext<TItem, TResponse>,\n    item: TItem,\n  ): string {\n    // 1. Generate unique ID\n    const id = crypto.randomUUID();\n\n    // 2. Determine the partition key (with error handling)\n    let partitionKey: string;\n    try {\n      partitionKey = context.options.partitionBy\n        ? context.options.partitionBy(item)\n        : \"default\";\n    } catch (error) {\n      this.log.warn(\n        \"partitionBy function threw an error, using 'default' partition\",\n        { error },\n      );\n      partitionKey = \"default\";\n    }\n\n    // 3. Create item state\n    const itemState: BatchItemState<TItem, TResponse> = {\n      id,\n      item,\n      partitionKey,\n      status: \"pending\",\n    };\n\n    // CAUTION: Do not log.debug/info here as it may cause infinite loops if logging is batched\n\n    context.itemStates.set(id, itemState);\n\n    // 4. Get or create the partition state\n    if (!context.partitions.has(partitionKey)) {\n      context.partitions.set(partitionKey, {\n        itemIds: [],\n        flushing: false,\n      });\n    }\n    const partition = context.partitions.get(partitionKey)!;\n\n    // 5. Check maxQueueSize before adding\n    if (\n      context.options.maxQueueSize !== undefined &&\n      partition.itemIds.length >= context.options.maxQueueSize\n    ) {\n      throw new AlephaError(\n        `Batch queue size exceeded for partition '${partitionKey}' (max: ${context.options.maxQueueSize})`,\n      );\n    }\n\n    // 6. Add item ID to partition\n    partition.itemIds.push(id);\n\n    const maxSize = this.getMaxSize(context);\n    const maxDuration = this.getMaxDuration(context);\n\n    // 7. Only start processing if the app is ready (after \"ready\" hook)\n    // During startup, items are just buffered in memory\n    if (context.isReady) {\n      // Check if the batch is full\n      if (partition.itemIds.length >= maxSize) {\n        this.log.trace(\n          `Batch partition '${partitionKey}' is full, flushing...`,\n        );\n        this.flushPartition(context, partitionKey).catch((error) =>\n          this.log.error(\n            `Failed to flush batch partition '${partitionKey}' on max size`,\n            error,\n          ),\n        );\n      } else if (!partition.timeout && !partition.flushing) {\n        // 8. Start the timeout if it's not already running for this partition and not currently flushing\n        partition.timeout = this.dateTime.createTimeout(() => {\n          this.log.trace(\n            `Batch partition '${partitionKey}' timed out, flushing...`,\n          );\n          this.flushPartition(context, partitionKey).catch((error) =>\n            this.log.error(\n              `Failed to flush batch partition '${partitionKey}' on timeout`,\n              error,\n            ),\n          );\n        }, maxDuration);\n      }\n    } else {\n      // Not ready yet - just buffer items, no size checks or timeouts\n      this.log.trace(\n        `Buffering item in partition '${partitionKey}' (app not ready yet, ${partition.itemIds.length} items buffered)`,\n      );\n    }\n\n    // 9. Return ID immediately\n    return id;\n  }\n\n  /**\n   * Wait for a specific item to be processed and get its result.\n   * @param id The item ID returned from push()\n   * @returns The processing result\n   * @throws If the item doesn't exist or processing failed\n   */\n  async wait<TItem, TResponse>(\n    context: BatchContext<TItem, TResponse>,\n    id: string,\n  ): Promise<TResponse> {\n    const itemState = context.itemStates.get(id);\n    if (!itemState) {\n      throw new AlephaError(`Item with id '${id}' not found`);\n    }\n\n    // If already completed or failed, return immediately\n    if (itemState.status === \"completed\") {\n      return itemState.result!;\n    }\n    if (itemState.status === \"failed\") {\n      throw itemState.error!;\n    }\n\n    // Create promise on-demand if not already created\n    if (!itemState.promise) {\n      itemState.promise = new Promise<TResponse>((resolve, reject) => {\n        itemState.resolve = resolve;\n        itemState.reject = reject;\n      });\n    }\n\n    return itemState.promise;\n  }\n\n  /**\n   * Get the current status of an item.\n   * @param id The item ID returned from push()\n   * @returns Status information or undefined if item doesn't exist\n   */\n  status<TItem, TResponse>(\n    context: BatchContext<TItem, TResponse>,\n    id: string,\n  ):\n    | { status: \"pending\" | \"processing\" }\n    | { status: \"completed\"; result: TResponse }\n    | { status: \"failed\"; error: Error }\n    | undefined {\n    const itemState = context.itemStates.get(id);\n    if (!itemState) {\n      return undefined;\n    }\n\n    if (itemState.status === \"completed\") {\n      return { status: \"completed\", result: itemState.result! };\n    }\n    if (itemState.status === \"failed\") {\n      return { status: \"failed\", error: itemState.error! };\n    }\n    return { status: itemState.status };\n  }\n\n  /**\n   * Clears completed and failed items from the context to free memory.\n   * Returns the number of items cleared.\n   *\n   * @param context The batch context\n   * @param status Optional: only clear items with this specific status ('completed' or 'failed')\n   * @returns The number of items cleared\n   */\n  clearCompleted<TItem, TResponse>(\n    context: BatchContext<TItem, TResponse>,\n    status?: \"completed\" | \"failed\",\n  ): number {\n    let count = 0;\n    for (const [id, state] of context.itemStates) {\n      if (status) {\n        if (state.status === status) {\n          context.itemStates.delete(id);\n          count++;\n        }\n      } else if (state.status === \"completed\" || state.status === \"failed\") {\n        context.itemStates.delete(id);\n        count++;\n      }\n    }\n    return count;\n  }\n\n  /**\n   * Flush all partitions or a specific partition.\n   */\n  async flush<TItem, TResponse>(\n    context: BatchContext<TItem, TResponse>,\n    partitionKey?: string,\n  ): Promise<void> {\n    const promises: Promise<void>[] = [];\n    if (partitionKey) {\n      if (context.partitions.has(partitionKey)) {\n        promises.push(this.flushPartition(context, partitionKey));\n      }\n    } else {\n      for (const key of context.partitions.keys()) {\n        promises.push(this.flushPartition(context, key));\n      }\n    }\n    await Promise.all(promises);\n  }\n\n  /**\n   * Flush a specific partition.\n   */\n  protected async flushPartition<TItem, TResponse>(\n    context: BatchContext<TItem, TResponse>,\n    partitionKey: string,\n    limit?: number,\n  ): Promise<void> {\n    const partition = context.partitions.get(partitionKey);\n    if (!partition || partition.itemIds.length === 0) {\n      context.partitions.delete(partitionKey);\n      return;\n    }\n\n    // Clear the timeout and grab the item IDs (up to limit if specified)\n    partition.timeout?.clear();\n    partition.timeout = undefined;\n    const itemsToTake =\n      limit !== undefined\n        ? Math.min(limit, partition.itemIds.length)\n        : partition.itemIds.length;\n    const itemIdsToProcess = partition.itemIds.splice(0, itemsToTake);\n\n    // Mark partition as flushing to prevent race conditions\n    partition.flushing = true;\n\n    // Get the items and mark them as processing\n    const itemsToProcess: TItem[] = [];\n    for (const id of itemIdsToProcess) {\n      const itemState = context.itemStates.get(id);\n      if (itemState) {\n        itemState.status = \"processing\";\n        itemsToProcess.push(itemState.item);\n      }\n    }\n\n    const concurrency = this.getConcurrency(context);\n    const maxDuration = this.getMaxDuration(context);\n\n    // Wait until there's a free slot (if at concurrency limit)\n    while (context.activeHandlers.length >= concurrency) {\n      this.log.trace(\n        `Batch handler is at concurrency limit, waiting for a slot...`,\n      );\n      // Wait for any single handler to complete, not all of them\n      await Promise.race(context.activeHandlers.map((it) => it.promise));\n    }\n\n    const promise = Promise.withResolvers<void>();\n    context.activeHandlers.push(promise);\n    let result: any;\n    try {\n      result = await context.alepha.context.run(() =>\n        // during shutdown, call handler directly to avoid retry cancellation\n        context.isShuttingDown\n          ? context.options.handler(itemsToProcess)\n          : this.retryProvider.retry(\n              {\n                ...context.options.retry,\n                handler: context.options.handler,\n              },\n              itemsToProcess,\n            ),\n      );\n\n      // Mark all items as completed and resolve their promises\n      for (const id of itemIdsToProcess) {\n        const itemState = context.itemStates.get(id);\n        if (itemState) {\n          itemState.status = \"completed\";\n          itemState.result = result;\n          // Only resolve if someone is waiting\n          itemState.resolve?.(result);\n        }\n      }\n    } catch (error) {\n      this.log.error(`Batch handler failed`, error);\n\n      // Mark all items as failed and reject their promises\n      for (const id of itemIdsToProcess) {\n        const itemState = context.itemStates.get(id);\n        if (itemState) {\n          itemState.status = \"failed\";\n          itemState.error = error as Error;\n          // Only reject if someone is waiting (promise was created)\n          itemState.reject?.(error as Error);\n        }\n      }\n    } finally {\n      promise.resolve();\n      context.activeHandlers = context.activeHandlers.filter(\n        (it) => it !== promise,\n      );\n\n      // Only delete partition if no new items arrived during processing\n      const currentPartition = context.partitions.get(partitionKey);\n      if (currentPartition?.flushing && currentPartition.itemIds.length === 0) {\n        context.partitions.delete(partitionKey);\n      } else if (currentPartition) {\n        // Reset flushing flag if partition still exists with items\n        currentPartition.flushing = false;\n\n        // Restart timeout for items that arrived during flush\n        if (currentPartition.itemIds.length > 0 && !currentPartition.timeout) {\n          currentPartition.timeout = this.dateTime.createTimeout(() => {\n            this.log.trace(\n              `Batch partition '${partitionKey}' timed out, flushing...`,\n            );\n            this.flushPartition(context, partitionKey).catch((error) =>\n              this.log.error(\n                `Failed to flush batch partition '${partitionKey}' on timeout`,\n                error,\n              ),\n            );\n          }, maxDuration);\n        }\n      }\n    }\n  }\n\n  /**\n   * Mark the context as ready and start processing buffered items.\n   * Called after the \"ready\" hook.\n   */\n  async markReady<TItem, TResponse>(\n    context: BatchContext<TItem, TResponse>,\n  ): Promise<void> {\n    this.log.debug(\n      \"Batch processor is now ready, starting to process buffered items...\",\n    );\n    context.isReady = true;\n    await this.startProcessing(context);\n  }\n\n  /**\n   * Mark the context as shutting down and flush all remaining items.\n   */\n  async shutdown<TItem, TResponse>(\n    context: BatchContext<TItem, TResponse>,\n  ): Promise<void> {\n    this.log.debug(\"Flushing all remaining batch partitions on shutdown...\");\n    context.isShuttingDown = true;\n    await this.flush(context);\n    this.log.debug(\"All batch partitions flushed\");\n  }\n\n  /**\n   * Called after the \"ready\" hook to start processing buffered items that were\n   * pushed during startup. This checks all partitions and starts timeouts/flushes\n   * for items that were accumulated before the app was ready.\n   */\n  protected async startProcessing<TItem, TResponse>(\n    context: BatchContext<TItem, TResponse>,\n  ): Promise<void> {\n    const maxSize = this.getMaxSize(context);\n    const maxDuration = this.getMaxDuration(context);\n\n    for (const [partitionKey, partition] of context.partitions.entries()) {\n      if (partition.itemIds.length === 0) {\n        continue;\n      }\n\n      this.log.trace(\n        `Starting processing for partition '${partitionKey}' with ${partition.itemIds.length} buffered items`,\n      );\n\n      // Flush batches of maxSize while we have items >= maxSize\n      while (partition.itemIds.length >= maxSize) {\n        this.log.trace(\n          `Partition '${partitionKey}' has ${partition.itemIds.length} items, flushing batch of ${maxSize}...`,\n        );\n        await this.flushPartition(context, partitionKey, maxSize);\n      }\n\n      // After flushing full batches, start timeout for any remaining items\n      if (\n        partition.itemIds.length > 0 &&\n        !partition.timeout &&\n        !partition.flushing\n      ) {\n        this.log.trace(\n          `Starting timeout for partition '${partitionKey}' with ${partition.itemIds.length} remaining items`,\n        );\n        partition.timeout = this.dateTime.createTimeout(() => {\n          this.log.trace(\n            `Batch partition '${partitionKey}' timed out, flushing...`,\n          );\n          this.flushPartition(context, partitionKey).catch((error) =>\n            this.log.error(\n              `Failed to flush partition '${partitionKey}' on timeout after startup`,\n              error,\n            ),\n          );\n        }, maxDuration);\n      }\n    }\n  }\n}\n","import {\n  $hook,\n  $inject,\n  createPrimitive,\n  KIND,\n  Primitive,\n  type Static,\n  type TSchema,\n} from \"alepha\";\nimport type { DurationLike } from \"alepha/datetime\";\nimport type { RetryPrimitiveOptions } from \"alepha/retry\";\nimport {\n  type BatchContext,\n  type BatchItemState,\n  type BatchItemStatus,\n  BatchProvider,\n} from \"../providers/BatchProvider.ts\";\n\n/**\n * Creates a batch processing primitive for efficient grouping and processing of multiple operations.\n */\nexport const $batch = <TItem extends TSchema, TResponse>(\n  options: BatchPrimitiveOptions<TItem, TResponse>,\n): BatchPrimitive<TItem, TResponse> =>\n  createPrimitive(BatchPrimitive<TItem, TResponse>, options);\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport interface BatchPrimitiveOptions<TItem extends TSchema, TResponse = any> {\n  /**\n   * TypeBox schema for validating each item added to the batch.\n   */\n  schema: TItem;\n\n  /**\n   * The batch processing handler function that processes arrays of validated items.\n   */\n  handler: (items: Static<TItem>[]) => TResponse;\n\n  /**\n   * Maximum number of items to collect before automatically flushing the batch.\n   */\n  maxSize?: number;\n\n  /**\n   * Maximum number of items that can be queued in a single partition.\n   * If exceeded, push() will throw an error.\n   */\n  maxQueueSize?: number;\n\n  /**\n   * Maximum time to wait before flushing a batch, even if it hasn't reached maxSize.\n   */\n  maxDuration?: DurationLike;\n\n  /**\n   * Function to determine partition keys for grouping items into separate batches.\n   */\n  partitionBy?: (item: Static<TItem>) => string;\n\n  /**\n   * Maximum number of batch handlers that can execute simultaneously.\n   */\n  concurrency?: number;\n\n  /**\n   * Retry configuration for failed batch processing operations.\n   */\n  retry?: Omit<RetryPrimitiveOptions<() => Array<Static<TItem>>>, \"handler\">;\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport type { BatchItemState, BatchItemStatus };\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport class BatchPrimitive<\n  TItem extends TSchema,\n  TResponse = any,\n> extends Primitive<BatchPrimitiveOptions<TItem, TResponse>> {\n  protected readonly batchProvider = $inject(BatchProvider);\n  protected readonly context: BatchContext<Static<TItem>, TResponse>;\n\n  constructor(\n    ...args: ConstructorParameters<\n      typeof Primitive<BatchPrimitiveOptions<TItem, TResponse>>\n    >\n  ) {\n    super(...args);\n    this.context = this.batchProvider.createContext(this.alepha, {\n      handler: this.options.handler,\n      maxSize: this.options.maxSize,\n      maxQueueSize: this.options.maxQueueSize,\n      maxDuration: this.options.maxDuration,\n      partitionBy: this.options.partitionBy,\n      concurrency: this.options.concurrency,\n      retry: this.options.retry,\n    });\n  }\n\n  /**\n   * Pushes an item into the batch and returns immediately with a unique ID.\n   * The item will be processed asynchronously with other items when the batch is flushed.\n   * Use wait(id) to get the processing result.\n   */\n  public async push(item: Static<TItem>): Promise<string> {\n    // Validate the item against the schema\n    const validatedItem = this.alepha.codec.validate(this.options.schema, item);\n    return this.batchProvider.push(this.context, validatedItem);\n  }\n\n  /**\n   * Wait for a specific item to be processed and get its result.\n   * @param id The item ID returned from push()\n   * @returns The processing result\n   * @throws If the item doesn't exist or processing failed\n   */\n  public async wait(id: string): Promise<TResponse> {\n    return this.batchProvider.wait(this.context, id);\n  }\n\n  /**\n   * Get the current status of an item.\n   * @param id The item ID returned from push()\n   * @returns Status information or undefined if item doesn't exist\n   */\n  public status(\n    id: string,\n  ):\n    | { status: \"pending\" | \"processing\" }\n    | { status: \"completed\"; result: TResponse }\n    | { status: \"failed\"; error: Error }\n    | undefined {\n    return this.batchProvider.status(this.context, id);\n  }\n\n  /**\n   * Flush all partitions or a specific partition.\n   */\n  public async flush(partitionKey?: string): Promise<void> {\n    return this.batchProvider.flush(this.context, partitionKey);\n  }\n\n  /**\n   * Clears completed and failed items from memory.\n   * Call this periodically in long-running applications to prevent memory leaks.\n   *\n   * @param status Optional: only clear items with this specific status ('completed' or 'failed')\n   * @returns The number of items cleared\n   */\n  public clearCompleted(status?: \"completed\" | \"failed\"): number {\n    return this.batchProvider.clearCompleted(this.context, status);\n  }\n\n  protected readonly onReady = $hook({\n    on: \"ready\",\n    handler: async () => {\n      await this.batchProvider.markReady(this.context);\n    },\n  });\n}\n\n$batch[KIND] = BatchPrimitive;\n","import { $module } from \"alepha\";\nimport { $batch } from \"./primitives/$batch.ts\";\nimport { BatchProvider } from \"./providers/BatchProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport * from \"./primitives/$batch.ts\";\nexport * from \"./providers/BatchProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Batch accumulation and processing.\n *\n * **Features:**\n * - Batch accumulator with handler\n * - Configurable batch size\n * - Time-based triggers\n * - Status tracking\n *\n * @module alepha.batch\n */\nexport const AlephaBatch = $module({\n  name: \"alepha.batch\",\n  primitives: [$batch],\n  services: [BatchProvider],\n});\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"sources":["../../src/batch/providers/BatchProvider.ts","../../src/batch/primitives/$batch.ts","../../src/batch/index.ts"],"sourcesContent":["import { $hook, $inject, type Alepha, AlephaError } from \"alepha\";\nimport { DateTimeProvider, type DurationLike } from \"alepha/datetime\";\nimport { $logger } from \"alepha/logger\";\nimport { type RetryBackoffOptions, RetryProvider } from \"alepha/retry\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport interface BatchOptions<TItem, TResponse = any> {\n  /**\n   * The batch processing handler function that processes arrays of validated items.\n   */\n  handler: (items: TItem[]) => TResponse;\n\n  /**\n   * Maximum number of items to collect before automatically flushing the batch.\n   *\n   * @default 10\n   */\n  maxSize?: number;\n\n  /**\n   * Maximum number of items that can be queued in a single partition.\n   * If exceeded, push() will throw an error.\n   */\n  maxQueueSize?: number;\n\n  /**\n   * Maximum time to wait before flushing a batch, even if it hasn't reached maxSize.\n   *\n   * @default [1, \"second\"]\n   */\n  maxDuration?: DurationLike;\n\n  /**\n   * Function to determine partition keys for grouping items into separate batches.\n   */\n  partitionBy?: (item: TItem) => string;\n\n  /**\n   * Maximum number of batch handlers that can execute simultaneously.\n   *\n   * @default 1\n   */\n  concurrency?: number;\n\n  /**\n   * Retry configuration for failed batch processing operations.\n   */\n  retry?: {\n    /**\n     * The maximum number of attempts.\n     *\n     * @default 3\n     */\n    max?: number;\n\n    /**\n     * The backoff strategy for delays between retries.\n     * Can be a fixed number (in ms) or a configuration object for exponential backoff.\n     *\n     * @default { initial: 200, factor: 2, jitter: true }\n     */\n    backoff?: number | RetryBackoffOptions;\n\n    /**\n     * An overall time limit for all retry attempts combined.\n     *\n     * e.g., `[5, 'seconds']`\n     */\n    maxDuration?: DurationLike;\n\n    /**\n     * A function that determines if a retry should be attempted based on the error.\n     *\n     * @default (error) => true (retries on any error)\n     */\n    when?: (error: Error) => boolean;\n\n    /**\n     * A custom callback for when a retry attempt fails.\n     * This is called before the delay.\n     */\n    onError?: (error: Error, attempt: number) => void;\n  };\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport type BatchItemStatus = \"pending\" | \"processing\" | \"completed\" | \"failed\";\n\nexport interface BatchItemState<TItem, TResponse> {\n  id: string;\n  item: TItem;\n  partitionKey: string;\n  status: BatchItemStatus;\n  result?: TResponse;\n  error?: Error;\n  promise?: Promise<TResponse>;\n  resolve?: (value: TResponse) => void;\n  reject?: (error: Error) => void;\n}\n\nexport interface PartitionState {\n  itemIds: string[];\n  timeout?: { clear: () => void };\n  flushing: boolean;\n}\n\n/**\n * Context object that holds all state for a batch processor instance.\n */\nexport interface BatchContext<TItem, TResponse> {\n  options: BatchOptions<TItem, TResponse>;\n  itemStates: Map<string, BatchItemState<TItem, TResponse>>;\n  partitions: Map<string, PartitionState>;\n  activeHandlers: PromiseWithResolvers<void>[];\n  isShuttingDown: boolean;\n  isReady: boolean;\n  alepha: Alepha;\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Service for batch processing operations.\n * Provides methods to manage batches of items with automatic flushing based on size or time.\n */\nexport class BatchProvider {\n  protected readonly log = $logger();\n  protected readonly dateTime = $inject(DateTimeProvider);\n  protected readonly retryProvider = $inject(RetryProvider);\n\n  /**\n   * All active batch contexts managed by this provider.\n   */\n  protected readonly contexts = new Set<BatchContext<any, any>>();\n\n  /**\n   * Creates a new batch context with the given options.\n   */\n  createContext<TItem, TResponse>(\n    alepha: Alepha,\n    options: BatchOptions<TItem, TResponse>,\n  ): BatchContext<TItem, TResponse> {\n    const context: BatchContext<TItem, TResponse> = {\n      options,\n      itemStates: new Map(),\n      partitions: new Map(),\n      activeHandlers: [],\n      isShuttingDown: false,\n      isReady: false,\n      alepha,\n    };\n    this.contexts.add(context);\n    return context;\n  }\n\n  /**\n   * Shutdown hook - flushes all batch contexts on application stop.\n   */\n  protected readonly onStop = $hook({\n    on: \"stop\",\n    priority: \"first\",\n    handler: async () => {\n      if (this.contexts.size === 0) {\n        return;\n      }\n      this.log.debug(`Shutting down ${this.contexts.size} batch context(s)...`);\n      const promises: Promise<void>[] = [];\n      for (const context of this.contexts) {\n        promises.push(this.shutdown(context));\n      }\n      await Promise.all(promises);\n      this.log.debug(\"All batch contexts shut down\");\n    },\n  });\n\n  /**\n   * Get the effective maxSize for a context.\n   */\n  protected getMaxSize<TItem, TResponse>(\n    context: BatchContext<TItem, TResponse>,\n  ): number {\n    return context.options.maxSize ?? 10;\n  }\n\n  /**\n   * Get the effective concurrency for a context.\n   */\n  protected getConcurrency<TItem, TResponse>(\n    context: BatchContext<TItem, TResponse>,\n  ): number {\n    return context.options.concurrency ?? 1;\n  }\n\n  /**\n   * Get the effective maxDuration for a context.\n   */\n  protected getMaxDuration<TItem, TResponse>(\n    context: BatchContext<TItem, TResponse>,\n  ): DurationLike {\n    return context.options.maxDuration ?? [1, \"second\"];\n  }\n\n  /**\n   * Pushes an item into the batch and returns immediately with a unique ID.\n   * The item will be processed asynchronously with other items when the batch is flushed.\n   * Use wait(id) to get the processing result.\n   *\n   * @throws Error if maxQueueSize is exceeded\n   */\n  push<TItem, TResponse>(\n    context: BatchContext<TItem, TResponse>,\n    item: TItem,\n  ): string {\n    // 1. Generate unique ID\n    const id = crypto.randomUUID();\n\n    // 2. Determine the partition key (with error handling)\n    let partitionKey: string;\n    try {\n      partitionKey = context.options.partitionBy\n        ? context.options.partitionBy(item)\n        : \"default\";\n    } catch (error) {\n      this.log.warn(\n        \"partitionBy function threw an error, using 'default' partition\",\n        { error },\n      );\n      partitionKey = \"default\";\n    }\n\n    // 3. Create item state\n    const itemState: BatchItemState<TItem, TResponse> = {\n      id,\n      item,\n      partitionKey,\n      status: \"pending\",\n    };\n\n    // CAUTION: Do not log.debug/info here as it may cause infinite loops if logging is batched\n\n    context.itemStates.set(id, itemState);\n\n    // 4. Get or create the partition state\n    if (!context.partitions.has(partitionKey)) {\n      context.partitions.set(partitionKey, {\n        itemIds: [],\n        flushing: false,\n      });\n    }\n    const partition = context.partitions.get(partitionKey)!;\n\n    // 5. Check maxQueueSize before adding\n    if (\n      context.options.maxQueueSize !== undefined &&\n      partition.itemIds.length >= context.options.maxQueueSize\n    ) {\n      throw new AlephaError(\n        `Batch queue size exceeded for partition '${partitionKey}' (max: ${context.options.maxQueueSize})`,\n      );\n    }\n\n    // 6. Add item ID to partition\n    partition.itemIds.push(id);\n\n    const maxSize = this.getMaxSize(context);\n    const maxDuration = this.getMaxDuration(context);\n\n    // 7. Only start processing if the app is ready (after \"ready\" hook)\n    // During startup, items are just buffered in memory\n    if (context.isReady) {\n      // Check if the batch is full\n      if (partition.itemIds.length >= maxSize) {\n        this.log.trace(\n          `Batch partition '${partitionKey}' is full, flushing...`,\n        );\n        this.flushPartition(context, partitionKey).catch((error) =>\n          this.log.error(\n            `Failed to flush batch partition '${partitionKey}' on max size`,\n            error,\n          ),\n        );\n      } else if (!partition.timeout && !partition.flushing) {\n        // 8. Start the timeout if it's not already running for this partition and not currently flushing\n        partition.timeout = this.dateTime.createTimeout(() => {\n          this.log.trace(\n            `Batch partition '${partitionKey}' timed out, flushing...`,\n          );\n          this.flushPartition(context, partitionKey).catch((error) =>\n            this.log.error(\n              `Failed to flush batch partition '${partitionKey}' on timeout`,\n              error,\n            ),\n          );\n        }, maxDuration);\n      }\n    } else {\n      // Not ready yet - just buffer items, no size checks or timeouts\n      this.log.trace(\n        `Buffering item in partition '${partitionKey}' (app not ready yet, ${partition.itemIds.length} items buffered)`,\n      );\n    }\n\n    // 9. Return ID immediately\n    return id;\n  }\n\n  /**\n   * Wait for a specific item to be processed and get its result.\n   * @param id The item ID returned from push()\n   * @returns The processing result\n   * @throws If the item doesn't exist or processing failed\n   */\n  async wait<TItem, TResponse>(\n    context: BatchContext<TItem, TResponse>,\n    id: string,\n  ): Promise<TResponse> {\n    const itemState = context.itemStates.get(id);\n    if (!itemState) {\n      throw new AlephaError(`Item with id '${id}' not found`);\n    }\n\n    // If already completed or failed, return immediately\n    if (itemState.status === \"completed\") {\n      return itemState.result!;\n    }\n    if (itemState.status === \"failed\") {\n      throw itemState.error!;\n    }\n\n    // Create promise on-demand if not already created\n    if (!itemState.promise) {\n      itemState.promise = new Promise<TResponse>((resolve, reject) => {\n        itemState.resolve = resolve;\n        itemState.reject = reject;\n      });\n    }\n\n    return itemState.promise;\n  }\n\n  /**\n   * Get the current status of an item.\n   * @param id The item ID returned from push()\n   * @returns Status information or undefined if item doesn't exist\n   */\n  status<TItem, TResponse>(\n    context: BatchContext<TItem, TResponse>,\n    id: string,\n  ):\n    | { status: \"pending\" | \"processing\" }\n    | { status: \"completed\"; result: TResponse }\n    | { status: \"failed\"; error: Error }\n    | undefined {\n    const itemState = context.itemStates.get(id);\n    if (!itemState) {\n      return undefined;\n    }\n\n    if (itemState.status === \"completed\") {\n      return { status: \"completed\", result: itemState.result! };\n    }\n    if (itemState.status === \"failed\") {\n      return { status: \"failed\", error: itemState.error! };\n    }\n    return { status: itemState.status };\n  }\n\n  /**\n   * Clears completed and failed items from the context to free memory.\n   * Returns the number of items cleared.\n   *\n   * @param context The batch context\n   * @param status Optional: only clear items with this specific status ('completed' or 'failed')\n   * @returns The number of items cleared\n   */\n  clearCompleted<TItem, TResponse>(\n    context: BatchContext<TItem, TResponse>,\n    status?: \"completed\" | \"failed\",\n  ): number {\n    let count = 0;\n    for (const [id, state] of context.itemStates) {\n      if (status) {\n        if (state.status === status) {\n          context.itemStates.delete(id);\n          count++;\n        }\n      } else if (state.status === \"completed\" || state.status === \"failed\") {\n        context.itemStates.delete(id);\n        count++;\n      }\n    }\n    return count;\n  }\n\n  /**\n   * Flush all partitions or a specific partition.\n   */\n  async flush<TItem, TResponse>(\n    context: BatchContext<TItem, TResponse>,\n    partitionKey?: string,\n  ): Promise<void> {\n    const promises: Promise<void>[] = [];\n    if (partitionKey) {\n      if (context.partitions.has(partitionKey)) {\n        promises.push(this.flushPartition(context, partitionKey));\n      }\n    } else {\n      for (const key of context.partitions.keys()) {\n        promises.push(this.flushPartition(context, key));\n      }\n    }\n    await Promise.all(promises);\n  }\n\n  /**\n   * Flush a specific partition.\n   */\n  protected async flushPartition<TItem, TResponse>(\n    context: BatchContext<TItem, TResponse>,\n    partitionKey: string,\n    limit?: number,\n  ): Promise<void> {\n    const partition = context.partitions.get(partitionKey);\n    if (!partition || partition.itemIds.length === 0) {\n      context.partitions.delete(partitionKey);\n      return;\n    }\n\n    // Clear the timeout and grab the item IDs (up to limit if specified)\n    partition.timeout?.clear();\n    partition.timeout = undefined;\n    const itemsToTake =\n      limit !== undefined\n        ? Math.min(limit, partition.itemIds.length)\n        : partition.itemIds.length;\n    const itemIdsToProcess = partition.itemIds.splice(0, itemsToTake);\n\n    // Mark partition as flushing to prevent race conditions\n    partition.flushing = true;\n\n    // Get the items and mark them as processing\n    const itemsToProcess: TItem[] = [];\n    for (const id of itemIdsToProcess) {\n      const itemState = context.itemStates.get(id);\n      if (itemState) {\n        itemState.status = \"processing\";\n        itemsToProcess.push(itemState.item);\n      }\n    }\n\n    const concurrency = this.getConcurrency(context);\n    const maxDuration = this.getMaxDuration(context);\n\n    // Wait until there's a free slot (if at concurrency limit)\n    while (context.activeHandlers.length >= concurrency) {\n      this.log.trace(\n        `Batch handler is at concurrency limit, waiting for a slot...`,\n      );\n      // Wait for any single handler to complete, not all of them\n      await Promise.race(context.activeHandlers.map((it) => it.promise));\n    }\n\n    const promise = Promise.withResolvers<void>();\n    context.activeHandlers.push(promise);\n    let result: any;\n    try {\n      result = await context.alepha.context.run(() =>\n        // during shutdown, call handler directly to avoid retry cancellation\n        context.isShuttingDown\n          ? context.options.handler(itemsToProcess)\n          : this.retryProvider.retry(\n              {\n                ...context.options.retry,\n                handler: context.options.handler,\n              },\n              itemsToProcess,\n            ),\n      );\n\n      // Mark all items as completed and resolve their promises\n      for (const id of itemIdsToProcess) {\n        const itemState = context.itemStates.get(id);\n        if (itemState) {\n          itemState.status = \"completed\";\n          itemState.result = result;\n          // Only resolve if someone is waiting\n          itemState.resolve?.(result);\n        }\n      }\n    } catch (error) {\n      this.log.error(`Batch handler failed`, error);\n\n      // Mark all items as failed and reject their promises\n      for (const id of itemIdsToProcess) {\n        const itemState = context.itemStates.get(id);\n        if (itemState) {\n          itemState.status = \"failed\";\n          itemState.error = error as Error;\n          // Only reject if someone is waiting (promise was created)\n          itemState.reject?.(error as Error);\n        }\n      }\n    } finally {\n      promise.resolve();\n      context.activeHandlers = context.activeHandlers.filter(\n        (it) => it !== promise,\n      );\n\n      // Only delete partition if no new items arrived during processing\n      const currentPartition = context.partitions.get(partitionKey);\n      if (currentPartition?.flushing && currentPartition.itemIds.length === 0) {\n        context.partitions.delete(partitionKey);\n      } else if (currentPartition) {\n        // Reset flushing flag if partition still exists with items\n        currentPartition.flushing = false;\n\n        // Restart timeout for items that arrived during flush\n        if (currentPartition.itemIds.length > 0 && !currentPartition.timeout) {\n          currentPartition.timeout = this.dateTime.createTimeout(() => {\n            this.log.trace(\n              `Batch partition '${partitionKey}' timed out, flushing...`,\n            );\n            this.flushPartition(context, partitionKey).catch((error) =>\n              this.log.error(\n                `Failed to flush batch partition '${partitionKey}' on timeout`,\n                error,\n              ),\n            );\n          }, maxDuration);\n        }\n      }\n    }\n  }\n\n  /**\n   * Mark the context as ready and start processing buffered items.\n   * Called after the \"ready\" hook.\n   */\n  async markReady<TItem, TResponse>(\n    context: BatchContext<TItem, TResponse>,\n  ): Promise<void> {\n    this.log.debug(\n      \"Batch processor is now ready, starting to process buffered items...\",\n    );\n    context.isReady = true;\n    await this.startProcessing(context);\n  }\n\n  /**\n   * Mark the context as shutting down and flush all remaining items.\n   */\n  async shutdown<TItem, TResponse>(\n    context: BatchContext<TItem, TResponse>,\n  ): Promise<void> {\n    this.log.debug(\"Flushing all remaining batch partitions on shutdown...\");\n    context.isShuttingDown = true;\n    await this.flush(context);\n    this.log.debug(\"All batch partitions flushed\");\n  }\n\n  /**\n   * Called after the \"ready\" hook to start processing buffered items that were\n   * pushed during startup. This checks all partitions and starts timeouts/flushes\n   * for items that were accumulated before the app was ready.\n   */\n  protected async startProcessing<TItem, TResponse>(\n    context: BatchContext<TItem, TResponse>,\n  ): Promise<void> {\n    const maxSize = this.getMaxSize(context);\n    const maxDuration = this.getMaxDuration(context);\n\n    for (const [partitionKey, partition] of context.partitions.entries()) {\n      if (partition.itemIds.length === 0) {\n        continue;\n      }\n\n      this.log.trace(\n        `Starting processing for partition '${partitionKey}' with ${partition.itemIds.length} buffered items`,\n      );\n\n      // Flush batches of maxSize while we have items >= maxSize\n      while (partition.itemIds.length >= maxSize) {\n        this.log.trace(\n          `Partition '${partitionKey}' has ${partition.itemIds.length} items, flushing batch of ${maxSize}...`,\n        );\n        await this.flushPartition(context, partitionKey, maxSize);\n      }\n\n      // After flushing full batches, start timeout for any remaining items\n      if (\n        partition.itemIds.length > 0 &&\n        !partition.timeout &&\n        !partition.flushing\n      ) {\n        this.log.trace(\n          `Starting timeout for partition '${partitionKey}' with ${partition.itemIds.length} remaining items`,\n        );\n        partition.timeout = this.dateTime.createTimeout(() => {\n          this.log.trace(\n            `Batch partition '${partitionKey}' timed out, flushing...`,\n          );\n          this.flushPartition(context, partitionKey).catch((error) =>\n            this.log.error(\n              `Failed to flush partition '${partitionKey}' on timeout after startup`,\n              error,\n            ),\n          );\n        }, maxDuration);\n      }\n    }\n  }\n}\n","import {\n  $hook,\n  $inject,\n  createPrimitive,\n  KIND,\n  Primitive,\n  type Static,\n  type TSchema,\n} from \"alepha\";\nimport type { DurationLike } from \"alepha/datetime\";\nimport type { RetryPrimitiveOptions } from \"alepha/retry\";\nimport {\n  type BatchContext,\n  type BatchItemState,\n  type BatchItemStatus,\n  BatchProvider,\n} from \"../providers/BatchProvider.ts\";\n\n/**\n * Creates a batch processing primitive for efficient grouping and processing of multiple operations.\n */\nexport const $batch = <TItem extends TSchema, TResponse>(\n  options: BatchPrimitiveOptions<TItem, TResponse>,\n): BatchPrimitive<TItem, TResponse> =>\n  createPrimitive(BatchPrimitive<TItem, TResponse>, options);\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport interface BatchPrimitiveOptions<TItem extends TSchema, TResponse = any> {\n  /**\n   * TypeBox schema for validating each item added to the batch.\n   */\n  schema: TItem;\n\n  /**\n   * The batch processing handler function that processes arrays of validated items.\n   */\n  handler: (items: Static<TItem>[]) => TResponse;\n\n  /**\n   * Maximum number of items to collect before automatically flushing the batch.\n   */\n  maxSize?: number;\n\n  /**\n   * Maximum number of items that can be queued in a single partition.\n   * If exceeded, push() will throw an error.\n   */\n  maxQueueSize?: number;\n\n  /**\n   * Maximum time to wait before flushing a batch, even if it hasn't reached maxSize.\n   */\n  maxDuration?: DurationLike;\n\n  /**\n   * Function to determine partition keys for grouping items into separate batches.\n   */\n  partitionBy?: (item: Static<TItem>) => string;\n\n  /**\n   * Maximum number of batch handlers that can execute simultaneously.\n   */\n  concurrency?: number;\n\n  /**\n   * Retry configuration for failed batch processing operations.\n   */\n  retry?: Omit<RetryPrimitiveOptions<() => Array<Static<TItem>>>, \"handler\">;\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport type { BatchItemState, BatchItemStatus };\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport class BatchPrimitive<\n  TItem extends TSchema,\n  TResponse = any,\n> extends Primitive<BatchPrimitiveOptions<TItem, TResponse>> {\n  protected readonly batchProvider = $inject(BatchProvider);\n  protected readonly context: BatchContext<Static<TItem>, TResponse>;\n\n  constructor(\n    ...args: ConstructorParameters<\n      typeof Primitive<BatchPrimitiveOptions<TItem, TResponse>>\n    >\n  ) {\n    super(...args);\n    this.context = this.batchProvider.createContext(this.alepha, {\n      handler: this.options.handler,\n      maxSize: this.options.maxSize,\n      maxQueueSize: this.options.maxQueueSize,\n      maxDuration: this.options.maxDuration,\n      partitionBy: this.options.partitionBy,\n      concurrency: this.options.concurrency,\n      retry: this.options.retry,\n    });\n  }\n\n  /**\n   * Pushes an item into the batch and returns immediately with a unique ID.\n   * The item will be processed asynchronously with other items when the batch is flushed.\n   * Use wait(id) to get the processing result.\n   */\n  public async push(item: Static<TItem>): Promise<string> {\n    // Validate the item against the schema\n    const validatedItem = this.alepha.codec.validate(this.options.schema, item);\n    return this.batchProvider.push(this.context, validatedItem);\n  }\n\n  /**\n   * Wait for a specific item to be processed and get its result.\n   * @param id The item ID returned from push()\n   * @returns The processing result\n   * @throws If the item doesn't exist or processing failed\n   */\n  public async wait(id: string): Promise<TResponse> {\n    return this.batchProvider.wait(this.context, id);\n  }\n\n  /**\n   * Get the current status of an item.\n   * @param id The item ID returned from push()\n   * @returns Status information or undefined if item doesn't exist\n   */\n  public status(\n    id: string,\n  ):\n    | { status: \"pending\" | \"processing\" }\n    | { status: \"completed\"; result: TResponse }\n    | { status: \"failed\"; error: Error }\n    | undefined {\n    return this.batchProvider.status(this.context, id);\n  }\n\n  /**\n   * Flush all partitions or a specific partition.\n   */\n  public async flush(partitionKey?: string): Promise<void> {\n    return this.batchProvider.flush(this.context, partitionKey);\n  }\n\n  /**\n   * Clears completed and failed items from memory.\n   * Call this periodically in long-running applications to prevent memory leaks.\n   *\n   * @param status Optional: only clear items with this specific status ('completed' or 'failed')\n   * @returns The number of items cleared\n   */\n  public clearCompleted(status?: \"completed\" | \"failed\"): number {\n    return this.batchProvider.clearCompleted(this.context, status);\n  }\n\n  protected readonly onReady = $hook({\n    on: \"ready\",\n    handler: async () => {\n      await this.batchProvider.markReady(this.context);\n    },\n  });\n}\n\n$batch[KIND] = BatchPrimitive;\n","import { $module } from \"alepha\";\nimport { $batch } from \"./primitives/$batch.ts\";\nimport { BatchProvider } from \"./providers/BatchProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport * from \"./primitives/$batch.ts\";\nexport * from \"./providers/BatchProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Batch accumulation and processing.\n *\n * **Features:**\n * - Batch accumulator with handler\n * - Configurable batch size\n * - Time-based triggers\n * - Status tracking\n *\n * @module alepha.batch\n */\nexport const AlephaBatch = $module({\n  name: \"alepha.batch\",\n  primitives: [$batch],\n  services: [BatchProvider],\n});\n"],"mappings":"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"}

package/dist/bucket/index.d.ts

@@ -40,6 +40,14 @@ declare abstract class FileStorageProvider {
    * @param fileId - Identifier of the file to delete
    */
   abstract delete(bucketName: string, fileId: string): Promise<void>;
+  /**
+   * Delete multiple files in one round-trip where the provider supports
+   * batch (R2/S3, up to 1000 per call). Memory/Local fall back to a loop.
+   *
+   * @param bucketName - Container name
+   * @param fileIds - Identifiers of the files to delete
+   */
+  abstract deleteMany(bucketName: string, fileIds: string[]): Promise<void>;
 }
 //#endregion
 //#region ../../src/bucket/providers/MemoryFileStorageProvider.d.ts
@@ -57,6 +65,7 @@ declare class MemoryFileStorageProvider implements FileStorageProvider {
   download(bucketName: string, fileId: string): Promise<FileLike>;
   exists(bucketName: string, fileId: string): Promise<boolean>;
   delete(bucketName: string, fileId: string): Promise<void>;
+  deleteMany(bucketName: string, fileIds: string[]): Promise<void>;
   protected createId(): string;
 }
 //#endregion
@@ -258,6 +267,12 @@ declare class BucketPrimitive extends Primitive<BucketPrimitiveOptions> {
    * Delete permanently a file from the bucket.
    */
   delete(fileId: string, skipHook?: boolean): Promise<void>;
+  /**
+   * Delete many files in one round-trip when the underlying provider supports
+   * batch (R2/S3 up to 1000 keys per call). Emits one `bucket:file:deleted`
+   * event per id unless `skipHook` is set.
+   */
+  deleteMany(fileIds: string[], skipHook?: boolean): Promise<void>;
   /**
    * Checks if a file exists in the bucket.
    */
@@ -357,6 +372,7 @@ declare class CloudflareR2Provider implements FileStorageProvider {
   download(bucketName: string, fileId: string): Promise<FileLike>;
   exists(bucketName: string, fileId: string): Promise<boolean>;
   delete(bucketName: string, fileId: string): Promise<void>;
+  deleteMany(bucketName: string, fileIds: string[]): Promise<void>;
   /**
    * Build the full R2 key: {prefix}/{bucketName}/{fileId}
    */
@@ -393,6 +409,7 @@ declare class LocalFileStorageProvider implements FileStorageProvider {
   download(bucketName: string, fileId: string): Promise<FileLike>;
   exists(bucketName: string, fileId: string): Promise<boolean>;
   delete(bucketName: string, fileId: string): Promise<void>;
+  deleteMany(bucketName: string, fileIds: string[]): Promise<void>;
   protected stat(bucket: string, fileId: string): Promise<fs.Stats>;
   protected createId(mimeType: string): string;
   protected path(bucket: string, fileId?: string): string;
@@ -461,6 +478,7 @@ declare class NodeS3BucketProvider implements FileStorageProvider {
   download(bucketName: string, fileId: string): Promise<FileLike>;
   exists(bucketName: string, fileId: string): Promise<boolean>;
   delete(bucketName: string, fileId: string): Promise<void>;
+  deleteMany(bucketName: string, fileIds: string[]): Promise<void>;
 }
 //#endregion
 //#region ../../src/bucket/index.d.ts

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/bucket/providers/FileStorageProvider.ts","../../src/bucket/providers/MemoryFileStorageProvider.ts","../../src/bucket/primitives/$bucket.ts","../../src/bucket/errors/FileNotFoundError.ts","../../src/bucket/providers/CloudflareR2Provider.ts","../../src/bucket/providers/LocalFileStorageProvider.ts","../../src/bucket/providers/NodeS3BucketProvider.ts","../../src/bucket/index.ts"],"mappings":"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"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/bucket/providers/FileStorageProvider.ts","../../src/bucket/providers/MemoryFileStorageProvider.ts","../../src/bucket/primitives/$bucket.ts","../../src/bucket/errors/FileNotFoundError.ts","../../src/bucket/providers/CloudflareR2Provider.ts","../../src/bucket/providers/LocalFileStorageProvider.ts","../../src/bucket/providers/NodeS3BucketProvider.ts","../../src/bucket/index.ts"],"mappings":"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"}

package/dist/bucket/index.js

@@ -58,6 +58,9 @@ var MemoryFileStorageProvider = class {
 		if (!(fileKey in this.files)) throw new FileNotFoundError(`File with ID ${fileId} not found.`);
 		delete this.files[fileKey];
 	}
+	async deleteMany(bucketName, fileIds) {
+		for (const id of fileIds) delete this.files[`${bucketName}/${id}`];
+	}
 	createId() {
 		return randomUUID();
 	}
@@ -157,6 +160,20 @@ var BucketPrimitive = class extends Primitive {
 		});
 	}
 	/**
+	* Delete many files in one round-trip when the underlying provider supports
+	* batch (R2/S3 up to 1000 keys per call). Emits one `bucket:file:deleted`
+	* event per id unless `skipHook` is set.
+	*/
+	async deleteMany(fileIds, skipHook = false) {
+		if (fileIds.length === 0) return;
+		await this.provider.deleteMany(this.name, fileIds);
+		if (skipHook) return;
+		for (const id of fileIds) await this.alepha.events.emit("bucket:file:deleted", {
+			id,
+			bucket: this
+		});
+	}
+	/**
 	* Checks if a file exists in the bucket.
 	*/
 	async exists(fileId) {
@@ -258,6 +275,12 @@ var LocalFileStorageProvider = class {
 			throw new AlephaError("Error deleting file", { cause: error });
 		}
 	}
+	async deleteMany(bucketName, fileIds) {
+		await Promise.all(fileIds.map((id) => unlink(this.path(bucketName, id)).catch((error) => {
+			if (this.isErrorNoEntry(error)) return;
+			throw new AlephaError("Error deleting file", { cause: error });
+		})));
+	}
 	stat(bucket, fileId) {
 		return stat(this.path(bucket, fileId));
 	}
@@ -402,6 +425,23 @@ var NodeS3BucketProvider = class {
 			throw error;
 		}
 	}
+	async deleteMany(bucketName, fileIds) {
+		if (fileIds.length === 0) return;
+		this.log.trace(`Deleting ${fileIds.length} files from bucket '${bucketName}'...`);
+		const client = this.getClient(bucketName);
+		for (let i = 0; i < fileIds.length; i += 1e3) {
+			const chunk = fileIds.slice(i, i + 1e3);
+			try {
+				const batch = client.deleteObjects;
+				if (typeof batch === "function") await batch.call(client, chunk);
+				else await Promise.all(chunk.map((id) => client.deleteObject(id)));
+			} catch (error) {
+				this.log.error(`Failed to delete files: ${error}`);
+				if (error instanceof Error) throw new FileNotFoundError("Error deleting files", { cause: error });
+				throw error;
+			}
+		}
+	}
 };
 //#endregion
 //#region ../../src/bucket/providers/CloudflareR2Provider.ts
@@ -532,6 +572,13 @@ R2_BUCKET_NAME: t.string({ description: "R2 bucket name in Cloudflare" }) }));
 		if (!await this.exists(bucketName, fileId)) throw new FileNotFoundError(`File '${fileId}' not found in bucket '${bucketName}'.`);
 		await r2.delete(key);
 	}
+	async deleteMany(bucketName, fileIds) {
+		if (fileIds.length === 0) return;
+		const r2 = this.getR2();
+		const keys = fileIds.map((id) => this.key(bucketName, id));
+		this.log.trace(`Deleting ${keys.length} keys from '${bucketName}'`);
+		for (let i = 0; i < keys.length; i += 1e3) await r2.delete(keys.slice(i, i + 1e3));
+	}
 	/**
 	* Build the full R2 key: {prefix}/{bucketName}/{fileId}
 	*/