@iveri/contracts 0.16.0 → 0.18.0

package/dist/cjs/api/localization/translation-status.enum.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TranslationStatus = void 0;
+/**
+ * Where a single translation stands, for one message in one locale.
+ *
+ * The states exist to answer one question a translator asks constantly — *what is left to do* —
+ * and they are ordered by how much trust a reader may put in the value.
+ *
+ * `MISSING` is **not stored**. A translation row exists only once someone has written something,
+ * so "missing" is the absence of a row projected into this enum by the read side. Storing it
+ * would mean writing a row per message per locale the moment a key is created, which turns
+ * adding one key into N writes and makes "has anyone touched this?" unanswerable.
+ */
+var TranslationStatus;
+(function (TranslationStatus) {
+    /** No row exists. Synthesised by the read side so a listing can be filtered on it. */
+    TranslationStatus["MISSING"] = "missing";
+    /** Someone is working on it. Excluded from a release unless the namespace allows drafts. */
+    TranslationStatus["DRAFT"] = "draft";
+    /**
+     * Written, but the source text changed underneath it.
+     *
+     * Set automatically when the source-locale value of the same message is edited — an English
+     * label reworded from `Archive` to `Delete` leaves a Georgian translation that is
+     * grammatically fine and now says the wrong thing. Nothing else in the system can catch that,
+     * because the translation is still valid text.
+     */
+    TranslationStatus["NEEDS_REVIEW"] = "needs-review";
+    /** Reviewed and publishable. */
+    TranslationStatus["APPROVED"] = "approved";
+})(TranslationStatus || (exports.TranslationStatus = TranslationStatus = {}));
+//# sourceMappingURL=translation-status.enum.js.map

package/dist/cjs/api/localization/translation-status.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"translation-status.enum.js","sourceRoot":"","sources":["../../../../src/api/localization/translation-status.enum.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;GAUG;AACH,IAAY,iBAmBX;AAnBD,WAAY,iBAAiB;IACzB,sFAAsF;IACtF,wCAAmB,CAAA;IAEnB,4FAA4F;IAC5F,oCAAe,CAAA;IAEf;;;;;;;OAOG;IACH,kDAA6B,CAAA;IAE7B,gCAAgC;IAChC,0CAAqB,CAAA;AACzB,CAAC,EAnBW,iBAAiB,iCAAjB,iBAAiB,QAmB5B"}

package/dist/cjs/api/localization/translation.type.d.ts

@@ -0,0 +1,74 @@
+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 { TranslationStatus } from './translation-status.enum.js';
+/**
+ * One message, in one locale.
+ *
+ * `value` is **ICU MessageFormat**, not a template string with our own placeholder syntax. That
+ * choice is the reason this service can be correct in Russian: Russian selects between `one`,
+ * `few`, `many` and `other` on the *numeric* value, and a hand-rolled `count === 1 ? a : b` is
+ * wrong for 2, 5 and 21 in ways an English-speaking reviewer cannot see. ICU already encodes
+ * every locale's plural rules, so the translation carries the branch and the code carries none.
+ */
+export interface Translation {
+    id: UUID;
+    messageId: UUID;
+    messageKey: string;
+    namespaceKey: string;
+    localeCode: string;
+    /** ICU MessageFormat. Validated against the message's declared variables on every write. */
+    value: string;
+    status: TranslationStatus;
+    /** Null when written by a service principal rather than a person. */
+    updatedByUserId: Nullable<UUID>;
+    createdAt: IsoDateTime;
+    updatedAt: IsoDateTime;
+}
+/**
+ * `PUT /api/v1/namespaces/:key/messages/:messageKey/translations/:localeCode`.
+ *
+ * An upsert rather than create/update, because a translator does not know or care whether a row
+ * exists — `MISSING` is the absence of one, and making them discover that through a 404 would be
+ * exposing our storage decision as a workflow step.
+ */
+export interface UpsertTranslationBody {
+    value: string;
+    /**
+     * Defaults to `DRAFT`. Setting `APPROVED` requires the same permission as any other write —
+     * approving is not separately gated, because the gate that matters is publishing.
+     */
+    status?: TranslationStatus;
+}
+/**
+ * `POST /api/v1/namespaces/:key/translations/bulk` — one locale, many messages.
+ *
+ * The entries that validate are written together in one transaction; the ones that do not are
+ * reported back. See {@link BulkUpsertTranslationsResult} for why it is not all-or-nothing.
+ */
+export interface BulkUpsertTranslationsBody {
+    localeCode: string;
+    entries: BulkTranslationEntry[];
+}
+export interface BulkTranslationEntry {
+    messageKey: string;
+    value: string;
+    status?: TranslationStatus;
+}
+/**
+ * The result of a bulk write.
+ *
+ * Rejections are returned per entry instead of failing the whole batch, because the usual caller
+ * is an import of a file a translator produced elsewhere: refusing 400 good rows over one bad
+ * placeholder means they have no way to make progress, and the failure they must fix is
+ * precisely the one this names.
+ */
+export interface BulkUpsertTranslationsResult {
+    written: number;
+    rejected: RejectedTranslation[];
+}
+export interface RejectedTranslation {
+    messageKey: string;
+    reason: string;
+}
+//# sourceMappingURL=translation.type.d.ts.map

