@open-mercato/core 0.6.8-develop.6983.1.e4f794099e → 0.6.8-develop.6985.1.fb93574faa

package/dist/modules/notifications/lib/typeCatalogue.js

@@ -0,0 +1,71 @@
+import { LockMode } from "@mikro-orm/core";
+import { detectLocale, loadDictionary } from "@open-mercato/shared/lib/i18n/server";
+import { createFallbackTranslator } from "@open-mercato/shared/lib/i18n/translate";
+import { resolveSupportedLocale } from "@open-mercato/shared/lib/i18n/locale";
+import { resolveLocaleFromRequest } from "../../translations/lib/locale.js";
+import { NotificationTypeOverride } from "../data/entities.js";
+import { getNotificationDeliveryStrategies } from "./deliveryStrategies.js";
+import { getNotificationType } from "./notification-type-registry.js";
+const CATEGORY_LABEL_KEY_PREFIX = "notifications.categories.";
+async function resolveCatalogueTranslate(req) {
+  const requested = resolveSupportedLocale(resolveLocaleFromRequest(req));
+  const locale = requested ?? await detectLocale();
+  return createFallbackTranslator(await loadDictionary(locale));
+}
+const typeItem = (row, override, translate) => ({
+  id: row.id,
+  labelKey: row.labelKey,
+  descriptionKey: row.descriptionKey ?? null,
+  category: row.category ?? null,
+  categoryLabel: row.category ? translate(`${CATEGORY_LABEL_KEY_PREFIX}${row.category}`, row.category) : null,
+  label: row.labelKey ? translate(row.labelKey, row.id) : null,
+  description: row.descriptionKey ? translate(row.descriptionKey, "") : null,
+  silent: row.silent === true,
+  nonOptOut: (override?.nonOptOut ?? row.nonOptOut) === true,
+  channels: override?.channels ?? getNotificationType(row.id)?.channels ?? null,
+  storedChannels: override?.channels ?? null,
+  storedNonOptOut: override?.nonOptOut ?? null,
+  updatedAt: override?.updatedAt ? override.updatedAt.toISOString() : null
+});
+function resolveRegisteredChannelIds() {
+  return getNotificationDeliveryStrategies().map((strategy) => strategy.id);
+}
+function resolveEffectiveChannels(typeId, storedChannels, registeredChannelIds) {
+  return storedChannels ?? getNotificationType(typeId)?.channels ?? registeredChannelIds;
+}
+function loadTypeOverrideForUpdate(em, tenantId, notificationTypeId) {
+  return em.findOne(
+    NotificationTypeOverride,
+    { tenantId, notificationTypeId },
+    { lockMode: LockMode.PESSIMISTIC_WRITE }
+  );
+}
+function applyTypeOverride(em, input) {
+  const { tenantId, notificationTypeId, existing, nextChannels, nextNonOptOut } = input;
+  if (nextChannels === null && nextNonOptOut === null) {
+    if (existing) em.remove(existing);
+    return null;
+  }
+  if (existing) {
+    existing.channels = nextChannels;
+    existing.nonOptOut = nextNonOptOut;
+    return existing;
+  }
+  const created = em.create(NotificationTypeOverride, {
+    tenantId,
+    notificationTypeId,
+    channels: nextChannels,
+    nonOptOut: nextNonOptOut
+  });
+  em.persist(created);
+  return created;
+}
+export {
+  applyTypeOverride,
+  loadTypeOverrideForUpdate,
+  resolveCatalogueTranslate,
+  resolveEffectiveChannels,
+  resolveRegisteredChannelIds,
+  typeItem
+};
+//# sourceMappingURL=typeCatalogue.js.map

