@iveri/contracts 0.18.0 → 0.20.0

package/dist/cjs/enum/user-permission.enum.js

@@ -319,6 +319,60 @@ var UserPermission;
      * key catalogue, and separating it keeps a compromised worker from enumerating it.
      */
     UserPermission["LOCALIZATION_RENDER"] = "localization:render";
+    // ══ iveri-notification-api ══════════════════════════════════════════════
+    /**
+     * Submit a notification for delivery.
+     *
+     * **A service permission, and the sharpest one here.** It reaches a real person's mailbox with
+     * text the platform composed, and it is not deliberately absent from the seeded `ADMIN` role
+     * the way `UNIBOX_REALTIME_PUBLISH` is — an admin has no reason to hold it, because there is
+     * nothing for a human to prove by sending a notification to somebody else by hand.
+     *
+     * Note what it does *not* let a holder do: a submission names a **template key**, never a
+     * subject and body. The wording of every notification the platform sends was written by
+     * somebody holding {@link UserPermission.NOTIFICATION_TEMPLATE_MANAGE} and translated by
+     * somebody holding {@link UserPermission.LOCALIZATION_TRANSLATE}. This is the same shape as
+     * `CONDUIT_DISPATCH_SEND` naming an operation rather than a URL, and it is load-bearing for
+     * the same reason: without it, a compromised service principal is an authenticated way to
+     * send arbitrary text from our own domain to any address it likes.
+     */
+    UserPermission["NOTIFICATION_SEND"] = "notification:send";
+    /**
+     * Read **your own** in-app inbox, and mark your own rows read.
+     *
+     * Scoped to the calling principal by the endpoint, not by this permission — there is no
+     * variant that reads somebody else's inbox, because a notification is addressed to one person
+     * and reading another's is reading their mail. It belongs in every human role, including the
+     * narrowest, for the same reason: without it a member cannot see what the product is telling
+     * them.
+     */
+    UserPermission["NOTIFICATION_READ"] = "notification:read";
+    /** Read the tenant's notification templates and the platform's built-in ones. */
+    UserPermission["NOTIFICATION_TEMPLATE_READ"] = "notification:template:read";
+    /**
+     * Override a built-in template, or define a new one — which channels a notification type
+     * reaches and which message keys it renders.
+     *
+     * Configuration that decides what every future notification of a type says, including the
+     * password-reset email. Overriding one badly is a way to stop people getting back into their
+     * accounts, so it is separated from reading for the same reason `CONDUIT_CONNECTOR_MANAGE` is.
+     */
+    UserPermission["NOTIFICATION_TEMPLATE_MANAGE"] = "notification:template:manage";
+    /**
+     * Read the delivery log and the dead-letter queue, including each delivery's last error.
+     *
+     * Grouped with reading rather than with operating the queue, and it is closer to a data-read
+     * permission than a config one: the log names who was written to and about what.
+     */
+    UserPermission["NOTIFICATION_DELIVERY_READ"] = "notification:delivery:read";
+    /**
+     * Redrive a dead-lettered delivery, or cancel one still pending.
+     *
+     * Separate from reading because it causes a message to be sent to a person rather than
+     * returning a row — and because redriving a backlog is a way to mail somebody the same thing
+     * fifty times an hour after an outage.
+     */
+    UserPermission["NOTIFICATION_DELIVERY_OPERATE"] = "notification:delivery:operate";
 })(UserPermission || (exports.UserPermission = UserPermission = {}));
 /**
  * Every member, for seeding the owner role and validating custom-role input.

package/dist/cjs/enum/user-permission.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"user-permission.enum.js","sourceRoot":"","sources":["../../../src/enum/user-permission.enum.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"user-permission.enum.js","sourceRoot":"","sources":["../../../src/enum/user-permission.enum.ts"],"names":[],"mappings":"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"}

package/dist/esm/api/localization/message.type.d.ts

@@ -24,6 +24,22 @@ export interface MessageVariable {
      */
     options: Nullable<string[]>;
 }
