@complyforce/api 1.10.8 → 1.11.0-24043

package/cjs/sdk.gen.js

@@ -30,6 +30,22 @@ class ComplyforceApi extends HeyApiClient {
         super(args);
         ComplyforceApi.__registry.set(this, args === null || args === void 0 ? void 0 : args.key);
     }
+    /**
+     * Cancel order
+     *
+     * Gracefully cancels an in-flight order before it reaches a final status.
+     *
+     * Authentication accepts **one of**: vendor API key, vendor-dashboard JWT (Bearer), or `x-authentication-super-admin`.
+     * A single `orderCancelAuth` guard implements this OR semantics — do not register multiple guards, as the controller requires every guard to succeed.
+     * The processor stops pending work, lets in-flight URL scans finish, and emits a final `canceled` status.
+     *
+     * Returns `204` when the cancel request is accepted, including when the order is already `canceled` (idempotent).
+     * Returns `422` when the order has already reached a non-cancelable final status (`completed`, `completedPartially`, or `error`).
+     */
+    postOrderCancel(options) {
+        var _a;
+        return ((_a = options.client) !== null && _a !== void 0 ? _a : this.client).post(Object.assign(Object.assign({ security: [{ name: 'x-authentication-super-admin', type: 'apiKey' }], url: '/order/cancel' }, options), { headers: Object.assign({ 'Content-Type': 'application/json' }, options.headers) }));
+    }
     /**
      * Get order
      *
@@ -44,6 +60,10 @@ class ComplyforceApi extends HeyApiClient {
      *
      * Accepting an order for a website scan with one, several, all, or the most relevant subpages.
      *
+     * Authentication accepts **one of**: vendor API key or vendor-dashboard JWT (Bearer).
+     * A single `orderCreateAuth` guard implements this OR semantics — do not register multiple guards, as the controller requires every guard to succeed.
+     * The vendor API key remains the primary integration path for external integrators.
+     *
      * #### Scan types (with examples)
      * <details>
      * <summary>Single page scan</summary>
@@ -75,9 +95,8 @@ class ComplyforceApi extends HeyApiClient {
      * "orderPreparationUrlsEnrichment"
      * ],
      * "scanDomain": "shop.example.com",
-     * "scanUrlsRequested": [
-     * "https://shop.example.com/login"
-     * ],
+     * "scanUrlsRequestedCount": 1,
+     * "scanUrlsFailedCount": 0,
      * "scanPriority": 50,
      * "status": "created",
      * "createdAt": "2025-01-01T12:00:00.000Z",
@@ -127,10 +146,8 @@ class ComplyforceApi extends HeyApiClient {
      * "orderPreparationUrlsEnrichment"
      * ],
      * "scanDomain": "shop.example.com",
-     * "scanUrlsRequested": [
-     * "https://shop.example.com/login",
-     * "https://shop.example.com/checkout"
-     * ],
+     * "scanUrlsRequestedCount": 2,
+     * "scanUrlsFailedCount": 0,
      * "scanPriority": 50,
      * "status": "created",
      * "createdAt": "2025-01-01T12:01:00.000Z",
@@ -178,7 +195,8 @@ class ComplyforceApi extends HeyApiClient {
      * "orderPreparationUrlsEnrichment"
      * ],
      * "scanDomain": "newsroom.example.com",
-     * "scanUrlsRequested": [],
+     * "scanUrlsRequestedCount": 1,
+     * "scanUrlsFailedCount": 0,
      * "scanPriority": 50,
      * "status": "created",
      * "createdAt": "2025-01-01T12:02:00.000Z",
@@ -231,7 +249,8 @@ class ComplyforceApi extends HeyApiClient {
      * "orderPreparationUrlsEnrichment"
      * ],
      * "scanDomain": "careers.example.com",
-     * "scanUrlsRequested": [],
+     * "scanUrlsRequestedCount": 1,
+     * "scanUrlsFailedCount": 0,
      * "scanUrlsLimit": 1000,
      * "scanPriority": 50,
      * "status": "created",
@@ -252,7 +271,7 @@ class ComplyforceApi extends HeyApiClient {
      */
     postOrder(options) {
         var _a;
-        return ((_a = options.client) !== null && _a !== void 0 ? _a : this.client).post(Object.assign(Object.assign({ security: [{ name: 'x-api-key', type: 'apiKey' }, { name: 'x-api-key', type: 'apiKey' }], url: '/order' }, options), { headers: Object.assign({ 'Content-Type': 'application/json' }, options.headers) }));
+        return ((_a = options.client) !== null && _a !== void 0 ? _a : this.client).post(Object.assign(Object.assign({ security: [{ name: 'authorization', type: 'apiKey' }], url: '/order' }, options), { headers: Object.assign({ 'Content-Type': 'application/json' }, options.headers) }));
     }
     /**
      * Get order progress
@@ -279,6 +298,20 @@ class ComplyforceApi extends HeyApiClient {
         var _a;
         return ((_a = options.client) !== null && _a !== void 0 ? _a : this.client).get(Object.assign({ security: [{ name: 'x-api-key', type: 'apiKey' }], url: '/order/report' }, options));
     }
+    /**
+     * Get scan artefact URLs for an order
+     *
+     * Looks up signed S3 download URLs for crawler scan artefacts (before/after consent captures and traces) for a single order.
+     *
+     * Artefacts are only mirrored when the order was created with `traceEnabled`. Absent or expired mirrors yield an empty `artefacts` map.
+     * Signed URLs expire with the S3 object lifetime; callers must treat them as short-lived download links, not permanent storage references.
+     *
+     * Authentication requires a vendor-dashboard JWT (Bearer). When the caller may not read the order, the response is `200` with an empty `artefacts` map (no existence leak).
+     */
+    getOrderOrderUuidScanArtefacts(options) {
+        var _a;
+        return ((_a = options.client) !== null && _a !== void 0 ? _a : this.client).get(Object.assign({ security: [{ name: 'authorization', type: 'apiKey' }], url: '/order/:orderUuid/scan-artefacts' }, options));
+    }
     /**
      * Get orders overview
      *

package/esm/sdk.gen.js

@@ -27,6 +27,22 @@ export class ComplyforceApi extends HeyApiClient {
         super(args);
         ComplyforceApi.__registry.set(this, args === null || args === void 0 ? void 0 : args.key);
     }
+    /**
+     * Cancel order
+     *
+     * Gracefully cancels an in-flight order before it reaches a final status.
+     *
+     * Authentication accepts **one of**: vendor API key, vendor-dashboard JWT (Bearer), or `x-authentication-super-admin`.
+     * A single `orderCancelAuth` guard implements this OR semantics — do not register multiple guards, as the controller requires every guard to succeed.
+     * The processor stops pending work, lets in-flight URL scans finish, and emits a final `canceled` status.
+     *
+     * Returns `204` when the cancel request is accepted, including when the order is already `canceled` (idempotent).
+     * Returns `422` when the order has already reached a non-cancelable final status (`completed`, `completedPartially`, or `error`).
+     */
+    postOrderCancel(options) {
+        var _a;
+        return ((_a = options.client) !== null && _a !== void 0 ? _a : this.client).post(Object.assign(Object.assign({ security: [{ name: 'x-authentication-super-admin', type: 'apiKey' }], url: '/order/cancel' }, options), { headers: Object.assign({ 'Content-Type': 'application/json' }, options.headers) }));
+    }
     /**
      * Get order
      *
@@ -41,6 +57,10 @@ export class ComplyforceApi extends HeyApiClient {
      *
      * Accepting an order for a website scan with one, several, all, or the most relevant subpages.
      *
+     * Authentication accepts **one of**: vendor API key or vendor-dashboard JWT (Bearer).
+     * A single `orderCreateAuth` guard implements this OR semantics — do not register multiple guards, as the controller requires every guard to succeed.
+     * The vendor API key remains the primary integration path for external integrators.
+     *
      * #### Scan types (with examples)
      * <details>
      * <summary>Single page scan</summary>
@@ -72,9 +92,8 @@ export class ComplyforceApi extends HeyApiClient {
      * "orderPreparationUrlsEnrichment"
      * ],
      * "scanDomain": "shop.example.com",
-     * "scanUrlsRequested": [
-     * "https://shop.example.com/login"
-     * ],
+     * "scanUrlsRequestedCount": 1,
+     * "scanUrlsFailedCount": 0,
      * "scanPriority": 50,
      * "status": "created",
      * "createdAt": "2025-01-01T12:00:00.000Z",
@@ -124,10 +143,8 @@ export class ComplyforceApi extends HeyApiClient {
      * "orderPreparationUrlsEnrichment"
      * ],
      * "scanDomain": "shop.example.com",
-     * "scanUrlsRequested": [
-     * "https://shop.example.com/login",
-     * "https://shop.example.com/checkout"
-     * ],
+     * "scanUrlsRequestedCount": 2,
+     * "scanUrlsFailedCount": 0,
      * "scanPriority": 50,
      * "status": "created",
      * "createdAt": "2025-01-01T12:01:00.000Z",
@@ -175,7 +192,8 @@ export class ComplyforceApi extends HeyApiClient {
      * "orderPreparationUrlsEnrichment"
      * ],
      * "scanDomain": "newsroom.example.com",
-     * "scanUrlsRequested": [],
+     * "scanUrlsRequestedCount": 1,
+     * "scanUrlsFailedCount": 0,
      * "scanPriority": 50,
      * "status": "created",
      * "createdAt": "2025-01-01T12:02:00.000Z",
@@ -228,7 +246,8 @@ export class ComplyforceApi extends HeyApiClient {
      * "orderPreparationUrlsEnrichment"
      * ],
      * "scanDomain": "careers.example.com",
-     * "scanUrlsRequested": [],
+     * "scanUrlsRequestedCount": 1,
+     * "scanUrlsFailedCount": 0,
      * "scanUrlsLimit": 1000,
      * "scanPriority": 50,
      * "status": "created",
@@ -249,7 +268,7 @@ export class ComplyforceApi extends HeyApiClient {
      */
     postOrder(options) {
         var _a;
-        return ((_a = options.client) !== null && _a !== void 0 ? _a : this.client).post(Object.assign(Object.assign({ security: [{ name: 'x-api-key', type: 'apiKey' }, { name: 'x-api-key', type: 'apiKey' }], url: '/order' }, options), { headers: Object.assign({ 'Content-Type': 'application/json' }, options.headers) }));
+        return ((_a = options.client) !== null && _a !== void 0 ? _a : this.client).post(Object.assign(Object.assign({ security: [{ name: 'authorization', type: 'apiKey' }], url: '/order' }, options), { headers: Object.assign({ 'Content-Type': 'application/json' }, options.headers) }));
     }
     /**
      * Get order progress
@@ -276,6 +295,20 @@ export class ComplyforceApi extends HeyApiClient {
         var _a;
         return ((_a = options.client) !== null && _a !== void 0 ? _a : this.client).get(Object.assign({ security: [{ name: 'x-api-key', type: 'apiKey' }], url: '/order/report' }, options));
     }
+    /**
+     * Get scan artefact URLs for an order
+     *
+     * Looks up signed S3 download URLs for crawler scan artefacts (before/after consent captures and traces) for a single order.
+     *
+     * Artefacts are only mirrored when the order was created with `traceEnabled`. Absent or expired mirrors yield an empty `artefacts` map.
+     * Signed URLs expire with the S3 object lifetime; callers must treat them as short-lived download links, not permanent storage references.
+     *
+     * Authentication requires a vendor-dashboard JWT (Bearer). When the caller may not read the order, the response is `200` with an empty `artefacts` map (no existence leak).
+     */
+    getOrderOrderUuidScanArtefacts(options) {
+        var _a;
+        return ((_a = options.client) !== null && _a !== void 0 ? _a : this.client).get(Object.assign({ security: [{ name: 'authorization', type: 'apiKey' }], url: '/order/:orderUuid/scan-artefacts' }, options));
+    }
     /**
      * Get orders overview
      *

package/package.json

@@ -1,26 +1,30 @@
 {
-    "name": "@complyforce/api",
-    "version": "1.10.8",
-    "description": "TypeScript client for the Complyforce API",
-    "digestMd5": "dc7435b7fb716f5d75f903fa1fa814e0",
-    "type": "module",
-    "main": "cjs/index.cjs.js",
-    "module": "esm/index.js",
-    "types": "types/index.d.ts",
-    "exports": {
-        "types": "./types/index.d.ts",
-        "default": {
-            "import": "./esm/index.js",
-            "require": "./cjs/index.js"
-        }
-    },
-    "author": "devowl.io GmbH <support@devowl.io> (https://devowl.io)",
-    "license": "MIT",
-    "homepage": "https://complyforce.com",
-    "devDependencies": {
-        "@types/node": "^22.10.2",
-        "typescript": "^5.7.2",
-        "undici-types": "^7.2.0"
-    },
-    "files": ["cjs", "esm", "types"]
+  "name": "@complyforce/api",
+  "version": "1.11.0-24043",
+  "description": "TypeScript client for the Complyforce API",
+  "digestMd5": "d76450af7f92f83236477855a34e2540",
+  "type": "module",
+  "main": "cjs/index.cjs.js",
+  "module": "esm/index.js",
+  "types": "types/index.d.ts",
+  "exports": {
+    "types": "./types/index.d.ts",
+    "default": {
+      "import": "./esm/index.js",
+      "require": "./cjs/index.js"
+    }
+  },
+  "author": "devowl.io GmbH <support@devowl.io> (https://devowl.io)",
+  "license": "MIT",
+  "homepage": "https://complyforce.com",
+  "devDependencies": {
+    "@types/node": "^22.10.2",
+    "typescript": "^5.7.2",
+    "undici-types": "^7.2.0"
+  },
+  "files": [
+    "cjs",
+    "esm",
+    "types"
+  ]
 }

package/types/index.d.ts

@@ -1,4 +1,4 @@
 export { ComplyforceApi, type Options } from './sdk.gen.js';
-export type { ClientOptions, CursorPaginationResponseMetadata, DeleteOrderReportData, DeleteOrderReportError, DeleteOrderReportErrors, DeleteOrderReportResponse, DeleteOrderReportResponses, GetOrderData, GetOrderError, GetOrderErrors, GetOrderProgressData, GetOrderProgressError, GetOrderProgressErrors, GetOrderProgressResponse, GetOrderProgressResponses, GetOrderReportData, GetOrderReportError, GetOrderReportErrors, GetOrderReportResponse, GetOrderReportResponses, GetOrderResponse, GetOrderResponses, GetOrdersData, GetOrdersError, GetOrdersErrors, GetOrdersResponse, GetOrdersResponses, GetVendorApiKeyValidateData, GetVendorApiKeyValidateError, GetVendorApiKeyValidateErrors, GetVendorApiKeyValidateResponse, GetVendorApiKeyValidateResponses, OrderCreate, OrderGetResponse, OrderListItem, OrderPosted, OrderProgressResponse, OrderReportDeleteRequest, OrderReportGetResponse, PostOrderData, PostOrderError, PostOrderErrors, PostOrderResponse, PostOrderResponses } from './types.gen.js';
+export type { ClientOptions, CursorPaginationResponseMetadata, DeleteOrderReportData, DeleteOrderReportError, DeleteOrderReportErrors, DeleteOrderReportResponse, DeleteOrderReportResponses, GetOrderData, GetOrderError, GetOrderErrors, GetOrderOrderUuidScanArtefactsData, GetOrderOrderUuidScanArtefactsError, GetOrderOrderUuidScanArtefactsErrors, GetOrderOrderUuidScanArtefactsResponse, GetOrderOrderUuidScanArtefactsResponses, GetOrderProgressData, GetOrderProgressError, GetOrderProgressErrors, GetOrderProgressResponse, GetOrderProgressResponses, GetOrderReportData, GetOrderReportError, GetOrderReportErrors, GetOrderReportResponse, GetOrderReportResponses, GetOrderResponse, GetOrderResponses, GetOrdersData, GetOrdersError, GetOrdersErrors, GetOrdersResponse, GetOrdersResponses, GetVendorApiKeyValidateData, GetVendorApiKeyValidateError, GetVendorApiKeyValidateErrors, GetVendorApiKeyValidateResponse, GetVendorApiKeyValidateResponses, OrderCancelRequest, OrderCreate, OrderGetResponse, OrderListItem, OrderPosted, OrderProgressResponse, OrderReportDeleteRequest, OrderReportGetResponse, OrderScanArtefactsGot, PostOrderCancelData, PostOrderCancelError, PostOrderCancelErrors, PostOrderCancelResponse, PostOrderCancelResponses, PostOrderData, PostOrderError, PostOrderErrors, PostOrderResponse, PostOrderResponses, ScanUrlResult, ScanUrlResults } from './types.gen.js';
 export { createClient, createConfig } from "./client/index.js";
 export { client } from "./client.gen.js";

package/types/sdk.gen.d.ts

@@ -1,5 +1,5 @@
 import type { Client, Options as Options2, TDataShape } from './client/index.js';
-import type { DeleteOrderReportData, DeleteOrderReportErrors, DeleteOrderReportResponses, GetOrderData, GetOrderErrors, GetOrderProgressData, GetOrderProgressErrors, GetOrderProgressResponses, GetOrderReportData, GetOrderReportErrors, GetOrderReportResponses, GetOrderResponses, GetOrdersData, GetOrdersErrors, GetOrdersResponses, GetVendorApiKeyValidateData, GetVendorApiKeyValidateErrors, GetVendorApiKeyValidateResponses, PostOrderData, PostOrderErrors, PostOrderResponses } from './types.gen.js';
+import type { DeleteOrderReportData, DeleteOrderReportErrors, DeleteOrderReportResponses, GetOrderData, GetOrderErrors, GetOrderOrderUuidScanArtefactsData, GetOrderOrderUuidScanArtefactsErrors, GetOrderOrderUuidScanArtefactsResponses, GetOrderProgressData, GetOrderProgressErrors, GetOrderProgressResponses, GetOrderReportData, GetOrderReportErrors, GetOrderReportResponses, GetOrderResponses, GetOrdersData, GetOrdersErrors, GetOrdersResponses, GetVendorApiKeyValidateData, GetVendorApiKeyValidateErrors, GetVendorApiKeyValidateResponses, PostOrderCancelData, PostOrderCancelErrors, PostOrderCancelResponses, PostOrderData, PostOrderErrors, PostOrderResponses } from './types.gen.js';
 export type Options<TData extends TDataShape = TDataShape, ThrowOnError extends boolean = boolean> = Options2<TData, ThrowOnError> & {
     /**
      * You can provide a client instance returned by `createClient()` instead of
@@ -31,6 +31,19 @@ export declare class ComplyforceApi extends HeyApiClient {
         client?: Client;
         key?: string;
     });
+    /**
+     * Cancel order
+     *
+     * Gracefully cancels an in-flight order before it reaches a final status.
+     *
+     * Authentication accepts **one of**: vendor API key, vendor-dashboard JWT (Bearer), or `x-authentication-super-admin`.
+     * A single `orderCancelAuth` guard implements this OR semantics — do not register multiple guards, as the controller requires every guard to succeed.
+     * The processor stops pending work, lets in-flight URL scans finish, and emits a final `canceled` status.
+     *
+     * Returns `204` when the cancel request is accepted, including when the order is already `canceled` (idempotent).
+     * Returns `422` when the order has already reached a non-cancelable final status (`completed`, `completedPartially`, or `error`).
+     */
+    postOrderCancel<ThrowOnError extends boolean = false>(options: Options<PostOrderCancelData, ThrowOnError>): import("./client/types.gen.js").RequestResult<PostOrderCancelResponses, PostOrderCancelErrors, ThrowOnError, "fields">;
     /**
      * Get order
      *
@@ -42,6 +55,10 @@ export declare class ComplyforceApi extends HeyApiClient {
      *
      * Accepting an order for a website scan with one, several, all, or the most relevant subpages.
      *
+     * Authentication accepts **one of**: vendor API key or vendor-dashboard JWT (Bearer).
+     * A single `orderCreateAuth` guard implements this OR semantics — do not register multiple guards, as the controller requires every guard to succeed.
+     * The vendor API key remains the primary integration path for external integrators.
+     *
      * #### Scan types (with examples)
      * <details>
      * <summary>Single page scan</summary>
@@ -73,9 +90,8 @@ export declare class ComplyforceApi extends HeyApiClient {
      * "orderPreparationUrlsEnrichment"
      * ],
      * "scanDomain": "shop.example.com",
-     * "scanUrlsRequested": [
-     * "https://shop.example.com/login"
-     * ],
+     * "scanUrlsRequestedCount": 1,
+     * "scanUrlsFailedCount": 0,
      * "scanPriority": 50,
      * "status": "created",
      * "createdAt": "2025-01-01T12:00:00.000Z",
@@ -125,10 +141,8 @@ export declare class ComplyforceApi extends HeyApiClient {
      * "orderPreparationUrlsEnrichment"
      * ],
      * "scanDomain": "shop.example.com",
-     * "scanUrlsRequested": [
-     * "https://shop.example.com/login",
-     * "https://shop.example.com/checkout"
-     * ],
+     * "scanUrlsRequestedCount": 2,
+     * "scanUrlsFailedCount": 0,
      * "scanPriority": 50,
      * "status": "created",
      * "createdAt": "2025-01-01T12:01:00.000Z",
@@ -176,7 +190,8 @@ export declare class ComplyforceApi extends HeyApiClient {
      * "orderPreparationUrlsEnrichment"
      * ],
      * "scanDomain": "newsroom.example.com",
-     * "scanUrlsRequested": [],
+     * "scanUrlsRequestedCount": 1,
+     * "scanUrlsFailedCount": 0,
      * "scanPriority": 50,
      * "status": "created",
      * "createdAt": "2025-01-01T12:02:00.000Z",
@@ -229,7 +244,8 @@ export declare class ComplyforceApi extends HeyApiClient {
      * "orderPreparationUrlsEnrichment"
      * ],
      * "scanDomain": "careers.example.com",
-     * "scanUrlsRequested": [],
+     * "scanUrlsRequestedCount": 1,
+     * "scanUrlsFailedCount": 0,
      * "scanUrlsLimit": 1000,
      * "scanPriority": 50,
      * "status": "created",
@@ -265,6 +281,17 @@ export declare class ComplyforceApi extends HeyApiClient {
      * Retrieve full report data and report link for completed orders.
      */
     getOrderReport<ThrowOnError extends boolean = false>(options: Options<GetOrderReportData, ThrowOnError>): import("./client/types.gen.js").RequestResult<GetOrderReportResponses, GetOrderReportErrors, ThrowOnError, "fields">;