package/dist/modules/notifications/lib/typeCatalogue.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/notifications/lib/typeCatalogue.ts"],
+  "sourcesContent": ["import { LockMode } from '@mikro-orm/core'\nimport type { EntityManager } from '@mikro-orm/postgresql'\nimport { detectLocale, loadDictionary } from '@open-mercato/shared/lib/i18n/server'\nimport { createFallbackTranslator } from '@open-mercato/shared/lib/i18n/translate'\nimport { resolveSupportedLocale } from '@open-mercato/shared/lib/i18n/locale'\nimport { resolveLocaleFromRequest } from '../../translations/lib/locale'\nimport { NotificationType, NotificationTypeOverride } from '../data/entities'\nimport { getNotificationDeliveryStrategies } from './deliveryStrategies'\nimport { getNotificationType } from './notification-type-registry'\n\nconst CATEGORY_LABEL_KEY_PREFIX = 'notifications.categories.'\n\nexport type CatalogueTranslate = (key: string, fallback: string) => string\n\n/**\n * Locale for the display strings, following the repo-wide request-locale convention\n * (`resolveLocaleFromRequest`: `?locale=` \u2192 `x-locale` \u2192 cookie \u2192 `Accept-Language`).\n * Only the `Accept-Language` branch of that helper validates its input, so the result is\n * re-checked against the supported set here \u2014 an unsupported `?locale=zz` would otherwise\n * load an empty dictionary instead of degrading. Falls back to ambient detection, which\n * also honours `OM_FORCE_LOCALE`.\n */\nexport async function resolveCatalogueTranslate(req: Request): Promise<CatalogueTranslate> {\n  const requested = resolveSupportedLocale(resolveLocaleFromRequest(req))\n  const locale = requested ?? (await detectLocale())\n  return createFallbackTranslator(await loadDictionary(locale))\n}\n\n/**\n * Catalogue item with the caller tenant's stored overrides merged in \u2014 matching\n * `resolveEligibleChannels` in the delivery gate, so preference UIs lock exactly the cells\n * delivery would reject. `channels: null` = no restriction (every registered channel).\n * `updatedAt` is the override row's version token for optimistic locking (`null` when the\n * tenant stores no override yet).\n *\n * `label` / `description` / `categoryLabel` are resolved server-side so clients without the\n * Open Mercato dictionary (the mobile app) can render the screen directly. Group on\n * `category` \u2014 the raw key, stable across locales \u2014 and display `categoryLabel`; grouping on\n * the localized string re-partitions the list whenever the language changes.\n *\n * A category whose owning module ships no `notifications.categories.<key>` entry falls back\n * to the raw key, so `categoryLabel === category` signals to a client that no server-side\n * translation exists and it may apply its own presentation.\n */\nexport const typeItem = (\n  row: NotificationType,\n  override: NotificationTypeOverride | null | undefined,\n  translate: CatalogueTranslate,\n) => ({\n  id: row.id,\n  labelKey: row.labelKey,\n  descriptionKey: row.descriptionKey ?? null,\n  category: row.category ?? null,\n  categoryLabel: row.category\n    ? translate(`${CATEGORY_LABEL_KEY_PREFIX}${row.category}`, row.category)\n    : null,\n  label: row.labelKey ? translate(row.labelKey, row.id) : null,\n  description: row.descriptionKey ? translate(row.descriptionKey, '') : null,\n  silent: row.silent === true,\n  nonOptOut: (override?.nonOptOut ?? row.nonOptOut) === true,\n  channels: override?.channels ?? getNotificationType(row.id)?.channels ?? null,\n  storedChannels: override?.channels ?? null,\n  storedNonOptOut: override?.nonOptOut ?? null,\n  updatedAt: override?.updatedAt ? override.updatedAt.toISOString() : null,\n})\n\n/** Ids of every registered delivery channel (`in_app`, `email`, `push`, \u2026). */\nexport function resolveRegisteredChannelIds(): string[] {\n  return getNotificationDeliveryStrategies().map((strategy) => strategy.id)\n}\n\n/**\n * The channel set a per-channel toggle applies to, resolved server-side so a client never\n * has to send a whole replacing array. Mirrors what the catalogue exposes as the effective\n * set \u2014 stored override, else the code declaration, else every registered channel (the\n * `channels: null` \"no restriction\" case, which a toggle has to materialize before it can\n * remove one entry from it).\n */\nexport function resolveEffectiveChannels(\n  typeId: string,\n  storedChannels: string[] | null | undefined,\n  registeredChannelIds: string[],\n): string[] {\n  return storedChannels ?? getNotificationType(typeId)?.channels ?? registeredChannelIds\n}\n\n/**\n * Load the tenant's override row for a type under a row lock, so a read-modify-write of the\n * `channels` array serializes against a concurrent one instead of last-write-wins. Returns\n * `null` when no override is stored yet (nothing exists to lock \u2014 that first-write race is\n * caught by the partial unique index instead).\n */\nexport function loadTypeOverrideForUpdate(\n  em: EntityManager,\n  tenantId: string,\n  notificationTypeId: string,\n): Promise<NotificationTypeOverride | null> {\n  return em.findOne(\n    NotificationTypeOverride,\n    { tenantId, notificationTypeId },\n    { lockMode: LockMode.PESSIMISTIC_WRITE },\n  )\n}\n\n/**\n * Apply the resolved override values to the tenant's row, creating, updating or dropping it.\n * Shared by the full-array `PATCH` and the per-channel add/remove sub-resource so both agree\n * on the \"all overrides cleared \u21D2 remove the row\" rule. Does NOT flush \u2014 the caller owns the\n * transaction boundary and the unique-violation handling.\n */\nexport function applyTypeOverride(\n  em: EntityManager,\n  input: {\n    tenantId: string\n    notificationTypeId: string\n    existing: NotificationTypeOverride | null\n    nextChannels: string[] | null\n    nextNonOptOut: boolean | null\n  },\n): NotificationTypeOverride | null {\n  const { tenantId, notificationTypeId, existing, nextChannels, nextNonOptOut } = input\n  if (nextChannels === null && nextNonOptOut === null) {\n    // Both overrides cleared \u21D2 the code declarations apply again; drop the row\n    // instead of keeping an all-null husk.\n    if (existing) em.remove(existing)\n    return null\n  }\n  if (existing) {\n    existing.channels = nextChannels\n    existing.nonOptOut = nextNonOptOut\n    return existing\n  }\n  const created = em.create(NotificationTypeOverride, {\n    tenantId,\n    notificationTypeId,\n    channels: nextChannels,\n    nonOptOut: nextNonOptOut,\n  })\n  em.persist(created)\n  return created\n}\n"],
+  "mappings": "AAAA,SAAS,gBAAgB;AAEzB,SAAS,cAAc,sBAAsB;AAC7C,SAAS,gCAAgC;AACzC,SAAS,8BAA8B;AACvC,SAAS,gCAAgC;AACzC,SAA2B,gCAAgC;AAC3D,SAAS,yCAAyC;AAClD,SAAS,2BAA2B;AAEpC,MAAM,4BAA4B;AAYlC,eAAsB,0BAA0B,KAA2C;AACzF,QAAM,YAAY,uBAAuB,yBAAyB,GAAG,CAAC;AACtE,QAAM,SAAS,aAAc,MAAM,aAAa;AAChD,SAAO,yBAAyB,MAAM,eAAe,MAAM,CAAC;AAC9D;AAkBO,MAAM,WAAW,CACtB,KACA,UACA,eACI;AAAA,EACJ,IAAI,IAAI;AAAA,EACR,UAAU,IAAI;AAAA,EACd,gBAAgB,IAAI,kBAAkB;AAAA,EACtC,UAAU,IAAI,YAAY;AAAA,EAC1B,eAAe,IAAI,WACf,UAAU,GAAG,yBAAyB,GAAG,IAAI,QAAQ,IAAI,IAAI,QAAQ,IACrE;AAAA,EACJ,OAAO,IAAI,WAAW,UAAU,IAAI,UAAU,IAAI,EAAE,IAAI;AAAA,EACxD,aAAa,IAAI,iBAAiB,UAAU,IAAI,gBAAgB,EAAE,IAAI;AAAA,EACtE,QAAQ,IAAI,WAAW;AAAA,EACvB,YAAY,UAAU,aAAa,IAAI,eAAe;AAAA,EACtD,UAAU,UAAU,YAAY,oBAAoB,IAAI,EAAE,GAAG,YAAY;AAAA,EACzE,gBAAgB,UAAU,YAAY;AAAA,EACtC,iBAAiB,UAAU,aAAa;AAAA,EACxC,WAAW,UAAU,YAAY,SAAS,UAAU,YAAY,IAAI;AACtE;AAGO,SAAS,8BAAwC;AACtD,SAAO,kCAAkC,EAAE,IAAI,CAAC,aAAa,SAAS,EAAE;AAC1E;AASO,SAAS,yBACd,QACA,gBACA,sBACU;AACV,SAAO,kBAAkB,oBAAoB,MAAM,GAAG,YAAY;AACpE;AAQO,SAAS,0BACd,IACA,UACA,oBAC0C;AAC1C,SAAO,GAAG;AAAA,IACR;AAAA,IACA,EAAE,UAAU,mBAAmB;AAAA,IAC/B,EAAE,UAAU,SAAS,kBAAkB;AAAA,EACzC;AACF;AAQO,SAAS,kBACd,IACA,OAOiC;AACjC,QAAM,EAAE,UAAU,oBAAoB,UAAU,cAAc,cAAc,IAAI;AAChF,MAAI,iBAAiB,QAAQ,kBAAkB,MAAM;AAGnD,QAAI,SAAU,IAAG,OAAO,QAAQ;AAChC,WAAO;AAAA,EACT;AACA,MAAI,UAAU;AACZ,aAAS,WAAW;AACpB,aAAS,YAAY;AACrB,WAAO;AAAA,EACT;AACA,QAAM,UAAU,GAAG,OAAO,0BAA0B;AAAA,IAClD;AAAA,IACA;AAAA,IACA,UAAU;AAAA,IACV,WAAW;AAAA,EACb,CAAC;AACD,KAAG,QAAQ,OAAO;AAClB,SAAO;AACT;",
+  "names": []
+}

