@warmhub/sdk-ts 0.128.0 → 0.129.1

package/dist/index.d.ts

@@ -274,13 +274,14 @@ type CommitValidateInput$1 = {
         kind: 'thing';
         name: string;
         data: unknown;
+        about?: never;
         affirmedTargets?: never;
         skipExisting?: boolean;
     } | {
         operation: 'add';
         kind: 'assertion';
         name: string;
-        about: string;
+        about?: string;
         data: unknown;
         affirmedTargets?: Array<string>;
         skipExisting?: boolean;
@@ -337,7 +338,7 @@ type CommitValidateInput$1 = {
         leaseId?: string;
     } | {
         operation: 'reaffirm';
-        kind?: 'assertion';
+        kind?: 'assertion' | 'thing';
         name: string;
         add?: Array<string>;
         remove?: Array<string>;
@@ -1194,7 +1195,7 @@ type ComponentDetail = {
     ownedThings: Array<{
         wref: string;
         name: string;
-        kind: 'thing' | 'assertion' | 'shape';
+        kind: 'thing' | 'shape';
         shapeName?: string;
         declaredShapes?: Array<string>;
         validatedShapes?: Array<string>;
@@ -1938,13 +1939,14 @@ type StreamAppendInput$1 = {
         kind: 'thing';
         name: string;
         data: unknown;
+        about?: never;
         affirmedTargets?: never;
         skipExisting?: boolean;
     } | {
         operation: 'add';
         kind: 'assertion';
         name: string;
-        about: string;
+        about?: string;
         data: unknown;
         affirmedTargets?: Array<string>;
         skipExisting?: boolean;
@@ -2001,7 +2003,7 @@ type StreamAppendInput$1 = {
         leaseId?: string;
     } | {
         operation: 'reaffirm';
-        kind?: 'assertion';
+        kind?: 'assertion' | 'thing';
         name: string;
         add?: Array<string>;
         remove?: Array<string>;
@@ -5371,7 +5373,7 @@ type ShapeListResult = {
 type ThingHistoryResult = {
     thing?: {
         wref: string;
-        kind: 'shape' | 'thing' | 'assertion' | 'collection';
+        kind: 'thing' | 'shape';
         shapeName?: string;
     };
     versions: Array<{
@@ -5414,7 +5416,7 @@ type ThingGetManyResult$1 = {
         wref: string;
         pinnedWref?: string;
         name: string;
-        kind: 'thing' | 'assertion' | 'shape';
+        kind: 'thing' | 'shape';
         shape?: string;
         shapeName?: string;
         validatedShape?: string;
@@ -5773,7 +5775,7 @@ type ViewEvaluateResult$1 = {
     items: Array<{
         wref: string;
         name: string;
-        kind: 'thing' | 'assertion' | 'shape';
+        kind: 'thing' | 'shape';
         shapeName?: string;
         declaredShapes?: Array<string>;
         validatedShapes?: Array<string>;
@@ -5935,6 +5937,9 @@ declare const MAX_WREFS_PER_THING_VERSION = 10000;
 
 declare const COMMIT_OPERATION_KINDS: readonly ["shape", "thing", "assertion", "collection"];
 type CommitOperationKind = (typeof COMMIT_OPERATION_KINDS)[number];
+/** What a read may be ASKED for: a read kind, or one of the legacy aliases. */
+declare const READ_KIND_FILTERS: readonly ["thing", "shape", "collection", "assertion"];
+type ReadKindFilter = (typeof READ_KIND_FILTERS)[number];
 
 /**
  * Canonical request signing for component CLI dispatch.
@@ -6026,24 +6031,16 @@ declare const repositoryExportRowSchema: z.ZodUnion<readonly [z.ZodDiscriminated
         shape: z.ZodString;
         memberCount: z.ZodNumber;
     }, 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.ZodString>;
-    about: z.ZodObject<{
+    about: z.ZodOptional<z.ZodObject<{
         wref: z.ZodString;
         v: z.ZodOptional<z.ZodNumber>;
         durableId: z.ZodString;
-    }, z.core.$strict>;
-    affirmed: z.ZodArray<z.ZodObject<{
+    }, z.core.$strict>>;
+    affirmed: z.ZodOptional<z.ZodArray<z.ZodObject<{
         wref: z.ZodString;
         v: z.ZodOptional<z.ZodNumber>;
         durableId: z.ZodString;
-    }, z.core.$strict>>;
+    }, z.core.$strict>>>;
     active: z.ZodLiteral<true>;
     data: z.ZodRecord<z.ZodString, z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>;
     wref: z.ZodString;
@@ -6053,7 +6050,6 @@ declare const repositoryExportRowSchema: z.ZodUnion<readonly [z.ZodDiscriminated
     kind: z.ZodEnum<{
         shape: "shape";
         thing: "thing";
-        assertion: "assertion";
     }>;
     active: z.ZodLiteral<false>;
     wref: z.ZodString;
@@ -6062,7 +6058,7 @@ declare const repositoryExportRowSchema: z.ZodUnion<readonly [z.ZodDiscriminated
 }, z.core.$strict>]>;
 declare const repositoryExportHeaderSchema: z.ZodObject<{
     kind: z.ZodLiteral<"header">;
-    formatVersion: z.ZodLiteral<4>;
+    formatVersion: z.ZodLiteral<5>;
     repo: z.ZodString;
     mode: z.ZodEnum<{
         ops: "ops";
@@ -6362,7 +6358,7 @@ interface ReaffirmOperation {
     /**
      * Optional kind safety hint; reaffirm applies only to assertions.
      */
-    kind?: 'assertion';
+    kind?: 'assertion' | 'thing';
     /**
      * Pinned target wrefs (`Shape/name@vN`) to affirm. A target already in the
      * set is reported as `ignored`, not an error.
@@ -7447,7 +7443,7 @@ interface ReaffirmOp {
     /**
      * Optional kind safety hint; reaffirm applies only to assertions.
      */
-    readonly kind?: 'assertion';
+    readonly kind?: 'assertion' | 'thing';
     /**
      * Pinned target wrefs (`Shape/name@vN`) to affirm.
      */
@@ -8296,6 +8292,18 @@ type ShapeReviseOptions = {
     /** Replace the composition list; omit to preserve it, or pass [] to clear it. */
     composes?: string[];
 };
+type ShapeReviseArgs = [
+    orgName: string,
+    repoName: string,
+    shapeName: string,
+    opts: ShapeReviseOptions
+] | [
+    orgName: string,
+    repoName: string,
+    shapeName: string,
+    newFields: Record<string, unknown> | undefined,
+    opts: ShapeReviseOptions
+];
 /** @internal */
 type ShapeRemoveOptions = {
     eventRequestId: string;
@@ -9114,12 +9122,12 @@ type FilterOptions = {
     /** Include the full certified Shape closure on each returned item. */
     includeValidatedShapes?: boolean;
     /**
-     * Filter to records of this kind: `shape`, `thing`, `assertion`, or
-     * `collection`. The requested kind controls membership: `thing` includes
-     * ordinary things and collections. Each result's `kind` describes that
-     * record: a collection is returned as `collection`.
+     * Filter to records of this kind. Results project only `shape` or `thing`;
+     * `assertion` and `collection` remain input aliases during their retirement
+     * windows. Assertions carry `aboutWref` + `affirmedWrefs`; collections carry
+     * `collections`.
      */
-    kind?: CommitOperationKind;
+    kind?: ReadKindFilter;
     /** Filter assertions whose `about` target wref matches the supplied value. */
     about?: string;
     /**
@@ -10324,7 +10332,7 @@ declare class WarmHubClient {
          * @param opts.eventRequestId Caller-owned UUID retained across ambiguous retries.
          * @param opts.description Optional human-readable description for the revised shape.
          */
-        revise: (orgName: string, repoName: string, shapeName: string, newFields: Record<string, unknown>, opts: ShapeReviseOptions) => Promise<ShapeChange>;
+        revise: (...args: ShapeReviseArgs) => Promise<ShapeChange>;
         /**
          * Retract a shape definition.
          *

package/dist/index.js

@@ -1,2 +1,2 @@
-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-YWUAJWBG.js';export{s as CLI_INSTALL_REPO_HEADER,t as CLI_SIGNATURE_HEADER,u as CLI_TIMESTAMP_HEADER,c as CONTENT_FIELD_LIMIT_ERROR,b as MAX_CONTENT_FIELD_BYTES,n as MAX_WREFS_PER_THING_VERSION,B as ORG_AUTH_SCOPES,x as REPO_AUTH_SCOPES,d as contentFieldLimitError,C as isKnownOrgAuthScope,y as isKnownRepoAuthScope,D as operationEventStreamRequestId,_ as validateAgainstShape}from'./chunk-NOX7T26R.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-ZMQZTPR4.js';export{t as CLI_INSTALL_REPO_HEADER,u as CLI_SIGNATURE_HEADER,v as CLI_TIMESTAMP_HEADER,d as CONTENT_FIELD_LIMIT_ERROR,c as MAX_CONTENT_FIELD_BYTES,o as MAX_WREFS_PER_THING_VERSION,C as ORG_AUTH_SCOPES,y as REPO_AUTH_SCOPES,e as contentFieldLimitError,D as isKnownOrgAuthScope,z as isKnownRepoAuthScope,E as operationEventStreamRequestId,$ as validateAgainstShape}from'./chunk-UCK4ZIVG.js';//# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/react.js

@@ -1,2 +1,2 @@
-import {O}from'./chunk-YWUAJWBG.js';export{E as DEFAULT_API_URL,z as SDK_VERSION,O as WarmHubClient,H as WarmHubError,I as toWarmHubError}from'./chunk-YWUAJWBG.js';import'./chunk-NOX7T26R.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=o.getAccessToken,a=useMemo(()=>new O({apiUrl:e,accessToken:async()=>await i()??void 0,client:{name:n,version:u},decorateResponses:r}),[e,n,u,r,i]);return jsx(p.Provider,{value:a,children:jsx(g,{auth:o,client:a,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(a=>{console.error("auth.sync failed:",a),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-ZMQZTPR4.js';export{E as DEFAULT_API_URL,z as SDK_VERSION,O as WarmHubClient,H as WarmHubError,I as toWarmHubError}from'./chunk-ZMQZTPR4.js';import'./chunk-UCK4ZIVG.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=o.getAccessToken,a=useMemo(()=>new O({apiUrl:e,accessToken:async()=>await i()??void 0,client:{name:n,version:u},decorateResponses:r}),[e,n,u,r,i]);return jsx(p.Provider,{value:a,children:jsx(g,{auth:o,client:a,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(a=>{console.error("auth.sync failed:",a),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.128.0",
+  "version": "0.129.1",
   "private": false,
   "type": "module",
   "description": "The TypeScript SDK for WarmHub — create repos, commit and query data, and compound knowledge with your AI agents.",