@warmhub/sdk-ts 0.52.1 → 0.54.0

package/dist/{chunk-OPTB23HY.js → chunk-I7PLCYOF.js}

@@ -2746,7 +2746,7 @@ async function submitOperationsViaStream(client, args) {
           orgName: args.orgName,
           repoName: args.repoName,
           streamId,
-          componentId: args.componentId,
+          componentRef: args.componentRef,
           committer: args.committer,
           message: args.message,
           operations: chunk
@@ -3652,7 +3652,7 @@ function validateWarmHubClientOptions(options) {
     throw new TypeError(`Unknown WarmHubClient option "${key}"${hint}`);
   }
 }
-var SDK_VERSION = "0.52.1" ;
+var SDK_VERSION = "0.54.0" ;
 var DEFAULT_API_URL = "https://api.warmhub.ai";
 var UNBATCHED_TRPC_PATHS = /* @__PURE__ */ new Set([
   "repo.shapeInstanceCounts",
@@ -4011,36 +4011,23 @@ var WarmHubClient = class _WarmHubClient {
     }
   };
   /**
-   * Lightweight permission checks for UI gating and service-side authorization probes.
+   * Effective-access resolution for UI gating and service-side authorization.
+   * First-party surface (web UI + whedge edge); the underlying `access.resolve`
+   * procedure is `@internal`.
+   * @internal
    */
   access = {
     /**
-     * Check whether the caller has a repo-scoped permission.
-     *
-     * @param permission Permission string such as `repo:read`, `repo:write`, `repo:configure`, or `repo:admin`.
+     * Resolve the caller's effective access for a batch of repos and/or orgs
+     * (addressed by name). Returns the coarse scope SET per target so one call
+     * answers any permission via `scopes.includes(...)` — e.g.
+     * `scopes.includes('repo:configure')`. Non-throwing: `visible: false` means
+     * not-found/not-visible; `scopes: []` means authenticated-but-no-access.
+     * Correlate results by the echoed `orgName`/`repoName`, not by position.
      */
-    checkRepoPermission: async (orgName, repoName, permission) => {
+    resolve: async (input) => {
       try {
-        return await this.trpc.access.checkRepoPermission.query({
-          orgName,
-          repoName,
-          permission
-        });
-      } catch (error) {
-        throw toWarmHubError(error);
-      }
-    },
-    /**
-     * Check whether the caller has an org-scoped permission.
-     *
-     * @param permission Permission string such as `org:read`, `org:configure`, or `org:admin`.
-     */
-    checkOrgPermission: async (orgName, permission) => {
-      try {
-        return await this.trpc.access.checkOrgPermission.query({
-          orgName,
-          permission
-        });
+        return await this.trpc.access.resolve.query(input);
       } catch (error) {
         throw toWarmHubError(error);
       }
@@ -4124,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 {
@@ -4138,14 +4131,30 @@ var WarmHubClient = class _WarmHubClient {
       }
     },
     /**
-     * Fetch one installed component by component ID.
+     * Search public registered components across all orgs (GH-4383).
+     * Public-only at launch. Distinct from listing components installed in a
+     * repo (`component.list`).
      */
-    get: async (orgName, repoName, componentId) => {
+    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.
+     */
+    get: async (orgName, repoName, componentRef) => {
       try {
         return await this.trpc.component.get.query({
           orgName,
           repoName,
-          componentId
+          componentRef
         });
       } catch (error) {
         throw toWarmHubError(error);
@@ -4282,7 +4291,7 @@ var WarmHubClient = class _WarmHubClient {
      * @param message Optional commit message stored with the submitted operations.
      * @param operations Add, revise, or retract operations to submit in order.
      * @param opts.committer Optional wref identifying the actor on whose behalf the write is made. Must be a full wref string like `"Agent/bot-1"` (a thing that already exists), or a cross-repo wref like `"wh:other-org/other-repo/Agent/bot-1"`. Bare names such as `"eval-runner"` are rejected by the backend with a "Thing wref required" error — there is no implicit shape.
-     * @param opts.componentId Attribute writes to an installed component when the caller is allowed to claim it.
+     * @param opts.componentRef Attribute writes to an installed component, identified by its `Org/Name` ref, when the caller is allowed to claim it.
      * @param opts.chunkSize Maximum operations per stream append. Values are clamped by the SDK.
      * @param opts.skipExisting Return `noop` for add operations whose target already exists.
      * @param opts.streamId Advanced continuation hook for caller-managed streams.
@@ -4295,7 +4304,7 @@ var WarmHubClient = class _WarmHubClient {
           repoName,
           committer: opts?.committer,
           message,
-          componentId: opts?.componentId,
+          componentRef: opts?.componentRef,
           chunkSize: opts?.chunkSize,
           skipExisting: opts?.skipExisting,
           streamId: opts?.streamId,
@@ -4635,6 +4644,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 {
@@ -4650,6 +4665,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.
      *
@@ -4808,6 +4838,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 {
@@ -4956,7 +4992,7 @@ var WarmHubClient = class _WarmHubClient {
           orgName,
           repoName,
           match: opts?.match,
-          componentId: opts?.componentId,
+          componentRef: opts?.componentRef,
           excludeComponents: opts?.excludeComponents,
           includeRetracted: opts?.includeRetracted
         });
@@ -5090,6 +5126,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 {
@@ -5356,6 +5398,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 {
@@ -5449,6 +5497,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,7 +5517,7 @@ var WarmHubClient = class _WarmHubClient {
           includeRetracted: opts?.includeRetracted,
           limit: opts?.limit,
           cursor: opts?.cursor,
-          componentId: opts?.componentId,
+          componentRef: opts?.componentRef,
           excludeComponents: opts?.excludeComponents,
           excludeInfraShapes: opts?.excludeInfraShapes,
           where: opts?.where
@@ -5476,6 +5530,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(
@@ -5488,6 +5548,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 ?? {};
@@ -5703,6 +5769,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 {
@@ -5759,6 +5831,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`,
@@ -5794,6 +5872,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(
@@ -5806,6 +5890,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 ?? {};
@@ -5820,6 +5910,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,7 +5931,7 @@ var WarmHubClient = class _WarmHubClient {
           resolveCollections: opts?.resolveCollections,
           limit: opts?.limit,
           cursor: opts?.cursor,
-          componentId: opts?.componentId,
+          componentRef: opts?.componentRef,
           excludeComponents: opts?.excludeComponents,
           excludeInfraShapes: opts?.excludeInfraShapes,
           where: opts?.where
@@ -5848,6 +5944,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(
@@ -5860,6 +5962,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 ?? {};
@@ -5874,6 +5982,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 {
@@ -5890,7 +6004,7 @@ var WarmHubClient = class _WarmHubClient {
           resolveCollections: opts?.resolveCollections,
           limit: opts?.limit,
           cursor: opts?.cursor,
-          componentId: opts?.componentId,
+          componentRef: opts?.componentRef,
           excludeComponents: opts?.excludeComponents,
           excludeInfraShapes: opts?.excludeInfraShapes,
           mode: opts?.mode
@@ -5914,7 +6028,7 @@ var WarmHubClient = class _WarmHubClient {
           match: opts?.match,
           includeRetracted: opts?.includeRetracted,
           resolveCollections: opts?.resolveCollections,
-          componentId: opts?.componentId,
+          componentRef: opts?.componentRef,
           excludeComponents: opts?.excludeComponents,
           excludeInfraShapes: opts?.excludeInfraShapes,
           where: opts?.where
@@ -5927,6 +6041,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 {
@@ -5947,6 +6067,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(
@@ -5959,6 +6085,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 ?? {};
@@ -5978,6 +6110,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(
@@ -5999,6 +6137,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(
@@ -6016,6 +6160,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(
@@ -6605,5 +6755,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-OPTB23HY.js.map
-//# sourceMappingURL=chunk-OPTB23HY.js.map
+//# sourceMappingURL=chunk-I7PLCYOF.js.map
+//# sourceMappingURL=chunk-I7PLCYOF.js.map