alepha 0.13.0 → 0.13.2

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

package/dist/api-notifications/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["notifications"],"sources":["../../src/api-notifications/controllers/NotificationController.ts","../../src/api-notifications/entities/notifications.ts","../../src/api-notifications/providers/SmsProvider.ts","../../src/api-notifications/services/NotificationSenderService.ts","../../src/api-notifications/queues/NotificationQueues.ts","../../src/api-notifications/schemas/notificationCreateSchema.ts","../../src/api-notifications/services/NotificationService.ts","../../src/api-notifications/descriptors/$notification.ts","../../src/api-notifications/jobs/NotificationJobs.ts","../../src/api-notifications/providers/MemorySmsProvider.ts","../../src/api-notifications/schemas/notificationContactPreferencesSchema.ts","../../src/api-notifications/index.ts"],"sourcesContent":["export class NotificationController {}\n","import { type Static, t } from \"alepha\";\nimport { $entity, pg } from \"alepha/orm\";\n\nexport const notifications = $entity({\n  name: \"notifications\",\n  schema: t.object({\n    id: pg.primaryKey(t.uuid()),\n\n    version: pg.version(),\n\n    createdAt: pg.createdAt(),\n\n    updatedAt: pg.updatedAt(),\n\n    // -----------------------------------------------------------------------------------------------------------------\n\n    type: t.enum([\"email\", \"sms\"]),\n\n    template: t.text(), // e.g. 'resetPassword'\n\n    category: t.optional(\n      t.text({\n        description:\n          \"For grouping related notifications (e.g., 'authentication', 'marketing'). Contact can filter notifications by category.\",\n      }),\n    ),\n\n    critical: t.optional(\n      t.boolean({\n        description:\n          \"Prioritize delivery of this notification. Set to true for important system alerts.\",\n      }),\n    ),\n\n    sensitive: t.optional(\n      t.boolean({\n        description:\n          \"Message won't be logged or stored in plain text. Set to true when notification contains passwords or codes.\",\n      }),\n    ),\n\n    // -----------------------------------------------------------------------------------------------------------------\n\n    contact: t.text(), // e.g. email address or phone number or user ID or whatever\n\n    variables: t.optional(t.record(t.text(), t.any())),\n\n    scheduledAt: t.optional(\n      t.datetime({\n        description:\n          \"When set, the notification will be sent at or after this date/time.\",\n      }),\n    ),\n\n    // -----------------------------------------------------------------------------------------------------------------\n\n    sentAt: t.optional(t.datetime()),\n\n    error: t.optional(\n      t.object({\n        at: t.datetime(),\n        name: t.text(),\n        message: t.text({ size: \"rich\" }),\n      }),\n    ),\n\n    // TODO: retryCount, lastRetryAt, etc.\n  }),\n});\n\nexport type NotificationEntity = Static<typeof notifications.schema>;\n","export abstract class SmsProvider {\n  public abstract send(options: SmsSendOptions): Promise<void>;\n}\n\nexport interface SmsSendOptions {\n  to: string;\n  message: string;\n}\n","import { $inject, Alepha, AlephaError } from \"alepha\";\nimport { DateTimeProvider } from \"alepha/datetime\";\nimport { EmailProvider } from \"alepha/email\";\nimport { $logger } from \"alepha/logger\";\nimport { $repository } from \"alepha/orm\";\nimport { $notification } from \"../descriptors/$notification.ts\";\nimport {\n  type NotificationEntity,\n  notifications,\n} from \"../entities/notifications.ts\";\nimport { SmsProvider } from \"../providers/SmsProvider.ts\";\n\nexport class NotificationSenderService {\n  protected readonly alepha = $inject(Alepha);\n  protected readonly log = $logger();\n  protected readonly notificationRepository = $repository(notifications);\n  protected readonly dateTimeProvider = $inject(DateTimeProvider);\n  protected readonly emailProvider = $inject(EmailProvider);\n  protected readonly smsProvider = $inject(SmsProvider);\n\n  public async send(notificationId: string | NotificationEntity) {\n    this.log.trace(\"Sending notification\", {\n      notificationId:\n        typeof notificationId === \"string\" ? notificationId : notificationId.id,\n    });\n\n    const notification =\n      typeof notificationId === \"string\"\n        ? await this.notificationRepository.findById(notificationId)\n        : notificationId;\n\n    if (notification.sentAt) {\n      this.log.debug(\"Notification already sent\", {\n        notificationId: notification.id,\n        sentAt: notification.sentAt,\n      });\n      return;\n    }\n\n    this.log.debug(\"Processing notification\", {\n      id: notification.id,\n      type: notification.type,\n      template: notification.template,\n      contact: notification.contact,\n    });\n\n    try {\n      if (notification.type === \"email\") {\n        await this.emailProvider.send(this.renderEmail(notification));\n        notification.sentAt = this.dateTimeProvider.nowISOString();\n        this.log.info(\"Email notification sent\", {\n          id: notification.id,\n          template: notification.template,\n          contact: notification.contact,\n        });\n      }\n      if (notification.type === \"sms\") {\n        await this.smsProvider.send(this.renderSms(notification));\n        notification.sentAt = this.dateTimeProvider.nowISOString();\n        this.log.info(\"SMS notification sent\", {\n          id: notification.id,\n          template: notification.template,\n          contact: notification.contact,\n        });\n      }\n    } catch (e) {\n      this.log.error(\"Failed to send notification\", {\n        id: notification.id,\n        type: notification.type,\n        template: notification.template,\n        contact: notification.contact,\n        error: e,\n      });\n      if (e instanceof Error) {\n        notification.error = {\n          at: this.dateTimeProvider.nowISOString(),\n          name: e.name,\n          message: e.message,\n        };\n      }\n    } finally {\n      await this.notificationRepository.save(notification);\n    }\n  }\n\n  public renderSms(notification: NotificationEntity) {\n    this.log.trace(\"Rendering SMS notification\", {\n      id: notification.id,\n      template: notification.template,\n    });\n\n    const { variables, contact, template } = this.load(notification);\n\n    const sms = template.options.sms;\n    if (!sms) {\n      this.log.error(\"Notification template has no SMS defined\", {\n        id: notification.id,\n        template: notification.template,\n      });\n      throw new AlephaError(\n        `Notification template ${notification.template} has no sms defined`,\n      );\n    }\n\n    this.log.debug(\"Rendering SMS\", {\n      template: notification.template,\n      contact,\n    });\n\n    const message =\n      typeof sms.message === \"function\"\n        ? sms.message(variables as any)\n        : sms.message;\n\n    return {\n      to: contact,\n      message,\n    };\n  }\n\n  public renderEmail(notification: NotificationEntity) {\n    this.log.trace(\"Rendering email notification\", {\n      id: notification.id,\n      template: notification.template,\n    });\n\n    const { variables, contact, template } = this.load(notification);\n\n    const email = template.options.email;\n    if (!email) {\n      this.log.error(\"Notification template has no email defined\", {\n        id: notification.id,\n        template: notification.template,\n      });\n      throw new AlephaError(\n        `Notification template ${notification.template} has no email defined`,\n      );\n    }\n\n    this.log.debug(\"Rendering email\", {\n      template: notification.template,\n      contact,\n      subject: email.subject,\n    });\n\n    const subject = email.subject;\n\n    const body =\n      typeof email.body === \"function\"\n        ? email.body(variables as any)\n        : email.body;\n\n    return {\n      to: contact,\n      subject,\n      body,\n    };\n  }\n\n  protected load(notification: NotificationEntity) {\n    const variables = notification.variables || {};\n    const contact = notification.contact;\n    const template = this.alepha\n      .descriptors($notification)\n      .find((it) => it.name === notification.template);\n\n    if (!template) {\n      this.log.error(\"Notification template not found\", {\n        id: notification.id,\n        template: notification.template,\n      });\n      throw new AlephaError(\n        `No notification template found for ${notification.template}`,\n      );\n    }\n\n    return {\n      template,\n      variables,\n      contact,\n    };\n  }\n}\n","import { $inject, t } from \"alepha\";\nimport { $queue } from \"alepha/queue\";\nimport { NotificationSenderService } from \"../services/NotificationSenderService.ts\";\n\nexport class NotificationQueues {\n  protected readonly notificationSenderService = $inject(\n    NotificationSenderService,\n  );\n\n  public readonly processNotification = $queue({\n    description: \"Queue for processing notifications\",\n    schema: t.object({\n      notificationId: t.string({ format: \"uuid\" }),\n    }),\n    handler: async (message) => {\n      await this.notificationSenderService.send(message.payload.notificationId);\n    },\n  });\n}\n","import { type Static, t } from \"alepha\";\nimport { notifications } from \"../entities/notifications.ts\";\n\nexport const notificationCreateSchema = t.pick(notifications.schema, [\n  \"type\",\n  \"contact\",\n  \"template\",\n  \"variables\",\n]);\n\nexport type NotificationCreate = Static<typeof notificationCreateSchema>;\n","import { $env, $inject, Alepha, type Static, t } from \"alepha\";\nimport { $batch } from \"alepha/batch\";\nimport { DateTimeProvider } from \"alepha/datetime\";\nimport { $logger } from \"alepha/logger\";\nimport { $repository } from \"alepha/orm\";\nimport { notifications } from \"../entities/notifications.ts\";\nimport { NotificationQueues } from \"../queues/NotificationQueues.ts\";\nimport {\n  type NotificationCreate,\n  notificationCreateSchema,\n} from \"../schemas/notificationCreateSchema.ts\";\nimport { NotificationSenderService } from \"./NotificationSenderService.ts\";\n\nexport const notificationServiceEnvSchema = t.object({\n  NOTIFICATION_QUEUE: t.optional(\n    t.boolean({\n      description:\n        \"If true, notifications will be queued instead of sent immediately\",\n    }),\n  ),\n});\n\ndeclare module \"alepha\" {\n  interface Env extends Partial<Static<typeof notificationServiceEnvSchema>> {}\n}\n\nexport class NotificationService {\n  protected readonly alepha = $inject(Alepha);\n  protected readonly log = $logger();\n  protected readonly env = $env(notificationServiceEnvSchema);\n  protected readonly notificationRepository = $repository(notifications);\n  protected readonly dateTimeProvider = $inject(DateTimeProvider);\n  protected readonly notificationSenderService = $inject(\n    NotificationSenderService,\n  );\n\n  public readonly notificationBatch = $batch({\n    maxSize: 100,\n    maxDuration: [15, \"seconds\"],\n    schema: notificationCreateSchema,\n    handler: async (notifications: NotificationCreate[]) => {\n      this.log.debug(\"Processing notification batch\", {\n        size: notifications.length,\n        templates: [...new Set(notifications.map((n) => n.template))],\n      });\n\n      const entities =\n        await this.notificationRepository.createMany(notifications);\n\n      await this.alepha\n        .inject(NotificationQueues)\n        .processNotification.push(\n          ...entities.map((it) => ({ notificationId: it.id })),\n        );\n\n      this.log.info(\"Notification batch queued\", {\n        count: entities.length,\n        ids: entities.map((it) => it.id),\n      });\n    },\n  });\n\n  public async findNotificationById(id: string) {\n    this.log.trace(\"Finding notification by ID\", { id });\n    return this.notificationRepository.findOne({ where: { id } });\n  }\n\n  /**\n   * Create a new notification.\n   */\n  public async createNotification(entry: NotificationCreate): Promise<void> {\n    this.log.trace(\"Creating notification\", {\n      template: entry.template,\n      type: entry.type,\n      contact: entry.contact,\n    });\n\n    if (\n      this.env.NOTIFICATION_QUEUE !== true ||\n      this.alepha.isServerless() ||\n      this.alepha.isTest()\n    ) {\n      this.log.debug(\"Sending notification immediately\", {\n        template: entry.template,\n        type: entry.type,\n        contact: entry.contact,\n      });\n      const notification = await this.notificationRepository.create(entry);\n      await this.notificationSenderService.send(notification);\n      return;\n    }\n\n    this.log.debug(\"Queuing notification to batch\", {\n      template: entry.template,\n      type: entry.type,\n      contact: entry.contact,\n    });\n\n    this.notificationBatch.push(entry).catch((e) => {\n      this.log.error(\"Failed to push notification to batch\", {\n        template: entry.template,\n        type: entry.type,\n        contact: entry.contact,\n        error: e,\n      });\n    });\n  }\n}\n","import {\n  $inject,\n  createDescriptor,\n  Descriptor,\n  KIND,\n  type Static,\n  type StaticEncode,\n  type TObject,\n} from \"alepha\";\nimport { NotificationService } from \"../services/NotificationService.ts\";\n\n/**\n * Creates a notification descriptor for managing email/SMS notification templates.\n *\n * Provides type-safe, reusable notification templates with multi-language support,\n * variable substitution, and categorization for different notification channels.\n *\n * @example\n * ```ts\n * class NotificationTemplates {\n *   welcomeEmail = $notification({\n *     name: \"welcome-email\",\n *     category: \"onboarding\",\n *     schema: t.object({ username: t.text(), activationLink: t.text() }),\n *     email: {\n *       subject: \"Welcome to our platform!\",\n *       body: (vars) => `Hello ${vars.username}, click: ${vars.activationLink}`\n *     }\n *   });\n *\n *   async sendWelcome(user: User) {\n *     await this.welcomeEmail.push({\n *       variables: { username: user.name, activationLink: generateLink() },\n *       contact: user.email\n *     });\n *   }\n * }\n * ```\n */\nexport const $notification = <T extends TObject>(\n  options: NotificationDescriptorOptions<T>,\n) => createDescriptor(NotificationDescriptor<T>, options);\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport interface NotificationDescriptorOptions<T extends TObject>\n  extends NotificationMessage<T> {\n  name?: string;\n  description?: string;\n  category?: string;\n  critical?: boolean;\n  sensitive?: boolean;\n  translations?: {\n    // e.g., \"en\", \"fr\", even \"en-US\"\n    [lang: string]: NotificationMessage<T>;\n  };\n  schema: T;\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport class NotificationDescriptor<T extends TObject> extends Descriptor<\n  NotificationDescriptorOptions<T>\n> {\n  protected readonly notificationService = $inject(NotificationService);\n\n  public get name() {\n    return this.options.name ?? `${this.config.propertyKey}`;\n  }\n\n  public async push(options: NotificationPushOptions<T>) {\n    if (this.options.email) {\n      await this.notificationService.createNotification({\n        ...options,\n        type: \"email\",\n        template: this.name,\n      });\n    }\n  }\n\n  public configure(options: Partial<NotificationDescriptorOptions<T>>) {\n    Object.assign(this.options, options);\n  }\n}\n\n$notification[KIND] = NotificationDescriptor;\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport interface NotificationPushOptions<T extends TObject> {\n  variables: StaticEncode<T>;\n  contact: string;\n}\n\nexport interface NotificationMessage<T extends TObject> {\n  email?: {\n    subject: string;\n    body: string | ((variables: Static<T>) => string);\n  };\n  sms?: {\n    message: string | ((variables: Static<T>) => string);\n  };\n}\n","export class NotificationJobs {\n  // - retry (lost, failed) notifications\n  // - purge old notifications\n}\n","import { SmsProvider, type SmsSendOptions } from \"./SmsProvider.ts\";\n\nexport interface SmsRecord {\n  to: string;\n  message: string;\n  sentAt: Date;\n}\n\nexport class MemorySmsProvider extends SmsProvider {\n  protected records: SmsRecord[] = [];\n\n  public async send(options: SmsSendOptions): Promise<void> {\n    const { to, message } = options;\n    this.records.push({\n      to,\n      message,\n      sentAt: new Date(),\n    });\n  }\n}\n","import { type Static, t } from \"alepha\";\n\nexport const notificationContactPreferencesSchema = t.object({\n  language: t.optional(t.text()),\n  exclude: t.array(t.text()),\n});\n\nexport type NotificationContactPreferences = Static<\n  typeof notificationContactPreferencesSchema\n>;\n","import { $module } from \"alepha\";\nimport { NotificationController } from \"./controllers/NotificationController.ts\";\nimport { $notification } from \"./descriptors/$notification.ts\";\nimport { NotificationJobs } from \"./jobs/NotificationJobs.ts\";\nimport { MemorySmsProvider } from \"./providers/MemorySmsProvider.ts\";\nimport { SmsProvider } from \"./providers/SmsProvider.ts\";\nimport { NotificationQueues } from \"./queues/NotificationQueues.ts\";\nimport { NotificationSenderService } from \"./services/NotificationSenderService.ts\";\nimport {\n  NotificationService,\n  notificationServiceEnvSchema,\n} from \"./services/NotificationService.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport * from \"./controllers/NotificationController.ts\";\nexport * from \"./descriptors/$notification.ts\";\nexport * from \"./entities/notifications.ts\";\nexport * from \"./jobs/NotificationJobs.ts\";\nexport * from \"./providers/MemorySmsProvider.ts\";\nexport * from \"./providers/SmsProvider.ts\";\nexport * from \"./queues/NotificationQueues.ts\";\nexport * from \"./schemas/notificationContactPreferencesSchema.ts\";\nexport * from \"./schemas/notificationCreateSchema.ts\";\nexport * from \"./services/NotificationSenderService.ts\";\nexport * from \"./services/NotificationService.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Provides notification management API endpoints for Alepha applications.\n *\n * This module includes notification sending, retrieval, status tracking,\n * and user notification preferences management.\n *\n * @module alepha.api.notifications\n */\nexport const AlephaApiNotifications = $module({\n  name: \"alepha.api.notifications\",\n  descriptors: [$notification],\n  services: [\n    NotificationController,\n    NotificationService,\n    NotificationSenderService,\n    NotificationQueues,\n    NotificationJobs,\n    SmsProvider,\n    MemorySmsProvider,\n  ],\n  register: (alepha) => {\n    alepha.with({\n      optional: true,\n      provide: SmsProvider,\n      use: MemorySmsProvider,\n    });\n\n    const env = alepha.parseEnv(notificationServiceEnvSchema);\n    if (env.NOTIFICATION_QUEUE) {\n      alepha.with(NotificationQueues);\n    }\n\n    alepha\n      .with(NotificationController)\n      .with(NotificationService)\n      .with(NotificationSenderService)\n      .with(NotificationJobs);\n  },\n});\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":["notifications"],"sources":["../../src/api-notifications/controllers/NotificationController.ts","../../src/api-notifications/jobs/NotificationJobs.ts","../../src/api-notifications/entities/notifications.ts","../../src/api-notifications/services/NotificationSenderService.ts","../../src/api-notifications/queues/NotificationQueues.ts","../../src/api-notifications/schemas/notificationCreateSchema.ts","../../src/api-notifications/services/NotificationService.ts","../../src/api-notifications/primitives/$notification.ts","../../src/api-notifications/schemas/notificationContactPreferencesSchema.ts","../../src/api-notifications/index.ts"],"sourcesContent":["export class NotificationController {}\n","export class NotificationJobs {\n  // - retry (lost, failed) notifications\n  // - purge old notifications\n}\n","import { type Static, t } from \"alepha\";\nimport { $entity, pg } from \"alepha/orm\";\n\nexport const notifications = $entity({\n  name: \"notifications\",\n  schema: t.object({\n    id: pg.primaryKey(t.uuid()),\n\n    version: pg.version(),\n\n    createdAt: pg.createdAt(),\n\n    updatedAt: pg.updatedAt(),\n\n    // -----------------------------------------------------------------------------------------------------------------\n\n    type: t.enum([\"email\", \"sms\"]),\n\n    template: t.text(), // e.g. 'resetPassword'\n\n    category: t.optional(\n      t.text({\n        description:\n          \"For grouping related notifications (e.g., 'authentication', 'marketing'). Contact can filter notifications by category.\",\n      }),\n    ),\n\n    critical: t.optional(\n      t.boolean({\n        description:\n          \"Prioritize delivery of this notification. Set to true for important system alerts.\",\n      }),\n    ),\n\n    sensitive: t.optional(\n      t.boolean({\n        description:\n          \"Message won't be logged or stored in plain text. Set to true when notification contains passwords or codes.\",\n      }),\n    ),\n\n    // -----------------------------------------------------------------------------------------------------------------\n\n    contact: t.text(), // e.g. email address or phone number or user ID or whatever\n\n    variables: t.optional(t.record(t.text(), t.any())),\n\n    scheduledAt: t.optional(\n      t.datetime({\n        description:\n          \"When set, the notification will be sent at or after this date/time.\",\n      }),\n    ),\n\n    // -----------------------------------------------------------------------------------------------------------------\n\n    sentAt: t.optional(t.datetime()),\n\n    error: t.optional(\n      t.object({\n        at: t.datetime(),\n        name: t.text(),\n        message: t.text({ size: \"rich\" }),\n      }),\n    ),\n\n    // TODO: retryCount, lastRetryAt, etc.\n  }),\n});\n\nexport type NotificationEntity = Static<typeof notifications.schema>;\n","import { $inject, Alepha, AlephaError } from \"alepha\";\nimport { DateTimeProvider } from \"alepha/datetime\";\nimport { EmailProvider } from \"alepha/email\";\nimport { $logger } from \"alepha/logger\";\nimport { $repository } from \"alepha/orm\";\nimport { SmsProvider } from \"alepha/sms\";\nimport {\n  type NotificationEntity,\n  notifications,\n} from \"../entities/notifications.ts\";\nimport { $notification } from \"../primitives/$notification.ts\";\n\nexport class NotificationSenderService {\n  protected readonly alepha = $inject(Alepha);\n  protected readonly log = $logger();\n  protected readonly notificationRepository = $repository(notifications);\n  protected readonly dateTimeProvider = $inject(DateTimeProvider);\n  protected readonly emailProvider = $inject(EmailProvider);\n  protected readonly smsProvider = $inject(SmsProvider);\n\n  public async send(notificationId: string | NotificationEntity) {\n    this.log.trace(\"Sending notification\", {\n      notificationId:\n        typeof notificationId === \"string\" ? notificationId : notificationId.id,\n    });\n\n    const notification =\n      typeof notificationId === \"string\"\n        ? await this.notificationRepository.findById(notificationId)\n        : notificationId;\n\n    if (notification.sentAt) {\n      this.log.debug(\"Notification already sent\", {\n        notificationId: notification.id,\n        sentAt: notification.sentAt,\n      });\n      return;\n    }\n\n    this.log.debug(\"Processing notification\", {\n      id: notification.id,\n      type: notification.type,\n      template: notification.template,\n      contact: notification.contact,\n    });\n\n    try {\n      if (notification.type === \"email\") {\n        await this.emailProvider.send(this.renderEmail(notification));\n        notification.sentAt = this.dateTimeProvider.nowISOString();\n        this.log.info(\"Email notification sent\", {\n          id: notification.id,\n          template: notification.template,\n          contact: notification.contact,\n        });\n      }\n      if (notification.type === \"sms\") {\n        await this.smsProvider.send(this.renderSms(notification));\n        notification.sentAt = this.dateTimeProvider.nowISOString();\n        this.log.info(\"SMS notification sent\", {\n          id: notification.id,\n          template: notification.template,\n          contact: notification.contact,\n        });\n      }\n    } catch (e) {\n      this.log.error(\"Failed to send notification\", {\n        id: notification.id,\n        type: notification.type,\n        template: notification.template,\n        contact: notification.contact,\n        error: e,\n      });\n      if (e instanceof Error) {\n        notification.error = {\n          at: this.dateTimeProvider.nowISOString(),\n          name: e.name,\n          message: e.message,\n        };\n      }\n    } finally {\n      await this.notificationRepository.save(notification);\n    }\n  }\n\n  public renderSms(notification: NotificationEntity) {\n    this.log.trace(\"Rendering SMS notification\", {\n      id: notification.id,\n      template: notification.template,\n    });\n\n    const { variables, contact, template } = this.load(notification);\n\n    const sms = template.options.sms;\n    if (!sms) {\n      this.log.error(\"Notification template has no SMS defined\", {\n        id: notification.id,\n        template: notification.template,\n      });\n      throw new AlephaError(\n        `Notification template ${notification.template} has no sms defined`,\n      );\n    }\n\n    this.log.debug(\"Rendering SMS\", {\n      template: notification.template,\n      contact,\n    });\n\n    const message =\n      typeof sms.message === \"function\"\n        ? sms.message(variables as any)\n        : sms.message;\n\n    return {\n      to: contact,\n      message,\n    };\n  }\n\n  public renderEmail(notification: NotificationEntity) {\n    this.log.trace(\"Rendering email notification\", {\n      id: notification.id,\n      template: notification.template,\n    });\n\n    const { variables, contact, template } = this.load(notification);\n\n    const email = template.options.email;\n    if (!email) {\n      this.log.error(\"Notification template has no email defined\", {\n        id: notification.id,\n        template: notification.template,\n      });\n      throw new AlephaError(\n        `Notification template ${notification.template} has no email defined`,\n      );\n    }\n\n    this.log.debug(\"Rendering email\", {\n      template: notification.template,\n      contact,\n      subject: email.subject,\n    });\n\n    const subject = email.subject;\n\n    const body =\n      typeof email.body === \"function\"\n        ? email.body(variables as any)\n        : email.body;\n\n    return {\n      to: contact,\n      subject,\n      body,\n    };\n  }\n\n  protected load(notification: NotificationEntity) {\n    const variables = notification.variables || {};\n    const contact = notification.contact;\n    const template = this.alepha\n      .primitives($notification)\n      .find((it) => it.name === notification.template);\n\n    if (!template) {\n      this.log.error(\"Notification template not found\", {\n        id: notification.id,\n        template: notification.template,\n      });\n      throw new AlephaError(\n        `No notification template found for ${notification.template}`,\n      );\n    }\n\n    return {\n      template,\n      variables,\n      contact,\n    };\n  }\n}\n","import { $inject, t } from \"alepha\";\nimport { $queue } from \"alepha/queue\";\nimport { NotificationSenderService } from \"../services/NotificationSenderService.ts\";\n\nexport class NotificationQueues {\n  protected readonly notificationSenderService = $inject(\n    NotificationSenderService,\n  );\n\n  public readonly processNotification = $queue({\n    description: \"Queue for processing notifications\",\n    schema: t.object({\n      notificationId: t.string({ format: \"uuid\" }),\n    }),\n    handler: async (message) => {\n      await this.notificationSenderService.send(message.payload.notificationId);\n    },\n  });\n}\n","import { type Static, t } from \"alepha\";\nimport { notifications } from \"../entities/notifications.ts\";\n\nexport const notificationCreateSchema = t.pick(notifications.schema, [\n  \"type\",\n  \"contact\",\n  \"template\",\n  \"variables\",\n]);\n\nexport type NotificationCreate = Static<typeof notificationCreateSchema>;\n","import { $env, $inject, Alepha, type Static, t } from \"alepha\";\nimport { $batch } from \"alepha/batch\";\nimport { DateTimeProvider } from \"alepha/datetime\";\nimport { $logger } from \"alepha/logger\";\nimport { $repository } from \"alepha/orm\";\nimport { notifications } from \"../entities/notifications.ts\";\nimport { NotificationQueues } from \"../queues/NotificationQueues.ts\";\nimport {\n  type NotificationCreate,\n  notificationCreateSchema,\n} from \"../schemas/notificationCreateSchema.ts\";\nimport { NotificationSenderService } from \"./NotificationSenderService.ts\";\n\nexport const notificationServiceEnvSchema = t.object({\n  NOTIFICATION_QUEUE: t.optional(\n    t.boolean({\n      description:\n        \"If true, notifications will be queued instead of sent immediately\",\n    }),\n  ),\n});\n\ndeclare module \"alepha\" {\n  interface Env extends Partial<Static<typeof notificationServiceEnvSchema>> {}\n}\n\nexport class NotificationService {\n  protected readonly alepha = $inject(Alepha);\n  protected readonly log = $logger();\n  protected readonly env = $env(notificationServiceEnvSchema);\n  protected readonly notificationRepository = $repository(notifications);\n  protected readonly dateTimeProvider = $inject(DateTimeProvider);\n  protected readonly notificationSenderService = $inject(\n    NotificationSenderService,\n  );\n\n  public readonly notificationBatch = $batch({\n    maxSize: 100,\n    maxDuration: [15, \"seconds\"],\n    schema: notificationCreateSchema,\n    handler: async (notifications: NotificationCreate[]) => {\n      this.log.debug(\"Processing notification batch\", {\n        size: notifications.length,\n        templates: [...new Set(notifications.map((n) => n.template))],\n      });\n\n      const entities =\n        await this.notificationRepository.createMany(notifications);\n\n      await this.alepha\n        .inject(NotificationQueues)\n        .processNotification.push(\n          ...entities.map((it) => ({ notificationId: it.id })),\n        );\n\n      this.log.info(\"Notification batch queued\", {\n        count: entities.length,\n        ids: entities.map((it) => it.id),\n      });\n    },\n  });\n\n  public async findNotificationById(id: string) {\n    this.log.trace(\"Finding notification by ID\", { id });\n    return this.notificationRepository.findOne({ where: { id } });\n  }\n\n  /**\n   * Create a new notification.\n   */\n  public async createNotification(entry: NotificationCreate): Promise<void> {\n    this.log.trace(\"Creating notification\", {\n      template: entry.template,\n      type: entry.type,\n      contact: entry.contact,\n    });\n\n    if (\n      this.env.NOTIFICATION_QUEUE !== true ||\n      this.alepha.isServerless() ||\n      this.alepha.isTest()\n    ) {\n      this.log.debug(\"Sending notification immediately\", {\n        template: entry.template,\n        type: entry.type,\n        contact: entry.contact,\n      });\n      const notification = await this.notificationRepository.create(entry);\n      await this.notificationSenderService.send(notification);\n      return;\n    }\n\n    this.log.debug(\"Queuing notification to batch\", {\n      template: entry.template,\n      type: entry.type,\n      contact: entry.contact,\n    });\n\n    this.notificationBatch.push(entry).catch((e) => {\n      this.log.error(\"Failed to push notification to batch\", {\n        template: entry.template,\n        type: entry.type,\n        contact: entry.contact,\n        error: e,\n      });\n    });\n  }\n}\n","import {\n  $inject,\n  createPrimitive,\n  KIND,\n  Primitive,\n  type Static,\n  type StaticEncode,\n  type TObject,\n} from \"alepha\";\nimport { NotificationService } from \"../services/NotificationService.ts\";\n\n/**\n * Creates a notification primitive for managing email/SMS notification templates.\n *\n * Provides type-safe, reusable notification templates with multi-language support,\n * variable substitution, and categorization for different notification channels.\n *\n * @example\n * ```ts\n * class NotificationTemplates {\n *   welcomeEmail = $notification({\n *     name: \"welcome-email\",\n *     category: \"onboarding\",\n *     schema: t.object({ username: t.text(), activationLink: t.text() }),\n *     email: {\n *       subject: \"Welcome to our platform!\",\n *       body: (vars) => `Hello ${vars.username}, click: ${vars.activationLink}`\n *     }\n *   });\n *\n *   async sendWelcome(user: User) {\n *     await this.welcomeEmail.push({\n *       variables: { username: user.name, activationLink: generateLink() },\n *       contact: user.email\n *     });\n *   }\n * }\n * ```\n */\nexport const $notification = <T extends TObject>(\n  options: NotificationPrimitiveOptions<T>,\n) => createPrimitive(NotificationPrimitive<T>, options);\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport interface NotificationPrimitiveOptions<T extends TObject>\n  extends NotificationMessage<T> {\n  name?: string;\n  description?: string;\n  category?: string;\n  critical?: boolean;\n  sensitive?: boolean;\n  translations?: {\n    // e.g., \"en\", \"fr\", even \"en-US\"\n    [lang: string]: NotificationMessage<T>;\n  };\n  schema: T;\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport class NotificationPrimitive<T extends TObject> extends Primitive<\n  NotificationPrimitiveOptions<T>\n> {\n  protected readonly notificationService = $inject(NotificationService);\n\n  public get name() {\n    return this.options.name ?? `${this.config.propertyKey}`;\n  }\n\n  public async push(options: NotificationPushOptions<T>) {\n    if (this.options.email) {\n      await this.notificationService.createNotification({\n        ...options,\n        type: \"email\",\n        template: this.name,\n      });\n    }\n  }\n\n  public configure(options: Partial<NotificationPrimitiveOptions<T>>) {\n    Object.assign(this.options, options);\n  }\n}\n\n$notification[KIND] = NotificationPrimitive;\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport interface NotificationPushOptions<T extends TObject> {\n  variables: StaticEncode<T>;\n  contact: string;\n}\n\nexport interface NotificationMessage<T extends TObject> {\n  email?: {\n    subject: string;\n    body: string | ((variables: Static<T>) => string);\n  };\n  sms?: {\n    message: string | ((variables: Static<T>) => string);\n  };\n}\n","import { type Static, t } from \"alepha\";\n\nexport const notificationContactPreferencesSchema = t.object({\n  language: t.optional(t.text()),\n  exclude: t.array(t.text()),\n});\n\nexport type NotificationContactPreferences = Static<\n  typeof notificationContactPreferencesSchema\n>;\n","import { $module } from \"alepha\";\nimport { NotificationController } from \"./controllers/NotificationController.ts\";\nimport { NotificationJobs } from \"./jobs/NotificationJobs.ts\";\nimport { $notification } from \"./primitives/$notification.ts\";\nimport { NotificationQueues } from \"./queues/NotificationQueues.ts\";\nimport { NotificationSenderService } from \"./services/NotificationSenderService.ts\";\nimport {\n  NotificationService,\n  notificationServiceEnvSchema,\n} from \"./services/NotificationService.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport * from \"./controllers/NotificationController.ts\";\nexport * from \"./entities/notifications.ts\";\nexport * from \"./jobs/NotificationJobs.ts\";\nexport * from \"./primitives/$notification.ts\";\nexport * from \"./queues/NotificationQueues.ts\";\nexport * from \"./schemas/notificationContactPreferencesSchema.ts\";\nexport * from \"./schemas/notificationCreateSchema.ts\";\nexport * from \"./services/NotificationSenderService.ts\";\nexport * from \"./services/NotificationService.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Provides notification management API endpoints for Alepha applications.\n *\n * This module includes notification sending, retrieval, status tracking,\n * and user notification preferences management.\n *\n * Requires `AlephaSms` module to be loaded for SMS notifications.\n *\n * @module alepha.api.notifications\n */\nexport const AlephaApiNotifications = $module({\n  name: \"alepha.api.notifications\",\n  primitives: [$notification],\n  services: [\n    NotificationController,\n    NotificationService,\n    NotificationSenderService,\n    NotificationQueues,\n    NotificationJobs,\n  ],\n  register: (alepha) => {\n    const env = alepha.parseEnv(notificationServiceEnvSchema);\n    if (env.NOTIFICATION_QUEUE) {\n      alepha.with(NotificationQueues);\n    }\n\n    alepha\n      .with(NotificationController)\n      .with(NotificationService)\n      .with(NotificationSenderService)\n      .with(NotificationJobs);\n  },\n});\n"],"mappings":"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"}

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

