@complyforce/api 1.11.0 → 1.12.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/cjs/sdk.gen.js CHANGED
@@ -33,36 +33,37 @@ class ComplyforceApi extends HeyApiClient {
33
33
  /**
34
34
  * Cancel order
35
35
  *
36
- * Gracefully cancels an in-flight order before it reaches a final status.
36
+ * Stops a scan order that has not finished yet.
37
37
  *
38
- * Authentication accepts **one of**: vendor API key, vendor-dashboard JWT (Bearer), or `x-authentication-super-admin`.
39
- * A single `orderCancelAuth` guard implements this OR semantics — do not register multiple guards, as the controller requires every guard to succeed.
40
- * The processor stops pending work, lets in-flight URL scans finish, and emits a final `canceled` status.
38
+ * Authenticate with a vendor API key (`x-api-key`) or a vendor dashboard Bearer token.
39
+ * The order status moves to **`canceling`** right away while remaining page scans are stopped, then to **`canceled`** once cleanup is done.
41
40
  *
42
- * Returns `204` when the cancel request is accepted, including when the order is already `canceled` (idempotent).
43
- * Returns `422` when the order has already reached a non-cancelable final status (`completed`, `completedPartially`, or `error`).
41
+ * Returns `204` when the cancel is accepted, including when the order is already `canceled` (idempotent).
42
+ * Returns `422` when the order cannot be canceled because it is already **`canceling`**, or has finished (`completed`, `completedPartially`, or `error`).
44
43
  */
45
44
  postOrderCancel(options) {
46
45
  var _a;
47
- 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) }));
46
+ return ((_a = options.client) !== null && _a !== void 0 ? _a : this.client).post(Object.assign(Object.assign({ security: [{ name: 'authorization', type: 'apiKey' }], url: '/order/cancel' }, options), { headers: Object.assign({ 'Content-Type': 'application/json' }, options.headers) }));
48
47
  }
49
48
  /**
50
49
  * Get order
51
50
  *
52
- * Retrieve order data, current status and status updates, as well as report link and summary for completed orders.
51
+ * Returns one order: current status, optional status history, and — when available — the report link and summary.
52
+ *
53
+ * Authenticate with a vendor API key (`x-api-key`) or a vendor dashboard Bearer token.
54
+ * You can only read orders that belong to a vendor you have access to.
53
55
  */
54
56
  getOrder(options) {
55
57
  var _a;
56
- return ((_a = options.client) !== null && _a !== void 0 ? _a : this.client).get(Object.assign({ url: '/order' }, options));
58
+ return ((_a = options.client) !== null && _a !== void 0 ? _a : this.client).get(Object.assign({ security: [{ name: 'authorization', type: 'apiKey' }], url: '/order' }, options));
57
59
  }
58
60
  /**
59
61
  * Create order
60
62
  *
61
- * Accepting an order for a website scan with one, several, all, or the most relevant subpages.
63
+ * Creates a website scan for one page, several pages, the most relevant pages, or all pages of a site.
62
64
  *
63
- * Authentication accepts **one of**: vendor API key or vendor-dashboard JWT (Bearer).
64
- * A single `orderCreateAuth` guard implements this OR semantics — do not register multiple guards, as the controller requires every guard to succeed.
65
- * The vendor API key remains the primary integration path for external integrators.
65
+ * Authenticate with a vendor API key (`x-api-key`) or a vendor dashboard Bearer token.
66
+ * For automated integrations, prefer a vendor API key.
66
67
  *
67
68
  * #### Scan types (with examples)
68
69
  * <details>
@@ -273,17 +274,10 @@ class ComplyforceApi extends HeyApiClient {
273
274
  var _a;
274
275
  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) }));
275
276
  }
276
- /**
277
- * Get order progress
278
- *
279
- * Current order workflow status and URL processing counters.
280
- */
281
- getOrderProgress(options) {
282
- var _a;
283
- return ((_a = options.client) !== null && _a !== void 0 ? _a : this.client).get(Object.assign({ url: '/order/progress' }, options));
284
- }
285
277
  /**
286
278
  * Delete order report
279
+ *
280
+ * Deletes the stored compliance report for an order. Authenticate with a vendor API key (`x-api-key`).
287
281
  */
288
282
  deleteOrderReport(options) {
289
283
  var _a;
@@ -292,30 +286,18 @@ class ComplyforceApi extends HeyApiClient {
292
286
  /**
293
287
  * Get order report
294
288
  *
295
- * Retrieve full report data and report link for completed orders.
289
+ * Returns the full compliance report and report link for a completed order. Authenticate with a vendor API key (`x-api-key`).
296
290
  */
297
291
  getOrderReport(options) {
298
292
  var _a;
299
293
  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));
300
294
  }
