@warmhub/sdk-ts 0.51.0 → 0.52.1

package/dist/index.d.ts

@@ -201,20 +201,6 @@ type ComponentSummary = {
     active: boolean;
     wref: string;
 };
-type InstallBundledSystemComponentResult = {
-    componentId: string;
-    componentName: string;
-    version: string;
-    state: 'ready' | 'unchanged';
-    componentInstallShapeCreated: boolean;
-    componentInstallShapeReconciled: boolean;
-    componentConfigShapeCreated: boolean;
-    componentConfigShapeReconciled: boolean;
-    componentInstallRecordCreated: boolean;
-    componentInstallRecordReconciled: boolean;
-    identityShapeCreated: boolean;
-    identityShapeReconciled: boolean;
-};
 type CredentialDeleteResult$1 = {
     ok: true;
     name: string;
@@ -462,6 +448,17 @@ type ThingGetManyResult$1 = {
     }>;
     missing: Array<string>;
 };
+type ThingHeadVersionsResult$1 = {
+    requested: number;
+    items: Array<{
+        wref: string;
+        durableId: string;
+        version: number;
+        active: boolean;
+        versionCreatedAt: number;
+    }>;
+    missing: Array<string>;
+};
 type RenameResult$1 = {
     renamed: true;
 };
@@ -585,7 +582,7 @@ type SynthesizedRepoContent$1 = {
 };
 type ShapeChangeResult = {
     name: string;
-    operation: 'add' | 'revise' | 'retract';
+    operation: 'add' | 'revise' | 'retract' | 'noop';
     version: number;
     dataHash: string;
 };
@@ -594,6 +591,10 @@ type SubscriptionBindCredentialsResult$1 = {
     subscriptionName: string;
     credentialSetName: string;
 };
