@warmhub/sdk-ts 0.60.1 → 0.62.0

package/dist/index.d.ts

@@ -67,52 +67,6 @@ declare const CLI_TIMESTAMP_HEADER = "X-WarmHub-Timestamp";
  */
 type CliHttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
 
-/**
- * Hardcoded meta-schema for validating shape definitions.
- * Shapes are NOT validated against a DB-stored shape — they validate against this constant.
- * This avoids the bootstrap chicken-and-egg problem.
- *
- * A valid shape definition is:
- * { fields: Record<string, TypeSpec>, description?: string }
- * where TypeSpec is one of:
- *   - primitive string: "number", "string", "boolean", "wref", "array"
- *   - optional primitive: "number?", "string?", "boolean?", "wref?", "array?"
- *   - typed field object: { type: primitive, description?: string }
- *   - array: [TypeSpec] (shorthand) or { type: "array", items: TypeSpec }
- *   - nested object: { fieldName: TypeSpec, ... } (key may end with "?" for optional)
- *
- * The primitive vocabulary above is closed: any other type name (e.g. "text",
- * "integer", "json", "date") is rejected. See VALID_PRIMITIVE_TYPES in
- * ./shape-types.ts for the authoritative set.
- * String `pattern` constraints use RE2 syntax and are evaluated with re2js so
- * user-authored patterns run in linear time across backend, SDK, web, CLI, and
- * worker-adjacent consumers. JavaScript-only constructs such as backreferences
- * and lookarounds are rejected at shape-definition time.
- */
-/**
- * Maximum size, in bytes (UTF-8 encoded), allowed for a single content field value.
- * WarmHub is not a document store: values larger than this are rejected at validation.
- * Store large documents in S3, Box, Drive, or another document system and reference
- * them from WarmHub instead.
- * @see https://docs.warmhub.ai/sdk-reference/variables/max_content_field_bytes/
- */
-declare const MAX_CONTENT_FIELD_BYTES: number;
-/**
- * Human-readable explanation of the {@link MAX_CONTENT_FIELD_BYTES} limit, suitable for
- * appending to a field-specific validation error. States the byte cap and points callers
- * to an external document store for large payloads.
- * @see https://docs.warmhub.ai/sdk-reference/variables/content_field_limit_error/
- */
-declare const CONTENT_FIELD_LIMIT_ERROR: string;
-/**
- * Returns a validation error message if the given string exceeds
- * {@link MAX_CONTENT_FIELD_BYTES} when UTF-8 encoded, or `null` if it is within the limit.
- *
- * @param path - The field path, used to identify the offending field in the message.
- * @param value - The candidate field value to measure.
- * @see https://docs.warmhub.ai/sdk-reference/functions/contentfieldlimiterror/
- */
-declare function contentFieldLimitError(path: string, value: string): string | null;
 /**
  * Validate a data payload against shape field definitions.
  *
@@ -170,6 +124,54 @@ type ShapeValidatorResult = {
     warnings?: UndeclaredFieldsWarning;
 };
 
+/**
+ * Hardcoded meta-schema for validating shape definitions.
+ * Shapes are NOT validated against a DB-stored shape — they validate against this constant.
+ * This avoids the bootstrap chicken-and-egg problem.
+ *
+ * A valid shape definition is:
+ * { fields: Record<string, TypeSpec>, description?: string }
+ * where TypeSpec is one of:
+ *   - primitive string: "number", "string", "boolean", "wref", "array"
+ *   - optional primitive: "number?", "string?", "boolean?", "wref?", "array?"
+ *   - typed field object: { type: primitive, description?: string }
+ *   - array: [TypeSpec] (shorthand) or { type: "array", items: TypeSpec }
+ *   - nested object: { fieldName: TypeSpec, ... } (key may end with "?" for optional)
+ *
+ * The primitive vocabulary above is closed: any other type name (e.g. "text",
+ * "integer", "json", "date") is rejected. See VALID_PRIMITIVE_TYPES in
+ * ./shape-types.ts for the authoritative set.
+ * String `pattern` constraints use RE2 syntax and are evaluated with re2js so
+ * user-authored patterns run in linear time across backend, SDK, web, CLI, and
+ * worker-adjacent consumers. JavaScript-only constructs such as backreferences
+ * and lookarounds are rejected at shape-definition time.
+ */
+
+/**
+ * Maximum size, in bytes (UTF-8 encoded), allowed for a single content field value.
+ * WarmHub is not a document store: values larger than this are rejected at validation.
+ * Store large documents in S3, Box, Drive, or another document system and reference
+ * them from WarmHub instead.
+ * @see https://docs.warmhub.ai/sdk-reference/variables/max_content_field_bytes/
+ */
+declare const MAX_CONTENT_FIELD_BYTES: number;
+/**
+ * Human-readable explanation of the {@link MAX_CONTENT_FIELD_BYTES} limit, suitable for
+ * appending to a field-specific validation error. States the byte cap and points callers
+ * to an external document store for large payloads.
+ * @see https://docs.warmhub.ai/sdk-reference/variables/content_field_limit_error/
+ */
+declare const CONTENT_FIELD_LIMIT_ERROR: string;
+/**
+ * Returns a validation error message if the given string exceeds
+ * {@link MAX_CONTENT_FIELD_BYTES} when UTF-8 encoded, or `null` if it is within the limit.
+ *
+ * @param path - The field path, used to identify the offending field in the message.
+ * @param value - The candidate field value to measure.
+ * @see https://docs.warmhub.ai/sdk-reference/functions/contentfieldlimiterror/
+ */
+declare function contentFieldLimitError(path: string, value: string): string | null;
+
 type ActionAttempt = {
     attempt: number;
     status: string;
@@ -1100,10 +1102,6 @@ type SubmittedStreamResult = {
         warnings?: NonNullable<StreamAppendResult$1['results'][number]['warnings']>;
     }>;
 };