+    /**
+     * Get scan artefact URLs for an order
+     *
+     * Looks up signed S3 download URLs for crawler scan artefacts (before/after consent captures and traces) for a single order.
+     *
+     * Artefacts are only mirrored when the order was created with `traceEnabled`. Absent or expired mirrors yield an empty `artefacts` map.
+     * Signed URLs expire with the S3 object lifetime; callers must treat them as short-lived download links, not permanent storage references.
+     *
+     * Authentication requires a vendor-dashboard JWT (Bearer). When the caller may not read the order, the response is `200` with an empty `artefacts` map (no existence leak).
+     */
+    getOrderOrderUuidScanArtefacts<ThrowOnError extends boolean = false>(options: Options<GetOrderOrderUuidScanArtefactsData, ThrowOnError>): import("./client/types.gen.js").RequestResult<GetOrderOrderUuidScanArtefactsResponses, GetOrderOrderUuidScanArtefactsErrors, ThrowOnError, "fields">;
     /**
      * Get orders overview
      *

package/types/types.gen.d.ts

@@ -1,6 +1,18 @@
 export type ClientOptions = {
     baseUrl: 'https://api.complyforce.com/v1' | (string & {});
 };
+/**
+ * Cancel order request with order UUID and optional cancel reason.
+ */
+export type OrderCancelRequest = {
+    order: {
+        uuid: string;
+    };
+    /**
+     * Optional reason for cancellation (vendor dashboard may require a selection).
+     */
+    cancelReason?: 'wrongTarget' | 'duplicateOrder' | 'noLongerNeeded' | 'takingTooLong' | 'other';
+};
 /**
  * Get order entity
  */