package/dist/modules/notifications/lib/typeChannelSettings.js

@@ -0,0 +1,12 @@
+function computeNextChannels(effective, channelId, enabled) {
+  return enabled ? Array.from(/* @__PURE__ */ new Set([...effective, channelId])) : effective.filter((channel) => channel !== channelId);
+}
+function computeChannelsPatch(effective, channelId, enabled) {
+  const next = computeNextChannels(effective, channelId, enabled);
+  return next.length > 0 ? next : null;
+}
+export {
+  computeChannelsPatch,
+  computeNextChannels
+};
+//# sourceMappingURL=typeChannelSettings.js.map

package/dist/modules/notifications/lib/typeChannelSettings.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/notifications/lib/typeChannelSettings.ts"],
+  "sourcesContent": ["/**\n * Next eligibility set after toggling one channel in the admin type-catalogue\n * table, based on the EFFECTIVE set (tenant override ?? code ?? all registered\n * channels) \u2014 the stored array replaces the code-declared set wholesale.\n */\nexport function computeNextChannels(\n  effective: string[],\n  channelId: string,\n  enabled: boolean,\n): string[] {\n  return enabled\n    ? Array.from(new Set([...effective, channelId]))\n    : effective.filter((channel) => channel !== channelId)\n}\n\n/**\n * The `channels` value to PATCH after one toggle: the next eligibility set, or `null` when the\n * toggle empties it (unchecking the last channel). Persisting `[]` would black-hole the type\n * (invisible + undelivered) and is rejected by the API \u2014 `null` clears the override so the\n * code-declared default reapplies.\n */\nexport function computeChannelsPatch(\n  effective: string[],\n  channelId: string,\n  enabled: boolean,\n): string[] | null {\n  const next = computeNextChannels(effective, channelId, enabled)\n  return next.length > 0 ? next : null\n}\n"],
+  "mappings": "AAKO,SAAS,oBACd,WACA,WACA,SACU;AACV,SAAO,UACH,MAAM,KAAK,oBAAI,IAAI,CAAC,GAAG,WAAW,SAAS,CAAC,CAAC,IAC7C,UAAU,OAAO,CAAC,YAAY,YAAY,SAAS;AACzD;AAQO,SAAS,qBACd,WACA,WACA,SACiB;AACjB,QAAM,OAAO,oBAAoB,WAAW,WAAW,OAAO;AAC9D,SAAO,KAAK,SAAS,IAAI,OAAO;AAClC;",
+  "names": []
+}

package/dist/modules/notifications/lib/typeOverrides.js

@@ -0,0 +1,19 @@
+async function getNotificationTypeOverrides(em, tenantId, typeIds) {
+  const result = /* @__PURE__ */ new Map();
+  const uniqueIds = Array.from(new Set(typeIds)).filter((id) => id.length > 0);
+  if (!uniqueIds.length || !tenantId) return result;
+  const db = em.getKysely();
+  const rows = await db.selectFrom("notification_type_overrides").select(["notification_type_id", "channels", "non_opt_out"]).where("tenant_id", "=", tenantId).where("notification_type_id", "in", uniqueIds).execute();
+  for (const row of rows) {
+    const channels = Array.isArray(row.channels) ? row.channels : null;
+    const nonOptOut = typeof row.non_opt_out === "boolean" ? row.non_opt_out : null;
+    if (channels !== null || nonOptOut !== null) {
+      result.set(row.notification_type_id, { channels, nonOptOut });
+    }
+  }
+  return result;
+}
+export {
+  getNotificationTypeOverrides
+};
+//# sourceMappingURL=typeOverrides.js.map

