@contractspec/module.notifications 2.4.0 → 2.5.0

package/dist/node/index.js

@@ -1,3 +1,183 @@
+var __defProp = Object.defineProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: (newValue) => all[name] = () => newValue
+    });
+};
+var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
+
+// src/i18n/catalogs/en.ts
+import { defineTranslation } from "@contractspec/lib.contracts-spec/translations";
+var enMessages;
+var init_en = __esm(() => {
+  enMessages = defineTranslation({
+    meta: {
+      key: "notifications.messages",
+      version: "1.0.0",
+      domain: "notifications",
+      description: "Template and channel strings for the notifications module",
+      owners: ["platform"],
+      stability: "experimental"
+    },
+    locale: "en",
+    fallback: "en",
+    messages: {
+      "template.welcome.name": {
+        value: "Welcome",
+        description: "Welcome template display name"
+      },
+      "template.welcome.description": {
+        value: "Sent when a user signs up.",
+        description: "Welcome template description"
+      },
+      "template.orgInvite.name": {
+        value: "Organization Invitation",
+        description: "Org invite template display name"
+      },
+      "template.orgInvite.description": {
+        value: "Sent when a user is invited to an organization.",
+        description: "Org invite template description"
+      },
+      "template.mention.name": {
+        value: "Mention",
+        description: "Mention template display name"
+      },
+      "template.mention.description": {
+        value: "Sent when a user is mentioned.",
+        description: "Mention template description"
+      },
+      "channel.webhook.noUrl": {
+        value: "No webhook URL configured",
+        description: "Error when webhook channel has no URL"
+      }
+    }
+  });
+});
+
+// src/i18n/catalogs/fr.ts
+import { defineTranslation as defineTranslation2 } from "@contractspec/lib.contracts-spec/translations";
+var frMessages;
+var init_fr = __esm(() => {
+  frMessages = defineTranslation2({
+    meta: {
+      key: "notifications.messages",
+      version: "1.0.0",
+      domain: "notifications",
+      description: "Template and channel strings (French)",
+      owners: ["platform"],
+      stability: "experimental"
+    },
+    locale: "fr",
+    fallback: "en",
+    messages: {
+      "template.welcome.name": {
+        value: "Bienvenue",
+        description: "Welcome template display name"
+      },
+      "template.welcome.description": {
+        value: "Envoyé lorsqu'un utilisateur s'inscrit.",
+        description: "Welcome template description"
+      },
+      "template.orgInvite.name": {
+        value: "Invitation à l'organisation",
+        description: "Org invite template display name"
+      },
+      "template.orgInvite.description": {
+        value: "Envoyé lorsqu'un utilisateur est invité à une organisation.",
+        description: "Org invite template description"
+      },
+      "template.mention.name": {
+        value: "Mention",
+        description: "Mention template display name"
+      },
+      "template.mention.description": {
+        value: "Envoyé lorsqu'un utilisateur est mentionné.",
+        description: "Mention template description"
+      },
+      "channel.webhook.noUrl": {
+        value: "Aucune URL de webhook configurée",
+        description: "Error when webhook channel has no URL"
+      }
+    }
+  });
+});
+
+// src/i18n/catalogs/es.ts
+import { defineTranslation as defineTranslation3 } from "@contractspec/lib.contracts-spec/translations";
+var esMessages;
+var init_es = __esm(() => {
+  esMessages = defineTranslation3({
+    meta: {
+      key: "notifications.messages",
+      version: "1.0.0",
+      domain: "notifications",
+      description: "Template and channel strings (Spanish)",
+      owners: ["platform"],
+      stability: "experimental"
+    },
+    locale: "es",
+    fallback: "en",
+    messages: {
+      "template.welcome.name": {
+        value: "Bienvenida",
+        description: "Welcome template display name"
+      },
+      "template.welcome.description": {
+        value: "Enviado cuando un usuario se registra.",
+        description: "Welcome template description"
+      },
+      "template.orgInvite.name": {
+        value: "Invitación a la organización",
+        description: "Org invite template display name"
+      },
+      "template.orgInvite.description": {
+        value: "Enviado cuando un usuario es invitado a una organización.",
+        description: "Org invite template description"
+      },
+      "template.mention.name": {
+        value: "Mención",
+        description: "Mention template display name"
+      },
+      "template.mention.description": {
+        value: "Enviado cuando un usuario es mencionado.",
+        description: "Mention template description"
+      },
+      "channel.webhook.noUrl": {
+        value: "No se ha configurado una URL de webhook",
+        description: "Error when webhook channel has no URL"
+      }
+    }
+  });
+});
+
+// src/i18n/messages.ts
+var exports_messages = {};
+__export(exports_messages, {
+  resetI18nRegistry: () => resetI18nRegistry,
+  getDefaultI18n: () => getDefaultI18n,
+  createNotificationsI18n: () => createNotificationsI18n
+});
+import {
+  createI18nFactory
+} from "@contractspec/lib.contracts-spec/translations";
+var factory, createNotificationsI18n, getDefaultI18n, resetI18nRegistry;
+var init_messages = __esm(() => {
+  init_en();
+  init_fr();
+  init_es();
+  factory = createI18nFactory({
+    specKey: "notifications.messages",
+    catalogs: [enMessages, frMessages, esMessages]
+  });
+  createNotificationsI18n = factory.create;
+  getDefaultI18n = factory.getDefault;
+  resetI18nRegistry = factory.resetRegistry;
+});
+
 // src/channels/index.ts
 class InAppChannel {
   channelId = "IN_APP";
@@ -46,11 +226,17 @@ class PushChannel {
 
 class WebhookChannel {
   channelId = "WEBHOOK";
+  locale;
+  constructor(options) {
+    this.locale = options?.locale;
+  }
   async send(notification) {
     if (!notification.webhook?.url) {
+      const { createNotificationsI18n: createNotificationsI18n2 } = await Promise.resolve().then(() => (init_messages(), exports_messages));
+      const i18n = createNotificationsI18n2(this.locale);
       return {
         success: false,
-        responseMessage: "No webhook URL configured"
+        responseMessage: i18n.t("channel.webhook.noUrl")
       };
     }
     try {
@@ -665,8 +851,8 @@ function renderTemplate(content, variables) {
     return String(value);
   });
 }
-function renderNotificationTemplate(template, channel, variables) {
-  const channelContent = template.channels[channel];
+function renderNotificationTemplate(template, channel, variables, locale) {
+  const channelContent = (locale && template.localeChannels?.[locale]?.[channel]) ?? template.channels[channel];
   if (!channelContent) {
     return null;
   }
@@ -734,6 +920,38 @@ var WelcomeTemplate = defineTemplate({
       body: "Thanks for joining. Click to complete your profile.",
       actionUrl: "{{actionUrl}}"
     }
+  },
+  localeChannels: {
+    fr: {
+      email: {
+        subject: "Bienvenue sur {{appName}}, {{name}} !",
+        body: `
+          <h1>Bienvenue, {{name}} !</h1>
+          <p>Merci d’avoir rejoint {{appName}}. Nous sommes ravis de vous compter parmi nous.</p>
+          <p><a href="{{actionUrl}}">Commencer maintenant</a></p>
+        `
+      },
+      inApp: {
+        title: "Bienvenue sur {{appName}} !",
+        body: "Merci de nous avoir rejoint. Cliquez pour compléter votre profil.",
+        actionUrl: "{{actionUrl}}"
+      }
+    },
+    es: {
+      email: {
+        subject: "¡Bienvenido a {{appName}}, {{name}}!",
+        body: `
+          <h1>¡Bienvenido, {{name}}!</h1>
+          <p>Gracias por unirte a {{appName}}. Estamos encantados de tenerte.</p>
+          <p><a href="{{actionUrl}}">Comenzar ahora</a></p>
+        `
+      },
+      inApp: {
+        title: "¡Bienvenido a {{appName}}!",
+        body: "Gracias por unirte. Haz clic para completar tu perfil.",
+        actionUrl: "{{actionUrl}}"
+      }
+    }
   }
 });
 var OrgInviteTemplate = defineTemplate({
@@ -763,6 +981,40 @@ var OrgInviteTemplate = defineTemplate({
       actionUrl: "{{actionUrl}}",
       actionText: "Accept"
     }
+  },
+  localeChannels: {
+    fr: {
+      email: {
+        subject: "{{inviterName}} vous invite à rejoindre {{orgName}}",
+        body: `
+          <h1>Vous êtes invité !</h1>
+          <p>{{inviterName}} vous a invité à rejoindre <strong>{{orgName}}</strong> en tant que {{role}}.</p>
+          <p><a href="{{actionUrl}}">Accepter l’invitation</a></p>
+        `
+      },
+      inApp: {
+        title: "Invitation à {{orgName}}",
+        body: "{{inviterName}} vous a invité à rejoindre en tant que {{role}}.",
+        actionUrl: "{{actionUrl}}",
+        actionText: "Accepter"
+      }
+    },
+    es: {
+      email: {
+        subject: "{{inviterName}} te invitó a unirte a {{orgName}}",
+        body: `
+          <h1>¡Has sido invitado!</h1>
+          <p>{{inviterName}} te ha invitado a unirte a <strong>{{orgName}}</strong> como {{role}}.</p>
+          <p><a href="{{actionUrl}}">Aceptar invitación</a></p>
+        `
+      },
+      inApp: {
+        title: "Invitación a {{orgName}}",
+        body: "{{inviterName}} te invitó a unirte como {{role}}.",
+        actionUrl: "{{actionUrl}}",
+        actionText: "Aceptar"
+      }
+    }
   }
 });
 var MentionTemplate = defineTemplate({
@@ -787,6 +1039,30 @@ var MentionTemplate = defineTemplate({
       title: "{{mentionerName}} mentioned you",
       body: "{{preview}}"
     }
+  },
+  localeChannels: {
+    fr: {
+      inApp: {
+        title: "{{mentionerName}} vous a mentionné",
+        body: "Dans {{context}} : « {{preview}} »",
+        actionUrl: "{{actionUrl}}"
+      },
+      push: {
+        title: "{{mentionerName}} vous a mentionné",
+        body: "{{preview}}"
+      }
+    },
+    es: {
+      inApp: {
+        title: "{{mentionerName}} te mencionó",
+        body: 'En {{context}}: "{{preview}}"',
+        actionUrl: "{{actionUrl}}"
+      },
+      push: {
+        title: "{{mentionerName}} te mencionó",
+        body: "{{preview}}"
+      }
+    }
   }
 });
 

package/dist/node/notifications.capability.js

@@ -1,3 +1,15 @@
+var __defProp = Object.defineProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: (newValue) => all[name] = () => newValue
+    });
+};
+var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
+
 // src/notifications.capability.ts
 import {
   defineCapability,

package/dist/node/notifications.feature.js

@@ -1,3 +1,15 @@
+var __defProp = Object.defineProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: (newValue) => all[name] = () => newValue
+    });
+};
+var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
+
 // src/notifications.feature.ts
 import { defineFeature } from "@contractspec/lib.contracts-spec";
 var NotificationsFeature = defineFeature({

package/dist/node/templates/index.js

@@ -1,3 +1,15 @@
+var __defProp = Object.defineProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: (newValue) => all[name] = () => newValue
+    });
+};
+var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
+
 // src/templates/index.ts
 function defineTemplate(def) {
   return def;
@@ -11,8 +23,8 @@ function renderTemplate(content, variables) {
     return String(value);
   });
 }
