alepha 0.14.0 → 0.14.2

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["registration: JobRegistration"],"sources":["../../../src/api/jobs/schemas/jobExecutionQuerySchema.ts","../../../src/api/jobs/entities/jobExecutions.ts","../../../src/api/jobs/schemas/jobExecutionResourceSchema.ts","../../../src/api/jobs/schemas/triggerJobSchema.ts","../../../src/api/jobs/providers/JobProvider.ts","../../../src/api/jobs/primitives/$job.ts","../../../src/api/jobs/services/JobService.ts","../../../src/api/jobs/controllers/JobController.ts","../../../src/api/jobs/index.ts"],"sourcesContent":["import type { Static } from \"alepha\";\nimport { t } from \"alepha\";\nimport { pageQuerySchema } from \"alepha/orm\";\n\nexport const jobExecutionQuerySchema = t.extend(pageQuerySchema, {\n  status: t.optional(t.enum([\"STARTED\", \"FAILED\", \"COMPLETED\"])),\n  job: t.optional(\n    t.text({\n      description: \"Filter by job name\",\n    }),\n  ),\n});\n\nexport type JobExecutionQuery = Static<typeof jobExecutionQuerySchema>;\n","import { type Static, t } from \"alepha\";\nimport { logEntrySchema } from \"alepha/logger\";\nimport { $entity, pg } from \"alepha/orm\";\n\nexport const jobExecutions = $entity({\n  name: \"job_executions\",\n  schema: t.object({\n    id: pg.primaryKey(t.uuid()),\n    version: pg.version(),\n    createdAt: pg.createdAt(),\n    updatedAt: pg.updatedAt(),\n    finishedAt: t.optional(t.datetime()),\n    job: t.string(),\n    status: t.enum([\"STARTED\", \"FAILED\", \"COMPLETED\"]),\n    error: t.optional(t.string()),\n    logs: t.optional(t.array(logEntrySchema)),\n  }),\n});\n\nexport type JobExecutionEntity = Static<typeof jobExecutions.schema>;\n","import { type Static, t } from \"alepha\";\nimport { jobExecutions } from \"../entities/jobExecutions.ts\";\n\nexport const jobExecutionResourceSchema = t.extend(\n  jobExecutions.schema,\n  {},\n  {\n    title: \"JobExecutionResource\",\n    description:\n      \"A job execution resource representing the execution details of a job.\",\n  },\n);\n\nexport type JobExecutionResource = Static<typeof jobExecutionResourceSchema>;\n","import type { Static } from \"alepha\";\nimport { t } from \"alepha\";\n\nexport const triggerJobSchema = t.object({\n  name: t.string(),\n});\n\nexport type TriggerJob = Static<typeof triggerJobSchema>;\n","import { $env, $inject, Alepha, type Async, type Static, t } from \"alepha\";\nimport { type DateTime, DateTimeProvider } from \"alepha/datetime\";\nimport { $lock, type LockPrimitive } from \"alepha/lock\";\nimport type { LogEntry } from \"alepha/logger\";\nimport { $repository } from \"alepha/orm\";\nimport { CronProvider } from \"alepha/scheduler\";\nimport { jobExecutions } from \"../entities/jobExecutions.ts\";\n\nconst envSchema = t.object({\n  JOB_PREFIX: t.optional(\n    t.text({\n      description: \"Prefix for job lock keys\",\n    }),\n  ),\n});\n\ndeclare module \"alepha\" {\n  interface Env extends Partial<Static<typeof envSchema>> {}\n}\n\n/**\n * Provider for job management and execution.\n * Handles job lifecycle, execution tracking, log capturing, and event emission.\n */\nexport class JobProvider {\n  protected readonly alepha = $inject(Alepha);\n  protected readonly dateTimeProvider = $inject(DateTimeProvider);\n  protected readonly cronProvider = $inject(CronProvider);\n  protected readonly executionRepository = $repository(jobExecutions);\n  protected readonly env = $env(envSchema);\n  protected readonly logs = new Map<string, LogEntry[]>();\n  protected readonly jobs = new Map<string, JobRegistration>();\n\n  /**\n   * Register and set up a job for execution (called during primitive initialization).\n   */\n  public registerJob(options: Job): JobRegistration {\n    const jobName = options.name;\n\n    // Set up log capturing for this job (only once)\n    if (this.jobs.size === 0) {\n      this.alepha.events.on(\"log\", ({ entry }) => {\n        const context = entry.context;\n        if (!context) {\n          return;\n        }\n\n        const entries = this.logs.get(context);\n        if (!entries) {\n          return;\n        }\n\n        entries.push(entry);\n        this.logs.set(context, entries);\n      });\n    }\n\n    // Create lock primitive if locking is enabled\n    const lockPrimitive =\n      options.lock !== false\n        ? $lock({\n            name: () => {\n              const prefix = this.env.JOB_PREFIX\n                ? `${this.env.JOB_PREFIX}:`\n                : \"\";\n              return `${prefix}job:${jobName}`;\n            },\n            handler: async () => {\n              await this.executeJob(jobName, options.handler);\n            },\n          })\n        : null;\n\n    const registration: JobRegistration = {\n      name: jobName,\n      options,\n      lockPrimitive,\n    };\n\n    this.jobs.set(jobName, registration);\n\n    // Set up cron scheduling if provided\n    if (options.cron) {\n      this.cronProvider.createCronJob(jobName, options.cron, () =>\n        this.triggerJob(jobName),\n      );\n    }\n\n    return registration;\n  }\n\n  /**\n   * Trigger a job by name.\n   */\n  public async triggerJob(jobName: string): Promise<void> {\n    const registration = this.jobs.get(jobName);\n    if (!registration) {\n      throw new Error(`Job not registered: ${jobName}`);\n    }\n\n    // Execute handler with or without lock\n    if (registration.options.lock !== false && registration.lockPrimitive) {\n      await registration.lockPrimitive.run();\n    } else {\n      await this.executeJob(jobName, registration.options.handler);\n    }\n  }\n\n  /**\n   * Execute a job handler (called by the job primitive).\n   */\n  public async executeJob(\n    jobName: string,\n    handler: (args: { now: DateTime }) => Async<void>,\n  ): Promise<void> {\n    if (!this.alepha.isStarted()) {\n      return;\n    }\n\n    const context = this.alepha.context.createContextId();\n\n    await this.alepha.context.run(\n      async () => {\n        try {\n          const now = this.dateTimeProvider.now();\n\n          // Initialize log collection for this context\n          this.logs.set(context, []);\n\n          // Create execution record\n          await this.executionRepository.create({\n            job: jobName,\n            status: \"STARTED\",\n          });\n\n          await this.alepha.events.emit(\"scheduler:begin\", {\n            name: jobName,\n            now,\n            context,\n          });\n\n          // Execute the handler\n          await handler({ now });\n\n          // Update execution as completed\n          const logs = this.logs.get(context) || [];\n          const exec = await this.executionRepository.findOne({\n            where: {\n              job: jobName,\n              status: \"STARTED\",\n            },\n          });\n\n          exec.status = \"COMPLETED\";\n          exec.logs = logs;\n          exec.finishedAt = this.dateTimeProvider.nowISOString();\n\n          await this.executionRepository.save(exec);\n\n          await this.alepha.events.emit(\n            \"scheduler:success\",\n            {\n              name: jobName,\n              context,\n            },\n            {\n              catch: true,\n            },\n          );\n        } catch (error) {\n          // Update execution as failed\n          const logs = this.logs.get(context) || [];\n          const exec = await this.executionRepository.findOne({\n            where: {\n              job: jobName,\n              status: \"STARTED\",\n            },\n          });\n\n          exec.status = \"FAILED\";\n          exec.error = (error as Error).message;\n          exec.logs = logs;\n          exec.finishedAt = this.dateTimeProvider.nowISOString();\n\n          await this.executionRepository.save(exec);\n\n          await this.alepha.events.emit(\n            \"scheduler:error\",\n            {\n              name: jobName,\n              error: error as Error,\n              context,\n            },\n            {\n              catch: true,\n            },\n          );\n\n          // Don't re-throw, jobs should handle errors gracefully\n        }\n\n        // Clean up logs\n        this.logs.delete(context);\n\n        await this.alepha.events.emit(\n          \"scheduler:end\",\n          {\n            name: jobName,\n            context,\n          },\n          {\n            catch: true,\n          },\n        );\n      },\n      {\n        context,\n      },\n    );\n  }\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport interface Job {\n  /**\n   * Name of the job.\n   */\n  name: string;\n\n  /**\n   * Optional description of the job.\n   */\n  description?: string;\n\n  /**\n   * Function to run on schedule.\n   */\n  handler: (args: { now: DateTime }) => Async<void>;\n\n  /**\n   * Cron expression to run the job.\n   */\n  cron?: string;\n\n  /**\n   * If true, the job will be locked and only one instance will run at a time.\n   * You probably need to import {@link AlephaLockRedis} for distributed locking.\n   *\n   * @default true\n   */\n  lock?: boolean;\n\n  /**\n   * Optional prefix for job lock keys.\n   */\n  lockPrefix?: string;\n}\n\nexport interface JobRegistration {\n  name: string;\n  options: Job;\n  lockPrimitive: LockPrimitive<() => Promise<void>> | null;\n}\n","import { $inject, createPrimitive, KIND, Primitive } from \"alepha\";\nimport type { DateTime } from \"alepha/datetime\";\nimport { type Job, JobProvider } from \"../providers/JobProvider.ts\";\n\n/**\n * Job primitive - a drop-in replacement for $scheduler with built-in execution tracking.\n */\nexport const $job = (options: JobPrimitiveOptions): JobPrimitive => {\n  return createPrimitive(JobPrimitive, options);\n};\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport type JobPrimitiveOptions = Omit<Job, \"name\"> & {\n  /**\n   * Name of the job. Defaults to the primitive property name.\n   */\n  name?: string;\n};\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport class JobPrimitive extends Primitive<JobPrimitiveOptions> {\n  protected readonly jobProvider = $inject(JobProvider);\n\n  public get name(): string {\n    return (\n      this.options.name ??\n      `${this.config.service.name}.${this.config.propertyKey}`\n    );\n  }\n\n  protected onInit() {\n    // Register job with JobProvider\n    this.jobProvider.registerJob({\n      ...this.options,\n      name: this.name,\n    });\n  }\n\n  public async trigger(): Promise<void> {\n    await this.jobProvider.triggerJob(this.name);\n  }\n}\n\n$job[KIND] = JobPrimitive;\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport interface JobHandlerArguments {\n  now: DateTime;\n}\n","import { $inject, Alepha } from \"alepha\";\nimport { $repository } from \"alepha/orm\";\nimport { jobExecutions } from \"../entities/jobExecutions.ts\";\nimport { $job } from \"../primitives/$job.ts\";\nimport type { JobExecutionQuery } from \"../schemas/jobExecutionQuerySchema.ts\";\n\nexport class JobService {\n  protected readonly alepha = $inject(Alepha);\n  protected readonly executionRepository = $repository(jobExecutions);\n\n  public async getJobs(): Promise<string[]> {\n    const jobPrimitives = this.alepha.primitives($job);\n    return jobPrimitives.map((job) => job.name);\n  }\n\n  public async getJobExecutions(query: JobExecutionQuery = {}) {\n    query.sort ??= \"-createdAt\";\n\n    const where = this.executionRepository.createQueryWhere();\n\n    if (query.job) {\n      where.job = { eq: query.job };\n    }\n\n    if (query.status) {\n      where.status = { eq: query.status };\n    }\n\n    return await this.executionRepository.paginate(\n      query,\n      { where },\n      { count: true },\n    );\n  }\n\n  public async triggerJob(name: string): Promise<{ ok: boolean }> {\n    const jobPrimitives = this.alepha.primitives($job);\n    const job = jobPrimitives.find((j) => j.name === name);\n\n    if (!job) {\n      throw new Error(`Job not found: ${name}`);\n    }\n\n    await job.trigger();\n    return { ok: true };\n  }\n}\n","import { $inject, t } from \"alepha\";\nimport { $action, okSchema } from \"alepha/server\";\nimport { jobExecutionQuerySchema } from \"../schemas/jobExecutionQuerySchema.ts\";\nimport { jobExecutionResourceSchema } from \"../schemas/jobExecutionResourceSchema.ts\";\nimport { triggerJobSchema } from \"../schemas/triggerJobSchema.ts\";\nimport { JobService } from \"../services/JobService.ts\";\n\nexport class JobController {\n  protected readonly url: string = \"/jobs\";\n  protected readonly group: string = \"jobs\";\n  protected readonly jobService = $inject(JobService);\n\n  public readonly getJobs = $action({\n    path: this.url,\n    group: this.group,\n    schema: {\n      response: t.array(t.string()),\n    },\n    handler: () => this.jobService.getJobs(),\n  });\n\n  public readonly getJobExecutions = $action({\n    path: `${this.url}/executions`,\n    group: this.group,\n    schema: {\n      query: jobExecutionQuerySchema,\n      response: t.page(jobExecutionResourceSchema),\n    },\n    handler: ({ query }) => this.jobService.getJobExecutions(query),\n  });\n\n  public readonly triggerJob = $action({\n    method: \"POST\",\n    path: `${this.url}/trigger`,\n    group: this.group,\n    schema: {\n      body: triggerJobSchema,\n      response: okSchema,\n    },\n    handler: ({ body }) => this.jobService.triggerJob(body.name),\n  });\n}\n","import { $module } from \"alepha\";\nimport { JobController } from \"./controllers/JobController.ts\";\nimport { JobProvider } from \"./providers/JobProvider.ts\";\nimport { JobService } from \"./services/JobService.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport * from \"./controllers/JobController.ts\";\nexport * from \"./entities/jobExecutions.ts\";\nexport * from \"./primitives/$job.ts\";\nexport * from \"./providers/JobProvider.ts\";\nexport * from \"./schemas/jobExecutionQuerySchema.ts\";\nexport * from \"./schemas/jobExecutionResourceSchema.ts\";\nexport * from \"./schemas/triggerJobSchema.ts\";\nexport * from \"./services/JobService.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Provides job management API endpoints for Alepha applications.\n *\n * This module includes job queue operations, job status monitoring,\n * and background task management capabilities.\n *\n * @module alepha.api.jobs\n */\nexport const AlephaApiJobs = $module({\n  name: \"alepha.api.jobs\",\n  services: [JobController, JobProvider, JobService],\n});\n"],"mappings":";;;;;;;;;AAIA,MAAa,0BAA0B,EAAE,OAAO,iBAAiB;CAC/D,QAAQ,EAAE,SAAS,EAAE,KAAK;EAAC;EAAW;EAAU;EAAY,CAAC,CAAC;CAC9D,KAAK,EAAE,SACL,EAAE,KAAK,EACL,aAAa,sBACd,CAAC,CACH;CACF,CAAC;;;;ACPF,MAAa,gBAAgB,QAAQ;CACnC,MAAM;CACN,QAAQ,EAAE,OAAO;EACf,IAAI,GAAG,WAAW,EAAE,MAAM,CAAC;EAC3B,SAAS,GAAG,SAAS;EACrB,WAAW,GAAG,WAAW;EACzB,WAAW,GAAG,WAAW;EACzB,YAAY,EAAE,SAAS,EAAE,UAAU,CAAC;EACpC,KAAK,EAAE,QAAQ;EACf,QAAQ,EAAE,KAAK;GAAC;GAAW;GAAU;GAAY,CAAC;EAClD,OAAO,EAAE,SAAS,EAAE,QAAQ,CAAC;EAC7B,MAAM,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;EAC1C,CAAC;CACH,CAAC;;;;ACdF,MAAa,6BAA6B,EAAE,OAC1C,cAAc,QACd,EAAE,EACF;CACE,OAAO;CACP,aACE;CACH,CACF;;;;ACRD,MAAa,mBAAmB,EAAE,OAAO,EACvC,MAAM,EAAE,QAAQ,EACjB,CAAC;;;;ACGF,MAAM,YAAY,EAAE,OAAO,EACzB,YAAY,EAAE,SACZ,EAAE,KAAK,EACL,aAAa,4BACd,CAAC,CACH,EACF,CAAC;;;;;AAUF,IAAa,cAAb,MAAyB;CACvB,AAAmB,SAAS,QAAQ,OAAO;CAC3C,AAAmB,mBAAmB,QAAQ,iBAAiB;CAC/D,AAAmB,eAAe,QAAQ,aAAa;CACvD,AAAmB,sBAAsB,YAAY,cAAc;CACnE,AAAmB,MAAM,KAAK,UAAU;CACxC,AAAmB,uBAAO,IAAI,KAAyB;CACvD,AAAmB,uBAAO,IAAI,KAA8B;;;;CAK5D,AAAO,YAAY,SAA+B;EAChD,MAAM,UAAU,QAAQ;AAGxB,MAAI,KAAK,KAAK,SAAS,EACrB,MAAK,OAAO,OAAO,GAAG,QAAQ,EAAE,YAAY;GAC1C,MAAM,UAAU,MAAM;AACtB,OAAI,CAAC,QACH;GAGF,MAAM,UAAU,KAAK,KAAK,IAAI,QAAQ;AACtC,OAAI,CAAC,QACH;AAGF,WAAQ,KAAK,MAAM;AACnB,QAAK,KAAK,IAAI,SAAS,QAAQ;IAC/B;EAmBJ,MAAMA,eAAgC;GACpC,MAAM;GACN;GACA,eAjBA,QAAQ,SAAS,QACb,MAAM;IACJ,YAAY;AAIV,YAAO,GAHQ,KAAK,IAAI,aACpB,GAAG,KAAK,IAAI,WAAW,KACvB,GACa,MAAM;;IAEzB,SAAS,YAAY;AACnB,WAAM,KAAK,WAAW,SAAS,QAAQ,QAAQ;;IAElD,CAAC,GACF;GAML;AAED,OAAK,KAAK,IAAI,SAAS,aAAa;AAGpC,MAAI,QAAQ,KACV,MAAK,aAAa,cAAc,SAAS,QAAQ,YAC/C,KAAK,WAAW,QAAQ,CACzB;AAGH,SAAO;;;;;CAMT,MAAa,WAAW,SAAgC;EACtD,MAAM,eAAe,KAAK,KAAK,IAAI,QAAQ;AAC3C,MAAI,CAAC,aACH,OAAM,IAAI,MAAM,uBAAuB,UAAU;AAInD,MAAI,aAAa,QAAQ,SAAS,SAAS,aAAa,cACtD,OAAM,aAAa,cAAc,KAAK;MAEtC,OAAM,KAAK,WAAW,SAAS,aAAa,QAAQ,QAAQ;;;;;CAOhE,MAAa,WACX,SACA,SACe;AACf,MAAI,CAAC,KAAK,OAAO,WAAW,CAC1B;EAGF,MAAM,UAAU,KAAK,OAAO,QAAQ,iBAAiB;AAErD,QAAM,KAAK,OAAO,QAAQ,IACxB,YAAY;AACV,OAAI;IACF,MAAM,MAAM,KAAK,iBAAiB,KAAK;AAGvC,SAAK,KAAK,IAAI,SAAS,EAAE,CAAC;AAG1B,UAAM,KAAK,oBAAoB,OAAO;KACpC,KAAK;KACL,QAAQ;KACT,CAAC;AAEF,UAAM,KAAK,OAAO,OAAO,KAAK,mBAAmB;KAC/C,MAAM;KACN;KACA;KACD,CAAC;AAGF,UAAM,QAAQ,EAAE,KAAK,CAAC;IAGtB,MAAM,OAAO,KAAK,KAAK,IAAI,QAAQ,IAAI,EAAE;IACzC,MAAM,OAAO,MAAM,KAAK,oBAAoB,QAAQ,EAClD,OAAO;KACL,KAAK;KACL,QAAQ;KACT,EACF,CAAC;AAEF,SAAK,SAAS;AACd,SAAK,OAAO;AACZ,SAAK,aAAa,KAAK,iBAAiB,cAAc;AAEtD,UAAM,KAAK,oBAAoB,KAAK,KAAK;AAEzC,UAAM,KAAK,OAAO,OAAO,KACvB,qBACA;KACE,MAAM;KACN;KACD,EACD,EACE,OAAO,MACR,CACF;YACM,OAAO;IAEd,MAAM,OAAO,KAAK,KAAK,IAAI,QAAQ,IAAI,EAAE;IACzC,MAAM,OAAO,MAAM,KAAK,oBAAoB,QAAQ,EAClD,OAAO;KACL,KAAK;KACL,QAAQ;KACT,EACF,CAAC;AAEF,SAAK,SAAS;AACd,SAAK,QAAS,MAAgB;AAC9B,SAAK,OAAO;AACZ,SAAK,aAAa,KAAK,iBAAiB,cAAc;AAEtD,UAAM,KAAK,oBAAoB,KAAK,KAAK;AAEzC,UAAM,KAAK,OAAO,OAAO,KACvB,mBACA;KACE,MAAM;KACC;KACP;KACD,EACD,EACE,OAAO,MACR,CACF;;AAMH,QAAK,KAAK,OAAO,QAAQ;AAEzB,SAAM,KAAK,OAAO,OAAO,KACvB,iBACA;IACE,MAAM;IACN;IACD,EACD,EACE,OAAO,MACR,CACF;KAEH,EACE,SACD,CACF;;;;;;;;;ACnNL,MAAa,QAAQ,YAA+C;AAClE,QAAO,gBAAgB,cAAc,QAAQ;;AAc/C,IAAa,eAAb,cAAkC,UAA+B;CAC/D,AAAmB,cAAc,QAAQ,YAAY;CAErD,IAAW,OAAe;AACxB,SACE,KAAK,QAAQ,QACb,GAAG,KAAK,OAAO,QAAQ,KAAK,GAAG,KAAK,OAAO;;CAI/C,AAAU,SAAS;AAEjB,OAAK,YAAY,YAAY;GAC3B,GAAG,KAAK;GACR,MAAM,KAAK;GACZ,CAAC;;CAGJ,MAAa,UAAyB;AACpC,QAAM,KAAK,YAAY,WAAW,KAAK,KAAK;;;AAIhD,KAAK,QAAQ;;;;ACvCb,IAAa,aAAb,MAAwB;CACtB,AAAmB,SAAS,QAAQ,OAAO;CAC3C,AAAmB,sBAAsB,YAAY,cAAc;CAEnE,MAAa,UAA6B;AAExC,SADsB,KAAK,OAAO,WAAW,KAAK,CAC7B,KAAK,QAAQ,IAAI,KAAK;;CAG7C,MAAa,iBAAiB,QAA2B,EAAE,EAAE;AAC3D,QAAM,SAAS;EAEf,MAAM,QAAQ,KAAK,oBAAoB,kBAAkB;AAEzD,MAAI,MAAM,IACR,OAAM,MAAM,EAAE,IAAI,MAAM,KAAK;AAG/B,MAAI,MAAM,OACR,OAAM,SAAS,EAAE,IAAI,MAAM,QAAQ;AAGrC,SAAO,MAAM,KAAK,oBAAoB,SACpC,OACA,EAAE,OAAO,EACT,EAAE,OAAO,MAAM,CAChB;;CAGH,MAAa,WAAW,MAAwC;EAE9D,MAAM,MADgB,KAAK,OAAO,WAAW,KAAK,CACxB,MAAM,MAAM,EAAE,SAAS,KAAK;AAEtD,MAAI,CAAC,IACH,OAAM,IAAI,MAAM,kBAAkB,OAAO;AAG3C,QAAM,IAAI,SAAS;AACnB,SAAO,EAAE,IAAI,MAAM;;;;;;ACrCvB,IAAa,gBAAb,MAA2B;CACzB,AAAmB,MAAc;CACjC,AAAmB,QAAgB;CACnC,AAAmB,aAAa,QAAQ,WAAW;CAEnD,AAAgB,UAAU,QAAQ;EAChC,MAAM,KAAK;EACX,OAAO,KAAK;EACZ,QAAQ,EACN,UAAU,EAAE,MAAM,EAAE,QAAQ,CAAC,EAC9B;EACD,eAAe,KAAK,WAAW,SAAS;EACzC,CAAC;CAEF,AAAgB,mBAAmB,QAAQ;EACzC,MAAM,GAAG,KAAK,IAAI;EAClB,OAAO,KAAK;EACZ,QAAQ;GACN,OAAO;GACP,UAAU,EAAE,KAAK,2BAA2B;GAC7C;EACD,UAAU,EAAE,YAAY,KAAK,WAAW,iBAAiB,MAAM;EAChE,CAAC;CAEF,AAAgB,aAAa,QAAQ;EACnC,QAAQ;EACR,MAAM,GAAG,KAAK,IAAI;EAClB,OAAO,KAAK;EACZ,QAAQ;GACN,MAAM;GACN,UAAU;GACX;EACD,UAAU,EAAE,WAAW,KAAK,WAAW,WAAW,KAAK,KAAK;EAC7D,CAAC;;;;;;;;;;;;;ACdJ,MAAa,gBAAgB,QAAQ;CACnC,MAAM;CACN,UAAU;EAAC;EAAe;EAAa;EAAW;CACnD,CAAC"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/api/jobs/schemas/jobExecutionQuerySchema.ts","../../../src/api/jobs/entities/jobExecutions.ts","../../../src/api/jobs/schemas/jobExecutionResourceSchema.ts","../../../src/api/jobs/schemas/triggerJobSchema.ts","../../../src/api/jobs/providers/JobProvider.ts","../../../src/api/jobs/primitives/$job.ts","../../../src/api/jobs/services/JobService.ts","../../../src/api/jobs/controllers/JobController.ts","../../../src/api/jobs/index.ts"],"sourcesContent":["import type { Static } from \"alepha\";\nimport { t } from \"alepha\";\nimport { pageQuerySchema } from \"alepha/orm\";\n\nexport const jobExecutionQuerySchema = t.extend(pageQuerySchema, {\n  status: t.optional(t.enum([\"STARTED\", \"FAILED\", \"COMPLETED\"])),\n  job: t.optional(\n    t.text({\n      description: \"Filter by job name\",\n    }),\n  ),\n});\n\nexport type JobExecutionQuery = Static<typeof jobExecutionQuerySchema>;\n","import { type Static, t } from \"alepha\";\nimport { logEntrySchema } from \"alepha/logger\";\nimport { $entity, pg } from \"alepha/orm\";\n\nexport const jobExecutions = $entity({\n  name: \"job_executions\",\n  schema: t.object({\n    id: pg.primaryKey(t.uuid()),\n    version: pg.version(),\n    createdAt: pg.createdAt(),\n    updatedAt: pg.updatedAt(),\n    finishedAt: t.optional(t.datetime()),\n    job: t.string(),\n    status: t.enum([\"STARTED\", \"FAILED\", \"COMPLETED\"]),\n    error: t.optional(t.string()),\n    logs: t.optional(t.array(logEntrySchema)),\n  }),\n});\n\nexport type JobExecutionEntity = Static<typeof jobExecutions.schema>;\n","import { type Static, t } from \"alepha\";\nimport { jobExecutions } from \"../entities/jobExecutions.ts\";\n\nexport const jobExecutionResourceSchema = t.extend(\n  jobExecutions.schema,\n  {},\n  {\n    title: \"JobExecutionResource\",\n    description:\n      \"A job execution resource representing the execution details of a job.\",\n  },\n);\n\nexport type JobExecutionResource = Static<typeof jobExecutionResourceSchema>;\n","import type { Static } from \"alepha\";\nimport { t } from \"alepha\";\n\nexport const triggerJobSchema = t.object({\n  name: t.string(),\n});\n\nexport type TriggerJob = Static<typeof triggerJobSchema>;\n","import { $env, $inject, Alepha, type Async, type Static, t } from \"alepha\";\nimport { type DateTime, DateTimeProvider } from \"alepha/datetime\";\nimport { $lock, type LockPrimitive } from \"alepha/lock\";\nimport type { LogEntry } from \"alepha/logger\";\nimport { $repository } from \"alepha/orm\";\nimport { CronProvider } from \"alepha/scheduler\";\nimport { jobExecutions } from \"../entities/jobExecutions.ts\";\n\nconst envSchema = t.object({\n  JOB_PREFIX: t.optional(\n    t.text({\n      description: \"Prefix for job lock keys\",\n    }),\n  ),\n});\n\ndeclare module \"alepha\" {\n  interface Env extends Partial<Static<typeof envSchema>> {}\n}\n\n/**\n * Provider for job management and execution.\n * Handles job lifecycle, execution tracking, log capturing, and event emission.\n */\nexport class JobProvider {\n  protected readonly alepha = $inject(Alepha);\n  protected readonly dateTimeProvider = $inject(DateTimeProvider);\n  protected readonly cronProvider = $inject(CronProvider);\n  protected readonly executionRepository = $repository(jobExecutions);\n  protected readonly env = $env(envSchema);\n  protected readonly logs = new Map<string, LogEntry[]>();\n  protected readonly jobs = new Map<string, JobRegistration>();\n\n  /**\n   * Register and set up a job for execution (called during primitive initialization).\n   */\n  public registerJob(options: Job): JobRegistration {\n    const jobName = options.name;\n\n    // Set up log capturing for this job (only once)\n    if (this.jobs.size === 0) {\n      this.alepha.events.on(\"log\", ({ entry }) => {\n        const context = entry.context;\n        if (!context) {\n          return;\n        }\n\n        const entries = this.logs.get(context);\n        if (!entries) {\n          return;\n        }\n\n        entries.push(entry);\n        this.logs.set(context, entries);\n      });\n    }\n\n    // Create lock primitive if locking is enabled\n    const lockPrimitive =\n      options.lock !== false\n        ? $lock({\n            name: () => {\n              const prefix = this.env.JOB_PREFIX\n                ? `${this.env.JOB_PREFIX}:`\n                : \"\";\n              return `${prefix}job:${jobName}`;\n            },\n            handler: async () => {\n              await this.executeJob(jobName, options.handler);\n            },\n          })\n        : null;\n\n    const registration: JobRegistration = {\n      name: jobName,\n      options,\n      lockPrimitive,\n    };\n\n    this.jobs.set(jobName, registration);\n\n    // Set up cron scheduling if provided\n    if (options.cron) {\n      this.cronProvider.createCronJob(jobName, options.cron, () =>\n        this.triggerJob(jobName),\n      );\n    }\n\n    return registration;\n  }\n\n  /**\n   * Trigger a job by name.\n   */\n  public async triggerJob(jobName: string): Promise<void> {\n    const registration = this.jobs.get(jobName);\n    if (!registration) {\n      throw new Error(`Job not registered: ${jobName}`);\n    }\n\n    // Execute handler with or without lock\n    if (registration.options.lock !== false && registration.lockPrimitive) {\n      await registration.lockPrimitive.run();\n    } else {\n      await this.executeJob(jobName, registration.options.handler);\n    }\n  }\n\n  /**\n   * Execute a job handler (called by the job primitive).\n   */\n  public async executeJob(\n    jobName: string,\n    handler: (args: { now: DateTime }) => Async<void>,\n  ): Promise<void> {\n    if (!this.alepha.isStarted()) {\n      return;\n    }\n\n    const context = this.alepha.context.createContextId();\n\n    await this.alepha.context.run(\n      async () => {\n        try {\n          const now = this.dateTimeProvider.now();\n\n          // Initialize log collection for this context\n          this.logs.set(context, []);\n\n          // Create execution record\n          await this.executionRepository.create({\n            job: jobName,\n            status: \"STARTED\",\n          });\n\n          await this.alepha.events.emit(\"scheduler:begin\", {\n            name: jobName,\n            now,\n            context,\n          });\n\n          // Execute the handler\n          await handler({ now });\n\n          // Update execution as completed\n          const logs = this.logs.get(context) || [];\n          const exec = await this.executionRepository.findOne({\n            where: {\n              job: jobName,\n              status: \"STARTED\",\n            },\n          });\n\n          exec.status = \"COMPLETED\";\n          exec.logs = logs;\n          exec.finishedAt = this.dateTimeProvider.nowISOString();\n\n          await this.executionRepository.save(exec);\n\n          await this.alepha.events.emit(\n            \"scheduler:success\",\n            {\n              name: jobName,\n              context,\n            },\n            {\n              catch: true,\n            },\n          );\n        } catch (error) {\n          // Update execution as failed\n          const logs = this.logs.get(context) || [];\n          const exec = await this.executionRepository.findOne({\n            where: {\n              job: jobName,\n              status: \"STARTED\",\n            },\n          });\n\n          exec.status = \"FAILED\";\n          exec.error = (error as Error).message;\n          exec.logs = logs;\n          exec.finishedAt = this.dateTimeProvider.nowISOString();\n\n          await this.executionRepository.save(exec);\n\n          await this.alepha.events.emit(\n            \"scheduler:error\",\n            {\n              name: jobName,\n              error: error as Error,\n              context,\n            },\n            {\n              catch: true,\n            },\n          );\n\n          // Don't re-throw, jobs should handle errors gracefully\n        }\n\n        // Clean up logs\n        this.logs.delete(context);\n\n        await this.alepha.events.emit(\n          \"scheduler:end\",\n          {\n            name: jobName,\n            context,\n          },\n          {\n            catch: true,\n          },\n        );\n      },\n      {\n        context,\n      },\n    );\n  }\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport interface Job {\n  /**\n   * Name of the job.\n   */\n  name: string;\n\n  /**\n   * Optional description of the job.\n   */\n  description?: string;\n\n  /**\n   * Function to run on schedule.\n   */\n  handler: (args: { now: DateTime }) => Async<void>;\n\n  /**\n   * Cron expression to run the job.\n   */\n  cron?: string;\n\n  /**\n   * If true, the job will be locked and only one instance will run at a time.\n   * You probably need to import {@link AlephaLockRedis} for distributed locking.\n   *\n   * @default true\n   */\n  lock?: boolean;\n\n  /**\n   * Optional prefix for job lock keys.\n   */\n  lockPrefix?: string;\n}\n\nexport interface JobRegistration {\n  name: string;\n  options: Job;\n  lockPrimitive: LockPrimitive<() => Promise<void>> | null;\n}\n","import { $inject, createPrimitive, KIND, Primitive } from \"alepha\";\nimport type { DateTime } from \"alepha/datetime\";\nimport { type Job, JobProvider } from \"../providers/JobProvider.ts\";\n\n/**\n * Job primitive - a drop-in replacement for $scheduler with built-in execution tracking.\n */\nexport const $job = (options: JobPrimitiveOptions): JobPrimitive => {\n  return createPrimitive(JobPrimitive, options);\n};\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport type JobPrimitiveOptions = Omit<Job, \"name\"> & {\n  /**\n   * Name of the job. Defaults to the primitive property name.\n   */\n  name?: string;\n};\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport class JobPrimitive extends Primitive<JobPrimitiveOptions> {\n  protected readonly jobProvider = $inject(JobProvider);\n\n  public get name(): string {\n    return (\n      this.options.name ??\n      `${this.config.service.name}.${this.config.propertyKey}`\n    );\n  }\n\n  protected onInit() {\n    // Register job with JobProvider\n    this.jobProvider.registerJob({\n      ...this.options,\n      name: this.name,\n    });\n  }\n\n  public async trigger(): Promise<void> {\n    await this.jobProvider.triggerJob(this.name);\n  }\n}\n\n$job[KIND] = JobPrimitive;\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport interface JobHandlerArguments {\n  now: DateTime;\n}\n","import { $inject, Alepha } from \"alepha\";\nimport { $repository } from \"alepha/orm\";\nimport { jobExecutions } from \"../entities/jobExecutions.ts\";\nimport { $job } from \"../primitives/$job.ts\";\nimport type { JobExecutionQuery } from \"../schemas/jobExecutionQuerySchema.ts\";\n\nexport class JobService {\n  protected readonly alepha = $inject(Alepha);\n  protected readonly executionRepository = $repository(jobExecutions);\n\n  public async getJobs(): Promise<string[]> {\n    const jobPrimitives = this.alepha.primitives($job);\n    return jobPrimitives.map((job) => job.name);\n  }\n\n  public async getJobExecutions(query: JobExecutionQuery = {}) {\n    query.sort ??= \"-createdAt\";\n\n    const where = this.executionRepository.createQueryWhere();\n\n    if (query.job) {\n      where.job = { eq: query.job };\n    }\n\n    if (query.status) {\n      where.status = { eq: query.status };\n    }\n\n    return await this.executionRepository.paginate(\n      query,\n      { where },\n      { count: true },\n    );\n  }\n\n  public async triggerJob(name: string): Promise<{ ok: boolean }> {\n    const jobPrimitives = this.alepha.primitives($job);\n    const job = jobPrimitives.find((j) => j.name === name);\n\n    if (!job) {\n      throw new Error(`Job not found: ${name}`);\n    }\n\n    await job.trigger();\n    return { ok: true };\n  }\n}\n","import { $inject, t } from \"alepha\";\nimport { $action, okSchema } from \"alepha/server\";\nimport { jobExecutionQuerySchema } from \"../schemas/jobExecutionQuerySchema.ts\";\nimport { jobExecutionResourceSchema } from \"../schemas/jobExecutionResourceSchema.ts\";\nimport { triggerJobSchema } from \"../schemas/triggerJobSchema.ts\";\nimport { JobService } from \"../services/JobService.ts\";\n\nexport class JobController {\n  protected readonly url: string = \"/jobs\";\n  protected readonly group: string = \"jobs\";\n  protected readonly jobService = $inject(JobService);\n\n  public readonly getJobs = $action({\n    path: this.url,\n    group: this.group,\n    schema: {\n      response: t.array(t.string()),\n    },\n    handler: () => this.jobService.getJobs(),\n  });\n\n  public readonly getJobExecutions = $action({\n    path: `${this.url}/executions`,\n    group: this.group,\n    schema: {\n      query: jobExecutionQuerySchema,\n      response: t.page(jobExecutionResourceSchema),\n    },\n    handler: ({ query }) => this.jobService.getJobExecutions(query),\n  });\n\n  public readonly triggerJob = $action({\n    method: \"POST\",\n    path: `${this.url}/trigger`,\n    group: this.group,\n    schema: {\n      body: triggerJobSchema,\n      response: okSchema,\n    },\n    handler: ({ body }) => this.jobService.triggerJob(body.name),\n  });\n}\n","import { $module } from \"alepha\";\nimport { JobController } from \"./controllers/JobController.ts\";\nimport { JobProvider } from \"./providers/JobProvider.ts\";\nimport { JobService } from \"./services/JobService.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport * from \"./controllers/JobController.ts\";\nexport * from \"./entities/jobExecutions.ts\";\nexport * from \"./primitives/$job.ts\";\nexport * from \"./providers/JobProvider.ts\";\nexport * from \"./schemas/jobExecutionQuerySchema.ts\";\nexport * from \"./schemas/jobExecutionResourceSchema.ts\";\nexport * from \"./schemas/triggerJobSchema.ts\";\nexport * from \"./services/JobService.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Provides job management API endpoints for Alepha applications.\n *\n * This module includes job queue operations, job status monitoring,\n * and background task management capabilities.\n *\n * @module alepha.api.jobs\n */\nexport const AlephaApiJobs = $module({\n  name: \"alepha.api.jobs\",\n  services: [JobController, JobProvider, JobService],\n});\n"],"mappings":"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"}

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