package/dist/modules/notifications/lib/typeOverrides.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/notifications/lib/typeOverrides.ts"],
+  "sourcesContent": ["import type { EntityManager } from '@mikro-orm/postgresql'\nimport type { Kysely } from 'kysely'\n\n/**\n * Tenant-scoped operator overrides of a notification type's delivery contract,\n * read from `notification_type_overrides`. Types without a row (or whose row\n * stores neither field) are absent from the map \u2014 the code declarations apply.\n * Used by the create-time gate, the deliver-subscriber recompute, and the\n * preference write path so `shouldDeliver` applies the same effective\n * eligibility + opt-out governance the types API reports.\n */\nexport type NotificationTypeOverrides = {\n  /** Stored eligibility override; `null` \u21D2 inherit the code-declared `type.channels`. */\n  channels: string[] | null\n  /** Stored `nonOptOut` override; `null` \u21D2 inherit the code-declared flag. */\n  nonOptOut: boolean | null\n}\n\nexport async function getNotificationTypeOverrides(\n  em: EntityManager,\n  tenantId: string,\n  typeIds: string[],\n): Promise<Map<string, NotificationTypeOverrides>> {\n  const result = new Map<string, NotificationTypeOverrides>()\n  const uniqueIds = Array.from(new Set(typeIds)).filter((id) => id.length > 0)\n  if (!uniqueIds.length || !tenantId) return result\n  const db = em.getKysely<any>() as Kysely<any>\n  const rows = (await db\n    .selectFrom('notification_type_overrides')\n    .select(['notification_type_id', 'channels', 'non_opt_out'])\n    .where('tenant_id', '=', tenantId)\n    .where('notification_type_id', 'in', uniqueIds)\n    .execute()) as Array<{\n    notification_type_id: string\n    channels: string[] | null\n    non_opt_out: boolean | null\n  }>\n  for (const row of rows) {\n    const channels = Array.isArray(row.channels) ? row.channels : null\n    const nonOptOut = typeof row.non_opt_out === 'boolean' ? row.non_opt_out : null\n    if (channels !== null || nonOptOut !== null) {\n      result.set(row.notification_type_id, { channels, nonOptOut })\n    }\n  }\n  return result\n}\n"],
+  "mappings": "AAkBA,eAAsB,6BACpB,IACA,UACA,SACiD;AACjD,QAAM,SAAS,oBAAI,IAAuC;AAC1D,QAAM,YAAY,MAAM,KAAK,IAAI,IAAI,OAAO,CAAC,EAAE,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC;AAC3E,MAAI,CAAC,UAAU,UAAU,CAAC,SAAU,QAAO;AAC3C,QAAM,KAAK,GAAG,UAAe;AAC7B,QAAM,OAAQ,MAAM,GACjB,WAAW,6BAA6B,EACxC,OAAO,CAAC,wBAAwB,YAAY,aAAa,CAAC,EAC1D,MAAM,aAAa,KAAK,QAAQ,EAChC,MAAM,wBAAwB,MAAM,SAAS,EAC7C,QAAQ;AAKX,aAAW,OAAO,MAAM;AACtB,UAAM,WAAW,MAAM,QAAQ,IAAI,QAAQ,IAAI,IAAI,WAAW;AAC9D,UAAM,YAAY,OAAO,IAAI,gBAAgB,YAAY,IAAI,cAAc;AAC3E,QAAI,aAAa,QAAQ,cAAc,MAAM;AAC3C,aAAO,IAAI,IAAI,sBAAsB,EAAE,UAAU,UAAU,CAAC;AAAA,IAC9D;AAAA,EACF;AACA,SAAO;AACT;",
+  "names": []
+}

package/dist/modules/notifications/migrations/Migration20260625122947_notifications.js

@@ -0,0 +1,14 @@
+import { Migration } from "@mikro-orm/migrations";
+class Migration20260625122947_notifications extends Migration {
+  up() {
+    this.addSql(`create table "notification_preferences" ("id" uuid not null default gen_random_uuid(), "tenant_id" uuid not null, "user_id" uuid not null, "notification_type_id" text not null, "channel" text not null, "enabled" boolean not null default true, "created_at" timestamptz not null, "updated_at" timestamptz not null, primary key ("id"));`);
+    this.addSql(`create unique index "notification_preferences_unique" on "notification_preferences" ("tenant_id", "user_id", "notification_type_id", "channel");`);
+    this.addSql(`create index "notification_preferences_tenant_user_idx" on "notification_preferences" ("tenant_id", "user_id");`);
+    this.addSql(`create table "notification_types" ("id" text not null, "tenant_id" uuid null, "label_key" text not null, "description_key" text null, "created_at" timestamptz not null, "updated_at" timestamptz not null, primary key ("id"));`);
+    this.addSql(`create index "notification_types_tenant_idx" on "notification_types" ("tenant_id");`);
+  }
+}
+export {
+  Migration20260625122947_notifications
+};
+//# sourceMappingURL=Migration20260625122947_notifications.js.map

package/dist/modules/notifications/migrations/Migration20260625122947_notifications.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/notifications/migrations/Migration20260625122947_notifications.ts"],
+  "sourcesContent": ["import { Migration } from '@mikro-orm/migrations';\n\nexport class Migration20260625122947_notifications extends Migration {\n\n  override up(): void | Promise<void> {\n    this.addSql(`create table \"notification_preferences\" (\"id\" uuid not null default gen_random_uuid(), \"tenant_id\" uuid not null, \"user_id\" uuid not null, \"notification_type_id\" text not null, \"channel\" text not null, \"enabled\" boolean not null default true, \"created_at\" timestamptz not null, \"updated_at\" timestamptz not null, primary key (\"id\"));`);\n    this.addSql(`create unique index \"notification_preferences_unique\" on \"notification_preferences\" (\"tenant_id\", \"user_id\", \"notification_type_id\", \"channel\");`);\n    this.addSql(`create index \"notification_preferences_tenant_user_idx\" on \"notification_preferences\" (\"tenant_id\", \"user_id\");`);\n\n    this.addSql(`create table \"notification_types\" (\"id\" text not null, \"tenant_id\" uuid null, \"label_key\" text not null, \"description_key\" text null, \"created_at\" timestamptz not null, \"updated_at\" timestamptz not null, primary key (\"id\"));`);\n    this.addSql(`create index \"notification_types_tenant_idx\" on \"notification_types\" (\"tenant_id\");`);\n  }\n\n}\n"],
+  "mappings": "AAAA,SAAS,iBAAiB;AAEnB,MAAM,8CAA8C,UAAU;AAAA,EAE1D,KAA2B;AAClC,SAAK,OAAO,+UAA+U;AAC3V,SAAK,OAAO,kJAAkJ;AAC9J,SAAK,OAAO,iHAAiH;AAE7H,SAAK,OAAO,kOAAkO;AAC9O,SAAK,OAAO,qFAAqF;AAAA,EACnG;AAEF;",
+  "names": []
+}

package/dist/modules/notifications/migrations/Migration20260626120500_notifications_push_payload.js

@@ -0,0 +1,15 @@
+import { Migration } from "@mikro-orm/migrations";
+class Migration20260626120500_notifications_push_payload extends Migration {
+  up() {
+    this.addSql(`alter table "notifications" add column "data" jsonb null;`);
+    this.addSql(`alter table "notifications" add column "push_options" jsonb null;`);
+  }
+  down() {
+    this.addSql(`alter table "notifications" drop column "push_options";`);
+    this.addSql(`alter table "notifications" drop column "data";`);
+  }
+}
+export {
+  Migration20260626120500_notifications_push_payload
+};
+//# sourceMappingURL=Migration20260626120500_notifications_push_payload.js.map

