alepha 0.13.1 → 0.13.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/descriptors/$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 LockDescriptor } 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 descriptor 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 descriptor if locking is enabled\n    const lockDescriptor =\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      lockDescriptor,\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.lockDescriptor) {\n      await registration.lockDescriptor.run();\n    } else {\n      await this.executeJob(jobName, registration.options.handler);\n    }\n  }\n\n  /**\n   * Execute a job handler (called by the job descriptor).\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  lockDescriptor: LockDescriptor<() => Promise<void>> | null;\n}\n","import { $inject, createDescriptor, Descriptor, KIND } from \"alepha\";\nimport type { DateTime } from \"alepha/datetime\";\nimport { type Job, JobProvider } from \"../providers/JobProvider.ts\";\n\n/**\n * Job descriptor - a drop-in replacement for $scheduler with built-in execution tracking.\n */\nexport const $job = (options: JobDescriptorOptions): JobDescriptor => {\n  return createDescriptor(JobDescriptor, options);\n};\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport type JobDescriptorOptions = Omit<Job, \"name\"> & {\n  /**\n   * Name of the job. Defaults to the descriptor property name.\n   */\n  name?: string;\n};\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport class JobDescriptor extends Descriptor<JobDescriptorOptions> {\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] = JobDescriptor;\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport interface JobHandlerArguments {\n  now: DateTime;\n}\n","import { $inject, Alepha } from \"alepha\";\nimport { $repository } from \"alepha/orm\";\nimport { $job } from \"../descriptors/$job.ts\";\nimport { jobExecutions } from \"../entities/jobExecutions.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 jobDescriptors = this.alepha.descriptors($job);\n    return jobDescriptors.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 jobDescriptors = this.alepha.descriptors($job);\n    const job = jobDescriptors.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 \"./descriptors/$job.ts\";\nexport * from \"./entities/jobExecutions.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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"}
+{"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":"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"}

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

@@ -1,78 +1,73 @@
-import * as alepha122 from "alepha";
-import { Alepha, Descriptor, KIND, Static, StaticEncode, TObject } from "alepha";
+import * as alepha1 from "alepha";
+import { Alepha, KIND, Primitive, Static, StaticEncode, TObject } from "alepha";
 import * as alepha_batch0 from "alepha/batch";
 import { DateTimeProvider } from "alepha/datetime";
 import * as alepha_logger0 from "alepha/logger";
-import * as alepha_orm50 from "alepha/orm";
+import * as alepha_orm0 from "alepha/orm";
 import * as alepha_queue0 from "alepha/queue";
 import { EmailProvider } from "alepha/email";
+import { SmsProvider } from "alepha/sms";
 
 //#region src/api-notifications/controllers/NotificationController.d.ts
 declare class NotificationController {}
 //#endregion
-//#region src/api-notifications/schemas/notificationCreateSchema.d.ts
-declare const notificationCreateSchema: alepha122.TObject<{
-  type: alepha122.TUnsafe<"email" | "sms">;
-  template: alepha122.TString;
-  contact: alepha122.TString;
-  variables: alepha122.TOptional<alepha122.TRecord<"^.*$", alepha122.TAny>>;
-}>;
-type NotificationCreate = Static<typeof notificationCreateSchema>;
-//#endregion
 //#region src/api-notifications/entities/notifications.d.ts