@@ -9,6 +9,7 @@ import * as alepha_logger0 from "alepha/logger";
 import * as alepha_queue0 from "alepha/queue";
 import { EmailProvider } from "alepha/email";
 import { SmsProvider } from "alepha/sms";
+import * as typebox0 from "typebox";
 
 //#region ../../src/api/notifications/entities/notifications.d.ts
 declare const notifications: alepha_orm66.EntityPrimitive<alepha133.TObject<{
@@ -158,7 +159,26 @@ declare class NotificationSenderService {
   };
   protected load(notification: NotificationEntity): {
     template: NotificationPrimitive<alepha133.TObject<alepha133.TProperties>>;
-    variables: Record<string, any>;
+    variables: typebox0.StaticRecord<[], "Decode", {}, {
+      id: alepha_orm66.PgAttr<alepha_orm66.PgAttr<alepha133.TString, typeof alepha_orm66.PG_PRIMARY_KEY>, typeof alepha_orm66.PG_DEFAULT>;
+      version: alepha_orm66.PgAttr<alepha_orm66.PgAttr<alepha133.TInteger, typeof alepha_orm66.PG_VERSION>, typeof alepha_orm66.PG_DEFAULT>;
+      createdAt: alepha_orm66.PgAttr<alepha_orm66.PgAttr<alepha133.TString, typeof alepha_orm66.PG_CREATED_AT>, typeof alepha_orm66.PG_DEFAULT>;
+      updatedAt: alepha_orm66.PgAttr<alepha_orm66.PgAttr<alepha133.TString, typeof alepha_orm66.PG_UPDATED_AT>, typeof alepha_orm66.PG_DEFAULT>;
+      type: alepha133.TUnsafe<"email" | "sms">;
+      template: alepha133.TString;
+      category: alepha133.TOptional<alepha133.TString>;
+      critical: alepha133.TOptional<alepha133.TBoolean>;
+      sensitive: alepha133.TOptional<alepha133.TBoolean>;
+      contact: alepha133.TString;
+      variables: alepha133.TOptional<alepha133.TRecord<"^.*$", alepha133.TAny>>;
+      scheduledAt: alepha133.TOptional<alepha133.TString>;
+      sentAt: alepha133.TOptional<alepha133.TString>;
+      error: alepha133.TOptional<alepha133.TObject<{
+        at: alepha133.TString;
+        name: alepha133.TString;
+        message: alepha133.TString;
+      }>>;
+    }, "^.*$", alepha133.TAny>;
     contact: string;
   };
 }

