@warmhub/sdk-ts 0.83.0 → 0.84.0

package/dist/{chunk-6AHGGJL6.js → chunk-CLDVXOJD.js}

@@ -56,6 +56,12 @@ var DEFAULT_STREAM_APPEND_CHUNK_SIZE = 1e3;
 var MAX_STREAM_APPEND_OPERATION_COUNT = 1e4;
 
 // ../rules/src/commit-types.ts
+var COMMIT_OPERATION_KINDS = [
+  "shape",
+  "thing",
+  "assertion",
+  "collection"
+];
 function splitLocalPath(name) {
   const idx = name.indexOf("/");
   if (idx === -1) return null;
@@ -7897,9 +7903,9 @@ function normalizeOptionalName(value) {
 
 // src/operation-normalize.ts
 function toBackendStreamOperation(operation) {
-  if (operation.expectedVersion !== void 0 && operation.operation !== "revise") {
+  if (operation.expectedVersion !== void 0 && operation.operation !== "revise" && operation.operation !== "retract") {
     throw new Error(
-      "expectedVersion is only valid on revise operations \u2014 set operation: 'revise'"
+      "expectedVersion is only valid on revise or retract operations \u2014 set an explicit operation discriminator"
     );
   }
   if (operation.operation === "retract") {
@@ -7908,6 +7914,7 @@ function toBackendStreamOperation(operation) {
       name: operation.name,
       ...operation.kind ? { kind: operation.kind } : {},
       ...operation.reason ? { reason: operation.reason } : {},
+      ...operation.expectedVersion !== void 0 ? { expectedVersion: operation.expectedVersion } : {},
       ...operation.leaseId ? { leaseId: operation.leaseId } : {}
     };
   }
@@ -8012,8 +8019,8 @@ var PartialStreamSubmissionError = class extends Error {
   code = "PARTIAL_STREAM_SUBMISSION";
   /**
    * Operations the SDK confirmed completed before the ambiguous or failing
-   * append. The remaining operations may or may not have landed; inspect
-   * repository state before retrying manually.
+   * append. The attempted append may or may not have landed; do not blindly
+   * replay it.
    */
   completedOperations;
   /**
@@ -8022,19 +8029,36 @@ var PartialStreamSubmissionError = class extends Error {
    * returns sparse or empty result rows.
    */
   acknowledgedOperationCount;
+  /**
+   * Last repository sequence returned by an acknowledged chunk that persisted
+   * an event. This is a lower bound for known completed work, never evidence
+   * that the attempted append did not land.
+   */
+  lastAcknowledgedRepoSeq;
+  /**
+   * Authoritative outcome of the attempted append. `not_applied` is used only
+   * when the SDK received explicit server rejection evidence; `unknown` means
+   * callers must stop writes and reconcile from a later verified checkpoint.
+   */
+  attemptedAppendOutcome;
   /**
    * Underlying error that triggered the partial submission, preserved for
-   * diagnostics. Inspect via `isWarmHubError(err.cause)` / `err.cause.kind`.
+   * diagnostics. Do not infer append outcome from this field; branch on
+   * `attemptedAppendOutcome` instead.
    */
   cause;
   constructor(input) {
     super(
-      "Stream submission failed. A timed-out append may already have landed, so inspect repository state before sending any further operations."
+      "Stream submission outcome is incomplete or unknown. Stop sending writes; once any outstanding append can no longer apply, obtain a later verified checkpoint and reconcile before replanning."
     );
     this.name = "WarmHubError";
     this.cause = input.cause;
     this.completedOperations = input.completedOperations;
     this.acknowledgedOperationCount = input.acknowledgedOperationCount ?? input.completedOperations.length;
+    this.attemptedAppendOutcome = input.attemptedAppendOutcome;
+    if (input.lastAcknowledgedRepoSeq !== void 0) {
+      this.lastAcknowledgedRepoSeq = input.lastAcknowledgedRepoSeq;
+    }
   }
 };
 var AllStreamOperationsFailedError = class extends Error {
@@ -8189,6 +8213,9 @@ function isTransientStreamFailure(cause) {
 function isFetchNetworkTypeError(cause) {
   return cause instanceof TypeError && /fetch/i.test(cause.message);
 }
+function isReplaySafeOperation(operation) {
+  return operation.operation !== "revise" || operation.expectedVersion !== void 0;
+}
 function computeBackoffDelayMs(attempt, policy) {
   const exponential = policy.baseDelayMs * 2 ** Math.max(0, attempt - 1);
   const jitter = Math.random() * policy.baseDelayMs;
@@ -8245,7 +8272,8 @@ async function submitOperationsViaStream(client, args) {
   )) {
     let attempt = 1;
     let priorAttemptAmbiguous = false;
-    const chunkIsAtomic = chunk.length === 1;
+    const chunkIsSingleOperation = chunk.length === 1;
+    const chunkIsReplaySafe = chunk.every(isReplaySafeOperation);
     while (true) {
       try {
         const appendResult = await client.stream.append({
@@ -8275,7 +8303,7 @@ async function submitOperationsViaStream(client, args) {
         if (acknowledgedOperationCount === 0 && !priorAttemptAmbiguous && isDefiniteClientError(cause)) {
           throw cause;
         }
-        if (acknowledgedOperationCount === 0 && chunkIsAtomic && policy !== false && attempt < policy.maxAttempts && isTransientStreamFailure(cause)) {
+        if (acknowledgedOperationCount === 0 && chunkIsSingleOperation && chunkIsReplaySafe && policy !== false && attempt < policy.maxAttempts && isTransientStreamFailure(cause)) {
           await sleep(computeBackoffDelayMs(attempt, policy));
           attempt += 1;
           priorAttemptAmbiguous = true;
@@ -8300,7 +8328,9 @@ async function submitOperationsViaStream(client, args) {
         throw new PartialStreamSubmissionError({
           cause,
           completedOperations,
-          acknowledgedOperationCount
+          acknowledgedOperationCount,
+          lastAcknowledgedRepoSeq: repoSeq,
+          attemptedAppendOutcome: !priorAttemptAmbiguous && isDefiniteClientError(cause) ? "not_applied" : "unknown"
         });
       }
     }
@@ -8322,7 +8352,9 @@ async function submitOperationsViaStream(client, args) {
       throw new PartialStreamSubmissionError({
         cause: failure,
         completedOperations: completedOperationsFrom(result),
-        acknowledgedOperationCount
+        acknowledgedOperationCount,
+        lastAcknowledgedRepoSeq: repoSeq,
+        attemptedAppendOutcome: "unknown"
       });
     }
     throw failure;
@@ -8449,7 +8481,7 @@ var SDK_DEVELOPMENT_VERSION = "0.0.0-development";
 function sdkVersionIsDevelopment(version) {
   return version === SDK_DEVELOPMENT_VERSION;
 }
-var SDK_VERSION = "0.83.0" ;
+var SDK_VERSION = "0.84.0" ;
 
 // src/component-cli.ts
 var SUPPORTED_METHODS = /* @__PURE__ */ new Set([
@@ -8689,13 +8721,7 @@ function normalizeReviseKind(op, name) {
 }
 function toBackendOp(op) {
   if (op.operation === "retract") {
-    return {
-      operation: "retract",
-      name: op.name,
-      ...op.kind ? { kind: op.kind } : {},
-      ...op.reason ? { reason: op.reason } : {},
-      ...op.leaseId ? { leaseId: op.leaseId } : {}
-    };
+    return toBackendStreamOperation(op);
   }
   if (op.operation === "add") {
     const kind2 = normalizeAddKind(op);
@@ -8948,7 +8974,8 @@ var OperationBuilder = class {
   /**
    * Add a retract operation.
    *
-   * Pass a wref string shorthand or an object with a target name, optional kind safety hint, and optional reason.
+   * Pass a wref string shorthand or an object with retract options such as a
+   * kind safety hint, reason, expected version, or lease ID.
    */
   retract(target) {
     this.assertCanModify();
@@ -8957,6 +8984,7 @@ var OperationBuilder = class {
       name: target.name,
       ...target.kind ? { kind: target.kind } : {},
       ...target.reason ? { reason: target.reason } : {},
+      ...target.expectedVersion !== void 0 ? { expectedVersion: target.expectedVersion } : {},
       ...target.leaseId ? { leaseId: target.leaseId } : {}
     });
     this.ops.push(op);
@@ -9364,6 +9392,9 @@ function chunkArray(items, chunkSize) {
   }
   return chunks;
 }
+function narrowKind(kind) {
+  return kind !== void 0 && COMMIT_OPERATION_KINDS.includes(kind) ? kind : void 0;
+}
 function toSubscriptionRef(args) {
   const [first, repoName, name] = args;
   return typeof first === "string" ? { orgName: first, repoName, name } : first;
@@ -11577,6 +11608,7 @@ var WarmHubClient = class _WarmHubClient {
         return await this.trpc.action.listRuns.query({
           orgName,
           repoName,
+          runId: opts?.runId,
           subscriptionName: opts?.subscriptionName,
           status: opts?.status,
           outcome: opts?.outcome,
@@ -11881,12 +11913,11 @@ var WarmHubClient = class _WarmHubClient {
      */
     head: async (orgName, repoName, opts) => {
       try {
-        const kind = opts?.kind === "shape" || opts?.kind === "thing" || opts?.kind === "assertion" || opts?.kind === "collection" ? opts.kind : void 0;
         return await this.trpc.thing.head.query({
           orgName,
           repoName,
           shape: opts?.shape,
-          kind,
+          kind: narrowKind(opts?.kind),
           match: opts?.match,
           dataMode: opts?.dataMode,
           includeRetracted: opts?.includeRetracted,
@@ -12345,13 +12376,12 @@ var WarmHubClient = class _WarmHubClient {
      */
     query: async (orgName, repoName, opts) => {
       try {
-        const kind = opts?.kind === "shape" || opts?.kind === "thing" || opts?.kind === "assertion" || opts?.kind === "collection" ? opts.kind : void 0;
         return await this.trpc.thing.query.query({
           orgName,
           repoName,
           shape: opts?.shape,
           about: opts?.about,
-          kind,
+          kind: narrowKind(opts?.kind),
           match: opts?.match,
           includeRetracted: opts?.includeRetracted,
           resolveCollections: opts?.resolveCollections,
@@ -12439,14 +12469,13 @@ var WarmHubClient = class _WarmHubClient {
      */
     search: async (orgName, repoName, query, opts) => {
       try {
-        const kind = opts?.kind === "shape" || opts?.kind === "thing" || opts?.kind === "assertion" || opts?.kind === "collection" ? opts.kind : void 0;
         return await this.trpc.thing.search.query({
           orgName,
           repoName,
           query,
           shape: opts?.shape,
           about: opts?.about,
-          kind,
+          kind: narrowKind(opts?.kind),
           match: opts?.match,
           includeRetracted: opts?.includeRetracted,
           resolveCollections: opts?.resolveCollections,
@@ -12496,13 +12525,12 @@ var WarmHubClient = class _WarmHubClient {
      */
     count: async (orgName, repoName, opts) => {
       try {
-        const kind = opts?.kind === "shape" || opts?.kind === "thing" || opts?.kind === "assertion" || opts?.kind === "collection" ? opts.kind : void 0;
         return await this.trpc.thing.count.query({
           orgName,
           repoName,
           shape: opts?.shape,
           about: opts?.about,
-          kind,
+          kind: narrowKind(opts?.kind),
           match: opts?.match,
           includeRetracted: opts?.includeRetracted,
           resolveCollections: opts?.resolveCollections,
@@ -13272,5 +13300,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-6AHGGJL6.js.map
-//# sourceMappingURL=chunk-6AHGGJL6.js.map
+//# sourceMappingURL=chunk-CLDVXOJD.js.map
+//# sourceMappingURL=chunk-CLDVXOJD.js.map