-declare const notifications: alepha_orm50.EntityDescriptor<alepha122.TObject<{
-  id: alepha_orm50.PgAttr<alepha_orm50.PgAttr<alepha122.TString, typeof alepha_orm50.PG_PRIMARY_KEY>, typeof alepha_orm50.PG_DEFAULT>;
-  version: alepha_orm50.PgAttr<alepha_orm50.PgAttr<alepha122.TInteger, typeof alepha_orm50.PG_VERSION>, typeof alepha_orm50.PG_DEFAULT>;
-  createdAt: alepha_orm50.PgAttr<alepha_orm50.PgAttr<alepha122.TString, typeof alepha_orm50.PG_CREATED_AT>, typeof alepha_orm50.PG_DEFAULT>;
-  updatedAt: alepha_orm50.PgAttr<alepha_orm50.PgAttr<alepha122.TString, typeof alepha_orm50.PG_UPDATED_AT>, typeof alepha_orm50.PG_DEFAULT>;
-  type: alepha122.TUnsafe<"email" | "sms">;
-  template: alepha122.TString;
-  category: alepha122.TOptional<alepha122.TString>;
-  critical: alepha122.TOptional<alepha122.TBoolean>;
-  sensitive: alepha122.TOptional<alepha122.TBoolean>;
-  contact: alepha122.TString;
-  variables: alepha122.TOptional<alepha122.TRecord<"^.*$", alepha122.TAny>>;
-  scheduledAt: alepha122.TOptional<alepha122.TString>;
-  sentAt: alepha122.TOptional<alepha122.TString>;
-  error: alepha122.TOptional<alepha122.TObject<{
-    at: alepha122.TString;
-    name: alepha122.TString;
-    message: alepha122.TString;
+declare const notifications: alepha_orm0.EntityPrimitive<alepha1.TObject<{
+  id: alepha_orm0.PgAttr<alepha_orm0.PgAttr<alepha1.TString, typeof alepha_orm0.PG_PRIMARY_KEY>, typeof alepha_orm0.PG_DEFAULT>;
+  version: alepha_orm0.PgAttr<alepha_orm0.PgAttr<alepha1.TInteger, typeof alepha_orm0.PG_VERSION>, typeof alepha_orm0.PG_DEFAULT>;
+  createdAt: alepha_orm0.PgAttr<alepha_orm0.PgAttr<alepha1.TString, typeof alepha_orm0.PG_CREATED_AT>, typeof alepha_orm0.PG_DEFAULT>;
+  updatedAt: alepha_orm0.PgAttr<alepha_orm0.PgAttr<alepha1.TString, typeof alepha_orm0.PG_UPDATED_AT>, typeof alepha_orm0.PG_DEFAULT>;
+  type: alepha1.TUnsafe<"email" | "sms">;
+  template: alepha1.TString;
+  category: alepha1.TOptional<alepha1.TString>;
+  critical: alepha1.TOptional<alepha1.TBoolean>;
+  sensitive: alepha1.TOptional<alepha1.TBoolean>;
+  contact: alepha1.TString;
+  variables: alepha1.TOptional<alepha1.TRecord<"^.*$", alepha1.TAny>>;
+  scheduledAt: alepha1.TOptional<alepha1.TString>;
+  sentAt: alepha1.TOptional<alepha1.TString>;
+  error: alepha1.TOptional<alepha1.TObject<{
+    at: alepha1.TString;
+    name: alepha1.TString;
+    message: alepha1.TString;
   }>>;
 }>>;
 type NotificationEntity = Static<typeof notifications.schema>;
 //#endregion
-//#region src/api-notifications/providers/SmsProvider.d.ts
-declare abstract class SmsProvider {
-  abstract send(options: SmsSendOptions): Promise<void>;
-}
-interface SmsSendOptions {
-  to: string;
-  message: string;
-}
+//#region src/api-notifications/jobs/NotificationJobs.d.ts
+declare class NotificationJobs {}
+//#endregion
+//#region src/api-notifications/schemas/notificationCreateSchema.d.ts
+declare const notificationCreateSchema: alepha1.TObject<{
+  type: alepha1.TUnsafe<"email" | "sms">;
+  template: alepha1.TString;
+  contact: alepha1.TString;
+  variables: alepha1.TOptional<alepha1.TRecord<"^.*$", alepha1.TAny>>;
+}>;
+type NotificationCreate = Static<typeof notificationCreateSchema>;
 //#endregion
 //#region src/api-notifications/services/NotificationSenderService.d.ts
 declare class NotificationSenderService {
   protected readonly alepha: Alepha;
   protected readonly log: alepha_logger0.Logger;
-  protected readonly notificationRepository: alepha_orm50.Repository<alepha122.TObject<{
-    id: alepha_orm50.PgAttr<alepha_orm50.PgAttr<alepha122.TString, typeof alepha_orm50.PG_PRIMARY_KEY>, typeof alepha_orm50.PG_DEFAULT>;
-    version: alepha_orm50.PgAttr<alepha_orm50.PgAttr<alepha122.TInteger, typeof alepha_orm50.PG_VERSION>, typeof alepha_orm50.PG_DEFAULT>;
-    createdAt: alepha_orm50.PgAttr<alepha_orm50.PgAttr<alepha122.TString, typeof alepha_orm50.PG_CREATED_AT>, typeof alepha_orm50.PG_DEFAULT>;
-    updatedAt: alepha_orm50.PgAttr<alepha_orm50.PgAttr<alepha122.TString, typeof alepha_orm50.PG_UPDATED_AT>, typeof alepha_orm50.PG_DEFAULT>;
-    type: alepha122.TUnsafe<"email" | "sms">;
-    template: alepha122.TString;
-    category: alepha122.TOptional<alepha122.TString>;
-    critical: alepha122.TOptional<alepha122.TBoolean>;
-    sensitive: alepha122.TOptional<alepha122.TBoolean>;
-    contact: alepha122.TString;
-    variables: alepha122.TOptional<alepha122.TRecord<"^.*$", alepha122.TAny>>;
-    scheduledAt: alepha122.TOptional<alepha122.TString>;
-    sentAt: alepha122.TOptional<alepha122.TString>;
-    error: alepha122.TOptional<alepha122.TObject<{
-      at: alepha122.TString;
-      name: alepha122.TString;
-      message: alepha122.TString;
+  protected readonly notificationRepository: alepha_orm0.Repository<alepha1.TObject<{
+    id: alepha_orm0.PgAttr<alepha_orm0.PgAttr<alepha1.TString, typeof alepha_orm0.PG_PRIMARY_KEY>, typeof alepha_orm0.PG_DEFAULT>;
+    version: alepha_orm0.PgAttr<alepha_orm0.PgAttr<alepha1.TInteger, typeof alepha_orm0.PG_VERSION>, typeof alepha_orm0.PG_DEFAULT>;
+    createdAt: alepha_orm0.PgAttr<alepha_orm0.PgAttr<alepha1.TString, typeof alepha_orm0.PG_CREATED_AT>, typeof alepha_orm0.PG_DEFAULT>;
+    updatedAt: alepha_orm0.PgAttr<alepha_orm0.PgAttr<alepha1.TString, typeof alepha_orm0.PG_UPDATED_AT>, typeof alepha_orm0.PG_DEFAULT>;
+    type: alepha1.TUnsafe<"email" | "sms">;
+    template: alepha1.TString;
+    category: alepha1.TOptional<alepha1.TString>;
+    critical: alepha1.TOptional<alepha1.TBoolean>;
+    sensitive: alepha1.TOptional<alepha1.TBoolean>;
+    contact: alepha1.TString;
+    variables: alepha1.TOptional<alepha1.TRecord<"^.*$", alepha1.TAny>>;
+    scheduledAt: alepha1.TOptional<alepha1.TString>;
+    sentAt: alepha1.TOptional<alepha1.TString>;
+    error: alepha1.TOptional<alepha1.TObject<{
+      at: alepha1.TString;
+      name: alepha1.TString;
+      message: alepha1.TString;
     }>>;
   }>>;
   protected readonly dateTimeProvider: DateTimeProvider;
@@ -89,15 +84,15 @@ declare class NotificationSenderService {
     body: string;
   };
   protected load(notification: NotificationEntity): {
-    template: NotificationDescriptor<alepha122.TObject<alepha122.TProperties>>;
+    template: NotificationPrimitive<alepha1.TObject<alepha1.TProperties>>;
     variables: Record<string, any>;
     contact: string;
   };
 }
 //#endregion
 //#region src/api-notifications/services/NotificationService.d.ts
-declare const notificationServiceEnvSchema: alepha122.TObject<{
-  NOTIFICATION_QUEUE: alepha122.TOptional<alepha122.TBoolean>;
+declare const notificationServiceEnvSchema: alepha1.TObject<{
+  NOTIFICATION_QUEUE: alepha1.TOptional<alepha1.TBoolean>;
 }>;
 declare module "alepha" {
   interface Env extends Partial<Static<typeof notificationServiceEnvSchema>> {}
@@ -108,71 +103,71 @@ declare class NotificationService {
   protected readonly env: {
     NOTIFICATION_QUEUE?: boolean | undefined;
   };
-  protected readonly notificationRepository: alepha_orm50.Repository<alepha122.TObject<{
-    id: alepha_orm50.PgAttr<alepha_orm50.PgAttr<alepha122.TString, typeof alepha_orm50.PG_PRIMARY_KEY>, typeof alepha_orm50.PG_DEFAULT>;
-    version: alepha_orm50.PgAttr<alepha_orm50.PgAttr<alepha122.TInteger, typeof alepha_orm50.PG_VERSION>, typeof alepha_orm50.PG_DEFAULT>;
-    createdAt: alepha_orm50.PgAttr<alepha_orm50.PgAttr<alepha122.TString, typeof alepha_orm50.PG_CREATED_AT>, typeof alepha_orm50.PG_DEFAULT>;
-    updatedAt: alepha_orm50.PgAttr<alepha_orm50.PgAttr<alepha122.TString, typeof alepha_orm50.PG_UPDATED_AT>, typeof alepha_orm50.PG_DEFAULT>;
-    type: alepha122.TUnsafe<"email" | "sms">;
-    template: alepha122.TString;
-    category: alepha122.TOptional<alepha122.TString>;
-    critical: alepha122.TOptional<alepha122.TBoolean>;
-    sensitive: alepha122.TOptional<alepha122.TBoolean>;
-    contact: alepha122.TString;
-    variables: alepha122.TOptional<alepha122.TRecord<"^.*$", alepha122.TAny>>;
-    scheduledAt: alepha122.TOptional<alepha122.TString>;
-    sentAt: alepha122.TOptional<alepha122.TString>;
-    error: alepha122.TOptional<alepha122.TObject<{
-      at: alepha122.TString;
-      name: alepha122.TString;
-      message: alepha122.TString;
+  protected readonly notificationRepository: alepha_orm0.Repository<alepha1.TObject<{
+    id: alepha_orm0.PgAttr<alepha_orm0.PgAttr<alepha1.TString, typeof alepha_orm0.PG_PRIMARY_KEY>, typeof alepha_orm0.PG_DEFAULT>;
+    version: alepha_orm0.PgAttr<alepha_orm0.PgAttr<alepha1.TInteger, typeof alepha_orm0.PG_VERSION>, typeof alepha_orm0.PG_DEFAULT>;
+    createdAt: alepha_orm0.PgAttr<alepha_orm0.PgAttr<alepha1.TString, typeof alepha_orm0.PG_CREATED_AT>, typeof alepha_orm0.PG_DEFAULT>;
+    updatedAt: alepha_orm0.PgAttr<alepha_orm0.PgAttr<alepha1.TString, typeof alepha_orm0.PG_UPDATED_AT>, typeof alepha_orm0.PG_DEFAULT>;
+    type: alepha1.TUnsafe<"email" | "sms">;
+    template: alepha1.TString;
+    category: alepha1.TOptional<alepha1.TString>;
+    critical: alepha1.TOptional<alepha1.TBoolean>;
+    sensitive: alepha1.TOptional<alepha1.TBoolean>;
+    contact: alepha1.TString;
+    variables: alepha1.TOptional<alepha1.TRecord<"^.*$", alepha1.TAny>>;
+    scheduledAt: alepha1.TOptional<alepha1.TString>;
+    sentAt: alepha1.TOptional<alepha1.TString>;
+    error: alepha1.TOptional<alepha1.TObject<{
+      at: alepha1.TString;
+      name: alepha1.TString;
+      message: alepha1.TString;
     }>>;
   }>>;
   protected readonly dateTimeProvider: DateTimeProvider;
   protected readonly notificationSenderService: NotificationSenderService;
-  readonly notificationBatch: alepha_batch0.BatchDescriptor<alepha122.TObject<{
-    type: alepha122.TUnsafe<"email" | "sms">;
-    template: alepha122.TString;
-    contact: alepha122.TString;
-    variables: alepha122.TOptional<alepha122.TRecord<"^.*$", alepha122.TAny>>;
+  readonly notificationBatch: alepha_batch0.BatchPrimitive<alepha1.TObject<{
+    type: alepha1.TUnsafe<"email" | "sms">;
+    template: alepha1.TString;
+    contact: alepha1.TString;
+    variables: alepha1.TOptional<alepha1.TRecord<"^.*$", alepha1.TAny>>;
   }>, Promise<void>>;
-  findNotificationById(id: string): Promise<alepha_orm50.PgStatic<alepha122.TObject<{
-    id: alepha_orm50.PgAttr<alepha_orm50.PgAttr<alepha122.TString, typeof alepha_orm50.PG_PRIMARY_KEY>, typeof alepha_orm50.PG_DEFAULT>;
-    version: alepha_orm50.PgAttr<alepha_orm50.PgAttr<alepha122.TInteger, typeof alepha_orm50.PG_VERSION>, typeof alepha_orm50.PG_DEFAULT>;
-    createdAt: alepha_orm50.PgAttr<alepha_orm50.PgAttr<alepha122.TString, typeof alepha_orm50.PG_CREATED_AT>, typeof alepha_orm50.PG_DEFAULT>;
-    updatedAt: alepha_orm50.PgAttr<alepha_orm50.PgAttr<alepha122.TString, typeof alepha_orm50.PG_UPDATED_AT>, typeof alepha_orm50.PG_DEFAULT>;
-    type: alepha122.TUnsafe<"email" | "sms">;
-    template: alepha122.TString;
-    category: alepha122.TOptional<alepha122.TString>;
-    critical: alepha122.TOptional<alepha122.TBoolean>;
-    sensitive: alepha122.TOptional<alepha122.TBoolean>;
-    contact: alepha122.TString;
-    variables: alepha122.TOptional<alepha122.TRecord<"^.*$", alepha122.TAny>>;
-    scheduledAt: alepha122.TOptional<alepha122.TString>;
-    sentAt: alepha122.TOptional<alepha122.TString>;
-    error: alepha122.TOptional<alepha122.TObject<{
-      at: alepha122.TString;
-      name: alepha122.TString;
-      message: alepha122.TString;
+  findNotificationById(id: string): Promise<alepha_orm0.PgStatic<alepha1.TObject<{
+    id: alepha_orm0.PgAttr<alepha_orm0.PgAttr<alepha1.TString, typeof alepha_orm0.PG_PRIMARY_KEY>, typeof alepha_orm0.PG_DEFAULT>;
+    version: alepha_orm0.PgAttr<alepha_orm0.PgAttr<alepha1.TInteger, typeof alepha_orm0.PG_VERSION>, typeof alepha_orm0.PG_DEFAULT>;
+    createdAt: alepha_orm0.PgAttr<alepha_orm0.PgAttr<alepha1.TString, typeof alepha_orm0.PG_CREATED_AT>, typeof alepha_orm0.PG_DEFAULT>;
+    updatedAt: alepha_orm0.PgAttr<alepha_orm0.PgAttr<alepha1.TString, typeof alepha_orm0.PG_UPDATED_AT>, typeof alepha_orm0.PG_DEFAULT>;
+    type: alepha1.TUnsafe<"email" | "sms">;
+    template: alepha1.TString;
+    category: alepha1.TOptional<alepha1.TString>;
+    critical: alepha1.TOptional<alepha1.TBoolean>;
+    sensitive: alepha1.TOptional<alepha1.TBoolean>;
+    contact: alepha1.TString;
+    variables: alepha1.TOptional<alepha1.TRecord<"^.*$", alepha1.TAny>>;
+    scheduledAt: alepha1.TOptional<alepha1.TString>;
+    sentAt: alepha1.TOptional<alepha1.TString>;
+    error: alepha1.TOptional<alepha1.TObject<{
+      at: alepha1.TString;
+      name: alepha1.TString;
+      message: alepha1.TString;
     }>>;
-  }>, alepha_orm50.PgRelationMap<alepha122.TObject<{
-    id: alepha_orm50.PgAttr<alepha_orm50.PgAttr<alepha122.TString, typeof alepha_orm50.PG_PRIMARY_KEY>, typeof alepha_orm50.PG_DEFAULT>;
-    version: alepha_orm50.PgAttr<alepha_orm50.PgAttr<alepha122.TInteger, typeof alepha_orm50.PG_VERSION>, typeof alepha_orm50.PG_DEFAULT>;
-    createdAt: alepha_orm50.PgAttr<alepha_orm50.PgAttr<alepha122.TString, typeof alepha_orm50.PG_CREATED_AT>, typeof alepha_orm50.PG_DEFAULT>;
-    updatedAt: alepha_orm50.PgAttr<alepha_orm50.PgAttr<alepha122.TString, typeof alepha_orm50.PG_UPDATED_AT>, typeof alepha_orm50.PG_DEFAULT>;
-    type: alepha122.TUnsafe<"email" | "sms">;
-    template: alepha122.TString;
-    category: alepha122.TOptional<alepha122.TString>;
-    critical: alepha122.TOptional<alepha122.TBoolean>;
-    sensitive: alepha122.TOptional<alepha122.TBoolean>;
-    contact: alepha122.TString;
-    variables: alepha122.TOptional<alepha122.TRecord<"^.*$", alepha122.TAny>>;
-    scheduledAt: alepha122.TOptional<alepha122.TString>;
-    sentAt: alepha122.TOptional<alepha122.TString>;
-    error: alepha122.TOptional<alepha122.TObject<{
-      at: alepha122.TString;
-      name: alepha122.TString;
-      message: alepha122.TString;
+  }>, alepha_orm0.PgRelationMap<alepha1.TObject<{
+    id: alepha_orm0.PgAttr<alepha_orm0.PgAttr<alepha1.TString, typeof alepha_orm0.PG_PRIMARY_KEY>, typeof alepha_orm0.PG_DEFAULT>;
+    version: alepha_orm0.PgAttr<alepha_orm0.PgAttr<alepha1.TInteger, typeof alepha_orm0.PG_VERSION>, typeof alepha_orm0.PG_DEFAULT>;
+    createdAt: alepha_orm0.PgAttr<alepha_orm0.PgAttr<alepha1.TString, typeof alepha_orm0.PG_CREATED_AT>, typeof alepha_orm0.PG_DEFAULT>;
+    updatedAt: alepha_orm0.PgAttr<alepha_orm0.PgAttr<alepha1.TString, typeof alepha_orm0.PG_UPDATED_AT>, typeof alepha_orm0.PG_DEFAULT>;
+    type: alepha1.TUnsafe<"email" | "sms">;
+    template: alepha1.TString;
+    category: alepha1.TOptional<alepha1.TString>;
+    critical: alepha1.TOptional<alepha1.TBoolean>;
+    sensitive: alepha1.TOptional<alepha1.TBoolean>;
+    contact: alepha1.TString;
+    variables: alepha1.TOptional<alepha1.TRecord<"^.*$", alepha1.TAny>>;
+    scheduledAt: alepha1.TOptional<alepha1.TString>;
+    sentAt: alepha1.TOptional<alepha1.TString>;
+    error: alepha1.TOptional<alepha1.TObject<{
+      at: alepha1.TString;
+      name: alepha1.TString;
+      message: alepha1.TString;
     }>>;
   }>>>>;
   /**
@@ -181,9 +176,9 @@ declare class NotificationService {
   createNotification(entry: NotificationCreate): Promise<void>;
 }
 //#endregion
-//#region src/api-notifications/descriptors/$notification.d.ts
+//#region src/api-notifications/primitives/$notification.d.ts
 /**
- * Creates a notification descriptor for managing email/SMS notification templates.
+ * Creates a notification primitive for managing email/SMS notification templates.
  *
  * Provides type-safe, reusable notification templates with multi-language support,
  * variable substitution, and categorization for different notification channels.
@@ -211,10 +206,10 @@ declare class NotificationService {
  * ```
  */
 declare const $notification: {
-  <T extends TObject>(options: NotificationDescriptorOptions<T>): NotificationDescriptor<T>;
-  [KIND]: typeof NotificationDescriptor;
+  <T extends TObject>(options: NotificationPrimitiveOptions<T>): NotificationPrimitive<T>;
+  [KIND]: typeof NotificationPrimitive;
 };
-interface NotificationDescriptorOptions<T extends TObject> extends NotificationMessage<T> {
+interface NotificationPrimitiveOptions<T extends TObject> extends NotificationMessage<T> {
   name?: string;
   description?: string;
   category?: string;
@@ -225,11 +220,11 @@ interface NotificationDescriptorOptions<T extends TObject> extends NotificationM
   };
   schema: T;
 }
-declare class NotificationDescriptor<T extends TObject> extends Descriptor<NotificationDescriptorOptions<T>> {
+declare class NotificationPrimitive<T extends TObject> extends Primitive<NotificationPrimitiveOptions<T>> {
   protected readonly notificationService: NotificationService;
   get name(): string;
   push(options: NotificationPushOptions<T>): Promise<void>;
-  configure(options: Partial<NotificationDescriptorOptions<T>>): void;
+  configure(options: Partial<NotificationPrimitiveOptions<T>>): void;
 }
 interface NotificationPushOptions<T extends TObject> {
   variables: StaticEncode<T>;
@@ -245,32 +240,18 @@ interface NotificationMessage<T extends TObject> {
   };
 }
 //#endregion
-//#region src/api-notifications/jobs/NotificationJobs.d.ts
-declare class NotificationJobs {}
-//#endregion
-//#region src/api-notifications/providers/MemorySmsProvider.d.ts
-interface SmsRecord {
-  to: string;
-  message: string;
-  sentAt: Date;
-}
-declare class MemorySmsProvider extends SmsProvider {
-  protected records: SmsRecord[];
-  send(options: SmsSendOptions): Promise<void>;
-}
-//#endregion
 //#region src/api-notifications/queues/NotificationQueues.d.ts
 declare class NotificationQueues {
   protected readonly notificationSenderService: NotificationSenderService;
-  readonly processNotification: alepha_queue0.QueueDescriptor<alepha122.TObject<{
-    notificationId: alepha122.TString;
+  readonly processNotification: alepha_queue0.QueuePrimitive<alepha1.TObject<{
+    notificationId: alepha1.TString;
   }>>;
 }
 //#endregion
 //#region src/api-notifications/schemas/notificationContactPreferencesSchema.d.ts
-declare const notificationContactPreferencesSchema: alepha122.TObject<{
-  language: alepha122.TOptional<alepha122.TString>;
-  exclude: alepha122.TArray<alepha122.TString>;
+declare const notificationContactPreferencesSchema: alepha1.TObject<{
+  language: alepha1.TOptional<alepha1.TString>;
+  exclude: alepha1.TArray<alepha1.TString>;
 }>;
 type NotificationContactPreferences = Static<typeof notificationContactPreferencesSchema>;
 //#endregion
@@ -281,9 +262,11 @@ type NotificationContactPreferences = Static<typeof notificationContactPreferenc
  * This module includes notification sending, retrieval, status tracking,
  * and user notification preferences management.
  *
+ * Requires `AlephaSms` module to be loaded for SMS notifications.
+ *
  * @module alepha.api.notifications
  */
-declare const AlephaApiNotifications: alepha122.Service<alepha122.Module>;
+declare const AlephaApiNotifications: alepha1.Service<alepha1.Module>;
 //#endregion
-export { $notification, AlephaApiNotifications, MemorySmsProvider, NotificationContactPreferences, NotificationController, NotificationCreate, NotificationDescriptor, NotificationDescriptorOptions, NotificationEntity, NotificationJobs, NotificationMessage, NotificationPushOptions, NotificationQueues, NotificationSenderService, NotificationService, SmsProvider, SmsRecord, SmsSendOptions, notificationContactPreferencesSchema, notificationCreateSchema, notificationServiceEnvSchema, notifications };
+export { $notification, AlephaApiNotifications, NotificationContactPreferences, NotificationController, NotificationCreate, NotificationEntity, NotificationJobs, NotificationMessage, NotificationPrimitive, NotificationPrimitiveOptions, NotificationPushOptions, NotificationQueues, NotificationSenderService, NotificationService, notificationContactPreferencesSchema, notificationCreateSchema, notificationServiceEnvSchema, notifications };
 //# sourceMappingURL=index.d.ts.map

package/dist/api-notifications/index.js

@@ -1,14 +1,19 @@
-import { $env, $inject, $module, Alepha, AlephaError, Descriptor, KIND, createDescriptor, t } from "alepha";
+import { $env, $inject, $module, Alepha, AlephaError, KIND, Primitive, createPrimitive, t } from "alepha";
 import { $batch } from "alepha/batch";
 import { DateTimeProvider } from "alepha/datetime";
 import { $logger } from "alepha/logger";
 import { $entity, $repository, pg } from "alepha/orm";
 import { $queue } from "alepha/queue";
 import { EmailProvider } from "alepha/email";
+import { SmsProvider } from "alepha/sms";
 
 //#region src/api-notifications/controllers/NotificationController.ts
 var NotificationController = class {};
 
+//#endregion
+//#region src/api-notifications/jobs/NotificationJobs.ts
+var NotificationJobs = class {};
+
 //#endregion
 //#region src/api-notifications/entities/notifications.ts
 const notifications = $entity({
@@ -35,10 +40,6 @@ const notifications = $entity({
 	})
 });
 
-//#endregion
-//#region src/api-notifications/providers/SmsProvider.ts
-var SmsProvider = class {};
-
 //#endregion
 //#region src/api-notifications/services/NotificationSenderService.ts
 var NotificationSenderService = class {
@@ -151,7 +152,7 @@ var NotificationSenderService = class {
 	load(notification) {
 		const variables = notification.variables || {};
 		const contact = notification.contact;
-		const template = this.alepha.descriptors($notification).find((it) => it.name === notification.template);
+		const template = this.alepha.primitives($notification).find((it) => it.name === notification.template);
 		if (!template) {
 			this.log.error("Notification template not found", {
 				id: notification.id,
@@ -256,9 +257,9 @@ var NotificationService = class {
 };
 
 //#endregion
-//#region src/api-notifications/descriptors/$notification.ts
+//#region src/api-notifications/primitives/$notification.ts
 /**
-* Creates a notification descriptor for managing email/SMS notification templates.
+* Creates a notification primitive for managing email/SMS notification templates.
 *
 * Provides type-safe, reusable notification templates with multi-language support,
 * variable substitution, and categorization for different notification channels.
@@ -285,8 +286,8 @@ var NotificationService = class {
 * }
 * ```
 */
-const $notification = (options) => createDescriptor(NotificationDescriptor, options);
-var NotificationDescriptor = class extends Descriptor {
+const $notification = (options) => createPrimitive(NotificationPrimitive, options);
+var NotificationPrimitive = class extends Primitive {
 	notificationService = $inject(NotificationService);
 	get name() {
 		return this.options.name ?? `${this.config.propertyKey}`;
@@ -302,25 +303,7 @@ var NotificationDescriptor = class extends Descriptor {
 		Object.assign(this.options, options);
 	}
 };
-$notification[KIND] = NotificationDescriptor;
-
-//#endregion
-//#region src/api-notifications/jobs/NotificationJobs.ts
-var NotificationJobs = class {};
-
-//#endregion
-//#region src/api-notifications/providers/MemorySmsProvider.ts
-var MemorySmsProvider = class extends SmsProvider {
-	records = [];
-	async send(options) {
-		const { to, message } = options;
-		this.records.push({
-			to,
-			message,
-			sentAt: /* @__PURE__ */ new Date()
-		});
-	}
-};
+$notification[KIND] = NotificationPrimitive;
 
 //#endregion
 //#region src/api-notifications/schemas/notificationContactPreferencesSchema.ts
@@ -337,31 +320,26 @@ const notificationContactPreferencesSchema = t.object({
 * This module includes notification sending, retrieval, status tracking,
 * and user notification preferences management.
 *
+* Requires `AlephaSms` module to be loaded for SMS notifications.
+*
 * @module alepha.api.notifications
 */
 const AlephaApiNotifications = $module({
 	name: "alepha.api.notifications",
-	descriptors: [$notification],
+	primitives: [$notification],
 	services: [
 		NotificationController,
 		NotificationService,
 		NotificationSenderService,
 		NotificationQueues,
-		NotificationJobs,
-		SmsProvider,
-		MemorySmsProvider
+		NotificationJobs
 	],
 	register: (alepha) => {
-		alepha.with({
-			optional: true,
-			provide: SmsProvider,
-			use: MemorySmsProvider
-		});
 		if (alepha.parseEnv(notificationServiceEnvSchema).NOTIFICATION_QUEUE) alepha.with(NotificationQueues);
 		alepha.with(NotificationController).with(NotificationService).with(NotificationSenderService).with(NotificationJobs);
 	}
 });
 
 //#endregion
-export { $notification, AlephaApiNotifications, MemorySmsProvider, NotificationController, NotificationDescriptor, NotificationJobs, NotificationQueues, NotificationSenderService, NotificationService, SmsProvider, notificationContactPreferencesSchema, notificationCreateSchema, notificationServiceEnvSchema, notifications };
+export { $notification, AlephaApiNotifications, NotificationController, NotificationJobs, NotificationPrimitive, NotificationQueues, NotificationSenderService, NotificationService, notificationContactPreferencesSchema, notificationCreateSchema, notificationServiceEnvSchema, notifications };
 //# sourceMappingURL=index.js.map