-/** @internal */
-declare function streamAppendResultStatus(result: StreamAppendResult$1['results'][number]): NonNullable<SubmittedStreamResult['operations'][number]['status']>;
-/** @internal */
-declare function countStreamAppendResultStatuses(results: StreamAppendResult$1['results']): NonNullable<SubmittedStreamResult['statusCounts']>;
 /**
  * Continuation state for caller-managed streamed commit submissions.
  * @see https://docs.warmhub.ai/sdk-reference/type-aliases/streamcontinuationstate/
@@ -1177,6 +1175,7 @@ declare class AllStreamOperationsFailedError extends Error {
     readonly cause?: StreamFailureCause;
     constructor(result: SubmittedStreamResult);
 }
+
 /**
  * Submit `operations` to the WarmHub stream-append surface, chunked to
  * stay under MAX_STREAM_APPEND_OPERATION_COUNT.
@@ -1272,6 +1271,15 @@ declare function submitOperationsViaStream(client: OperationStreamClient, args:
     retry?: RetryPolicyOptions | false;
 }): Promise<SubmittedStreamResult>;
 
+/**
+ * Exposed for unit tests and internal callers to avoid re-deriving status values.
+ *
+ * @internal
+ */
+declare function streamAppendResultStatus(result: StreamAppendResult$1['results'][number]): NonNullable<SubmittedStreamResult['operations'][number]['status']>;
+/** @internal */
+declare function countStreamAppendResultStatuses(results: StreamAppendResult$1['results']): NonNullable<SubmittedStreamResult['statusCounts']>;
+
 /**
  * Server-side verifier for component CLI dispatch calls.
  *
@@ -1582,6 +1590,7 @@ interface OperationBuilderOptions {
 }
 /** @internal */
 type OperationBuilderClient = OperationStreamClient;
+
 type ReviseInput = Omit<ReviseOp, 'operation'> | ReviseOp;
 /**
  * Fluent builder for composing, validating, and submitting WarmHub commit
@@ -1766,6 +1775,18 @@ interface WarmHubClientOptions {
      * Control replay of backend function log lines. Defaults to `off`.
      */
     functionLogs?: FunctionLogMode;
+    /**
+     * Self-identification sent on the `X-WarmHub-Client` header (`name/version`)
+     * for backend observability + read-analytics surface attribution. Defaults to
+     * `@warmhub/sdk-ts/<SDK_VERSION>`. A wrapper such as the WarmHub CLI overrides
+     * `name` (and usually `version`) to identify itself instead. An untrusted
+     * hint — never an authz signal. A per-request `X-WarmHub-Client` header on a
+     * raw request still wins over this default.
+     */
+    client?: {
+        name?: string;
+        version?: string;
+    };
 }
 /**
  * Version string for the installed SDK package.
@@ -3045,6 +3066,8 @@ declare class WarmHubClient {
     readonly apiUrl: string;
     private readonly fetchImpl;
     private readonly accessToken;
+    /** Resolved `X-WarmHub-Client` identity; defaults to this SDK's name/version. */
+    private readonly clientIdentity;
     protected readonly functionLogMode: FunctionLogMode;
     protected readonly getToken?: () => Promise<string | undefined>;
     private readonly trpc;
