@medalsocial/sdk 1.5.0 → 1.6.0

package/dist/src/openapi.generated.d.mts

@@ -610,6 +610,26 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/v1/capability-confirmations": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Issue a capability confirmation token
+         * @description Mints a short-lived `X-Capability-Confirmation` token for one pending write. Confirmable write routes require BOTH `Idempotency-Key` and `X-Capability-Confirmation` when the credential holds the capability scope directly; API keys with legacy scopes are exempt. The token is bound to the workspace, auth subject, method, path, required scopes and idempotency key, and expires within 15 minutes. `user_approved: true` asserts that a human on the caller's side approved this exact action.
+         */
+        post: operations["issueCapabilityConfirmation"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/v1/channels/connect-links": {
         parameters: {
             query?: never;
@@ -619,7 +639,7 @@ interface paths {
         };
         /**
          * List connect links
-         * @description Link tokens are never returned.
+         * @description Link tokens are never returned. Newest first, cursor-paginated. The `channel_type` / `status` filters are applied within each page, so a page may hold fewer than `limit` items while `pagination.has_more` is still true — page off `has_more`, not the item count.
          */
         get: operations["listChannelConnectLinks"];
         put?: never;
@@ -663,7 +683,10 @@ interface paths {
             path?: never;
             cookie?: never;
         };
-        /** List channel connections */
+        /**
+         * List channel connections
+         * @description The workspace's channel connections in a generic, channel-agnostic shape. Newest first, cursor-paginated. Rows that are not projectable as connections are dropped within the page, so a page may hold fewer than `limit` items while `pagination.has_more` is still true — page off `has_more`, not the item count.
+         */
         get: operations["listChannelConnections"];
         put?: never;
         post?: never;
@@ -695,6 +718,62 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/v1/scan": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Queue a company/site scan
+         * @description Queues an asynchronous scan. Provide exactly one of `url`, `orgnr`, or `name`; poll the returned id via `GET /api/v1/scan/{id}`.
+         */
+        post: operations["createScan"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/scan/companies": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Search the Norwegian company registry */
+        get: operations["searchScanCompanies"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/scan/{id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: components["parameters"]["Id"];
+            };
+            cookie?: never;
+        };
+        /** Get a scan job */
+        get: operations["getScan"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
 }
 type webhooks = Record<string, never>;
 interface components {
@@ -1212,9 +1291,15 @@ interface components {
             author_user_id: string | null;
             author_name: string | null;
             body: string;
+            /** @description Outbound delivery state, or `null` for inbound messages and internal notes. A `201` from `POST /api/v1/helpdesk/replies` means the reply was accepted, NOT delivered — the channel hand-off is asynchronous, so poll this field (or subscribe to `helpdesk.message_delivery_updated`) to learn the outcome. */
+            delivery_status: components["schemas"]["HelpdeskMessageDeliveryStatus"] | null;
+            /** @description Last send error for a `failed` outbound message, otherwise `null`. */
+            delivery_error: string | null;
             /** @description Unix timestamp in milliseconds. */
             created_at: number;
         };
+        /** @enum {string} */
+        HelpdeskMessageDeliveryStatus: "pending" | "sent" | "delivered" | "failed";
         /** @description At least one field is required. */
         UpdateHelpdeskConversationInput: {
             status?: components["schemas"]["HelpdeskConversationStatus"];
@@ -1306,9 +1391,17 @@ interface components {
             /** @constant */
             status: "deleted";
         };
+        /** @description A delivery attempt record. `id` is the same value sent as the `X-Medal-Delivery-Id` and `Idempotency-Key` headers on the outbound request. Deliveries never carry payload bodies (payloads can contain customer PII). The correlation fields are derived from the stored event and fail closed to `null` when no canonical event exists — e.g. `test.ping` deliveries or events that have aged out of retention. */
         WebhookDelivery: {
             id: string;
             event_type: string;
+            /** @description Primary subject id of the announced event, or `null`. */
+            resource_id: string | null;
+            conversation_id: string | null;
+            message_id: string | null;
+            connection_ref: string | null;
+            channel: string | null;
+            channel_connection_id: string | null;
             /** @enum {string} */
             status: "pending" | "delivered" | "dead_letter";
             attempt_count: number;
@@ -1413,6 +1506,9 @@ interface components {
         ApiResponse_GdprExportRequest: components["schemas"]["Envelope_GdprExportRequest"];
         ApiResponse_GdprExportArray: components["schemas"]["Envelope_GdprExportArray"];
         ApiResponse_GdprExport: components["schemas"]["Envelope_GdprExport"];
+        ApiResponse_ScanCreateResult: components["schemas"]["Envelope_ScanCreateResult"];
+        ApiResponse_ScanCompanyArray: components["schemas"]["Envelope_ScanCompanyArray"];
+        ApiResponse_ScanJob: components["schemas"]["Envelope_ScanJob"];
         ApiResponse_ConsentResult: components["schemas"]["Envelope_ConsentResult"];
         ApiResponse_ConsentRecordArray: components["schemas"]["Envelope_ConsentRecordArray"];
         ApiResponse_WorkspaceArray: components["schemas"]["Envelope_WorkspaceArray"];
@@ -1453,6 +1549,14 @@ interface components {
             data: components["schemas"]["HelpdeskMessage"][];
             pagination: components["schemas"]["Pagination"];
         };
+        PaginatedResponse_ConnectLink: {
+            data: components["schemas"]["ConnectLink"][];
+            pagination: components["schemas"]["Pagination"];
+        };
+        PaginatedResponse_ChannelConnection: {
+            data: components["schemas"]["ChannelConnection"][];
+            pagination: components["schemas"]["Pagination"];
+        };
         Envelope_PostCreateResult: {
             data: components["schemas"]["PostCreateResult"];
         };
@@ -1516,6 +1620,67 @@ interface components {
         Envelope_DealRemoveResult: {
             data: components["schemas"]["DealRemoveResult"];
         };
+        /** @description Provide exactly one of `url`, `orgnr`, or `name`. */
+        ScanCreateInput: {
+            url?: string;
+            orgnr?: string;
+            name?: string;
+        } & (unknown | unknown | unknown);
+        ScanCreateResult: {
+            id: string;
+            status: string;
+            message?: string;
+        };
+        ScanCompany: {
+            orgnr: string;
+            name: string;
+            org_form: string | null;
+            industry: string | null;
+            city: string | null;
+            website: string | null;
+        };
+        ScanJob: {
+            id: string;
+            /** @description pending | running | done | failed */
+            status: string;
+            input: components["schemas"]["ScanCreateInput"];
+            resolved: {
+                orgnr?: string;
+                companyName?: string;
+                websiteUrl?: string;
+            } | null;
+            /** @description Versioned findings payload (see the SDK `ScanResultPayload` type); additive per `version`. The stable core is documented below; further sections (registry, signals, pagespeed, seo, ai, gdpr, mailAuth, httpsOk) evolve additively. */
+            result: ({
+                version: number;
+                /** @description Weighted composite score (0-100); null when unmeasurable. */
+                nettskaar: number | null;
+                /** @description Per-axis 0-100 scores; null axes were unmeasurable. */
+                subScores: {
+                    fart: number | null;
+                    google: number | null;
+                    ai: number | null;
+                    trygghet: number | null;
+                    omdomme: number | null;
+                };
+            } & {
+                [key: string]: unknown;
+            }) | null;
+            /** @description Public-safe failure code (company_not_found, no_website, …). */
+            error: string | null;
+            /** Format: date-time */
+            created_at: string | null;
+            /** Format: date-time */
+            finished_at: string | null;
+        };
+        Envelope_ScanCreateResult: {
+            data: components["schemas"]["ScanCreateResult"];
+        };
+        Envelope_ScanCompanyArray: {
+            data: components["schemas"]["ScanCompany"][];
+        };
+        Envelope_ScanJob: {
+            data: components["schemas"]["ScanJob"];
+        };
         Envelope_GdprExportRequest: {
             data: components["schemas"]["GdprExportRequest"];
         };
@@ -1552,6 +1717,44 @@ interface components {
         Envelope_WebhookDeleteResult: {
             data: components["schemas"]["WebhookDeleteResult"];
         };
+        IssueCapabilityConfirmationInput: {
+            /** @description Confirmable capability to mint a token for. */
+            capability_id: string;
+            /** @description Concrete `/api/v1/...` path to bind the token to. Optional when the capability has exactly one API target; required when it has several. */
+            api_path?: string;
+            /** @description Values for the capability path template's parameters. */
+            path_params?: {
+                [key: string]: string | number | boolean;
+            };
+            /** @description The exact `Idempotency-Key` the confirmed write will send. The token is bound to it. */
+            idempotency_key?: string;
+            /** @description Human-readable description of the approved action, retained for audit. */
+            preview_summary: string;
+            /**
+             * @description Asserts that a human on the caller's side approved this specific action.
+             * @constant
+             */
+            user_approved: true;
+        };
+        CapabilityConfirmation: {
+            /** @description Send as the `X-Capability-Confirmation` header on the write. */
+            confirmation_token: string;
+            /** @constant */
+            token_type: "medal_capability_confirmation";
+            capability_id: string;
+            method: string;
+            path: string;
+            required_scopes: string[];
+            idempotency_key: string | null;
+            expires_in: number;
+            /** Format: date-time */
+            expires_at: string;
+            preview_summary: string;
+        };
+        ApiResponse_CapabilityConfirmation: components["schemas"]["Envelope_CapabilityConfirmation"];
+        Envelope_CapabilityConfirmation: {
+            data: components["schemas"]["CapabilityConfirmation"];
+        };
         Envelope_WebhookDeliveryArray: {
             data: components["schemas"]["WebhookDelivery"][];
         };
@@ -1561,12 +1764,20 @@ interface components {
         Envelope_ConnectLinkCreateResult: {
             data: components["schemas"]["ConnectLinkCreateResult"];
         };
+        /**
+         * @deprecated
+         * @description Deprecated — `listChannelConnectLinks` responds with `PaginatedResponse_ConnectLink`. Retained for backwards compatibility with consumers of the generated contract types.
+         */
         Envelope_ConnectLinkArray: {
             data: components["schemas"]["ConnectLink"][];
         };
         Envelope_ConnectLinkRevokeResult: {
             data: components["schemas"]["ConnectLinkRevokeResult"];
         };
+        /**
+         * @deprecated
+         * @description Deprecated — `listChannelConnections` responds with `PaginatedResponse_ChannelConnection`. Retained for backwards compatibility with consumers of the generated contract types.
+         */
         Envelope_ChannelConnectionArray: {
             data: components["schemas"]["ChannelConnection"][];
         };
@@ -2712,9 +2923,37 @@ interface operations {
             default: components["responses"]["ApiError"];
         };
     };
+    issueCapabilityConfirmation: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["IssueCapabilityConfirmationInput"];
+            };
+        };
+        responses: {
+            /** @description Minted confirmation token. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ApiResponse_CapabilityConfirmation"];
+                };
+            };
+            default: components["responses"]["ApiError"];
+        };
+    };
     listChannelConnectLinks: {
         parameters: {
             query?: {
+                /** @description Page size (default 50, capped at 100). */
+                limit?: number;
+                cursor?: components["parameters"]["Cursor"];
                 channel_type?: string;
                 status?: components["schemas"]["ConnectLinkStatus"];
             };
@@ -2724,13 +2963,13 @@ interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description The workspace's connect links. */
+            /** @description Connect links page. */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ApiResponse_ConnectLinkArray"];
+                    "application/json": components["schemas"]["PaginatedResponse_ConnectLink"];
                 };
             };
             default: components["responses"]["ApiError"];
@@ -2786,20 +3025,24 @@ interface operations {
     };
     listChannelConnections: {
         parameters: {
-            query?: never;
+            query?: {
+                /** @description Page size (default 50, capped at 100). */
+                limit?: number;
+                cursor?: components["parameters"]["Cursor"];
+            };
             header?: never;
             path?: never;
             cookie?: never;
         };
         requestBody?: never;
         responses: {
-            /** @description The workspace's channel connections (generic shape). */
+            /** @description Channel connections page. */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ApiResponse_ChannelConnectionArray"];
+                    "application/json": components["schemas"]["PaginatedResponse_ChannelConnection"];
                 };
             };
             default: components["responses"]["ApiError"];
@@ -2828,6 +3071,77 @@ interface operations {
             default: components["responses"]["ApiError"];
         };
     };
+    createScan: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["ScanCreateInput"];
+            };
+        };
+        responses: {
+            /** @description Scan job queued. */
+            202: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ApiResponse_ScanCreateResult"];
+                };
+            };
+            default: components["responses"]["ApiError"];
+        };
+    };
+    searchScanCompanies: {
+        parameters: {
+            query: {
+                q: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Registry matches (top 5, relevance-ranked). */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ApiResponse_ScanCompanyArray"];
+                };
+            };
+            default: components["responses"]["ApiError"];
+        };
+    };
+    getScan: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: components["parameters"]["Id"];
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Scan job status and, once done, the findings payload. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ApiResponse_ScanJob"];
+                };
+            };
+            default: components["responses"]["ApiError"];
+        };
+    };
 }
 
 export type { $defs, components, operations, paths, webhooks };