package/dist/cjs/api/localization/translation.type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"translation.type.d.ts","sourceRoot":"","sources":["../../../../src/api/localization/translation.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,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAEtE;;;;;;;;GAQG;AACH,MAAM,WAAW,WAAW;IACxB,EAAE,EAAE,IAAI,CAAC;IAET,SAAS,EAAE,IAAI,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IAEnB,4FAA4F;IAC5F,KAAK,EAAE,MAAM,CAAC;IAEd,MAAM,EAAE,iBAAiB,CAAC;IAE1B,qEAAqE;IACrE,eAAe,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;IAEhC,SAAS,EAAE,WAAW,CAAC;IACvB,SAAS,EAAE,WAAW,CAAC;CAC1B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,qBAAqB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,MAAM,CAAC,EAAE,iBAAiB,CAAC;CAC9B;AAED;;;;;GAKG;AACH,MAAM,WAAW,0BAA0B;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,oBAAoB,EAAE,CAAC;CACnC;AAED,MAAM,WAAW,oBAAoB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,iBAAiB,CAAC;CAC9B;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,4BAA4B;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,mBAAmB,EAAE,CAAC;CACnC;AAED,MAAM,WAAW,mBAAmB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAClB"}

package/dist/cjs/api/localization/translation.type.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=translation.type.js.map

package/dist/cjs/api/localization/translation.type.js.map

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

package/dist/cjs/api/localization/variable-type.enum.d.ts

@@ -0,0 +1,39 @@
+/**
+ * The kind of value a message placeholder expects.
+ *
+ * **Declared on the message, not inferred from the text.** A translation is rejected at write
+ * time if its placeholders do not match the message's declared set, which is the single check
+ * that stops a Russian string shipping with a literal `{orderNumber}` in front of a customer.
+ * Inferring the set from whichever locale happened to be written first would make the check
+ * circular — the first typo becomes the specification.
+ *
+ * The type is what tells a renderer how to format the value and what an editor should show as an
+ * example. It also tells a translator what they are allowed to do with it: `PLURAL` may be
+ * branched on, `STRING` may not.
+ */
+export declare enum VariableType {
+    /** Substituted verbatim. `{name}` */
+    STRING = "string",
+    /** Formatted with `Intl.NumberFormat` for the target locale. `{count, number}` */
+    NUMBER = "number",
+    /** Formatted with `Intl.DateTimeFormat` for the target locale. `{dueAt, date, medium}` */
+    DATE = "date",
+    /**
+     * A count the translation branches on: `{n, plural, one {...} few {...} other {...}}`.
+     *
+     * Distinct from `NUMBER` because the plural categories a locale needs are not a formatting
+     * choice. Russian has `one`/`few`/`many`/`other` and English has `one`/`other`, so a
+     * translation written by substituting a number and appending an "s" is wrong in Russian in a
+     * way no reviewer of the English can see.
+     */
+    PLURAL = "plural",
+    /**
+     * A closed set the translation branches on: `{gender, select, female {...} other {...}}`.
+     *
+     * Georgian and Russian inflect around the subject where English does not, so a sentence that
+     * needs no branch in the source locale needs one in the target. The declared options are the
+     * contract — a translation branching on an option the message never declared is rejected.
+     */
+    SELECT = "select"
+}
+//# sourceMappingURL=variable-type.enum.d.ts.map

package/dist/cjs/api/localization/variable-type.enum.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"variable-type.enum.d.ts","sourceRoot":"","sources":["../../../../src/api/localization/variable-type.enum.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,oBAAY,YAAY;IACpB,qCAAqC;IACrC,MAAM,WAAW;IAEjB,kFAAkF;IAClF,MAAM,WAAW;IAEjB,0FAA0F;IAC1F,IAAI,SAAS;IAEb;;;;;;;OAOG;IACH,MAAM,WAAW;IAEjB;;;;;;OAMG;IACH,MAAM,WAAW;CACpB"}