package/dist/api/notifications/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/api/notifications/entities/notifications.ts","../../../src/api/notifications/schemas/notificationCreateSchema.ts","../../../src/api/notifications/schemas/notificationQuerySchema.ts","../../../src/api/notifications/primitives/$notification.ts","../../../src/api/notifications/services/NotificationSenderService.ts","../../../src/api/notifications/services/NotificationService.ts","../../../src/api/notifications/controllers/NotificationController.ts","../../../src/api/notifications/jobs/NotificationJobs.ts","../../../src/api/notifications/queues/NotificationQueues.ts","../../../src/api/notifications/schemas/notificationContactPreferencesSchema.ts","../../../src/api/notifications/index.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;cAGa,eAAa,YAAA,CAAA,0BAAA;8CAiExB,SAAA,CAAA,OAAA;;;;;;;;;;;EAjEW,WAAA,qBAiEX,mBAAA;EAAA,MAAA,qBAAA,mBAAA;;;;;;;KAEU,kBAAA,GAAqB,cAAc,aAAA,CAAc;;;cCnEhD,oCAAwB;QAKnC,SAAA,CAAA;;;;;KAEU,kBAAA,GAAqB,cAAc;;;cCNlC,mCAAuB;4BAMlC,SAAA,CAAA,QAAA;;;;;;;;;KAEU,iBAAA,GAAoB,cAAc;;;;;;;;;;;;;;AFT9C;;;;;;;;;;;;;;;;;cGoCa;aAA2B,kBAC7B,6BAA6B,KAAE,sBAAA;;;UAKzB,uCAAuC,iBAC9C,oBAAoB;;;;;;;oBAQV,oBAAoB;;UAE9B;;cAKG,gCAAgC,iBAAiB,UAC5D,6BAA6B;0CAES;;gBAMX,wBAAwB,KAAE;qBAU3B,QAAQ,6BAA6B;;UAShD,kCAAkC;aACtC,aAAa;;;UAIT,mBH3FS,CAAA,UG2FqB,OH3FrB,CAAA,CAAA;EAAA,KAAA,CAAA,EAAA;IAAA,OAAA,EAAA,MAAA;IAmEd,IAAA,EAAA,MAAA,GAAA,CAAA,CAAkB,SAAA,EG2BE,MH3Be,CG2BR,CH3BQ,CAAA,EAAA,GAAc,MAAA,CAAA;;;mCG8B1B,OAAO;EFjG7B,CAAA;;;;cGSA,yBAAA;6BACc;0BAAA,cAAA,CACH;6CACmB,YAAA,CAAA,qBAAA;gDADnB,SAAA,CAAA,OAAA;;;;IJXX,IAAA,mBAiEX,CAAA,OAAA,GAAA,KAAA,CAAA;IAAA,QAAA,mBAAA;;;;;;;;;;;;;;uCIpDmC;oCACH;kCACF;gCAEa,qBAAkB;0BAiE9B;;;;4BAmCE;;;;;+BAuCJ;sDAAkB,SAAA,CAAA,WAAA;;;;;;;cC9IpC,wCAA4B;0CAOvC,SAAA,CAAA,QAAA;;;wBAGsB,QAAQ,cAAc;ALxB9C;AAiEE,cKtCW,mBAAA,CLsCX;6BKrCyB;0BAAA,cAAA,CACH;;;;6CAEmB,YAAA,CAAA,qBAAA;gDAFnB,SAAA,CAAA,OAAA;;;;;;;;;;;;;;;;;;;uCAGa;gDACS;4CAIX,yBAAA;UAJW,SAAA,CAAA;;;;;oCA8BA,qBAAA,mBAAA;gDA1BX,SAAA,CAAA,OAAA;;;;;;YLrCT,qBAAA,mBAAA;IAAA,QAAA,qBAAA,oBAAA;IAAA,SAAA,qBAAA,oBAAA;IAmEd,OAAA,mBAAmC;;;;ICnElC,KAAA,qBAKX,kBAAA,CAAA;MAAA,EAAA,mBAAA;;;;;gDI0D4C,SAAA,CAAA,OAAA;WJ/DT,qBAAA,oBAAA,qBAAA,8BAAA,CAAA,EAAA,8BAAA,CAAA;IAAA,SAAA,qBAAA,oBAAA,oBAAA,iCAAA,CAAA,EAAA,8BAAA,CAAA;IAOzB,SAAA,qBAAmC,oBAAR,oBAAA,iCAAA,CAAA,EAAA,8BAAA,CAAA;;;;ICN1B,QAAA,qBAMX,oBAAA;IAAA,SAAA,qBAAA,oBAAA;;;;;;;;;;;wBG8DK,oBACF,QAAQ,KAAK;;;;4BAwCuB,qBAAqB;;;;cC1GjD,sBAAA;;;0CAG2B;;;;6CAKL;;gCALK,SAAA,CAAA,QAAA;;;MNP3B,IAAA,qBAiEX,kBAAA,CAAA,OAAA,GAAA,KAAA,CAAA,CAAA;MAAA,QAAA,qBAAA,mBAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cOpEW,gBAAA;;;cCIA,kBAAA;gDACiC;gCAIT,aAAA,CAAA,yBAAA;oBAJS,SAAA,CAAA;;;;;cCHjC,gDAAoC;gCAG/C,SAAA,CAAA,OAAA;;;KAEU,8BAAA,GAAiC,cACpC;;;;;;ATLT;;;;;;;cUiCa,wBAAsB,SAAA,CAAA,QAsBjC,SAAA,CAtBiC,MAAA"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/api/notifications/entities/notifications.ts","../../../src/api/notifications/schemas/notificationCreateSchema.ts","../../../src/api/notifications/schemas/notificationQuerySchema.ts","../../../src/api/notifications/primitives/$notification.ts","../../../src/api/notifications/services/NotificationSenderService.ts","../../../src/api/notifications/services/NotificationService.ts","../../../src/api/notifications/controllers/NotificationController.ts","../../../src/api/notifications/jobs/NotificationJobs.ts","../../../src/api/notifications/queues/NotificationQueues.ts","../../../src/api/notifications/schemas/notificationContactPreferencesSchema.ts","../../../src/api/notifications/index.ts"],"sourcesContent":[],"mappings":"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"}

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

