@nopaque/sdk 0.1.1 → 0.6.0

package/dist/index.mjs

@@ -91,7 +91,7 @@ function resolveConfig(opts) {
 }
 
 // src/version.ts
-var VERSION = true ? "0.1.1" : "0.0.0-dev";
+var VERSION = true ? "0.6.0" : "0.0.0-dev";
 
 // src/userAgent.ts
 function composeUserAgent() {
@@ -449,7 +449,13 @@ var AudioResource = class extends Resource {
     const resolvedName = input.name ?? inferredName ?? "upload.bin";
     const resolvedType = input.contentType ?? sniffContentType(resolvedName);
     const presign = await this.createUploadUrl(
-      { fileName: resolvedName, contentType: resolvedType },
+      {
+        filename: resolvedName,
+        contentType: resolvedType,
+        category: input.category,
+        ...input.associatedId && { associatedId: input.associatedId },
+        sizeBytes: bytes.byteLength
+      },
       requestOptions
     );
     await s3Put(presign.uploadUrl, bytes, {
@@ -574,6 +580,62 @@ var BatchesResource = class extends Resource {
   }
 };
 
+// src/resources/compliance.ts
+function encodePhone(phoneNumber) {
+  return encodeURIComponent(phoneNumber);
+}
+var ComplianceResource = class extends Resource {
+  async getCatalogue(params = {}, requestOptions) {
+    return await this.transport.request("GET", "/testing/compliance-catalogue", { params, requestOptions });
+  }
+  // Atomic batch dispatch. Server enforces compliancePickerLimits[tier] on
+  // testIds.length and returns 402 with code='BATCH_SIZE_EXCEEDS_TIER' on
+  // overflow. Surfaces as a typed NopaqueAPIError with code preserved.
+  async run(body, requestOptions) {
+    return await this.transport.request("POST", "/testing/compliance-runs", { body, requestOptions });
+  }
+  listReports(params = {}, requestOptions) {
+    return new Paginator({
+      fetchPage: async (p) => await this.transport.request("GET", "/testing/compliance-reports", { params: p, requestOptions }),
+      params: { ...params }
+    });
+  }
+  async listReportsPage(params = {}, requestOptions) {
+    const raw = await this.transport.request("GET", "/testing/compliance-reports", { params, requestOptions });
+    return new Page(raw.items, raw.nextToken);
+  }
+  async getReport(phoneNumber, requestOptions) {
+    return await this.transport.request(
+      "GET",
+      `/testing/compliance-reports/${encodePhone(phoneNumber)}`,
+      { requestOptions }
+    );
+  }
+  // Returns the presigned S3 URL the platform uploaded the PDF to. The 1 hour
+  // expiry is baked into the URL itself; the response body is `{ url }` only.
+  async generatePdfUrl(phoneNumber, body = {}, requestOptions) {
+    return await this.transport.request(
+      "POST",
+      `/testing/compliance-reports/${encodePhone(phoneNumber)}/pdf`,
+      { body, requestOptions }
+    );
+  }
+  // Convenience: get the URL, then fetch the bytes. For applications that
+  // already have an HTTP client, prefer generatePdfUrl() and fetch the URL
+  // with that client instead.
+  async downloadReportPdf(phoneNumber, body = {}, requestOptions) {
+    const { url } = await this.generatePdfUrl(phoneNumber, body, requestOptions);
+    const response = await this.transport.config.fetch(url);
+    if (!response.ok) {
+      throw new Error(`Failed to download PDF: ${response.status} ${response.statusText}`);
+    }
+    return new Uint8Array(await response.arrayBuffer());
+  }
+  async rerun(runId, requestOptions) {
+    return await this.transport.request("POST", `/testing/compliance-runs/${runId}/rerun`, { requestOptions });
+  }
+};
+
 // src/resources/datasets.ts
 var DatasetsResource = class extends Resource {
   async create(body, requestOptions) {
@@ -606,6 +668,207 @@ var DatasetsResource = class extends Resource {
   }
 };
 
+// src/resources/digitalCompliance.ts
+var DigitalComplianceResource = class extends Resource {
+  /**
+   * List digital compliance audits, one entry per target.
+   *
+   * @beta Access is limited to beta workspaces during the beta period.
+   */
+  async listAudits(requestOptions) {
+    const raw = await this.transport.request(
+      "GET",
+      "/digital-testing/compliance-audits",
+      { requestOptions }
+    );
+    return raw.audits ?? [];
+  }
+  /**
+   * Compliance report for one digital target.
+   *
+   * `targetRef` goes in the QUERY STRING, not the path: a targetRef contains
+   * slashes (`acme/billing-bot`) and a single path segment cannot hold one. The
+   * API made the same choice for the same reason.
+   *
+   * Pass `{ sector }` to restrict the catalogue to tests applicable to that sector.
+   *
+   * @beta Access is limited to beta workspaces during the beta period.
+   */
+  async getReport(targetRef, params = {}, requestOptions) {
+    return await this.transport.request("GET", "/digital-testing/compliance-audits/report", {
+      params: { targetRef, ...params },
+      requestOptions
+    });
+  }
+};
+
+// src/resources/digitalTestConfigs.ts
+var DigitalTestConfigsResource = class extends Resource {
+  /** @beta Access is limited to beta workspaces during the beta period. */
+  list(params = {}, requestOptions) {
+    return new Paginator({
+      fetchPage: async (p) => {
+        const { nextToken, cursor, ...rest } = p;
+        const raw = await this.transport.request(
+          "GET",
+          "/digital-testing/configs",
+          {
+            // `nextToken` first: the Paginator advances by writing it, and a
+            // caller-supplied `cursor` would otherwise pin every page to page one.
+            params: { ...rest, cursor: nextToken ?? cursor },
+            requestOptions
+          }
+        );
+        return {
+          items: raw.configs ?? raw.items ?? [],
+          nextToken: raw.nextCursor ?? raw.nextToken ?? null
+        };
+      },
+      params: { ...params }
+    });
+  }
+  /** @beta Access is limited to beta workspaces during the beta period. */
+  async listPage(params = {}, requestOptions) {
+    const { nextToken, cursor, ...rest } = params;
+    const raw = await this.transport.request("GET", "/digital-testing/configs", {
+      params: { ...rest, cursor: nextToken ?? cursor },
+      requestOptions
+    });
+    return new Page(raw.configs ?? raw.items ?? [], raw.nextCursor ?? raw.nextToken ?? null);
+  }
+  /**
+   * Save a digital test config. Per-kind rules are enforced at SAVE time, so a
+   * config that could never run is rejected with 400 rather than stored.
+   *
+   * @beta Access is limited to beta workspaces during the beta period.
+   */
+  async create(body, requestOptions) {
+    return await this.transport.request("POST", "/digital-testing/configs", {
+      body,
+      requestOptions
+    });
+  }
+  /** @beta Access is limited to beta workspaces during the beta period. */
+  async get(configId, requestOptions) {
+    return await this.transport.request("GET", `/digital-testing/configs/${configId}`, {
+      requestOptions
+    });
+  }
+  /** @beta Access is limited to beta workspaces during the beta period. */
+  async update(configId, body, requestOptions) {
+    return await this.transport.request("PATCH", `/digital-testing/configs/${configId}`, {
+      body,
+      requestOptions
+    });
+  }
+  /** @beta Access is limited to beta workspaces during the beta period. */
+  async delete(configId, requestOptions) {
+    await this.transport.request("DELETE", `/digital-testing/configs/${configId}`, {
+      requestOptions
+    });
+  }
+  /**
+   * Launch a run from a saved config. `target` and `targetRef` must be
+   * overridden together — a half-override is a 400.
+   *
+   * @beta Access is limited to beta workspaces during the beta period.
+   */
+  async launch(configId, body = {}, requestOptions) {
+    const raw = await this.transport.request("POST", `/digital-testing/configs/${configId}/runs`, { body, requestOptions });
+    return raw.run ?? raw;
+  }
+};
+
+// src/resources/digitalTesting.ts
+var TERMINAL = /* @__PURE__ */ new Set(["completed", "failed", "cancelled"]);
+var DigitalTestingResource = class extends Resource {
+  /**
+   * Queue a digital test run.
+   *
+   * @beta Access is limited to beta workspaces during the beta period.
+   */
+  async create(body, requestOptions) {
+    const raw = await this.transport.request("POST", "/digital-testing/runs", { body, requestOptions });
+    return raw.run ?? raw;
+  }
+  /**
+   * Paginated list of digital test runs, newest first.
+   *
+   * @beta Access is limited to beta workspaces during the beta period.
+   */
+  list(params = {}, requestOptions) {
+    return new Paginator({
+      fetchPage: async (p) => {
+        const { nextToken, cursor, ...rest } = p;
+        const raw = await this.transport.request("GET", "/digital-testing/runs", {
+          // `nextToken` first: the Paginator advances by writing it, and a
+          // caller-supplied `cursor` would otherwise pin every page to page one.
+          params: { ...rest, cursor: nextToken ?? cursor },
+          requestOptions
+        });
+        return {
+          items: raw.runs ?? raw.items ?? [],
+          nextToken: raw.nextCursor ?? raw.nextToken ?? null
+        };
+      },
+      params: { ...params }
+    });
+  }
+  /**
+   * One page of digital test runs.
+   *
+   * @beta Access is limited to beta workspaces during the beta period.
+   */
+  async listPage(params = {}, requestOptions) {
+    const { nextToken, cursor, ...rest } = params;
+    const raw = await this.transport.request("GET", "/digital-testing/runs", {
+      params: { ...rest, cursor: nextToken ?? cursor },
+      requestOptions
+    });
+    return new Page(raw.runs ?? raw.items ?? [], raw.nextCursor ?? raw.nextToken ?? null);
+  }
+  /**
+   * Get one digital test run.
+   *
+   * @beta Access is limited to beta workspaces during the beta period.
+   */
+  async get(runId, requestOptions) {
+    return await this.transport.request("GET", `/digital-testing/runs/${runId}`, {
+      requestOptions
+    });
+  }
+  /**
+   * Cancel a digital test run.
+   *
+   * @beta Access is limited to beta workspaces during the beta period.
+   */
+  async cancel(runId, requestOptions) {
+    return await this.transport.request("POST", `/digital-testing/runs/${runId}/cancel`, {
+      requestOptions
+    });
+  }
+  /**
+   * Poll until the run reaches a terminal state.
+   *
+   * Resolves on `completed`, `failed` and `cancelled` alike and returns the run.
+   * A bot that behaved badly is `completed` with `outcome: 'fail'`, which is a
+   * RESULT, not an error — this never throws on it. `failed` means the test could
+   * not be delivered.
+   *
+   * @beta Access is limited to beta workspaces during the beta period.
+   */
+  async waitForRun(runId, opts = {}) {
+    return await waitFor({
+      fetch: () => this.get(runId, opts.requestOptions),
+      isTerminal: (r) => TERMINAL.has(r.status),
+      timeout: opts.timeout,
+      initialInterval: opts.pollInterval,
+      intervalCap: opts.intervalCap,
+      onUpdate: opts.onUpdate
+    });
+  }
+};
+
 // src/resources/enrichment.ts
 var EnrichmentResource = class extends Resource {
   async get(jobId, runId, type, requestOptions) {
@@ -720,17 +983,24 @@ var TERMINAL_STATUSES2 = /* @__PURE__ */ new Set(["completed", "failed", "limite
 var MappingResource = class extends Resource {
   list(params = {}, requestOptions) {
     return new Paginator({
-      fetchPage: async (p) => await this.transport.request("GET", "/mapping", { params: p, requestOptions }),
+      fetchPage: async (p) => {
+        const { nextToken, cursor, ...rest } = p;
+        const raw = await this.transport.request("GET", "/mapping", {
+          params: { ...rest, cursor: cursor ?? nextToken },
+          requestOptions
+        });
+        return { items: raw.items ?? [], nextToken: raw.nextCursor ?? raw.nextToken ?? null };
+      },
       params: { ...params }
     });
   }
   async listPage(params = {}, requestOptions) {
-    const raw = await this.transport.request(
-      "GET",
-      "/mapping",
-      { params, requestOptions }
-    );
-    return new Page(raw.items, raw.nextToken);
+    const { nextToken, cursor, ...rest } = params;
+    const raw = await this.transport.request("GET", "/mapping", {
+      params: { ...rest, cursor: cursor ?? nextToken },
+      requestOptions
+    });
+    return new Page(raw.items ?? [], raw.nextCursor ?? raw.nextToken ?? null);
   }
   async get(jobId, requestOptions) {
     return await this.transport.request("GET", `/mapping/${jobId}`, { requestOptions });
@@ -756,6 +1026,16 @@ var MappingResource = class extends Resource {
       requestOptions
     });
   }
+  // Trigger on-demand security-probe analysis on a completed mapping run.
+  // Returns the queue summary { message, probeCount }; poll the run / steps
+  // afterwards to see classified results land.
+  async probe(jobId, runId, requestOptions) {
+    return await this.transport.request(
+      "POST",
+      `/mapping/${jobId}/runs/${runId}/probe`,
+      { requestOptions }
+    );
+  }
   steps(jobId, params = {}, requestOptions) {
     return new Paginator({
       fetchPage: async (p) => await this.transport.request("GET", `/mapping/${jobId}/steps`, {
@@ -812,13 +1092,6 @@ var MappingResource = class extends Resource {
       { requestOptions }
     );
   }
-  async probe(jobId, runId, body = {}, requestOptions) {
-    return await this.transport.request(
-      "POST",
-      `/mapping/${jobId}/runs/${runId}/probe`,
-      { body, requestOptions }
-    );
-  }
   async waitForComplete(jobId, opts = {}) {
     return await waitFor({
       fetch: () => this.get(jobId, opts.requestOptions),
@@ -831,6 +1104,83 @@ var MappingResource = class extends Resource {
   }
 };
 
+// src/resources/missionTestConfigs.ts
+var MissionTestConfigsResource = class extends Resource {
+  list(params = {}, requestOptions) {
+    return new Paginator({
+      fetchPage: async (p) => {
+        const { nextToken, cursor, ...rest } = p;
+        const raw = await this.transport.request("GET", "/testing/mission-test-configs", {
+          params: { ...rest, cursor: cursor ?? nextToken },
+          requestOptions
+        });
+        return { items: raw.items ?? [], nextToken: raw.nextCursor ?? raw.nextToken ?? null };
+      },
+      params: { ...params }
+    });
+  }
+  async listPage(params = {}, requestOptions) {
+    const { nextToken, cursor, ...rest } = params;
+    const raw = await this.transport.request("GET", "/testing/mission-test-configs", {
+      params: { ...rest, cursor: cursor ?? nextToken },
+      requestOptions
+    });
+    return new Page(raw.items ?? [], raw.nextCursor ?? raw.nextToken ?? null);
+  }
+  async create(body, requestOptions) {
+    return await this.transport.request("POST", "/testing/mission-test-configs", { body, requestOptions });
+  }
+  async get(id, requestOptions) {
+    return await this.transport.request("GET", `/testing/mission-test-configs/${id}`, { requestOptions });
+  }
+  async update(id, body, requestOptions) {
+    return await this.transport.request("PATCH", `/testing/mission-test-configs/${id}`, {
+      body,
+      requestOptions
+    });
+  }
+  async delete(id, requestOptions) {
+    await this.transport.request("DELETE", `/testing/mission-test-configs/${id}`, { requestOptions });
+  }
+  // Launch a mission test run from a saved config. The returned run is freeform-shaped.
+  async run(id, requestOptions) {
+    return await this.transport.request("POST", `/testing/mission-test-configs/${id}/runs`, { requestOptions });
+  }
+};
+
+// src/resources/missionTests.ts
+var MissionTestsResource = class extends Resource {
+  list(params = {}, requestOptions) {
+    return new Paginator({
+      fetchPage: async (p) => await this.transport.request("GET", "/testing/mission-tests", { params: p, requestOptions }),
+      params: { ...params }
+    });
+  }
+  async listPage(params = {}, requestOptions) {
+    const raw = await this.transport.request(
+      "GET",
+      "/testing/mission-tests",
+      { params, requestOptions }
+    );
+    return new Page(raw.items, raw.nextToken);
+  }
+  async create(body, requestOptions) {
+    return await this.transport.request("POST", "/testing/mission-tests", { body, requestOptions });
+  }
+  // Returns 503 with code='CATALOG_NOT_READY' until the mission-tester service
+  // publishes its SSM payload. Callers can catch and retry, or fall back to a
+  // known-good default sector/mission/acceptance.
+  async getDefaults(requestOptions) {
+    return await this.transport.request("GET", "/testing/mission-tests/defaults", { requestOptions });
+  }
+  async get(id, requestOptions) {
+    return await this.transport.request("GET", `/testing/mission-tests/${id}`, { requestOptions });
+  }
+  async cancel(id, requestOptions) {
+    return await this.transport.request("POST", `/testing/mission-tests/${id}/cancel`, { requestOptions });
+  }
+};
+
 // src/resources/profiles.ts
 var ProfilesResource = class extends Resource {
   async create(body, requestOptions) {
@@ -868,8 +1218,9 @@ var ProfilesResource = class extends Resource {
       requestOptions
     });
   }
+  /** Returns the updated profile, as all three item routes do. */
   async deleteItem(profileId, itemId, requestOptions) {
-    await this.transport.request(
+    return await this.transport.request(
       "DELETE",
       `/profiles/${profileId}/items/${itemId}`,
       { requestOptions }
@@ -1061,15 +1412,33 @@ var TestingRunsResource = class extends Resource {
   list(params = {}, requestOptions) {
     return new Paginator({
       fetchPage: async (p) => {
-        const raw = await this.transport.request("GET", "/testing/runs", { params: p, requestOptions });
-        return { items: raw.runs ?? raw.items ?? [], nextToken: null };
+        const { nextToken, cursor, ...rest } = p;
+        const raw = await this.transport.request("GET", "/testing/runs", {
+          params: { ...rest, cursor: cursor ?? nextToken },
+          requestOptions
+        });
+        return {
+          items: raw.runs ?? raw.items ?? [],
+          nextToken: raw.nextCursor ?? raw.nextToken ?? null
+        };
       },
       params: { ...params }
     });
   }
   async listPage(params = {}, requestOptions) {
-    const raw = await this.transport.request("GET", "/testing/runs", { params, requestOptions });
-    return new Page(raw.runs ?? raw.items ?? [], raw.nextToken ?? null);
+    const { nextToken, cursor, ...rest } = params;
+    const raw = await this.transport.request("GET", "/testing/runs", {
+      params: { ...rest, cursor: cursor ?? nextToken },
+      requestOptions
+    });
+    return new Page(raw.runs ?? raw.items ?? [], raw.nextCursor ?? raw.nextToken ?? null);
+  }
+  /** GET /testing/runs/aggregate — grouped counts over test runs. */
+  async aggregate(params, requestOptions) {
+    return await this.transport.request("GET", "/testing/runs/aggregate", {
+      params,
+      requestOptions
+    });
   }
   async get(runId, requestOptions) {
     return await this.transport.request("GET", `/testing/runs/${runId}`, { requestOptions });
@@ -1095,6 +1464,24 @@ var TestingResource = class extends Resource {
     this.jobs = new TestingJobsResource(transport);
     this.runs = new TestingRunsResource(transport);
   }
+  /** Paginated, filtered list of test runs (alias for `testing.runs.list()`). */
+  listRuns(params = {}, requestOptions) {
+    return this.runs.list(params, requestOptions);
+  }
+  /** GET /testing/voices — operator-enabled voices a mission test may use. */
+  async listVoices(requestOptions) {
+    return await this.transport.request("GET", "/testing/voices", { requestOptions });
+  }
+  /** GET /testing/runs/aggregate — grouped counts over test runs. */
+  async aggregateRuns(params, requestOptions) {
+    return await this.runs.aggregate(params, requestOptions);
+  }
+  /** GET /testing/mission-test-runs/{id} — mission-strict run detail (no steps). */
+  async getMissionTestRun(id, requestOptions) {
+    return await this.transport.request("GET", `/testing/mission-test-runs/${id}`, {
+      requestOptions
+    });
+  }
 };
 
 // src/client.ts
@@ -1109,6 +1496,12 @@ var Nopaque = class {
   loadTesting;
   scheduler;
   enrichment;
+  missionTests;
+  missionTestConfigs;
+  compliance;
+  digitalTesting;
+  digitalTestConfigs;
+  digitalCompliance;
   transport;
   constructor(options = {}) {
     const config = resolveConfig(options);
@@ -1123,6 +1516,12 @@ var Nopaque = class {
     this.loadTesting = new LoadTestingResource(this.transport);
     this.scheduler = new SchedulerResource(this.transport);
     this.enrichment = new EnrichmentResource(this.transport);
+    this.missionTests = new MissionTestsResource(this.transport);
+    this.missionTestConfigs = new MissionTestConfigsResource(this.transport);
+    this.compliance = new ComplianceResource(this.transport);
+    this.digitalTesting = new DigitalTestingResource(this.transport);
+    this.digitalTestConfigs = new DigitalTestConfigsResource(this.transport);
+    this.digitalCompliance = new DigitalComplianceResource(this.transport);
   }
   close() {
   }