package/dist/modules/notifications/migrations/Migration20260626120500_notifications_push_payload.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/notifications/migrations/Migration20260626120500_notifications_push_payload.ts"],
+  "sourcesContent": ["import { Migration } from '@mikro-orm/migrations';\n\nexport class Migration20260626120500_notifications_push_payload extends Migration {\n\n  override up(): void | Promise<void> {\n    this.addSql(`alter table \"notifications\" add column \"data\" jsonb null;`);\n    this.addSql(`alter table \"notifications\" add column \"push_options\" jsonb null;`);\n  }\n\n  override down(): void | Promise<void> {\n    this.addSql(`alter table \"notifications\" drop column \"push_options\";`);\n    this.addSql(`alter table \"notifications\" drop column \"data\";`);\n  }\n\n}\n"],
+  "mappings": "AAAA,SAAS,iBAAiB;AAEnB,MAAM,2DAA2D,UAAU;AAAA,EAEvE,KAA2B;AAClC,SAAK,OAAO,2DAA2D;AACvE,SAAK,OAAO,mEAAmE;AAAA,EACjF;AAAA,EAES,OAA6B;AACpC,SAAK,OAAO,yDAAyD;AACrE,SAAK,OAAO,iDAAiD;AAAA,EAC/D;AAEF;",
+  "names": []
+}

package/dist/modules/notifications/migrations/Migration20260626130000_notifications_non_opt_out.js

@@ -0,0 +1,13 @@
+import { Migration } from "@mikro-orm/migrations";
+class Migration20260626130000_notifications_non_opt_out extends Migration {
+  up() {
+    this.addSql(`alter table "notification_types" add column "non_opt_out" boolean not null default false;`);
+  }
+  down() {
+    this.addSql(`alter table "notification_types" drop column "non_opt_out";`);
+  }
+}
+export {
+  Migration20260626130000_notifications_non_opt_out
+};
+//# sourceMappingURL=Migration20260626130000_notifications_non_opt_out.js.map

package/dist/modules/notifications/migrations/Migration20260626130000_notifications_non_opt_out.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/notifications/migrations/Migration20260626130000_notifications_non_opt_out.ts"],
+  "sourcesContent": ["import { Migration } from '@mikro-orm/migrations';\n\nexport class Migration20260626130000_notifications_non_opt_out extends Migration {\n\n  override up(): void | Promise<void> {\n    this.addSql(`alter table \"notification_types\" add column \"non_opt_out\" boolean not null default false;`);\n  }\n\n  override down(): void | Promise<void> {\n    this.addSql(`alter table \"notification_types\" drop column \"non_opt_out\";`);\n  }\n\n}\n"],
+  "mappings": "AAAA,SAAS,iBAAiB;AAEnB,MAAM,0DAA0D,UAAU;AAAA,EAEtE,KAA2B;AAClC,SAAK,OAAO,2FAA2F;AAAA,EACzG;AAAA,EAES,OAA6B;AACpC,SAAK,OAAO,6DAA6D;AAAA,EAC3E;AAEF;",
+  "names": []
+}

package/dist/modules/notifications/migrations/Migration20260626140000_notifications_type_category_silent.js

@@ -0,0 +1,15 @@
+import { Migration } from "@mikro-orm/migrations";
+class Migration20260626140000_notifications_type_category_silent extends Migration {
+  up() {
+    this.addSql(`alter table "notification_types" add column "category" text null;`);
+    this.addSql(`alter table "notification_types" add column "silent" boolean not null default false;`);
+  }
+  down() {
+    this.addSql(`alter table "notification_types" drop column "silent";`);
+    this.addSql(`alter table "notification_types" drop column "category";`);
+  }
+}
+export {
+  Migration20260626140000_notifications_type_category_silent
+};
+//# sourceMappingURL=Migration20260626140000_notifications_type_category_silent.js.map

package/dist/modules/notifications/migrations/Migration20260626140000_notifications_type_category_silent.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/notifications/migrations/Migration20260626140000_notifications_type_category_silent.ts"],
+  "sourcesContent": ["import { Migration } from '@mikro-orm/migrations';\n\nexport class Migration20260626140000_notifications_type_category_silent extends Migration {\n\n  override up(): void | Promise<void> {\n    this.addSql(`alter table \"notification_types\" add column \"category\" text null;`);\n    this.addSql(`alter table \"notification_types\" add column \"silent\" boolean not null default false;`);\n  }\n\n  override down(): void | Promise<void> {\n    this.addSql(`alter table \"notification_types\" drop column \"silent\";`);\n    this.addSql(`alter table \"notification_types\" drop column \"category\";`);\n  }\n\n}\n"],
+  "mappings": "AAAA,SAAS,iBAAiB;AAEnB,MAAM,mEAAmE,UAAU;AAAA,EAE/E,KAA2B;AAClC,SAAK,OAAO,mEAAmE;AAC/E,SAAK,OAAO,sFAAsF;AAAA,EACpG;AAAA,EAES,OAA6B;AACpC,SAAK,OAAO,wDAAwD;AACpE,SAAK,OAAO,0DAA0D;AAAA,EACxE;AAEF;",
+  "names": []
+}

package/dist/modules/notifications/migrations/Migration20260706120000_notifications_channels.js

@@ -0,0 +1,13 @@
+import { Migration } from "@mikro-orm/migrations";
+class Migration20260706120000_notifications_channels extends Migration {
+  up() {
+    this.addSql(`alter table "notifications" add column "channels" jsonb null;`);
+  }
+  down() {
+    this.addSql(`alter table "notifications" drop column "channels";`);
+  }
+}
+export {
+  Migration20260706120000_notifications_channels
+};
+//# sourceMappingURL=Migration20260706120000_notifications_channels.js.map

package/dist/modules/notifications/migrations/Migration20260706120000_notifications_channels.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/notifications/migrations/Migration20260706120000_notifications_channels.ts"],
+  "sourcesContent": ["import { Migration } from '@mikro-orm/migrations';\n\nexport class Migration20260706120000_notifications_channels extends Migration {\n\n  override up(): void | Promise<void> {\n    this.addSql(`alter table \"notifications\" add column \"channels\" jsonb null;`);\n  }\n\n  override down(): void | Promise<void> {\n    this.addSql(`alter table \"notifications\" drop column \"channels\";`);\n  }\n\n}\n"],
+  "mappings": "AAAA,SAAS,iBAAiB;AAEnB,MAAM,uDAAuD,UAAU;AAAA,EAEnE,KAA2B;AAClC,SAAK,OAAO,+DAA+D;AAAA,EAC7E;AAAA,EAES,OAA6B;AACpC,SAAK,OAAO,qDAAqD;AAAA,EACnE;AAEF;",
+  "names": []
+}