package/dist/cjs/api/localization/variable-type.enum.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VariableType = void 0;
+/**
+ * The kind of value a message placeholder expects.
+ *
+ * **Declared on the message, not inferred from the text.** A translation is rejected at write
+ * time if its placeholders do not match the message's declared set, which is the single check
+ * that stops a Russian string shipping with a literal `{orderNumber}` in front of a customer.
+ * Inferring the set from whichever locale happened to be written first would make the check
+ * circular — the first typo becomes the specification.
+ *
+ * The type is what tells a renderer how to format the value and what an editor should show as an
+ * example. It also tells a translator what they are allowed to do with it: `PLURAL` may be
+ * branched on, `STRING` may not.
+ */
+var VariableType;
+(function (VariableType) {
+    /** Substituted verbatim. `{name}` */
+    VariableType["STRING"] = "string";
+    /** Formatted with `Intl.NumberFormat` for the target locale. `{count, number}` */
+    VariableType["NUMBER"] = "number";
+    /** Formatted with `Intl.DateTimeFormat` for the target locale. `{dueAt, date, medium}` */
+    VariableType["DATE"] = "date";
+    /**
+     * A count the translation branches on: `{n, plural, one {...} few {...} other {...}}`.
+     *
+     * Distinct from `NUMBER` because the plural categories a locale needs are not a formatting
+     * choice. Russian has `one`/`few`/`many`/`other` and English has `one`/`other`, so a
+     * translation written by substituting a number and appending an "s" is wrong in Russian in a
+     * way no reviewer of the English can see.
+     */
+    VariableType["PLURAL"] = "plural";
+    /**
+     * A closed set the translation branches on: `{gender, select, female {...} other {...}}`.
+     *
+     * Georgian and Russian inflect around the subject where English does not, so a sentence that
+     * needs no branch in the source locale needs one in the target. The declared options are the
+     * contract — a translation branching on an option the message never declared is rejected.
+     */
+    VariableType["SELECT"] = "select";
+})(VariableType || (exports.VariableType = VariableType = {}));
+//# sourceMappingURL=variable-type.enum.js.map

package/dist/cjs/api/localization/variable-type.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"variable-type.enum.js","sourceRoot":"","sources":["../../../../src/api/localization/variable-type.enum.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;;GAYG;AACH,IAAY,YA4BX;AA5BD,WAAY,YAAY;IACpB,qCAAqC;IACrC,iCAAiB,CAAA;IAEjB,kFAAkF;IAClF,iCAAiB,CAAA;IAEjB,0FAA0F;IAC1F,6BAAa,CAAA;IAEb;;;;;;;OAOG;IACH,iCAAiB,CAAA;IAEjB;;;;;;OAMG;IACH,iCAAiB,CAAA;AACrB,CAAC,EA5BW,YAAY,4BAAZ,YAAY,QA4BvB"}

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