301
- /**
302
- * Get scan artefact URLs for an order
303
- *
304
- * Looks up signed S3 download URLs for crawler scan artefacts (before/after consent captures and traces) for a single order.
305
- *
306
- * Artefacts are only mirrored when the order was created with `traceEnabled`. Absent or expired mirrors yield an empty `artefacts` map.
307
- * Signed URLs expire with the S3 object lifetime; callers must treat them as short-lived download links, not permanent storage references.
308
- *
309
- * 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).
310
- */
311
- getOrderOrderUuidScanArtefacts(options) {
312
- var _a;
313
- 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));
314
- }
315
295
  /**
316
296
  * Get orders overview
317
297
  *
318
- * List orders for the authenticated vendor. Supports cursor-based pagination and optional filters by date range, billing, status, brand and channel.
298
+ * Lists scan orders for a vendor, with cursor pagination and optional filters (date range, billing, status, brand, channel).
299
+ *
300
+ * Authenticate with a vendor API key (`x-api-key`) or a vendor dashboard Bearer token.
319
301
  */
320
302
  getOrders(options) {
321
303
  var _a;
package/esm/sdk.gen.js CHANGED
@@ -30,36 +30,37 @@ export class ComplyforceApi extends HeyApiClient {
30
30
  /**
31
31
  * Cancel order
32
32
  *
33
- * Gracefully cancels an in-flight order before it reaches a final status.
33
+ * Stops a scan order that has not finished yet.
34
34
  *
35
- * Authentication accepts **one of**: vendor API key, vendor-dashboard JWT (Bearer), or `x-authentication-super-admin`.
36
- * A single `orderCancelAuth` guard implements this OR semantics — do not register multiple guards, as the controller requires every guard to succeed.
37
- * The processor stops pending work, lets in-flight URL scans finish, and emits a final `canceled` status.
35
+ * Authenticate with a vendor API key (`x-api-key`) or a vendor dashboard Bearer token.
36
+ * The order status moves to **`canceling`** right away while remaining page scans are stopped, then to **`canceled`** once cleanup is done.
38
37
  *
39
- * Returns `204` when the cancel request is accepted, including when the order is already `canceled` (idempotent).
40
- * Returns `422` when the order has already reached a non-cancelable final status (`completed`, `completedPartially`, or `error`).
38
+ * Returns `204` when the cancel is accepted, including when the order is already `canceled` (idempotent).
39
+ * Returns `422` when the order cannot be canceled because it is already **`canceling`**, or has finished (`completed`, `completedPartially`, or `error`).
41
40
  */
42
41
  postOrderCancel(options) {
43
42
  var _a;
44
- 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) }));
43
+ return ((_a = options.client) !== null && _a !== void 0 ? _a : this.client).post(Object.assign(Object.assign({ security: [{ name: 'authorization', type: 'apiKey' }], url: '/order/cancel' }, options), { headers: Object.assign({ 'Content-Type': 'application/json' }, options.headers) }));
45
44
  }
46
45
  /**
47
46
  * Get order
48
47
  *
49
- * Retrieve order data, current status and status updates, as well as report link and summary for completed orders.
48
+ * Returns one order: current status, optional status history, and — when available — the report link and summary.
49
+ *
50
+ * Authenticate with a vendor API key (`x-api-key`) or a vendor dashboard Bearer token.
51
+ * You can only read orders that belong to a vendor you have access to.
50
52
  */
51
53
  getOrder(options) {
52
54
  var _a;
53
- return ((_a = options.client) !== null && _a !== void 0 ? _a : this.client).get(Object.assign({ url: '/order' }, options));
55
+ return ((_a = options.client) !== null && _a !== void 0 ? _a : this.client).get(Object.assign({ security: [{ name: 'authorization', type: 'apiKey' }], url: '/order' }, options));
54
56
  }
55
57
  /**
56
58
  * Create order
57
59
  *
58
- * Accepting an order for a website scan with one, several, all, or the most relevant subpages.
60
+ * Creates a website scan for one page, several pages, the most relevant pages, or all pages of a site.
59
61
  *
60
- * Authentication accepts **one of**: vendor API key or vendor-dashboard JWT (Bearer).
61
- * A single `orderCreateAuth` guard implements this OR semantics — do not register multiple guards, as the controller requires every guard to succeed.
62
- * The vendor API key remains the primary integration path for external integrators.
62
+ * Authenticate with a vendor API key (`x-api-key`) or a vendor dashboard Bearer token.
63
+ * For automated integrations, prefer a vendor API key.
63
64
  *
64
65
  * #### Scan types (with examples)
65
66
  * <details>
@@ -270,17 +271,10 @@ export class ComplyforceApi extends HeyApiClient {
270
271
  var _a;
271
272
  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) }));
272
273
  }
273
- /**
274
- * Get order progress
275
- *
276
- * Current order workflow status and URL processing counters.
277
- */
278
- getOrderProgress(options) {
279
- var _a;
280
- return ((_a = options.client) !== null && _a !== void 0 ? _a : this.client).get(Object.assign({ url: '/order/progress' }, options));
281
- }
282
274
  /**
283
275
  * Delete order report
276
+ *
277
+ * Deletes the stored compliance report for an order. Authenticate with a vendor API key (`x-api-key`).
284
278
  */