package/dist/modules/notifications/migrations/Migration20260716123121_notifications.js

@@ -0,0 +1,14 @@
+import { Migration } from "@mikro-orm/migrations";
+class Migration20260716123121_notifications extends Migration {
+  up() {
+    this.addSql(`create table "notification_type_overrides" ("id" uuid not null default gen_random_uuid(), "tenant_id" uuid not null, "notification_type_id" text not null, "channels" jsonb null, "non_opt_out" boolean null, "created_at" timestamptz not null, "updated_at" timestamptz not null, primary key ("id"));`);
+    this.addSql(`create unique index "notification_type_overrides_unique" on "notification_type_overrides" ("tenant_id", "notification_type_id");`);
+  }
+  down() {
+    this.addSql(`drop table if exists "notification_type_overrides" cascade;`);
+  }
+}
+export {
+  Migration20260716123121_notifications
+};
+//# sourceMappingURL=Migration20260716123121_notifications.js.map

package/dist/modules/notifications/migrations/Migration20260716123121_notifications.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/notifications/migrations/Migration20260716123121_notifications.ts"],
+  "sourcesContent": ["import { Migration } from '@mikro-orm/migrations';\n\nexport class Migration20260716123121_notifications extends Migration {\n\n  override up(): void | Promise<void> {\n    this.addSql(`create table \"notification_type_overrides\" (\"id\" uuid not null default gen_random_uuid(), \"tenant_id\" uuid not null, \"notification_type_id\" text not null, \"channels\" jsonb null, \"non_opt_out\" boolean null, \"created_at\" timestamptz not null, \"updated_at\" timestamptz not null, primary key (\"id\"));`);\n    this.addSql(`create unique index \"notification_type_overrides_unique\" on \"notification_type_overrides\" (\"tenant_id\", \"notification_type_id\");`);\n  }\n\n  override down(): void | Promise<void> {\n    this.addSql(`drop table if exists \"notification_type_overrides\" cascade;`);\n  }\n\n}\n"],
+  "mappings": "AAAA,SAAS,iBAAiB;AAEnB,MAAM,8CAA8C,UAAU;AAAA,EAE1D,KAA2B;AAClC,SAAK,OAAO,0SAA0S;AACtT,SAAK,OAAO,kIAAkI;AAAA,EAChJ;AAAA,EAES,OAA6B;AACpC,SAAK,OAAO,6DAA6D;AAAA,EAC3E;AAEF;",
+  "names": []
+}

package/dist/modules/notifications/notification-channels.js

@@ -0,0 +1,26 @@
+const notificationChannels = [
+  {
+    id: "in_app",
+    labelKey: "notifications.preferences.channels.inApp",
+    descriptionKey: "notifications.preferences.channels.inAppHint",
+    order: 10
+  },
+  {
+    id: "email",
+    labelKey: "notifications.preferences.channels.email",
+    descriptionKey: "notifications.preferences.channels.emailHint",
+    order: 20
+  },
+  {
+    id: "push",
+    labelKey: "notifications.preferences.channels.push",
+    descriptionKey: "notifications.preferences.channels.pushHint",
+    order: 30
+  }
+];
+var notification_channels_default = notificationChannels;
+export {
+  notification_channels_default as default,
+  notificationChannels
+};
+//# sourceMappingURL=notification-channels.js.map

package/dist/modules/notifications/notification-channels.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/modules/notifications/notification-channels.ts"],
+  "sourcesContent": ["import type { NotificationChannelDefinition } from '@open-mercato/shared/modules/notifications/types'\n\n/**\n * Core-owned delivery channels. `notifications` is the channel-metadata authority (labels shown in the\n * preferences UI + the `/api/notifications/channels` catalogue); the delivery *behavior* for each lives\n * in its own strategy (`in_app`/`email` here, `push` in `push_notifications`). Third-party modules add\n * further channels by shipping their own generator-discovered `notification-channels.ts`.\n */\nexport const notificationChannels: NotificationChannelDefinition[] = [\n  {\n    id: 'in_app',\n    labelKey: 'notifications.preferences.channels.inApp',\n    descriptionKey: 'notifications.preferences.channels.inAppHint',\n    order: 10,\n  },\n  {\n    id: 'email',\n    labelKey: 'notifications.preferences.channels.email',\n    descriptionKey: 'notifications.preferences.channels.emailHint',\n    order: 20,\n  },\n  {\n    id: 'push',\n    labelKey: 'notifications.preferences.channels.push',\n    descriptionKey: 'notifications.preferences.channels.pushHint',\n    order: 30,\n  },\n]\n\nexport default notificationChannels\n"],
+  "mappings": "AAQO,MAAM,uBAAwD;AAAA,EACnE;AAAA,IACE,IAAI;AAAA,IACJ,UAAU;AAAA,IACV,gBAAgB;AAAA,IAChB,OAAO;AAAA,EACT;AAAA,EACA;AAAA,IACE,IAAI;AAAA,IACJ,UAAU;AAAA,IACV,gBAAgB;AAAA,IAChB,OAAO;AAAA,EACT;AAAA,EACA;AAAA,IACE,IAAI;AAAA,IACJ,UAAU;AAAA,IACV,gBAAgB;AAAA,IAChB,OAAO;AAAA,EACT;AACF;AAEA,IAAO,gCAAQ;",
+  "names": []
+}

package/dist/modules/notifications/notifications.delivery-strategies.js

@@ -0,0 +1,12 @@
+import { inAppDeliveryStrategy } from "./lib/strategies/in-app-delivery-strategy.js";
+import { emailDeliveryStrategy } from "./lib/strategies/email-delivery-strategy.js";
+const deliveryStrategies = [
+  inAppDeliveryStrategy,
+  emailDeliveryStrategy
+];
+var notifications_delivery_strategies_default = deliveryStrategies;
+export {
+  notifications_delivery_strategies_default as default,
+  deliveryStrategies
+};
+//# sourceMappingURL=notifications.delivery-strategies.js.map