+type SubscriptionRevealResult = {
+    webhookUrl?: string;
+    fallbackWebhookUrl?: string;
+};
 type SubscriptionUnbindCredentialsResult$1 = {
     unbound: true;
     subscriptionName: string;
@@ -644,8 +645,10 @@ interface AddOperation {
     operation?: 'add';
     /**
      * Optional kind override: `shape`, `thing`, `assertion`, or `collection`.
-     * When omitted, kind is inferred from `name` segmentation (1-seg → thing,
-     * 2-seg `Shape/name` → thing, 3+ segments → assertion).
+     * When omitted, kind is inferred: `about` present → assertion; collection
+     * `type` plus `members` → collection; otherwise by `name` segmentation
+     * (1–2 segments → thing, 3+ segments → assertion). Shape adds always
+     * require explicit `kind: 'shape'`.
      */
     kind?: 'shape' | 'thing' | 'assertion' | 'collection';
     /**
@@ -1089,19 +1092,37 @@ type CliHttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
  * A valid shape definition is:
  * { fields: Record<string, TypeSpec>, description?: string }
  * where TypeSpec is one of:
- *   - primitive string: "number", "string", "boolean", "wref"
- *   - optional primitive: "number?", "string?", "boolean?", "wref?"
+ *   - primitive string: "number", "string", "boolean", "wref", "array"
+ *   - optional primitive: "number?", "string?", "boolean?", "wref?", "array?"
  *   - typed field object: { type: primitive, description?: string }
- *   - array: [TypeSpec]
+ *   - 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.
+ */
+/**
+ * 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;
@@ -1689,7 +1710,7 @@ type ShapeList = ShapeListResult;
  */
 type ShapeRemove = {
     name: string;
-    operation: 'add' | 'revise' | 'retract';
+    operation: 'add' | 'revise' | 'retract' | 'noop';
     version: number;
     dataHash: string;
     removed: true;
@@ -1704,6 +1725,10 @@ type ShapeRemove = {
  * and `actionContainerConfig` appear on the type as optional fields but are
  * always returned as `undefined` on reads.
  *
+ * Webhook URLs are redacted to their origin (`webhookOrigin`,
+ * `fallbackWebhookOrigin` = scheme://host) on read — the raw URL path is a
+ * bearer secret and is returned only via `client.subscription.reveal`.
+ *
  * @internal
  */
 type SubscriptionInfo = {
@@ -1713,8 +1738,8 @@ type SubscriptionInfo = {
     shapeName?: string;
     sourceRepo?: string;
     filterJson?: unknown;
-    webhookUrl?: string;
-    fallbackWebhookUrl?: string;
+    webhookOrigin?: string;
+    fallbackWebhookOrigin?: string;
     actionContainerConfig?: unknown;
     actionContainer?: string;
     cronConfig?: {
@@ -1751,26 +1776,18 @@ type SubscriptionCompatCreateBase = {
 };
 /**
  * Input shape for `client.subscription.create`. Webhook subscriptions require
- * `filterJson`; cron subscriptions require `cronConfig`. Both variants require
- * `webhookUrl`.
- * Non-cron subscriptions must additionally identify a shape via `shapeName`
+ * `filterJson` and `webhookUrl`, and must identify a shape via `shapeName`
  * or `filterJson.shape` (or a shape-lifecycle `{ kind: 'shape' }` filter).
+ * The cron kind was retired from public surfaces; legacy cron rows remain
+ * readable via {@link SubscriptionInfo}.
  *
  * @see https://docs.warmhub.ai/subscriptions/creating/
  */
-type SubscriptionCompatCreateInput = (SubscriptionCompatCreateBase & {
+type SubscriptionCompatCreateInput = SubscriptionCompatCreateBase & {
     kind: 'webhook';
     filterJson: Record<string, unknown>;
     sourceRepoRef?: string;
-}) | (SubscriptionCompatCreateBase & {
-    kind: 'cron';
-    cronConfig: {
-        cronspec: string;
-        timezone?: string;
-    };
-    filterJson?: Record<string, unknown>;
-    sourceRepoRef?: never;
-});
+};
 /**
  * Input shape for `client.subscription.update`. `orgName`, `repoName`, and
  * `name` identify the subscription; all other fields are optional and only
@@ -1786,10 +1803,6 @@ type SubscriptionCompatUpdateInput = {
     filterJson?: Record<string, unknown>;
     webhookUrl?: string;
     fallbackWebhookUrl?: string | null;
-    cronConfig?: {
-        cronspec: string;
-        timezone?: string;
-    };
     allowTraceReentry?: boolean;
     notifyOnSuccess?: boolean;
     /** @internal Back-compat field; not consumed by the backend update mutation. */
@@ -1873,8 +1886,6 @@ type ComponentListOptions = {
     limit?: number;
     cursor?: string;
 };
-/** @internal */
-type ComponentInstallSystemResult = InstallBundledSystemComponentResult;
 type ComponentRegistryInfo = {
     id: string;
     ownerOrgName: string;
@@ -1906,30 +1917,29 @@ type ComponentRegistryMutationInput = {
     allowedCallbackDomains?: string[];
     credentialSetName?: string;
     description?: string;
+    /** Validated component manifest. Required on register; on update, supplying it publishes a new version. */
+    manifest?: Record<string, unknown>;
+};
+type ComponentRegistryRegisterInput = ComponentRegistryMutationInput & {
+    manifest: Record<string, unknown>;
 };
 type ComponentRegistryResolveResult = {
-    sourceUrl: string;
-    sourceDefaultRef?: string;
+    /** Latest published manifest (manifest-only install — #3993). */
+    manifest: Record<string, unknown>;
+    /** Stored content hash of the resolved manifest; echo it back on setupCall. */
+    manifestHash: string;
     hasSetup: boolean;
     installId: string;
 };
-type ComponentRegistrySourceDownloadInput = {
-    installRepo: string;
-    ref?: string;
-};
-type ComponentRegistrySourceDownloadResult = {
-    archive: Uint8Array;
-    sourceUrl: string;
-    sourceRef?: string;
-    resolvedSha?: string;
-    componentRef: string;
-    contentType: string;
-};
 type ComponentRegistrySetupCallInput = {
     installId: string;
     installRepo: string;
-    ref?: string;
-    resolvedSha?: string;
+    /**
+     * Manifest hash from the preceding resolve. The backend rejects the call if
+     * its latest manifest no longer matches, so token scopes can't drift to a
+     * revision published mid-install (#3993).
+     */
+    expectedManifestHash: string;
 };
 type ComponentRegistrySetupCallResult = {
     ok: boolean;
@@ -2305,7 +2315,7 @@ type ThingHeadRequest = {
     orgName: string;
     repoName: string;
     shape?: string;
-    kind?: string;
+    kind?: 'shape' | 'thing' | 'assertion' | 'collection';
     match?: string;
     dataMode?: 'full' | 'summary' | 'none';
     includeRetracted?: boolean;
@@ -2491,6 +2501,8 @@ type ResolveWrefResult = ThingDetail;
 /** @internal */
 type ThingGetManyResult = ThingGetManyResult$1;
 /** @internal */
+type ThingHeadVersionsResult = ThingHeadVersionsResult$1;
+/** @internal */
 type CountResult = {
     count: number;
 };
@@ -2552,7 +2564,7 @@ type FilterOptions = {
     /** Filter to records of this shape name (for example `Player`). */
     shape?: string;
     /** Filter to records of this kind: `shape`, `thing`, `assertion`, or `collection`. */
-    kind?: string;
+    kind?: 'shape' | 'thing' | 'assertion' | 'collection';
     /** Filter assertions whose `about` target wref matches the supplied value. */
     about?: string;
     /** Glob pattern matched against record names (for example `Player/*`). */
@@ -2891,17 +2903,13 @@ declare class WarmHubClient {
          * Fetch one installed component by component ID.
          */
         get: (orgName: string, repoName: string, componentId: string) => Promise<ComponentView>;
-        /**
-         * Install an allowlisted bundled system component into a repository.
-         */
-        installSystem: (orgName: string, repoName: string, componentId: string) => Promise<ComponentInstallSystemResult>;
         /**
          * Registered-component identity and install-pipeline operations.
          *
-         * This sub-surface drives the backend-mediated install flow that powers `wh component install <org/name>`. It manages registered component identities (`register`, `unregister`, `list`, `view`, `update`) and the install pipeline (`resolve` mints an install id, `downloadSource` fetches the source archive through the backend, `setupCall` dispatches the optional setup callback). Use these when building a custom installer; most callers should run the CLI instead.
+         * This sub-surface drives the backend-mediated install flow that powers `wh component install <org/name>`. It manages registered component identities (`register`, `unregister`, `list`, `view`, `update`) and the install pipeline (`resolve` returns the latest published manifest plus an install id, `setupCall` dispatches the optional setup callback). Use these when building a custom installer; most callers should run the CLI instead.
          */
         registry: {
-            register: (orgName: string, componentName: string, input?: ComponentRegistryMutationInput) => Promise<ComponentRegistryInfo>;
+            register: (orgName: string, componentName: string, input: ComponentRegistryRegisterInput) => Promise<ComponentRegistryInfo>;
             unregister: (orgName: string, componentName: string) => Promise<{
                 unregistered: true;
             }>;
@@ -2909,7 +2917,6 @@ declare class WarmHubClient {
             view: (orgName: string, componentName: string) => Promise<ComponentRegistryInfo>;
             update: (orgName: string, componentName: string, input: ComponentRegistryMutationInput) => Promise<ComponentRegistryInfo>;
             resolve: (orgName: string, componentName: string, installRepo: string) => Promise<ComponentRegistryResolveResult>;
-            downloadSource: (orgName: string, componentName: string, input: ComponentRegistrySourceDownloadInput) => Promise<ComponentRegistrySourceDownloadResult>;
             setupCall: (orgName: string, componentName: string, input: ComponentRegistrySetupCallInput) => Promise<ComponentRegistrySetupCallResult>;
         };
         /**
@@ -3307,15 +3314,15 @@ declare class WarmHubClient {
         history: (orgName: string, repoName: string, name: string, opts?: ShapeHistoryOptions) => Promise<ShapeHistory>;
     };
     /**
-     * Webhook and cron subscription management surface scoped to a repository.
+     * Webhook subscription management surface scoped to a repository.
      *
      * @see https://docs.warmhub.ai/sdk/component-identity/#subscriptions
      */
     readonly subscription: {
         /**
-         * Create a webhook or cron subscription.
+         * Create a webhook subscription.
          *
-         * Both subscription kinds require a delivery URL. Webhook subscriptions can also forward events from another repository, allow trace reentry, bind fallback delivery, and opt into success notifications. Component identity is set at creation time and follows the same authority rules as commit writes.
+         * Webhook subscriptions require a delivery URL and can forward events from another repository, allow trace reentry, bind fallback delivery, and opt into success notifications. Component identity is set at creation time and follows the same authority rules as commit writes.
          *
          * Webhook subscriptions must specify a shape filter via `shapeName` or `filterJson.shape`, except [shape-lifecycle subscriptions](/subscriptions/creating/#shape-lifecycle-subscriptions) which omit both and rely on a `{ kind: 'shape', ... }` filter.
          */
@@ -3324,14 +3331,25 @@ declare class WarmHubClient {
          * Get one subscription by name.
          */
         get: (orgName: string, repoName: string, name: string) => Promise<SubscriptionInfo>;
+        /**
+         * Reveal the raw webhook URL(s) for a subscription.
+         *
+         * Reads return only `webhookOrigin`/`fallbackWebhookOrigin` (scheme://host);
+         * the raw URL path is a bearer secret. This break-glass call returns the
+         * raw URL(s) and is audit-logged server-side. Requires `repo:configure`.
+         * Because it returns the secret, a name-scoped principal (e.g. a component
+         * setup token) may reveal only the subscriptions it is scoped to — a
+         * stricter contract than the redacted `get`/`list`, which are unscoped.
+         */
+        reveal: (orgName: string, repoName: string, name: string) => Promise<SubscriptionRevealResult>;
         /**
          * List subscriptions attached to a repository.
          */
         list: (orgName: string, repoName: string) => Promise<SubscriptionList>;
         /**
-         * Update an existing webhook or cron subscription.
+         * Update an existing webhook subscription.
          *
-         * Use `null` for nullable fields such as fallback webhook URL when you need to clear an existing value.
+         * Use `null` for nullable fields such as fallback webhook URL when you need to clear an existing value. Legacy cron subscriptions cannot be updated — delete them instead.
          */
         update: (input: SubscriptionCompatUpdateInput) => Promise<SubscriptionInfo>;
         /**
@@ -3509,6 +3527,25 @@ declare class WarmHubClient {
             chunkSize?: number;
             chunkConcurrency?: number;
         }) => Promise<ThingGetManyResult>;
+        /**
+         * Batched lightweight per-thing change probe — returns
+         * `{ wref, durableId, version, active, versionCreatedAt }` per wref with NO
+         * payload. Use it to check whether locally-cached copies are still fresh
+         * without pulling `data`: a value is stale if `durableId` differs (the wref
+         * now points to a different thing), `version`/`active` differ (the same
+         * thing changed/was retracted), or the wref appears in `missing`.
+         *
+         * Auto-chunks above the backend's 500-wref transport cap; preserves
+         * duplicate requested wrefs and reports inaccessible/unknown refs in
+         * `missing` rather than throwing per item.
+         *
+         * @param opts.chunkSize Maximum wrefs per backend request. Defaults to 500 and is clamped to the backend cap.
+         * @param opts.chunkConcurrency Maximum concurrent chunk requests. Defaults to 1 and is clamped to 8.
+         */
+        headVersions: (orgName: string | undefined, repoName: string | undefined, wrefs: string[], opts?: {
+            chunkSize?: number;
+            chunkConcurrency?: number;
+        }) => Promise<ThingHeadVersionsResult>;
         /**
          * Return version history and timeline metadata for repository records.
          *
@@ -3877,4 +3914,4 @@ declare class WarmHubClient {
     private watchRepoQuery;
 }
 
-export { type AboutOptions, type AboutResult, type AccessTokenProvider, type ActionAttemptInfo, type ActionLeaseAcquire, type ActionLeaseOp, type ActionListNotificationsOptions, type ActionListRunsOptions, type ActionLiveFeed, type ActionLiveFeedOptions, type ActionNotificationInfo, type ActionRunInfo, type ActionRunStatsInfo, type ActionRunStatsOptions, type AddOp, type AddOperation, AllStreamOperationsFailedError, type Assertion, CLI_INSTALL_REPO_HEADER, CLI_SIGNATURE_HEADER, CLI_TIMESTAMP_HEADER, CONTENT_FIELD_LIMIT_ERROR, type CliCallSecrets, CliCallVerificationError, type CliCallVerificationFailureReason, type CollectionAbout, type CollectionTag, type ComponentInfo, type ComponentInstallSystemResult, type ComponentList, type ComponentListOptions, type ComponentView, type CoreErrorKind, type CountOptions, type CountResult, type CredentialAuditEntry, type CredentialDeleteResult, type CredentialGrantResult, type CredentialInfo, type CredentialKeyMutationResult, type CredentialRevokeResult, type CredentialUngrantResult, type CurrentUserInfo, DEFAULT_API_URL, DEFAULT_STREAM_CHUNK_SIZE, type ErrorKind, type FilterOptions, type FilterResult, type FunctionLogMode, type HeadResult, type HistoryResult, type IndexedFieldEntry, type IndexedFieldsReport, type LiveHandle, type LiveRepoEvent, type LiveSubscriptionLogOptions, type LiveThingHeadOptions, type LiveThingHistoryOptions, type LiveWatchResult, MAX_CONTENT_FIELD_BYTES, MAX_STREAM_APPEND_OPERATION_COUNT, type Operation, OperationBuilder, type OperationBuilderClient, type OperationBuilderOp, type OperationBuilderOptions, type OperationSubmitResult, type OrgInfo, type OrgList, type OrgListMembersOptions, type OrgListOptions, type OrgMemberInfo, type OrgMemberList, type OrgRef, type OrgRole, type Page, type PageRequest, PartialStreamSubmissionError, type PingResult, type RefLink, type RefsOptions, type RefsResult, type RenameResult, type RepoConfigureStatsView, type RepoDescribeResult, type RepoInfo, type RepoList, type RepoListForCallerOptions, type RepoListOptions, type RepoListPageOptions, type RepoListPageResult, type RepoLocator, type RepoRecentInfo, type RepoRef, type RepoShapeInstanceCountsView, type RepoSort, type RepoStatsBatchResult, type RepoStatsView, type RepoWithStatsInfo, type RequestEvent, type ResolveWrefResult, type RetractOp, type RetractOperation, type RetryPolicyOptions, type ReviseOp, type ReviseOperation, SDK_VERSION, type SearchOptions, type SearchResult, type Shape, type ShapeChange, type ShapeCreateOptions, type ShapeFields, type ShapeGetOptions, type ShapeHistory, type ShapeHistoryOptions, type ShapeList, type ShapeListOptions, type ShapeRef, type ShapeRemove, type ShapeReviseOptions, type ShapeValidatorResult, type StreamAppendInput, type StreamAppendResult, type StreamContinuationState, type SubscriptionBindCredentialsResult, type SubscriptionCompatCreateInput, type SubscriptionCompatUpdateInput, type SubscriptionInfo, type SubscriptionList, type SubscriptionUnbindCredentialsResult, type SynthesizedRepoContent, type ThingDetail, type ThingGet, type ThingGetManyResult, type ThingGetOptions, type ThingGetWithLease, type ThingGraphOptions, type ThingGraphResult, type ThingGraphValue, type ThingHead, type ThingHeadOptions, type ThingHeadRequest, type ThingHistory, type ThingHistoryOptions, type ThingItem, type ThingMetadata, type TokenInfo, type TokenResult, type UndeclaredFieldsWarning, type ValidationDiagnostic, type ValidationResult, type VerifiedCliCall, WarmHubClient, type WarmHubClientOptions, WarmHubError, type WarmHubErrorDetails, type WherePredicate, type WhoamiInfo, type WhoamiScopeEntry, type WireScopeEntry, connectionErrorMessage, contentFieldLimitError, countStreamAppendResultStatuses, isConnectionError, isRetryable, isWarmHubError, normalizeWref, resolveFunctionLogMode, sanitizeErrorMessage, sdkVersionIsBelowMinimum, streamAppendResultStatus, submitOperationsViaStream, toWarmHubError, validateAgainstShape, verifyCliCall };
+export { type AboutOptions, type AboutResult, type AccessTokenProvider, type ActionAttemptInfo, type ActionLeaseAcquire, type ActionLeaseOp, type ActionListNotificationsOptions, type ActionListRunsOptions, type ActionLiveFeed, type ActionLiveFeedOptions, type ActionNotificationInfo, type ActionRunInfo, type ActionRunStatsInfo, type ActionRunStatsOptions, type AddOp, type AddOperation, AllStreamOperationsFailedError, type Assertion, CLI_INSTALL_REPO_HEADER, CLI_SIGNATURE_HEADER, CLI_TIMESTAMP_HEADER, CONTENT_FIELD_LIMIT_ERROR, type CliCallSecrets, CliCallVerificationError, type CliCallVerificationFailureReason, type CollectionAbout, type CollectionTag, type ComponentInfo, type ComponentList, type ComponentListOptions, type ComponentView, type CoreErrorKind, type CountOptions, type CountResult, type CredentialAuditEntry, type CredentialDeleteResult, type CredentialGrantResult, type CredentialInfo, type CredentialKeyMutationResult, type CredentialRevokeResult, type CredentialUngrantResult, type CurrentUserInfo, DEFAULT_API_URL, DEFAULT_STREAM_CHUNK_SIZE, type ErrorKind, type FilterOptions, type FilterResult, type FunctionLogMode, type HeadResult, type HistoryResult, type IndexedFieldEntry, type IndexedFieldsReport, type LiveHandle, type LiveRepoEvent, type LiveSubscriptionLogOptions, type LiveThingHeadOptions, type LiveThingHistoryOptions, type LiveWatchResult, MAX_CONTENT_FIELD_BYTES, MAX_STREAM_APPEND_OPERATION_COUNT, type Operation, OperationBuilder, type OperationBuilderClient, type OperationBuilderOp, type OperationBuilderOptions, type OperationSubmitResult, type OrgInfo, type OrgList, type OrgListMembersOptions, type OrgListOptions, type OrgMemberInfo, type OrgMemberList, type OrgRef, type OrgRole, type Page, type PageRequest, PartialStreamSubmissionError, type PingResult, type RefLink, type RefsOptions, type RefsResult, type RenameResult, type RepoConfigureStatsView, type RepoDescribeResult, type RepoInfo, type RepoList, type RepoListForCallerOptions, type RepoListOptions, type RepoListPageOptions, type RepoListPageResult, type RepoLocator, type RepoRecentInfo, type RepoRef, type RepoShapeInstanceCountsView, type RepoSort, type RepoStatsBatchResult, type RepoStatsView, type RepoWithStatsInfo, type RequestEvent, type ResolveWrefResult, type RetractOp, type RetractOperation, type RetryPolicyOptions, type ReviseOp, type ReviseOperation, SDK_VERSION, type SearchOptions, type SearchResult, type Shape, type ShapeChange, type ShapeCreateOptions, type ShapeFields, type ShapeGetOptions, type ShapeHistory, type ShapeHistoryOptions, type ShapeList, type ShapeListOptions, type ShapeRef, type ShapeRemove, type ShapeReviseOptions, type ShapeValidatorResult, type StreamAppendInput, type StreamAppendResult, type StreamContinuationState, type SubscriptionBindCredentialsResult, type SubscriptionCompatCreateInput, type SubscriptionCompatUpdateInput, type SubscriptionInfo, type SubscriptionList, type SubscriptionUnbindCredentialsResult, type SynthesizedRepoContent, type ThingDetail, type ThingGet, type ThingGetManyResult, type ThingGetOptions, type ThingGetWithLease, type ThingGraphOptions, type ThingGraphResult, type ThingGraphValue, type ThingHead, type ThingHeadOptions, type ThingHeadRequest, type ThingHeadVersionsResult, type ThingHistory, type ThingHistoryOptions, type ThingItem, type ThingMetadata, type TokenInfo, type TokenResult, type UndeclaredFieldsWarning, type ValidationDiagnostic, type ValidationResult, type VerifiedCliCall, WarmHubClient, type WarmHubClientOptions, WarmHubError, type WarmHubErrorDetails, type WherePredicate, type WhoamiInfo, type WhoamiScopeEntry, type WireScopeEntry, connectionErrorMessage, contentFieldLimitError, countStreamAppendResultStatuses, isConnectionError, isRetryable, isWarmHubError, normalizeWref, resolveFunctionLogMode, sanitizeErrorMessage, sdkVersionIsBelowMinimum, streamAppendResultStatus, submitOperationsViaStream, toWarmHubError, validateAgainstShape, verifyCliCall };

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-ZTDMTDJ6.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-OPTB23HY.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/react.js

@@ -1,5 +1,5 @@
-import { WarmHubClient } from './chunk-ZTDMTDJ6.js';
-export { DEFAULT_API_URL, SDK_VERSION, WarmHubClient, WarmHubError, toWarmHubError } from './chunk-ZTDMTDJ6.js';
+import { WarmHubClient } from './chunk-OPTB23HY.js';
+export { DEFAULT_API_URL, SDK_VERSION, WarmHubClient, WarmHubError, toWarmHubError } from './chunk-OPTB23HY.js';
 import { createContext, useMemo, useState, useEffect, useContext } from 'react';
 import { jsx } from 'react/jsx-runtime';
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@warmhub/sdk-ts",
-  "version": "0.51.0",
+  "version": "0.52.1",
   "private": false,
   "type": "module",
   "description": "The TypeScript SDK for WarmHub — create repos, commit and query data, and compound knowledge with your AI agents.",
@@ -68,6 +68,7 @@
     "quality:verbose": "bun run scripts/quality-check.ts --verbose",
     "check:contract": "node ../../scripts/lint/external-identity-contracts.mjs sdk",
     "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
     "test:watch": "vitest",
     "typecheck": "bun run check:contract && bun run audit:backend-types && bun run audit:sdk-result-types && tsc --noEmit",
     "docs:api:json": "typedoc --options typedoc.json --json /tmp/warmhub-sdk-api.json",
@@ -85,6 +86,7 @@
     "@trpc/client": "11.17.0"
   },
   "devDependencies": {
+    "@vitest/coverage-v8": "4.1.5",
     "@types/react": "19.2.14",
     "react": "19.2.6",
     "tsup": "8.5.1",