285
279
  deleteOrderReport(options) {
286
280
  var _a;
@@ -289,30 +283,18 @@ export class ComplyforceApi extends HeyApiClient {
289
283
  /**
290
284
  * Get order report
291
285
  *
292
- * Retrieve full report data and report link for completed orders.
286
+ * Returns the full compliance report and report link for a completed order. Authenticate with a vendor API key (`x-api-key`).
293
287
  */
294
288
  getOrderReport(options) {
295
289
  var _a;
296
290
  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));
297
291
  }
298
- /**
299
- * Get scan artefact URLs for an order
300
- *
301
- * Looks up signed S3 download URLs for crawler scan artefacts (before/after consent captures and traces) for a single order.
302
- *
303
- * Artefacts are only mirrored when the order was created with `traceEnabled`. Absent or expired mirrors yield an empty `artefacts` map.
304
- * Signed URLs expire with the S3 object lifetime; callers must treat them as short-lived download links, not permanent storage references.
305
- *
306
- * 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).
307
- */
308
- getOrderOrderUuidScanArtefacts(options) {
309
- var _a;
310
- 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));
311
- }
312
292
  /**
313
293
  * Get orders overview
314
294
  *
315
- * List orders for the authenticated vendor. Supports cursor-based pagination and optional filters by date range, billing, status, brand and channel.
295
+ * Lists scan orders for a vendor, with cursor pagination and optional filters (date range, billing, status, brand, channel).
296
+ *
297
+ * Authenticate with a vendor API key (`x-api-key`) or a vendor dashboard Bearer token.
316
298
  */
