alepha 0.15.0 → 0.15.2

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

@@ -1 +1 @@
-{"version":3,"file":"index.browser.js","names":["notifications"],"sources":["../../../src/api/notifications/entities/notifications.ts","../../../src/api/notifications/schemas/notificationQuerySchema.ts","../../../src/api/notifications/primitives/$notification.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/controllers/AdminNotificationController.ts","../../../src/api/notifications/schemas/notificationContactPreferencesSchema.ts","../../../src/api/notifications/schemas/notificationContactSchema.ts","../../../src/api/notifications/index.browser.ts"],"sourcesContent":["import { type Static, t } from \"alepha\";\nimport { $entity, db } from \"alepha/orm\";\n\nexport const notifications = $entity({\n  name: \"notifications\",\n  schema: t.object({\n    id: db.primaryKey(t.uuid()),\n\n    version: db.version(),\n\n    createdAt: db.createdAt(),\n\n    updatedAt: db.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 type { Static } from \"alepha\";\nimport { t } from \"alepha\";\nimport { pageQuerySchema } from \"alepha/orm\";\n\nexport const notificationQuerySchema = t.extend(pageQuerySchema, {\n  type: t.optional(t.enum([\"email\", \"sms\"])),\n  template: t.optional(t.string()),\n  contact: t.optional(t.string()),\n  category: t.optional(t.string()),\n  status: t.optional(t.enum([\"pending\", \"sent\", \"failed\"])),\n});\n\nexport type NotificationQuery = Static<typeof notificationQuerySchema>;\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 { $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, type Page } from \"alepha/orm\";\nimport {\n  type NotificationEntity,\n  notifications,\n} from \"../entities/notifications.ts\";\nimport { NotificationQueues } from \"../queues/NotificationQueues.ts\";\nimport {\n  type NotificationCreate,\n  notificationCreateSchema,\n} from \"../schemas/notificationCreateSchema.ts\";\nimport type { NotificationQuery } from \"../schemas/notificationQuerySchema.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  public async findNotifications(\n    q: NotificationQuery = {},\n  ): Promise<Page<NotificationEntity>> {\n    this.log.trace(\"Finding notifications\", { query: q });\n    q.sort ??= \"-createdAt\";\n\n    const where = this.notificationRepository.createQueryWhere();\n\n    if (q.type) {\n      where.type = { eq: q.type };\n    }\n\n    if (q.template) {\n      where.template = { like: `%${q.template}%` };\n    }\n\n    if (q.contact) {\n      where.contact = { like: `%${q.contact}%` };\n    }\n\n    if (q.category) {\n      where.category = { eq: q.category };\n    }\n\n    if (q.status) {\n      if (q.status === \"sent\") {\n        where.sentAt = { isNotNull: true };\n        where.error = { isNull: true };\n      } else if (q.status === \"failed\") {\n        where.error = { isNotNull: true };\n      } else if (q.status === \"pending\") {\n        where.sentAt = { isNull: true };\n        where.error = { isNull: true };\n      }\n    }\n\n    return this.notificationRepository.paginate(q, { where }, { count: true });\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 { $inject, t } from \"alepha\";\nimport { $action } from \"alepha/server\";\nimport { notifications } from \"../entities/notifications.ts\";\nimport { notificationQuerySchema } from \"../schemas/notificationQuerySchema.ts\";\nimport { NotificationService } from \"../services/NotificationService.ts\";\n\nexport class AdminNotificationController {\n  protected readonly url = \"/notifications\";\n  protected readonly group = \"admin:notifications\";\n  protected readonly notificationService = $inject(NotificationService);\n\n  /**\n   * Find notifications with pagination and filtering.\n   */\n  public readonly findNotifications = $action({\n    path: this.url,\n    group: this.group,\n    description: \"Find notifications with pagination and filtering\",\n    schema: {\n      query: notificationQuerySchema,\n      response: t.page(notifications.schema),\n    },\n    handler: ({ query }) => this.notificationService.findNotifications(query),\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 { type Static, t } from \"alepha\";\n\nexport const notificationContactSchema = t.object({\n  email: t.optional(t.email()),\n  phoneNumber: t.optional(t.e164()),\n  firstName: t.optional(t.shortText()),\n  lastName: t.optional(t.text({ size: \"short\" })),\n  language: t.optional(t.bcp47()),\n});\n\nexport type NotificationContact = Static<typeof notificationContactSchema>;\n","import { $module } from \"alepha\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport * from \"./controllers/AdminNotificationController.ts\";\nexport * from \"./entities/notifications.ts\";\nexport * from \"./schemas/notificationContactPreferencesSchema.ts\";\nexport * from \"./schemas/notificationContactSchema.ts\";\nexport * from \"./schemas/notificationCreateSchema.ts\";\nexport * from \"./schemas/notificationQuerySchema.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport const AlephaApiNotifications = $module({\n  name: \"alepha.api.notifications\",\n  services: [],\n});\n"],"mappings":"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"}
+{"version":3,"file":"index.browser.js","names":[],"sources":["../../../src/api/notifications/entities/notifications.ts","../../../src/api/notifications/schemas/notificationQuerySchema.ts","../../../src/api/notifications/primitives/$notification.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/controllers/AdminNotificationController.ts","../../../src/api/notifications/schemas/notificationContactPreferencesSchema.ts","../../../src/api/notifications/schemas/notificationContactSchema.ts","../../../src/api/notifications/index.browser.ts"],"sourcesContent":["import { type Static, t } from \"alepha\";\nimport { $entity, db } from \"alepha/orm\";\n\nexport const notifications = $entity({\n  name: \"notifications\",\n  schema: t.object({\n    id: db.primaryKey(t.uuid()),\n\n    version: db.version(),\n\n    createdAt: db.createdAt(),\n\n    updatedAt: db.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 type { Static } from \"alepha\";\nimport { t } from \"alepha\";\nimport { pageQuerySchema } from \"alepha/orm\";\n\nexport const notificationQuerySchema = t.extend(pageQuerySchema, {\n  type: t.optional(t.enum([\"email\", \"sms\"])),\n  template: t.optional(t.string()),\n  contact: t.optional(t.string()),\n  category: t.optional(t.string()),\n  status: t.optional(t.enum([\"pending\", \"sent\", \"failed\"])),\n});\n\nexport type NotificationQuery = Static<typeof notificationQuerySchema>;\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 { $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, type Page } from \"alepha/orm\";\nimport {\n  type NotificationEntity,\n  notifications,\n} from \"../entities/notifications.ts\";\nimport { NotificationQueues } from \"../queues/NotificationQueues.ts\";\nimport {\n  type NotificationCreate,\n  notificationCreateSchema,\n} from \"../schemas/notificationCreateSchema.ts\";\nimport type { NotificationQuery } from \"../schemas/notificationQuerySchema.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  public async findNotifications(\n    q: NotificationQuery = {},\n  ): Promise<Page<NotificationEntity>> {\n    this.log.trace(\"Finding notifications\", { query: q });\n    q.sort ??= \"-createdAt\";\n\n    const where = this.notificationRepository.createQueryWhere();\n\n    if (q.type) {\n      where.type = { eq: q.type };\n    }\n\n    if (q.template) {\n      where.template = { like: `%${q.template}%` };\n    }\n\n    if (q.contact) {\n      where.contact = { like: `%${q.contact}%` };\n    }\n\n    if (q.category) {\n      where.category = { eq: q.category };\n    }\n\n    if (q.status) {\n      if (q.status === \"sent\") {\n        where.sentAt = { isNotNull: true };\n        where.error = { isNull: true };\n      } else if (q.status === \"failed\") {\n        where.error = { isNotNull: true };\n      } else if (q.status === \"pending\") {\n        where.sentAt = { isNull: true };\n        where.error = { isNull: true };\n      }\n    }\n\n    return this.notificationRepository.paginate(q, { where }, { count: true });\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 { $inject, t } from \"alepha\";\nimport { $action } from \"alepha/server\";\nimport { notifications } from \"../entities/notifications.ts\";\nimport { notificationQuerySchema } from \"../schemas/notificationQuerySchema.ts\";\nimport { NotificationService } from \"../services/NotificationService.ts\";\n\nexport class AdminNotificationController {\n  protected readonly url = \"/notifications\";\n  protected readonly group = \"admin:notifications\";\n  protected readonly notificationService = $inject(NotificationService);\n\n  /**\n   * Find notifications with pagination and filtering.\n   */\n  public readonly findNotifications = $action({\n    path: this.url,\n    group: this.group,\n    description: \"Find notifications with pagination and filtering\",\n    schema: {\n      query: notificationQuerySchema,\n      response: t.page(notifications.schema),\n    },\n    handler: ({ query }) => this.notificationService.findNotifications(query),\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 { type Static, t } from \"alepha\";\n\nexport const notificationContactSchema = t.object({\n  email: t.optional(t.email()),\n  phoneNumber: t.optional(t.e164()),\n  firstName: t.optional(t.shortText()),\n  lastName: t.optional(t.text({ size: \"short\" })),\n  language: t.optional(t.bcp47()),\n});\n\nexport type NotificationContact = Static<typeof notificationContactSchema>;\n","import { $module } from \"alepha\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport * from \"./controllers/AdminNotificationController.ts\";\nexport * from \"./entities/notifications.ts\";\nexport * from \"./schemas/notificationContactPreferencesSchema.ts\";\nexport * from \"./schemas/notificationContactSchema.ts\";\nexport * from \"./schemas/notificationCreateSchema.ts\";\nexport * from \"./schemas/notificationQuerySchema.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport const AlephaApiNotifications = $module({\n  name: \"alepha.api.notifications\",\n  services: [],\n});\n"],"mappings":"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"}

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

