@warmhub/sdk-ts 0.107.0 → 0.108.0

package/dist/index.d.ts

@@ -1,3 +1,5 @@
+import { z } from 'zod';
+
 type ActionAttempt = {
     attempt: number;
     status: string;
@@ -5027,32 +5029,6 @@ type RepositoryCheckpointStatus$1 = {
         sha256: string;
         contentType: 'application/zip';
     };
-} | {
-    checkpointId: string;
-    repoSeq: number;
-    contractVersion: 2;
-    attemptsStarted: number;
-    runAgeMs: number;
-    createdAt: number;
-    updatedAt: number;
-    runStartedAt: number;
-    state: 'failed';
-    completedAt: number;
-    failureCode: 'deadline_exceeded' | 'attempts_exhausted';
-    nextAction: 'retry';
-} | {
-    checkpointId: string;
-    repoSeq: number;
-    contractVersion: 2;
-    attemptsStarted: number;
-    runAgeMs: number;
-    createdAt: number;
-    updatedAt: number;
-    runStartedAt: number;
-    state: 'failed';
-    completedAt: number;
-    failureCode: 'invalid_source';
-    nextAction: 'generate';
 } | {
     checkpointId: string;
     repoSeq: number;
@@ -5077,7 +5053,7 @@ type RepositoryCheckpointStatus$1 = {
     runStartedAt: number;
     state: 'failed';
     completedAt: number;
-    failureCode: 'repository_deleted';
+    failureCode: 'deadline_exceeded' | 'attempts_exhausted' | 'invalid_source' | 'repository_deleted';
     nextAction: 'none';
 };
 type RepoConfigureStats = {
@@ -5529,6 +5505,105 @@ type OrgScopedEventType = (typeof ORG_SCOPED_EVENT_TYPES)[number];
  */
 declare function operationEventStreamRequestId(submissionId: string, chunkOrdinal: number): string;
 
+type JsonValue = null | boolean | number | string | JsonValue[] | {
+    [key: string]: JsonValue;
+};
+
+declare const REPOSITORY_EXPORT_MODES: readonly ["heads", "ops"];
+declare const repositoryExportRowSchema: z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"shape">;
+    shapes: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        v: z.ZodNumber;
+        durableId: z.ZodString;
+        provenance: z.ZodEnum<{
+            captured: "captured";
+            "migration-stamped": "migration-stamped";
+            reconstructed: "reconstructed";
+        }>;
+        declared: z.ZodBoolean;
+    }, z.core.$strict>>;
+    active: z.ZodLiteral<true>;
+    data: z.ZodRecord<z.ZodString, z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>;
+    wref: z.ZodString;
+    durableId: z.ZodString;
+    version: z.ZodNumber;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodEnum<{
+        thing: "thing";
+        collection: "collection";
+    }>;
+    shapes: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        v: z.ZodNumber;
+        durableId: z.ZodString;
+        provenance: z.ZodEnum<{
+            captured: "captured";
+            "migration-stamped": "migration-stamped";
+            reconstructed: "reconstructed";
+        }>;
+        declared: z.ZodBoolean;
+    }, z.core.$strict>>;
+    active: z.ZodLiteral<true>;
+    data: z.ZodRecord<z.ZodString, z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>;
+    wref: z.ZodString;
+    durableId: z.ZodString;
+    version: z.ZodNumber;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"assertion">;
+    shapes: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        v: z.ZodNumber;
+        durableId: z.ZodString;
+        provenance: z.ZodEnum<{
+            captured: "captured";
+            "migration-stamped": "migration-stamped";
+            reconstructed: "reconstructed";
+        }>;
+        declared: z.ZodBoolean;
+    }, z.core.$strict>>;
+    about: z.ZodObject<{
+        wref: z.ZodString;
+        v: z.ZodOptional<z.ZodNumber>;
+        durableId: z.ZodString;
+    }, z.core.$strict>;
+    affirmed: z.ZodArray<z.ZodObject<{
+        wref: z.ZodString;
+        v: z.ZodOptional<z.ZodNumber>;
+        durableId: z.ZodString;
+    }, z.core.$strict>>;
+    active: z.ZodLiteral<true>;
+    data: z.ZodRecord<z.ZodString, z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>;
+    wref: z.ZodString;
+    durableId: z.ZodString;
+    version: z.ZodNumber;
+}, z.core.$strict>], "kind">, z.ZodObject<{
+    kind: z.ZodEnum<{
+        shape: "shape";
+        thing: "thing";
+        assertion: "assertion";
+        collection: "collection";
+    }>;
+    active: z.ZodLiteral<false>;
+    wref: z.ZodString;
+    durableId: z.ZodString;
+    version: z.ZodNumber;
+}, z.core.$strict>]>;
+declare const repositoryExportHeaderSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"header">;
+    formatVersion: z.ZodLiteral<3>;
+    repo: z.ZodString;
+    mode: z.ZodEnum<{
+        ops: "ops";
+        heads: "heads";
+    }>;
+    sinceRepoSeq: z.ZodNumber;
+    atRepoSeq: z.ZodNumber;
+}, z.core.$strict>;
+type RepositoryExportMode = (typeof REPOSITORY_EXPORT_MODES)[number];
+type RepositoryExportRow = z.infer<typeof repositoryExportRowSchema>;
+type RepositoryExportHeader = z.infer<typeof repositoryExportHeaderSchema>;
+
 /**
  * Warning details for input fields that no shape in the effective set declares.
  * @see https://docs.warmhub.ai/sdk-reference/type-aliases/undeclaredfieldswarning/
@@ -5999,6 +6074,254 @@ type WarmHubDecorations = Record<string, string>;
  */
 declare function getResponseDecorations(result: unknown): WarmHubDecorations | undefined;
 
