@warmhub/sdk-ts 0.72.0 → 0.74.0

package/dist/{chunk-E3PWTUOS.js → chunk-AFP7ZGMR.js}

@@ -385,10 +385,11 @@ function illegalOpSequences(operations, errors, checkAddAdd) {
 }
 
 // ../rules/src/preflight-operation.ts
-var collectionTypes = ["pair", "set", "list"];
+var collectionTypes = ["arc", "bond", "set", "list", "pair"];
+var canonicalCollectionTypes = ["arc", "bond", "set", "list"];
 var collectionOps = ["add", "revise"];
 var COLLECTION_CREATE_REQUIRES_NAME_MESSAGE = "Collection create requires a name. Collections are ordinary named things (ADR 0004).";
-var COLLECTION_ABOUT_REMOVED_MESSAGE = 'about accepts a wref. Create the collection as its own named operation, then point the assertion at it. Prefer deterministic relationship names, for example: [{"operation":"add","kind":"collection","type":"pair","name":"a-b-relationship","members":["A","B"]},{"operation":"add","kind":"assertion","about":"Pair/a-b-relationship","name":"Assertion/example","data":{}}]. For CLI usage, use wh commit submit --file with the two operations.';
+var COLLECTION_ABOUT_REMOVED_MESSAGE = 'about accepts a wref. Create the collection as its own named operation, then point the assertion at it. Prefer deterministic relationship names, for example: [{"operation":"add","kind":"collection","type":"arc","name":"a-to-b","members":["A","B"]},{"operation":"add","kind":"assertion","about":"Arc/a-to-b","name":"Assertion/example","data":{}}]. For CLI usage, use wh commit submit --file with the two operations.';
 function preflightOpDiagnostics(op, operationIndex) {
   const errors = [];
   errors.push(...builtinShapeGuard(op, operationIndex));
@@ -529,7 +530,7 @@ function validateCollectionOps(op, operationIndex) {
     errors.push({
       code: "VALIDATION_ERROR",
       operationIndex,
-      message: `Collection "type" must be one of: pair, set, list. Got: "${op.type ?? ""}"`
+      message: `Collection "type" is invalid. Use one of: ${canonicalCollectionTypes.join(", ")}. Got: "${op.type ?? ""}"`
     });
   }
   if (!op.members || !Array.isArray(op.members)) {
@@ -566,6 +567,10 @@ function validateCollectionOps(op, operationIndex) {
 }
 function collectionArityError(tag, members) {
   switch (tag) {
+    case "arc":
+      return members.length !== 2 ? `Arc requires exactly 2 members, got ${members.length}` : null;
+    case "bond":
+      return members.length !== 2 ? `Bond requires exactly 2 members, got ${members.length}` : null;
     case "pair":
       return members.length !== 2 ? `Pair requires exactly 2 members, got ${members.length}` : null;
     case "set":
@@ -7876,7 +7881,13 @@ function shapeDefinitionPreflightError(name, data, verb) {
 }
 
 // src/collection-operation-normalize.ts
-var collectionTypes2 = /* @__PURE__ */ new Set(["pair", "set", "list"]);
+var collectionTypes2 = /* @__PURE__ */ new Set([
+  "arc",
+  "bond",
+  "pair",
+  "set",
+  "list"
+]);
 function normalizeBackendCollectionAdd(operation, source) {
   const normalized = normalizeCollectionWrite(operation, source, "add");
   return {
@@ -7922,7 +7933,7 @@ function normalizeCollectionWrite(operation, source, writeOperation) {
   const type = normalizeCollectionType(operation.type);
   if (!type) {
     throw new Error(
-      `${source}: collection ${writeOperation} requires 'type' to be one of: pair, set, list`
+      `${source}: collection ${writeOperation} requires 'type'. Use one of: arc, bond, set, list`
     );
   }
   if (!Array.isArray(operation.members)) {
@@ -8297,6 +8308,7 @@ async function submitOperationsViaStream(client, args) {
   const policy = args.streamId !== void 0 ? false : resolveRetryPolicy(args.retry);
   let allocatedTokenRanges = [];
   let createdByEmail;
+  let repoSeq;
   const chunkResults = [];
   let sawAmbiguousAttempt = false;
   for (const { operations: chunk, start: chunkStart } of chunkOperations(
@@ -8316,12 +8328,16 @@ async function submitOperationsViaStream(client, args) {
           componentRef: args.componentRef,
           committer: args.committer,
           message: args.message,
+          ...args.returnRepoSeq !== void 0 ? { returnRepoSeq: args.returnRepoSeq } : {},
           operations: chunk
         });
         allocatedTokenRanges = appendResult.allocatedTokenRanges;
         if (appendResult.createdByEmail !== void 0) {
           createdByEmail = appendResult.createdByEmail;
         }
+        if (appendResult.repoSeq !== void 0) {
+          repoSeq = appendResult.repoSeq;
+        }
         chunkResults.push(
           ...offsetChunkResultIndexes(appendResult.results, chunkStart)
         );
@@ -8346,6 +8362,7 @@ async function submitOperationsViaStream(client, args) {
             },
             args.committer,
             createdByEmail,
+            repoSeq,
             args.message,
             chunkResults,
             operations
@@ -8364,6 +8381,7 @@ async function submitOperationsViaStream(client, args) {
     },
     args.committer,
     createdByEmail,
+    repoSeq,
     args.message,
     chunkResults,
     operations
@@ -8442,16 +8460,18 @@ function offsetChunkResultIndexes(results, chunkStart) {
     opIndex: chunkStart + (result.opIndex ?? index)
   }));
 }
-function toSubmittedStreamResult(writeResult, committer, createdByEmail, message, results, operations) {
+function toSubmittedStreamResult(writeResult, committer, createdByEmail, repoSeq, message, results, operations) {
   const statusCounts = countStreamAppendResultStatuses(results);
   const partial = statusCounts.error > 0;
+  const dedupedResults = dedupeDeprecationsByShape(results);
   return {
     committer,
     ...createdByEmail !== void 0 ? { createdByEmail } : {},
     message,
     operationCount: writeResult.operationCount,
+    ...repoSeq !== void 0 ? { repoSeq } : {},
     ...partial ? { partial, statusCounts } : {},
-    operations: results.map((result) => ({
+    operations: dedupedResults.map((result) => ({
       ...result.opIndex !== void 0 ? { opIndex: result.opIndex } : {},
       name: result.name ?? "",
       operation: result.operation === "revise" || result.operation === "retract" || result.operation === "rename" || result.operation === "noop" ? result.operation : "add",
@@ -8466,6 +8486,32 @@ function toSubmittedStreamResult(writeResult, committer, createdByEmail, message
     }))
   };
 }
+function dedupeDeprecationsByShape(results) {
+  if (!results.some(
+    (result) => result.status !== "failed" && result.warnings?.deprecations?.length
+  )) {
+    return results;
+  }
+  const seenShapes = /* @__PURE__ */ new Set();
+  let deduped;
+  for (const [index, result] of results.entries()) {
+    if (result.status === "failed") continue;
+    const operationWarnings = result.warnings;
+    const deprecations = operationWarnings?.deprecations;
+    if (!deprecations) continue;
+    const retained = deprecations.filter((warning) => {
+      if (seenShapes.has(warning.shape)) return false;
+      seenShapes.add(warning.shape);
+      return true;
+    });
+    if (retained.length === deprecations.length) continue;
+    const { deprecations: _deprecations, ...otherWarnings } = operationWarnings;
+    const warnings = retained.length > 0 ? { ...otherWarnings, deprecations: retained } : Object.keys(otherWarnings).length > 0 ? otherWarnings : void 0;
+    deduped ??= [...results];
+    deduped[index] = { ...result, warnings };
+  }
+  return deduped ?? results;
+}
 
 // src/component-cli.ts
 var SUPPORTED_METHODS = /* @__PURE__ */ new Set([
@@ -9165,6 +9211,7 @@ var OperationBuilder = class {
    * @param params.committer Optional wref identifying the actor on whose behalf the write is made.
    * @param params.chunkSize Maximum operations per stream append.
    * @param params.streamId Advanced continuation hook for caller-managed streams.
+   * @param params.returnRepoSeq Return the writer's own repository-sequence acknowledgement.
    * @param params.retry Retry policy for transient first-chunk failures, or `false` to disable automatic retry.
    */
   async commit(params) {
@@ -9187,6 +9234,7 @@ var OperationBuilder = class {
         message: params.message,
         chunkSize: params.chunkSize,
         streamId: params.streamId,
+        returnRepoSeq: params.returnRepoSeq,
         retry: params.retry,
         operations
       });
@@ -9239,7 +9287,7 @@ function validateWarmHubClientOptions(options) {
     throw new TypeError(`Unknown WarmHubClient option "${key}"${hint}`);
   }
 }
-var SDK_VERSION = "0.72.0" ;
+var SDK_VERSION = "0.74.0" ;
 var DEFAULT_API_URL = "https://api.warmhub.ai";
 var UNBATCHED_TRPC_PATHS = /* @__PURE__ */ new Set([
   "repo.shapeInstanceCounts",
@@ -9371,7 +9419,7 @@ function hasExplicitCollectionMembers(opts) {
 function collectionTypeFromWref(wref) {
   const local = wref.replace(/^wh:[^/]+\/[^/]+\//, "").replace(/@(?:HEAD|ALL|v\d+)$/, "");
   const shape = local.split("/")[0]?.toLowerCase();
-  return shape === "pair" || shape === "set" || shape === "list" ? shape : void 0;
+  return shape === "arc" || shape === "bond" || shape === "pair" || shape === "set" || shape === "list" ? shape : void 0;
 }
 function assertSelectorBackedCollectionType(type, opts) {
   if (hasCollectionQuerySource(opts.query) && !hasCollectionSelectorAnchor(opts.query)) {
@@ -10082,6 +10130,10 @@ var WarmHubClient = class _WarmHubClient {
      * @param opts.chunkSize Maximum operations per stream append. Values are clamped by the SDK.
      * @param opts.skipExisting Return `noop` for add operations whose target already exists.
      * @param opts.streamId Advanced continuation hook for caller-managed streams.
+     * @param opts.returnRepoSeq Return the sequence allocated to the writer's
+     * own commit acknowledgement. This does not disclose a reader-facing
+     * repository head. Multi-chunk submissions return the last sequence
+     * actually allocated; a later no-op or failed chunk does not erase it.
      * @param opts.retry Retry policy for transient first-chunk failures, or `false` to disable automatic retry.
      */
     apply: async (orgName, repoName, message, operations, opts) => {
@@ -10095,6 +10147,7 @@ var WarmHubClient = class _WarmHubClient {
           chunkSize: opts?.chunkSize,
           skipExisting: opts?.skipExisting,
           streamId: opts?.streamId,
+          returnRepoSeq: opts?.returnRepoSeq,
           retry: opts?.retry,
           operations
         });
@@ -11871,6 +11924,7 @@ var WarmHubClient = class _WarmHubClient {
           includeRetracted: opts?.includeRetracted,
           depth: opts?.depth,
           resolveCollections: opts?.resolveCollections,
+          role: opts?.role,
           limit: opts?.limit,
           cursor: opts?.cursor,
           where: opts?.where
@@ -11940,6 +11994,7 @@ var WarmHubClient = class _WarmHubClient {
           match: opts?.match,
           includeRetracted: opts?.includeRetracted,
           resolveCollections: opts?.resolveCollections,
+          role: opts?.role,
           limit: opts?.limit,
           cursor: opts?.cursor,
           componentRef: opts?.componentRef,
@@ -12805,5 +12860,5 @@ re2js/build/index.js:
 */
 
 export { AllStreamOperationsFailedError, CLI_INSTALL_REPO_HEADER, CLI_SIGNATURE_HEADER, CLI_TIMESTAMP_HEADER, CONTENT_FIELD_LIMIT_ERROR, CliCallVerificationError, DEFAULT_API_URL, DEFAULT_STREAM_CHUNK_SIZE, MAX_CONTENT_FIELD_BYTES, MAX_STREAM_APPEND_OPERATION_COUNT2 as MAX_STREAM_APPEND_OPERATION_COUNT, OperationBuilder, PartialStreamSubmissionError, SDK_VERSION, WarmHubClient, WarmHubError, connectionErrorMessage, contentFieldLimitError, countStreamAppendResultStatuses, isConnectionError, isRetryable, isWarmHubError, normalizeWref, resolveFunctionLogMode, sanitizeErrorMessage, sdkVersionIsBelowMinimum, streamAppendResultStatus, submitOperationsViaStream, toWarmHubError, validateAgainstShape, verifyCliCall };
-//# sourceMappingURL=chunk-E3PWTUOS.js.map
-//# sourceMappingURL=chunk-E3PWTUOS.js.map
+//# sourceMappingURL=chunk-AFP7ZGMR.js.map
+//# sourceMappingURL=chunk-AFP7ZGMR.js.map