@warmhub/sdk-ts 0.59.0 → 0.60.0

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-declare const COMMIT_OPERATIONS: readonly ["add", "revise", "retract"];
+declare const COMMIT_OPERATIONS: readonly ["add", "revise", "retract", "rename"];
 type CommitOperation = (typeof COMMIT_OPERATIONS)[number];
 declare const COMMIT_OPERATION_KINDS: readonly ["shape", "thing", "assertion", "collection"];
 type CommitOperationKind = (typeof COMMIT_OPERATION_KINDS)[number];
@@ -286,7 +286,7 @@ type CommitApplyResult = {
     operations: Array<{
         opIndex?: number;
         name: string;
-        operation: 'add' | 'revise' | 'retract' | 'noop';
+        operation: 'add' | 'revise' | 'retract' | 'rename' | 'noop';
         version: number;
         dataHash: string;
         status?: 'applied' | 'noop';
@@ -324,11 +324,11 @@ type ComponentDetail = {
         synthesized?: boolean;
         aboutWref?: string;
         committerWref?: string;
-        createdByWref?: string;
+        revisedBy?: string;
         metadata?: {
             durableId: string;
-            thingCreatedAt: number;
-            versionCreatedAt: number;
+            createdOn: number;
+            revisedOn: number;
         };
     };
     ownedShapes: Array<{
@@ -356,8 +356,8 @@ type ComponentDetail = {
         aboutWref?: string;
         metadata?: {
             durableId: string;
-            thingCreatedAt: number;
-            versionCreatedAt: number;
+            createdOn: number;
+            revisedOn: number;
         };
     }>;
 };
@@ -504,6 +504,11 @@ type StreamAppendInput$1 = {
         kind?: 'shape' | 'thing' | 'assertion' | 'collection';
         reason?: string;
         leaseId?: string;
+    } | {
+        operation: 'rename';
+        name: string;
+        newName: string;
+        kind?: 'shape' | 'thing' | 'assertion' | 'collection';
     }>;
 };
 type StreamAppendResult$1 = {
@@ -514,7 +519,7 @@ type StreamAppendResult$1 = {
     results: Array<{
         opIndex?: number;
         name: string;
-        operation?: 'add' | 'revise' | 'retract' | 'noop';
+        operation?: 'add' | 'revise' | 'retract' | 'rename' | 'noop';
         version?: number;
         dataHash?: string;
         status?: 'success' | 'noop' | 'failed';
@@ -648,11 +653,11 @@ type ThingGetManyResult$1 = {
         synthesized?: boolean;
         aboutWref?: string;
         committerWref?: string;
-        createdByWref?: string;
+        revisedBy?: string;
         metadata?: {
             durableId: string;
-            thingCreatedAt: number;
-            versionCreatedAt: number;
+            createdOn: number;
+            revisedOn: number;
         };
     }>;
     missing: Array<string>;
@@ -664,7 +669,7 @@ type ThingHeadVersionsResult$1 = {
         durableId: string;
         version: number;
         active: boolean;
-        versionCreatedAt: number;
+        revisedOn: number;
     }>;
     missing: Array<string>;
 };
@@ -795,6 +800,13 @@ type ShapeChangeResult = {
     version: number;
     dataHash: string;
 };
+type ShapeRemoveResult = {
+    name: string;
+    operation: 'add' | 'revise' | 'retract' | 'noop';
+    version: number;
+    dataHash: string;
+    removed: true;
+};
 type SubscriptionBindCredentialsResult$1 = {
     bound: true;
     subscriptionName: string;
@@ -972,10 +984,37 @@ interface RetractOperation {
      */
     leaseId?: string;
 }
+/**
+ * Rename operation accepted by `client.commit.apply` (#4848). Rewrites a thing's
+ * or shape's name in place — a version-less metadata op that records a from→to
+ * event but mints no new body version.
+ *
+ * @see https://docs.warmhub.ai/writes/operations/#rename-operations
+ */
+interface RenameOperation {
+    /**
+     * Operation discriminator. Required.
+     */
+    operation: 'rename';
+    /**
+     * Current target: `Shape/oldName` for a thing/assertion, or the plain shape
+     * name for a shape.
+     */
+    name: string;
+    /**
+     * New bare name — within the same shape for a thing/assertion, or the new
+     * shape name for a shape rename.
+     */
+    newName: string;
+    /**
+     * Optional kind safety hint: `thing`, `assertion`, `shape`, or `collection`.
+     */
+    kind?: CommitOperationKind;
+}
 /**
  * Commit operation accepted by `client.commit.apply`. Discriminated union over
- * {@link AddOperation}, {@link ReviseOperation}, and {@link RetractOperation},
- * keyed on `operation`.
+ * {@link AddOperation}, {@link ReviseOperation}, {@link RetractOperation}, and
+ * {@link RenameOperation}, keyed on `operation`.
  *
  * Inline array literals passed directly to `client.commit.apply` are
  * contextually typed by the parameter, so `operation: "add"` stays narrowed
@@ -1003,7 +1042,7 @@ interface RetractOperation {
  *
  * @see https://docs.warmhub.ai/sdk/write-methods/#typing-operation-arrays
  */
-type Operation = AddOperation | ReviseOperation | RetractOperation;
+type Operation = AddOperation | ReviseOperation | RetractOperation | RenameOperation;
 
 /**
  * Default number of operations the SDK sends per stream append chunk.
@@ -1017,7 +1056,7 @@ declare const DEFAULT_STREAM_CHUNK_SIZE = 1000;
  * @internal
  */
 declare const MAX_STREAM_APPEND_OPERATION_COUNT = 10000;
-type CommitResultOperation$1 = CommitOperation | 'noop';
+type CommitResultOperation = CommitOperation | 'noop';
 interface OperationStreamClient {
     stream: {
         append(input: StreamAppendInput$1): Promise<StreamAppendResult$1>;
@@ -1037,7 +1076,7 @@ type SubmittedStreamResult = {
     operations: Array<{
         opIndex?: number;
         name: string;
-        operation: CommitResultOperation$1;
+        operation: CommitResultOperation;
         dataHash: string;
         version: number;
         status?: 'applied' | 'noop' | 'error';
@@ -1793,14 +1832,13 @@ type ShapeChange = ShapeChangeResult;
 type Shape = ShapeGetResult;
 /** @internal */
 type ShapeList = ShapeListResult;
-type CommitResultOperation = CommitOperation | 'noop';
 /**
  * Result of `client.shape.remove` — confirms the retraction with the new version metadata.
  * @internal
  */
 type ShapeRemove = {
     name: string;
-    operation: CommitResultOperation;
+    operation: ShapeRemoveResult['operation'];
     version: number;
     dataHash: string;
     removed: true;
@@ -2309,10 +2347,10 @@ type RepoLocator = {
  * Stable identity and creation timestamps embedded on every thing-like read
  * result. `durableId` is a self-routing, self-verifying token (Crockford base32
  * over `repo_id + things.id + CRC-32C`) that remains identical before and after
- * rename and across revise/retract. `thingCreatedAt` records the thing's birth
- * date (stable across all mutations); `versionCreatedAt` is the timestamp of
+ * rename and across revise/retract. `createdOn` records the thing's birth
+ * date (stable across all mutations); `revisedOn` is the timestamp of
  * the current version (advances on each revise). History rows carry only
- * `durableId` and `thingCreatedAt` — omit `versionCreatedAt`.
+ * `durableId` and `createdOn` — omit `revisedOn`.
  *
  * Pass a bare `durableId` (optionally with `@vN`) wherever a wref is accepted
  * on read surfaces; `orgName`/`repoName` may be omitted for self-routing reads.
@@ -2321,8 +2359,8 @@ type RepoLocator = {
  */
 type ThingMetadata = {
     durableId: string;
-    thingCreatedAt: number;
-    versionCreatedAt: number;
+    createdOn: number;
+    revisedOn: number;
 };
 /** @internal */
 type ThingItem = {
@@ -2394,7 +2432,8 @@ type ThingDetail = {
     synthesized?: boolean;
     aboutWref?: string;
     committerWref?: string;
-    createdByWref?: string;
+    /** #4848 Phase C: current-version author (renamed from createdByWref). */
+    revisedBy?: string;
     metadata?: ThingMetadata;
     [key: string]: unknown;
 };
@@ -2439,8 +2478,9 @@ type HistoryResult = {
         shapeName?: string;
         data?: unknown;
         committerWref?: string;
-        createdByWref?: string;
-        metadata?: Pick<ThingMetadata, 'durableId' | 'thingCreatedAt'>;
+        /** #4848 Phase C: per-version author (renamed from createdByWref). */
+        revisedBy?: string;
+        metadata?: Pick<ThingMetadata, 'durableId' | 'createdOn'>;
         [key: string]: unknown;
     }>;
     nextCursor?: string;
@@ -3795,7 +3835,7 @@ declare class WarmHubClient {
         }) => Promise<ThingGetManyResult>;
         /**
          * Batched lightweight per-thing change probe — returns
-         * `{ wref, durableId, version, active, versionCreatedAt }` per wref with NO
+         * `{ wref, durableId, version, active, revisedOn }` per wref with NO
          * payload. Use it to check whether locally-cached copies are still fresh
          * without pulling `data`: a value is stale if `durableId` differs (the wref
          * now points to a different thing), `version`/`active` differ (the same
@@ -4270,4 +4310,4 @@ declare class WarmHubClient {
     private watchRepoQuery;
 }
 
-export { type AboutOptions, type AboutResult, type AccessResolveInput, type AccessResolveResult, type AccessTokenProvider, type ActionAttemptInfo, type ActionLeaseAcquire, type ActionLeaseOp, type ActionListNotificationsOptions, type ActionListRunsOptions, type ActionLiveFeed, type ActionLiveFeedOptions, type ActionNotificationInfo, type ActionRunInfo, type ActionRunStatsInfo, type ActionRunStatsOptions, type AddOp, type AddOperation, AllStreamOperationsFailedError, type Assertion, CLI_INSTALL_REPO_HEADER, CLI_SIGNATURE_HEADER, CLI_TIMESTAMP_HEADER, CONTENT_FIELD_LIMIT_ERROR, type CliCallSecrets, CliCallVerificationError, type CliCallVerificationFailureReason, type CollectionAbout, type CollectionTag, type ComponentInfo, type ComponentInstallResult, type ComponentList, type ComponentListOptions, type ComponentUninstallResult, type ComponentView, type CoreErrorKind, type CountOptions, type CountResult, type CredentialAuditEntry, type CredentialDeleteResult, type CredentialGrantResult, type CredentialInfo, type CredentialKeyMutationResult, type CredentialRevokeResult, type CredentialUngrantResult, type CurrentUserInfo, DEFAULT_API_URL, DEFAULT_STREAM_CHUNK_SIZE, type ErrorKind, type FilterOptions, type FilterResult, type FunctionLogMode, type GlobalSearchOptions, type GlobalSearchResult, type GlobalSearchResultItem, type HeadResult, type HistoryResult, type IndexedFieldEntry, type IndexedFieldsReport, type LiveHandle, type LiveRepoEvent, type LiveSubscriptionLogOptions, type LiveThingHeadOptions, type LiveThingHistoryOptions, type LiveWatchResult, MAX_CONTENT_FIELD_BYTES, MAX_STREAM_APPEND_OPERATION_COUNT, type Operation, OperationBuilder, type OperationBuilderClient, type OperationBuilderOp, type OperationBuilderOptions, type OperationSubmitResult, type OrgAccessResult, type OrgInfo, type OrgList, type OrgListMembersOptions, type OrgListOptions, type OrgMemberInfo, type OrgMemberList, type OrgRef, type OrgRole, type Page, type PageRequest, PartialStreamSubmissionError, type PingResult, type RefLink, type RefsOptions, type RefsResult, type RenameResult, type RepoAccessResult, type RepoConfigureStatsView, type RepoDescribeResult, type RepoInfo, type RepoList, type RepoListForCallerOptions, type RepoListOptions, type RepoListPageOptions, type RepoListPageResult, type RepoLocator, type RepoRecentInfo, type RepoRef, type RepoShapeInstanceCountsView, type RepoSort, type RepoStatsBatchResult, type RepoStatsView, type RepoWithStatsInfo, type RequestEvent, type ResolveWrefResult, type RetractOp, type RetractOperation, type RetryPolicyOptions, type ReviseOp, type ReviseOperation, SDK_VERSION, type SearchOptions, type SearchResult, type Shape, type ShapeChange, type ShapeCreateOptions, type ShapeFields, type ShapeGetOptions, type ShapeHistory, type ShapeHistoryOptions, type ShapeList, type ShapeListOptions, type ShapeRef, type ShapeRemove, type ShapeReviseOptions, type ShapeValidatorResult, type StreamAppendInput, type StreamAppendResult, type StreamContinuationState, type SubscriptionBindCredentialsResult, type SubscriptionCompatCreateInput, type SubscriptionCompatUpdateInput, type SubscriptionInfo, type SubscriptionList, type SubscriptionUnbindCredentialsResult, type SynthesizedRepoContent, type ThingDetail, type ThingGet, type ThingGetManyResult, type ThingGetOptions, type ThingGetWithLease, type ThingGraphOptions, type ThingGraphResult, type ThingGraphValue, type ThingHead, type ThingHeadOptions, type ThingHeadRequest, type ThingHeadVersionsResult, type ThingHistory, type ThingHistoryOptions, type ThingItem, type ThingMetadata, type TokenInfo, type TokenResult, type UndeclaredFieldsWarning, type ValidationDiagnostic, type ValidationResult, type VerifiedCliCall, WarmHubClient, type WarmHubClientOptions, WarmHubError, type WarmHubErrorDetails, type WherePredicate, type WhoamiInfo, type WhoamiScopeEntry, type WireScopeEntry, connectionErrorMessage, contentFieldLimitError, countStreamAppendResultStatuses, isConnectionError, isRetryable, isWarmHubError, normalizeWref, resolveFunctionLogMode, sanitizeErrorMessage, sdkVersionIsBelowMinimum, streamAppendResultStatus, submitOperationsViaStream, toWarmHubError, validateAgainstShape, verifyCliCall };
+export { type AboutOptions, type AboutResult, type AccessResolveInput, type AccessResolveResult, type AccessTokenProvider, type ActionAttemptInfo, type ActionLeaseAcquire, type ActionLeaseOp, type ActionListNotificationsOptions, type ActionListRunsOptions, type ActionLiveFeed, type ActionLiveFeedOptions, type ActionNotificationInfo, type ActionRunInfo, type ActionRunStatsInfo, type ActionRunStatsOptions, type AddOp, type AddOperation, AllStreamOperationsFailedError, type Assertion, CLI_INSTALL_REPO_HEADER, CLI_SIGNATURE_HEADER, CLI_TIMESTAMP_HEADER, CONTENT_FIELD_LIMIT_ERROR, type CliCallSecrets, CliCallVerificationError, type CliCallVerificationFailureReason, type CollectionAbout, type CollectionTag, type ComponentInfo, type ComponentInstallResult, type ComponentList, type ComponentListOptions, type ComponentUninstallResult, type ComponentView, type CoreErrorKind, type CountOptions, type CountResult, type CredentialAuditEntry, type CredentialDeleteResult, type CredentialGrantResult, type CredentialInfo, type CredentialKeyMutationResult, type CredentialRevokeResult, type CredentialUngrantResult, type CurrentUserInfo, DEFAULT_API_URL, DEFAULT_STREAM_CHUNK_SIZE, type ErrorKind, type FilterOptions, type FilterResult, type FunctionLogMode, type GlobalSearchOptions, type GlobalSearchResult, type GlobalSearchResultItem, type HeadResult, type HistoryResult, type IndexedFieldEntry, type IndexedFieldsReport, type LiveHandle, type LiveRepoEvent, type LiveSubscriptionLogOptions, type LiveThingHeadOptions, type LiveThingHistoryOptions, type LiveWatchResult, MAX_CONTENT_FIELD_BYTES, MAX_STREAM_APPEND_OPERATION_COUNT, type Operation, OperationBuilder, type OperationBuilderClient, type OperationBuilderOp, type OperationBuilderOptions, type OperationSubmitResult, type OrgAccessResult, type OrgInfo, type OrgList, type OrgListMembersOptions, type OrgListOptions, type OrgMemberInfo, type OrgMemberList, type OrgRef, type OrgRole, type Page, type PageRequest, PartialStreamSubmissionError, type PingResult, type RefLink, type RefsOptions, type RefsResult, type RenameOperation, type RenameResult, type RepoAccessResult, type RepoConfigureStatsView, type RepoDescribeResult, type RepoInfo, type RepoList, type RepoListForCallerOptions, type RepoListOptions, type RepoListPageOptions, type RepoListPageResult, type RepoLocator, type RepoRecentInfo, type RepoRef, type RepoShapeInstanceCountsView, type RepoSort, type RepoStatsBatchResult, type RepoStatsView, type RepoWithStatsInfo, type RequestEvent, type ResolveWrefResult, type RetractOp, type RetractOperation, type RetryPolicyOptions, type ReviseOp, type ReviseOperation, SDK_VERSION, type SearchOptions, type SearchResult, type Shape, type ShapeChange, type ShapeCreateOptions, type ShapeFields, type ShapeGetOptions, type ShapeHistory, type ShapeHistoryOptions, type ShapeList, type ShapeListOptions, type ShapeRef, type ShapeRemove, type ShapeReviseOptions, type ShapeValidatorResult, type StreamAppendInput, type StreamAppendResult, type StreamContinuationState, type SubscriptionBindCredentialsResult, type SubscriptionCompatCreateInput, type SubscriptionCompatUpdateInput, type SubscriptionInfo, type SubscriptionList, type SubscriptionUnbindCredentialsResult, type SynthesizedRepoContent, type ThingDetail, type ThingGet, type ThingGetManyResult, type ThingGetOptions, type ThingGetWithLease, type ThingGraphOptions, type ThingGraphResult, type ThingGraphValue, type ThingHead, type ThingHeadOptions, type ThingHeadRequest, type ThingHeadVersionsResult, type ThingHistory, type ThingHistoryOptions, type ThingItem, type ThingMetadata, type TokenInfo, type TokenResult, type UndeclaredFieldsWarning, type ValidationDiagnostic, type ValidationResult, type VerifiedCliCall, WarmHubClient, type WarmHubClientOptions, WarmHubError, type WarmHubErrorDetails, type WherePredicate, type WhoamiInfo, type WhoamiScopeEntry, type WireScopeEntry, connectionErrorMessage, contentFieldLimitError, countStreamAppendResultStatuses, isConnectionError, isRetryable, isWarmHubError, normalizeWref, resolveFunctionLogMode, sanitizeErrorMessage, sdkVersionIsBelowMinimum, streamAppendResultStatus, submitOperationsViaStream, toWarmHubError, validateAgainstShape, verifyCliCall };

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

package/dist/react.js

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