@@ -3474,12 +3497,6 @@ declare class WarmHubClient {
         delete: (orgName: string, repoName: string) => Promise<{
             graceExpiresAt: Date;
         }>;
-        /**
-         * Immediately and irreversibly purge a repository.
-         *
-         * This owner-only operation has no grace window and uses the same inbound-reference guard as `delete`.
-         */
-        hardDelete: (orgName: string, repoName: string) => Promise<void>;
         /**
          * List repositories with dashboard-oriented per-repository metadata.
          *
@@ -4345,6 +4362,11 @@ declare class WarmHubClient {
         listNotifications: (orgName: string, repoName: string, opts?: ActionListNotificationsOptions) => Promise<ActionNotificationInfo[]>;
     };
     private openSse;
+    /**
+     * Stamp the `X-WarmHub-Client` self-identification header, unless the caller
+     * already set it on the request (a per-request header wins over the default).
+     */
+    private applyClientHeader;
     private fetchWithAuth;
     private requestResponse;
     private requestJson;

package/dist/index.js

@@ -1,3 +1,3 @@
-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_COUNT, OperationBuilder, PartialStreamSubmissionError, SDK_VERSION, WarmHubClient, WarmHubError, connectionErrorMessage, contentFieldLimitError, countStreamAppendResultStatuses, isConnectionError, isRetryable, isWarmHubError, normalizeWref, resolveFunctionLogMode, sanitizeErrorMessage, sdkVersionIsBelowMinimum, streamAppendResultStatus, submitOperationsViaStream, toWarmHubError, validateAgainstShape, verifyCliCall } from './chunk-D5A5SSUU.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_COUNT, OperationBuilder, PartialStreamSubmissionError, SDK_VERSION, WarmHubClient, WarmHubError, connectionErrorMessage, contentFieldLimitError, countStreamAppendResultStatuses, isConnectionError, isRetryable, isWarmHubError, normalizeWref, resolveFunctionLogMode, sanitizeErrorMessage, sdkVersionIsBelowMinimum, streamAppendResultStatus, submitOperationsViaStream, toWarmHubError, validateAgainstShape, verifyCliCall } from './chunk-CN4352BX.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/react.d.ts

@@ -12,13 +12,23 @@ interface WarmHubProviderProps {
         isLoading: boolean;
         getAccessToken: () => Promise<string | null>;
     };
+    /**
+     * Self-identification forwarded to the `X-WarmHub-Client` header. First-party
+     * apps set `name` (e.g. `warmhub-web`) so backend observability can tell them
+     * apart from raw SDK consumers; an omitted `version` falls through to the SDK
+     * version. See `WarmHubClientOptions.client`.
+     */
+    client?: {
+        name?: string;
+        version?: string;
+    };
 }
 interface WarmHubAuthState {
     isAuthenticated: boolean;
     isLoading: boolean;
 }
 /** @internal */
-declare function WarmHubProvider({ apiUrl, children, auth, }: WarmHubProviderProps): react_jsx_runtime.JSX.Element;
+declare function WarmHubProvider({ apiUrl, children, auth, client: clientIdentity, }: WarmHubProviderProps): react_jsx_runtime.JSX.Element;
 /** @internal */
 declare function useWarmHubClient(): WarmHubClient;
 /** @internal */

package/dist/react.js

@@ -1,5 +1,5 @@
-import { WarmHubClient } from './chunk-D5A5SSUU.js';
-export { DEFAULT_API_URL, SDK_VERSION, WarmHubClient, WarmHubError, toWarmHubError } from './chunk-D5A5SSUU.js';
+import { WarmHubClient } from './chunk-CN4352BX.js';
+export { DEFAULT_API_URL, SDK_VERSION, WarmHubClient, WarmHubError, toWarmHubError } from './chunk-CN4352BX.js';
 import { createContext, useMemo, useState, useEffect, useContext } from 'react';
 import { jsx } from 'react/jsx-runtime';
 
