openpond-sdk 0.12.20 → 0.12.22

package/dist/dataset-workspaces.js

@@ -1,6 +1,14 @@
 import {
   TaskDesignProposalSchema
 } from "./chunk-QIGMNB6M.js";
+import {
+  DatasetTaskAppendReceiptSchema,
+  DatasetTaskAppendRequestSchema,
+  DatasetTaskIngestionError,
+  DatasetTaskInputSchema,
+  addDatasetTask,
+  createTaskAdder
+} from "./chunk-NZRGRUYG.js";
 import {
   ConnectedCaseRefSchema,
   ConnectedStartingAssetSchema,
@@ -15,8 +23,7 @@ import {
 } from "./chunk-AG6UJ3DI.js";
 import {
   compileTasksetDraftWorkspace
-} from "./chunk-3MDNVNBM.js";
-import "./chunk-GWXJSBWR.js";
+} from "./chunk-BNBPKCIR.js";
 import {
   createTasksetDraftFile,
   createTasksetDraftWorkspace,
@@ -24,6 +31,7 @@ import {
   decodeTasksetDraftWorkspaceFile,
   validateTasksetDraftWorkspace
 } from "./chunk-Q4RGCEOI.js";
+import "./chunk-GWXJSBWR.js";
 import {
   TasksetDraftSchema,
   createTasksetDraft
@@ -34,10 +42,10 @@ import {
   TasksetEnvironmentContractSchema,
   TasksetSourceRefSchema
 } from "./chunk-ZQ6QTYRE.js";
+import "./chunk-TK3DXH7A.js";
 import {
   TasksetCatalogReleaseRefSchema
 } from "./chunk-Z252BNAZ.js";
-import "./chunk-TK3DXH7A.js";
 import "./chunk-H3367ISL.js";
 import "./chunk-QTNYXOJW.js";
 import {
@@ -754,89 +762,163 @@ var OpenPondDatasetWorkspaceClient = class {
   constructor(options) {
     this.options = options;
     const url = new URL(options.baseUrl);
-    if (!["http:", "https:"].includes(url.protocol) || url.username || url.password || url.search || url.hash || !options.apiKey.trim() || !options.teamId.trim()) throw new Error("A clean API origin and workspace credentials are required.");
+    if (!["http:", "https:"].includes(url.protocol) || url.username || url.password || url.search || url.hash || !options.apiKey.trim() || !options.teamId.trim())
+      throw new Error("A clean API origin and workspace credentials are required.");
     this.baseUrl = url.toString().replace(/\/+$/, "");
     this.preparations = new OpenPondDatasetPreparationClient(options);
   }
   options;
   baseUrl;
   preparations;
+  async addTask(id, task, options) {
+    return addDatasetTask(this.options, id, task, options);
+  }
   async list(options = {}) {
     const { signal, ...input } = options;
     const query = DatasetWorkspaceListQuerySchema.parse(input);
-    const params = new URLSearchParams(Object.entries(query).filter(([, value]) => value !== void 0).map(([key, value]) => [key, String(value)]));
-    const result = DatasetWorkspaceListSchema.parse(await this.request(`?${params}`, "GET", void 0, signal));
-    if (result.teamId !== this.options.teamId || result.datasets.length > query.limit || new Set(result.datasets.map((item) => item.id)).size !== result.datasets.length) throw new Error("Dataset list workspace/page mismatch.");
+    const params = new URLSearchParams(
+      Object.entries(query).filter(([, value]) => value !== void 0).map(([key, value]) => [key, String(value)])
+    );
+    const result = DatasetWorkspaceListSchema.parse(
+      await this.request(`?${params}`, "GET", void 0, signal)
+    );
+    if (result.teamId !== this.options.teamId || result.datasets.length > query.limit || new Set(result.datasets.map((item) => item.id)).size !== result.datasets.length)
+      throw new Error("Dataset list workspace/page mismatch.");
     return result;
   }
   async get(id, signal) {
-    return this.readback(await this.request(`/${encodeURIComponent(id)}`, "GET", void 0, signal), id);
+    return this.readback(
+      await this.request(`/${encodeURIComponent(id)}`, "GET", void 0, signal),
+      id
+    );
   }
   /** Recover only this actor's retained operation; base bytes allow adapters to
    * reconstruct and verify the identical original CAS request before replay. */
   async operationResult(operationId, options) {
     const kind = DatasetWorkspaceOperationKindSchema.parse(options.kind);
-    const params = new URLSearchParams({ kind, ...options.datasetId ? { datasetId: options.datasetId } : {} });
-    const raw = await this.request(`/operations/${encodeURIComponent(operationId)}?${params}`, "GET", void 0, options.signal, 132 * 1024 * 1024);
+    const params = new URLSearchParams({
+      kind,
+      ...options.datasetId ? { datasetId: options.datasetId } : {}
+    });
+    const raw = await this.request(
+      `/operations/${encodeURIComponent(operationId)}?${params}`,
+      "GET",
+      void 0,
+      options.signal,
+      132 * 1024 * 1024
+    );
     if (raw === null) return null;
     const value = DatasetWorkspaceOperationResultSchema.parse(raw);
     this.readback(value.receipt, value.receipt.datasetId);
     if (value.base) this.readback(value.base, value.receipt.datasetId);
-    if (value.operationId !== operationId || value.kind !== kind || options.datasetId && value.receipt.datasetId !== options.datasetId || options.requestHash && value.requestHash !== options.requestHash) throw new Error("Dataset operation recovery identity/request mismatch.");
+    if (value.operationId !== operationId || value.kind !== kind || options.datasetId && value.receipt.datasetId !== options.datasetId || options.requestHash && value.requestHash !== options.requestHash)
+      throw new Error("Dataset operation recovery identity/request mismatch.");
     return value;
   }
   async beginVersion(id, input, signal) {
     const request = DatasetWorkspaceBeginVersionSchema.parse(input);
-    const result = this.readback(await this.request(`/${encodeURIComponent(id)}/begin-version`, "POST", request, signal), id);
-    if (result.revision !== request.expectedRevision + 1 || result.workspace.draft.status !== "draft" || !result.publication || !result.workspace.draft.publishedTasksetRef) throw new Error("Editable version receipt mismatch.");
+    const result = this.readback(
+      await this.request(`/${encodeURIComponent(id)}/begin-version`, "POST", request, signal),
+      id
+    );
+    if (result.revision !== request.expectedRevision + 1 || result.workspace.draft.status !== "draft" || !result.publication || !result.workspace.draft.publishedTasksetRef)
+      throw new Error("Editable version receipt mismatch.");
     return result;
   }
   async versions(id, options = {}) {
-    const query = new URLSearchParams(options.beforeRevision === void 0 ? {} : { beforeRevision: String(options.beforeRevision) });
-    const result = DatasetWorkspaceVersionsSchema.parse(await this.request(`/${encodeURIComponent(id)}/versions?${query}`, "GET", void 0, options.signal));
-    if (result.teamId !== this.options.teamId || result.datasetId !== id || result.items.some((item, index) => index > 0 && item.workspaceRevision >= result.items[index - 1].workspaceRevision || options.beforeRevision !== void 0 && item.workspaceRevision >= options.beforeRevision)) throw new Error("Dataset version history scope/order mismatch.");
+    const query = new URLSearchParams(
+      options.beforeRevision === void 0 ? {} : { beforeRevision: String(options.beforeRevision) }
+    );
+    const result = DatasetWorkspaceVersionsSchema.parse(
+      await this.request(
+        `/${encodeURIComponent(id)}/versions?${query}`,
+        "GET",
+        void 0,
+        options.signal
+      )
+    );
+    if (result.teamId !== this.options.teamId || result.datasetId !== id || result.items.some(
+      (item, index) => index > 0 && item.workspaceRevision >= result.items[index - 1].workspaceRevision || options.beforeRevision !== void 0 && item.workspaceRevision >= options.beforeRevision
+    ))
+      throw new Error("Dataset version history scope/order mismatch.");
     return result;
   }
   async version(id, workspaceRevision, signal) {
-    const result = this.readback(await this.request(`/${encodeURIComponent(id)}/versions/${workspaceRevision}`, "GET", void 0, signal), id);
-    if (result.revision !== workspaceRevision || result.workspace.draft.status !== "published") throw new Error("Dataset immutable version mismatch.");
+    const result = this.readback(
+      await this.request(
+        `/${encodeURIComponent(id)}/versions/${workspaceRevision}`,
+        "GET",
+        void 0,
+        signal
+      ),
+      id
+    );
+    if (result.revision !== workspaceRevision || result.workspace.draft.status !== "published")
+      throw new Error("Dataset immutable version mismatch.");
     return result;
   }
   async save(input, signal) {
     const request = DatasetWorkspaceWriteSchema.parse(input);
     const workspace = validateTasksetDraftWorkspace(request.workspace);
-    if (workspace.draft.profileId !== this.options.teamId || workspace.draft.revision !== request.expectedRevision + 1) throw new Error("Dataset write scope or revision mismatch.");
-    const result = this.readback(await this.request(`/${encodeURIComponent(workspace.draft.id)}`, "PUT", request, signal), workspace.draft.id);
-    if (request.originProjectId && result.originProjectId !== request.originProjectId) throw new Error("Dataset origin Project mismatch.");
-    if (request.ownerScope && result.ownerScope !== request.ownerScope) throw new Error("Dataset owner scope mismatch.");
-    if (result.workspace.contentHash !== workspace.contentHash) throw new Error("Dataset write receipt differs from the saved bytes.");
+    if (workspace.draft.profileId !== this.options.teamId || workspace.draft.revision !== request.expectedRevision + 1)
+      throw new Error("Dataset write scope or revision mismatch.");
+    const result = this.readback(
+      await this.request(`/${encodeURIComponent(workspace.draft.id)}`, "PUT", request, signal),
+      workspace.draft.id
+    );
+    if (request.originProjectId && result.originProjectId !== request.originProjectId)
+      throw new Error("Dataset origin Project mismatch.");
+    if (request.ownerScope && result.ownerScope !== request.ownerScope)
+      throw new Error("Dataset owner scope mismatch.");
+    if (result.workspace.contentHash !== workspace.contentHash)
+      throw new Error("Dataset write receipt differs from the saved bytes.");
     return result;
   }
   async validate(id, expectedRevision, signal) {
-    const result = DatasetWorkspaceValidationSchema.parse(await this.request(`/${encodeURIComponent(id)}/validate`, "POST", { expectedRevision }, signal));
-    if (result.teamId !== this.options.teamId || result.datasetId !== id || result.revision !== expectedRevision) throw new Error("Dataset validation receipt mismatch.");
+    const result = DatasetWorkspaceValidationSchema.parse(
+      await this.request(
+        `/${encodeURIComponent(id)}/validate`,
+        "POST",
+        { expectedRevision },
+        signal
+      )
+    );
+    if (result.teamId !== this.options.teamId || result.datasetId !== id || result.revision !== expectedRevision)
+      throw new Error("Dataset validation receipt mismatch.");
     return result;
   }
   async publish(id, input, signal) {
     const request = DatasetWorkspacePublishSchema.parse(input);
-    const result = this.readback(await this.request(`/${encodeURIComponent(id)}/publish`, "POST", request, signal), id);
-    if (result.revision !== request.expectedRevision + 1 || result.workspace.draft.status !== "published" || result.publication?.packageHash !== request.packageHash) throw new Error("Dataset publication receipt mismatch.");
+    const result = this.readback(
+      await this.request(`/${encodeURIComponent(id)}/publish`, "POST", request, signal),
+      id
+    );
+    if (result.revision !== request.expectedRevision + 1 || result.workspace.draft.status !== "published" || result.publication?.packageHash !== request.packageHash)
+      throw new Error("Dataset publication receipt mismatch.");
     return result;
   }
   readback(value, id) {
     const result = DatasetWorkspaceReceiptSchema.parse(value);
     validateTasksetDraftWorkspace(result.workspace);
-    if (result.datasetId !== id || result.teamId !== this.options.teamId) throw new Error("Dataset identity mismatch.");
+    if (result.datasetId !== id || result.teamId !== this.options.teamId)
+      throw new Error("Dataset identity mismatch.");
     return result;
   }
   async request(path, method, body, signal, maxResponseBytes) {
-    const response = await (this.options.fetch ?? fetch)(`${this.baseUrl}/v1/dataset-workspaces${path}`, {
-      method,
-      signal,
-      redirect: "error",
-      headers: { Authorization: `Bearer ${this.options.apiKey}`, "X-OpenPond-Team-Id": this.options.teamId, "Content-Type": "application/json" },
-      ...body === void 0 ? {} : { body: JSON.stringify(body) }
-    });
+    const response = await (this.options.fetch ?? fetch)(
+      `${this.baseUrl}/v1/dataset-workspaces${path}`,
+      {
+        method,
+        signal,
+        redirect: "error",
+        headers: {
+          Authorization: `Bearer ${this.options.apiKey}`,
+          "X-OpenPond-Team-Id": this.options.teamId,
+          "Content-Type": "application/json"
+        },
+        ...body === void 0 ? {} : { body: JSON.stringify(body) }
+      }
+    );
     if (!response.ok) throw new Error(`Dataset request failed (${response.status}).`);
     if (maxResponseBytes !== void 0) {
       if (!response.body) throw new Error("Dataset response is empty.");
@@ -847,7 +929,8 @@ var OpenPondDatasetWorkspaceClient = class {
           const part = await reader.read();
           if (part.done) break;
           length += part.value.byteLength;
-          if (length > maxResponseBytes) throw new Error("Dataset recovery exceeds its bounded response.");
+          if (length > maxResponseBytes)
+            throw new Error("Dataset recovery exceeds its bounded response.");
           chunks.push(part.value);
         }
       } finally {
@@ -1360,6 +1443,10 @@ export {
   DatasetPreparationStageSchema,
   DatasetPreparationStatusSchema,
   DatasetPreparationTaskClassSchema,
+  DatasetTaskAppendReceiptSchema,
+  DatasetTaskAppendRequestSchema,
+  DatasetTaskIngestionError,
+  DatasetTaskInputSchema,
   DatasetWorkspaceBeginVersionSchema,
   DatasetWorkspaceListQuerySchema,
   DatasetWorkspaceListSchema,
@@ -1381,10 +1468,12 @@ export {
   PreparedTaskProvenanceSchema,
   PreparedTaskQualificationSchema,
   PreparedWitnessAdjudicationSchema,
+  addDatasetTask,
   assemblePreparedTaskWorkspaces,
   compileTasksetDraftWorkspace,
   connectedStartingAssetReference,
   createPreparedTaskAuthoringWorkspace,
+  createTaskAdder,
   parseConnectedStartingAssetReference,
   preparedRepositoryEnvironment,
   reconcilePreparationSourceCoverage