package/dist/modules/notifications/notifications.delivery-strategies.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/modules/notifications/notifications.delivery-strategies.ts"],
+  "sourcesContent": ["import type { NotificationDeliveryStrategy } from './lib/deliveryStrategies'\nimport { inAppDeliveryStrategy } from './lib/strategies/in-app-delivery-strategy'\nimport { emailDeliveryStrategy } from './lib/strategies/email-delivery-strategy'\n\n/**\n * Core-owned delivery strategies, discovered by the notifications `delivery-strategies` generator\n * plugin (see `generators.ts`) and registered at bootstrap. `push` is contributed separately by the\n * `push_notifications` module through its own `notifications.delivery-strategies.ts`.\n */\nexport const deliveryStrategies: NotificationDeliveryStrategy[] = [\n  inAppDeliveryStrategy,\n  emailDeliveryStrategy,\n]\n\nexport default deliveryStrategies\n"],
+  "mappings": "AACA,SAAS,6BAA6B;AACtC,SAAS,6BAA6B;AAO/B,MAAM,qBAAqD;AAAA,EAChE;AAAA,EACA;AACF;AAEA,IAAO,4CAAQ;",
+  "names": []
+}

package/dist/modules/notifications/setup.js

@@ -1,8 +1,23 @@
+import { createLogger } from "@open-mercato/shared/lib/logger";
+import { TYPE_REGISTRY_SYNC_EVENT } from "./events.js";
+const logger = createLogger("notifications");
 const setup = {
   defaultRoleFeatures: {
     superadmin: ["notifications.*"],
     admin: ["notifications.*"],
-    employee: ["notifications.view"]
+    employee: ["notifications.view", "notifications.manage_preferences"]
+  },
+  async seedDefaults({ container, tenantId, organizationId }) {
+    try {
+      const eventBus = container.resolve("eventBus");
+      await eventBus.emit(
+        TYPE_REGISTRY_SYNC_EVENT,
+        { tenantId, organizationId },
+        { tenantId, organizationId, persistent: true }
+      );
+    } catch (err) {
+      logger.warn("type_registry.sync emit skipped during seedDefaults", { err });
+    }
   }
 };
 var setup_default = setup;

package/dist/modules/notifications/setup.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/modules/notifications/setup.ts"],
-  "sourcesContent": ["import type { ModuleSetupConfig } from '@open-mercato/shared/modules/setup'\n\nexport const setup: ModuleSetupConfig = {\n  defaultRoleFeatures: {\n    superadmin: ['notifications.*'],\n    admin: ['notifications.*'],\n    employee: ['notifications.view'],\n  },\n}\n\nexport default setup\n"],
-  "mappings": "AAEO,MAAM,QAA2B;AAAA,EACtC,qBAAqB;AAAA,IACnB,YAAY,CAAC,iBAAiB;AAAA,IAC9B,OAAO,CAAC,iBAAiB;AAAA,IACzB,UAAU,CAAC,oBAAoB;AAAA,EACjC;AACF;AAEA,IAAO,gBAAQ;",
+  "sourcesContent": ["import type { ModuleSetupConfig } from '@open-mercato/shared/modules/setup'\nimport { createLogger } from '@open-mercato/shared/lib/logger'\nimport { TYPE_REGISTRY_SYNC_EVENT } from './events'\n\nconst logger = createLogger('notifications')\n\nexport const setup: ModuleSetupConfig = {\n  defaultRoleFeatures: {\n    superadmin: ['notifications.*'],\n    admin: ['notifications.*'],\n    employee: ['notifications.view', 'notifications.manage_preferences'],\n  },\n\n  async seedDefaults({ container, tenantId, organizationId }) {\n    // Best-effort: nudge the type catalogue into the DB at init time. The\n    // `GET /api/notifications/types` lazy reconcile is the reliable fallback, so\n    // a failure here must never break tenant initialization.\n    try {\n      const eventBus = container.resolve('eventBus') as {\n        emit: (event: string, payload: unknown, options?: unknown) => Promise<void>\n      }\n      await eventBus.emit(\n        TYPE_REGISTRY_SYNC_EVENT,\n        { tenantId, organizationId },\n        { tenantId, organizationId, persistent: true },\n      )\n    } catch (err) {\n      logger.warn('type_registry.sync emit skipped during seedDefaults', { err })\n    }\n  },\n}\n\nexport default setup\n"],
+  "mappings": "AACA,SAAS,oBAAoB;AAC7B,SAAS,gCAAgC;AAEzC,MAAM,SAAS,aAAa,eAAe;AAEpC,MAAM,QAA2B;AAAA,EACtC,qBAAqB;AAAA,IACnB,YAAY,CAAC,iBAAiB;AAAA,IAC9B,OAAO,CAAC,iBAAiB;AAAA,IACzB,UAAU,CAAC,sBAAsB,kCAAkC;AAAA,EACrE;AAAA,EAEA,MAAM,aAAa,EAAE,WAAW,UAAU,eAAe,GAAG;AAI1D,QAAI;AACF,YAAM,WAAW,UAAU,QAAQ,UAAU;AAG7C,YAAM,SAAS;AAAA,QACb;AAAA,QACA,EAAE,UAAU,eAAe;AAAA,QAC3B,EAAE,UAAU,gBAAgB,YAAY,KAAK;AAAA,MAC/C;AAAA,IACF,SAAS,KAAK;AACZ,aAAO,KAAK,uDAAuD,EAAE,IAAI,CAAC;AAAA,IAC5E;AAAA,EACF;AACF;AAEA,IAAO,gBAAQ;",
   "names": []
 }

package/dist/modules/notifications/subscribers/deliver-notification.js

@@ -2,11 +2,11 @@ import { Notification } from "../data/entities.js";
 import { NOTIFICATION_EVENTS } from "../lib/events.js";
 import { DEFAULT_NOTIFICATION_DELIVERY_CONFIG, resolveNotificationDeliveryConfig, resolveNotificationPanelUrl } from "../lib/deliveryConfig.js";
 import { getNotificationDeliveryStrategies } from "../lib/deliveryStrategies.js";
-import { sendEmail } from "@open-mercato/shared/lib/email/send";
-import NotificationEmail from "../emails/NotificationEmail.js";
-import { loadDictionary } from "@open-mercato/shared/lib/i18n/server";
-import { createFallbackTranslator } from "@open-mercato/shared/lib/i18n/translate";
-import { defaultLocale } from "@open-mercato/shared/lib/i18n/config";
+import { resolveEffectiveChannels } from "../lib/shouldDeliver.js";
+import { getNotificationType } from "../lib/notification-type-registry.js";
+import { getNotificationTypeOverrides } from "../lib/typeOverrides.js";
+import { resolveNotificationPreferenceService } from "../lib/notificationPreferenceService.js";
+import { resolveNotificationCopy } from "../lib/notificationCopy.js";
 import { findOneWithDecryption } from "@open-mercato/shared/lib/encryption/find";
 import { User } from "../../auth/data/entities.js";
 import { createLogger } from "@open-mercato/shared/lib/logger";
