@iveri/contracts 0.19.0 → 0.21.0

package/dist/cjs/api/realtime/realtime.type.d.ts

@@ -0,0 +1,106 @@
+import type { IsoDateTime } from '../../type/iso-date-time.type.js';
+import type { UUID } from '../../type/uuid.type.js';
+import type { RealtimeEventType } from './realtime-event-type.enum.js';
+import type { RealtimeResourceType } from './realtime-resource-type.enum.js';
+export declare const REALTIME_CLIENT_EVENT: {
+    readonly SUBSCRIBE: "realtime.subscribe";
+    readonly UNSUBSCRIBE: "realtime.unsubscribe";
+};
+export declare const REALTIME_SERVER_EVENT: {
+    readonly READY: "realtime.ready";
+    readonly SUBSCRIBED: "realtime.subscribed";
+    readonly RESOURCE_UPDATED: "realtime.resource-updated";
+    readonly ERROR: "realtime.error";
+};
+export declare const REALTIME_PROTOCOL_VERSION = 1;
+export declare const MAX_REALTIME_SUBSCRIPTIONS_PER_SOCKET = 100;
+export declare const MAX_REALTIME_EVENT_BYTES: number;
+export declare const DEFAULT_REALTIME_GRANT_TTL_SECONDS = 120;
+export declare const MAX_REALTIME_GRANT_TTL_SECONDS = 300;
+export declare const REALTIME_GRANT_AUDIENCE = "iveri-realtime-subscription";
+export declare const REALTIME_GRANT_ISSUER = "iveri-realtime";
+/**
+ * Requested by an owning API only after it has authorized a person to read the resource.
+ *
+ * `tenantId` is absent: it comes from the API's service token. The grant is bound to
+ * `subjectId`, so copying one to another authenticated socket does not authorize that socket.
+ */
+export interface IssueRealtimeSubscriptionGrantBody {
+    subjectId: UUID;
+    resourceType: RealtimeResourceType;
+    resourceId: UUID;
+    ttlSeconds?: number;
+}
+export interface RealtimeSubscriptionGrantResponse {
+    grant: string;
+    expiresAt: IsoDateTime;
+}
+/** Claims inside a subscription grant signed and verified only by `iveri-realtime`. */
+export interface RealtimeSubscriptionGrantClaims {
+    jti: UUID;
+    sub: UUID;
+    tid: UUID;
+    azp: UUID;
+    resourceType: RealtimeResourceType;
+    resourceId: UUID;
+    purpose: 'subscription';
+    iat: number;
+    exp: number;
+    iss: typeof REALTIME_GRANT_ISSUER;
+    aud: typeof REALTIME_GRANT_AUDIENCE;
+}
+/**
+ * A product service's best-effort change notification.
+ *
+ * The tenant comes from the authenticated service principal and is intentionally absent here.
+ * `idempotencyKey` makes an HTTP retry harmless; no domain data or location coordinates travel
+ * over this channel.
+ */
+export interface PublishRealtimeEventBody {
+    idempotencyKey: UUID;
+    resourceType: RealtimeResourceType;
+    resourceId: UUID;
+    event: RealtimeEventType;
+    version: number;
+    occurredAt: IsoDateTime;
+}
+export interface PublishRealtimeEventResponse {
+    accepted: boolean;
+    duplicate: boolean;
+}
+/** A socket subscribes with grants, never with client-chosen room names or bare resource ids. */
+export interface RealtimeSubscribeRequest {
+    grants: string[];
+}
+export interface RealtimeUnsubscribeRequest {
+    subscriptions: RealtimeSubscription[];
+}
+export interface RealtimeSubscription {
+    resourceType: RealtimeResourceType;
+    resourceId: UUID;
+}
+export interface RealtimeReadyMessage {
+    protocolVersion: typeof REALTIME_PROTOCOL_VERSION;
+}
+export interface RealtimeSubscribedMessage {
+    subscriptions: RealtimeSubscription[];
+}
+export interface RealtimeResourceUpdatedMessage {
+    resourceType: RealtimeResourceType;
+    resourceId: UUID;
+    event: RealtimeEventType;
+    version: number;
+    occurredAt: IsoDateTime;
+}
+export interface RealtimeErrorMessage {
+    code: 'UNAUTHENTICATED' | 'FORBIDDEN' | 'INVALID_GRANT' | 'INVALID_SUBSCRIPTION' | 'SUBSCRIPTION_LIMIT_REACHED';
+    message: string;
+}
+export type RealtimeSubscriptionAck = {
+    ok: true;
+    message: RealtimeSubscribedMessage;
+} | {
+    ok: false;
+    message: RealtimeErrorMessage;
+};
+//# sourceMappingURL=realtime.type.d.ts.map