+/**
+ * A materialized export, keyed by the identity that survives renames.
+ * @see https://docs.warmhub.ai/sdk-reference/type-aliases/repositoryexportrowmap/
+ */
+type RepositoryExportRowMap = ReadonlyMap<string, RepositoryExportRow>;
+/**
+ * Any row collection {@link applyRepositoryExportDelta} accepts: a materialized
+ * map from a previous fold, or a plain iterable of rows straight off a stream.
+ * @see https://docs.warmhub.ai/sdk-reference/type-aliases/repositoryexportrows/
+ */
+type RepositoryExportRows = Iterable<RepositoryExportRow> | RepositoryExportRowMap;
+/**
+ * Fold a delta export onto a base, by `durableId`: active rows upsert, and
+ * tombstones remove. Pure — neither argument is mutated — and order-dependent
+ * within each argument, so the last row for an identity wins.
+ * @see https://docs.warmhub.ai/sdk-reference/functions/applyrepositoryexportdelta/
+ */
+declare function applyRepositoryExportDelta(base: RepositoryExportRows, delta: RepositoryExportRows): Map<string, RepositoryExportRow>;
+
+/**
+ * Stable failure categories produced while reading a repository export stream.
+ *
+ * Every reason except `since_below_epoch_floor` is a local verification
+ * verdict: the bytes the server sent do not prove what the trailer claims.
+ * `since_below_epoch_floor` is the server's own refusal and is surfaced
+ * distinctly so callers can fall back to a full export.
+ * @see https://docs.warmhub.ai/sdk-reference/type-aliases/repositoryexporterrorreason/
+ */
+type RepositoryExportErrorReason = 'count_mismatch' | 'digest_mismatch' | 'fence_mismatch' | 'header_invalid' | 'row_invalid' | 'row_out_of_order' | 'since_below_epoch_floor' | 'trailer_invalid' | 'truncated';
+/**
+ * A repository export protocol or verification failure.
+ * @see https://docs.warmhub.ai/sdk-reference/classes/repositoryexporterror/
+ */
+declare class RepositoryExportError extends Error {
+    readonly reason: RepositoryExportErrorReason;
+    readonly name = "RepositoryExportError";
+    constructor(reason: RepositoryExportErrorReason, message?: string);
+}
+/**
+ * The verification state of one logical export stream.
+ *
+ * A resumed request carries no header, and its trailer covers only the rows of
+ * that segment — the server cannot know what a client already read. So the
+ * session keeps two hashers: a per-segment one, which each segment's trailer is
+ * checked against, and a whole-stream one, which accumulates across every
+ * segment and is what the caller should record as the export's content digest.
+ * For a stream that never broke the two agree, and the trailer proves both.
+ * @see https://docs.warmhub.ai/sdk-reference/classes/repositoryexportsession/
+ */
+declare class RepositoryExportSession {
+    #private;
+    /**
+     * The header of the opening segment; resumed segments repeat none.
+     * @see https://docs.warmhub.ai/sdk-reference/classes/repositoryexportsession/#header
+     */
+    get header(): RepositoryExportHeader | undefined;
+    /**
+     * Cursor for `afterDurableId` when resuming a broken stream.
+     * @see https://docs.warmhub.ai/sdk-reference/classes/repositoryexportsession/#lastdurableid
+     */
+    get lastDurableId(): string | undefined;
+    /**
+     * Rows verified so far across every segment.
+     * @see https://docs.warmhub.ai/sdk-reference/classes/repositoryexportsession/#rowcount
+     */
+    get rowCount(): number;
+    /**
+     * Rows verified in the segment currently being read.
+     * @see https://docs.warmhub.ai/sdk-reference/classes/repositoryexportsession/#segmentrowcount
+     */
+    get segmentRowCount(): number;
+    /**
+     * The whole logical stream's content digest, available once the stream has
+     * been finalized — by its closing trailer, or by `finalizeContentSha256`.
+     * @see https://docs.warmhub.ai/sdk-reference/classes/repositoryexportsession/#contentsha256
+     */
+    get contentSha256(): string | undefined;
+    /**
+     * End the session early and read the digest of what was verified. Useful when
+     * a stream will not be resumed; the session cannot be read from again.
+     * @see https://docs.warmhub.ai/sdk-reference/classes/repositoryexportsession/#finalizecontentsha256
+     */
+    finalizeContentSha256(): string;
+    /** @internal Start a fresh per-segment hasher for one HTTP response. */
+    beginSegment(): void;
+    /**
+     * @internal A segment failed its trailer — the bytes did not match what the
+     * server said it wrote. The stream digest has already absorbed those rows, so
+     * this session can never produce a trustworthy total again.
+     */
+    markUnverifiable(): void;
+    /** @internal The digest of the segment just read; spends the segment hasher. */
+    finalizeSegment(): string;
+    /** @internal Async-flow token, re-redeemed when a prepared download breaks. */
+    get token(): string | undefined;
+    /** @internal */
+    set token(value: string | undefined);
+    /**
+     * Whether this session's trailer has been verified.
+     * @see https://docs.warmhub.ai/sdk-reference/classes/repositoryexportsession/#complete
+     */
+    get complete(): boolean;
+    /** @internal Record the closing trailer and seal the whole-stream digest. */
+    markComplete(): void;
+    /** @internal Refuse a segment on a session whose digest is already sealed. */
+    assertResumable(): void;
+    /** @internal Only the opening segment carries a header; it must not change. */
+    adoptHeader(header: RepositoryExportHeader): void;
+    /** @internal */
+    recordRow(durableId: string, lineBytes: Uint8Array): void;
+}
+/**
+ * Create the session that carries verification state across an export's
+ * segments: the header, the resume cursor, and the whole-stream digest.
+ * @see https://docs.warmhub.ai/sdk-reference/functions/createrepositoryexportsession/
+ */
+declare function createRepositoryExportSession(): RepositoryExportSession;
+
+/**
+ * Options for `client.repo.export`: what to export (mode, delta base, fence)
+ * and how (sync stream or async token flow, resume cursor, abort signal).
+ * @see https://docs.warmhub.ai/sdk-reference/type-aliases/repositoryexportoptions/
+ */
+type RepositoryExportOptions = {
+    /** `heads` (default) exports current heads; `ops` exports the operation log. */
+    readonly mode?: RepositoryExportMode;
+    /** Delta base. Defaults to 0, a full export. */
+    readonly sinceRepoSeq?: number;
+    /** Pin the fence. Omit to let the server pin current and echo it back. */
+    readonly atRepoSeq?: number;
+    /**
+     * Resume cursor. Defaults to the session's last verified row, and needs a
+     * `session` carrying the opening header: a resumed request gets no header
+     * back, so without one there is nothing to check the repository and fence
+     * against.
+     */
+    readonly afterDurableId?: string;
+    /**
+     * `async` asks the server to prepare the export first, then redeems the
+     * returned token once it is ready. Defaults to a direct stream.
+     */
+    readonly prefer?: 'sync' | 'async';
+    /**
+     * Redeem a token from a previous `exportPrepare`, polling until the prepared
+     * export is ready. Use it to download an export a different process, or a
+     * different machine, asked for.
+     *
+     * Redemption returns a short-lived URL for the whole stored export object, so
+     * a token download always reads from the beginning: it cannot be continued
+     * with `afterDurableId`. A broken download restarts on a fresh session, and
+     * re-redeeming the token is a free lookup.
+     */
+    readonly token?: string;
+    /**
+     * Verification state. Pass a session back in to resume a broken stream: the
+     * rolling digest continues and the request is pinned to what it reached.
+     */
+    readonly session?: RepositoryExportSession;
+    /**
+     * How long to wait between redemption polls while an async export is still
+     * building. Defaults to one second, and is clamped up to a 50ms floor: the
+     * poll re-runs the full authorization gate, so a zero would spin it.
+     */
+    readonly pollIntervalMs?: number;
+    readonly signal?: AbortSignal;
+};
+/**
+ * What to prepare: the same window a direct stream takes, minus everything
+ * about reading one back.
+ *
+ * @internal
+ */
+type RepositoryExportPrepareOptions = Pick<RepositoryExportOptions, 'mode' | 'sinceRepoSeq' | 'atRepoSeq' | 'signal'>;
+/**
+ * A prepared export: the token that redeems it and the fence the server pinned.
+ *
+ * @internal
+ */
+type RepositoryExportPreparation = {
+    /** Redeem it with `export`'s `token` option, from anywhere. */
+    readonly exportToken: string;
+    /** The repository sequence the export is pinned to. */
+    readonly atRepoSeq: number;
+};
+
+/**
+ * What the caller asked for, which the header must agree with.
+ *
+ * @internal
+ */
+type RepositoryExportExpectation = {
+    readonly repo: string;
+    readonly mode: RepositoryExportMode;
+    /**
+     * Window bounds the caller stated explicitly. A token redemption sends only
+     * the token, so the header is the first place a stored job's window can be
+     * compared against what the caller asked for — undefined bounds are the
+     * caller delegating the choice, and only stated ones are enforced.
+     */
+    readonly sinceRepoSeq?: number;
+    readonly atRepoSeq?: number;
+};
+/**
+ * How to read one HTTP segment of an export.
+ *
+ * @internal
+ */
+type RepositoryExportSegmentOptions = {
+    /** True when the request carried `afterDurableId`, so no header is sent. */
+    readonly resumed?: boolean;
+};
+/**
+ * How to replay a saved export back into a session.
+ *
+ * @internal
+ */
+type RepositoryExportRestoreOptions = {
+    /**
+     * Accept bytes that stop before the trailer — an interrupted download, which
+     * is exactly what a resume continues from. The restored session is then not
+     * `complete`, and carries the cursor the saved bytes reached. Without it a
+     * missing trailer is `truncated`, as it is on the wire.
+     */
+    readonly partial?: boolean;
+};
+/**
+ * Read one HTTP response body as export records, verifying it against the
+ * session as it goes: header continuity, per-line canonical decode, the rolling
+ * digest, and finally the trailer.
+ * @see https://docs.warmhub.ai/sdk-reference/functions/readrepositoryexportstream/
+ */
+declare function readRepositoryExportStream(source: AsyncIterable<Uint8Array> | ReadableStream<Uint8Array>, session: RepositoryExportSession, expected: RepositoryExportExpectation, options?: RepositoryExportSegmentOptions): AsyncGenerator<RepositoryExportRow>;
+/**
+ * Replay a saved export's own bytes back into a fresh verification session.
+ *
+ * This is the offline twin of `readRepositoryExportStream`: the same header,
+ * canonical-row, ordering, and trailer checks, run over a file rather than a
+ * response body, and against no expected repository — a saved export is checked
+ * for what it says it is, not for what a caller hoped it would be. It returns
+ * the session rather than the rows, because the two things a caller needs from
+ * a saved file are proof (`complete`, `contentSha256`, `rowCount`) and the
+ * cursor a resume continues from (`header`, `lastDurableId`).
+ *
+ * Pass `partial` to accept bytes that stop before the trailer.
+ * @see https://docs.warmhub.ai/sdk-reference/functions/restorerepositoryexportsession/
+ */
+declare function restoreRepositoryExportSession(source: AsyncIterable<Uint8Array> | ReadableStream<Uint8Array>, options?: RepositoryExportRestoreOptions): Promise<RepositoryExportSession>;
+
 /**
  * Operations to submit, in order.
  *
@@ -8582,6 +8905,12 @@ declare class WarmHubClient {
     private readonly trpc;
     private compatibilityCheck?;
     private overrideNoticePrinted;
+    /**
+     * Repository export v3 streaming, exposed as `repo.export`. The transport
+     * closures are lazy, so this initializer runs before `apiUrl` is assigned
+     * without reading it.
+     */
+    private readonly repositoryExport;
     private noteCompatibilityOverride;
     private assertWriteCompatible;
     private createCompatibilityLink;