@@ -1,11 +1,24 @@
 import * as alepha317 from "alepha";
-import { KIND, Primitive, Static, TObject } from "alepha";
+import { KIND, Primitive, Static, TNull, TObject, TOptional, TSchema, TUnion } from "alepha";
 import * as alepha_server0 from "alepha/server";
 import { DateTimeProvider } from "alepha/datetime";
 import * as alepha_logger0 from "alepha/logger";
 import * as alepha_orm14 from "alepha/orm";
 import * as alepha_topic0 from "alepha/topic";
 import * as alepha_scheduler0 from "alepha/scheduler";
+import "bun";
+import "bun:sqlite";
+import "drizzle-orm/bun-sql";
+import "drizzle-orm/bun-sqlite";
+import "drizzle-orm/d1";
+import { BuildExtraConfigColumns, SQL } from "drizzle-orm";
+import { PgColumnBuilderBase, PgSequenceOptions, PgTableExtraConfigValue, UpdateDeleteAction } from "drizzle-orm/pg-core";
+import "alepha/retry";
+import "alepha/lock";
+import * as typebox0 from "typebox";
+import "drizzle-orm/sqlite-core";
+import "drizzle-orm/postgres-js";
+import "postgres";
 import { UserAccount } from "alepha/security";
 
 //#region ../../src/api/parameters/entities/parameters.d.ts