@@ -1,12 +1,25 @@
 import * as alepha1 from "alepha";
-import { Descriptor, Static, TObject } from "alepha";
+import { Primitive, Static, TObject } from "alepha";
 import * as alepha_orm0 from "alepha/orm";
 import { UserAccount } from "alepha/security";
 
-//#region src/api-parameters/descriptors/$config.d.ts
-
+//#region src/api-parameters/entities/parameters.d.ts
+declare const parameters: 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>;
+  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>;
+  name: alepha1.TString;
+  content: alepha1.TRecord<string, alepha1.TAny>;
+  tags: alepha1.TOptional<alepha1.TArray<alepha1.TString>>;
+  creatorId: alepha1.TOptional<alepha1.TString>;
+  creatorName: alepha1.TOptional<alepha1.TString>;
+  activationDate: alepha1.TString;
+}>>;
+type ParameterEntity = Static<typeof parameters.schema>;
+//#endregion
+//#region src/api-parameters/primitives/$config.d.ts
 /**
- * Creates a configuration parameter descriptor for managing application settings.
+ * Creates a configuration parameter primitive for managing application settings.
  *
  * Provides type-safe, versioned configuration with schema validation, default values,
  * and scheduled activation. Useful for feature flags, system parameters, and runtime settings.
@@ -32,13 +45,13 @@ import { UserAccount } from "alepha/security";
  * }
  * ```
  */
