@warmhub/sdk-ts 0.62.1 → 0.64.0

package/dist/index.d.ts

@@ -185,6 +185,7 @@ type ActionAttempt = {
 type ActionLiveFeedResult = {
     items: Array<{
         subscriptionName: string;
+        deliveryId: string;
         runId?: string;
         status: string;
         matchedOperationIndexes: Array<number>;
@@ -297,9 +298,16 @@ type CommitApplyResult = {
         dataHash: string;
         status?: 'applied' | 'noop';
         warnings?: {
-            undeclaredFields: Array<string>;
+            undeclaredFields?: Array<string>;
             undeclaredFieldsTruncated?: true;
             totalUndeclared?: number;
+            coalescedWrefs?: Array<{
+                fieldPath: string;
+                wref: string;
+                reason: string;
+            }>;
+            coalescedWrefsTruncated?: true;
+            totalCoalescedWrefs?: number;
         };
     }>;
 };
@@ -316,6 +324,8 @@ type ComponentDetail = {
     checkedAt?: string;
     active: boolean;
     wref: string;
+    latestVersion?: string;
+    updateAvailable?: boolean;
     install: {
         wref: string;
         pinnedWref?: string;
@@ -390,6 +400,8 @@ type ComponentListResult = {
         checkedAt?: string;
         active: boolean;
         wref: string;
+        latestVersion?: string;
+        updateAvailable?: boolean;
     }>;
     nextCursor?: string;
 };
@@ -406,6 +418,8 @@ type ComponentSummary = {
     checkedAt?: string;
     active: boolean;
     wref: string;
+    latestVersion?: string;
+    updateAvailable?: boolean;
 };
 type ComponentUninstallResult$1 = {
     componentRef: string;
@@ -433,6 +447,44 @@ type Capabilities = {
     minSupportedSdk: string;
     features: Record<string, boolean>;
 };
+type HomepageFeaturedListsResult$1 = {
+    lists: Array<{
+        slug: string;
+        title: string;
+        description?: string;
+        surface?: string;
+        itemKind?: 'repo' | 'component' | 'skill';
+        sortOrder?: number;
+        items: Array<{
+            kind: 'repo' | 'component' | 'skill';
+            slug: string;
+            title: string;
+            description?: string;
+            sortOrder: number;
+            tagline?: string;
+            category?: string;
+            ctaLabel?: string;
+            curationReason?: string;
+            featuredSince?: string;
+            orgName?: string;
+            repoName?: string;
+            componentName?: string;
+            componentRef?: string;
+            marketplace?: string;
+            skillName?: string;
+            packageName?: string;
+            installCommand?: string;
+            externalUrl?: string;
+            createdAt?: number;
+            total?: number;
+            byKind?: {
+                shape: number;
+                thing: number;
+                assertion: number;
+            };
+        }>;
+    }>;
+};
 type StreamAppendInput$1 = {
     orgName: string;
     repoName: string;
@@ -554,9 +606,16 @@ type StreamAppendResult$1 = {
         resolvedName?: string;
         retryable?: boolean;
         warnings?: {
-            undeclaredFields: Array<string>;
+            undeclaredFields?: Array<string>;
             undeclaredFieldsTruncated?: true;
             totalUndeclared?: number;
+            coalescedWrefs?: Array<{
+                fieldPath: string;
+                wref: string;
+                reason: string;
+            }>;
+            coalescedWrefsTruncated?: true;
+            totalCoalescedWrefs?: number;
         };
     }>;
     createdByEmail?: string;
@@ -2059,6 +2118,14 @@ type ActionLeaseOp = {
     ok: false;
     reason: string;
 };
+/** @internal */
+type ActionDeliveryTarget = string | {
+    runId: string;
+    deliveryId?: never;
+} | {
+    deliveryId: string;
+    runId?: never;
+};
 /**
  * Result returned by in-place rename mutations: `client.shape.rename` and
  * `client.thing.rename`. A rename patches the identity field directly and
@@ -2069,6 +2136,8 @@ type ActionLeaseOp = {
  * @see https://docs.warmhub.ai/data-modeling/naming-as-navigation/
  */
 type RenameResult = RenameResult$1;
+/** @internal Curated lists returned by `client.homepage.featuredLists()`. */
+type HomepageFeaturedListsResult = HomepageFeaturedListsResult$1;
 /**
  * A single entry in the indexed-fields report.
  * @see https://docs.warmhub.ai/sdk-reference/type-aliases/indexedfieldentry/
@@ -2345,6 +2414,7 @@ type CurrentUserInfo = {
     lastName?: string;
     externalId: string;
     identityWref: string | null;
+    knockUserToken: string | null;
 } | null;
 /** @internal */
 type WhoamiScopeEntry = {
@@ -3111,6 +3181,16 @@ declare class WarmHubClient {
          */
         whoami: () => Promise<WhoamiInfo>;
     };
+    /**
+     * Homepage surfaces.
+     * @see https://docs.warmhub.ai/sdk-reference/classes/warmhubclient/#homepage
+     */
+    readonly homepage: {
+        /**
+         * Return manually curated featured homepage lists.
+         */
+        featuredLists: () => Promise<HomepageFeaturedListsResult$1>;
+    };
     /**
      * Effective-access resolution for UI gating and service-side authorization.
      * First-party surface (web UI + whedge edge); the underlying `access.resolve`
@@ -3756,13 +3836,13 @@ declare class WarmHubClient {
          */
         releaseLease: (orgName: string, repoName: string, subscriptionName: string, holderId: string) => Promise<ActionLeaseOp>;
         /**
-         * Claim one action delivery run for processing.
+         * Claim one action delivery for processing.
          */
-        claimDelivery: (orgName: string, repoName: string, runId: string, holderId: string) => Promise<ActionLeaseOp>;
+        claimDelivery: (orgName: string, repoName: string, target: ActionDeliveryTarget, holderId: string) => Promise<ActionLeaseOp>;
         /**
-         * Mark one claimed action delivery run as complete.
+         * Mark one claimed action delivery as complete.
          */
-        completeDelivery: (orgName: string, repoName: string, runId: string, holderId: string) => Promise<ActionLeaseOp>;
+        completeDelivery: (orgName: string, repoName: string, target: ActionDeliveryTarget, holderId: string) => Promise<ActionLeaseOp>;
         /**
          * Query the live delivery feed for a subscription.
          *
@@ -4329,13 +4409,13 @@ declare class WarmHubClient {
          */
         releaseLease: (orgName: string, repoName: string, subscriptionName: string, holderId: string) => Promise<ActionLeaseOp>;
         /**
-         * Claim one action delivery run for processing.
+         * Claim one action delivery for processing.
          */
-        claimDelivery: (orgName: string, repoName: string, runId: string, holderId: string) => Promise<ActionLeaseOp>;
+        claimDelivery: (orgName: string, repoName: string, target: ActionDeliveryTarget, holderId: string) => Promise<ActionLeaseOp>;
         /**
-         * Mark one claimed action delivery run as complete.
+         * Mark one claimed action delivery as complete.
          */
-        completeDelivery: (orgName: string, repoName: string, runId: string, holderId: string) => Promise<ActionLeaseOp>;
+        completeDelivery: (orgName: string, repoName: string, target: ActionDeliveryTarget, holderId: string) => Promise<ActionLeaseOp>;
         /**
          * Query the live delivery feed for a subscription.
          *
@@ -4384,4 +4464,4 @@ declare class WarmHubClient {
     private watchRepoQuery;
 }
 
-export { type AboutOptions, type AboutResult, type AccessResolveInput, type AccessResolveResult, 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 CollectionAddOp, type CollectionAddType, type CollectionTag, type ComponentInfo, type ComponentInstallResult, type ComponentList, type ComponentListOptions, type ComponentUninstallResult, 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 GlobalSearchOptions, type GlobalSearchResult, type GlobalSearchResultItem, 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 OperationBuilderAddInput, type OperationBuilderClient, type OperationBuilderOp, type OperationBuilderOptions, type OperationSubmitResult, type OrgAccessResult, 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 RenameOperation, type RenameResult, type RepoAccessResult, 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 };
+export { type AboutOptions, type AboutResult, type AccessResolveInput, type AccessResolveResult, type AccessTokenProvider, type ActionAttemptInfo, type ActionDeliveryTarget, 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 CollectionAddOp, type CollectionAddType, type CollectionTag, type ComponentInfo, type ComponentInstallResult, type ComponentList, type ComponentListOptions, type ComponentUninstallResult, 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 GlobalSearchOptions, type GlobalSearchResult, type GlobalSearchResultItem, type HeadResult, type HistoryResult, type HomepageFeaturedListsResult, 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 OperationBuilderAddInput, type OperationBuilderClient, type OperationBuilderOp, type OperationBuilderOptions, type OperationSubmitResult, type OrgAccessResult, 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 RenameOperation, type RenameResult, type RepoAccessResult, 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-XMQSHDUV.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-CJWKJDVX.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/react.js

@@ -1,5 +1,5 @@
-import { WarmHubClient } from './chunk-XMQSHDUV.js';
-export { DEFAULT_API_URL, SDK_VERSION, WarmHubClient, WarmHubError, toWarmHubError } from './chunk-XMQSHDUV.js';
+import { WarmHubClient } from './chunk-CJWKJDVX.js';
+export { DEFAULT_API_URL, SDK_VERSION, WarmHubClient, WarmHubError, toWarmHubError } from './chunk-CJWKJDVX.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.62.1",
+  "version": "0.64.0",
   "private": false,
   "type": "module",
   "description": "The TypeScript SDK for WarmHub — create repos, commit and query data, and compound knowledge with your AI agents.",
@@ -50,8 +50,7 @@
     }
   },
   "scripts": {
-    "prebuild": "tsc --noEmit",
-    "build": "tsup && bun run scripts/inject-doc-links.ts",
+    "build": "tsc --noEmit && tsup && bun run scripts/inject-doc-links.ts",
     "generate:api-contract": "bun run scripts/generate-api-contract.ts",
     "generate:backend-types": "bun run scripts/generate-backend-types.ts",
     "audit:api-contract": "bun run scripts/audit-api-contract.ts",