@@ -92,6 +105,406 @@ declare const parameters: alepha_orm14.EntityPrimitive<alepha317.TObject<{
 type Parameter = Static<typeof parameters.schema>;
 type ParameterInsert = Omit<Parameter, "id" | "createdAt" | "updatedAt">;
 //#endregion
+//#region ../../src/orm/schemas/insertSchema.d.ts
+/**
+ * Transforms a TObject schema for insert operations.
+ * All default properties at the root level are made optional.
+ *
+ * @example
+ * Before: { name: string; age: number(default=0); }
+ * After:  { name: string; age?: number; }
+ */
+type TObjectInsert<T extends TObject> = TObject<{ [K in keyof T["properties"]]: T["properties"][K] extends {
+  [PG_DEFAULT]: any;
+} | {
+  "~optional": true;
+} ? TOptional<T["properties"][K]> : T["properties"][K] }>;
+//#endregion
+//#region ../../src/orm/schemas/updateSchema.d.ts
+/**
+ * Transforms a TObject schema for update operations.
+ * All optional properties at the root level are made nullable (i.e., `T | null`).
+ * This allows an API endpoint to explicitly accept `null` to clear an optional field in the database.
+ *
+ * @example
+ * Before: { name?: string; age: number; }
+ * After:  { name?: string | null; age: number; }
+ */
+type TObjectUpdate<T extends TObject> = TObject<{ [K in keyof T["properties"]]: T["properties"][K] extends TOptional<infer U> ? TOptional<TUnion<[U, TNull]>> : T["properties"][K] }>;
+//#endregion
+//#region ../../src/orm/primitives/$entity.d.ts
+interface EntityPrimitiveOptions<T extends TObject, Keys = keyof Static<T>> {
+  /**
+   * The database table name that will be created for this entity.
+   * If not provided, name will be inferred from the $repository variable name.
+   */
+  name: string;
+  /**
+   * TypeBox schema defining the table structure and column types.
+   */
+  schema: T;
+  /**
+   * Database indexes to create for query optimization.
+   */
+  indexes?: (Keys | {
+    /**
+     * Single column to index.
+     */
+    column: Keys;
+    /**
+     * Whether this should be a unique index (enforces uniqueness constraint).
+     */
+    unique?: boolean;
+    /**
+     * Custom name for the index. If not provided, generates name automatically.
+     */
+    name?: string;
+  } | {
+    /**
+     * Multiple columns for composite index (order matters for query optimization).
+     */
+    columns: Keys[];
+    /**
+     * Whether this should be a unique index (enforces uniqueness constraint).
+     */
+    unique?: boolean;
+    /**
+     * Custom name for the index. If not provided, generates name automatically.
+     */
+    name?: string;
+  })[];
+  /**
+   * Foreign key constraints to maintain referential integrity.
+   */
+  foreignKeys?: Array<{
+    /**
+     * Optional name for the foreign key constraint.
+     */
+    name?: string;
+    /**
+     * Local columns that reference the foreign table.
+     */
+    columns: Array<keyof Static<T>>;
+    /**
+     * Referenced columns in the foreign table.
+     * Must be EntityColumn references from other entities.
+     */
+    foreignColumns: Array<() => EntityColumn<any>>;
+  }>;
+  /**
+   * Additional table constraints for data validation.
+   *
+   * Constraints enforce business rules at the database level, providing
+   * an additional layer of data integrity beyond application validation.
+   *
+   * **Constraint Types**:
+   * - **Unique constraints**: Prevent duplicate values across columns
+   * - **Check constraints**: Enforce custom validation rules with SQL expressions
+   *
+   * @example
+   * ```ts
+   * constraints: [
+   *   {
+   *     name: "unique_user_email",
+   *     columns: ["email"],
+   *     unique: true
+   *   },
+   *   {
+   *     name: "valid_age_range",
+   *     columns: ["age"],
+   *     check: sql`age >= 0 AND age <= 150`
+   *   },
+   *   {
+   *     name: "unique_user_username_per_tenant",
+   *     columns: ["tenantId", "username"],
+   *     unique: true
+   *   }
+   * ]
+   * ```
+   */
+  constraints?: Array<{
+    /**
+     * Columns involved in this constraint.
+     */
+    columns: Array<keyof Static<T>>;
+    /**
+     * Optional name for the constraint.
+     */
+    name?: string;
+    /**
+     * Whether this is a unique constraint.
+     */
+    unique?: boolean | {};
+    /**
+     * SQL expression for check constraint validation.
+     */
+    check?: SQL;
+  }>;
+  /**
+   * Advanced Drizzle ORM configuration for complex table setups.
+   */
+  config?: (self: BuildExtraConfigColumns<string, FromSchema<T>, "pg">) => PgTableExtraConfigValue[];
+}
+declare class EntityPrimitive<T extends TObject = TObject> {
+  readonly options: EntityPrimitiveOptions<T>;
+  constructor(options: EntityPrimitiveOptions<T>);
+  alias(alias: string): this;
+  get cols(): EntityColumns<T>;
+  get name(): string;
+  get schema(): T;
+  get insertSchema(): TObjectInsert<T>;
+  get updateSchema(): TObjectUpdate<T>;
+}
+/**
+ * Convert a schema to columns.
+ */
+type FromSchema<T extends TObject> = { [key in keyof T["properties"]]: PgColumnBuilderBase };
+type EntityColumn<T extends TObject> = {
+  name: string;
+  entity: EntityPrimitive<T>;
+};
+type EntityColumns<T extends TObject> = { [key in keyof T["properties"]]: EntityColumn<T> };
+//#endregion
+//#region ../../src/orm/constants/PG_SYMBOLS.d.ts
+declare const PG_DEFAULT: unique symbol;
+declare const PG_PRIMARY_KEY: unique symbol;
+declare const PG_CREATED_AT: unique symbol;
+declare const PG_UPDATED_AT: unique symbol;
+declare const PG_DELETED_AT: unique symbol;
+declare const PG_VERSION: unique symbol;
+declare const PG_IDENTITY: unique symbol;
+declare const PG_ENUM: unique symbol;
+declare const PG_REF: unique symbol;
+/**
+ * @deprecated Use `PG_IDENTITY` instead.
+ */
+declare const PG_SERIAL: unique symbol;
+type PgSymbols = {
+  [PG_DEFAULT]: {};
+  [PG_PRIMARY_KEY]: {};
+  [PG_CREATED_AT]: {};
+  [PG_UPDATED_AT]: {};
+  [PG_DELETED_AT]: {};
+  [PG_VERSION]: {};
+  [PG_IDENTITY]: PgIdentityOptions;
+  [PG_REF]: PgRefOptions;
+  [PG_ENUM]: PgEnumOptions;
+  /**
+   * @deprecated Use `PG_IDENTITY` instead.
+   */
+  [PG_SERIAL]: {};
+};
+type PgSymbolKeys = keyof PgSymbols;
+type PgIdentityOptions = {
+  mode: "always" | "byDefault";
+} & PgSequenceOptions & {
+  name?: string;
+};
+interface PgEnumOptions {
+  name?: string;
+  description?: string;
+}
+interface PgRefOptions {
+  ref: () => {
+    name: string;
+    entity: EntityPrimitive;
+  };
+  actions?: {
+    onUpdate?: UpdateDeleteAction;
+    onDelete?: UpdateDeleteAction;
+  };
+}
+//#endregion
+//#region ../../src/orm/helpers/pgAttr.d.ts
+/**
+ * Type representation.
+ */
+type PgAttr<T extends TSchema, TAttr extends PgSymbolKeys> = T & { [K in TAttr]: PgSymbols[K] };
+//#endregion
+//#region ../../src/orm/providers/drivers/BunPostgresProvider.d.ts
+declare module "alepha" {
+  interface Env extends Partial<Static<typeof envSchema$1>> {}
+}
+declare const envSchema$1: alepha317.TObject<{
+  /**
+   * Main configuration for database connection.
+   * Accept a string in the format of a Postgres connection URL.
+   * Example: postgres://user:password@localhost:5432/database
+   * or
+   * Example: postgres://user:password@localhost:5432/database?sslmode=require
+   */
+  DATABASE_URL: alepha317.TOptional<alepha317.TString>;
+  /**
+   * In addition to the DATABASE_URL, you can specify the postgres schema name.
+   */
+  POSTGRES_SCHEMA: alepha317.TOptional<alepha317.TString>;
+}>;
+/**
+ * Bun PostgreSQL provider using Drizzle ORM with Bun's native SQL client.
+ *
+ * This provider uses Bun's built-in SQL class for PostgreSQL connections,
+ * which provides excellent performance on the Bun runtime.
+ *
+ * @example
+ * ```ts
+ * // Set DATABASE_URL environment variable
+ * // DATABASE_URL=postgres://user:password@localhost:5432/database
+ *
+ * // Or configure programmatically
+ * alepha.with({
+ *   provide: DatabaseProvider,
+ *   use: BunPostgresProvider,
+ * });
+ * ```
+ */
+//#endregion
+//#region ../../src/orm/providers/drivers/BunSqliteProvider.d.ts
+/**
+ * Configuration options for the Bun SQLite database provider.
+ */
+declare const bunSqliteOptions: alepha317.Atom<alepha317.TObject<{
+  path: alepha317.TOptional<alepha317.TString>;
+}>, "alepha.postgres.bun-sqlite.options">;
+type BunSqliteProviderOptions = Static<typeof bunSqliteOptions.schema>;
+declare module "alepha" {
+  interface State {
+    [bunSqliteOptions.key]: BunSqliteProviderOptions;
+  }
+}
+/**
+ * Bun SQLite provider using Drizzle ORM with Bun's native SQLite client.
+ *
+ * This provider uses Bun's built-in `bun:sqlite` for SQLite connections,
+ * which provides excellent performance on the Bun runtime.
+ *
+ * @example
+ * ```ts
+ * // Set DATABASE_URL environment variable
+ * // DATABASE_URL=sqlite://./my-database.db
+ *
+ * // Or configure programmatically
+ * alepha.with({
+ *   provide: DatabaseProvider,
+ *   use: BunSqliteProvider,
+ * });
+ *
+ * // Or use options atom
+ * alepha.store.mut(bunSqliteOptions, (old) => ({
+ *   ...old,
+ *   path: ":memory:",
+ * }));
+ * ```
+ */
+//#endregion
+//#region ../../src/orm/providers/drivers/NodePostgresProvider.d.ts
+declare module "alepha" {
+  interface Env extends Partial<Static<typeof envSchema>> {}
+}
+declare const envSchema: alepha317.TObject<{
+  /**
+   * Main configuration for database connection.
+   * Accept a string in the format of a Postgres connection URL.
+   * Example: postgres://user:password@localhost:5432/database
+   * or
+   * Example: postgres://user:password@localhost:5432/database?sslmode=require
+   */
+  DATABASE_URL: alepha317.TOptional<alepha317.TString>;
+  /**
+   * In addition to the DATABASE_URL, you can specify the postgres schema name.
+   *
+   * It will monkey patch drizzle tables.
+   */
+  POSTGRES_SCHEMA: alepha317.TOptional<alepha317.TString>;
+}>;
+//#endregion
+//#region ../../src/orm/providers/drivers/NodeSqliteProvider.d.ts
+/**
+ * Configuration options for the Node.js SQLite database provider.
+ */
+declare const nodeSqliteOptions: alepha317.Atom<alepha317.TObject<{
+  path: alepha317.TOptional<alepha317.TString>;
+}>, "alepha.postgres.node-sqlite.options">;
+type NodeSqliteProviderOptions = Static<typeof nodeSqliteOptions.schema>;
+declare module "alepha" {
+  interface State {
+    [nodeSqliteOptions.key]: NodeSqliteProviderOptions;
+  }
+}
+/**
+ * Add a fake support for SQLite in Node.js based on Postgres interfaces.
+ *
+ * This is NOT a real SQLite provider, it's a workaround to use SQLite with Drizzle ORM.
+ * This is NOT recommended for production use.
+ */
+//#endregion
+//#region ../../src/orm/index.d.ts
+declare module "alepha" {
+  interface Hooks {
+    /**
+     * Fires before creating an entity in the repository.
+     */
+    "repository:create:before": {
+      tableName: string;
+      data: any;
+    };
+    /**
+     * Fires after creating an entity in the repository.
+     */
+    "repository:create:after": {
+      tableName: string;
+      data: any;
+      entity: any;
+    };
+    /**
+     * Fires before updating entities in the repository.
+     */
+    "repository:update:before": {
+      tableName: string;
+      where: any;
+      data: any;
+    };
+    /**
+     * Fires after updating entities in the repository.
+     */
+    "repository:update:after": {
+      tableName: string;
+      where: any;
+      data: any;
+      entities: any[];
+    };
+    /**
+     * Fires before deleting entities from the repository.
+     */
+    "repository:delete:before": {
+      tableName: string;
+      where: any;
+    };
+    /**
+     * Fires after deleting entities from the repository.
+     */
+    "repository:delete:after": {
+      tableName: string;
+      where: any;
+      ids: Array<string | number>;
+    };
+    /**
+     * Fires before reading entities from the repository.
+     */
+    "repository:read:before": {
+      tableName: string;
+      query: any;
+    };
+    /**
+     * Fires after reading entities from the repository.
+     */
+    "repository:read:after": {
+      tableName: string;
+      query: any;
+      entities: any[];
+    };
+  }
+}
+//#endregion
 //#region ../../src/api/parameters/primitives/$config.d.ts
 /**
  * Creates a versioned configuration primitive for managing application settings.
@@ -182,7 +595,7 @@ declare class ConfigPrimitive<T extends TObject> extends Primitive<ConfigPrimiti
   /**
    * Get a specific field from the current configuration.
    */
-  get<Key extends keyof Static<T>>(key: Key): Static<T>[Key];
+  get<Key$1 extends keyof Static<T>>(key: Key$1): Static<T>[Key$1];
   /**
    * Set a new configuration value.
    *
@@ -213,13 +626,47 @@ declare class ConfigPrimitive<T extends TObject> extends Primitive<ConfigPrimiti
     tags?: string[] | undefined;
     creatorId?: string | undefined;
     creatorName?: string | undefined;
-    previousContent?: Record<string, any> | undefined;
+    previousContent?: typebox0.StaticRecord<[], "Decode", {}, {
+      id: PgAttr<PgAttr<alepha317.TString, typeof PG_PRIMARY_KEY>, typeof PG_DEFAULT>;
+      createdAt: PgAttr<PgAttr<alepha317.TString, typeof PG_CREATED_AT>, typeof PG_DEFAULT>;
+      updatedAt: PgAttr<PgAttr<alepha317.TString, typeof PG_UPDATED_AT>, typeof PG_DEFAULT>;
+      name: alepha317.TString;
+      content: alepha317.TRecord<string, alepha317.TAny>;
+      schemaHash: alepha317.TString;
+      status: PgAttr<alepha317.TUnsafe<"expired" | "current" | "next" | "future">, typeof PG_DEFAULT>;
+      activationDate: alepha317.TString;
+      expiredAt: alepha317.TOptional<alepha317.TString>;
+      version: alepha317.TInteger;
+      changeDescription: alepha317.TOptional<alepha317.TString>;
+      tags: alepha317.TOptional<alepha317.TArray<alepha317.TString>>;
+      creatorId: alepha317.TOptional<alepha317.TString>;
+      creatorName: alepha317.TOptional<alepha317.TString>;
+      previousContent: alepha317.TOptional<alepha317.TRecord<string, alepha317.TAny>>;
+      migrationLog: alepha317.TOptional<alepha317.TString>;
+    }, string, alepha317.TAny> | undefined;
     migrationLog?: string | undefined;
     id: string;
     createdAt: string;
     updatedAt: string;
     name: string;
-    content: Record<string, any>;
+    content: typebox0.StaticRecord<[], "Decode", {}, {
+      id: PgAttr<PgAttr<alepha317.TString, typeof PG_PRIMARY_KEY>, typeof PG_DEFAULT>;
+      createdAt: PgAttr<PgAttr<alepha317.TString, typeof PG_CREATED_AT>, typeof PG_DEFAULT>;
+      updatedAt: PgAttr<PgAttr<alepha317.TString, typeof PG_UPDATED_AT>, typeof PG_DEFAULT>;
+      name: alepha317.TString;
+      content: alepha317.TRecord<string, alepha317.TAny>;
+      schemaHash: alepha317.TString;
+      status: PgAttr<alepha317.TUnsafe<"expired" | "current" | "next" | "future">, typeof PG_DEFAULT>;
+      activationDate: alepha317.TString;
+      expiredAt: alepha317.TOptional<alepha317.TString>;
+      version: alepha317.TInteger;
+      changeDescription: alepha317.TOptional<alepha317.TString>;
+      tags: alepha317.TOptional<alepha317.TArray<alepha317.TString>>;
+      creatorId: alepha317.TOptional<alepha317.TString>;
+      creatorName: alepha317.TOptional<alepha317.TString>;
+      previousContent: alepha317.TOptional<alepha317.TRecord<string, alepha317.TAny>>;
+      migrationLog: alepha317.TOptional<alepha317.TString>;
+    }, string, alepha317.TAny>;
     schemaHash: string;
     status: "expired" | "current" | "next" | "future";
     activationDate: string;