@@ -46,114 +46,114 @@ type TObjectUpdate<T extends TObject> = TObject<{ [K in keyof T["properties"]]:
 //#region ../../src/orm/primitives/$entity.d.ts
 interface EntityPrimitiveOptions<T extends TObject, Keys = keyof Static<T>> {
   /**
-       * The database table name that will be created for this entity.
-       * If not provided, name will be inferred from the $repository variable name.
-       */
+   * The database table name that will be created for this entity.
+   * If not provided, name will be inferred from the $repository variable name.
+   */
   name: string;
   /**
-       * TypeBox schema defining the table structure and column types.
-       */
+   * TypeBox schema defining the table structure and column types.
+   */
   schema: T;
   /**
-       * Database indexes to create for query optimization.
-       */
+   * Database indexes to create for query optimization.
+   */
   indexes?: (Keys | {
     /**
-             * Single column to index.
-             */
+     * Single column to index.
+     */
     column: Keys;
     /**
-             * Whether this should be a unique index (enforces uniqueness constraint).
-             */
+     * Whether this should be a unique index (enforces uniqueness constraint).
+     */
     unique?: boolean;
     /**
-             * Custom name for the index. If not provided, generates name automatically.
-             */
+     * Custom name for the index. If not provided, generates name automatically.
+     */
     name?: string;
   } | {
     /**
-             * Multiple columns for composite index (order matters for query optimization).
-             */
+     * Multiple columns for composite index (order matters for query optimization).
+     */
     columns: Keys[];
     /**
-             * Whether this should be a unique index (enforces uniqueness constraint).
-             */
+     * Whether this should be a unique index (enforces uniqueness constraint).
+     */
     unique?: boolean;
     /**
-             * Custom name for the index. If not provided, generates name automatically.
-             */
+     * Custom name for the index. If not provided, generates name automatically.
+     */
     name?: string;
   })[];
   /**
-       * Foreign key constraints to maintain referential integrity.
-       */
+   * Foreign key constraints to maintain referential integrity.
+   */
   foreignKeys?: Array<{
     /**
-             * Optional name for the foreign key constraint.
-             */
+     * Optional name for the foreign key constraint.
+     */
     name?: string;
     /**
-             * Local columns that reference the foreign table.
-             */
+     * Local columns that reference the foreign table.
+     */
     columns: Array<keyof Static<T>>;
     /**
-             * Referenced columns in the foreign table.
-             * Must be EntityColumn references from other entities.
-             */
+     * Referenced columns in the foreign table.
+     * Must be EntityColumn references from other entities.
+     */
     foreignColumns: Array<() => EntityColumn<any>>;
   }>;
   /**
-       * Additional table constraints for data validation.
-       *
-       * Constraints enforce business rules at the database level, providing
-       * an additional layer of data integrity beyond application validation.
-       *
-       * **Constraint Types**:
-       * - **Unique constraints**: Prevent duplicate values across columns
-       * - **Check constraints**: Enforce custom validation rules with SQL expressions
-       *
-       * @example
-       * ```ts
-       * constraints: [
-       *   {
-       *     name: "unique_user_email",
-       *     columns: ["email"],
-       *     unique: true
-       *   },
-       *   {
-       *     name: "valid_age_range",
-       *     columns: ["age"],
-       *     check: sql`age >= 0 AND age <= 150`
-       *   },
-       *   {
-       *     name: "unique_user_username_per_tenant",
-       *     columns: ["tenantId", "username"],
-       *     unique: true
-       *   }
-       * ]
-       * ```
-       */
+   * Additional table constraints for data validation.
+   *
+   * Constraints enforce business rules at the database level, providing
+   * an additional layer of data integrity beyond application validation.
+   *
+   * **Constraint Types**:
+   * - **Unique constraints**: Prevent duplicate values across columns
+   * - **Check constraints**: Enforce custom validation rules with SQL expressions
+   *
+   * @example
+   * ```ts
+   * constraints: [
+   *   {
+   *     name: "unique_user_email",
+   *     columns: ["email"],
+   *     unique: true
+   *   },
+   *   {
+   *     name: "valid_age_range",
+   *     columns: ["age"],
+   *     check: sql`age >= 0 AND age <= 150`
+   *   },
+   *   {
+   *     name: "unique_user_username_per_tenant",
+   *     columns: ["tenantId", "username"],
+   *     unique: true
+   *   }
+   * ]
+   * ```
+   */
   constraints?: Array<{
     /**
-             * Columns involved in this constraint.
-             */
+     * Columns involved in this constraint.
+     */
     columns: Array<keyof Static<T>>;
     /**
-             * Optional name for the constraint.
-             */
+     * Optional name for the constraint.
+     */
     name?: string;
     /**
-             * Whether this is a unique constraint.
-             */
+     * Whether this is a unique constraint.
+     */
     unique?: boolean | {};
     /**
-             * SQL expression for check constraint validation.
-             */
+     * SQL expression for check constraint validation.
+     */
     check?: SQL;
   }>;
   /**
-       * Advanced Drizzle ORM configuration for complex table setups.
-       */
+   * Advanced Drizzle ORM configuration for complex table setups.
+   */
   config?: (self: BuildExtraConfigColumns<string, FromSchema<T>, "pg">) => PgTableExtraConfigValue[];
 }
 declare class EntityPrimitive<T extends TObject = TObject> {
@@ -201,8 +201,8 @@ type PgSymbols = {
   [PG_REF]: PgRefOptions;
   [PG_ENUM]: PgEnumOptions;
   /**
-       * @deprecated Use `PG_IDENTITY` instead.
-       */
+   * @deprecated Use `PG_IDENTITY` instead.
+   */
   [PG_SERIAL]: {};
 };
 type PgSymbolKeys = keyof PgSymbols;
@@ -486,8 +486,8 @@ declare class NotificationService {
   }>>>>;
   findNotifications(q?: NotificationQuery): Promise<Page<NotificationEntity>>;
   /**
-       * Create a new notification.
-       */
+   * Create a new notification.
+   */
   createNotification(entry: NotificationCreate): Promise<void>;
 }
 //#endregion
@@ -497,8 +497,8 @@ declare class AdminNotificationController {
   protected readonly group = "admin:notifications";
   protected readonly notificationService: NotificationService;
   /**
-       * Find notifications with pagination and filtering.
-       */
+   * Find notifications with pagination and filtering.
+   */
   readonly findNotifications: alepha_server0.ActionPrimitiveFn<{
     query: alepha133.TObject<{
       page: alepha133.TOptional<alepha133.TInteger>;
@@ -553,12 +553,18 @@ type NotificationContactPreferences = Static<typeof notificationContactPreferenc
 //#endregion
 //#region ../../src/api/notifications/index.d.ts
 /**
- * Provides notification management API endpoints for Alepha applications.
+ * | type | quality | stability |
+ * |------|---------|-----------|
+ * | backend | standard | stable |
  *
- * This module includes notification sending, retrieval, status tracking,
- * and user notification preferences management.
+ * User notification management.
  *
- * Requires `AlephaSms` module to be loaded for SMS notifications.
+ * **Features:**
+ * - Notification definitions
+ * - Email/SMS notification sending
+ * - Status tracking
+ * - User preferences
+ * - Queue integration
  *
  * @module alepha.api.notifications
  */

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/orm/schemas/insertSchema.ts","../../../src/orm/schemas/updateSchema.ts","../../../src/orm/primitives/$entity.ts","../../../src/orm/constants/PG_SYMBOLS.ts","../../../src/orm/helpers/pgAttr.ts","../../../src/api/notifications/entities/notifications.ts","../../../src/api/notifications/schemas/notificationCreateSchema.ts","../../../src/api/notifications/schemas/notificationQuerySchema.ts","../../../src/api/notifications/primitives/$notification.ts","../../../src/api/notifications/services/NotificationSenderService.ts","../../../src/api/notifications/services/NotificationService.ts","../../../src/api/notifications/controllers/AdminNotificationController.ts","../../../src/api/notifications/jobs/NotificationJobs.ts","../../../src/api/notifications/queues/NotificationQueues.ts","../../../src/api/notifications/schemas/notificationContactPreferencesSchema.ts","../../../src/api/notifications/index.ts"],"mappings":"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"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/orm/schemas/insertSchema.ts","../../../src/orm/schemas/updateSchema.ts","../../../src/orm/primitives/$entity.ts","../../../src/orm/constants/PG_SYMBOLS.ts","../../../src/orm/helpers/pgAttr.ts","../../../src/api/notifications/entities/notifications.ts","../../../src/api/notifications/schemas/notificationCreateSchema.ts","../../../src/api/notifications/schemas/notificationQuerySchema.ts","../../../src/api/notifications/primitives/$notification.ts","../../../src/api/notifications/services/NotificationSenderService.ts","../../../src/api/notifications/services/NotificationService.ts","../../../src/api/notifications/controllers/AdminNotificationController.ts","../../../src/api/notifications/jobs/NotificationJobs.ts","../../../src/api/notifications/queues/NotificationQueues.ts","../../../src/api/notifications/schemas/notificationContactPreferencesSchema.ts","../../../src/api/notifications/index.ts"],"mappings":"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"}

package/dist/api/notifications/index.js

@@ -260,12 +260,12 @@ var NotificationService = class {
 		maxSize: 100,
 		maxDuration: [15, "seconds"],
 		schema: notificationCreateSchema,
-		handler: async (notifications$1) => {
+		handler: async (notifications) => {
 			this.log.debug("Processing notification batch", {
-				size: notifications$1.length,
-				templates: [...new Set(notifications$1.map((n) => n.template))]
+				size: notifications.length,
+				templates: [...new Set(notifications.map((n) => n.template))]
 			});
-			const entities = await this.notificationRepository.createMany(notifications$1);
+			const entities = await this.notificationRepository.createMany(notifications);
 			await this.alepha.inject(NotificationQueues).processNotification.push(...entities.map((it) => ({ notificationId: it.id })));
 			this.log.info("Notification batch queued", {
 				count: entities.length,
@@ -367,12 +367,18 @@ const notificationContactPreferencesSchema = t.object({
 //#endregion
 //#region ../../src/api/notifications/index.ts
 /**
-* Provides notification management API endpoints for Alepha applications.
+* | type | quality | stability |
+* |------|---------|-----------|
+* | backend | standard | stable |
 *
-* This module includes notification sending, retrieval, status tracking,
-* and user notification preferences management.
+* User notification management.
 *
-* Requires `AlephaSms` module to be loaded for SMS notifications.
+* **Features:**
+* - Notification definitions
+* - Email/SMS notification sending
+* - Status tracking
+* - User preferences
+* - Queue integration
 *
 * @module alepha.api.notifications
 */

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["notifications"],"sources":["../../../src/api/notifications/entities/notifications.ts","../../../src/api/notifications/schemas/notificationQuerySchema.ts","../../../src/api/notifications/primitives/$notification.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/controllers/AdminNotificationController.ts","../../../src/api/notifications/jobs/NotificationJobs.ts","../../../src/api/notifications/schemas/notificationContactPreferencesSchema.ts","../../../src/api/notifications/index.ts"],"sourcesContent":["import { type Static, t } from \"alepha\";\nimport { $entity, db } from \"alepha/orm\";\n\nexport const notifications = $entity({\n  name: \"notifications\",\n  schema: t.object({\n    id: db.primaryKey(t.uuid()),\n\n    version: db.version(),\n\n    createdAt: db.createdAt(),\n\n    updatedAt: db.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 type { Static } from \"alepha\";\nimport { t } from \"alepha\";\nimport { pageQuerySchema } from \"alepha/orm\";\n\nexport const notificationQuerySchema = t.extend(pageQuerySchema, {\n  type: t.optional(t.enum([\"email\", \"sms\"])),\n  template: t.optional(t.string()),\n  contact: t.optional(t.string()),\n  category: t.optional(t.string()),\n  status: t.optional(t.enum([\"pending\", \"sent\", \"failed\"])),\n});\n\nexport type NotificationQuery = Static<typeof notificationQuerySchema>;\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 { $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, type Page } from \"alepha/orm\";\nimport {\n  type NotificationEntity,\n  notifications,\n} from \"../entities/notifications.ts\";\nimport { NotificationQueues } from \"../queues/NotificationQueues.ts\";\nimport {\n  type NotificationCreate,\n  notificationCreateSchema,\n} from \"../schemas/notificationCreateSchema.ts\";\nimport type { NotificationQuery } from \"../schemas/notificationQuerySchema.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  public async findNotifications(\n    q: NotificationQuery = {},\n  ): Promise<Page<NotificationEntity>> {\n    this.log.trace(\"Finding notifications\", { query: q });\n    q.sort ??= \"-createdAt\";\n\n    const where = this.notificationRepository.createQueryWhere();\n\n    if (q.type) {\n      where.type = { eq: q.type };\n    }\n\n    if (q.template) {\n      where.template = { like: `%${q.template}%` };\n    }\n\n    if (q.contact) {\n      where.contact = { like: `%${q.contact}%` };\n    }\n\n    if (q.category) {\n      where.category = { eq: q.category };\n    }\n\n    if (q.status) {\n      if (q.status === \"sent\") {\n        where.sentAt = { isNotNull: true };\n        where.error = { isNull: true };\n      } else if (q.status === \"failed\") {\n        where.error = { isNotNull: true };\n      } else if (q.status === \"pending\") {\n        where.sentAt = { isNull: true };\n        where.error = { isNull: true };\n      }\n    }\n\n    return this.notificationRepository.paginate(q, { where }, { count: true });\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 { $inject, t } from \"alepha\";\nimport { $action } from \"alepha/server\";\nimport { notifications } from \"../entities/notifications.ts\";\nimport { notificationQuerySchema } from \"../schemas/notificationQuerySchema.ts\";\nimport { NotificationService } from \"../services/NotificationService.ts\";\n\nexport class AdminNotificationController {\n  protected readonly url = \"/notifications\";\n  protected readonly group = \"admin:notifications\";\n  protected readonly notificationService = $inject(NotificationService);\n\n  /**\n   * Find notifications with pagination and filtering.\n   */\n  public readonly findNotifications = $action({\n    path: this.url,\n    group: this.group,\n    description: \"Find notifications with pagination and filtering\",\n    schema: {\n      query: notificationQuerySchema,\n      response: t.page(notifications.schema),\n    },\n    handler: ({ query }) => this.notificationService.findNotifications(query),\n  });\n}\n","export class NotificationJobs {\n  // - retry (lost, failed) notifications\n  // - purge old notifications\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 { AdminNotificationController } from \"./controllers/AdminNotificationController.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/AdminNotificationController.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 \"./schemas/notificationQuerySchema.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    AdminNotificationController,\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(AdminNotificationController)\n      .with(NotificationService)\n      .with(NotificationSenderService)\n      .with(NotificationJobs);\n  },\n});\n"],"mappings":";;;;;;;;;;;AAGA,MAAa,gBAAgB,QAAQ;CACnC,MAAM;CACN,QAAQ,EAAE,OAAO;EACf,IAAI,GAAG,WAAW,EAAE,MAAM,CAAC;EAE3B,SAAS,GAAG,SAAS;EAErB,WAAW,GAAG,WAAW;EAEzB,WAAW,GAAG,WAAW;EAIzB,MAAM,EAAE,KAAK,CAAC,SAAS,MAAM,CAAC;EAE9B,UAAU,EAAE,MAAM;EAElB,UAAU,EAAE,SACV,EAAE,KAAK,EACL,aACE,2HACH,CAAC,CACH;EAED,UAAU,EAAE,SACV,EAAE,QAAQ,EACR,aACE,sFACH,CAAC,CACH;EAED,WAAW,EAAE,SACX,EAAE,QAAQ,EACR,aACE,+GACH,CAAC,CACH;EAID,SAAS,EAAE,MAAM;EAEjB,WAAW,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,KAAK,CAAC,CAAC;EAElD,aAAa,EAAE,SACb,EAAE,SAAS,EACT,aACE,uEACH,CAAC,CACH;EAID,QAAQ,EAAE,SAAS,EAAE,UAAU,CAAC;EAEhC,OAAO,EAAE,SACP,EAAE,OAAO;GACP,IAAI,EAAE,UAAU;GAChB,MAAM,EAAE,MAAM;GACd,SAAS,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;GAClC,CAAC,CACH;EAGF,CAAC;CACH,CAAC;;;;AChEF,MAAa,0BAA0B,EAAE,OAAO,iBAAiB;CAC/D,MAAM,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,MAAM,CAAC,CAAC;CAC1C,UAAU,EAAE,SAAS,EAAE,QAAQ,CAAC;CAChC,SAAS,EAAE,SAAS,EAAE,QAAQ,CAAC;CAC/B,UAAU,EAAE,SAAS,EAAE,QAAQ,CAAC;CAChC,QAAQ,EAAE,SAAS,EAAE,KAAK;EAAC;EAAW;EAAQ;EAAS,CAAC,CAAC;CAC1D,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AC6BF,MAAa,iBACX,YACG,gBAAgB,uBAA0B,QAAQ;AAoBvD,IAAa,wBAAb,cAA8D,UAE5D;CACA,AAAmB,sBAAsB,QAAQ,oBAAoB;CAErE,IAAW,OAAO;AAChB,SAAO,KAAK,QAAQ,QAAQ,GAAG,KAAK,OAAO;;CAG7C,MAAa,KAAK,SAAqC;AACrD,MAAI,KAAK,QAAQ,MACf,OAAM,KAAK,oBAAoB,mBAAmB;GAChD,GAAG;GACH,MAAM;GACN,UAAU,KAAK;GAChB,CAAC;;CAIN,AAAO,UAAU,SAAmD;AAClE,SAAO,OAAO,KAAK,SAAS,QAAQ;;;AAIxC,cAAc,QAAQ;;;;ACzEtB,IAAa,4BAAb,MAAuC;CACrC,AAAmB,SAAS,QAAQ,OAAO;CAC3C,AAAmB,MAAM,SAAS;CAClC,AAAmB,yBAAyB,YAAY,cAAc;CACtE,AAAmB,mBAAmB,QAAQ,iBAAiB;CAC/D,AAAmB,gBAAgB,QAAQ,cAAc;CACzD,AAAmB,cAAc,QAAQ,YAAY;CAErD,MAAa,KAAK,gBAA6C;AAC7D,OAAK,IAAI,MAAM,wBAAwB,EACrC,gBACE,OAAO,mBAAmB,WAAW,iBAAiB,eAAe,IACxE,CAAC;EAEF,MAAM,eACJ,OAAO,mBAAmB,WACtB,MAAM,KAAK,uBAAuB,SAAS,eAAe,GAC1D;AAEN,MAAI,aAAa,QAAQ;AACvB,QAAK,IAAI,MAAM,6BAA6B;IAC1C,gBAAgB,aAAa;IAC7B,QAAQ,aAAa;IACtB,CAAC;AACF;;AAGF,OAAK,IAAI,MAAM,2BAA2B;GACxC,IAAI,aAAa;GACjB,MAAM,aAAa;GACnB,UAAU,aAAa;GACvB,SAAS,aAAa;GACvB,CAAC;AAEF,MAAI;AACF,OAAI,aAAa,SAAS,SAAS;AACjC,UAAM,KAAK,cAAc,KAAK,KAAK,YAAY,aAAa,CAAC;AAC7D,iBAAa,SAAS,KAAK,iBAAiB,cAAc;AAC1D,SAAK,IAAI,KAAK,2BAA2B;KACvC,IAAI,aAAa;KACjB,UAAU,aAAa;KACvB,SAAS,aAAa;KACvB,CAAC;;AAEJ,OAAI,aAAa,SAAS,OAAO;AAC/B,UAAM,KAAK,YAAY,KAAK,KAAK,UAAU,aAAa,CAAC;AACzD,iBAAa,SAAS,KAAK,iBAAiB,cAAc;AAC1D,SAAK,IAAI,KAAK,yBAAyB;KACrC,IAAI,aAAa;KACjB,UAAU,aAAa;KACvB,SAAS,aAAa;KACvB,CAAC;;WAEG,GAAG;AACV,QAAK,IAAI,MAAM,+BAA+B;IAC5C,IAAI,aAAa;IACjB,MAAM,aAAa;IACnB,UAAU,aAAa;IACvB,SAAS,aAAa;IACtB,OAAO;IACR,CAAC;AACF,OAAI,aAAa,MACf,cAAa,QAAQ;IACnB,IAAI,KAAK,iBAAiB,cAAc;IACxC,MAAM,EAAE;IACR,SAAS,EAAE;IACZ;YAEK;AACR,SAAM,KAAK,uBAAuB,KAAK,aAAa;;;CAIxD,AAAO,UAAU,cAAkC;AACjD,OAAK,IAAI,MAAM,8BAA8B;GAC3C,IAAI,aAAa;GACjB,UAAU,aAAa;GACxB,CAAC;EAEF,MAAM,EAAE,WAAW,SAAS,aAAa,KAAK,KAAK,aAAa;EAEhE,MAAM,MAAM,SAAS,QAAQ;AAC7B,MAAI,CAAC,KAAK;AACR,QAAK,IAAI,MAAM,4CAA4C;IACzD,IAAI,aAAa;IACjB,UAAU,aAAa;IACxB,CAAC;AACF,SAAM,IAAI,YACR,yBAAyB,aAAa,SAAS,qBAChD;;AAGH,OAAK,IAAI,MAAM,iBAAiB;GAC9B,UAAU,aAAa;GACvB;GACD,CAAC;AAOF,SAAO;GACL,IAAI;GACJ,SANA,OAAO,IAAI,YAAY,aACnB,IAAI,QAAQ,UAAiB,GAC7B,IAAI;GAKT;;CAGH,AAAO,YAAY,cAAkC;AACnD,OAAK,IAAI,MAAM,gCAAgC;GAC7C,IAAI,aAAa;GACjB,UAAU,aAAa;GACxB,CAAC;EAEF,MAAM,EAAE,WAAW,SAAS,aAAa,KAAK,KAAK,aAAa;EAEhE,MAAM,QAAQ,SAAS,QAAQ;AAC/B,MAAI,CAAC,OAAO;AACV,QAAK,IAAI,MAAM,8CAA8C;IAC3D,IAAI,aAAa;IACjB,UAAU,aAAa;IACxB,CAAC;AACF,SAAM,IAAI,YACR,yBAAyB,aAAa,SAAS,uBAChD;;AAGH,OAAK,IAAI,MAAM,mBAAmB;GAChC,UAAU,aAAa;GACvB;GACA,SAAS,MAAM;GAChB,CAAC;AASF,SAAO;GACL,IAAI;GACJ,SATc,MAAM;GAUpB,MAPA,OAAO,MAAM,SAAS,aAClB,MAAM,KAAK,UAAiB,GAC5B,MAAM;GAMX;;CAGH,AAAU,KAAK,cAAkC;EAC/C,MAAM,YAAY,aAAa,aAAa,EAAE;EAC9C,MAAM,UAAU,aAAa;EAC7B,MAAM,WAAW,KAAK,OACnB,WAAW,cAAc,CACzB,MAAM,OAAO,GAAG,SAAS,aAAa,SAAS;AAElD,MAAI,CAAC,UAAU;AACb,QAAK,IAAI,MAAM,mCAAmC;IAChD,IAAI,aAAa;IACjB,UAAU,aAAa;IACxB,CAAC;AACF,SAAM,IAAI,YACR,sCAAsC,aAAa,WACpD;;AAGH,SAAO;GACL;GACA;GACA;GACD;;;;;;AChLL,IAAa,qBAAb,MAAgC;CAC9B,AAAmB,4BAA4B,QAC7C,0BACD;CAED,AAAgB,sBAAsB,OAAO;EAC3C,aAAa;EACb,QAAQ,EAAE,OAAO,EACf,gBAAgB,EAAE,OAAO,EAAE,QAAQ,QAAQ,CAAC,EAC7C,CAAC;EACF,SAAS,OAAO,YAAY;AAC1B,SAAM,KAAK,0BAA0B,KAAK,QAAQ,QAAQ,eAAe;;EAE5E,CAAC;;;;;ACdJ,MAAa,2BAA2B,EAAE,KAAK,cAAc,QAAQ;CACnE;CACA;CACA;CACA;CACD,CAAC;;;;ACSF,MAAa,+BAA+B,EAAE,OAAO,EACnD,oBAAoB,EAAE,SACpB,EAAE,QAAQ,EACR,aACE,qEACH,CAAC,CACH,EACF,CAAC;AAMF,IAAa,sBAAb,MAAiC;CAC/B,AAAmB,SAAS,QAAQ,OAAO;CAC3C,AAAmB,MAAM,SAAS;CAClC,AAAmB,MAAM,KAAK,6BAA6B;CAC3D,AAAmB,yBAAyB,YAAY,cAAc;CACtE,AAAmB,mBAAmB,QAAQ,iBAAiB;CAC/D,AAAmB,4BAA4B,QAC7C,0BACD;CAED,AAAgB,oBAAoB,OAAO;EACzC,SAAS;EACT,aAAa,CAAC,IAAI,UAAU;EAC5B,QAAQ;EACR,SAAS,OAAO,oBAAwC;AACtD,QAAK,IAAI,MAAM,iCAAiC;IAC9C,MAAMA,gBAAc;IACpB,WAAW,CAAC,GAAG,IAAI,IAAIA,gBAAc,KAAK,MAAM,EAAE,SAAS,CAAC,CAAC;IAC9D,CAAC;GAEF,MAAM,WACJ,MAAM,KAAK,uBAAuB,WAAWA,gBAAc;AAE7D,SAAM,KAAK,OACR,OAAO,mBAAmB,CAC1B,oBAAoB,KACnB,GAAG,SAAS,KAAK,QAAQ,EAAE,gBAAgB,GAAG,IAAI,EAAE,CACrD;AAEH,QAAK,IAAI,KAAK,6BAA6B;IACzC,OAAO,SAAS;IAChB,KAAK,SAAS,KAAK,OAAO,GAAG,GAAG;IACjC,CAAC;;EAEL,CAAC;CAEF,MAAa,qBAAqB,IAAY;AAC5C,OAAK,IAAI,MAAM,8BAA8B,EAAE,IAAI,CAAC;AACpD,SAAO,KAAK,uBAAuB,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;;CAG/D,MAAa,kBACX,IAAuB,EAAE,EACU;AACnC,OAAK,IAAI,MAAM,yBAAyB,EAAE,OAAO,GAAG,CAAC;AACrD,IAAE,SAAS;EAEX,MAAM,QAAQ,KAAK,uBAAuB,kBAAkB;AAE5D,MAAI,EAAE,KACJ,OAAM,OAAO,EAAE,IAAI,EAAE,MAAM;AAG7B,MAAI,EAAE,SACJ,OAAM,WAAW,EAAE,MAAM,IAAI,EAAE,SAAS,IAAI;AAG9C,MAAI,EAAE,QACJ,OAAM,UAAU,EAAE,MAAM,IAAI,EAAE,QAAQ,IAAI;AAG5C,MAAI,EAAE,SACJ,OAAM,WAAW,EAAE,IAAI,EAAE,UAAU;AAGrC,MAAI,EAAE,QACJ;OAAI,EAAE,WAAW,QAAQ;AACvB,UAAM,SAAS,EAAE,WAAW,MAAM;AAClC,UAAM,QAAQ,EAAE,QAAQ,MAAM;cACrB,EAAE,WAAW,SACtB,OAAM,QAAQ,EAAE,WAAW,MAAM;YACxB,EAAE,WAAW,WAAW;AACjC,UAAM,SAAS,EAAE,QAAQ,MAAM;AAC/B,UAAM,QAAQ,EAAE,QAAQ,MAAM;;;AAIlC,SAAO,KAAK,uBAAuB,SAAS,GAAG,EAAE,OAAO,EAAE,EAAE,OAAO,MAAM,CAAC;;;;;CAM5E,MAAa,mBAAmB,OAA0C;AACxE,OAAK,IAAI,MAAM,yBAAyB;GACtC,UAAU,MAAM;GAChB,MAAM,MAAM;GACZ,SAAS,MAAM;GAChB,CAAC;AAEF,MACE,KAAK,IAAI,uBAAuB,QAChC,KAAK,OAAO,cAAc,IAC1B,KAAK,OAAO,QAAQ,EACpB;AACA,QAAK,IAAI,MAAM,oCAAoC;IACjD,UAAU,MAAM;IAChB,MAAM,MAAM;IACZ,SAAS,MAAM;IAChB,CAAC;GACF,MAAM,eAAe,MAAM,KAAK,uBAAuB,OAAO,MAAM;AACpE,SAAM,KAAK,0BAA0B,KAAK,aAAa;AACvD;;AAGF,OAAK,IAAI,MAAM,iCAAiC;GAC9C,UAAU,MAAM;GAChB,MAAM,MAAM;GACZ,SAAS,MAAM;GAChB,CAAC;AAEF,OAAK,kBAAkB,KAAK,MAAM,CAAC,OAAO,MAAM;AAC9C,QAAK,IAAI,MAAM,wCAAwC;IACrD,UAAU,MAAM;IAChB,MAAM,MAAM;IACZ,SAAS,MAAM;IACf,OAAO;IACR,CAAC;IACF;;;;;;AC9IN,IAAa,8BAAb,MAAyC;CACvC,AAAmB,MAAM;CACzB,AAAmB,QAAQ;CAC3B,AAAmB,sBAAsB,QAAQ,oBAAoB;;;;CAKrE,AAAgB,oBAAoB,QAAQ;EAC1C,MAAM,KAAK;EACX,OAAO,KAAK;EACZ,aAAa;EACb,QAAQ;GACN,OAAO;GACP,UAAU,EAAE,KAAK,cAAc,OAAO;GACvC;EACD,UAAU,EAAE,YAAY,KAAK,oBAAoB,kBAAkB,MAAM;EAC1E,CAAC;;;;;ACvBJ,IAAa,mBAAb,MAA8B;;;;ACE9B,MAAa,uCAAuC,EAAE,OAAO;CAC3D,UAAU,EAAE,SAAS,EAAE,MAAM,CAAC;CAC9B,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC;CAC3B,CAAC;;;;;;;;;;;;;;AC+BF,MAAa,yBAAyB,QAAQ;CAC5C,MAAM;CACN,YAAY,CAAC,cAAc;CAC3B,UAAU;EACR;EACA;EACA;EACA;EACA;EACD;CACD,WAAW,WAAW;AAEpB,MADY,OAAO,SAAS,6BAA6B,CACjD,mBACN,QAAO,KAAK,mBAAmB;AAGjC,SACG,KAAK,4BAA4B,CACjC,KAAK,oBAAoB,CACzB,KAAK,0BAA0B,CAC/B,KAAK,iBAAiB;;CAE5B,CAAC"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/api/notifications/entities/notifications.ts","../../../src/api/notifications/schemas/notificationQuerySchema.ts","../../../src/api/notifications/primitives/$notification.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/controllers/AdminNotificationController.ts","../../../src/api/notifications/jobs/NotificationJobs.ts","../../../src/api/notifications/schemas/notificationContactPreferencesSchema.ts","../../../src/api/notifications/index.ts"],"sourcesContent":["import { type Static, t } from \"alepha\";\nimport { $entity, db } from \"alepha/orm\";\n\nexport const notifications = $entity({\n  name: \"notifications\",\n  schema: t.object({\n    id: db.primaryKey(t.uuid()),\n\n    version: db.version(),\n\n    createdAt: db.createdAt(),\n\n    updatedAt: db.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 type { Static } from \"alepha\";\nimport { t } from \"alepha\";\nimport { pageQuerySchema } from \"alepha/orm\";\n\nexport const notificationQuerySchema = t.extend(pageQuerySchema, {\n  type: t.optional(t.enum([\"email\", \"sms\"])),\n  template: t.optional(t.string()),\n  contact: t.optional(t.string()),\n  category: t.optional(t.string()),\n  status: t.optional(t.enum([\"pending\", \"sent\", \"failed\"])),\n});\n\nexport type NotificationQuery = Static<typeof notificationQuerySchema>;\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 { $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, type Page } from \"alepha/orm\";\nimport {\n  type NotificationEntity,\n  notifications,\n} from \"../entities/notifications.ts\";\nimport { NotificationQueues } from \"../queues/NotificationQueues.ts\";\nimport {\n  type NotificationCreate,\n  notificationCreateSchema,\n} from \"../schemas/notificationCreateSchema.ts\";\nimport type { NotificationQuery } from \"../schemas/notificationQuerySchema.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  public async findNotifications(\n    q: NotificationQuery = {},\n  ): Promise<Page<NotificationEntity>> {\n    this.log.trace(\"Finding notifications\", { query: q });\n    q.sort ??= \"-createdAt\";\n\n    const where = this.notificationRepository.createQueryWhere();\n\n    if (q.type) {\n      where.type = { eq: q.type };\n    }\n\n    if (q.template) {\n      where.template = { like: `%${q.template}%` };\n    }\n\n    if (q.contact) {\n      where.contact = { like: `%${q.contact}%` };\n    }\n\n    if (q.category) {\n      where.category = { eq: q.category };\n    }\n\n    if (q.status) {\n      if (q.status === \"sent\") {\n        where.sentAt = { isNotNull: true };\n        where.error = { isNull: true };\n      } else if (q.status === \"failed\") {\n        where.error = { isNotNull: true };\n      } else if (q.status === \"pending\") {\n        where.sentAt = { isNull: true };\n        where.error = { isNull: true };\n      }\n    }\n\n    return this.notificationRepository.paginate(q, { where }, { count: true });\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 { $inject, t } from \"alepha\";\nimport { $action } from \"alepha/server\";\nimport { notifications } from \"../entities/notifications.ts\";\nimport { notificationQuerySchema } from \"../schemas/notificationQuerySchema.ts\";\nimport { NotificationService } from \"../services/NotificationService.ts\";\n\nexport class AdminNotificationController {\n  protected readonly url = \"/notifications\";\n  protected readonly group = \"admin:notifications\";\n  protected readonly notificationService = $inject(NotificationService);\n\n  /**\n   * Find notifications with pagination and filtering.\n   */\n  public readonly findNotifications = $action({\n    path: this.url,\n    group: this.group,\n    description: \"Find notifications with pagination and filtering\",\n    schema: {\n      query: notificationQuerySchema,\n      response: t.page(notifications.schema),\n    },\n    handler: ({ query }) => this.notificationService.findNotifications(query),\n  });\n}\n","export class NotificationJobs {\n  // - retry (lost, failed) notifications\n  // - purge old notifications\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 { AdminNotificationController } from \"./controllers/AdminNotificationController.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/AdminNotificationController.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 \"./schemas/notificationQuerySchema.ts\";\nexport * from \"./services/NotificationSenderService.ts\";\nexport * from \"./services/NotificationService.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * | type | quality | stability |\n * |------|---------|-----------|\n * | backend | standard | stable |\n *\n * User notification management.\n *\n * **Features:**\n * - Notification definitions\n * - Email/SMS notification sending\n * - Status tracking\n * - User preferences\n * - Queue integration\n *\n * @module alepha.api.notifications\n */\nexport const AlephaApiNotifications = $module({\n  name: \"alepha.api.notifications\",\n  primitives: [$notification],\n  services: [\n    AdminNotificationController,\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(AdminNotificationController)\n      .with(NotificationService)\n      .with(NotificationSenderService)\n      .with(NotificationJobs);\n  },\n});\n"],"mappings":";;;;;;;;;;;AAGA,MAAa,gBAAgB,QAAQ;CACnC,MAAM;CACN,QAAQ,EAAE,OAAO;EACf,IAAI,GAAG,WAAW,EAAE,MAAM,CAAC;EAE3B,SAAS,GAAG,SAAS;EAErB,WAAW,GAAG,WAAW;EAEzB,WAAW,GAAG,WAAW;EAIzB,MAAM,EAAE,KAAK,CAAC,SAAS,MAAM,CAAC;EAE9B,UAAU,EAAE,MAAM;EAElB,UAAU,EAAE,SACV,EAAE,KAAK,EACL,aACE,2HACH,CAAC,CACH;EAED,UAAU,EAAE,SACV,EAAE,QAAQ,EACR,aACE,sFACH,CAAC,CACH;EAED,WAAW,EAAE,SACX,EAAE,QAAQ,EACR,aACE,+GACH,CAAC,CACH;EAID,SAAS,EAAE,MAAM;EAEjB,WAAW,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,KAAK,CAAC,CAAC;EAElD,aAAa,EAAE,SACb,EAAE,SAAS,EACT,aACE,uEACH,CAAC,CACH;EAID,QAAQ,EAAE,SAAS,EAAE,UAAU,CAAC;EAEhC,OAAO,EAAE,SACP,EAAE,OAAO;GACP,IAAI,EAAE,UAAU;GAChB,MAAM,EAAE,MAAM;GACd,SAAS,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;GAClC,CAAC,CACH;EAGF,CAAC;CACH,CAAC;;;;AChEF,MAAa,0BAA0B,EAAE,OAAO,iBAAiB;CAC/D,MAAM,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,MAAM,CAAC,CAAC;CAC1C,UAAU,EAAE,SAAS,EAAE,QAAQ,CAAC;CAChC,SAAS,EAAE,SAAS,EAAE,QAAQ,CAAC;CAC/B,UAAU,EAAE,SAAS,EAAE,QAAQ,CAAC;CAChC,QAAQ,EAAE,SAAS,EAAE,KAAK;EAAC;EAAW;EAAQ;EAAS,CAAC,CAAC;CAC1D,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AC6BF,MAAa,iBACX,YACG,gBAAgB,uBAA0B,QAAQ;AAoBvD,IAAa,wBAAb,cAA8D,UAE5D;CACA,AAAmB,sBAAsB,QAAQ,oBAAoB;CAErE,IAAW,OAAO;AAChB,SAAO,KAAK,QAAQ,QAAQ,GAAG,KAAK,OAAO;;CAG7C,MAAa,KAAK,SAAqC;AACrD,MAAI,KAAK,QAAQ,MACf,OAAM,KAAK,oBAAoB,mBAAmB;GAChD,GAAG;GACH,MAAM;GACN,UAAU,KAAK;GAChB,CAAC;;CAIN,AAAO,UAAU,SAAmD;AAClE,SAAO,OAAO,KAAK,SAAS,QAAQ;;;AAIxC,cAAc,QAAQ;;;;ACzEtB,IAAa,4BAAb,MAAuC;CACrC,AAAmB,SAAS,QAAQ,OAAO;CAC3C,AAAmB,MAAM,SAAS;CAClC,AAAmB,yBAAyB,YAAY,cAAc;CACtE,AAAmB,mBAAmB,QAAQ,iBAAiB;CAC/D,AAAmB,gBAAgB,QAAQ,cAAc;CACzD,AAAmB,cAAc,QAAQ,YAAY;CAErD,MAAa,KAAK,gBAA6C;AAC7D,OAAK,IAAI,MAAM,wBAAwB,EACrC,gBACE,OAAO,mBAAmB,WAAW,iBAAiB,eAAe,IACxE,CAAC;EAEF,MAAM,eACJ,OAAO,mBAAmB,WACtB,MAAM,KAAK,uBAAuB,SAAS,eAAe,GAC1D;AAEN,MAAI,aAAa,QAAQ;AACvB,QAAK,IAAI,MAAM,6BAA6B;IAC1C,gBAAgB,aAAa;IAC7B,QAAQ,aAAa;IACtB,CAAC;AACF;;AAGF,OAAK,IAAI,MAAM,2BAA2B;GACxC,IAAI,aAAa;GACjB,MAAM,aAAa;GACnB,UAAU,aAAa;GACvB,SAAS,aAAa;GACvB,CAAC;AAEF,MAAI;AACF,OAAI,aAAa,SAAS,SAAS;AACjC,UAAM,KAAK,cAAc,KAAK,KAAK,YAAY,aAAa,CAAC;AAC7D,iBAAa,SAAS,KAAK,iBAAiB,cAAc;AAC1D,SAAK,IAAI,KAAK,2BAA2B;KACvC,IAAI,aAAa;KACjB,UAAU,aAAa;KACvB,SAAS,aAAa;KACvB,CAAC;;AAEJ,OAAI,aAAa,SAAS,OAAO;AAC/B,UAAM,KAAK,YAAY,KAAK,KAAK,UAAU,aAAa,CAAC;AACzD,iBAAa,SAAS,KAAK,iBAAiB,cAAc;AAC1D,SAAK,IAAI,KAAK,yBAAyB;KACrC,IAAI,aAAa;KACjB,UAAU,aAAa;KACvB,SAAS,aAAa;KACvB,CAAC;;WAEG,GAAG;AACV,QAAK,IAAI,MAAM,+BAA+B;IAC5C,IAAI,aAAa;IACjB,MAAM,aAAa;IACnB,UAAU,aAAa;IACvB,SAAS,aAAa;IACtB,OAAO;IACR,CAAC;AACF,OAAI,aAAa,MACf,cAAa,QAAQ;IACnB,IAAI,KAAK,iBAAiB,cAAc;IACxC,MAAM,EAAE;IACR,SAAS,EAAE;IACZ;YAEK;AACR,SAAM,KAAK,uBAAuB,KAAK,aAAa;;;CAIxD,AAAO,UAAU,cAAkC;AACjD,OAAK,IAAI,MAAM,8BAA8B;GAC3C,IAAI,aAAa;GACjB,UAAU,aAAa;GACxB,CAAC;EAEF,MAAM,EAAE,WAAW,SAAS,aAAa,KAAK,KAAK,aAAa;EAEhE,MAAM,MAAM,SAAS,QAAQ;AAC7B,MAAI,CAAC,KAAK;AACR,QAAK,IAAI,MAAM,4CAA4C;IACzD,IAAI,aAAa;IACjB,UAAU,aAAa;IACxB,CAAC;AACF,SAAM,IAAI,YACR,yBAAyB,aAAa,SAAS,qBAChD;;AAGH,OAAK,IAAI,MAAM,iBAAiB;GAC9B,UAAU,aAAa;GACvB;GACD,CAAC;AAOF,SAAO;GACL,IAAI;GACJ,SANA,OAAO,IAAI,YAAY,aACnB,IAAI,QAAQ,UAAiB,GAC7B,IAAI;GAKT;;CAGH,AAAO,YAAY,cAAkC;AACnD,OAAK,IAAI,MAAM,gCAAgC;GAC7C,IAAI,aAAa;GACjB,UAAU,aAAa;GACxB,CAAC;EAEF,MAAM,EAAE,WAAW,SAAS,aAAa,KAAK,KAAK,aAAa;EAEhE,MAAM,QAAQ,SAAS,QAAQ;AAC/B,MAAI,CAAC,OAAO;AACV,QAAK,IAAI,MAAM,8CAA8C;IAC3D,IAAI,aAAa;IACjB,UAAU,aAAa;IACxB,CAAC;AACF,SAAM,IAAI,YACR,yBAAyB,aAAa,SAAS,uBAChD;;AAGH,OAAK,IAAI,MAAM,mBAAmB;GAChC,UAAU,aAAa;GACvB;GACA,SAAS,MAAM;GAChB,CAAC;AASF,SAAO;GACL,IAAI;GACJ,SATc,MAAM;GAUpB,MAPA,OAAO,MAAM,SAAS,aAClB,MAAM,KAAK,UAAiB,GAC5B,MAAM;GAMX;;CAGH,AAAU,KAAK,cAAkC;EAC/C,MAAM,YAAY,aAAa,aAAa,EAAE;EAC9C,MAAM,UAAU,aAAa;EAC7B,MAAM,WAAW,KAAK,OACnB,WAAW,cAAc,CACzB,MAAM,OAAO,GAAG,SAAS,aAAa,SAAS;AAElD,MAAI,CAAC,UAAU;AACb,QAAK,IAAI,MAAM,mCAAmC;IAChD,IAAI,aAAa;IACjB,UAAU,aAAa;IACxB,CAAC;AACF,SAAM,IAAI,YACR,sCAAsC,aAAa,WACpD;;AAGH,SAAO;GACL;GACA;GACA;GACD;;;;;;AChLL,IAAa,qBAAb,MAAgC;CAC9B,AAAmB,4BAA4B,QAC7C,0BACD;CAED,AAAgB,sBAAsB,OAAO;EAC3C,aAAa;EACb,QAAQ,EAAE,OAAO,EACf,gBAAgB,EAAE,OAAO,EAAE,QAAQ,QAAQ,CAAC,EAC7C,CAAC;EACF,SAAS,OAAO,YAAY;AAC1B,SAAM,KAAK,0BAA0B,KAAK,QAAQ,QAAQ,eAAe;;EAE5E,CAAC;;;;;ACdJ,MAAa,2BAA2B,EAAE,KAAK,cAAc,QAAQ;CACnE;CACA;CACA;CACA;CACD,CAAC;;;;ACSF,MAAa,+BAA+B,EAAE,OAAO,EACnD,oBAAoB,EAAE,SACpB,EAAE,QAAQ,EACR,aACE,qEACH,CAAC,CACH,EACF,CAAC;AAMF,IAAa,sBAAb,MAAiC;CAC/B,AAAmB,SAAS,QAAQ,OAAO;CAC3C,AAAmB,MAAM,SAAS;CAClC,AAAmB,MAAM,KAAK,6BAA6B;CAC3D,AAAmB,yBAAyB,YAAY,cAAc;CACtE,AAAmB,mBAAmB,QAAQ,iBAAiB;CAC/D,AAAmB,4BAA4B,QAC7C,0BACD;CAED,AAAgB,oBAAoB,OAAO;EACzC,SAAS;EACT,aAAa,CAAC,IAAI,UAAU;EAC5B,QAAQ;EACR,SAAS,OAAO,kBAAwC;AACtD,QAAK,IAAI,MAAM,iCAAiC;IAC9C,MAAM,cAAc;IACpB,WAAW,CAAC,GAAG,IAAI,IAAI,cAAc,KAAK,MAAM,EAAE,SAAS,CAAC,CAAC;IAC9D,CAAC;GAEF,MAAM,WACJ,MAAM,KAAK,uBAAuB,WAAW,cAAc;AAE7D,SAAM,KAAK,OACR,OAAO,mBAAmB,CAC1B,oBAAoB,KACnB,GAAG,SAAS,KAAK,QAAQ,EAAE,gBAAgB,GAAG,IAAI,EAAE,CACrD;AAEH,QAAK,IAAI,KAAK,6BAA6B;IACzC,OAAO,SAAS;IAChB,KAAK,SAAS,KAAK,OAAO,GAAG,GAAG;IACjC,CAAC;;EAEL,CAAC;CAEF,MAAa,qBAAqB,IAAY;AAC5C,OAAK,IAAI,MAAM,8BAA8B,EAAE,IAAI,CAAC;AACpD,SAAO,KAAK,uBAAuB,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;;CAG/D,MAAa,kBACX,IAAuB,EAAE,EACU;AACnC,OAAK,IAAI,MAAM,yBAAyB,EAAE,OAAO,GAAG,CAAC;AACrD,IAAE,SAAS;EAEX,MAAM,QAAQ,KAAK,uBAAuB,kBAAkB;AAE5D,MAAI,EAAE,KACJ,OAAM,OAAO,EAAE,IAAI,EAAE,MAAM;AAG7B,MAAI,EAAE,SACJ,OAAM,WAAW,EAAE,MAAM,IAAI,EAAE,SAAS,IAAI;AAG9C,MAAI,EAAE,QACJ,OAAM,UAAU,EAAE,MAAM,IAAI,EAAE,QAAQ,IAAI;AAG5C,MAAI,EAAE,SACJ,OAAM,WAAW,EAAE,IAAI,EAAE,UAAU;AAGrC,MAAI,EAAE,QACJ;OAAI,EAAE,WAAW,QAAQ;AACvB,UAAM,SAAS,EAAE,WAAW,MAAM;AAClC,UAAM,QAAQ,EAAE,QAAQ,MAAM;cACrB,EAAE,WAAW,SACtB,OAAM,QAAQ,EAAE,WAAW,MAAM;YACxB,EAAE,WAAW,WAAW;AACjC,UAAM,SAAS,EAAE,QAAQ,MAAM;AAC/B,UAAM,QAAQ,EAAE,QAAQ,MAAM;;;AAIlC,SAAO,KAAK,uBAAuB,SAAS,GAAG,EAAE,OAAO,EAAE,EAAE,OAAO,MAAM,CAAC;;;;;CAM5E,MAAa,mBAAmB,OAA0C;AACxE,OAAK,IAAI,MAAM,yBAAyB;GACtC,UAAU,MAAM;GAChB,MAAM,MAAM;GACZ,SAAS,MAAM;GAChB,CAAC;AAEF,MACE,KAAK,IAAI,uBAAuB,QAChC,KAAK,OAAO,cAAc,IAC1B,KAAK,OAAO,QAAQ,EACpB;AACA,QAAK,IAAI,MAAM,oCAAoC;IACjD,UAAU,MAAM;IAChB,MAAM,MAAM;IACZ,SAAS,MAAM;IAChB,CAAC;GACF,MAAM,eAAe,MAAM,KAAK,uBAAuB,OAAO,MAAM;AACpE,SAAM,KAAK,0BAA0B,KAAK,aAAa;AACvD;;AAGF,OAAK,IAAI,MAAM,iCAAiC;GAC9C,UAAU,MAAM;GAChB,MAAM,MAAM;GACZ,SAAS,MAAM;GAChB,CAAC;AAEF,OAAK,kBAAkB,KAAK,MAAM,CAAC,OAAO,MAAM;AAC9C,QAAK,IAAI,MAAM,wCAAwC;IACrD,UAAU,MAAM;IAChB,MAAM,MAAM;IACZ,SAAS,MAAM;IACf,OAAO;IACR,CAAC;IACF;;;;;;AC9IN,IAAa,8BAAb,MAAyC;CACvC,AAAmB,MAAM;CACzB,AAAmB,QAAQ;CAC3B,AAAmB,sBAAsB,QAAQ,oBAAoB;;;;CAKrE,AAAgB,oBAAoB,QAAQ;EAC1C,MAAM,KAAK;EACX,OAAO,KAAK;EACZ,aAAa;EACb,QAAQ;GACN,OAAO;GACP,UAAU,EAAE,KAAK,cAAc,OAAO;GACvC;EACD,UAAU,EAAE,YAAY,KAAK,oBAAoB,kBAAkB,MAAM;EAC1E,CAAC;;;;;ACvBJ,IAAa,mBAAb,MAA8B;;;;ACE9B,MAAa,uCAAuC,EAAE,OAAO;CAC3D,UAAU,EAAE,SAAS,EAAE,MAAM,CAAC;CAC9B,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC;CAC3B,CAAC;;;;;;;;;;;;;;;;;;;;ACqCF,MAAa,yBAAyB,QAAQ;CAC5C,MAAM;CACN,YAAY,CAAC,cAAc;CAC3B,UAAU;EACR;EACA;EACA;EACA;EACA;EACD;CACD,WAAW,WAAW;AAEpB,MADY,OAAO,SAAS,6BAA6B,CACjD,mBACN,QAAO,KAAK,mBAAmB;AAGjC,SACG,KAAK,4BAA4B,CACjC,KAAK,oBAAoB,CACzB,KAAK,0BAA0B,CAC/B,KAAK,iBAAiB;;CAE5B,CAAC"}