317
299
  getOrders(options) {
318
300
  var _a;
package/package.json CHANGED
@@ -1,8 +1,8 @@
1
1
  {
2
2
  "name": "@complyforce/api",
3
- "version": "1.11.0",
3
+ "version": "1.12.0",
4
4
  "description": "TypeScript client for the Complyforce API",
5
- "digestMd5": "d76450af7f92f83236477855a34e2540",
5
+ "digestMd5": "f79c3f41429b00e9bf76cdd19dc90e6e",
6
6
  "type": "module",
7
7
  "main": "cjs/index.cjs.js",
8
8
  "module": "esm/index.js",
package/types/index.d.ts CHANGED
@@ -1,4 +1,4 @@
1
1
  export { ComplyforceApi, type Options } from './sdk.gen.js';
2
- 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';
2
+ export type { ClientOptions, CursorPaginationResponseMetadata, DeleteOrderReportData, DeleteOrderReportError, DeleteOrderReportErrors, DeleteOrderReportResponse, DeleteOrderReportResponses, GetOrderData, GetOrderError, GetOrderErrors, GetOrderReportData, GetOrderReportError, GetOrderReportErrors, GetOrderReportResponse, GetOrderReportResponses, GetOrderResponse, GetOrderResponses, GetOrdersData, GetOrdersError, GetOrdersErrors, GetOrdersResponse, GetOrdersResponses, GetVendorApiKeyValidateData, GetVendorApiKeyValidateError, GetVendorApiKeyValidateErrors, GetVendorApiKeyValidateResponse, GetVendorApiKeyValidateResponses, OrderCancelRequest, OrderCreate, OrderGetResponse, OrderListItem, OrderPosted, OrderReportDeleteRequest, OrderReportGetResponse, PostOrderCancelData, PostOrderCancelError, PostOrderCancelErrors, PostOrderCancelResponse, PostOrderCancelResponses, PostOrderData, PostOrderError, PostOrderErrors, PostOrderResponse, PostOrderResponses } from './types.gen.js';
3
3
  export { createClient, createConfig } from "./client/index.js";
4
4
  export { client } from "./client.gen.js";
@@ -1,5 +1,5 @@
1
1
  import type { Client, Options as Options2, TDataShape } from './client/index.js';
2
- 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';
2
+ import type { DeleteOrderReportData, DeleteOrderReportErrors, DeleteOrderReportResponses, GetOrderData, GetOrderErrors, GetOrderReportData, GetOrderReportErrors, GetOrderReportResponses, GetOrderResponses, GetOrdersData, GetOrdersErrors, GetOrdersResponses, GetVendorApiKeyValidateData, GetVendorApiKeyValidateErrors, GetVendorApiKeyValidateResponses, PostOrderCancelData, PostOrderCancelErrors, PostOrderCancelResponses, PostOrderData, PostOrderErrors, PostOrderResponses } from './types.gen.js';
3
3
  export type Options<TData extends TDataShape = TDataShape, ThrowOnError extends boolean = boolean> = Options2<TData, ThrowOnError> & {
4
4
  /**
5
5
  * You can provide a client instance returned by `createClient()` instead of
@@ -34,30 +34,31 @@ export declare class ComplyforceApi extends HeyApiClient {
34
34
  /**
35
35
  * Cancel order
36
36
  *
37
- * Gracefully cancels an in-flight order before it reaches a final status.
37
+ * Stops a scan order that has not finished yet.
38
38
  *
39
- * Authentication accepts **one of**: vendor API key, vendor-dashboard JWT (Bearer), or `x-authentication-super-admin`.
40
- * A single `orderCancelAuth` guard implements this OR semantics — do not register multiple guards, as the controller requires every guard to succeed.
41
- * The processor stops pending work, lets in-flight URL scans finish, and emits a final `canceled` status.
39
+ * Authenticate with a vendor API key (`x-api-key`) or a vendor dashboard Bearer token.
40
+ * The order status moves to **`canceling`** right away while remaining page scans are stopped, then to **`canceled`** once cleanup is done.
42
41
  *
43
- * Returns `204` when the cancel request is accepted, including when the order is already `canceled` (idempotent).
44
- * Returns `422` when the order has already reached a non-cancelable final status (`completed`, `completedPartially`, or `error`).
42
+ * Returns `204` when the cancel is accepted, including when the order is already `canceled` (idempotent).
43
+ * Returns `422` when the order cannot be canceled because it is already **`canceling`**, or has finished (`completed`, `completedPartially`, or `error`).
45
44
  */
46
45
  postOrderCancel<ThrowOnError extends boolean = false>(options: Options<PostOrderCancelData, ThrowOnError>): import("./client/types.gen.js").RequestResult<PostOrderCancelResponses, PostOrderCancelErrors, ThrowOnError, "fields">;
47
46
  /**
48
47
  * Get order
49
48
  *
50
- * Retrieve order data, current status and status updates, as well as report link and summary for completed orders.
49
+ * Returns one order: current status, optional status history, and — when available — the report link and summary.
50
+ *
51
+ * Authenticate with a vendor API key (`x-api-key`) or a vendor dashboard Bearer token.
52
+ * You can only read orders that belong to a vendor you have access to.
51
53
  */
52
54
  getOrder<ThrowOnError extends boolean = false>(options: Options<GetOrderData, ThrowOnError>): import("./client/types.gen.js").RequestResult<GetOrderResponses, GetOrderErrors, ThrowOnError, "fields">;
53
55
  /**
54
56
  * Create order
55
57
  *
56
- * Accepting an order for a website scan with one, several, all, or the most relevant subpages.
58
+ * Creates a website scan for one page, several pages, the most relevant pages, or all pages of a site.
57
59
  *
58
- * Authentication accepts **one of**: vendor API key or vendor-dashboard JWT (Bearer).
59
- * A single `orderCreateAuth` guard implements this OR semantics — do not register multiple guards, as the controller requires every guard to succeed.
60
- * The vendor API key remains the primary integration path for external integrators.
60
+ * Authenticate with a vendor API key (`x-api-key`) or a vendor dashboard Bearer token.
61
+ * For automated integrations, prefer a vendor API key.
61
62
  *
62
63
  * #### Scan types (with examples)
63
64
  * <details>
@@ -265,37 +266,24 @@ export declare class ComplyforceApi extends HeyApiClient {
265
266
  * </details>
266
267
  */
267
268
  postOrder<ThrowOnError extends boolean = false>(options: Options<PostOrderData, ThrowOnError>): import("./client/types.gen.js").RequestResult<PostOrderResponses, PostOrderErrors, ThrowOnError, "fields">;
268
- /**
269
- * Get order progress
270
- *
271
- * Current order workflow status and URL processing counters.
272
- */
273
- getOrderProgress<ThrowOnError extends boolean = false>(options: Options<GetOrderProgressData, ThrowOnError>): import("./client/types.gen.js").RequestResult<GetOrderProgressResponses, GetOrderProgressErrors, ThrowOnError, "fields">;
274
269
  /**
275
270
  * Delete order report
271
+ *
272
+ * Deletes the stored compliance report for an order. Authenticate with a vendor API key (`x-api-key`).
276
273
  */
277
274
  deleteOrderReport<ThrowOnError extends boolean = false>(options: Options<DeleteOrderReportData, ThrowOnError>): import("./client/types.gen.js").RequestResult<DeleteOrderReportResponses, DeleteOrderReportErrors, ThrowOnError, "fields">;
278
275
  /**
279
276
  * Get order report
280
277
  *
281
- * Retrieve full report data and report link for completed orders.
278
+ * Returns the full compliance report and report link for a completed order. Authenticate with a vendor API key (`x-api-key`).
282
279
  */
283
280
  getOrderReport<ThrowOnError extends boolean = false>(options: Options<GetOrderReportData, ThrowOnError>): import("./client/types.gen.js").RequestResult<GetOrderReportResponses, GetOrderReportErrors, ThrowOnError, "fields">;
284
- /**
285
- * Get scan artefact URLs for an order
286
- *
287
- * Looks up signed S3 download URLs for crawler scan artefacts (before/after consent captures and traces) for a single order.
288
- *
289
- * Artefacts are only mirrored when the order was created with `traceEnabled`. Absent or expired mirrors yield an empty `artefacts` map.
290
- * Signed URLs expire with the S3 object lifetime; callers must treat them as short-lived download links, not permanent storage references.
291
- *
292
- * 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).
293
- */
294
- getOrderOrderUuidScanArtefacts<ThrowOnError extends boolean = false>(options: Options<GetOrderOrderUuidScanArtefactsData, ThrowOnError>): import("./client/types.gen.js").RequestResult<GetOrderOrderUuidScanArtefactsResponses, GetOrderOrderUuidScanArtefactsErrors, ThrowOnError, "fields">;
295
281
  /**
296
282
  * Get orders overview
297
283
  *
298
- * List orders for the authenticated vendor. Supports cursor-based pagination and optional filters by date range, billing, status, brand and channel.
284
+ * Lists scan orders for a vendor, with cursor pagination and optional filters (date range, billing, status, brand, channel).
285
+ *
286
+ * Authenticate with a vendor API key (`x-api-key`) or a vendor dashboard Bearer token.
299
287
  */
300
288
  getOrders<ThrowOnError extends boolean = false>(options: Options<GetOrdersData, ThrowOnError>): import("./client/types.gen.js").RequestResult<GetOrdersResponses, GetOrdersErrors, ThrowOnError, "fields">;
301
289
  /**
@@ -2,14 +2,14 @@ export type ClientOptions = {
2
2
  baseUrl: 'https://api.complyforce.com/v1' | (string & {});
3
3
  };
4
4
  /**
5
- * Cancel order request with order UUID and optional cancel reason.
5
+ * Order to cancel and optional cancel reason.
6
6
  */
7
7
  export type OrderCancelRequest = {
8
8
  order: {
9
9
  uuid: string;
10
10
  };
11
11
  /**
12
- * Optional reason for cancellation (vendor dashboard may require a selection).
12
+ * Optional reason why the order is being canceled.
13
13
  */
14
14
  cancelReason?: 'wrongTarget' | 'duplicateOrder' | 'noLongerNeeded' | 'takingTooLong' | 'other';
15
15
  };
@@ -31,7 +31,7 @@ export type OrderGetResponse = {
31
31
  scanUrlsLimit?: number;
32
32
  scanPriority: number;
33
33
  scanFeaturesExecuted?: Array<'orderPreparationUrlsEnrichment' | 'browseAgentVisionAi' | 'informationObligationAgentLlmAi' | 'consentComplianceAgent' | 'archivingAgent'>;
34
- status: 'created' | 'preparing' | 'prepared' | 'queued' | 'crawling' | 'crawled' | 'processing' | 'processed' | 'reportGenerating' | 'reportGenerated' | 'reportDeliveryToWebhookQueued' | 'completed' | 'completedPartially' | 'canceled' | 'error';
34
+ status: 'created' | 'preparing' | 'prepared' | 'queued' | 'crawling' | 'crawled' | 'processing' | 'processed' | 'reportGenerating' | 'reportGenerated' | 'reportDeliveryToWebhookQueued' | 'canceling' | 'completed' | 'completedPartially' | 'canceled' | 'error';
35
35
  reportAvailability: 'pending' | 'available' | 'canceled' | 'deleted';
36
36
  reportDeletionReason?: 'expired' | 'websiteOperatorRequest' | 'vendorRequest' | 'unknown';
37
37
  reportAvailableUntil?: string;
@@ -67,7 +67,7 @@ export type OrderGetResponse = {
67
67
  statusUpdates: Array<{
68
68
  id: string;
69
69
  uuid: string;
70
- status: 'created' | 'preparing' | 'prepared' | 'queued' | 'crawling' | 'crawled' | 'processing' | 'processed' | 'reportGenerating' | 'reportGenerated' | 'reportDeliveryToWebhookQueued' | 'completed' | 'completedPartially' | 'canceled' | 'error';
70
+ status: 'created' | 'preparing' | 'prepared' | 'queued' | 'crawling' | 'crawled' | 'processing' | 'processed' | 'reportGenerating' | 'reportGenerated' | 'reportDeliveryToWebhookQueued' | 'canceling' | 'completed' | 'completedPartially' | 'canceled' | 'error';
71
71
  errorType?: 'domainNotReachable' | 'invalidUrl' | 'domainBlacklisted' | 'scanTypeNotAllowed' | 'channelInactive' | 'brandInactive' | 'tooManyUrls' | 'mixedDomains' | 'crawlingTimeout' | 'processingError' | 'reportGenerationError' | 'webhookDeliveryError';
72
72
  updatedAt?: string;
73
73
  createdAt?: string;
@@ -95,12 +95,12 @@ export type OrderPosted = {
95
95
  */
96
96
  scanUrlsLimit?: number;
97
97
  scanPriority: number;
98
- status: 'created' | 'preparing' | 'prepared' | 'queued' | 'crawling' | 'crawled' | 'processing' | 'processed' | 'reportGenerating' | 'reportGenerated' | 'reportDeliveryToWebhookQueued' | 'completed' | 'completedPartially' | 'canceled' | 'error';
98
+ status: 'created' | 'preparing' | 'prepared' | 'queued' | 'crawling' | 'crawled' | 'processing' | 'processed' | 'reportGenerating' | 'reportGenerated' | 'reportDeliveryToWebhookQueued' | 'canceling' | 'completed' | 'completedPartially' | 'canceled' | 'error';
99
99
  createdAt?: string;
100
100
  statusUpdates: Array<{
101
101
  id: string;
102
102
  uuid: string;
103
- status: 'created' | 'preparing' | 'prepared' | 'queued' | 'crawling' | 'crawled' | 'processing' | 'processed' | 'reportGenerating' | 'reportGenerated' | 'reportDeliveryToWebhookQueued' | 'completed' | 'completedPartially' | 'canceled' | 'error';
103
+ status: 'created' | 'preparing' | 'prepared' | 'queued' | 'crawling' | 'crawled' | 'processing' | 'processed' | 'reportGenerating' | 'reportGenerated' | 'reportDeliveryToWebhookQueued' | 'canceling' | 'completed' | 'completedPartially' | 'canceled' | 'error';
104
104
  errorType?: 'domainNotReachable' | 'invalidUrl' | 'domainBlacklisted' | 'scanTypeNotAllowed' | 'channelInactive' | 'brandInactive' | 'tooManyUrls' | 'mixedDomains' | 'crawlingTimeout' | 'processingError' | 'reportGenerationError' | 'webhookDeliveryError';
105
105
  updatedAt?: string;
106
106
  createdAt?: string;
@@ -120,27 +120,13 @@ export type OrderCreate = {
120
120
  */
121
121
  scanUrlsLimit?: number;
122
122
  /**
123
- * When set by an admin user, overrides the API config default for per-order crawler tracing and scan-artefact mirror writes.
123
+ * Admin only. When true, keeps detailed diagnostic captures for this order after the scan finishes.
124
124
  */
125
125
  traceEnabled?: boolean;
126
126
  channel: {
127
127
  uuid: string;
128
128
  };
129
129
  };
130
- /**
131
- * Order progress response
132
- */
133
- export type OrderProgressResponse = {
134
- orderUuid: string;
135
- status: 'created' | 'preparing' | 'prepared' | 'queued' | 'crawling' | 'crawled' | 'processing' | 'processed' | 'reportGenerating' | 'reportGenerated' | 'reportDeliveryToWebhookQueued' | 'completed' | 'completedPartially' | 'canceled' | 'error';
136
- sitemapDiscoveredUrls?: number;
137
- processedUrls: number;
138
- totalUrls: number;
139
- error?: {
140
- type?: 'domainNotReachable' | 'invalidUrl' | 'domainBlacklisted' | 'scanTypeNotAllowed' | 'channelInactive' | 'brandInactive' | 'tooManyUrls' | 'mixedDomains' | 'crawlingTimeout' | 'processingError' | 'reportGenerationError' | 'webhookDeliveryError';
141
- message?: string;
142
- };
143
- };
144
130
  /**
145
131
  * Order report delete request
146
132
  */
@@ -203,57 +189,12 @@ export type OrderReportGetResponse = {
203
189
  riskScore: number;
204
190
  };
205
191
  latestStatusUpdate: {
206
- status: 'created' | 'preparing' | 'prepared' | 'queued' | 'crawling' | 'crawled' | 'processing' | 'processed' | 'reportGenerating' | 'reportGenerated' | 'reportDeliveryToWebhookQueued' | 'completed' | 'completedPartially' | 'canceled' | 'error';
192
+ status: 'created' | 'preparing' | 'prepared' | 'queued' | 'crawling' | 'crawled' | 'processing' | 'processed' | 'reportGenerating' | 'reportGenerated' | 'reportDeliveryToWebhookQueued' | 'canceling' | 'completed' | 'completedPartially' | 'canceled' | 'error';
207
193
  errorType?: 'domainNotReachable' | 'invalidUrl' | 'domainBlacklisted' | 'scanTypeNotAllowed' | 'channelInactive' | 'brandInactive' | 'tooManyUrls' | 'mixedDomains' | 'crawlingTimeout' | 'processingError' | 'reportGenerationError' | 'webhookDeliveryError';
208
194
  updatedAt?: string;
209
195
  createdAt?: string;
210
196
  };
211
197
  };
212
- /**
213
- * Scan artefact lookup result for one order
214
- */
215
- export type OrderScanArtefactsGot = {
216
- artefacts: ScanUrlResults;
217
- };
218
- /**
219
- * Map of scanned page URL to artefact fields. Empty when no artefacts are available or the caller may not read the order.
220
- */
221
- export type ScanUrlResults = {
222
- [key: string]: ScanUrlResult;
223
- };
224
- /**
225
- * Scan artefact fields for one scanned page URL.
226
- */
227
- export type ScanUrlResult = {
228
- /**
229
- * Signed S3 URL for the before-consent (accept-all) capture.
230
- */
231
- beforeConsentAcceptAll?: string;
232
- /**
233
- * Signed S3 URL for the after-consent (accept-all) capture.
234
- */
235
- afterConsentAcceptAll?: string;
236
- /**
237
- * Signed S3 URL for the crawl trace artefact.
238
- */
239
- trace?: string;
240
- /**
241
- * Error name when the URL scan failed.
242
- */
243
- errorName?: string;
244
- /**
245
- * Error message when the URL scan failed.
246
- */
247
- errorMessage?: string;
248
- /**
249
- * Error stack when the URL scan failed.
250
- */
251
- errorStack?: string;
252
- /**
253
- * ISO timestamp when this URL was processed.
254
- */
255
- processedAt?: string;
256
- };
257
198
  /**
258
199
  * Order summary for list view
259
200
  */
@@ -270,13 +211,13 @@ export type OrderListItem = {
270
211
  dataProtectionViolationsFound: boolean;
271
212
  riskScore: number;
272
213
  };
273
- status: 'created' | 'preparing' | 'prepared' | 'queued' | 'crawling' | 'crawled' | 'processing' | 'processed' | 'reportGenerating' | 'reportGenerated' | 'reportDeliveryToWebhookQueued' | 'completed' | 'completedPartially' | 'canceled' | 'error';
214
+ status: 'created' | 'preparing' | 'prepared' | 'queued' | 'crawling' | 'crawled' | 'processing' | 'processed' | 'reportGenerating' | 'reportGenerated' | 'reportDeliveryToWebhookQueued' | 'canceling' | 'completed' | 'completedPartially' | 'canceled' | 'error';
274
215
  errorType?: 'domainNotReachable' | 'invalidUrl' | 'domainBlacklisted' | 'scanTypeNotAllowed' | 'channelInactive' | 'brandInactive' | 'tooManyUrls' | 'mixedDomains' | 'crawlingTimeout' | 'processingError' | 'reportGenerationError' | 'webhookDeliveryError';
275
216
  createdAt: string;
276
217
  lastStatusUpdate?: {
277
218
  id: string;
278
219
  uuid: string;
279
- status: 'created' | 'preparing' | 'prepared' | 'queued' | 'crawling' | 'crawled' | 'processing' | 'processed' | 'reportGenerating' | 'reportGenerated' | 'reportDeliveryToWebhookQueued' | 'completed' | 'completedPartially' | 'canceled' | 'error';
220
+ status: 'created' | 'preparing' | 'prepared' | 'queued' | 'crawling' | 'crawled' | 'processing' | 'processed' | 'reportGenerating' | 'reportGenerated' | 'reportDeliveryToWebhookQueued' | 'canceling' | 'completed' | 'completedPartially' | 'canceled' | 'error';
280
221
  errorType?: 'domainNotReachable' | 'invalidUrl' | 'domainBlacklisted' | 'scanTypeNotAllowed' | 'channelInactive' | 'brandInactive' | 'tooManyUrls' | 'mixedDomains' | 'crawlingTimeout' | 'processingError' | 'reportGenerationError' | 'webhookDeliveryError';
281
222
  log?: string;
282
223
  updatedAt?: string;
@@ -333,7 +274,20 @@ export type PostOrderCancelErrors = {
333
274
  /**
334
275
  * No valid authentication credentials provided
335
276
  */
336
- 401: null;
277
+ 401: Array<{
278
+ code: string;
279
+ message: string;
280
+ description?: string;
281
+ entityName?: string;
282
+ fieldName?: string;
283
+ index?: number;
284
+ data?: {
285
+ [key: string]: unknown;
286
+ };
287
+ } | {
288
+ code: 'InvalidApiKey';
289
+ message: string;
290
+ }>;
337
291
  422: Array<{
338
292
  code: string;
339
293
  message: string;
@@ -363,7 +317,7 @@ export type PostOrderCancelErrors = {
363
317
  export type PostOrderCancelError = PostOrderCancelErrors[keyof PostOrderCancelErrors];
364
318
  export type PostOrderCancelResponses = {
365
319
  /**
366
- * Cancel request accepted or order already canceled
320
+ * Cancel accepted, or the order was already canceled
367
321
  */
368
322
  204: null;
369
323
  };
@@ -379,6 +333,23 @@ export type GetOrderData = {
379
333
  url: '/order';
380
334
  };
381
335
  export type GetOrderErrors = {
336
+ /**
337
+ * No valid authentication credentials provided
338
+ */
339
+ 401: Array<{
340
+ code: string;
341
+ message: string;
342
+ description?: string;
343
+ entityName?: string;
344
+ fieldName?: string;
345
+ index?: number;
346
+ data?: {
347
+ [key: string]: unknown;
348
+ };
349
+ } | {
350
+ code: 'InvalidApiKey';
351
+ message: string;
352
+ }>;
382
353
  default: Array<{
383
354
  code: string;
384
355
  message: string;
@@ -449,35 +420,6 @@ export type PostOrderResponses = {
449
420
  };
450
421
  };
451
422
  export type PostOrderResponse = PostOrderResponses[keyof PostOrderResponses];
452
- export type GetOrderProgressData = {
453
- body?: never;
454
- path?: never;
455
- query: {
456
- orderUuid: string;
457
- };
458
- url: '/order/progress';
459
- };
460
- export type GetOrderProgressErrors = {
461
- default: Array<{
462
- code: string;
463
- message: string;
464
- description?: string;
465
- entityName?: string;
466
- fieldName?: string;
467
- index?: number;
468
- data?: {
469
- [key: string]: unknown;
470
- };
471
- }>;
472
- };
473
- export type GetOrderProgressError = GetOrderProgressErrors[keyof GetOrderProgressErrors];
474
- export type GetOrderProgressResponses = {
475
- /**
476
- * Order progress retrieved
477
- */
478
- 200: OrderProgressResponse;
479
- };
480
- export type GetOrderProgressResponse = GetOrderProgressResponses[keyof GetOrderProgressResponses];
481
423
  export type DeleteOrderReportData = {
482
424
  body: OrderReportDeleteRequest;
483
425
  path?: never;
@@ -564,52 +506,12 @@ export type GetOrderReportResponses = {
564
506
  };
565
507
  };
566
508
  export type GetOrderReportResponse = GetOrderReportResponses[keyof GetOrderReportResponses];
567
- export type GetOrderOrderUuidScanArtefactsData = {
568
- body?: never;
569
- path?: never;
570
- query: {
571
- /**
572
- * Order UUID to look up.
573
- */
574
- orderUuid: string;
575
- };
576
- url: '/order/:orderUuid/scan-artefacts';
577
- };
578
- export type GetOrderOrderUuidScanArtefactsErrors = {
579
- /**
580
- * JWT is invalid
581
- */
582
- 401: null;
583
- /**
584
- * JWT valid, but insufficient permissions
585
- */
586
- 403: null;
587
- default: Array<{
588
- code: string;
589
- message: string;
590
- description?: string;
591
- entityName?: string;
592
- fieldName?: string;
593
- index?: number;
594
- data?: {
595
- [key: string]: unknown;
596
- };
597
- }>;
598
- };
599
- export type GetOrderOrderUuidScanArtefactsError = GetOrderOrderUuidScanArtefactsErrors[keyof GetOrderOrderUuidScanArtefactsErrors];
600
- export type GetOrderOrderUuidScanArtefactsResponses = {
601
- /**
602
- * Signed scan artefact URLs for the requested order
603
- */
604
- 200: OrderScanArtefactsGot;
605
- };
606
- export type GetOrderOrderUuidScanArtefactsResponse = GetOrderOrderUuidScanArtefactsResponses[keyof GetOrderOrderUuidScanArtefactsResponses];
607
509
  export type GetOrdersData = {
608
510
  body?: never;
609
511
  path?: never;
610
512
  query: {
611
513
  /**
612
- * Vendor UUID. User must be assigned to this vendor.
514
+ * Vendor UUID. The authenticated API key or JWT user must have access to this vendor.
613
515
  */
614
516
  vendorUuid: string;
615
517
  /**
@@ -629,13 +531,13 @@ export type GetOrdersData = {
629
531
  */
630
532
  dateTo?: string;
631
533
  /**
632
- * Filter by vendor billing ID (numeric primary key).
534
+ * Filter by vendor billing ID.
633
535
  */
634
536
  billingId?: string;
635
537
  /**
636
538
  * Filter by order status.
637
539
  */
638
- status?: 'created' | 'preparing' | 'prepared' | 'queued' | 'crawling' | 'crawled' | 'processing' | 'processed' | 'reportGenerating' | 'reportGenerated' | 'reportDeliveryToWebhookQueued' | 'completed' | 'completedPartially' | 'canceled' | 'error';
540
+ status?: 'created' | 'preparing' | 'prepared' | 'queued' | 'crawling' | 'crawled' | 'processing' | 'processed' | 'reportGenerating' | 'reportGenerated' | 'reportDeliveryToWebhookQueued' | 'canceling' | 'completed' | 'completedPartially' | 'canceled' | 'error';
639
541
  /**
640
542
  * Filter by vendor brand UUID.
641
543
  */
@@ -649,13 +551,22 @@ export type GetOrdersData = {
649
551
  };
650
552
  export type GetOrdersErrors = {
651
553
  /**
652
- * JWT is invalid
653
- */
654
- 401: null;
655
- /**
656
- * JWT valid, but insufficient permissions
554
+ * No valid authentication credentials provided
657
555
  */
658
- 403: null;
556
+ 401: Array<{
557
+ code: string;
558
+ message: string;
559
+ description?: string;
560
+ entityName?: string;
561
+ fieldName?: string;
562
+ index?: number;
563
+ data?: {
564
+ [key: string]: unknown;
565
+ };
566
+ } | {
567
+ code: 'InvalidApiKey';
568
+ message: string;
569
+ }>;
659
570
  default: Array<{
660
571
  code: string;
661
572
  message: string;