@warmhub/sdk-ts 0.64.0 → 0.66.0

package/dist/index.d.ts

@@ -265,6 +265,7 @@ type AccessResolveResult$1 = {
         visible: boolean;
         scopes: Array<'repo:read' | 'repo:write' | 'repo:configure' | 'repo:admin' | 'repo:action-callback'>;
         allowedMatches?: Array<string>;
+        repoDurableId?: string;
     }>;
     orgs: Array<{
         orgName: string;
@@ -315,38 +316,18 @@ type ComponentDetail = {
     ref?: string;
     componentName: string;
     version?: string;
-    state?: string;
+    state?: 'initiated' | 'active' | 'uninstalled';
     source?: string;
+    sourceUrl?: string;
     sourceRef?: string;
     resolvedSha?: string;
     manifestHash?: string;
     installedAt?: string;
-    checkedAt?: string;
     active: boolean;
-    wref: string;
     latestVersion?: string;
     updateAvailable?: boolean;
-    install: {
-        wref: string;
-        pinnedWref?: string;
-        name: string;
-        kind: 'shape' | 'thing' | 'assertion' | 'collection';
-        shape?: string;
-        shapeName?: string;
-        validatedShape?: string;
-        version: number;
-        data?: unknown;
-        active: boolean;
-        synthesized?: boolean;
-        aboutWref?: string;
-        committerWref?: string;
-        revisedBy?: string;
-        metadata?: {
-            durableId: string;
-            createdOn: number;
-            revisedOn: number;
-        };
-    };
+    installedManifest: unknown;
+    installComponentId?: string;
     ownedShapes: Array<{
         name: string;
         kind: 'shape';
@@ -377,6 +358,14 @@ type ComponentDetail = {
         };
     }>;
 };
+type ComponentHistoryResult = {
+    items: Array<{
+        ref: string;
+        kind: string;
+        version: string | null;
+        createdAt: number;
+    }>;
+};
 type ComponentInstallResult$1 = {
     componentRef: string;
     componentName: string;
@@ -391,15 +380,14 @@ type ComponentListResult = {
         ref?: string;
         componentName: string;
         version?: string;
-        state?: string;
+        state?: 'initiated' | 'active' | 'uninstalled';
         source?: string;
+        sourceUrl?: string;
         sourceRef?: string;
         resolvedSha?: string;
         manifestHash?: string;
         installedAt?: string;
-        checkedAt?: string;
         active: boolean;
-        wref: string;
         latestVersion?: string;
         updateAvailable?: boolean;
     }>;
@@ -409,15 +397,14 @@ type ComponentSummary = {
     ref?: string;
     componentName: string;
     version?: string;
-    state?: string;
+    state?: 'initiated' | 'active' | 'uninstalled';
     source?: string;
+    sourceUrl?: string;
     sourceRef?: string;
     resolvedSha?: string;
     manifestHash?: string;
     installedAt?: string;
-    checkedAt?: string;
     active: boolean;
-    wref: string;
     latestVersion?: string;
     updateAvailable?: boolean;
 };
@@ -426,6 +413,7 @@ type ComponentUninstallResult$1 = {
     componentName: string;
     state: 'uninstalled';
     pausedSubscriptions: Array<string>;
+    releasedShapes: Array<string>;
     tokensRevoked: number;
     uninstallDispatched: boolean;
     warnings: Array<string>;
@@ -789,6 +777,48 @@ type RepoDescribeResult$1 = {
         synthesized: boolean;
     }>;
 };
+type RepoExploreInput = {
+    search?: string;
+    org?: string;
+    activity?: 'week' | 'month';
+    hasSubscriptions?: true;
+    minThings?: number;
+    sort?: 'recentlyUpdated' | 'mostSubscribed' | 'mostThings' | 'nameAsc' | 'newest';
+    limit?: number;
+    cursor?: string;
+    slugs?: Array<string>;
+};
+type RepoExploreItem$1 = {
+    orgName: string;
+    orgDisplayName?: string;
+    name: string;
+    displayName: string;
+    description?: string;
+    createdAt: number;
+    lastWriteAt?: number;
+    subscriptionCount: number;
+    thingCount: number;
+};
+type RepoExploreResult$1 = {
+    items: Array<{
+        orgName: string;
+        orgDisplayName?: string;
+        name: string;
+        displayName: string;
+        description?: string;
+        createdAt: number;
+        lastWriteAt?: number;
+        subscriptionCount: number;
+        thingCount: number;
+    }>;
+    nextCursor?: string;
+    total?: number;
+    orgs?: Array<{
+        name: string;
+        displayName?: string;
+        count: number;
+    }>;
+};
 type RepoForCaller = {
     orgName: string;
     name: string;
@@ -2172,6 +2202,13 @@ type ComponentView = ComponentDetail;
 /** @internal */
 type ComponentList = ComponentListResult;
 /** @internal */
+type ComponentHistory = ComponentHistoryResult;
+/** @internal */
+type ComponentHistoryOptions = {
+    componentRef?: string;
+    limit?: number;
+};
+/** @internal */
 type ComponentInstallResult = ComponentInstallResult$1;
 /** @internal */
 type ComponentUninstallResult = ComponentUninstallResult$1;
@@ -2406,6 +2443,43 @@ type RepoListForCallerOptions = {
     limit?: number;
     sort?: 'recent' | 'name';
 };
+/**
+ * Options for the public "Explore" directory (`client.repo.explore`).
+ *
+ * Structural alias of the generated `RepoExploreInput` (sourced from the
+ * backend `repoExploreInputSchema` via the backend-types pipeline), so it
+ * can't drift from the procedure's input contract.
+ *
+ * Two mutually-exclusive modes: the browse mode
+ * (`search`/`org`/`activity`/`hasSubscriptions`/`minThings`/`sort`/`limit`/`cursor`)
+ * and the exact-match `slugs` batch lookup. `slugs` cannot be combined with any
+ * browse/search/sort/filter field — the backend rejects the mix.
+ *
+ * @internal
+ */
+type RepoExploreOptions = RepoExploreInput;
+/**
+ * A repository row in the public "Explore" directory
+ * (`client.repo.explore`).
+ *
+ * Structural alias of the generated `RepoExploreItem` (sourced from the backend
+ * `repoExploreItemSchema` via the backend-types pipeline), so it can't drift.
+ *
+ * @internal
+ */
+type RepoExploreItem = RepoExploreItem$1;
+/**
+ * Result of the public "Explore" directory (`client.repo.explore`).
+ *
+ * `total` and `orgs` are first-page only (present when `cursor` is absent).
+ *
+ * Structural alias of the generated `RepoExploreResult` (sourced from the
+ * backend `repoExploreResultSchema` via the backend-types pipeline), so it
+ * can't drift.
+ *
+ * @internal
+ */
+type RepoExploreResult = RepoExploreResult$1;
 /** @internal */
 type CurrentUserInfo = {
     id: string;
@@ -2923,6 +2997,8 @@ type SearchOptions = Omit<FilterOptions, 'where'> & {
     about?: string;
     /** Search mode: `text` (BM25), `vector` (semantic), or `hybrid` (combined). Defaults to `text`. */
     mode?: 'text' | 'vector' | 'hybrid';
+    /** Opt into deterministic literal name matching before ranked search. Intended for UI list filtering; defaults to ranked search. */
+    nameMatch?: 'ranked' | 'deterministic';
     /** Expand collection members in the result; pages may be sparse when set. */
     resolveCollections?: boolean;
     /** Exclude internal infrastructure shapes from results. */
@@ -3267,6 +3343,12 @@ declare class WarmHubClient {
          * Fetch one installed component by its `Org/Name` ref.
          */
         get: (orgName: string, repoName: string, componentRef: string) => Promise<ComponentView>;
+        /**
+         * Install lifecycle timeline from the durable install-events log (GH-4690).
+         * Omit `componentRef` for the repo-wide activity feed; pass `Org/Name` for a
+         * single component's history.
+         */
+        history: (orgName: string, repoName: string, opts?: ComponentHistoryOptions) => Promise<ComponentHistory>;
         /**
          * Install a registered component into a repository (GH-4610).
          *
@@ -3614,6 +3696,30 @@ declare class WarmHubClient {
          * the org-scoped `listPage` from token-authenticated contexts.
          */
         listForCaller: (opts?: RepoListForCallerOptions) => Promise<RepoRecentInfo[]>;
+        /**
+         * Browse the public "Explore" directory: every `visibility='public'` live
+         * repository across all orgs, with search, org/activity/subscription/thing
+         * filters, and sort. No auth required — anonymous callers see the same
+         * public-only listing.
+         *
+         * Two mutually-exclusive modes. Browse mode paginates a filtered, sorted
+         * listing (`search`/`org`/`activity`/`hasSubscriptions`/`minThings`/`sort`/
+         * `limit`/`cursor`). Slugs mode is an exact-match batch lookup: pass up to
+         * 12 `org/repo` slugs to resolve just those live public repos in input
+         * order, ignoring every browse field. Combining `slugs` with any browse/
+         * search/sort/filter field is a hard input error, not a silently-filtered
+         * list.
+         *
+         * `total` and `orgs` (the org-filter facet) are returned on the first page
+         * only — i.e. when `cursor` is absent.
+         *
+         * Cursor contract: cursors are short-lived resume tokens for the same query
+         * and result scope. If filters, visibility, or backing streams change, the
+         * backend may reject a saved cursor with `VALIDATION_ERROR` / `Invalid
+         * cursor`; restart the query without `cursor` instead of retrying the stale
+         * token.
+         */
+        explore: (opts?: RepoExploreOptions) => Promise<RepoExploreResult>;
         /**
          * Fetch a repository's `Content/Readme` markdown record.
          *
@@ -4464,4 +4570,4 @@ declare class WarmHubClient {
     private watchRepoQuery;
 }
 
-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 };
+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 ComponentHistory, type ComponentHistoryOptions, 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 RepoExploreItem, type RepoExploreOptions, type RepoExploreResult, 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-CJWKJDVX.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-U5Z6ZS6A.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/react.js

@@ -1,5 +1,5 @@
-import { WarmHubClient } from './chunk-CJWKJDVX.js';
-export { DEFAULT_API_URL, SDK_VERSION, WarmHubClient, WarmHubError, toWarmHubError } from './chunk-CJWKJDVX.js';
+import { WarmHubClient } from './chunk-U5Z6ZS6A.js';
+export { DEFAULT_API_URL, SDK_VERSION, WarmHubClient, WarmHubError, toWarmHubError } from './chunk-U5Z6ZS6A.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.64.0",
+  "version": "0.66.0",
   "private": false,
   "type": "module",
   "description": "The TypeScript SDK for WarmHub — create repos, commit and query data, and compound knowledge with your AI agents.",