package/dist/cjs/api/realtime/realtime.type.d.ts.map

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

package/dist/cjs/api/realtime/realtime.type.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.REALTIME_GRANT_ISSUER = exports.REALTIME_GRANT_AUDIENCE = exports.MAX_REALTIME_GRANT_TTL_SECONDS = exports.DEFAULT_REALTIME_GRANT_TTL_SECONDS = exports.MAX_REALTIME_EVENT_BYTES = exports.MAX_REALTIME_SUBSCRIPTIONS_PER_SOCKET = exports.REALTIME_PROTOCOL_VERSION = exports.REALTIME_SERVER_EVENT = exports.REALTIME_CLIENT_EVENT = void 0;
+exports.REALTIME_CLIENT_EVENT = {
+    SUBSCRIBE: 'realtime.subscribe',
+    UNSUBSCRIBE: 'realtime.unsubscribe',
+};
+exports.REALTIME_SERVER_EVENT = {
+    READY: 'realtime.ready',
+    SUBSCRIBED: 'realtime.subscribed',
+    RESOURCE_UPDATED: 'realtime.resource-updated',
+    ERROR: 'realtime.error',
+};
+exports.REALTIME_PROTOCOL_VERSION = 1;
+exports.MAX_REALTIME_SUBSCRIPTIONS_PER_SOCKET = 100;
+exports.MAX_REALTIME_EVENT_BYTES = 4 * 1024;
+exports.DEFAULT_REALTIME_GRANT_TTL_SECONDS = 120;
+exports.MAX_REALTIME_GRANT_TTL_SECONDS = 300;
+exports.REALTIME_GRANT_AUDIENCE = 'iveri-realtime-subscription';
+exports.REALTIME_GRANT_ISSUER = 'iveri-realtime';
+//# sourceMappingURL=realtime.type.js.map

package/dist/cjs/api/realtime/realtime.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime.type.js","sourceRoot":"","sources":["../../../../src/api/realtime/realtime.type.ts"],"names":[],"mappings":";;;AAMa,QAAA,qBAAqB,GAAG;IACjC,SAAS,EAAE,oBAAoB;IAC/B,WAAW,EAAE,sBAAsB;CAC7B,CAAC;AAEE,QAAA,qBAAqB,GAAG;IACjC,KAAK,EAAE,gBAAgB;IACvB,UAAU,EAAE,qBAAqB;IACjC,gBAAgB,EAAE,2BAA2B;IAC7C,KAAK,EAAE,gBAAgB;CACjB,CAAC;AAEE,QAAA,yBAAyB,GAAG,CAAC,CAAC;AAC9B,QAAA,qCAAqC,GAAG,GAAG,CAAC;AAC5C,QAAA,wBAAwB,GAAG,CAAC,GAAG,IAAI,CAAC;AACpC,QAAA,kCAAkC,GAAG,GAAG,CAAC;AACzC,QAAA,8BAA8B,GAAG,GAAG,CAAC;AACrC,QAAA,uBAAuB,GAAG,6BAA6B,CAAC;AACxD,QAAA,qBAAqB,GAAG,gBAAgB,CAAC"}

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

@@ -271,7 +271,72 @@ 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",
+    /**
+     * Ask the shared gateway to issue a short-lived subscription grant after the owning API has
+     * authorized a person to read one resource. Service-only: a human may consume a grant but
+     * must never mint one.
+     */
+    REALTIME_SUBSCRIPTION_GRANT_ISSUE = "realtime:subscription-grant:issue",
+    /**
+     * Publish an identifier-only resource change. Separate from grant issue because announcing a
+     * write and authorizing a read are distinct powers and a service may legitimately need one
+     * without the other.
+     */
+    REALTIME_EVENT_PUBLISH = "realtime:event:publish"
 }
 /**
  * Every member, for seeding the owner role and validating custom-role input.

package/dist/cjs/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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"}

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

@@ -319,6 +319,73 @@ 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";
+    // ══ iveri-realtime ══════════════════════════════════════════════════════
+    /**
+     * Ask the shared gateway to issue a short-lived subscription grant after the owning API has
+     * authorized a person to read one resource. Service-only: a human may consume a grant but
+     * must never mint one.
+     */
+    UserPermission["REALTIME_SUBSCRIPTION_GRANT_ISSUE"] = "realtime:subscription-grant:issue";
+    /**
+     * Publish an identifier-only resource change. Separate from grant issue because announcing a
+     * write and authorizing a read are distinct powers and a service may legitimately need one
+     * without the other.
+     */
+    UserPermission["REALTIME_EVENT_PUBLISH"] = "realtime:event:publish";
 })(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/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":""}