@insurance-broker/api-client 5.7.0 → 5.8.0

package/dist/schema.d.ts

@@ -152,6 +152,14 @@ export interface paths {
          *     The **currency is not a field** — it is the policy's own, so BR-008's pair travels from one source. The **payer is not a field** either: an invoice is addressed to whoever owns the policy.
          *
          *     A draft has **no total**. The total is fixed once, at issue, from the lines.
+         *
+         *     A replay answers the invoice **as it is now**, lines and status included: a draft that has since gained lines, been issued or been discarded is still the one invoice the key drafted, so its body can differ from the first response's, `status` included.
+         *
+         *     **`idempotencyKey` is optional, and it is what makes a retry after a lost response safe.** Without one, every request writes a new invoice. With one, a repeat carrying a key already used **answers the original invoice with the same `201 Created` and the same `Location`** and writes nothing; a repeat carrying that key with a **different** policy is a `409` and writes nothing. The key is trimmed, at most 200 characters, blank is no key, and it belongs to this broker alone.
+         *
+         *     **A key is honoured for 30 days from the moment the invoice was written, and then stops being honoured** — after that the same key is one this platform has never seen. Mint a fresh key per intended invoice; do not recycle one.
+         *
+         *     **The key collision `409` is settled**: retrying it can only fail again, and it carries no `retryable` marker.
          */
         post: operations["DraftInvoice"];
         delete?: never;
@@ -236,6 +244,12 @@ export interface paths {
          *     **It may not credit more than the invoice demanded**, counting what earlier credit notes already credit. Crediting past the demand is a payment out rather than a correction, and a refund is its own record (WRK-004, Phase 2).
          *
          *     Refused against a **draft** invoice: a draft was never demanded of anybody, so it is discarded rather than credited.
+         *
+         *     **A retried credit note without a key credits the customer twice**, so send one. **`idempotencyKey` is optional, and it is what makes a retry after a lost response safe.** Without one, every request writes a new credit note. With one, a repeat carrying a key already used **answers the original credit note with the same `201 Created` and the same `Location`** and writes nothing; a repeat carrying that key with a **different** invoice, reason or set of lines is a `409` and writes nothing. The key is trimmed, at most 200 characters, blank is no key, and it belongs to this broker alone.
+         *
+         *     **A key is honoured for 30 days from the moment the credit note was written, and then stops being honoured** — after that the same key is one this platform has never seen. Mint a fresh key per intended credit note; do not recycle one.
+         *
+         *     **The key collision `409` is settled**: retrying it can only fail again, and it carries no `retryable` marker.
          */
         post: operations["IssueCreditNote"];
         delete?: never;
@@ -562,6 +576,12 @@ export interface paths {
          *     **One currency per statement.** A charge carries its own currency, and a balance in two of them is not a number. A customer owing in two currencies gets two statements.
          *
          *     **Nothing about money is stored on the row.** There is no balance column: every figure is derived from the obligations and payments the statement renders, bounded by its period and by the instant it was produced.
+         *
+         *     **`idempotencyKey` is optional, and it is what makes a retry after a lost response safe.** Without one, every request produces a statement. With one, a repeat carrying a key already used **answers the original statement with the same `201 Created` and the same `Location`** and produces nothing; a repeat carrying that key with a **different** customer, currency or period is a `409` and produces nothing. The key is trimmed, at most 200 characters, blank is no key, and it belongs to this broker alone.
+         *
+         *     **A key is honoured for 30 days from the moment the statement was produced, and then stops being honoured** — after that the same key is one this platform has never seen. Mint a fresh key per intended statement; do not recycle one.
+         *
+         *     **The key collision `409` is settled**: retrying it can only fail again, and it carries no `retryable` marker.
          */
         post: operations["ProduceStatement"];
         delete?: never;
@@ -7219,6 +7239,7 @@ export interface components {
         DraftInvoiceRequest: {
             /** Format: uuid */
             policyId: string;
+            idempotencyKey?: null | string;
         };
         EmergencyContactDetailsResponse: {
             providerName: string;
@@ -7820,6 +7841,7 @@ export interface components {
         IssueCreditNoteRequest: {
             reason: string;
             lines: components["schemas"]["CreditNoteLineRequest"][];
+            idempotencyKey?: null | string;
         };
         IssuedCustomerInvitationResponse: {
             /** Format: uuid */
@@ -8608,6 +8630,7 @@ export interface components {
             periodStart: string;
             /** Format: date */
             periodEnd: string;
+            idempotencyKey?: null | string;
         };
         ProductCategoryResponse: {
             /** Format: uuid */
@@ -10133,6 +10156,15 @@ export interface operations {
                     "application/problem+json": components["schemas"]["HttpValidationProblemDetails"];
                 };
             };
+            /** @description Conflict. A type of urn:brokerplatform:problem:concurrency-conflict means someone else changed the record first and nothing was written: read it again and decide again. Any other type is a conflict this operation decided itself, and retrying it unchanged will not help. */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ConcurrencyConflictProblem"] | components["schemas"]["ProblemDetails"];
+                };
+            };
         };
     };
     AddInvoiceLine: {
@@ -10844,6 +10876,15 @@ export interface operations {
                     "application/problem+json": components["schemas"]["HttpValidationProblemDetails"];
                 };
             };
+            /** @description Conflict. A type of urn:brokerplatform:problem:concurrency-conflict means someone else changed the record first and nothing was written: read it again and decide again. Any other type is a conflict this operation decided itself, and retrying it unchanged will not help. */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ConcurrencyConflictProblem"] | components["schemas"]["ProblemDetails"];
+                };
+            };
             /** @description Too Many Requests (ADR-0050). This operation renders, produces or exports, and the caller's own budget for such work, or their organisation's, is spent. Nothing was done: no document, statement, export or receipt exists for this request. Wait the number of seconds in Retry-After (also in retryAfterSeconds) before trying again. */
             429: {
                 headers: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@insurance-broker/api-client",
-  "version": "5.7.0",
+  "version": "5.8.0",
   "description": "Generated TypeScript client for the Insurance Broker Platform API. Do not edit by hand: regenerate with scripts/update-api-contract.",
   "license": "UNLICENSED",
   "private": false,