@@ -3,6 +3,7 @@ import type { RealtimeConversationEvent } from './realtime-event.enum.js';
 /** Socket.IO event names a client sends. */
 export declare const REALTIME_CLIENT_EVENT: {
     readonly SUBSCRIBE: "realtime.subscribe";
+    readonly UNSUBSCRIBE: "realtime.unsubscribe";
 };
 /** Socket.IO event names a client receives. */
 export declare const REALTIME_SERVER_EVENT: {
@@ -48,10 +49,21 @@ export interface PublishConversationEventResponse {
 export interface RealtimeReadyMessage {
     protocolVersion: typeof REALTIME_PROTOCOL_VERSION;
 }
-/** What a client asks to watch. */
+/** What a client asks to watch. Additive — the socket keeps what it already had. */
 export interface RealtimeSubscribeRequest {
     conversationIds: UUID[];
 }
+/**
+ * What a client asks to stop watching.
+ *
+ * Subscribing is additive and capped at {@link MAX_REALTIME_SUBSCRIPTIONS_PER_SOCKET}, so
+ * without this a long-lived inbox that pages through conversations reaches the cap and then
+ * silently stops receiving anything new. Unsubscribing what has scrolled out of view is what
+ * keeps the set bounded by what is on screen rather than by everything ever looked at.
+ */
+export interface RealtimeUnsubscribeRequest {
+    conversationIds: UUID[];
+}
 /** The full set a socket is watching after a subscribe, not just the delta. */
 export interface RealtimeSubscribedMessage {
     conversationIds: UUID[];

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

@@ -1 +1 @@
-{"version":3,"file":"realtime.type.d.ts","sourceRoot":"","sources":["../../../../src/api/unibox/realtime.type.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAC;AAEpD,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AAE1E,4CAA4C;AAC5C,eAAO,MAAM,qBAAqB;;CAExB,CAAC;AAEX,+CAA+C;AAC/C,eAAO,MAAM,qBAAqB;;;;;CAKxB,CAAC;AAEX,4FAA4F;AAC5F,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAE3C,oDAAoD;AACpD,eAAO,MAAM,qCAAqC,MAAM,CAAC;AAEzD,0CAA0C;AAC1C,eAAO,MAAM,wBAAwB,QAAY,CAAC;AAElD,oDAAoD;AACpD,eAAO,MAAM,8BAA8B,MAAM,CAAC;AAElD;;;;;;;GAOG;AACH,MAAM,WAAW,4BAA4B;IACzC,cAAc,EAAE,IAAI,CAAC;IACrB,KAAK,EAAE,yBAAyB,CAAC;IACjC,uFAAuF;IACvF,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,+CAA+C;AAC/C,MAAM,WAAW,gCAAgC;IAC7C;;;;;;OAMG;IACH,QAAQ,EAAE,OAAO,CAAC;CACrB;AAED,gDAAgD;AAChD,MAAM,WAAW,oBAAoB;IACjC,eAAe,EAAE,OAAO,yBAAyB,CAAC;CACrD;AAED,mCAAmC;AACnC,MAAM,WAAW,wBAAwB;IACrC,eAAe,EAAE,IAAI,EAAE,CAAC;CAC3B;AAED,+EAA+E;AAC/E,MAAM,WAAW,yBAAyB;IACtC,eAAe,EAAE,IAAI,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,oBAAoB;IACjC,IAAI,EAAE,iBAAiB,GAAG,WAAW,GAAG,sBAAsB,GAAG,mBAAmB,CAAC;IACrF,OAAO,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,0BAA0B;IACvC,cAAc,EAAE,IAAI,CAAC;IACrB,KAAK,EAAE,yBAAyB,CAAC;IACjC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,+DAA+D;AAC/D,MAAM,MAAM,uBAAuB,GAC/B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,yBAAyB,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,oBAAoB,CAAA;CAAE,CAAC"}
+{"version":3,"file":"realtime.type.d.ts","sourceRoot":"","sources":["../../../../src/api/unibox/realtime.type.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAC;AAEpD,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AAE1E,4CAA4C;AAC5C,eAAO,MAAM,qBAAqB;;;CAGxB,CAAC;AAEX,+CAA+C;AAC/C,eAAO,MAAM,qBAAqB;;;;;CAKxB,CAAC;AAEX,4FAA4F;AAC5F,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAE3C,oDAAoD;AACpD,eAAO,MAAM,qCAAqC,MAAM,CAAC;AAEzD,0CAA0C;AAC1C,eAAO,MAAM,wBAAwB,QAAY,CAAC;AAElD,oDAAoD;AACpD,eAAO,MAAM,8BAA8B,MAAM,CAAC;AAElD;;;;;;;GAOG;AACH,MAAM,WAAW,4BAA4B;IACzC,cAAc,EAAE,IAAI,CAAC;IACrB,KAAK,EAAE,yBAAyB,CAAC;IACjC,uFAAuF;IACvF,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,+CAA+C;AAC/C,MAAM,WAAW,gCAAgC;IAC7C;;;;;;OAMG;IACH,QAAQ,EAAE,OAAO,CAAC;CACrB;AAED,gDAAgD;AAChD,MAAM,WAAW,oBAAoB;IACjC,eAAe,EAAE,OAAO,yBAAyB,CAAC;CACrD;AAED,oFAAoF;AACpF,MAAM,WAAW,wBAAwB;IACrC,eAAe,EAAE,IAAI,EAAE,CAAC;CAC3B;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,0BAA0B;IACvC,eAAe,EAAE,IAAI,EAAE,CAAC;CAC3B;AAED,+EAA+E;AAC/E,MAAM,WAAW,yBAAyB;IACtC,eAAe,EAAE,IAAI,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,oBAAoB;IACjC,IAAI,EAAE,iBAAiB,GAAG,WAAW,GAAG,sBAAsB,GAAG,mBAAmB,CAAC;IACrF,OAAO,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,0BAA0B;IACvC,cAAc,EAAE,IAAI,CAAC;IACrB,KAAK,EAAE,yBAAyB,CAAC;IACjC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,+DAA+D;AAC/D,MAAM,MAAM,uBAAuB,GAC/B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,yBAAyB,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,oBAAoB,CAAA;CAAE,CAAC"}

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

@@ -4,6 +4,7 @@ exports.MAX_REALTIME_EVENT_NAME_LENGTH = exports.MAX_REALTIME_EVENT_BYTES = expo
 /** Socket.IO event names a client sends. */
 exports.REALTIME_CLIENT_EVENT = {
     SUBSCRIBE: 'realtime.subscribe',
+    UNSUBSCRIBE: 'realtime.unsubscribe',
 };
 /** Socket.IO event names a client receives. */
 exports.REALTIME_SERVER_EVENT = {

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

@@ -1 +1 @@
-{"version":3,"file":"realtime.type.js","sourceRoot":"","sources":["../../../../src/api/unibox/realtime.type.ts"],"names":[],"mappings":";;;AAIA,4CAA4C;AAC/B,QAAA,qBAAqB,GAAG;IACjC,SAAS,EAAE,oBAAoB;CACzB,CAAC;AAEX,+CAA+C;AAClC,QAAA,qBAAqB,GAAG;IACjC,KAAK,EAAE,gBAAgB;IACvB,UAAU,EAAE,qBAAqB;IACjC,oBAAoB,EAAE,sBAAsB;IAC5C,KAAK,EAAE,gBAAgB;CACjB,CAAC;AAEX,4FAA4F;AAC/E,QAAA,yBAAyB,GAAG,CAAC,CAAC;AAE3C,oDAAoD;AACvC,QAAA,qCAAqC,GAAG,GAAG,CAAC;AAEzD,0CAA0C;AAC7B,QAAA,wBAAwB,GAAG,EAAE,GAAG,IAAI,CAAC;AAElD,oDAAoD;AACvC,QAAA,8BAA8B,GAAG,GAAG,CAAC"}
+{"version":3,"file":"realtime.type.js","sourceRoot":"","sources":["../../../../src/api/unibox/realtime.type.ts"],"names":[],"mappings":";;;AAIA,4CAA4C;AAC/B,QAAA,qBAAqB,GAAG;IACjC,SAAS,EAAE,oBAAoB;IAC/B,WAAW,EAAE,sBAAsB;CAC7B,CAAC;AAEX,+CAA+C;AAClC,QAAA,qBAAqB,GAAG;IACjC,KAAK,EAAE,gBAAgB;IACvB,UAAU,EAAE,qBAAqB;IACjC,oBAAoB,EAAE,sBAAsB;IAC5C,KAAK,EAAE,gBAAgB;CACjB,CAAC;AAEX,4FAA4F;AAC/E,QAAA,yBAAyB,GAAG,CAAC,CAAC;AAE3C,oDAAoD;AACvC,QAAA,qCAAqC,GAAG,GAAG,CAAC;AAEzD,0CAA0C;AAC7B,QAAA,wBAAwB,GAAG,EAAE,GAAG,IAAI,CAAC;AAElD,oDAAoD;AACvC,QAAA,8BAA8B,GAAG,GAAG,CAAC"}

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

@@ -228,7 +228,50 @@ export declare enum UserPermission {
     /** Read tenant invoices and their immutable line items. */
     BILLING_INVOICE_READ = "billing:invoice:read",
     /** Create, finalize or void tenant invoices. */
-    BILLING_INVOICE_MANAGE = "billing:invoice:manage"
+    BILLING_INVOICE_MANAGE = "billing:invoice:manage",
+    /**
+     * Read locales, namespaces, keys, translations and release history — and pull a published
+     * bundle, which is how a build gets its strings.
+     *
+     * One read permission over all of it rather than one per aggregate: none of it is secret. It
+     * is text written to be shown to users, and a key list with the values hidden is unusable
+     * for the review this permission exists to enable.
+     */
+    LOCALIZATION_READ = "localization:read",
+    /**
+     * Define the structure — locales, namespaces, message keys and their declared variables.
+     *
+     * The engineer's half, and the sharper one despite sounding like configuration. A message key
+     * is compiled into an app (`t('inbox.title')`), so archiving one breaks a screen that already
+     * shipped; and editing a message's declared variables invalidates every translation of it in
+     * every language at once. A translator must not be able to do either by accident.
+     */
+    LOCALIZATION_MESSAGE_MANAGE = "localization:message:manage",
+    /**
+     * Write translation values.
+     *
+     * The translator's whole job, and deliberately the *only* thing it grants. This is the
+     * permission handed to an outside contractor or an agency, so it must be safe to hand to
+     * someone with no stake in the codebase: they can rewrite every string in the product and
+     * cannot add a key, remove one, or put a word of it in front of a customer.
+     */
+    LOCALIZATION_TRANSLATE = "localization:translate",
+    /**
+     * Cut a release — the act that actually changes what users read.
+     *
+     * Separate from `LOCALIZATION_TRANSLATE` for the reason the release aggregate exists at all:
+     * editing has to be free so a translator can work in the tool instead of in a spreadsheet,
+     * which is only tolerable if editing is not shipping. This is the gate between the two.
+     */
+    LOCALIZATION_PUBLISH = "localization:publish",
+    /**
+     * Resolve and format messages at runtime through `POST /render`.
+     *
+     * A service permission. `iveri-messaging-api` rendering an OTP body and `iveri-billing-api`
+     * 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"
 }
 /**
  * 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":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,oBAAY,cAAc;IAItB,WAAW,gBAAgB;IAC3B,aAAa,kBAAkB;IAC/B,sFAAsF;IACtF,aAAa,kBAAkB;IAG/B,SAAS,cAAc;IACvB,WAAW,gBAAgB;IAC3B,WAAW,gBAAgB;IAC3B,WAAW,gBAAgB;IAG3B,eAAe,oBAAoB;IACnC,6EAA6E;IAC7E,iBAAiB,sBAAsB;IACvC;;;OAGG;IACH,sBAAsB,2BAA2B;IAGjD,SAAS,cAAc;IACvB,WAAW,gBAAgB;IAC3B,WAAW,gBAAgB;IAC3B,WAAW,gBAAgB;IAG3B,YAAY,iBAAiB;IAC7B,aAAa,kBAAkB;IAC/B,cAAc,mBAAmB;IAKjC,qEAAqE;IACrE,qBAAqB,0BAA0B;IAC/C,uBAAuB,4BAA4B;IACnD,uBAAuB,4BAA4B;IACnD,uBAAuB,4BAA4B;IAGnD;;;;OAIG;IACH,oBAAoB,yBAAyB;IAC7C,sBAAsB,2BAA2B;IAGjD;;;;OAIG;IACH,sBAAsB,2BAA2B;IAGjD,qBAAqB,0BAA0B;IAC/C,yFAAyF;IACzF,uBAAuB,4BAA4B;IAGnD,mEAAmE;IACnE,wBAAwB,6BAA6B;IACrD;;;;;;;OAOG;IACH,0BAA0B,+BAA+B;IAGzD,kBAAkB,uBAAuB;IACzC,2DAA2D;IAC3D,oBAAoB,yBAAyB;IAG7C;;;;;OAKG;IACH,qBAAqB,0BAA0B;IAC/C;;;;;;OAMG;IACH,wBAAwB,6BAA6B;IAGrD,wFAAwF;IACxF,sBAAsB,2BAA2B;IACjD;;;;;;;;OAQG;IACH,wBAAwB,6BAA6B;IAGrD,sEAAsE;IACtE,uBAAuB,4BAA4B;IACnD;;;;;OAKG;IACH,yBAAyB,8BAA8B;IAGvD;;;;;OAKG;IACH,qBAAqB,0BAA0B;IAC/C;;;;;;;OAOG;IACH,qBAAqB,0BAA0B;IAC/C,qEAAqE;IACrE,wBAAwB,6BAA6B;IAKrD,4EAA4E;IAC5E,qBAAqB,0BAA0B;IAC/C,yEAAyE;IACzE,uBAAuB,4BAA4B;IAInD,iEAAiE;IACjE,sBAAsB,2BAA2B;IACjD,mDAAmD;IACnD,sBAAsB,2BAA2B;IACjD,qEAAqE;IACrE,kBAAkB,uBAAuB;IACzC,uEAAuE;IACvE,qBAAqB,0BAA0B;IAC/C,yFAAyF;IACzF,uBAAuB,4BAA4B;IAKnD,kFAAkF;IAClF,mBAAmB,wBAAwB;IAC3C;;;;;;OAMG;IACH,qBAAqB,0BAA0B;IAG/C,2FAA2F;IAC3F,mBAAmB,wBAAwB;IAC3C,gDAAgD;IAChD,qBAAqB,0BAA0B;IAG/C;;;;;;;OAOG;IACH,wBAAwB,6BAA6B;IACrD,yFAAyF;IACzF,0BAA0B,+BAA+B;IACzD;;;;;;OAMG;IACH,0BAA0B,+BAA+B;IAGzD;;;;;;OAMG;IACH,mBAAmB,wBAAwB;IAG3C,gBAAgB,qBAAqB;IACrC,8FAA8F;IAC9F,kBAAkB,uBAAuB;IAGzC,wBAAwB,6BAA6B;IACrD,oEAAoE;IACpE,0BAA0B,+BAA+B;IAGzD;;;;;;;;;;;OAWG;IACH,uBAAuB,4BAA4B;IAGnD,gGAAgG;IAChG,aAAa,kBAAkB;IAG/B,6EAA6E;IAC7E,eAAe,oBAAoB;IACnC,wDAAwD;IACxD,iBAAiB,sBAAsB;IAKvC,8CAA8C;IAC9C,iBAAiB,sBAAsB;IACvC,sDAAsD;IACtD,mBAAmB,wBAAwB;IAG3C,6DAA6D;IAC7D,yBAAyB,8BAA8B;IACvD,qDAAqD;IACrD,2BAA2B,gCAAgC;IAG3D,yCAAyC;IACzC,kBAAkB,uBAAuB;IACzC,2DAA2D;IAC3D,oBAAoB,yBAAyB;IAG7C,+DAA+D;IAC/D,oBAAoB,yBAAyB;IAC7C,+EAA+E;IAC/E,sBAAsB,2BAA2B;IAGjD,2DAA2D;IAC3D,oBAAoB,yBAAyB;IAC7C,gDAAgD;IAChD,sBAAsB,2BAA2B;IAUjD;;;;;;;OAOG;IACH,iBAAiB,sBAAsB;IAEvC;;;;;;;OAOG;IACH,2BAA2B,gCAAgC;IAE3D;;;;;;;OAOG;IACH,sBAAsB,2BAA2B;IAEjD;;;;;;OAMG;IACH,oBAAoB,yBAAyB;IAE7C;;;;;;OAMG;IACH,mBAAmB,wBAAwB;CAC9C;AAED;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,EAAE,SAAS,cAAc,EAAiD,CAAC"}

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

@@ -269,6 +269,56 @@ var UserPermission;
     UserPermission["BILLING_INVOICE_READ"] = "billing:invoice:read";
     /** Create, finalize or void tenant invoices. */
     UserPermission["BILLING_INVOICE_MANAGE"] = "billing:invoice:manage";
+    // ══ iveri-localization-api ══════════════════════════════════════════════
+    //
+    // Four permissions for what looks like one job, because translation has four distinct
+    // audiences and the whole point of the service is that they are not the same person. An
+    // engineer defines keys, a translator writes values, a reviewer decides a language is ready,
+    // and a service reads the result. Collapsing them means a contractor hired to translate a
+    // panel into Georgian can delete the keys the panel is built from.
+    /**
+     * Read locales, namespaces, keys, translations and release history — and pull a published
+     * bundle, which is how a build gets its strings.
+     *
+     * One read permission over all of it rather than one per aggregate: none of it is secret. It
+     * is text written to be shown to users, and a key list with the values hidden is unusable
+     * for the review this permission exists to enable.
+     */
+    UserPermission["LOCALIZATION_READ"] = "localization:read";
+    /**
+     * Define the structure — locales, namespaces, message keys and their declared variables.
+     *
+     * The engineer's half, and the sharper one despite sounding like configuration. A message key
+     * is compiled into an app (`t('inbox.title')`), so archiving one breaks a screen that already
+     * shipped; and editing a message's declared variables invalidates every translation of it in
+     * every language at once. A translator must not be able to do either by accident.
+     */
+    UserPermission["LOCALIZATION_MESSAGE_MANAGE"] = "localization:message:manage";
+    /**
+     * Write translation values.
+     *
+     * The translator's whole job, and deliberately the *only* thing it grants. This is the
+     * permission handed to an outside contractor or an agency, so it must be safe to hand to
+     * someone with no stake in the codebase: they can rewrite every string in the product and
+     * cannot add a key, remove one, or put a word of it in front of a customer.
+     */
+    UserPermission["LOCALIZATION_TRANSLATE"] = "localization:translate";
+    /**
+     * Cut a release — the act that actually changes what users read.
+     *
+     * Separate from `LOCALIZATION_TRANSLATE` for the reason the release aggregate exists at all:
+     * editing has to be free so a translator can work in the tool instead of in a spreadsheet,
+     * which is only tolerable if editing is not shipping. This is the gate between the two.
+     */
+    UserPermission["LOCALIZATION_PUBLISH"] = "localization:publish";
+    /**
+     * Resolve and format messages at runtime through `POST /render`.
+     *
+     * A service permission. `iveri-messaging-api` rendering an OTP body and `iveri-billing-api`
+     * 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.
+     */
+    UserPermission["LOCALIZATION_RENDER"] = "localization:render";
 })(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/bundle.type.d.ts

@@ -0,0 +1,41 @@
+import type { IsoDateTime } from '../../type/iso-date-time.type.js';
+/**
+ * One namespace at one locale, flattened — what a build pulls and commits into a repo.
+ *
+ * **UI strings are fetched at build time, never at runtime, and that is the load-bearing decision
+ * in this service.** A React app that fetched its labels on mount would put a network call in
+ * front of every first paint, make this service a hard dependency of two admin panels that are
+ * otherwise happy while it is down, and render a screen of empty strings when it is not. The
+ * strings were known when the app compiled; that is when they should be baked in.
+ *
+ * So a consumer runs `pnpm i18n:pull`, gets one of these per locale, writes it to
+ * `src/locale/<code>.json`, and commits it. The diff is reviewable, the app has no runtime
+ * dependency, and rolling back a bad translation is `git revert`.
+ *
+ * {@link RenderedMessage} is the other half — for text produced on a server, where there is no
+ * bundle to bake into.
+ */
+export interface TranslationBundle {
+    namespaceKey: string;
+    localeCode: string;
+    /** The release this was cut from. Pinned by the consumer; `latest` resolves to a number. */
+    version: number;
+    generatedAt: IsoDateTime;
+    /**
+     * Message key to ICU value.
+     *
+     * **Flat, not nested.** `{"inbox.title": "..."}` rather than `{"inbox": {"title": "..."}}`,
+     * even though the dotted keys invite nesting. Nesting means a key containing a dot becomes
+     * ambiguous, and it makes `messages[key]` — the only lookup anyone performs — a path walk
+     * instead of a property read.
+     */
+    messages: Record<string, string>;
+    /**
+     * Keys served from a fallback locale rather than this one, and where they came from.
+     *
+     * Emitted so a build can fail, or warn, on an incomplete bundle. Without it a half-translated
+     * locale looks identical to a complete one: every key resolves, and half of them are English.
+     */
+    fallbacks: Record<string, string>;
+}
+//# sourceMappingURL=bundle.type.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bundle.type.d.ts","sourceRoot":"","sources":["../../../../src/api/localization/bundle.type.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAEpE;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,iBAAiB;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IAEnB,4FAA4F;IAC5F,OAAO,EAAE,MAAM,CAAC;IAEhB,WAAW,EAAE,WAAW,CAAC;IAEzB;;;;;;;OAOG;IACH,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEjC;;;;;OAKG;IACH,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACrC"}

package/dist/esm/api/localization/bundle.type.js

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

package/dist/esm/api/localization/bundle.type.js.map

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

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

@@ -0,0 +1,10 @@
+export * from './bundle.type.js';
+export * from './locale.type.js';
+export * from './message.type.js';
+export * from './namespace.type.js';
+export * from './release.type.js';
+export * from './render.type.js';
+export * from './translation-status.enum.js';
+export * from './translation.type.js';
+export * from './variable-type.enum.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/api/localization/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC"}

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

@@ -0,0 +1,10 @@
+export * from './bundle.type.js';
+export * from './locale.type.js';
+export * from './message.type.js';
+export * from './namespace.type.js';
+export * from './release.type.js';
+export * from './render.type.js';
+export * from './translation-status.enum.js';
+export * from './translation.type.js';
+export * from './variable-type.enum.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/api/localization/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC"}

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

@@ -0,0 +1,67 @@
+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';
+/**
+ * A language a tenant publishes in.
+ *
+ * **A row, not an enum member.** The obvious alternative — `enum LocaleCode { EN, RU, KA }` — makes
+ * adding Ukrainian a contracts release, an SDK release and a redeploy of every consumer, to add a
+ * value that no code branches on. Nothing in the platform switches on *which* locale a string is
+ * in; it only ever looks one up. So the set belongs in data.
+ *
+ * `code` is a BCP-47 tag and is what every other surface uses: the `Accept-Language` header the
+ * SDK already resolves into `RequestContext.locale`, the export filename, the render request.
+ */
+export interface Locale {
+    id: UUID;
+    /** BCP-47, lowercased — `en`, `ru`, `ka`, `en-GB`. Unique within the tenant. */
+    code: string;
+    /** For the language picker in an English-language admin screen. */
+    englishName: string;
+    /** For the language picker a native speaker sees — `ქართული`, `Русский`. */
+    nativeName: string;
+    /**
+     * The locale translators translate *from*. Exactly one per tenant.
+     *
+     * It is also the locale a message's source text lives in, so editing a source value is what
+     * flips every other locale's translation of that message to `needs-review`. Changing which
+     * locale is the source is therefore not a display preference — it moves that trigger.
+     */
+    isSource: boolean;
+    /**
+     * Whether this locale is offered at all. Inactive keeps the translations and stops them
+     * being exported or rendered, which is what a locale that is half-translated needs — the
+     * alternative is deleting the work to hide it.
+     */
+    isActive: boolean;
+    /**
+     * Where a lookup goes when this locale has no approved translation. Null ends the chain.
+     *
+     * Chains are followed transitively (`en-GB → en → null`) and are **rejected at write time if
+     * they cycle**, because the resolver would otherwise loop on a row a customer can create.
+     */
+    fallbackCode: Nullable<string>;
+    createdAt: IsoDateTime;
+    updatedAt: IsoDateTime;
+}
+/** `GET /api/v1/locales`. Small and unpaged — a tenant has a handful of these, not a page of them. */
+export type LocaleList = Locale[];
+/** `POST /api/v1/locales`. */
+export interface CreateLocaleBody {
+    code: string;
+    englishName: string;
+    nativeName: string;
+    isSource?: boolean;
+    isActive?: boolean;
+    fallbackCode?: Nullable<string>;
+}
+/** `PATCH /api/v1/locales/:code`. */
+export interface UpdateLocaleBody {
+    englishName?: string;
+    nativeName?: string;
+    /** Promoting a locale to source demotes the previous one in the same transaction. */
+    isSource?: boolean;
+    isActive?: boolean;
+    fallbackCode?: Nullable<string>;
+}
+//# sourceMappingURL=locale.type.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"locale.type.d.ts","sourceRoot":"","sources":["../../../../src/api/localization/locale.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;;;;;;;;;;GAUG;AACH,MAAM,WAAW,MAAM;IACnB,EAAE,EAAE,IAAI,CAAC;IAET,gFAAgF;IAChF,IAAI,EAAE,MAAM,CAAC;IAEb,mEAAmE;IACnE,WAAW,EAAE,MAAM,CAAC;IAEpB,4EAA4E;IAC5E,UAAU,EAAE,MAAM,CAAC;IAEnB;;;;;;OAMG;IACH,QAAQ,EAAE,OAAO,CAAC;IAElB;;;;OAIG;IACH,QAAQ,EAAE,OAAO,CAAC;IAElB;;;;;OAKG;IACH,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAE/B,SAAS,EAAE,WAAW,CAAC;IACvB,SAAS,EAAE,WAAW,CAAC;CAC1B;AAED,sGAAsG;AACtG,MAAM,MAAM,UAAU,GAAG,MAAM,EAAE,CAAC;AAElC,8BAA8B;AAC9B,MAAM,WAAW,gBAAgB;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,YAAY,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;CACnC;AAED,qCAAqC;AACrC,MAAM,WAAW,gBAAgB;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qFAAqF;IACrF,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,YAAY,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;CACnC"}

package/dist/esm/api/localization/locale.type.js

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

package/dist/esm/api/localization/locale.type.js.map

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