+/**
+ * A declaration as a *client sends* it, where the optional halves may simply be absent.
+ *
+ * A separate type from {@link MessageVariable} rather than that one with everything optional,
+ * because the two directions genuinely differ: on the way in, omitting `description` means "I
+ * have nothing to say"; on the way out, the field is always present and `null` says the same
+ * thing explicitly. Collapsing them forces every reader to handle `undefined` for a field the
+ * server always sends.
+ */
+export interface MessageVariableInput {
+    name: string;
+    type: VariableType;
+    description?: Nullable<string>;
+    example?: Nullable<string>;
+    options?: Nullable<string[]>;
+}
 /**
  * A translatable string, identified by a key that never changes.
  *
@@ -71,7 +87,7 @@ export type MessagesPage = Paginated<Message>;
 export interface CreateMessageBody {
     key: string;
     description?: Nullable<string>;
-    variables?: MessageVariable[];
+    variables?: MessageVariableInput[];
     /** The source-locale text. Written as an `APPROVED` translation in the same transaction. */
     sourceValue: string;
 }
@@ -84,7 +100,7 @@ export interface CreateMessageBody {
  */
 export interface UpdateMessageBody {
     description?: Nullable<string>;
-    variables?: MessageVariable[];
+    variables?: MessageVariableInput[];
     isArchived?: boolean;
 }
 //# sourceMappingURL=message.type.d.ts.map

package/dist/esm/api/localization/message.type.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"message.type.d.ts","sourceRoot":"","sources":["../../../../src/api/localization/message.type.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAC;AAEpD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAE5D,+FAA+F;AAC/F,MAAM,WAAW,eAAe;IAC5B,6FAA6F;IAC7F,IAAI,EAAE,MAAM,CAAC;IAEb,IAAI,EAAE,YAAY,CAAC;IAEnB;;;;;OAKG;IACH,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAE9B,iFAAiF;IACjF,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAE1B;;;OAGG;IACH,OAAO,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;CAC/B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,OAAO;IACpB,EAAE,EAAE,IAAI,CAAC;IAET,WAAW,EAAE,IAAI,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IAErB,8FAA8F;IAC9F,GAAG,EAAE,MAAM,CAAC;IAEZ;;;;;;;OAOG;IACH,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAE9B,SAAS,EAAE,eAAe,EAAE,CAAC;IAE7B;;;OAGG;IACH,UAAU,EAAE,OAAO,CAAC;IAEpB,uFAAuF;IACvF,YAAY,CAAC,EAAE,yBAAyB,EAAE,CAAC;IAE3C,SAAS,EAAE,WAAW,CAAC;IACvB,SAAS,EAAE,WAAW,CAAC;CAC1B;AAED,qEAAqE;AACrE,MAAM,WAAW,yBAAyB;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,qEAAqE;IACrE,MAAM,EAAE,iBAAiB,CAAC;IAC1B,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IACxB,SAAS,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC;CACpC;AAED,8CAA8C;AAC9C,MAAM,MAAM,YAAY,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;AAE9C,+CAA+C;AAC/C,MAAM,WAAW,iBAAiB;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC/B,SAAS,CAAC,EAAE,eAAe,EAAE,CAAC;IAC9B,4FAA4F;IAC5F,WAAW,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAC9B,WAAW,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC/B,SAAS,CAAC,EAAE,eAAe,EAAE,CAAC;IAC9B,UAAU,CAAC,EAAE,OAAO,CAAC;CACxB"}
+{"version":3,"file":"message.type.d.ts","sourceRoot":"","sources":["../../../../src/api/localization/message.type.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAC;AAEpD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAE5D,+FAA+F;AAC/F,MAAM,WAAW,eAAe;IAC5B,6FAA6F;IAC7F,IAAI,EAAE,MAAM,CAAC;IAEb,IAAI,EAAE,YAAY,CAAC;IAEnB;;;;;OAKG;IACH,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAE9B,iFAAiF;IACjF,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAE1B;;;OAGG;IACH,OAAO,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;CAC/B;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,oBAAoB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,YAAY,CAAC;IACnB,WAAW,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC/B,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC3B,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;CAChC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,OAAO;IACpB,EAAE,EAAE,IAAI,CAAC;IAET,WAAW,EAAE,IAAI,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IAErB,8FAA8F;IAC9F,GAAG,EAAE,MAAM,CAAC;IAEZ;;;;;;;OAOG;IACH,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAE9B,SAAS,EAAE,eAAe,EAAE,CAAC;IAE7B;;;OAGG;IACH,UAAU,EAAE,OAAO,CAAC;IAEpB,uFAAuF;IACvF,YAAY,CAAC,EAAE,yBAAyB,EAAE,CAAC;IAE3C,SAAS,EAAE,WAAW,CAAC;IACvB,SAAS,EAAE,WAAW,CAAC;CAC1B;AAED,qEAAqE;AACrE,MAAM,WAAW,yBAAyB;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,qEAAqE;IACrE,MAAM,EAAE,iBAAiB,CAAC;IAC1B,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IACxB,SAAS,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC;CACpC;AAED,8CAA8C;AAC9C,MAAM,MAAM,YAAY,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;AAE9C,+CAA+C;AAC/C,MAAM,WAAW,iBAAiB;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC/B,SAAS,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACnC,4FAA4F;IAC5F,WAAW,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAC9B,WAAW,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC/B,SAAS,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACnC,UAAU,CAAC,EAAE,OAAO,CAAC;CACxB"}

package/dist/esm/api/notification/index.d.ts

@@ -0,0 +1,5 @@
+export * from './notification-channel.enum.js';
+export * from './notification-delivery-status.enum.js';
+export * from './notification-template.type.js';
+export * from './notification.type.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/api/notification/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/api/notification/index.ts"],"names":[],"mappings":"AAAA,cAAc,gCAAgC,CAAC;AAC/C,cAAc,wCAAwC,CAAC;AACvD,cAAc,iCAAiC,CAAC;AAChD,cAAc,wBAAwB,CAAC"}

package/dist/esm/api/notification/index.js

@@ -0,0 +1,5 @@
+export * from './notification-channel.enum.js';
+export * from './notification-delivery-status.enum.js';
+export * from './notification-template.type.js';
+export * from './notification.type.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/api/notification/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/api/notification/index.ts"],"names":[],"mappings":"AAAA,cAAc,gCAAgC,CAAC;AAC/C,cAAc,wCAAwC,CAAC;AACvD,cAAc,iCAAiC,CAAC;AAChD,cAAc,wBAAwB,CAAC"}

package/dist/esm/api/notification/notification-channel.enum.d.ts

@@ -0,0 +1,27 @@
+/**
+ * A way a notification reaches a person.
+ *
+ * A channel is not a provider. `EMAIL` says a message is addressed to a mailbox; whether it
+ * leaves through a local SMTP sink, SES or a transactional-email vendor is an adapter detail
+ * `iveri-notification-api` keeps behind its own boundary, and nothing on the wire names one.
+ *
+ * **There is deliberately no `PUSH` member yet**, and adding one is not a formality. Push needs a
+ * device registry, per-platform credentials (APNs keys, FCM service accounts) and a token-rotation
+ * story, none of which exist and none of which any product currently asks for. A member declared
+ * before the machinery behind it is a value a caller can send that quietly goes nowhere — worse
+ * than a 422 saying the channel is unknown, because it looks like it worked.
+ */
+export declare enum NotificationChannel {
+    /** A message to a mailbox. Needs `recipient.emailAddress`. */
+    EMAIL = "email",
+    /**
+     * A row in the recipient's own in-app inbox. Needs `recipient.userId`.
+     *
+     * The only channel whose delivery is a local write, which is why it is the one channel that
+     * cannot fail for a reason outside our control. It still goes through the same queue as
+     * email: a notification that fans out to both must not have one half committed inline and the
+     * other half queued, or a rollback leaves the two halves disagreeing about what happened.
+     */
+    IN_APP = "in-app"
+}
+//# sourceMappingURL=notification-channel.enum.d.ts.map

package/dist/esm/api/notification/notification-channel.enum.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-channel.enum.d.ts","sourceRoot":"","sources":["../../../../src/api/notification/notification-channel.enum.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,oBAAY,mBAAmB;IAC3B,8DAA8D;IAC9D,KAAK,UAAU;IAEf;;;;;;;OAOG;IACH,MAAM,WAAW;CACpB"}

package/dist/esm/api/notification/notification-channel.enum.js

@@ -0,0 +1,28 @@
+/**
+ * A way a notification reaches a person.
+ *
+ * A channel is not a provider. `EMAIL` says a message is addressed to a mailbox; whether it
+ * leaves through a local SMTP sink, SES or a transactional-email vendor is an adapter detail
+ * `iveri-notification-api` keeps behind its own boundary, and nothing on the wire names one.
+ *
+ * **There is deliberately no `PUSH` member yet**, and adding one is not a formality. Push needs a
+ * device registry, per-platform credentials (APNs keys, FCM service accounts) and a token-rotation
+ * story, none of which exist and none of which any product currently asks for. A member declared
+ * before the machinery behind it is a value a caller can send that quietly goes nowhere — worse
+ * than a 422 saying the channel is unknown, because it looks like it worked.
+ */
+export var NotificationChannel;
+(function (NotificationChannel) {
+    /** A message to a mailbox. Needs `recipient.emailAddress`. */
+    NotificationChannel["EMAIL"] = "email";
+    /**
+     * A row in the recipient's own in-app inbox. Needs `recipient.userId`.
+     *
+     * The only channel whose delivery is a local write, which is why it is the one channel that
+     * cannot fail for a reason outside our control. It still goes through the same queue as
+     * email: a notification that fans out to both must not have one half committed inline and the
+     * other half queued, or a rollback leaves the two halves disagreeing about what happened.
+     */
+    NotificationChannel["IN_APP"] = "in-app";
+})(NotificationChannel || (NotificationChannel = {}));
+//# sourceMappingURL=notification-channel.enum.js.map

package/dist/esm/api/notification/notification-channel.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-channel.enum.js","sourceRoot":"","sources":["../../../../src/api/notification/notification-channel.enum.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,MAAM,CAAN,IAAY,mBAaX;AAbD,WAAY,mBAAmB;IAC3B,8DAA8D;IAC9D,sCAAe,CAAA;IAEf;;;;;;;OAOG;IACH,wCAAiB,CAAA;AACrB,CAAC,EAbW,mBAAmB,KAAnB,mBAAmB,QAa9B"}

package/dist/esm/api/notification/notification-delivery-status.enum.d.ts

@@ -0,0 +1,45 @@
+/**
+ * How far one channel's attempt at a notification got.
+ *
+ * The state lives on the **delivery**, never on the notification. A notification that fans out to
+ * email and the in-app inbox has two independent fates, and a single rolled-up status would have
+ * to pick one of them to report — which means either hiding a dead letter behind a success or
+ * marking a wholly delivered notification as failed because one channel bounced.
+ *
+ * These mirror `conduit-api`'s outbound states deliberately but are a **separate enum**, for the
+ * same reason Conduit keeps its inbound and outbound statuses apart: the words coincide and the
+ * stories do not. A dead-lettered dispatch means a customer's message never reached a provider; a
+ * dead-lettered notification means a person was never told something we decided to tell them.
+ */
+export declare enum NotificationDeliveryStatus {
+    /** Waiting for its next attempt, due at `nextAttemptAt`. */
+    PENDING = "pending",
+    /**
+     * Claimed by a worker and in progress.
+     *
+     * A row stranded here past the claim timeout is reclaimed by the same query that claims fresh
+     * work, which is where at-least-once becomes visible and why every channel adapter has to
+     * tolerate being asked twice.
+     */
+    IN_FLIGHT = "in-flight",
+    /**
+     * The channel accepted it. Terminal, and the strongest thing we can honestly say.
+     *
+     * **There is no `DELIVERED`**, and its absence is a decision rather than an omission. An SMTP
+     * relay accepting a message is not evidence a person received it — the bounce arrives minutes
+     * later, out of band, and nothing here is listening for one yet. A `DELIVERED` state we cannot
+     * observe would be a field every UI renders as a green tick and no code ever sets.
+     */
+    SENT = "sent",
+    /**
+     * The attempt budget is spent, or the channel refused in a way no retry can fix. Terminal.
+     *
+     * Reached from a permanent refusal on the very first attempt — an address the relay rejects
+     * outright, a template that names a message key nobody has published — because four more
+     * identical failures buy nothing and delay the moment somebody can act.
+     */
+    DEAD_LETTERED = "dead-lettered",
+    /** An operator stopped it before it went out. Terminal, and not a failure. */
+    CANCELLED = "cancelled"
+}
+//# sourceMappingURL=notification-delivery-status.enum.d.ts.map

package/dist/esm/api/notification/notification-delivery-status.enum.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-delivery-status.enum.d.ts","sourceRoot":"","sources":["../../../../src/api/notification/notification-delivery-status.enum.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,oBAAY,0BAA0B;IAClC,4DAA4D;IAC5D,OAAO,YAAY;IAEnB;;;;;;OAMG;IACH,SAAS,cAAc;IAEvB;;;;;;;OAOG;IACH,IAAI,SAAS;IAEb;;;;;;OAMG;IACH,aAAa,kBAAkB;IAE/B,8EAA8E;IAC9E,SAAS,cAAc;CAC1B"}

package/dist/esm/api/notification/notification-delivery-status.enum.js

@@ -0,0 +1,46 @@
+/**
+ * How far one channel's attempt at a notification got.
+ *
+ * The state lives on the **delivery**, never on the notification. A notification that fans out to
+ * email and the in-app inbox has two independent fates, and a single rolled-up status would have
+ * to pick one of them to report — which means either hiding a dead letter behind a success or
+ * marking a wholly delivered notification as failed because one channel bounced.
+ *
+ * These mirror `conduit-api`'s outbound states deliberately but are a **separate enum**, for the
+ * same reason Conduit keeps its inbound and outbound statuses apart: the words coincide and the
+ * stories do not. A dead-lettered dispatch means a customer's message never reached a provider; a
+ * dead-lettered notification means a person was never told something we decided to tell them.
+ */
+export var NotificationDeliveryStatus;
+(function (NotificationDeliveryStatus) {
+    /** Waiting for its next attempt, due at `nextAttemptAt`. */
+    NotificationDeliveryStatus["PENDING"] = "pending";
+    /**
+     * Claimed by a worker and in progress.
+     *
+     * A row stranded here past the claim timeout is reclaimed by the same query that claims fresh
+     * work, which is where at-least-once becomes visible and why every channel adapter has to
+     * tolerate being asked twice.
+     */
+    NotificationDeliveryStatus["IN_FLIGHT"] = "in-flight";
+    /**
+     * The channel accepted it. Terminal, and the strongest thing we can honestly say.
+     *
+     * **There is no `DELIVERED`**, and its absence is a decision rather than an omission. An SMTP
+     * relay accepting a message is not evidence a person received it — the bounce arrives minutes
+     * later, out of band, and nothing here is listening for one yet. A `DELIVERED` state we cannot
+     * observe would be a field every UI renders as a green tick and no code ever sets.
+     */
+    NotificationDeliveryStatus["SENT"] = "sent";
+    /**
+     * The attempt budget is spent, or the channel refused in a way no retry can fix. Terminal.
+     *
+     * Reached from a permanent refusal on the very first attempt — an address the relay rejects
+     * outright, a template that names a message key nobody has published — because four more
+     * identical failures buy nothing and delay the moment somebody can act.
+     */
+    NotificationDeliveryStatus["DEAD_LETTERED"] = "dead-lettered";
+    /** An operator stopped it before it went out. Terminal, and not a failure. */
+    NotificationDeliveryStatus["CANCELLED"] = "cancelled";
+})(NotificationDeliveryStatus || (NotificationDeliveryStatus = {}));
+//# sourceMappingURL=notification-delivery-status.enum.js.map

package/dist/esm/api/notification/notification-delivery-status.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-delivery-status.enum.js","sourceRoot":"","sources":["../../../../src/api/notification/notification-delivery-status.enum.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,MAAM,CAAN,IAAY,0BAkCX;AAlCD,WAAY,0BAA0B;IAClC,4DAA4D;IAC5D,iDAAmB,CAAA;IAEnB;;;;;;OAMG;IACH,qDAAuB,CAAA;IAEvB;;;;;;;OAOG;IACH,2CAAa,CAAA;IAEb;;;;;;OAMG;IACH,6DAA+B,CAAA;IAE/B,8EAA8E;IAC9E,qDAAuB,CAAA;AAC3B,CAAC,EAlCW,0BAA0B,KAA1B,0BAA0B,QAkCrC"}

package/dist/esm/api/notification/notification-template.type.d.ts

@@ -0,0 +1,68 @@
+import type { IsoDateTime } from '../../type/iso-date-time.type.js';
+import type { Nullable } from '../../type/nil.type.js';
+import type { UUID } from '../../type/uuid.type.js';
+import type { NotificationChannel } from './notification-channel.enum.js';
+/**
+ * What a notification *type* means: which channels it reaches and which strings it renders.
+ *
+ * A template holds **no text**. It names message keys in `iveri-localization-api`, which resolves
+ * them into the recipient's own language at send time. Storing the wording here instead would
+ * give the platform two places to author user-facing copy, and the second one would be the one
+ * without ICU validation, without a review gate and without Russian — see §13.1 of the workspace
+ * guide, which draws that line for exactly this case.
+ *
+ * **Built-in templates ship in code and a tenant row overrides one by key**, the same arrangement
+ * `conduit-api` uses for provider and connector manifests. `user.invitation` has to exist before
+ * any tenant has configured anything, and a platform whose password-reset email depends on a seed
+ * row is a platform where one missing row means nobody can get back into their account.
+ */
+export interface NotificationTemplate {
+    /**
+     * The stable type key a caller submits — `user.invitation`, `user.password-reset`.
+     *
+     * Dotted `<aggregate>.<event>`, lowercase. It is what a caller writes down, so it never
+     * changes once shipped; a rename is a new key and a deprecation of the old one.
+     */
+    key: string;
+    /** Null for a built-in. A tenant override is a real row and carries an id. */
+    id: Nullable<UUID>;
+    /**
+     * Which channels this type fans out to. One delivery row is written per channel.
+     *
+     * An empty list is refused on write rather than stored: a template that reaches nobody is a
+     * notification that silently disappears, and the submit would still answer 202.
+     */
+    channels: NotificationChannel[];
+    /** The localization namespace holding this template's strings. */
+    namespaceKey: string;
+    /** Message key for the subject line. Null for channels that have no subject. */
+    subjectMessageKey: Nullable<string>;
+    /** Message key for the body. Always present — a notification with no body says nothing. */
+    bodyMessageKey: string;
+    /**
+     * Placeholder names the body and subject need supplied at submit time.
+     *
+     * Checked when a notification is submitted, not when it is sent. A missing variable fails
+     * identically on every attempt, so discovering it five backoffs later tells the caller nothing
+     * they can still act on — the same rule Conduit applies to an unfillable path template.
+     */
+    requiredVariables: string[];
+    /**
+     * False for a tenant's own row, true for one of the platform's.
+     *
+     * Surfaced so a panel can say "you are overriding a built-in" rather than presenting a
+     * customised password-reset email as if the platform had no opinion about it.
+     */
+    isBuiltIn: boolean;
+    createdAt: Nullable<IsoDateTime>;
+    updatedAt: Nullable<IsoDateTime>;
+}
+/** `PUT /api/v1/templates/{key}` — create or replace a tenant's override of a template. */
+export interface UpsertNotificationTemplateBody {
+    channels: NotificationChannel[];
+    namespaceKey: string;
+    subjectMessageKey?: Nullable<string>;
+    bodyMessageKey: string;
+    requiredVariables?: Nullable<string[]>;
+}
+//# sourceMappingURL=notification-template.type.d.ts.map

package/dist/esm/api/notification/notification-template.type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-template.type.d.ts","sourceRoot":"","sources":["../../../../src/api/notification/notification-template.type.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAC;AAEpD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAE1E;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,oBAAoB;IACjC;;;;;OAKG;IACH,GAAG,EAAE,MAAM,CAAC;IAEZ,8EAA8E;IAC9E,EAAE,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;IAEnB;;;;;OAKG;IACH,QAAQ,EAAE,mBAAmB,EAAE,CAAC;IAEhC,kEAAkE;IAClE,YAAY,EAAE,MAAM,CAAC;IAErB,gFAAgF;IAChF,iBAAiB,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAEpC,2FAA2F;IAC3F,cAAc,EAAE,MAAM,CAAC;IAEvB;;;;;;OAMG;IACH,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAE5B;;;;;OAKG;IACH,SAAS,EAAE,OAAO,CAAC;IAEnB,SAAS,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC;IACjC,SAAS,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC;CACpC;AAED,2FAA2F;AAC3F,MAAM,WAAW,8BAA8B;IAC3C,QAAQ,EAAE,mBAAmB,EAAE,CAAC;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IACrC,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,CAAC,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;CAC1C"}

package/dist/esm/api/notification/notification-template.type.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=notification-template.type.js.map

package/dist/esm/api/notification/notification-template.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-template.type.js","sourceRoot":"","sources":["../../../../src/api/notification/notification-template.type.ts"],"names":[],"mappings":""}

package/dist/esm/api/notification/notification.type.d.ts

@@ -0,0 +1,136 @@
+import type { CursorPage } from '../../type/cursor-page.type.js';
+import type { IsoDateTime } from '../../type/iso-date-time.type.js';
+import type { Nullable } from '../../type/nil.type.js';
+import type { UUID } from '../../type/uuid.type.js';
+import type { NotificationChannel } from './notification-channel.enum.js';
+import type { NotificationDeliveryStatus } from './notification-delivery-status.enum.js';
+/** Who a notification is for, and in what language. */
+export interface NotificationRecipient {
+    /**
+     * The person, when there is one. Required by {@link NotificationChannel.IN_APP}.
+     *
+     * Null for a notification to somebody who has no account yet — which is precisely the
+     * invitation case, and the reason this is nullable rather than the obvious required field.
+     */
+    userId: Nullable<UUID>;
+    /** Required by {@link NotificationChannel.EMAIL}. */
+    emailAddress: Nullable<string>;
+    /**
+     * BCP-47. The language of the **recipient**, not of whoever submitted the notification.
+     *
+     * Null falls back to the tenant's source locale. This is the field that makes rendering a
+     * runtime concern rather than a build-time one: an agent working in English invites a
+     * colleague who reads Georgian, and the email is the colleague's.
+     */
+    localeCode: Nullable<string>;
+}
+/**
+ * One attempt-tracked send of a notification down one channel.
+ *
+ * This row **is** the outbox. It is written in the same transaction as the notification it belongs
+ * to, claimed by a worker afterwards, and retried on its own schedule — so a channel that is down
+ * delays one delivery rather than failing the submit.
+ */
+export interface NotificationDelivery {
+    id: UUID;
+    notificationId: UUID;
+    channel: NotificationChannel;
+    status: NotificationDeliveryStatus;
+    /** Attempts actually made. A refusal that costs no attempt does not increment it. */
+    attemptCount: number;
+    /** When the next attempt is due. Null once the delivery reaches a terminal state. */
+    nextAttemptAt: Nullable<IsoDateTime>;
+    sentAt: Nullable<IsoDateTime>;
+    /**
+     * Why the last attempt failed, in words an operator can act on.
+     *
+     * Never carries the rendered body or the recipient's address — a delivery log is read by more
+     * people than the mailbox it describes.
+     */
+    lastError: Nullable<string>;
+    /**
+     * The channel's own handle for what it accepted — an SMTP message id.
+     *
+     * Opaque and provider-shaped by nature, kept so a support question about one email can be
+     * traced into a relay's logs. Nothing branches on it.
+     */
+    providerReference: Nullable<string>;
+    /** When the recipient opened it. In-app only; email opens are not tracked. */
+    readAt: Nullable<IsoDateTime>;
+    createdAt: IsoDateTime;
+    updatedAt: IsoDateTime;
+}
+/**
+ * Something the platform decided to tell somebody.
+ *
+ * **It carries no status of its own**, and that is the load-bearing shape here. Status lives on
+ * {@link NotificationDelivery}, one per channel, because a notification that emailed successfully
+ * and dead-lettered in the inbox has two true answers and no single one. A caller asking "did it
+ * go" reads `deliveries`, which answers precisely rather than approximately.
+ */
+export interface Notification {
+    id: UUID;
+    /** The {@link NotificationTemplate} key this was rendered from. */
+    type: string;
+    recipient: NotificationRecipient;
+    /**
+     * Values for the template's declared placeholders.
+     *
+     * Stored as submitted and re-used on every retry, so a message that is retried an hour later
+     * says what it said the first time. Rendering happens per attempt; the *inputs* do not move.
+     */
+    variables: Record<string, string | number>;
+    /**
+     * The caller's deduplication key, unique per tenant.
+     *
+     * Enforced by a unique index rather than by a read before the insert. Two replicas processing
+     * the same event submit at the same instant, and the read-then-insert both of them do
+     * succeeds — the index is the only thing that turns that into one email.
+     */
+    idempotencyKey: Nullable<string>;
+    deliveries: NotificationDelivery[];
+    createdAt: IsoDateTime;
+}
+/** `POST /api/v1/notifications` */
+export interface SubmitNotificationBody {
+    /** A {@link NotificationTemplate} key. Unknown keys are refused at submit, not at send. */
+    type: string;
+    recipient: {
+        userId?: Nullable<UUID>;
+        emailAddress?: Nullable<string>;
+        localeCode?: Nullable<string>;
+    };
+    variables?: Nullable<Record<string, string | number>>;
+    /** Strongly recommended. Without one, a retried submit tells somebody the same thing twice. */
+    idempotencyKey?: Nullable<string>;
+}
+export interface SubmitNotificationResponse {
+    id: UUID;
+    /**
+     * True when the idempotency key matched an existing notification and nothing was created.
+     *
+     * Reported rather than flattened into success: it means the recipient was already being told,
+     * so a caller treating it as a fresh send would write a second record of one event.
+     */
+    isDuplicate: boolean;
+    deliveries: NotificationDelivery[];
+}
+/**
+ * A row in the caller's own in-app inbox, already rendered.
+ *
+ * Rendered text is returned rather than a key and variables, because it was rendered once at send
+ * time in the recipient's language and re-rendering it on read would let a published translation
+ * change what a notification from last week says.
+ */
+export interface InAppNotification {
+    id: UUID;
+    notificationId: UUID;
+    type: string;
+    subject: Nullable<string>;
+    body: string;
+    readAt: Nullable<IsoDateTime>;
+    createdAt: IsoDateTime;
+}
+export type InAppNotificationPage = CursorPage<InAppNotification>;
+export type NotificationDeliveryPage = CursorPage<NotificationDelivery>;
+//# sourceMappingURL=notification.type.d.ts.map

package/dist/esm/api/notification/notification.type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification.type.d.ts","sourceRoot":"","sources":["../../../../src/api/notification/notification.type.ts"],"names":[],"mappings":"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"}

package/dist/esm/api/notification/notification.type.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=notification.type.js.map

package/dist/esm/api/notification/notification.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification.type.js","sourceRoot":"","sources":["../../../../src/api/notification/notification.type.ts"],"names":[],"mappings":""}

package/dist/esm/enum/user-permission.enum.d.ts

@@ -271,7 +271,60 @@ export declare enum UserPermission {
      * rendering an invoice line hold this and nothing else here — they have no reason to read the
      * key catalogue, and separating it keeps a compromised worker from enumerating it.
      */
-    LOCALIZATION_RENDER = "localization:render"
+    LOCALIZATION_RENDER = "localization:render",
+    /**
+     * Submit a notification for delivery.
+     *
+     * **A service permission, and the sharpest one here.** It reaches a real person's mailbox with
+     * text the platform composed, and it is not deliberately absent from the seeded `ADMIN` role
+     * the way `UNIBOX_REALTIME_PUBLISH` is — an admin has no reason to hold it, because there is
+     * nothing for a human to prove by sending a notification to somebody else by hand.
+     *
+     * Note what it does *not* let a holder do: a submission names a **template key**, never a
+     * subject and body. The wording of every notification the platform sends was written by
+     * somebody holding {@link UserPermission.NOTIFICATION_TEMPLATE_MANAGE} and translated by
+     * somebody holding {@link UserPermission.LOCALIZATION_TRANSLATE}. This is the same shape as
+     * `CONDUIT_DISPATCH_SEND` naming an operation rather than a URL, and it is load-bearing for
+     * the same reason: without it, a compromised service principal is an authenticated way to
+     * send arbitrary text from our own domain to any address it likes.
+     */
+    NOTIFICATION_SEND = "notification:send",
+    /**
+     * Read **your own** in-app inbox, and mark your own rows read.
+     *
+     * Scoped to the calling principal by the endpoint, not by this permission — there is no
+     * variant that reads somebody else's inbox, because a notification is addressed to one person
+     * and reading another's is reading their mail. It belongs in every human role, including the
+     * narrowest, for the same reason: without it a member cannot see what the product is telling
+     * them.
+     */
+    NOTIFICATION_READ = "notification:read",
+    /** Read the tenant's notification templates and the platform's built-in ones. */
+    NOTIFICATION_TEMPLATE_READ = "notification:template:read",
+    /**
+     * Override a built-in template, or define a new one — which channels a notification type
+     * reaches and which message keys it renders.
+     *
+     * Configuration that decides what every future notification of a type says, including the
+     * password-reset email. Overriding one badly is a way to stop people getting back into their
+     * accounts, so it is separated from reading for the same reason `CONDUIT_CONNECTOR_MANAGE` is.
+     */
+    NOTIFICATION_TEMPLATE_MANAGE = "notification:template:manage",
+    /**
+     * Read the delivery log and the dead-letter queue, including each delivery's last error.
+     *
+     * Grouped with reading rather than with operating the queue, and it is closer to a data-read
+     * permission than a config one: the log names who was written to and about what.
+     */
+    NOTIFICATION_DELIVERY_READ = "notification:delivery:read",
+    /**
+     * Redrive a dead-lettered delivery, or cancel one still pending.
+     *
+     * Separate from reading because it causes a message to be sent to a person rather than
+     * returning a row — and because redriving a backlog is a way to mail somebody the same thing
+     * fifty times an hour after an outage.
+     */
+    NOTIFICATION_DELIVERY_OPERATE = "notification:delivery:operate"
 }
 /**
  * Every member, for seeding the owner role and validating custom-role input.

package/dist/esm/enum/user-permission.enum.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"user-permission.enum.d.ts","sourceRoot":"","sources":["../../../src/enum/user-permission.enum.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"user-permission.enum.d.ts","sourceRoot":"","sources":["../../../src/enum/user-permission.enum.ts"],"names":[],"mappings":"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"}