@@ -11,17 +11,21 @@ var AuthContext = createContext({
 function WarmHubProvider({
   apiUrl,
   children,
-  auth
+  auth,
+  client: clientIdentity
 }) {
+  const clientName = clientIdentity?.name;
+  const clientVersion = clientIdentity?.version;
   const client = useMemo(
     () => new WarmHubClient({
       apiUrl,
       accessToken: async () => {
         const token = await auth.getAccessToken();
         return token ?? void 0;
-      }
+      },
+      client: { name: clientName, version: clientVersion }
     }),
-    [apiUrl, auth.getAccessToken]
+    [apiUrl, auth.getAccessToken, clientName, clientVersion]
   );
   return /* @__PURE__ */ jsx(ClientContext.Provider, { value: client, children: /* @__PURE__ */ jsx(AuthSyncGate, { auth, client, children }) });
 }

package/dist/react.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/react/provider.tsx"],"names":[],"mappings":";;;;;AA0BA,IAAM,aAAA,GAAgB,cAAoC,IAAI,CAAA;AAC9D,IAAM,cAAc,aAAA,CAAgC;AAAA,EAClD,eAAA,EAAiB,KAAA;AAAA,EACjB,SAAA,EAAW;AACb,CAAC,CAAA;AAGM,SAAS,eAAA,CAAgB;AAAA,EAC9B,MAAA;AAAA,EACA,QAAA;AAAA,EACA;AACF,CAAA,EAAyB;AACvB,EAAA,MAAM,MAAA,GAAS,OAAA;AAAA,IACb,MACE,IAAI,aAAA,CAAc;AAAA,MAChB,MAAA;AAAA,MACA,aAAa,YAAY;AACvB,QAAA,MAAM,KAAA,GAAQ,MAAM,IAAA,CAAK,cAAA,EAAe;AACxC,QAAA,OAAO,KAAA,IAAS,MAAA;AAAA,MAClB;AAAA,KACD,CAAA;AAAA,IACH,CAAC,MAAA,EAAQ,IAAA,CAAK,cAAc;AAAA,GAC9B;AAEA,EAAA,uBACE,GAAA,CAAC,aAAA,CAAc,QAAA,EAAd,EAAuB,KAAA,EAAO,MAAA,EAC7B,QAAA,kBAAA,GAAA,CAAC,YAAA,EAAA,EAAa,IAAA,EAAY,MAAA,EACvB,QAAA,EACH,CAAA,EACF,CAAA;AAEJ;AAEA,SAAS,YAAA,CAAa;AAAA,EACpB,IAAA;AAAA,EACA,MAAA;AAAA,EACA;AACF,CAAA,EAIG;AACD,EAAA,MAAM,CAAC,MAAA,EAAQ,SAAS,CAAA,GAAI,SAAS,KAAK,CAAA;AAE1C,EAAA,SAAA,CAAU,MAAM;AACd,IAAA,IAAI,CAAC,KAAK,eAAA,EAAiB;AACzB,MAAA,SAAA,CAAU,KAAK,CAAA;AACf,MAAA;AAAA,IACF;AAEA,IAAA,IAAI,SAAA,GAAY,KAAA;AAChB,IAAA,MAAA,CAAO,IAAA,CACJ,IAAA,EAAK,CACL,IAAA,CAAK,MAAM;AACV,MAAA,IAAI,CAAC,SAAA,EAAW,SAAA,CAAU,IAAI,CAAA;AAAA,IAChC,CAAC,CAAA,CACA,KAAA,CAAM,CAAC,GAAA,KAAQ;AACd,MAAA,OAAA,CAAQ,KAAA,CAAM,qBAAqB,GAAG,CAAA;AACtC,MAAA,IAAI,CAAC,SAAA,EAAW,SAAA,CAAU,IAAI,CAAA;AAAA,IAChC,CAAC,CAAA;AACH,IAAA,OAAO,MAAM;AACX,MAAA,SAAA,GAAY,IAAA;AAAA,IACd,CAAA;AAAA,EACF,CAAA,EAAG,CAAC,IAAA,CAAK,eAAA,EAAiB,MAAM,CAAC,CAAA;AAEjC,EAAA,MAAM,SAAA,GAAY,OAAA;AAAA,IAChB,OAAO;AAAA,MACL,eAAA,EAAiB,KAAK,eAAA,IAAmB,MAAA;AAAA,MACzC,SAAA,EAAW,IAAA,CAAK,SAAA,IAAc,IAAA,CAAK,mBAAmB,CAAC;AAAA,KACzD,CAAA;AAAA,IACA,CAAC,IAAA,CAAK,eAAA,EAAiB,IAAA,CAAK,WAAW,MAAM;AAAA,GAC/C;AAGA,EAAA,IAAI,IAAA,CAAK,SAAA,IAAc,IAAA,CAAK,eAAA,IAAmB,CAAC,MAAA,EAAS;AACvD,IAAA,OAAO,IAAA;AAAA,EACT;AAEA,EAAA,2BACG,WAAA,CAAY,QAAA,EAAZ,EAAqB,KAAA,EAAO,WAAY,QAAA,EAAS,CAAA;AAEtD;AAGO,SAAS,gBAAA,GAAkC;AAChD,EAAA,MAAM,MAAA,GAAS,WAAW,aAAa,CAAA;AACvC,EAAA,IAAI,CAAC,MAAA,EAAQ;AACX,IAAA,MAAM,IAAI,MAAM,wDAAwD,CAAA;AAAA,EAC1E;AACA,EAAA,OAAO,MAAA;AACT;AAGO,SAAS,cAAA,GAAmC;AACjD,EAAA,OAAO,WAAW,WAAW,CAAA;AAC/B","file":"react.js"}
+{"version":3,"sources":["../src/react/provider.tsx"],"names":[],"mappings":"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","file":"react.js"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@warmhub/sdk-ts",
-  "version": "0.60.1",
+  "version": "0.62.0",
   "private": false,
   "type": "module",
   "description": "The TypeScript SDK for WarmHub — create repos, commit and query data, and compound knowledge with your AI agents.",