@@ -8993,19 +9322,16 @@ declare class WarmHubClient {
      */
     readonly repo: {
         /**
-         * Repository checkpoint lifecycle and artifact-access operations.
+         * Repository checkpoint status and artifact-access operations.
          *
-         * Reads require unrestricted `repo:read` plus `repo:checkpoint-read`;
-         * generation and retry additionally require `repo:checkpoint-generate`;
-         * `repo:admin` remains compatible for them.
+         * Reads require unrestricted `repo:read` plus `repo:checkpoint-read`.
+         * Checkpoint generation retired with export v3; use `repo.export` to
+         * produce a fresh snapshot.
          *
          * `getAccess` returns a signed artifact descriptor only. It does not fetch
          * the signed URL or attach the WarmHub bearer token to that URL.
          */
         checkpoint: {
-            generate: (orgName: string, repoName: string, options?: {
-                atLeastRepoSeq?: number;
-            }) => Promise<RepositoryCheckpointStatus>;
             status: (orgName: string, repoName: string, selector: {
                 checkpointId: string;
                 repoSeq?: never;
@@ -9028,8 +9354,26 @@ declare class WarmHubClient {
                     chunkPath: string;
                 };
             }) => Promise<RepositoryCheckpointAccess>;
-            retry: (orgName: string, repoName: string, checkpointId: string) => Promise<RepositoryCheckpointStatus>;
         };
+        /**
+         * Stream a verified repository export (wire format v3).
+         *
+         * Yields rows only after the header matches the repository and mode asked
+         * for, each line decodes canonically, and — at the end — the trailer's
+         * record count and content digest match what was actually read. A stream
+         * that breaks resumes by passing the same `session` back in.
+         */
+        export: (orgName: string, repoName: string, options?: RepositoryExportOptions) => AsyncGenerator<RepositoryExportRow>;
+        /**
+         * Ask the server to prepare an export and return the token that redeems it,
+         * without waiting for the fold or reading a byte.
+         *
+         * The fold runs off the request path, so a large export can be started by
+         * one process and downloaded later — or elsewhere — by passing the returned
+         * token to `export`. The token is redeemable only at this repository's URL,
+         * by a principal who holds checkpoint read there.
+         */
+        exportPrepare: (orgName: string, repoName: string, options?: RepositoryExportPrepareOptions) => Promise<RepositoryExportPreparation>;
         /**
          * Get a repository by organization and repository name.
          */
@@ -10373,4 +10717,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 ActionLiveFeedItem, 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 CollectionAddOp, type CollectionAddType, type CollectionContainsOptions, type CollectionContainsResult, type CollectionCreateOptions, type CollectionDiffOptions, type CollectionDiffResult, type CollectionMember, type CollectionMembersOptions, type CollectionMembersPage, type CollectionMembershipRole, type CollectionMutationResult, type CollectionQuerySourceOptions, type CollectionReadDataMode, type CollectionReadSummary, type CollectionReviseOptions, type CollectionStatsOptions, type CollectionStatsResult, type CollectionTag, type CollectionType, type CommitApplyCompatibilityResult, type CommitDiagnostic, type CommitRealOperationResult, type CommitValidateInput, type CommitValidateOptions, type CommitValidateResult, type ComponentHistory, type ComponentHistoryOptions, type ComponentInfo, type ComponentInstallOptions, type ComponentInstallResult, type ComponentList, type ComponentListOptions, type ComponentUninstallOptions, 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 Grant, type GrantCreateOptions, type GrantListOptions, type GrantListResult, type GrantRecipientSelector, type GrantRevokeResult, type HeadResult, type HistoryResult, type HistoryVersion, type HomepageFeaturedListsResult, type IndexedFieldEntry, type IndexedFieldsReport, type LiveHandle, type LiveRepoEvent, type LiveSubscriptionLogOptions, type LiveThingHeadOptions, type LiveThingHistoryOptions, type LiveWatchResult, MAX_COMMIT_VALIDATION_ENCODED_BYTES, MAX_COMMIT_VALIDATION_OPERATIONS, MAX_CONTENT_FIELD_BYTES, MAX_STREAM_APPEND_OPERATION_COUNT, ORG_AUTH_SCOPES, type Operation, OperationBuilder, type OperationBuilderAddInput, type OperationBuilderClient, type OperationBuilderOp, type OperationBuilderOptions, type OperationEventReceipt, type OperationEventReceiptV1, type OperationSource, type OperationSubmitResult, type OrgAccessResult, type OrgAuthScope, type OrgInfo, type OrgList, type OrgListMembersOptions, type OrgListOptions, type OrgMemberInfo, type OrgMemberList, type OrgRef, type OrgRole, type Page, type PageRequest, PartialStreamSubmissionError, type PingResult, REPO_AUTH_SCOPES, type ReaffirmOperation, type RefLink, type RefsOptions, type RefsResult, type RenameOperation, type RenameOptions, type RenameResult, type RepoAccessResult, type RepoAuthScope, type RepoConfigureStatsView, type RepoDescribeResult, type RepoExploreBrowseOptions, type RepoExploreItem, type RepoExploreOptions, type RepoExploreResult, type RepoInfo, type RepoLicense, 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 RepositoryCheckpointAccess, type RepositoryCheckpointStatus, 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 ShapeRemoveOptions, type ShapeReviseOptions, type ShapeValidatorResult, type StreamAppendInput, type StreamAppendResult, type StreamContinuationState, StreamSubmissionAggregator, type StreamingSubmissionHandle, type StreamingSubmissionOptions, StreamingSubmissionOutcomeUnknownError, type StreamingSubmissionRetryIdentity, type StreamingSubmissionRow, type SubscriptionBindCredentialsResult, type SubscriptionCompatCreateInput, type SubscriptionCompatUpdateInput, type SubscriptionInfo, type SubscriptionList, type SubscriptionUnbindCredentialsResult, type SynthesizedRepoContent, type ThingChanges, type ThingDetail, type ThingGet, type ThingGetManyResult, type ThingGetOptions, type ThingGetWithLease, type ThingGraphOptions, type ThingGraphResult, type ThingGraphValue, type ThingHead, type ThingHeadChangesOptions, type ThingHeadOptions, type ThingHeadRequest, type ThingHeadVersionsResult, type ThingHistory, type ThingHistoryOptions, type ThingItem, type ThingMetadata, type ThingQueryChangesOptions, type TokenInfo, type TokenResult, type UndeclaredFieldsWarning, type ValidationDiagnostic, type ValidationResult, type VerifiedCliCall, type ViewEvaluateOptions, type ViewEvaluateResult, WarmHubClient, type WarmHubClientOptions, type WarmHubDecorations, WarmHubError, type WarmHubErrorDetails, type WherePredicate, type WhoamiInfo, type WhoamiScopeEntry, type WireScopeEntry, collectDurableTokens, commitValidateRequestBodyBytes, connectionErrorMessage, contentFieldLimitError, countStreamAppendResultStatuses, createCommitValidateInput, createOperationEventRequestId, createOperationEventSubmissionId, encodeCommitValidateRequestBody, getResponseDecorations, isConnectionError, isDefiniteStreamAppendRejection, isKnownOrgAuthScope, isKnownRepoAuthScope, isRetryable, isWarmHubError, normalizeWref, operationEventStreamRequestId, 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 ActionLiveFeedItem, 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 CollectionAddOp, type CollectionAddType, type CollectionContainsOptions, type CollectionContainsResult, type CollectionCreateOptions, type CollectionDiffOptions, type CollectionDiffResult, type CollectionMember, type CollectionMembersOptions, type CollectionMembersPage, type CollectionMembershipRole, type CollectionMutationResult, type CollectionQuerySourceOptions, type CollectionReadDataMode, type CollectionReadSummary, type CollectionReviseOptions, type CollectionStatsOptions, type CollectionStatsResult, type CollectionTag, type CollectionType, type CommitApplyCompatibilityResult, type CommitDiagnostic, type CommitRealOperationResult, type CommitValidateInput, type CommitValidateOptions, type CommitValidateResult, type ComponentHistory, type ComponentHistoryOptions, type ComponentInfo, type ComponentInstallOptions, type ComponentInstallResult, type ComponentList, type ComponentListOptions, type ComponentUninstallOptions, 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 Grant, type GrantCreateOptions, type GrantListOptions, type GrantListResult, type GrantRecipientSelector, type GrantRevokeResult, type HeadResult, type HistoryResult, type HistoryVersion, type HomepageFeaturedListsResult, type IndexedFieldEntry, type IndexedFieldsReport, type LiveHandle, type LiveRepoEvent, type LiveSubscriptionLogOptions, type LiveThingHeadOptions, type LiveThingHistoryOptions, type LiveWatchResult, MAX_COMMIT_VALIDATION_ENCODED_BYTES, MAX_COMMIT_VALIDATION_OPERATIONS, MAX_CONTENT_FIELD_BYTES, MAX_STREAM_APPEND_OPERATION_COUNT, ORG_AUTH_SCOPES, type Operation, OperationBuilder, type OperationBuilderAddInput, type OperationBuilderClient, type OperationBuilderOp, type OperationBuilderOptions, type OperationEventReceipt, type OperationEventReceiptV1, type OperationSource, type OperationSubmitResult, type OrgAccessResult, type OrgAuthScope, type OrgInfo, type OrgList, type OrgListMembersOptions, type OrgListOptions, type OrgMemberInfo, type OrgMemberList, type OrgRef, type OrgRole, type Page, type PageRequest, PartialStreamSubmissionError, type PingResult, REPO_AUTH_SCOPES, type ReaffirmOperation, type RefLink, type RefsOptions, type RefsResult, type RenameOperation, type RenameOptions, type RenameResult, type RepoAccessResult, type RepoAuthScope, type RepoConfigureStatsView, type RepoDescribeResult, type RepoExploreBrowseOptions, type RepoExploreItem, type RepoExploreOptions, type RepoExploreResult, type RepoInfo, type RepoLicense, 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 RepositoryCheckpointAccess, type RepositoryCheckpointStatus, RepositoryExportError, type RepositoryExportErrorReason, type RepositoryExportExpectation, type RepositoryExportOptions, type RepositoryExportPreparation, type RepositoryExportPrepareOptions, type RepositoryExportRestoreOptions, type RepositoryExportRowMap, type RepositoryExportRows, type RepositoryExportSegmentOptions, RepositoryExportSession, 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 ShapeRemoveOptions, type ShapeReviseOptions, type ShapeValidatorResult, type StreamAppendInput, type StreamAppendResult, type StreamContinuationState, StreamSubmissionAggregator, type StreamingSubmissionHandle, type StreamingSubmissionOptions, StreamingSubmissionOutcomeUnknownError, type StreamingSubmissionRetryIdentity, type StreamingSubmissionRow, type SubscriptionBindCredentialsResult, type SubscriptionCompatCreateInput, type SubscriptionCompatUpdateInput, type SubscriptionInfo, type SubscriptionList, type SubscriptionUnbindCredentialsResult, type SynthesizedRepoContent, type ThingChanges, type ThingDetail, type ThingGet, type ThingGetManyResult, type ThingGetOptions, type ThingGetWithLease, type ThingGraphOptions, type ThingGraphResult, type ThingGraphValue, type ThingHead, type ThingHeadChangesOptions, type ThingHeadOptions, type ThingHeadRequest, type ThingHeadVersionsResult, type ThingHistory, type ThingHistoryOptions, type ThingItem, type ThingMetadata, type ThingQueryChangesOptions, type TokenInfo, type TokenResult, type UndeclaredFieldsWarning, type ValidationDiagnostic, type ValidationResult, type VerifiedCliCall, type ViewEvaluateOptions, type ViewEvaluateResult, WarmHubClient, type WarmHubClientOptions, type WarmHubDecorations, WarmHubError, type WarmHubErrorDetails, type WherePredicate, type WhoamiInfo, type WhoamiScopeEntry, type WireScopeEntry, applyRepositoryExportDelta, collectDurableTokens, commitValidateRequestBodyBytes, connectionErrorMessage, contentFieldLimitError, countStreamAppendResultStatuses, createCommitValidateInput, createOperationEventRequestId, createOperationEventSubmissionId, createRepositoryExportSession, encodeCommitValidateRequestBody, getResponseDecorations, isConnectionError, isDefiniteStreamAppendRejection, isKnownOrgAuthScope, isKnownRepoAuthScope, isRetryable, isWarmHubError, normalizeWref, operationEventStreamRequestId, readRepositoryExportStream, resolveFunctionLogMode, restoreRepositoryExportSession, sanitizeErrorMessage, sdkVersionIsBelowMinimum, streamAppendResultStatus, submitOperationsViaStream, toWarmHubError, validateAgainstShape, verifyCliCall };

package/dist/index.js

@@ -1,2 +1,2 @@
-export{n as AllStreamOperationsFailedError,u as CliCallVerificationError,y as DEFAULT_API_URL,k as DEFAULT_STREAM_CHUNK_SIZE,b as MAX_COMMIT_VALIDATION_ENCODED_BYTES,a as MAX_COMMIT_VALIDATION_OPERATIONS,l as MAX_STREAM_APPEND_OPERATION_COUNT,w as OperationBuilder,m as PartialStreamSubmissionError,t as SDK_VERSION,h as StreamSubmissionAggregator,s as StreamingSubmissionOutcomeUnknownError,I as WarmHubClient,B as WarmHubError,f as collectDurableTokens,e as commitValidateRequestBodyBytes,G as connectionErrorMessage,p as countStreamAppendResultStatuses,c as createCommitValidateInput,j as createOperationEventRequestId,i as createOperationEventSubmissionId,d as encodeCommitValidateRequestBody,g as getResponseDecorations,F as isConnectionError,q as isDefiniteStreamAppendRejection,E as isRetryable,D as isWarmHubError,x as normalizeWref,z as resolveFunctionLogMode,A as sanitizeErrorMessage,H as sdkVersionIsBelowMinimum,o as streamAppendResultStatus,r as submitOperationsViaStream,C as toWarmHubError,v as verifyCliCall}from'./chunk-YMVHXOMD.js';export{n as CLI_INSTALL_REPO_HEADER,o as CLI_SIGNATURE_HEADER,p as CLI_TIMESTAMP_HEADER,y as CONTENT_FIELD_LIMIT_ERROR,x as MAX_CONTENT_FIELD_BYTES,A as ORG_AUTH_SCOPES,s as REPO_AUTH_SCOPES,z as contentFieldLimitError,B as isKnownOrgAuthScope,t as isKnownRepoAuthScope,C as operationEventStreamRequestId,R as validateAgainstShape}from'./chunk-DWOK3J6H.js';//# sourceMappingURL=index.js.map
+export{t as AllStreamOperationsFailedError,A as CliCallVerificationError,E as DEFAULT_API_URL,q as DEFAULT_STREAM_CHUNK_SIZE,b as MAX_COMMIT_VALIDATION_ENCODED_BYTES,a as MAX_COMMIT_VALIDATION_OPERATIONS,r as MAX_STREAM_APPEND_OPERATION_COUNT,C as OperationBuilder,s as PartialStreamSubmissionError,i as RepositoryExportError,j as RepositoryExportSession,z as SDK_VERSION,n as StreamSubmissionAggregator,y as StreamingSubmissionOutcomeUnknownError,O as WarmHubClient,H as WarmHubError,h as applyRepositoryExportDelta,f as collectDurableTokens,e as commitValidateRequestBodyBytes,M as connectionErrorMessage,v as countStreamAppendResultStatuses,c as createCommitValidateInput,p as createOperationEventRequestId,o as createOperationEventSubmissionId,k as createRepositoryExportSession,d as encodeCommitValidateRequestBody,g as getResponseDecorations,L as isConnectionError,w as isDefiniteStreamAppendRejection,K as isRetryable,J as isWarmHubError,D as normalizeWref,l as readRepositoryExportStream,F as resolveFunctionLogMode,m as restoreRepositoryExportSession,G as sanitizeErrorMessage,N as sdkVersionIsBelowMinimum,u as streamAppendResultStatus,x as submitOperationsViaStream,I as toWarmHubError,B as verifyCliCall}from'./chunk-WEJSFESQ.js';export{n as CLI_INSTALL_REPO_HEADER,o as CLI_SIGNATURE_HEADER,p as CLI_TIMESTAMP_HEADER,y as CONTENT_FIELD_LIMIT_ERROR,x as MAX_CONTENT_FIELD_BYTES,A as ORG_AUTH_SCOPES,s as REPO_AUTH_SCOPES,z as contentFieldLimitError,B as isKnownOrgAuthScope,t as isKnownRepoAuthScope,C as operationEventStreamRequestId,Z as validateAgainstShape}from'./chunk-X5CR7GVH.js';//# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/react.d.ts

@@ -2,6 +2,7 @@ import { WarmHubClient } from './index.js';
 export { AboutOptions, AboutResult, CountOptions, CountResult, CurrentUserInfo, DEFAULT_API_URL, ErrorKind, FilterOptions, FilterResult, HeadResult, HistoryResult, Operation, OperationSubmitResult, PingResult, RefsOptions, RefsResult, RepoListPageOptions, RepoListPageResult, RepoWithStatsInfo, ResolveWrefResult, SDK_VERSION, SearchOptions, SearchResult, ThingDetail, WarmHubClientOptions, WarmHubError, toWarmHubError } from './index.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode } from 'react';
+import 'zod';
 
 /** @internal */
 interface WarmHubProviderProps {

package/dist/react.js

@@ -1,2 +1,2 @@
-import {I}from'./chunk-YMVHXOMD.js';export{y as DEFAULT_API_URL,t as SDK_VERSION,I as WarmHubClient,B as WarmHubError,C as toWarmHubError}from'./chunk-YMVHXOMD.js';import'./chunk-DWOK3J6H.js';import {createContext,useMemo,useState,useEffect,useContext}from'react';import {jsx}from'react/jsx-runtime';var p=createContext(null),f=createContext({isAuthenticated:false,isLoading:true});function P({apiUrl:e,children:t,auth:o,client:s,decorateResponses:r}){let n=s?.name,u=s?.version,i=useMemo(()=>new I({apiUrl:e,accessToken:async()=>await o.getAccessToken()??void 0,client:{name:n,version:u},decorateResponses:r}),[e,o.getAccessToken,n,u,r]);return jsx(p.Provider,{value:i,children:jsx(g,{auth:o,client:i,children:t})})}function g({auth:e,client:t,children:o}){let[s,r]=useState(null),n=e.isAuthenticated&&s===t;useEffect(()=>{if(!e.isAuthenticated){r(null);return}let i=false;return t.auth.sync().then(()=>{i||r(t);}).catch(c=>{console.error("auth.sync failed:",c),i||r(t);}),()=>{i=true;}},[e.isAuthenticated,t]);let u=useMemo(()=>({isAuthenticated:e.isAuthenticated&&n,isLoading:e.isLoading||e.isAuthenticated&&!n}),[e.isAuthenticated,e.isLoading,n]);return e.isLoading||e.isAuthenticated&&!n?null:jsx(f.Provider,{value:u,children:o})}function v(){let e=useContext(p);if(!e)throw new Error("useWarmHubClient must be used within a WarmHubProvider");return e}function S(){return useContext(f)}export{P as WarmHubProvider,S as useWarmHubAuth,v as useWarmHubClient};//# sourceMappingURL=react.js.map
+import {O}from'./chunk-WEJSFESQ.js';export{E as DEFAULT_API_URL,z as SDK_VERSION,O as WarmHubClient,H as WarmHubError,I as toWarmHubError}from'./chunk-WEJSFESQ.js';import'./chunk-X5CR7GVH.js';import {createContext,useMemo,useState,useEffect,useContext}from'react';import {jsx}from'react/jsx-runtime';var p=createContext(null),f=createContext({isAuthenticated:false,isLoading:true});function P({apiUrl:e,children:t,auth:o,client:s,decorateResponses:r}){let n=s?.name,u=s?.version,i=useMemo(()=>new O({apiUrl:e,accessToken:async()=>await o.getAccessToken()??void 0,client:{name:n,version:u},decorateResponses:r}),[e,o.getAccessToken,n,u,r]);return jsx(p.Provider,{value:i,children:jsx(g,{auth:o,client:i,children:t})})}function g({auth:e,client:t,children:o}){let[s,r]=useState(null),n=e.isAuthenticated&&s===t;useEffect(()=>{if(!e.isAuthenticated){r(null);return}let i=false;return t.auth.sync().then(()=>{i||r(t);}).catch(c=>{console.error("auth.sync failed:",c),i||r(t);}),()=>{i=true;}},[e.isAuthenticated,t]);let u=useMemo(()=>({isAuthenticated:e.isAuthenticated&&n,isLoading:e.isLoading||e.isAuthenticated&&!n}),[e.isAuthenticated,e.isLoading,n]);return e.isLoading||e.isAuthenticated&&!n?null:jsx(f.Provider,{value:u,children:o})}function v(){let e=useContext(p);if(!e)throw new Error("useWarmHubClient must be used within a WarmHubProvider");return e}function S(){return useContext(f)}export{P as WarmHubProvider,S as useWarmHubAuth,v as useWarmHubClient};//# sourceMappingURL=react.js.map
 //# sourceMappingURL=react.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@warmhub/sdk-ts",
-  "version": "0.107.0",
+  "version": "0.108.0",
   "private": false,
   "type": "module",
   "description": "The TypeScript SDK for WarmHub — create repos, commit and query data, and compound knowledge with your AI agents.",
@@ -38,6 +38,7 @@
   "sideEffects": false,
   "files": [
     "dist",
+    "CHANGELOG.md",
     "README.md"
   ],
   "publishConfig": {
@@ -102,6 +103,7 @@
   },
   "devDependencies": {
     "@vitest/coverage-v8": "catalog:",
+    "pako": "2.1.0",
     "@types/react": "catalog:",
     "react": "19.2.6",
     "tsup": "8.5.1",