@@ -10,19 +22,17 @@ export type OrderGetResponse = {
     scanType: 'single' | 'multiple' | 'mostRelevant' | 'all';
     scanFeaturesRequested: Array<'orderPreparationUrlsEnrichment' | 'browseAgentVisionAi' | 'informationObligationAgentLlmAi' | 'consentComplianceAgent' | 'archivingAgent'>;
     scanDomain: string;
-    /**
-     * Array of URLs to scan. Duplicate URLs are automatically removed when multiple URLs are provided.
-     */
-    scanUrlsRequested: Array<string>;
+    scanUrlsRequestedCount: number;
+    scanUrlsProcessedCount?: number | null;
+    scanUrlsFailedCount?: number;
     /**
      * Maximum number of URLs/pages to scan for all-pages scans (default: 500, max: 10000).
      */
     scanUrlsLimit?: number;
     scanPriority: number;
     scanFeaturesExecuted?: Array<'orderPreparationUrlsEnrichment' | 'browseAgentVisionAi' | 'informationObligationAgentLlmAi' | 'consentComplianceAgent' | 'archivingAgent'>;
-    scanUrlsExecuted?: Array<string>;
-    status: 'created' | 'preparing' | 'prepared' | 'queued' | 'crawling' | 'crawled' | 'processing' | 'processed' | 'reportGenerating' | 'reportGenerated' | 'reportDeliveryToWebhookQueued' | 'completed' | 'completedPartially' | 'error';
-    reportAvailability: 'pending' | 'available' | 'deleted';
+    status: 'created' | 'preparing' | 'prepared' | 'queued' | 'crawling' | 'crawled' | 'processing' | 'processed' | 'reportGenerating' | 'reportGenerated' | 'reportDeliveryToWebhookQueued' | 'completed' | 'completedPartially' | 'canceled' | 'error';
+    reportAvailability: 'pending' | 'available' | 'canceled' | 'deleted';
     reportDeletionReason?: 'expired' | 'websiteOperatorRequest' | 'vendorRequest' | 'unknown';
     reportAvailableUntil?: string;
     createdAt?: string;
@@ -57,7 +67,7 @@ export type OrderGetResponse = {
     statusUpdates: Array<{
         id: string;
         uuid: string;
-        status: 'created' | 'preparing' | 'prepared' | 'queued' | 'crawling' | 'crawled' | 'processing' | 'processed' | 'reportGenerating' | 'reportGenerated' | 'reportDeliveryToWebhookQueued' | 'completed' | 'completedPartially' | 'error';
+        status: 'created' | 'preparing' | 'prepared' | 'queued' | 'crawling' | 'crawled' | 'processing' | 'processed' | 'reportGenerating' | 'reportGenerated' | 'reportDeliveryToWebhookQueued' | 'completed' | 'completedPartially' | 'canceled' | 'error';
         errorType?: 'domainNotReachable' | 'invalidUrl' | 'domainBlacklisted' | 'scanTypeNotAllowed' | 'channelInactive' | 'brandInactive' | 'tooManyUrls' | 'mixedDomains' | 'crawlingTimeout' | 'processingError' | 'reportGenerationError' | 'webhookDeliveryError';
         updatedAt?: string;
         createdAt?: string;
@@ -77,21 +87,20 @@ export type OrderPosted = {
     scanType: 'single' | 'multiple' | 'mostRelevant' | 'all';
     scanFeaturesRequested: Array<'orderPreparationUrlsEnrichment' | 'browseAgentVisionAi' | 'informationObligationAgentLlmAi' | 'consentComplianceAgent' | 'archivingAgent'>;
     scanDomain: string;
-    /**
-     * Array of URLs to scan. Duplicate URLs are automatically removed when multiple URLs are provided.
-     */
-    scanUrlsRequested: Array<string>;
+    scanUrlsRequestedCount: number;
+    scanUrlsProcessedCount?: number | null;
+    scanUrlsFailedCount?: number;
     /**
      * Maximum number of URLs/pages to scan for all-pages scans (default: 500, max: 10000).
      */
     scanUrlsLimit?: number;
     scanPriority: number;
-    status: 'created' | 'preparing' | 'prepared' | 'queued' | 'crawling' | 'crawled' | 'processing' | 'processed' | 'reportGenerating' | 'reportGenerated' | 'reportDeliveryToWebhookQueued' | 'completed' | 'completedPartially' | 'error';
+    status: 'created' | 'preparing' | 'prepared' | 'queued' | 'crawling' | 'crawled' | 'processing' | 'processed' | 'reportGenerating' | 'reportGenerated' | 'reportDeliveryToWebhookQueued' | 'completed' | 'completedPartially' | 'canceled' | 'error';
     createdAt?: string;
     statusUpdates: Array<{
         id: string;
         uuid: string;
-        status: 'created' | 'preparing' | 'prepared' | 'queued' | 'crawling' | 'crawled' | 'processing' | 'processed' | 'reportGenerating' | 'reportGenerated' | 'reportDeliveryToWebhookQueued' | 'completed' | 'completedPartially' | 'error';
+        status: 'created' | 'preparing' | 'prepared' | 'queued' | 'crawling' | 'crawled' | 'processing' | 'processed' | 'reportGenerating' | 'reportGenerated' | 'reportDeliveryToWebhookQueued' | 'completed' | 'completedPartially' | 'canceled' | 'error';
         errorType?: 'domainNotReachable' | 'invalidUrl' | 'domainBlacklisted' | 'scanTypeNotAllowed' | 'channelInactive' | 'brandInactive' | 'tooManyUrls' | 'mixedDomains' | 'crawlingTimeout' | 'processingError' | 'reportGenerationError' | 'webhookDeliveryError';
         updatedAt?: string;
         createdAt?: string;
@@ -110,6 +119,10 @@ export type OrderCreate = {
      * Maximum number of URLs/pages to scan for all-pages scans (default: 500, max: 10000).
      */
     scanUrlsLimit?: number;
+    /**
+     * When set by an admin user, overrides the API config default for per-order crawler tracing and scan-artefact mirror writes.
+     */
+    traceEnabled?: boolean;
     channel: {
         uuid: string;
     };
@@ -119,9 +132,8 @@ export type OrderCreate = {
  */
 export type OrderProgressResponse = {
     orderUuid: string;
-    status: 'created' | 'preparing' | 'prepared' | 'queued' | 'crawling' | 'crawled' | 'processing' | 'processed' | 'reportGenerating' | 'reportGenerated' | 'reportDeliveryToWebhookQueued' | 'completed' | 'completedPartially' | 'error';
+    status: 'created' | 'preparing' | 'prepared' | 'queued' | 'crawling' | 'crawled' | 'processing' | 'processed' | 'reportGenerating' | 'reportGenerated' | 'reportDeliveryToWebhookQueued' | 'completed' | 'completedPartially' | 'canceled' | 'error';
     sitemapDiscoveredUrls?: number;
-    latestProcessedUrl?: string;
     processedUrls: number;
     totalUrls: number;
     error?: {
@@ -144,7 +156,9 @@ export type OrderReportGetResponse = {
     uuid: string;
     scanType: 'single' | 'multiple' | 'mostRelevant' | 'all';
     scanDomain: string;
-    scanUrlsExecuted?: Array<string>;
+    scanUrlsRequestedCount: number;
+    scanUrlsProcessedCount?: number | null;
+    scanUrlsFailedCount?: number;
     createdAt?: string;
     vendorBrand: {
         uuid: string;
@@ -189,12 +203,57 @@ export type OrderReportGetResponse = {
         riskScore: number;
     };
     latestStatusUpdate: {
-        status: 'created' | 'preparing' | 'prepared' | 'queued' | 'crawling' | 'crawled' | 'processing' | 'processed' | 'reportGenerating' | 'reportGenerated' | 'reportDeliveryToWebhookQueued' | 'completed' | 'completedPartially' | 'error';
+        status: 'created' | 'preparing' | 'prepared' | 'queued' | 'crawling' | 'crawled' | 'processing' | 'processed' | 'reportGenerating' | 'reportGenerated' | 'reportDeliveryToWebhookQueued' | 'completed' | 'completedPartially' | 'canceled' | 'error';
         errorType?: 'domainNotReachable' | 'invalidUrl' | 'domainBlacklisted' | 'scanTypeNotAllowed' | 'channelInactive' | 'brandInactive' | 'tooManyUrls' | 'mixedDomains' | 'crawlingTimeout' | 'processingError' | 'reportGenerationError' | 'webhookDeliveryError';
         updatedAt?: string;
         createdAt?: string;
     };
 };
+/**
+ * Scan artefact lookup result for one order
+ */
+export type OrderScanArtefactsGot = {
+    artefacts: ScanUrlResults;
+};
+/**
+ * Map of scanned page URL to artefact fields. Empty when no artefacts are available or the caller may not read the order.
+ */
+export type ScanUrlResults = {
+    [key: string]: ScanUrlResult;
+};
+/**
+ * Scan artefact fields for one scanned page URL.
+ */
+export type ScanUrlResult = {
+    /**
+     * Signed S3 URL for the before-consent (accept-all) capture.
+     */
+    beforeConsentAcceptAll?: string;
+    /**
+     * Signed S3 URL for the after-consent (accept-all) capture.
+     */
+    afterConsentAcceptAll?: string;
+    /**
+     * Signed S3 URL for the crawl trace artefact.
+     */
+    trace?: string;
+    /**
+     * Error name when the URL scan failed.
+     */
+    errorName?: string;
+    /**
+     * Error message when the URL scan failed.
+     */
+    errorMessage?: string;
+    /**
+     * Error stack when the URL scan failed.
+     */
+    errorStack?: string;
+    /**
+     * ISO timestamp when this URL was processed.
+     */
+    processedAt?: string;
+};
 /**
  * Order summary for list view
  */
@@ -211,18 +270,19 @@ export type OrderListItem = {
         dataProtectionViolationsFound: boolean;
         riskScore: number;
     };
-    status: 'created' | 'preparing' | 'prepared' | 'queued' | 'crawling' | 'crawled' | 'processing' | 'processed' | 'reportGenerating' | 'reportGenerated' | 'reportDeliveryToWebhookQueued' | 'completed' | 'completedPartially' | 'error';
+    status: 'created' | 'preparing' | 'prepared' | 'queued' | 'crawling' | 'crawled' | 'processing' | 'processed' | 'reportGenerating' | 'reportGenerated' | 'reportDeliveryToWebhookQueued' | 'completed' | 'completedPartially' | 'canceled' | 'error';
     errorType?: 'domainNotReachable' | 'invalidUrl' | 'domainBlacklisted' | 'scanTypeNotAllowed' | 'channelInactive' | 'brandInactive' | 'tooManyUrls' | 'mixedDomains' | 'crawlingTimeout' | 'processingError' | 'reportGenerationError' | 'webhookDeliveryError';
     createdAt: string;
     lastStatusUpdate?: {
         id: string;
         uuid: string;
-        status: 'created' | 'preparing' | 'prepared' | 'queued' | 'crawling' | 'crawled' | 'processing' | 'processed' | 'reportGenerating' | 'reportGenerated' | 'reportDeliveryToWebhookQueued' | 'completed' | 'completedPartially' | 'error';
+        status: 'created' | 'preparing' | 'prepared' | 'queued' | 'crawling' | 'crawled' | 'processing' | 'processed' | 'reportGenerating' | 'reportGenerated' | 'reportDeliveryToWebhookQueued' | 'completed' | 'completedPartially' | 'canceled' | 'error';
         errorType?: 'domainNotReachable' | 'invalidUrl' | 'domainBlacklisted' | 'scanTypeNotAllowed' | 'channelInactive' | 'brandInactive' | 'tooManyUrls' | 'mixedDomains' | 'crawlingTimeout' | 'processingError' | 'reportGenerationError' | 'webhookDeliveryError';
+        log?: string;
         updatedAt?: string;
         createdAt?: string;
     };
-    reportAvailability: 'pending' | 'available' | 'deleted';
+    reportAvailability: 'pending' | 'available' | 'canceled' | 'deleted';
     reportAvailableUntil?: string;
     vendorBrand: {
         id: string;
@@ -234,6 +294,17 @@ export type OrderListItem = {
         uuid: string;
         name: string;
     };
+    createdByUser?: {
+        id: string;
+        email: string;
+        firstName: string;
+        lastName: string;
+    };
+    vendorApiKey?: {
+        id: string;
+        keyLastDigits: string;
+        description?: string;
+    };
 };
 /**
  * Cursor-based pagination metadata for list responses.
@@ -252,6 +323,51 @@ export type CursorPaginationResponseMetadata = {
      */
     dataCount: number;
 };
+export type PostOrderCancelData = {
+    body: OrderCancelRequest;
+    path?: never;
+    query?: never;
+    url: '/order/cancel';
+};
+export type PostOrderCancelErrors = {
+    /**
+     * No valid authentication credentials provided
+     */
+    401: null;
+    422: Array<{
+        code: string;
+        message: string;
+        description?: string;
+        entityName?: string;
+        fieldName?: string;
+        index?: number;
+        data?: {
+            [key: string]: unknown;
+        };
+    } | {
+        code: 'orderNotCancelable';
+        message: string;
+    }>;
+    default: Array<{
+        code: string;
+        message: string;
+        description?: string;
+        entityName?: string;
+        fieldName?: string;
+        index?: number;
+        data?: {
+            [key: string]: unknown;
+        };
+    }>;
+};
+export type PostOrderCancelError = PostOrderCancelErrors[keyof PostOrderCancelErrors];
+export type PostOrderCancelResponses = {
+    /**
+     * Cancel request accepted or order already canceled
+     */
+    204: null;
+};
+export type PostOrderCancelResponse = PostOrderCancelResponses[keyof PostOrderCancelResponses];
 export type GetOrderData = {
     body?: never;
     path?: never;
@@ -295,7 +411,7 @@ export type PostOrderData = {
 };
 export type PostOrderErrors = {
     /**
-     * API key is invalid
+     * No valid authentication credentials provided
      */
     401: Array<{
         code: string;
@@ -311,23 +427,6 @@ export type PostOrderErrors = {
         code: 'InvalidApiKey';
         message: string;
     }>;
-    /**
-     * Vendor has no signed main contract
-     */
-    403: Array<{
-        code: string;
-        message: string;
-        description?: string;
-        entityName?: string;
-        fieldName?: string;
-        index?: number;
-        data?: {
-            [key: string]: unknown;
-        };
-    } | {
-        code: 'VendorMainContractNotSigned';
-        message: string;
-    }>;
     default: Array<{
         code: string;
         message: string;
@@ -465,6 +564,46 @@ export type GetOrderReportResponses = {
     };
 };
 export type GetOrderReportResponse = GetOrderReportResponses[keyof GetOrderReportResponses];
+export type GetOrderOrderUuidScanArtefactsData = {
+    body?: never;
+    path?: never;
+    query: {
+        /**
+         * Order UUID to look up.
+         */
+        orderUuid: string;
+    };
+    url: '/order/:orderUuid/scan-artefacts';
+};
+export type GetOrderOrderUuidScanArtefactsErrors = {
+    /**
+     * JWT is invalid
+     */
+    401: null;
+    /**
+     * JWT valid, but insufficient permissions
+     */
+    403: null;
+    default: Array<{
+        code: string;
+        message: string;
+        description?: string;
+        entityName?: string;
+        fieldName?: string;
+        index?: number;
+        data?: {
+            [key: string]: unknown;
+        };
+    }>;
+};
+export type GetOrderOrderUuidScanArtefactsError = GetOrderOrderUuidScanArtefactsErrors[keyof GetOrderOrderUuidScanArtefactsErrors];
+export type GetOrderOrderUuidScanArtefactsResponses = {
+    /**
+     * Signed scan artefact URLs for the requested order
+     */
+    200: OrderScanArtefactsGot;
+};
+export type GetOrderOrderUuidScanArtefactsResponse = GetOrderOrderUuidScanArtefactsResponses[keyof GetOrderOrderUuidScanArtefactsResponses];
 export type GetOrdersData = {
     body?: never;
     path?: never;
@@ -496,7 +635,7 @@ export type GetOrdersData = {
         /**
          * Filter by order status.
          */
-        status?: 'created' | 'preparing' | 'prepared' | 'queued' | 'crawling' | 'crawled' | 'processing' | 'processed' | 'reportGenerating' | 'reportGenerated' | 'reportDeliveryToWebhookQueued' | 'completed' | 'completedPartially' | 'error';
+        status?: 'created' | 'preparing' | 'prepared' | 'queued' | 'crawling' | 'crawled' | 'processing' | 'processed' | 'reportGenerating' | 'reportGenerated' | 'reportDeliveryToWebhookQueued' | 'completed' | 'completedPartially' | 'canceled' | 'error';
         /**
          * Filter by vendor brand UUID.
          */