@warmhub/sdk-ts 0.53.0 → 0.55.0

package/dist/{chunk-L5PODJ66.js → chunk-EXE36J6Z.js}

@@ -3652,7 +3652,7 @@ function validateWarmHubClientOptions(options) {
     throw new TypeError(`Unknown WarmHubClient option "${key}"${hint}`);
   }
 }
-var SDK_VERSION = "0.53.0" ;
+var SDK_VERSION = "0.55.0" ;
 var DEFAULT_API_URL = "https://api.warmhub.ai";
 var UNBATCHED_TRPC_PATHS = /* @__PURE__ */ new Set([
   "repo.shapeInstanceCounts",
@@ -4111,6 +4111,12 @@ var WarmHubClient = class _WarmHubClient {
      * List components installed in a repository.
      *
      * Pass pagination options when a repository may have many installed components.
+     *
+     * 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.
      */
     list: async (orgName, repoName, opts) => {
       try {
@@ -4124,6 +4130,22 @@ var WarmHubClient = class _WarmHubClient {
         throw toWarmHubError(error);
       }
     },
+    /**
+     * Search public registered components across all orgs (GH-4383).
+     * Public-only at launch. Distinct from listing components installed in a
+     * repo (`component.list`).
+     */
+    search: async (query, opts) => {
+      try {
+        return await this.trpc.component.search.query({
+          query,
+          limit: opts?.limit,
+          cursor: opts?.cursor
+        });
+      } catch (error) {
+        throw toWarmHubError(error);
+      }
+    },
     /**
      * Fetch one installed component by its `Org/Name` ref.
      */
@@ -4138,6 +4160,57 @@ var WarmHubClient = class _WarmHubClient {
         throw toWarmHubError(error);
       }
     },
+    /**
+     * Install a registered component into a repository (GH-4610).
+     *
+     * Backend-driven: the server resolves the registration and its latest
+     * published manifest, reconciles the shapes/subscriptions/credentials/seeds
+     * into the target repo, and runs the component's optional setup callback —
+     * the same pipeline `wh component install <org/name>` drives. `orgName` /
+     * `repoName` identify the INSTALL repo; `componentRef` is the
+     * `<org>/<name>` of the component to install. Requires `things:write` on the
+     * install repo; private registrations require owner-org membership.
+     *
+     * Reinstall is idempotent: the install identity (`installId`) is reused so
+     * runtime tokens keyed on it survive teardown/reinstall.
+     */
+    install: async (orgName, repoName, componentRef) => {
+      try {
+        return await this.trpc.component.install.mutate({
+          orgName,
+          repoName,
+          componentRef
+        });
+      } catch (error) {
+        throw toWarmHubError(error);
+      }
+    },
+    /**
+     * Uninstall a registered component from a repository (GH-4677).
+     *
+     * Backend-driven terminal teardown — the sibling of {@link install}: the
+     * server pauses the install's subscriptions per the manifest teardown
+     * policy, revokes its tokens in place, dispatches the component's optional
+     * uninstall callback, and marks the repo-local `ComponentInstall` record
+     * `uninstalled`. The same pipeline `wh component teardown <org/name>` drives.
+     * `orgName` / `repoName` identify the INSTALL repo; `componentRef` is the
+     * `<org>/<name>` of the component. Requires `things:write` on the install
+     * repo; private registrations require owner-org membership.
+     *
+     * Non-destructive: manifest shapes and seeded data are left intact (only
+     * repo deletion removes those) and reinstall revives the install.
+     */
+    uninstall: async (orgName, repoName, componentRef) => {
+      try {
+        return await this.trpc.component.uninstall.mutate({
+          orgName,
+          repoName,
+          componentRef
+        });
+      } catch (error) {
+        throw toWarmHubError(error);
+      }
+    },
     /**
      * Registered-component identity and install-pipeline operations.
      *
@@ -4622,6 +4695,12 @@ var WarmHubClient = class _WarmHubClient {
      * List repositories in an organization.
      *
      * Archived repositories are hidden by default. Search and sort options are applied before pagination.
+     *
+     * 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.
      */
     list: async (orgName, opts) => {
       try {
@@ -4637,6 +4716,21 @@ var WarmHubClient = class _WarmHubClient {
         throw toWarmHubError(error);
       }
     },
+    /**
+     * Search public repos across all orgs (GH-4383). Public-only at launch;
+     * BM25 over name/description/shape vocabulary/README.
+     */
+    search: async (query, opts) => {
+      try {
+        return await this.trpc.repo.search.query({
+          query,
+          limit: opts?.limit,
+          cursor: opts?.cursor
+        });
+      } catch (error) {
+        throw toWarmHubError(error);
+      }
+    },
     /**
      * Create a repository inside an organization.
      *
@@ -4795,6 +4889,12 @@ var WarmHubClient = class _WarmHubClient {
      * Each item includes exact active counts, an activity-oriented `lastWriteAt`, and a `hasErrors` flag for terminal action failures.
      *
      * Search and sort are applied before pagination, so cursors remain stable across the filtered and ordered list.
+     *
+     * 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.
      */
     listPage: async (orgName, opts) => {
       try {
@@ -5077,6 +5177,12 @@ var WarmHubClient = class _WarmHubClient {
      * Return add, revise, retract, and rename history for a shape.
      *
      * Use pagination options for long-lived shapes with many revisions.
+     *
+     * 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.
      */
     history: async (orgName, repoName, name, opts = {}) => {
       try {
@@ -5343,6 +5449,12 @@ var WarmHubClient = class _WarmHubClient {
      * Query the live delivery feed for a subscription.
      *
      * Use this for polling or live-log views that need recent delivery status entries.
+     *
+     * 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.
      */
     liveFeed: async (orgName, repoName, subscriptionName, opts) => {
       try {
@@ -5436,6 +5548,12 @@ var WarmHubClient = class _WarmHubClient {
      * Filter by shape, kind, assertion target, or glob `match` pattern, and choose the data mode appropriate for the payload size. Component filters can narrow results to component-owned records or hide component infrastructure records.
      *
      * Tokenless reads of public repositories have stricter page-size and page-count limits than authenticated reads.
+     *
+     * 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.
      */
     head: async (orgName, repoName, opts) => {
       try {
@@ -5463,6 +5581,12 @@ var WarmHubClient = class _WarmHubClient {
      * Iterate every current HEAD row matching the supplied filters.
      *
      * Prefer this over hand-written cursor loops when scanning all matching records. Pass `opts.cursor` to resume from a saved cursor; the iterator advances the cursor automatically after the first request. Pass `limit` to control page size.
+     *
+     * 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.
      */
     headIter: (orgName, repoName, opts) => {
       return paginate(
@@ -5475,6 +5599,12 @@ var WarmHubClient = class _WarmHubClient {
      * Materialize every current HEAD row matching the supplied filters.
      *
      * Use `max` to guard memory usage; throws a `WarmHubError` with kind `VALIDATION_ERROR` once more than `max` items have actually been observed across pages.
+     *
+     * 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.
      */
     headAll: async (orgName, repoName, opts) => {
       const { max, ...pageOpts } = opts ?? {};
@@ -5690,6 +5820,12 @@ var WarmHubClient = class _WarmHubClient {
      * Return version history and timeline metadata for repository records.
      *
      * Provide at least one selector: a concrete wref, a shape filter, or an assertion target. Shape- and target-filtered histories support pagination and optional collection resolution.
+     *
+     * 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.
      */
     history: async (orgName, repoName, opts) => {
       try {
@@ -5746,6 +5882,12 @@ var WarmHubClient = class _WarmHubClient {
      *
      * Filter by assertion shape or glob `match` pattern, optionally resolve collection targets, and page through large assertion sets with `limit` and `cursor`.
      *
+     * 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.
+     *
      * Returns `{ target?, assertions, nextCursor? }`.
      * The array is named `assertions`, **not** `items`. This breaks the repo-wide
      * `items` convention used by `HeadResult`, `FilterResult`, `SearchResult`,
@@ -5781,6 +5923,12 @@ var WarmHubClient = class _WarmHubClient {
      * Iterate every assertion about a thing or collection target.
      *
      * Prefer this over hand-written cursor loops when scanning all matching assertions. The iterator reads the `assertions` envelope field and advances the cursor automatically; pass `opts.cursor` to resume from a saved cursor and `limit` to control page size.
+     *
+     * 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.
      */
     aboutIter: (orgName, repoName, wref, opts) => {
       return paginate(
@@ -5793,6 +5941,12 @@ var WarmHubClient = class _WarmHubClient {
      * Materialize every assertion about a thing or collection target.
      *
      * Use `max` to guard memory usage; throws a `WarmHubError` with kind `VALIDATION_ERROR` once more than `max` assertions have actually been observed across pages.
+     *
+     * 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.
      */
     aboutAll: async (orgName, repoName, wref, opts) => {
       const { max, ...pageOpts } = opts ?? {};
@@ -5807,6 +5961,12 @@ var WarmHubClient = class _WarmHubClient {
      * Query repository records by shape, kind, assertion target, text filters, or glob `match` pattern.
      *
      * Use this for structured reads where the caller controls filters. For ranked text or vector search, use `thing.search`. For count-only reads, use `thing.count`.
+     *
+     * 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.
      */
     query: async (orgName, repoName, opts) => {
       try {
@@ -5835,6 +5995,12 @@ var WarmHubClient = class _WarmHubClient {
      * Iterate every repository record matching the supplied filters.
      *
      * Prefer this over hand-written cursor loops when scanning all matching records. Pass `opts.cursor` to resume from a saved cursor; the iterator advances the cursor automatically after the first request. Pass `limit` to control page size.
+     *
+     * 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.
      */
     queryIter: (orgName, repoName, opts) => {
       return paginate(
@@ -5847,6 +6013,12 @@ var WarmHubClient = class _WarmHubClient {
      * Materialize every repository record matching the supplied filters.
      *
      * Use `max` to guard memory usage; throws a `WarmHubError` with kind `VALIDATION_ERROR` once more than `max` items have actually been observed across pages.
+     *
+     * 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.
      */
     queryAll: async (orgName, repoName, opts) => {
       const { max, ...pageOpts } = opts ?? {};
@@ -5861,6 +6033,12 @@ var WarmHubClient = class _WarmHubClient {
      * Search repository records with text, vector, or hybrid mode.
      *
      * When searching with an assertion target or collection resolution, pages may be sparse; keep paginating until `nextCursor` 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.
      */
     search: async (orgName, repoName, query, opts) => {
       try {
@@ -5914,6 +6092,12 @@ var WarmHubClient = class _WarmHubClient {
      * Query wref-typed field references for a record.
      *
      * Inbound mode finds records whose wref fields point at the supplied wref. Outbound mode finds records that the supplied record points to. Inbound queries can be narrowed to a field path.
+     *
+     * 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.
      */
     refs: async (orgName, repoName, wref, opts) => {
       try {
@@ -5934,6 +6118,12 @@ var WarmHubClient = class _WarmHubClient {
      * Iterate every wref-typed field reference for a record.
      *
      * Prefer this over hand-written cursor loops when scanning all matching references. Pass `opts.cursor` to resume from a saved cursor; the iterator advances the cursor automatically after the first request. Pass `limit` to control page size.
+     *
+     * 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.
      */
     refsIter: (orgName, repoName, wref, opts) => {
       return paginate(
@@ -5946,6 +6136,12 @@ var WarmHubClient = class _WarmHubClient {
      * Materialize every wref-typed field reference for a record.
      *
      * Use `max` to guard memory usage; throws a `WarmHubError` with kind `VALIDATION_ERROR` once more than `max` refs have actually been observed across pages.
+     *
+     * 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.
      */
     refsAll: async (orgName, repoName, wref, opts) => {
       const { max, ...pageOpts } = opts ?? {};
@@ -5965,6 +6161,12 @@ var WarmHubClient = class _WarmHubClient {
      * Stream refreshed `thing.head` results whenever the repository changes.
      *
      * The SDK re-runs the underlying `thing.head` query after each invalidation and passes the latest snapshot to `onUpdate`.
+     *
+     * 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.
      */
     thingHead: async (orgName, repoName, opts, onUpdate) => {
       return this.watchRepoQuery(
@@ -5986,6 +6188,12 @@ var WarmHubClient = class _WarmHubClient {
     },
     /**
      * Stream refreshed history results for a single wref whenever the repository changes.
+     *
+     * 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.
      */
     thingHistory: async (orgName, repoName, opts, onUpdate) => {
       return this.watchRepoQuery(
@@ -6003,6 +6211,12 @@ var WarmHubClient = class _WarmHubClient {
     },
     /**
      * Stream refreshed action live-feed entries for a subscription.
+     *
+     * 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.
      */
     subscriptionLog: async (orgName, repoName, subscriptionName, opts, onUpdate) => {
       return this.watchRepoQuery(
@@ -6592,5 +6806,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-L5PODJ66.js.map
-//# sourceMappingURL=chunk-L5PODJ66.js.map
+//# sourceMappingURL=chunk-EXE36J6Z.js.map
+//# sourceMappingURL=chunk-EXE36J6Z.js.map