@insurance-broker/api-client 2.4.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;
@@ -2227,6 +2237,32 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/v1/customer/emergency-contacts": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Who to call in an emergency, and what to do first
+         * @description CLM-003, the customer's half. What your broker wants you to do if something happens, in the order they want you to do it.
+         *
+         *     **This is the answer and not the configuration.** Each entry is the contact that applies to you. It does not say whether your broker chose it or the platform did, because that is not a question anybody needs answered at the scene of an incident.
+         *
+         *     **You are not named in the request, and neither is your broker.** There is no country field and no product field: the list is your own broker's, for the country they operate in, resolved from the session you are signed in with.
+         *
+         *     Calling an emergency service is not reporting a claim. When you are safe, report the loss to your broker separately.
+         */
+        get: operations["ReadOwnBrokersEmergencyContacts"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/v1/leads": {
         parameters: {
             query?: never;
@@ -5624,6 +5660,15 @@ export interface components {
             state: string;
             value: null | string;
         };
+        CustomerEmergencyContactResponse: {
+            countryCode: string;
+            contact: string;
+            name: string;
+            description: null | string;
+            providerName: string;
+            contactDetail: string;
+            instruction: string;
+        };
         CustomerInsurerOutcomeResponse: {
             /** Format: uuid */
             id: string;
@@ -7149,6 +7194,7 @@ export interface components {
             /** Format: date */
             dueOn: string;
             description: string;
+            idempotencyKey?: null | string;
         };
         RaiseOutstandingItemRequest: {
             awaitedFrom: null | string;
@@ -7819,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: {
@@ -12588,6 +12643,26 @@ export interface operations {
             };
         };
     };
+    ReadOwnBrokersEmergencyContacts: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["CustomerEmergencyContactResponse"][];
+                };
+            };
+        };
+    };
     ListLeads: {
         parameters: {
             query?: {

package/package.json

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