-function renderNotificationTemplate(template, channel, variables) {
-  const channelContent = template.channels[channel];
+function renderNotificationTemplate(template, channel, variables, locale) {
+  const channelContent = (locale && template.localeChannels?.[locale]?.[channel]) ?? template.channels[channel];
   if (!channelContent) {
     return null;
   }
@@ -80,6 +92,38 @@ var WelcomeTemplate = defineTemplate({
       body: "Thanks for joining. Click to complete your profile.",
       actionUrl: "{{actionUrl}}"
     }
+  },
+  localeChannels: {
+    fr: {
+      email: {
+        subject: "Bienvenue sur {{appName}}, {{name}} !",
+        body: `
+          <h1>Bienvenue, {{name}} !</h1>
+          <p>Merci d’avoir rejoint {{appName}}. Nous sommes ravis de vous compter parmi nous.</p>
+          <p><a href="{{actionUrl}}">Commencer maintenant</a></p>
+        `
+      },
+      inApp: {
+        title: "Bienvenue sur {{appName}} !",
+        body: "Merci de nous avoir rejoint. Cliquez pour compléter votre profil.",
+        actionUrl: "{{actionUrl}}"
+      }
+    },
+    es: {
+      email: {
+        subject: "¡Bienvenido a {{appName}}, {{name}}!",
+        body: `
+          <h1>¡Bienvenido, {{name}}!</h1>
+          <p>Gracias por unirte a {{appName}}. Estamos encantados de tenerte.</p>
+          <p><a href="{{actionUrl}}">Comenzar ahora</a></p>
+        `
+      },
+      inApp: {
+        title: "¡Bienvenido a {{appName}}!",
+        body: "Gracias por unirte. Haz clic para completar tu perfil.",
+        actionUrl: "{{actionUrl}}"
+      }
+    }
   }
 });
 var OrgInviteTemplate = defineTemplate({
@@ -109,6 +153,40 @@ var OrgInviteTemplate = defineTemplate({
       actionUrl: "{{actionUrl}}",
       actionText: "Accept"
     }
+  },
+  localeChannels: {
+    fr: {
+      email: {
+        subject: "{{inviterName}} vous invite à rejoindre {{orgName}}",
+        body: `
+          <h1>Vous êtes invité !</h1>
+          <p>{{inviterName}} vous a invité à rejoindre <strong>{{orgName}}</strong> en tant que {{role}}.</p>
+          <p><a href="{{actionUrl}}">Accepter l’invitation</a></p>
+        `
+      },
+      inApp: {
+        title: "Invitation à {{orgName}}",
+        body: "{{inviterName}} vous a invité à rejoindre en tant que {{role}}.",
+        actionUrl: "{{actionUrl}}",
+        actionText: "Accepter"
+      }
+    },
+    es: {
+      email: {
+        subject: "{{inviterName}} te invitó a unirte a {{orgName}}",
+        body: `
+          <h1>¡Has sido invitado!</h1>
+          <p>{{inviterName}} te ha invitado a unirte a <strong>{{orgName}}</strong> como {{role}}.</p>
+          <p><a href="{{actionUrl}}">Aceptar invitación</a></p>
+        `
+      },
+      inApp: {
+        title: "Invitación a {{orgName}}",
+        body: "{{inviterName}} te invitó a unirte como {{role}}.",
+        actionUrl: "{{actionUrl}}",
+        actionText: "Aceptar"
+      }
+    }
   }
 });
 var MentionTemplate = defineTemplate({
@@ -133,6 +211,30 @@ var MentionTemplate = defineTemplate({
       title: "{{mentionerName}} mentioned you",
       body: "{{preview}}"
     }
+  },
+  localeChannels: {
+    fr: {
+      inApp: {
+        title: "{{mentionerName}} vous a mentionné",
+        body: "Dans {{context}} : « {{preview}} »",
+        actionUrl: "{{actionUrl}}"
+      },
+      push: {
+        title: "{{mentionerName}} vous a mentionné",
+        body: "{{preview}}"
+      }
+    },
+    es: {
+      inApp: {
+        title: "{{mentionerName}} te mencionó",
+        body: 'En {{context}}: "{{preview}}"',
+        actionUrl: "{{actionUrl}}"
+      },
+      push: {
+        title: "{{mentionerName}} te mencionó",
+        body: "{{preview}}"
+      }
+    }
   }
 });
 export {

package/dist/notifications.capability.js

@@ -1,4 +1,16 @@
 // @bun
+var __defProp = Object.defineProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: (newValue) => all[name] = () => newValue
+    });
+};
+var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
+
 // src/notifications.capability.ts
 import {
   defineCapability,

package/dist/notifications.feature.js

@@ -1,4 +1,16 @@
 // @bun
+var __defProp = Object.defineProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: (newValue) => all[name] = () => newValue
+    });
+};
+var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
+
 // src/notifications.feature.ts
 import { defineFeature } from "@contractspec/lib.contracts-spec";
 var NotificationsFeature = defineFeature({

package/dist/templates/index.d.ts

@@ -18,6 +18,13 @@ export interface ChannelTemplateContent {
     actionUrl?: string;
     actionText?: string;
 }
+/** Channel content map for a template. */
+export interface ChannelContentMap {
+    email?: ChannelTemplateContent;
+    inApp?: ChannelTemplateContent;
+    push?: ChannelTemplateContent;
+    webhook?: ChannelTemplateContent;
+}
 /**
  * Notification template definition.
  */
@@ -28,12 +35,12 @@ export interface NotificationTemplateDefinition {
     category?: string;
     variables?: TemplateVariable[];
     defaultChannels?: string[];
-    channels: {
-        email?: ChannelTemplateContent;
-        inApp?: ChannelTemplateContent;
-        push?: ChannelTemplateContent;
-        webhook?: ChannelTemplateContent;
-    };
+    channels: ChannelContentMap;
+    /**
+     * Per-locale channel content overrides.
+     * Falls back to `channels` for unlisted locales.
+     */
+    localeChannels?: Record<string, Partial<ChannelContentMap>>;
 }
 /**
  * Rendered notification content.
@@ -58,8 +65,11 @@ export declare function defineTemplate(def: NotificationTemplateDefinition): Not
 export declare function renderTemplate(content: string, variables: Record<string, unknown>): string;
 /**
  * Render a notification template for a specific channel.
+ *
+ * When `locale` is provided, the renderer first looks for channel content
+ * under `localeChannels[locale]`, falling back to the default `channels`.
  */
-export declare function renderNotificationTemplate(template: NotificationTemplateDefinition, channel: keyof NotificationTemplateDefinition['channels'], variables: Record<string, unknown>): RenderedNotification | null;
+export declare function renderNotificationTemplate(template: NotificationTemplateDefinition, channel: keyof ChannelContentMap, variables: Record<string, unknown>, locale?: string): RenderedNotification | null;
 /**
  * Template registry for managing templates.
  */