@warmhub/sdk-ts 0.69.1 → 0.71.0

package/dist/index.d.ts

@@ -60,6 +60,13 @@ declare const CLI_TIMESTAMP_HEADER = "X-WarmHub-Timestamp";
  */
 type CliHttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
 
+/** Every event type a webhook subscription can watch. */
+declare const SUBSCRIBABLE_EVENT_TYPES: readonly ["commit", "repo.renamed", "org.renamed", "org.member_added", "org.repo_created", "org.repo_published", "thing.renamed", "shape.renamed"];
+type SubscribableEventType = (typeof SUBSCRIBABLE_EVENT_TYPES)[number];
+/** Org-scoped events — created with an `orgName` and no `repoName`. */
+declare const ORG_SCOPED_EVENT_TYPES: readonly ["org.renamed", "org.member_added", "org.repo_created", "org.repo_published"];
+type OrgScopedEventType = (typeof ORG_SCOPED_EVENT_TYPES)[number];
+
 /**
  * Validate a data payload against shape field definitions.
  *
@@ -300,7 +307,7 @@ type CommitApplyResult = {
     }>;
 };
 type CollectionContainsResult$1 = {
-    type: 'pair' | 'set' | 'list' | 'triple';
+    type: 'arc' | 'bond' | 'pair' | 'set' | 'list' | 'triple';
     wref: string;
     version: number;
     results: Array<{
@@ -310,7 +317,7 @@ type CollectionContainsResult$1 = {
     }>;
 };
 type CollectionDiffResult$1 = {
-    type: 'pair' | 'set' | 'list' | 'triple';
+    type: 'arc' | 'bond' | 'pair' | 'set' | 'list' | 'triple';
     leftWref: string;
     rightWref: string;
     leftVersion: number;
@@ -319,45 +326,45 @@ type CollectionDiffResult$1 = {
     added: Array<{
         wref: string;
         position?: number;
-        fieldPath: 'first' | 'second' | 'third' | 'members' | 'items';
+        fieldPath: 'from' | 'to' | 'ends' | 'first' | 'second' | 'third' | 'members' | 'items';
     }>;
     removed: Array<{
         wref: string;
         position?: number;
-        fieldPath: 'first' | 'second' | 'third' | 'members' | 'items';
+        fieldPath: 'from' | 'to' | 'ends' | 'first' | 'second' | 'third' | 'members' | 'items';
     }>;
     unchanged: Array<{
         wref: string;
         position?: number;
-        fieldPath: 'first' | 'second' | 'third' | 'members' | 'items';
+        fieldPath: 'from' | 'to' | 'ends' | 'first' | 'second' | 'third' | 'members' | 'items';
     }>;
     changed: Array<{
         position: number;
         left?: {
             wref: string;
             position?: number;
-            fieldPath: 'first' | 'second' | 'third' | 'members' | 'items';
+            fieldPath: 'from' | 'to' | 'ends' | 'first' | 'second' | 'third' | 'members' | 'items';
         };
         right?: {
             wref: string;
             position?: number;
-            fieldPath: 'first' | 'second' | 'third' | 'members' | 'items';
+            fieldPath: 'from' | 'to' | 'ends' | 'first' | 'second' | 'third' | 'members' | 'items';
         };
     }>;
 };
 type CollectionMember$1 = {
     wref: string;
     position?: number;
-    fieldPath: 'first' | 'second' | 'third' | 'members' | 'items';
+    fieldPath: 'from' | 'to' | 'ends' | 'first' | 'second' | 'third' | 'members' | 'items';
 };
 type CollectionMembersPage$1 = {
-    type: 'pair' | 'set' | 'list' | 'triple';
+    type: 'arc' | 'bond' | 'pair' | 'set' | 'list' | 'triple';
     wref: string;
     version: number;
     items: Array<{
         wref: string;
         position?: number;
-        fieldPath: 'first' | 'second' | 'third' | 'members' | 'items';
+        fieldPath: 'from' | 'to' | 'ends' | 'first' | 'second' | 'third' | 'members' | 'items';
     }>;
     nextCursor?: string;
 };
@@ -371,7 +378,7 @@ type CollectionMutationResult$1 = {
     status: 'created' | 'updated' | 'noop';
 };
 type CollectionStatsResult$1 = {
-    type: 'pair' | 'set' | 'list' | 'triple';
+    type: 'arc' | 'bond' | 'pair' | 'set' | 'list' | 'triple';
     wref: string;
     version: number;
     memberCount: number;
@@ -773,8 +780,8 @@ type ThingGetManyResult$1 = {
         version: number;
         data?: unknown;
         collection?: {
-            type: 'pair' | 'set' | 'list' | 'triple';
-            memberField: 'first/second' | 'first/second/third' | 'members' | 'items';
+            type: 'arc' | 'bond' | 'pair' | 'set' | 'list' | 'triple';
+            memberField: 'from/to' | 'ends' | 'first/second' | 'first/second/third' | 'members' | 'items';
             memberCount: number;
             dataMode: 'full' | 'summary';
             fullData: boolean;
@@ -787,6 +794,7 @@ type ThingGetManyResult$1 = {
         synthesized?: boolean;
         aboutWref?: string;
         committerWref?: string;
+        createdBy?: string;
         revisedBy?: string;
         metadata?: {
             durableId: string;
@@ -2105,6 +2113,7 @@ type ShapeRemove = {
 type SubscriptionInfo = {
     name: string;
     kind: 'webhook' | 'cron';
+    eventType: SubscribableEventType;
     active: boolean;
     shapeName?: string;
     sourceRepo?: string;
@@ -2152,7 +2161,7 @@ type SubscriptionCompatCreateCommon = {
  *   `filterJson` object and a shape binding (`shapeName` or `filterJson.shape`).
  * - `repo.renamed` / `thing.renamed` / `shape.renamed` — repo-scoped metadata
  *   events; no shape/filter/source.
- * - `org.renamed` — org-scoped metadata event; no `repoName`/shape/filter/source.
+ * - org-scoped metadata events — no `repoName`/shape/filter/source.
  *
  * The metadata variants forbid the commit-only fields at the type level so
  * invalid shapes fail at compile time, not just server-side.
@@ -2172,7 +2181,7 @@ type SubscriptionCompatCreateInput = (SubscriptionCompatCreateCommon & {
     shapeName?: never;
     sourceRepoRef?: never;
 }) | (SubscriptionCompatCreateCommon & {
-    eventType: 'org.renamed';
+    eventType: OrgScopedEventType;
     repoName?: never;
     filterJson?: never;
     shapeName?: never;
@@ -2180,9 +2189,9 @@ type SubscriptionCompatCreateInput = (SubscriptionCompatCreateCommon & {
 });
 /**
  * Input shape for `client.subscription.update`. `orgName` and `name` identify
- * the subscription; omit `repoName` to update an org-scoped (`org.renamed`)
+ * the subscription; omit `repoName` to update an org-scoped
  * subscription. All other fields are optional and only the ones you provide get
- * patched. Metadata subscriptions (any `*.renamed`) reject
+ * patched. Metadata subscriptions reject
  * `shapeName`/`filterJson` — they have only delivery fields to edit.
  *
  * @see https://docs.warmhub.ai/subscriptions/managing/#update-subscription
@@ -2572,6 +2581,7 @@ type CurrentUserInfo = {
     externalId: string;
     identityWref: string | null;
     knockUserToken: string | null;
+    personalOrgName: string | null;
 } | null;
 /** @internal */
 type WhoamiScopeEntry = {
@@ -2666,8 +2676,8 @@ type ThingMetadata = {
 type CollectionReadDataMode = 'auto' | 'full';
 /** @internal */
 type CollectionReadSummary = {
-    type: 'pair' | 'set' | 'list' | 'triple';
-    memberField: 'first/second' | 'first/second/third' | 'members' | 'items';
+    type: 'arc' | 'bond' | 'pair' | 'set' | 'list' | 'triple';
+    memberField: 'from/to' | 'ends' | 'first/second' | 'first/second/third' | 'members' | 'items';
     memberCount: number;
     dataMode: 'full' | 'summary';
     fullData: boolean;
@@ -2747,6 +2757,12 @@ type ThingDetail = {
     synthesized?: boolean;
     aboutWref?: string;
     committerWref?: string;
+    /**
+     * #4848 Phase C: the thing's creator (first-version author), a peer of the
+     * current-version author `revisedBy`. Present for things created after Phase
+     * C; optional for legacy rows without trustworthy creator provenance.
+     */
+    createdBy?: string;
     /** #4848 Phase C: current-version author (renamed from createdByWref). */
     revisedBy?: string;
     metadata?: ThingMetadata;
@@ -2858,7 +2874,9 @@ type LiveRepoEvent = {
 type ActionListRunsOptions = {
     subscriptionName?: string;
     status?: 'pending' | 'running' | 'processing' | 'retry_wait' | 'succeeded' | 'suppressed' | 'failed_terminal' | 'dead_letter';
+    outcome?: 'succeeded' | 'failed';
     since?: number;
+    cursor?: string;
     limit?: number;
 };
 /** @internal */
@@ -3691,6 +3709,14 @@ declare class WarmHubClient {
          * Remove an active member or revoke a pending invite by email address.
          */
         removeMember: (orgName: string, email: string) => Promise<void>;
+        /**
+         * Leave an organization the caller is a member of (self-service).
+         *
+         * Session-only: requires an interactive user session, so personal access
+         * tokens are rejected. You cannot leave your personal organization, and an
+         * owner can only leave when the organization retains another active owner.
+         */
+        leave: (orgName: string) => Promise<void>;
         /**
          * Change a member's organization role.
          *
@@ -4012,16 +4038,21 @@ declare class WarmHubClient {
         /**
          * Create a webhook subscription.
          *
-         * 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 require a delivery URL. Commit subscriptions are
+         * repo-scoped and require a shape/filter; repo and org metadata
+         * subscriptions omit commit-only fields. Org-scoped events also omit
+         * `repoName`.
          *
-         * 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.
+         * Delivery can use a fallback URL, allow trace reentry, and opt into
+         * success notifications. Commit subscriptions can additionally forward
+         * events from another repository.
          */
         create: (input: SubscriptionCompatCreateInput) => Promise<SubscriptionInfo>;
         /**
          * Get one subscription by name.
          *
          * Repo-scoped subscriptions are addressed by `(orgName, repoName, name)`;
-         * org-scoped subscriptions (`org.renamed`) omit `repoName` via the object
+         * org-scoped subscriptions omit `repoName` via the object
          * form: `get({ orgName, name })`.
          */
         get: (...args: SubscriptionRefArgs) => Promise<SubscriptionInfo>;
@@ -4041,7 +4072,7 @@ declare class WarmHubClient {
          *
          * Pass `(orgName, repoName)` to list a repository's subscriptions, or omit
          * `repoName` — `list(orgName)` or `list({ orgName })` — to list the
-         * org-scoped (`org.renamed`) subscriptions.
+         * org-scoped subscriptions.
          */
         list: (...args: SubscriptionListArgs) => Promise<SubscriptionList>;
         /**
@@ -4134,16 +4165,24 @@ declare class WarmHubClient {
          */
         liveFeed: (orgName: string, repoName: string, subscriptionName: string, opts?: ActionLiveFeedOptions) => Promise<ActionLiveFeed>;
         /**
-         * List subscription action runs for a repository.
+         * List subscription action runs as a `Page<ActionRunInfo>` (`items` +
+         * optional `nextCursor`), newest-first, capped at 200 runs per page.
          *
-         * The result can be filtered by subscription name, status, and start time.
+         * `status` and `outcome` are mutually exclusive.
+         * `since` and `cursor` are mutually exclusive; pass `cursor` alone on later
+         * pages — the `since` window rides in the cursor.
+         * Cursors are opaque, short-lived resume tokens; on `VALIDATION_ERROR`
+         * restart the query without `cursor`.
+         * See docs/dev/warmhub-actions-api.md for the full contract.
          */
-        listRuns: (orgName: string, repoName: string, opts?: ActionListRunsOptions) => Promise<ActionRunInfo[]>;
+        listRuns: (orgName: string, repoName: string, opts?: ActionListRunsOptions) => Promise<Page<ActionRunInfo>>;
         /**
          * Aggregate run counts (total + per-status) for a repo or one subscription.
          *
-         * Computed server-side over an optional `since` window — not bounded by the
-         * `listRuns` row cap, so it reflects the full window regardless of volume.
+         * Computed server-side over an optional `since` window as a window
+         * aggregate — it counts every run in the window, whereas `listRuns` returns
+         * only a page sample of that pageable history. Use `runStats` for totals and
+         * `listRuns` to walk the individual runs page by page.
          */
         runStats: (orgName: string, repoName: string, opts?: ActionRunStatsOptions) => Promise<ActionRunStatsInfo>;
         /**
@@ -4721,16 +4760,24 @@ declare class WarmHubClient {
          */
         liveFeed: (orgName: string, repoName: string, subscriptionName: string, opts?: ActionLiveFeedOptions) => Promise<ActionLiveFeed>;
         /**
-         * List subscription action runs for a repository.
+         * List subscription action runs as a `Page<ActionRunInfo>` (`items` +
+         * optional `nextCursor`), newest-first, capped at 200 runs per page.
          *
-         * The result can be filtered by subscription name, status, and start time.
+         * `status` and `outcome` are mutually exclusive.
+         * `since` and `cursor` are mutually exclusive; pass `cursor` alone on later
+         * pages — the `since` window rides in the cursor.
+         * Cursors are opaque, short-lived resume tokens; on `VALIDATION_ERROR`
+         * restart the query without `cursor`.
+         * See docs/dev/warmhub-actions-api.md for the full contract.
          */
-        listRuns: (orgName: string, repoName: string, opts?: ActionListRunsOptions) => Promise<ActionRunInfo[]>;
+        listRuns: (orgName: string, repoName: string, opts?: ActionListRunsOptions) => Promise<Page<ActionRunInfo>>;
         /**
          * Aggregate run counts (total + per-status) for a repo or one subscription.
          *
-         * Computed server-side over an optional `since` window — not bounded by the
-         * `listRuns` row cap, so it reflects the full window regardless of volume.
+         * Computed server-side over an optional `since` window as a window
+         * aggregate — it counts every run in the window, whereas `listRuns` returns
+         * only a page sample of that pageable history. Use `runStats` for totals and
+         * `listRuns` to walk the individual runs page by page.
          */
         runStats: (orgName: string, repoName: string, opts?: ActionRunStatsOptions) => Promise<ActionRunStatsInfo>;
         /**

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

package/dist/react.js

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