@insurance-broker/api-client 2.5.0 → 2.6.0

package/dist/schema.d.ts

@@ -34,6 +34,16 @@ export interface paths {
          *     The **payer is not a field** either. An obligation is owed by whoever owns the policy, so a customer identifier here could only ever agree or be wrong (ADR-0042 §3).
          *
          *     A **due date in the past is accepted**: a book carried across from another system arrives already in arrears, and refusing that would make a migrated debt unrepresentable.
+         *
+         *     **`idempotencyKey` is optional, and it is the only thing that makes a retry safe.** Without one, a double-tapped button, a client retry after a timeout or two officers recording the same instalment each raise a separate debt — and that is correct, because two identical instalments falling due on one day is legitimate and nothing about `(policy, amount, due date, description)` can be made unique.
+         *
+         *     With one: a repeat carrying a key already used **returns the original charge and the same `201 Created` with the same `Location`**, so an honest retry is indistinguishable from a first call and no second debt exists. A repeat carrying that key with a **different** policy, amount, due date or description is a `409` and raises nothing.
+         *
+         *     **A key is honoured for as long as the charge it raised is kept, and nothing sweeps keys.** It is stored on the obligation rather than in a store of its own. Mint a fresh key per intended charge; do not recycle one (#394).
+         *
+         *     **What a key does not do**: it assumes the retrying client owns it. Two people at two desks recording the same instalment invent two keys, and both charges are raised (ADR-0042 §19).
+         *
+         *     **Two different things answer `409` here.** A key collision is settled — retrying it can only fail again — and carries no `retryable` marker. The group's concurrency conflict is the other one and says it is retryable. Branch on that, not on the status.
          */
         post: operations["RaiseObligation"];
         delete?: never;
@@ -7184,6 +7194,7 @@ export interface components {
             /** Format: date */
             dueOn: string;
             description: string;
+            idempotencyKey?: null | string;
         };
         RaiseOutstandingItemRequest: {
             awaitedFrom: null | string;
@@ -7854,6 +7865,15 @@ export interface operations {
                     "application/problem+json": components["schemas"]["HttpValidationProblemDetails"];
                 };
             };
+            /** @description Conflict */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["ProblemDetails"];
+                };
+            };
         };
     };
     GetObligation: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@insurance-broker/api-client",
-  "version": "2.5.0",
+  "version": "2.6.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,