-interface ConfigDescriptorOptions<T extends TObject> {
+interface ConfigPrimitiveOptions<T extends TObject> {
   name?: string;
   description?: string;
   schema: T;
   default: Static<T>;
 }
-declare class ConfigDescriptor<T extends TObject> extends Descriptor<ConfigDescriptorOptions<T>> {
+declare class ConfigPrimitive<T extends TObject> extends Primitive<ConfigPrimitiveOptions<T>> {
   get name(): string;
   get schema(): T;
   get current(): Static<T>;
@@ -53,21 +66,7 @@ declare class ConfigDescriptor<T extends TObject> extends Descriptor<ConfigDescr
   }): Promise<void>;
   sub(fn: (curr: Static<T>) => void): void;
 }
-declare const $config: <T extends TObject>(options: ConfigDescriptorOptions<T>) => ConfigDescriptor<T>;
-//#endregion
-//#region src/api-parameters/entities/parameters.d.ts
-declare const parameters: alepha_orm0.EntityDescriptor<alepha1.TObject<{
-  id: alepha_orm0.PgAttr<alepha_orm0.PgAttr<alepha1.TString, typeof alepha_orm0.PG_PRIMARY_KEY>, 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>;
-  name: alepha1.TString;
-  content: alepha1.TRecord<string, alepha1.TAny>;
-  tags: alepha1.TOptional<alepha1.TArray<alepha1.TString>>;
-  creatorId: alepha1.TOptional<alepha1.TString>;
-  creatorName: alepha1.TOptional<alepha1.TString>;
-  activationDate: alepha1.TString;
-}>>;
-type ParameterEntity = Static<typeof parameters.schema>;
+declare const $config: <T extends TObject>(options: ConfigPrimitiveOptions<T>) => ConfigPrimitive<T>;
 //#endregion
 //#region src/api-parameters/index.d.ts
 /**
@@ -80,5 +79,5 @@ type ParameterEntity = Static<typeof parameters.schema>;
  */
 declare const AlephaApiParameters: alepha1.Service<alepha1.Module>;
 //#endregion
