@warmhub/sdk-ts 0.47.0 → 0.49.0

package/dist/{chunk-E32PSLWS.js → chunk-CVMYSRPS.js}

@@ -604,16 +604,28 @@ function illegalOpSequences(operations, errors, checkAddAdd) {
 }
 
 // ../rules/src/reserved-orgs.ts
+var RESERVED_RAW_CONTENT_TOP_LEVEL_NAMES = [
+  "_app",
+  "_static",
+  "api",
+  "health",
+  "healthz",
+  "mcp",
+  "readyz",
+  "robots.txt",
+  "sse",
+  "trpc",
+  "version"
+];
 var RESERVED_ORG_NAMES = [
+  ...RESERVED_RAW_CONTENT_TOP_LEVEL_NAMES,
   "admin",
-  "api",
   "billing",
   "blog",
   "docs",
   "help",
   "login",
   "public",
-  "robots.txt",
   "settings",
   "signup",
   "status",
@@ -624,6 +636,15 @@ var RESERVED_ORG_NAMES = [
 ];
 new Set(RESERVED_ORG_NAMES);
 
+// ../rules/src/shape-field-key.ts
+function foldFieldName(name) {
+  const stripped = name.endsWith("?") ? name.slice(0, -1) : name;
+  return stripped.toLowerCase();
+}
+function foldFieldPath(path) {
+  return path.split(".").map((segment) => foldFieldName(segment)).join(".");
+}
+
 // ../rules/src/shape-types.ts
 var BASE_PRIMITIVE_TYPES = [
   "number",
@@ -1006,6 +1027,37 @@ function collectIndexableShapeFieldPaths(fields, prefix = "") {
   }
   return paths;
 }
+function isNestedFieldsRecord(value) {
+  if (!isPlainObject(value) || Array.isArray(value)) return false;
+  if (isTypeSpecObject(value)) return false;
+  if ("type" in value && typeof value.type === "string" && VALID_PRIMITIVE_TYPES.has(value.type) && Object.keys(value).every((k) => VALID_TYPESPEC_KEYS.has(k))) {
+    return false;
+  }
+  return true;
+}
+function validateFieldsRecord(fields, prefix, errors) {
+  const seenDisplayByFolded = /* @__PURE__ */ new Map();
+  for (const [key, value] of Object.entries(fields)) {
+    const folded = foldFieldName(key);
+    const prior = seenDisplayByFolded.get(folded);
+    if (prior !== void 0) {
+      errors.push(
+        `${prefix}.${key}: duplicate field name. Shape already declares "${prior}" (case-insensitive match).`
+      );
+      continue;
+    }
+    seenDisplayByFolded.set(folded, key);
+    if (isNestedFieldsRecord(value)) {
+      validateFieldsRecord(
+        value,
+        `${prefix}.${key}`,
+        errors
+      );
+    } else {
+      validateTypeSpec(`${prefix}.${key}`, value, errors);
+    }
+  }
+}
 function validateShapeDefinition(data) {
   if (typeof data !== "object" || data === null || Array.isArray(data)) {
     return { valid: false, errors: ["Shape definition must be a plain object"] };
@@ -1030,11 +1082,7 @@ function validateShapeDefinition(data) {
       errors: ['"fields" must be a plain object mapping field names to types']
     };
   }
-  for (const [key, value] of Object.entries(
-    fields
-  )) {
-    validateTypeSpec(`fields.${key}`, value, errors);
-  }
+  validateFieldsRecord(fields, "fields", errors);
   const indexableFieldPaths = collectIndexableShapeFieldPaths(
     fields
   );
@@ -1042,15 +1090,16 @@ function validateShapeDefinition(data) {
   const seenIndexableFieldPaths = /* @__PURE__ */ new Set();
   const duplicateIndexableFieldPaths = /* @__PURE__ */ new Set();
   for (const fieldPath of indexableFieldPaths) {
-    if (seenIndexableFieldPaths.has(fieldPath)) {
-      duplicateIndexableFieldPaths.add(fieldPath);
+    const foldedPath = foldFieldPath(fieldPath);
+    if (seenIndexableFieldPaths.has(foldedPath)) {
+      duplicateIndexableFieldPaths.add(foldedPath);
       continue;
     }
-    seenIndexableFieldPaths.add(fieldPath);
+    seenIndexableFieldPaths.add(foldedPath);
   }
   for (const fieldPath of duplicateIndexableFieldPaths) {
     errors.push(
-      `Shape declares ambiguous indexable field path "${fieldPath}"; dotted field names and optional-key suffixes must not collide with another indexable path`
+      `Shape declares ambiguous indexable field path "${fieldPath}"; dotted field names, optional-key suffixes, and case-insensitive folded paths must not collide with another indexable path`
     );
   }
   if (indexableFieldCount > MAX_INDEXABLE_SCALAR_FIELDS_PER_SHAPE) {
@@ -1445,12 +1494,18 @@ new Set(
 
 // src/operation-normalize.ts
 function toBackendStreamOperation(operation) {
+  if (operation.expectedVersion !== void 0 && operation.operation !== "revise") {
+    throw new Error(
+      "expectedVersion is only valid on revise operations \u2014 set operation: 'revise'"
+    );
+  }
   if (operation.operation === "retract") {
     return {
       operation: "retract",
       name: operation.name,
       ...operation.kind ? { kind: operation.kind } : {},
-      ...operation.reason ? { reason: operation.reason } : {}
+      ...operation.reason ? { reason: operation.reason } : {},
+      ...operation.leaseId ? { leaseId: operation.leaseId } : {}
     };
   }
   if (operation.operation === "revise") {
@@ -1477,14 +1532,18 @@ function toBackendStreamOperation(operation) {
         operation: "revise",
         kind: "assertion",
         name,
-        data: operation.data
+        data: operation.data,
+        ...operation.expectedVersion !== void 0 ? { expectedVersion: operation.expectedVersion } : {},
+        ...operation.leaseId ? { leaseId: operation.leaseId } : {}
       };
     }
     return {
       operation: "revise",
       kind: kind2,
       name,
-      data: operation.data
+      data: operation.data,
+      ...operation.expectedVersion !== void 0 ? { expectedVersion: operation.expectedVersion } : {},
+      ...operation.leaseId ? { leaseId: operation.leaseId } : {}
     };
   }
   const kind = operation.kind ?? inferKind(operation.name, operation);
@@ -2206,7 +2265,8 @@ var OperationBuilder = class {
       operation: "retract",
       name: target.name,
       ...target.kind ? { kind: target.kind } : {},
-      ...target.reason ? { reason: target.reason } : {}
+      ...target.reason ? { reason: target.reason } : {},
+      ...target.leaseId ? { leaseId: target.leaseId } : {}
     });
     this.ops.push(op);
     return this;
@@ -2450,7 +2510,8 @@ function toBackendOp(op) {
       operation: "retract",
       name: op.name,
       ...op.kind ? { kind: op.kind } : {},
-      ...op.reason ? { reason: op.reason } : {}
+      ...op.reason ? { reason: op.reason } : {},
+      ...op.leaseId ? { leaseId: op.leaseId } : {}
     };
   }
   if (op.operation === "add") {
@@ -2516,7 +2577,9 @@ function toBackendOp(op) {
     operation: "revise",
     kind,
     name,
-    data: op.data ?? {}
+    data: op.data ?? {},
+    ...op.expectedVersion !== void 0 ? { expectedVersion: op.expectedVersion } : {},
+    ...op.leaseId ? { leaseId: op.leaseId } : {}
   };
 }
 function toPreflightOp(op, kind) {
@@ -2589,7 +2652,7 @@ function preflightCheckRevise(kind, name, data) {
 function normalizeWref(wref) {
   return wref.replace(/@(?:v\d+|HEAD|ALL)$/i, "");
 }
-var SDK_VERSION = "0.47.0" ;
+var SDK_VERSION = "0.49.0" ;
 var DEFAULT_API_URL = "https://api.warmhub.ai";
 var UNBATCHED_TRPC_PATHS = /* @__PURE__ */ new Set([
   "repo.shapeInstanceCounts",
@@ -2721,7 +2784,16 @@ var WarmHubError = class extends Error {
    * generic `BACKEND` fallback), branch on {@link code} or {@link kind}.
    */
   backendCode;
-  constructor(code, message, status, hint, retryAfter, backendCode) {
+  /**
+   * Structured backend error details, when the response carried them. Branch on
+   * `details.reason`: an `expected_version_mismatch` carries
+   * `expectedVersion`/`currentVersion` so an optimistic-concurrency caller can
+   * re-read HEAD and retry (#3624); a `lease_held` carries `leaseExpiresAt` so a
+   * caller can back off until the lease expires (#3625). Present only when the
+   * backend wire carried `data.warmhub.details`. See {@link WarmHubErrorDetails}.
+   */
+  details;
+  constructor(code, message, status, hint, retryAfter, backendCode, details) {
     super(message);
     this.name = "WarmHubError";
     this.code = code;
@@ -2729,6 +2801,7 @@ var WarmHubError = class extends Error {
     this.hint = hint;
     this.retryAfter = retryAfter;
     this.backendCode = backendCode;
+    this.details = details;
   }
   get kind() {
     return this.code;
@@ -2757,7 +2830,8 @@ function toWarmHubError(error) {
       data?.warmhub?.status,
       data?.warmhub?.hint,
       data?.warmhub?.retryAfter,
-      wireCode
+      wireCode,
+      data?.warmhub?.details
     );
   }
   if (error instanceof Error) {
@@ -2769,7 +2843,8 @@ function toWarmHubError(error) {
         typeof warmhubLike.status === "number" ? warmhubLike.status : void 0,
         typeof warmhubLike.hint === "string" ? warmhubLike.hint : void 0,
         typeof warmhubLike.retryAfter === "number" ? warmhubLike.retryAfter : void 0,
-        typeof warmhubLike.backendCode === "string" ? warmhubLike.backendCode : void 0
+        typeof warmhubLike.backendCode === "string" ? warmhubLike.backendCode : void 0,
+        warmhubLike.details
       );
     }
     if (error.name === "AbortError") {
@@ -4423,6 +4498,56 @@ var WarmHubClient = class _WarmHubClient {
         throw toWarmHubError(error);
       }
     },
+    /**
+     * Acquire a short, bounded, exclusive lease on a thing AND read it in one
+     * atomic round trip (#3625).
+     *
+     * Returns everything {@link WarmHub.thing.get} returns plus a `lease`
+     * block; the holder echoes `lease.id` back as `leaseId` on the subsequent
+     * `revise`/`retract` (auto-releasing the lease) or calls
+     * {@link WarmHub.thing.releaseLease} to return it early. Requires
+     * `things:write` — never anonymous.
+     *
+     * Fail-fast: if another holder already holds an active lease, throws a
+     * `WarmHubError` with `kind === 'LEASE_UNAVAILABLE'` and
+     * `error.details?.reason === 'lease_held'` (read `leaseExpiresAt` to back
+     * off until expiry). `ttlMs` out of the backend's bounds (default 5s /
+     * min 1s / max 30s) is rejected, never clamped.
+     */
+    getWithLease: async (orgName, repoName, wref, opts) => {
+      try {
+        return await this.trpc.thing.getWithLease.mutate({
+          orgName,
+          repoName,
+          wref,
+          ttlMs: opts?.ttlMs
+        });
+      } catch (error) {
+        throw toWarmHubError(error);
+      }
+    },
+    /**
+     * Release a lease early (#3625), closing the acquire↔release loop without
+     * waiting out the TTL.
+     *
+     * Idempotent and owner-gated: releasing an absent, already-released,
+     * expired, or non-matching lease is a benign no-op (no error). A
+     * successful `revise`/`retract` carrying the `leaseId` already
+     * auto-releases the lease, so this is only needed when the holder decides
+     * not to mutate. Requires `things:write`.
+     */
+    releaseLease: async (orgName, repoName, wref, leaseId) => {
+      try {
+        await this.trpc.thing.releaseLease.mutate({
+          orgName,
+          repoName,
+          wref,
+          leaseId
+        });
+      } catch (error) {
+        throw toWarmHubError(error);
+      }
+    },
     /**
      * Get one record and its embedded assertion, about, and wref graph.
      *
@@ -5399,5 +5524,5 @@ function isAbortError(error) {
 }
 
 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-E32PSLWS.js.map
-//# sourceMappingURL=chunk-E32PSLWS.js.map
+//# sourceMappingURL=chunk-CVMYSRPS.js.map
+//# sourceMappingURL=chunk-CVMYSRPS.js.map