@warmhub/sdk-ts 0.73.0 → 0.75.0

package/dist/{chunk-GHJFQ6F7.js → chunk-QQTES2LQ.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":
@@ -6987,6 +6992,7 @@ var RE2JS = class RE2JS2 {
 // ../rules/src/shape-validation-types.ts
 var MAX_CONTENT_FIELD_BYTES = 64 * 1024;
 var MAX_INDEXABLE_SCALAR_FIELDS_PER_SHAPE = 256;
+var MAX_INDEXABLE_FIELD_PATH_BYTES = 256;
 var UNSUPPORTED_REGEX_SYNTAX_REASON = "uses unsupported regex syntax";
 var CONTENT_FIELD_LIMIT_ERROR = `WarmHub content fields are limited to ${MAX_CONTENT_FIELD_BYTES} bytes. WarmHub is not a document store; store large documents in S3, Box, Drive, or another document system and reference them from WarmHub instead.`;
 var textEncoder = new TextEncoder();
@@ -7777,6 +7783,12 @@ function validateShapeDefinition(data, options = {}) {
   const seenIndexableFieldPaths = /* @__PURE__ */ new Set();
   const duplicateIndexableFieldPaths = /* @__PURE__ */ new Set();
   for (const fieldPath of indexableFieldPaths) {
+    const pathBytes = utf8ByteLength(fieldPath);
+    if (pathBytes > MAX_INDEXABLE_FIELD_PATH_BYTES) {
+      errors.push(
+        `Indexable field path "${escapeFieldNameForDisplay(fieldPath)}" is ${pathBytes} bytes; maximum is ${MAX_INDEXABLE_FIELD_PATH_BYTES}`
+      );
+    }
     const foldedPath = foldFieldPath(fieldPath);
     if (seenIndexableFieldPaths.has(foldedPath)) {
       duplicateIndexableFieldPaths.add(foldedPath);
@@ -7876,7 +7888,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 +7940,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)) {
@@ -8092,6 +8110,12 @@ var PartialStreamSubmissionError = class extends Error {
    * repository state before retrying manually.
    */
   completedOperations;
+  /**
+   * Number of operations covered by append responses the SDK received before
+   * the failure. This can exceed `completedOperations.length` when the backend
+   * returns sparse or empty result rows.
+   */
+  acknowledgedOperationCount;
   /**
    * Underlying error that triggered the partial submission, preserved for
    * diagnostics. Inspect via `isWarmHubError(err.cause)` / `err.cause.kind`.
@@ -8104,6 +8128,7 @@ var PartialStreamSubmissionError = class extends Error {
     this.name = "WarmHubError";
     this.cause = input.cause;
     this.completedOperations = input.completedOperations;
+    this.acknowledgedOperationCount = input.acknowledgedOperationCount ?? input.completedOperations.length;
   }
 };
 var AllStreamOperationsFailedError = class extends Error {
@@ -8297,7 +8322,9 @@ async function submitOperationsViaStream(client, args) {
   const policy = args.streamId !== void 0 ? false : resolveRetryPolicy(args.retry);
   let allocatedTokenRanges = [];
   let createdByEmail;
+  let repoSeq;
   const chunkResults = [];
+  let acknowledgedOperationCount = 0;
   let sawAmbiguousAttempt = false;
   for (const { operations: chunk, start: chunkStart } of chunkOperations(
     operations,
@@ -8316,21 +8343,26 @@ 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)
         );
+        acknowledgedOperationCount += chunk.length;
         break;
       } catch (cause) {
-        if (chunkResults.length === 0 && !priorAttemptAmbiguous && isDefiniteClientError(cause)) {
+        if (acknowledgedOperationCount === 0 && !priorAttemptAmbiguous && isDefiniteClientError(cause)) {
           throw cause;
         }
-        if (chunkResults.length === 0 && chunkIsAtomic && policy !== false && attempt < policy.maxAttempts && isTransientStreamFailure(cause)) {
+        if (acknowledgedOperationCount === 0 && chunkIsAtomic && policy !== false && attempt < policy.maxAttempts && isTransientStreamFailure(cause)) {
           await sleep(computeBackoffDelayMs(attempt, policy));
           attempt += 1;
           priorAttemptAmbiguous = true;
@@ -8346,6 +8378,7 @@ async function submitOperationsViaStream(client, args) {
             },
             args.committer,
             createdByEmail,
+            repoSeq,
             args.message,
             chunkResults,
             operations
@@ -8353,7 +8386,8 @@ async function submitOperationsViaStream(client, args) {
         );
         throw new PartialStreamSubmissionError({
           cause,
-          completedOperations
+          completedOperations,
+          acknowledgedOperationCount
         });
       }
     }
@@ -8364,6 +8398,7 @@ async function submitOperationsViaStream(client, args) {
     },
     args.committer,
     createdByEmail,
+    repoSeq,
     args.message,
     chunkResults,
     operations
@@ -8373,7 +8408,8 @@ async function submitOperationsViaStream(client, args) {
     if (sawAmbiguousAttempt) {
       throw new PartialStreamSubmissionError({
         cause: failure,
-        completedOperations: completedOperationsFrom(result)
+        completedOperations: completedOperationsFrom(result),
+        acknowledgedOperationCount
       });
     }
     throw failure;
@@ -8442,16 +8478,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 +8504,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([
@@ -9158,13 +9222,14 @@ var OperationBuilder = class {
   /**
    * Validate, submit, and seal the builder.
    *
-   * A successful call submits operations through the same stream path as `client.commit.apply` and makes the builder single-use. Validation failures throw before any server request is made. Ambiguous multi-chunk failures surface as `PartialStreamSubmissionError`; deterministic all-failed batches surface as `AllStreamOperationsFailedError` with per-op failure data.
+   * A successful call submits operations through the same stream path as `client.commit.apply` and makes the builder single-use. A `PartialStreamSubmissionError` also seals the builder to prevent blind replay. Validation failures throw before any server request is made. Deterministic all-failed batches surface as `AllStreamOperationsFailedError` with per-op failure data.
    *
    * @param params.client WarmHub client or compatible stream client used for submission.
    * @param params.message Optional commit message.
    * @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,11 +9252,17 @@ var OperationBuilder = class {
         message: params.message,
         chunkSize: params.chunkSize,
         streamId: params.streamId,
+        returnRepoSeq: params.returnRepoSeq,
         retry: params.retry,
         operations
       });
       this.submitted = true;
       return result;
+    } catch (error) {
+      if (error instanceof PartialStreamSubmissionError) {
+        this.submitted = true;
+      }
+      throw error;
     } finally {
       this.inFlight = false;
     }
@@ -9239,7 +9310,7 @@ function validateWarmHubClientOptions(options) {
     throw new TypeError(`Unknown WarmHubClient option "${key}"${hint}`);
   }
 }
-var SDK_VERSION = "0.73.0" ;
+var SDK_VERSION = "0.75.0" ;
 var DEFAULT_API_URL = "https://api.warmhub.ai";
 var UNBATCHED_TRPC_PATHS = /* @__PURE__ */ new Set([
   "repo.shapeInstanceCounts",
@@ -9371,7 +9442,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 +10153,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 +10170,7 @@ var WarmHubClient = class _WarmHubClient {
           chunkSize: opts?.chunkSize,
           skipExisting: opts?.skipExisting,
           streamId: opts?.streamId,
+          returnRepoSeq: opts?.returnRepoSeq,
           retry: opts?.retry,
           operations
         });
@@ -11871,6 +11947,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 +12017,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 +12883,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-GHJFQ6F7.js.map
-//# sourceMappingURL=chunk-GHJFQ6F7.js.map
+//# sourceMappingURL=chunk-QQTES2LQ.js.map
+//# sourceMappingURL=chunk-QQTES2LQ.js.map