-export { $config, AlephaApiParameters, ConfigDescriptor, ConfigDescriptorOptions, ParameterEntity, parameters };
+export { $config, AlephaApiParameters, ConfigPrimitive, ConfigPrimitiveOptions, ParameterEntity, parameters };
 //# sourceMappingURL=index.d.ts.map

package/dist/api-parameters/index.js

@@ -1,8 +1,25 @@
-import { $module, Descriptor, createDescriptor, t } from "alepha";
+import { $module, Primitive, createPrimitive, t } from "alepha";
 import { $entity, pg } from "alepha/orm";
 
-//#region src/api-parameters/descriptors/$config.ts
-var ConfigDescriptor = class extends Descriptor {
+//#region src/api-parameters/entities/parameters.ts
+const parameters = $entity({
+	name: "parameters",
+	schema: t.object({
+		id: pg.primaryKey(t.uuid()),
+		createdAt: pg.createdAt(),
+		updatedAt: pg.updatedAt(),
+		name: t.string(),
+		content: t.json(),
+		tags: t.optional(t.array(t.string())),
+		creatorId: t.optional(t.uuid()),
+		creatorName: t.optional(t.string()),
+		activationDate: t.datetime({ description: "Optional activation date. Default to now. Must be now or later." })
+	})
+});
+
+//#endregion
+//#region src/api-parameters/primitives/$config.ts
+var ConfigPrimitive = class extends Primitive {
 	get name() {
 		return this.options.name || this.config.propertyKey;
 	}
@@ -23,26 +40,9 @@ var ConfigDescriptor = class extends Descriptor {
 	sub(fn) {}
 };
 const $config = (options) => {
-	return createDescriptor(ConfigDescriptor, options);
+	return createPrimitive(ConfigPrimitive, options);
 };
 
-//#endregion
-//#region src/api-parameters/entities/parameters.ts
-const parameters = $entity({
-	name: "parameters",
-	schema: t.object({
-		id: pg.primaryKey(t.uuid()),
-		createdAt: pg.createdAt(),
-		updatedAt: pg.updatedAt(),
-		name: t.string(),
-		content: t.json(),
-		tags: t.optional(t.array(t.string())),
-		creatorId: t.optional(t.uuid()),
-		creatorName: t.optional(t.string()),
-		activationDate: t.datetime({ description: "Optional activation date. Default to now. Must be now or later." })
-	})
-});
-
 //#endregion
 //#region src/api-parameters/index.ts
 /**
@@ -59,5 +59,5 @@ const AlephaApiParameters = $module({
 });
 
 //#endregion
-export { $config, AlephaApiParameters, ConfigDescriptor, parameters };
+export { $config, AlephaApiParameters, ConfigPrimitive, parameters };
 //# sourceMappingURL=index.js.map

package/dist/api-parameters/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../src/api-parameters/descriptors/$config.ts","../../src/api-parameters/entities/parameters.ts","../../src/api-parameters/index.ts"],"sourcesContent":["import {\n  createDescriptor,\n  Descriptor,\n  type Static,\n  type TObject,\n} from \"alepha\";\nimport type { UserAccount } from \"alepha/security\";\n\n/**\n * Creates a configuration parameter descriptor for managing application settings.\n *\n * Provides type-safe, versioned configuration with schema validation, default values,\n * and scheduled activation. Useful for feature flags, system parameters, and runtime settings.\n *\n * @example\n * ```ts\n * class AppConfig {\n *   features = $config({\n *     name: \"feature-flags\",\n *     schema: t.object({\n *       enableBeta: t.boolean(),\n *       maxUploadSize: t.number()\n *     }),\n *     default: { enableBeta: false, maxUploadSize: 10485760 }\n *   });\n *\n *   async updateFeatures() {\n *     await this.features.set(\n *       { enableBeta: true, maxUploadSize: 20971520 },\n *       { user: currentUser, activationDate: tomorrow }\n *     );\n *   }\n * }\n * ```\n */\nexport interface ConfigDescriptorOptions<T extends TObject> {\n  name?: string;\n  description?: string;\n  schema: T;\n  default: Static<T>;\n}\n\nexport class ConfigDescriptor<T extends TObject> extends Descriptor<\n  ConfigDescriptorOptions<T>\n> {\n  public get name() {\n    return this.options.name || this.config.propertyKey;\n  }\n\n  public get schema(): T {\n    return this.options.schema;\n  }\n\n  public get current(): Static<T> {\n    return this.options.default;\n  }\n\n  public get next(): Static<T> | undefined {\n    return undefined;\n  }\n\n  public get<Key extends keyof Static<T>>(key: Key): Static<T>[Key] {\n    return this.current[key];\n  }\n\n  /**\n   * Apply a new configuration object.\n   */\n  public async set(\n    value: Static<T>,\n    options: {\n      user?: UserAccount;\n      activationDate?: Date; // default to now\n    },\n  ): Promise<void> {}\n\n  public sub(fn: (curr: Static<T>) => void): void {}\n}\n\nexport const $config = <T extends TObject>(\n  options: ConfigDescriptorOptions<T>,\n) => {\n  return createDescriptor(ConfigDescriptor<T>, options);\n};\n","import { type Static, t } from \"alepha\";\nimport { $entity, pg } from \"alepha/orm\";\n\nexport const parameters = $entity({\n  name: \"parameters\",\n  schema: t.object({\n    id: pg.primaryKey(t.uuid()),\n\n    createdAt: pg.createdAt(),\n\n    updatedAt: pg.updatedAt(),\n\n    name: t.string(),\n\n    content: t.json(),\n\n    tags: t.optional(t.array(t.string())),\n\n    creatorId: t.optional(t.uuid()),\n\n    creatorName: t.optional(t.string()),\n\n    activationDate: t.datetime({\n      description:\n        \"Optional activation date. Default to now. Must be now or later.\",\n    }),\n  }),\n});\n\nexport type ParameterEntity = Static<typeof parameters.schema>;\n","import { $module } from \"alepha\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport * from \"./descriptors/$config.ts\";\nexport * from \"./entities/parameters.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Provides parameter management API endpoints for Alepha applications.\n *\n * This module includes configuration parameter storage, retrieval,\n * and dynamic application settings management.\n *\n * @module alepha.api.parameters\n */\nexport const AlephaApiParameters = $module({\n  name: \"alepha.api.parameters\",\n  services: [],\n});\n"],"mappings":";;;;AA0CA,IAAa,mBAAb,cAAyD,WAEvD;CACA,IAAW,OAAO;AAChB,SAAO,KAAK,QAAQ,QAAQ,KAAK,OAAO;;CAG1C,IAAW,SAAY;AACrB,SAAO,KAAK,QAAQ;;CAGtB,IAAW,UAAqB;AAC9B,SAAO,KAAK,QAAQ;;CAGtB,IAAW,OAA8B;CAIzC,AAAO,IAAiC,KAA0B;AAChE,SAAO,KAAK,QAAQ;;;;;CAMtB,MAAa,IACX,OACA,SAIe;CAEjB,AAAO,IAAI,IAAqC;;AAGlD,MAAa,WACX,YACG;AACH,QAAO,iBAAiB,kBAAqB,QAAQ;;;;;AC/EvD,MAAa,aAAa,QAAQ;CAChC,MAAM;CACN,QAAQ,EAAE,OAAO;EACf,IAAI,GAAG,WAAW,EAAE,MAAM,CAAC;EAE3B,WAAW,GAAG,WAAW;EAEzB,WAAW,GAAG,WAAW;EAEzB,MAAM,EAAE,QAAQ;EAEhB,SAAS,EAAE,MAAM;EAEjB,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;EAErC,WAAW,EAAE,SAAS,EAAE,MAAM,CAAC;EAE/B,aAAa,EAAE,SAAS,EAAE,QAAQ,CAAC;EAEnC,gBAAgB,EAAE,SAAS,EACzB,aACE,mEACH,CAAC;EACH,CAAC;CACH,CAAC;;;;;;;;;;;;ACVF,MAAa,sBAAsB,QAAQ;CACzC,MAAM;CACN,UAAU,EAAE;CACb,CAAC"}
+{"version":3,"file":"index.js","names":[],"sources":["../../src/api-parameters/entities/parameters.ts","../../src/api-parameters/primitives/$config.ts","../../src/api-parameters/index.ts"],"sourcesContent":["import { type Static, t } from \"alepha\";\nimport { $entity, pg } from \"alepha/orm\";\n\nexport const parameters = $entity({\n  name: \"parameters\",\n  schema: t.object({\n    id: pg.primaryKey(t.uuid()),\n\n    createdAt: pg.createdAt(),\n\n    updatedAt: pg.updatedAt(),\n\n    name: t.string(),\n\n    content: t.json(),\n\n    tags: t.optional(t.array(t.string())),\n\n    creatorId: t.optional(t.uuid()),\n\n    creatorName: t.optional(t.string()),\n\n    activationDate: t.datetime({\n      description:\n        \"Optional activation date. Default to now. Must be now or later.\",\n    }),\n  }),\n});\n\nexport type ParameterEntity = Static<typeof parameters.schema>;\n","import { createPrimitive, Primitive, type Static, type TObject } from \"alepha\";\nimport type { UserAccount } from \"alepha/security\";\n\n/**\n * Creates a configuration parameter primitive for managing application settings.\n *\n * Provides type-safe, versioned configuration with schema validation, default values,\n * and scheduled activation. Useful for feature flags, system parameters, and runtime settings.\n *\n * @example\n * ```ts\n * class AppConfig {\n *   features = $config({\n *     name: \"feature-flags\",\n *     schema: t.object({\n *       enableBeta: t.boolean(),\n *       maxUploadSize: t.number()\n *     }),\n *     default: { enableBeta: false, maxUploadSize: 10485760 }\n *   });\n *\n *   async updateFeatures() {\n *     await this.features.set(\n *       { enableBeta: true, maxUploadSize: 20971520 },\n *       { user: currentUser, activationDate: tomorrow }\n *     );\n *   }\n * }\n * ```\n */\nexport interface ConfigPrimitiveOptions<T extends TObject> {\n  name?: string;\n  description?: string;\n  schema: T;\n  default: Static<T>;\n}\n\nexport class ConfigPrimitive<T extends TObject> extends Primitive<\n  ConfigPrimitiveOptions<T>\n> {\n  public get name() {\n    return this.options.name || this.config.propertyKey;\n  }\n\n  public get schema(): T {\n    return this.options.schema;\n  }\n\n  public get current(): Static<T> {\n    return this.options.default;\n  }\n\n  public get next(): Static<T> | undefined {\n    return undefined;\n  }\n\n  public get<Key extends keyof Static<T>>(key: Key): Static<T>[Key] {\n    return this.current[key];\n  }\n\n  /**\n   * Apply a new configuration object.\n   */\n  public async set(\n    value: Static<T>,\n    options: {\n      user?: UserAccount;\n      activationDate?: Date; // default to now\n    },\n  ): Promise<void> {}\n\n  public sub(fn: (curr: Static<T>) => void): void {}\n}\n\nexport const $config = <T extends TObject>(\n  options: ConfigPrimitiveOptions<T>,\n) => {\n  return createPrimitive(ConfigPrimitive<T>, options);\n};\n","import { $module } from \"alepha\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport * from \"./entities/parameters.ts\";\nexport * from \"./primitives/$config.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Provides parameter management API endpoints for Alepha applications.\n *\n * This module includes configuration parameter storage, retrieval,\n * and dynamic application settings management.\n *\n * @module alepha.api.parameters\n */\nexport const AlephaApiParameters = $module({\n  name: \"alepha.api.parameters\",\n  services: [],\n});\n"],"mappings":";;;;AAGA,MAAa,aAAa,QAAQ;CAChC,MAAM;CACN,QAAQ,EAAE,OAAO;EACf,IAAI,GAAG,WAAW,EAAE,MAAM,CAAC;EAE3B,WAAW,GAAG,WAAW;EAEzB,WAAW,GAAG,WAAW;EAEzB,MAAM,EAAE,QAAQ;EAEhB,SAAS,EAAE,MAAM;EAEjB,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;EAErC,WAAW,EAAE,SAAS,EAAE,MAAM,CAAC;EAE/B,aAAa,EAAE,SAAS,EAAE,QAAQ,CAAC;EAEnC,gBAAgB,EAAE,SAAS,EACzB,aACE,mEACH,CAAC;EACH,CAAC;CACH,CAAC;;;;ACUF,IAAa,kBAAb,cAAwD,UAEtD;CACA,IAAW,OAAO;AAChB,SAAO,KAAK,QAAQ,QAAQ,KAAK,OAAO;;CAG1C,IAAW,SAAY;AACrB,SAAO,KAAK,QAAQ;;CAGtB,IAAW,UAAqB;AAC9B,SAAO,KAAK,QAAQ;;CAGtB,IAAW,OAA8B;CAIzC,AAAO,IAAiC,KAA0B;AAChE,SAAO,KAAK,QAAQ;;;;;CAMtB,MAAa,IACX,OACA,SAIe;CAEjB,AAAO,IAAI,IAAqC;;AAGlD,MAAa,WACX,YACG;AACH,QAAO,gBAAgB,iBAAoB,QAAQ;;;;;;;;;;;;;AC5DrD,MAAa,sBAAsB,QAAQ;CACzC,MAAM;CACN,UAAU,EAAE;CACb,CAAC"}