@@ -28,13 +28,6 @@ const buildPanelLink = (panelUrl, notificationId) => {
   const separator = panelUrl.includes("?") ? "&" : "?";
   return `${panelUrl}${separator}notificationId=${encodeURIComponent(notificationId)}`;
 };
-const resolveNotificationCopy = async (notification) => {
-  const dict = await loadDictionary(defaultLocale);
-  const t = createFallbackTranslator(dict);
-  const title = notification.titleKey ? t(notification.titleKey, notification.title ?? notification.titleKey, notification.titleVariables ?? void 0) : notification.title;
-  const body = notification.bodyKey ? t(notification.bodyKey, notification.body ?? notification.bodyKey ?? "", notification.bodyVariables ?? void 0) : notification.body ?? null;
-  return { title, body, t };
-};
 const resolveRecipient = async (em, notification, encryptionService) => {
   const where = {
     id: notification.recipientUserId,
@@ -64,9 +57,6 @@ const resolveRecipient = async (em, notification, encryptionService) => {
 async function handle(payload, ctx) {
   debug("deliver notification event", payload);
   const deliveryConfig = await resolveNotificationDeliveryConfig(ctx, { defaultValue: DEFAULT_NOTIFICATION_DELIVERY_CONFIG });
-  if (!deliveryConfig.strategies.email.enabled) {
-    debug("email delivery disabled");
-  }
   const em = ctx.resolve("em");
   const notification = await findOneWithDecryption(
     em,
@@ -118,59 +108,78 @@ async function handle(payload, ctx) {
         href: fullHref
       };
     }).filter((action) => action !== null);
-    if (deliveryConfig.strategies.email.enabled && recipient?.email && panelLink) {
-      const subjectPrefix = deliveryConfig.strategies.email.subjectPrefix?.trim();
-      const subject = subjectPrefix ? `${subjectPrefix} ${title}` : title;
-      const copy = {
-        preview: t("notifications.delivery.email.preview", "New notification"),
-        heading: t("notifications.delivery.email.heading", "You have a new notification"),
-        bodyIntro: t("notifications.delivery.email.bodyIntro", "Review the notification details and take any required actions."),
-        actionNotice: t("notifications.delivery.email.actionNotice", "Actions are available in Open Mercato and are read-only in this email."),
-        openCta: t("notifications.delivery.email.openCta", "Open notification center"),
-        footer: t("notifications.delivery.email.footer", "Open Mercato notifications")
-      };
+    const strategyConfigs = deliveryConfig.strategies.custom ?? {};
+    const strategies = getNotificationDeliveryStrategies();
+    const persistedChannels = notification.channels;
+    const registeredStrategyIds = strategies.map((strategy) => strategy.id);
+    let targetChannels = persistedChannels ?? null;
+    if (persistedChannels == null && registeredStrategyIds.length > 0) {
       try {
-        debug("sending email", { recipientUserId: notification.recipientUserId });
-        await sendEmail({
-          to: recipient.email,
-          subject,
-          from: deliveryConfig.strategies.email.from,
-          replyTo: deliveryConfig.strategies.email.replyTo,
-          react: NotificationEmail({
-            title,
-            body,
-            actions: actionLinks,
-            panelUrl: panelLink,
-            copy
-          })
+        const typeOverrides = (await getNotificationTypeOverrides(em, notification.tenantId, [notification.type])).get(notification.type);
+        targetChannels = await resolveEffectiveChannels({
+          typeId: notification.type,
+          type: getNotificationType(notification.type),
+          scope: { tenantId: notification.tenantId, userId: notification.recipientUserId },
+          targetChannels: null,
+          registeredChannels: registeredStrategyIds,
+          preferences: resolveNotificationPreferenceService({ resolve: ctx.resolve }),
+          channelsOverride: typeOverrides?.channels ?? null,
+          nonOptOutOverride: typeOverrides?.nonOptOut ?? null
         });
-      } catch (error) {
-        logger.error("Email delivery failed", { err: error });
+      } catch (err) {
+        logger.error("failed to recompute delivery channels; retrying via persistent subscriber", {
+          notificationId: notification.id,
+          type: notification.type,
+          err
+        });
+        throw err;
+      }
+    }
+    if (persistedChannels == null && targetChannels != null) {
+      try {
+        await em.fork().nativeUpdate(
+          Notification,
+          { id: notification.id, tenantId: notification.tenantId },
+          { channels: targetChannels }
+        );
+      } catch (err) {
+        debug("failed to persist recomputed channels", err);
       }
     }
-    const strategyConfigs = deliveryConfig.strategies.custom ?? {};
-    const strategies = getNotificationDeliveryStrategies();
     for (const strategy of strategies) {
+      if (targetChannels && !targetChannels.includes(strategy.id)) {
+        debug("channel not targeted", strategy.id);
+        continue;
+      }
       const strategyConfig = strategyConfigs[strategy.id];
       const enabled = strategyConfig?.enabled ?? strategy.defaultEnabled ?? false;
       if (!enabled) {
-        debug("custom delivery disabled", strategy.id);
+        debug("delivery disabled", strategy.id);
         continue;
       }
+      if (strategy.supports && !strategy.supports(notification)) {
+        debug("strategy does not support notification", strategy.id);
+        continue;
+      }
+      const context = {
+        notification,
+        recipient,
+        title,
+        body,
+        panelUrl,
+        panelLink,
+        actionLinks,
+        deliveryConfig,
+        config: strategyConfig ?? {},
+        resolve: ctx.resolve,
+        t
+      };
       try {
-        await strategy.deliver({
-          notification,
-          recipient,
-          title,
-          body,
-          panelUrl,
-          panelLink,
-          actionLinks,
-          deliveryConfig,
-          config: strategyConfig ?? {},
-          resolve: ctx.resolve,
-          t
-        });
+        if (strategy.isConfigured && !await strategy.isConfigured(context)) {
+          debug("strategy not configured", strategy.id);
+          continue;
+        }
+        await strategy.deliver(context);
       } catch (error) {
         logger.error("Delivery strategy failed", { strategyId: strategy.id, err: error });
       }