@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 +20 -38
- package/esm/sdk.gen.js +20 -38
- package/package.json +2 -2
- package/types/index.d.ts +1 -1
- package/types/sdk.gen.d.ts +19 -31
- package/types/types.gen.d.ts +60 -149
package/cjs/sdk.gen.js
CHANGED
|
@@ -33,36 +33,37 @@ class ComplyforceApi extends HeyApiClient {
|
|
|
33
33
|
/**
|
|
34
34
|
* Cancel order
|
|
35
35
|
*
|
|
36
|
-
*
|
|
36
|
+
* Stops a scan order that has not finished yet.
|
|
37
37
|
*
|
|
38
|
-
*
|
|
39
|
-
*
|
|
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
|
|
43
|
-
* Returns `422` when the order
|
|
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: '
|
|
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
|
-
*
|
|
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
|
-
*
|
|
63
|
+
* Creates a website scan for one page, several pages, the most relevant pages, or all pages of a site.
|
|
62
64
|
*
|
|
63
|
-
*
|
|
64
|
-
*
|
|
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
|
-
*
|
|
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
|
-
*
|
|
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
|
-
*
|
|
33
|
+
* Stops a scan order that has not finished yet.
|
|
34
34
|
*
|
|
35
|
-
*
|
|
36
|
-
*
|
|
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
|
|
40
|
-
* Returns `422` when the order
|
|
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: '
|
|
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
|
-
*
|
|
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
|
-
*
|
|
60
|
+
* Creates a website scan for one page, several pages, the most relevant pages, or all pages of a site.
|
|
59
61
|
*
|
|
60
|
-
*
|
|
61
|
-
*
|
|
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
|
-
*
|
|
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
|
-
*
|
|
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.
|
|
3
|
+
"version": "1.12.0",
|
|
4
4
|
"description": "TypeScript client for the Complyforce API",
|
|
5
|
-
"digestMd5": "
|
|
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,
|
|
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";
|
package/types/sdk.gen.d.ts
CHANGED
|
@@ -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,
|
|
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
|
-
*
|
|
37
|
+
* Stops a scan order that has not finished yet.
|
|
38
38
|
*
|
|
39
|
-
*
|
|
40
|
-
*
|
|
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
|
|
44
|
-
* Returns `422` when the order
|
|
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
|
-
*
|
|
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
|
-
*
|
|
58
|
+
* Creates a website scan for one page, several pages, the most relevant pages, or all pages of a site.
|
|
57
59
|
*
|
|
58
|
-
*
|
|
59
|
-
*
|
|
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
|
-
*
|
|
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
|
-
*
|
|
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
|
/**
|
package/types/types.gen.d.ts
CHANGED
|
@@ -2,14 +2,14 @@ export type ClientOptions = {
|
|
|
2
2
|
baseUrl: 'https://api.complyforce.com/v1' | (string & {});
|
|
3
3
|
};
|
|
4
4
|
/**
|
|
5
|
-
*
|
|
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
|
|
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
|
-
*
|
|
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:
|
|
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
|
|
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.
|
|
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
|
|
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
|
-
*
|
|
653
|
-
*/
|
|
654
|
-
401: null;
|
|
655
|
-
/**
|
|
656
|
-
* JWT valid, but insufficient permissions
|
|
554
|
+
* No valid authentication credentials provided
|
|
657
555
|
*/
|
|
658
|
-
|
|
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;
|