@granular-software/sdk 0.3.3 → 0.4.1

package/dist/{types-CnX4jXYQ.d.mts → types-BOPsFZYi.d.mts}

@@ -5,15 +5,31 @@
 /**
  * Configuration for the Granular client
  */
+type AccessTokenProvider = () => Promise<string | null | undefined> | string | null | undefined;
+type EndpointMode = 'auto' | 'local' | 'production';
 interface GranularOptions {
     /** Your Granular API key (for service/CLI auth; use with GRANULAR_API_KEY) */
     apiKey?: string;
     /** Application/session JWT (for user-context auth; use from simulator or getAccessToken) */
     token?: string;
+    /** Optional provider used to refresh JWT before WebSocket (re)connect attempts */
+    tokenProvider?: AccessTokenProvider;
     /** Optional API URL (for on-prem or testing) */
     apiUrl?: string;
+    /** Optional endpoint mode when apiUrl is not explicitly provided */
+    endpointMode?: EndpointMode;
     /** Optional WebSocket constructor (for Node.js environments) */
     WebSocketCtor?: any;
+    /**
+     * Optional callback invoked when a connected WebSocket closes unexpectedly.
+     * Useful for forwarding close diagnostics to monitoring (e.g., Sentry).
+     */
+    onUnexpectedClose?: (info: WSDisconnectInfo) => void;
+    /**
+     * Optional callback invoked when automatic reconnect fails.
+     * Useful to capture auth or gateway rejection causes.
+     */
+    onReconnectError?: (info: WSReconnectErrorInfo) => void;
 }
 /** Resolved auth credential: either apiKey or token must be provided */
 type GranularAuth = string;
@@ -401,11 +417,28 @@ interface Prompt {
     options?: string[];
     defaultValue?: unknown;
 }
+interface WSDisconnectInfo {
+    code?: number;
+    reason?: string;
+    wasClean?: boolean;
+    unexpected: boolean;
+    timestamp: number;
+    reconnectScheduled: boolean;
+    reconnectDelayMs?: number;
+}
+interface WSReconnectErrorInfo {
+    sessionId: string;
+    error: string;
+    timestamp: number;
+}
 interface WSClientOptions {
     url: string;
     sessionId: string;
     token: string;
+    tokenProvider?: AccessTokenProvider;
     WebSocketCtor?: any;
+    onUnexpectedClose?: (info: WSDisconnectInfo) => void;
+    onReconnectError?: (info: WSReconnectErrorInfo) => void;
 }
 interface RPCRequest {
     type: 'rpc';
@@ -636,4 +669,4 @@ interface DeleteResponse {
     deleted: boolean;
 }
 
-export type { ManifestOperation as $, AssignmentListResponse as A, BuildPolicy as B, ConnectOptions as C, DomainState as D, EnvironmentData as E, BuildListResponse as F, GranularOptions as G, JobStatus as H, InstanceToolHandler as I, Job as J, JobSubmitResult as K, Prompt as L, ModelRef as M, RPCRequest as N, RPCResponse as O, PublishToolsResult as P, SyncMessage as Q, RecordUserOptions as R, SandboxListResponse as S, ToolWithHandler as T, User as U, RPCRequestFromServer as V, WSClientOptions as W, ToolInvokeParams as X, ToolResultParams as Y, ManifestPropertySpec as Z, ManifestRelationshipDef as _, ToolHandler as a, ManifestImport as a0, ManifestVolume as a1, APIError as a2, ToolInfo as b, ToolsChangedEvent as c, GraphQLResult as d, DefineRelationshipOptions as e, RelationshipInfo as f, ManifestContent as g, RecordObjectOptions as h, RecordObjectResult as i, Sandbox as j, CreateSandboxData as k, DeleteResponse as l, PermissionProfile as m, CreatePermissionProfileData as n, CreateEnvironmentData as o, Subject as p, ToolSchema as q, GranularAuth as r, PermissionRules as s, PermissionProfileListResponse as t, Assignment as u, EnvironmentListResponse as v, Manifest as w, ManifestListResponse as x, BuildStatus as y, Build as z };
+export type { ToolInvokeParams as $, AssignmentListResponse as A, BuildPolicy as B, ConnectOptions as C, DomainState as D, EnvironmentData as E, BuildStatus as F, GranularOptions as G, Build as H, InstanceToolHandler as I, Job as J, BuildListResponse as K, JobStatus as L, ModelRef as M, JobSubmitResult as N, Prompt as O, PublishToolsResult as P, WSDisconnectInfo as Q, RecordUserOptions as R, SandboxListResponse as S, ToolWithHandler as T, User as U, WSReconnectErrorInfo as V, WSClientOptions as W, RPCRequest as X, RPCResponse as Y, SyncMessage as Z, RPCRequestFromServer as _, ToolHandler as a, ToolResultParams as a0, ManifestPropertySpec as a1, ManifestRelationshipDef as a2, ManifestOperation as a3, ManifestImport as a4, ManifestVolume as a5, APIError as a6, ToolInfo as b, ToolsChangedEvent as c, GraphQLResult as d, DefineRelationshipOptions as e, RelationshipInfo as f, ManifestContent as g, RecordObjectOptions as h, RecordObjectResult as i, Sandbox as j, CreateSandboxData as k, DeleteResponse as l, PermissionProfile as m, CreatePermissionProfileData as n, CreateEnvironmentData as o, Subject as p, ToolSchema as q, AccessTokenProvider as r, EndpointMode as s, GranularAuth as t, PermissionRules as u, PermissionProfileListResponse as v, Assignment as w, EnvironmentListResponse as x, Manifest as y, ManifestListResponse as z };

package/dist/{types-CnX4jXYQ.d.ts → types-BOPsFZYi.d.ts}

@@ -5,15 +5,31 @@
 /**
  * Configuration for the Granular client
  */
+type AccessTokenProvider = () => Promise<string | null | undefined> | string | null | undefined;
+type EndpointMode = 'auto' | 'local' | 'production';
 interface GranularOptions {
     /** Your Granular API key (for service/CLI auth; use with GRANULAR_API_KEY) */
     apiKey?: string;
     /** Application/session JWT (for user-context auth; use from simulator or getAccessToken) */
     token?: string;
+    /** Optional provider used to refresh JWT before WebSocket (re)connect attempts */
+    tokenProvider?: AccessTokenProvider;
     /** Optional API URL (for on-prem or testing) */
     apiUrl?: string;
+    /** Optional endpoint mode when apiUrl is not explicitly provided */
+    endpointMode?: EndpointMode;
     /** Optional WebSocket constructor (for Node.js environments) */
     WebSocketCtor?: any;
+    /**
+     * Optional callback invoked when a connected WebSocket closes unexpectedly.
+     * Useful for forwarding close diagnostics to monitoring (e.g., Sentry).
+     */
+    onUnexpectedClose?: (info: WSDisconnectInfo) => void;
+    /**
+     * Optional callback invoked when automatic reconnect fails.
+     * Useful to capture auth or gateway rejection causes.
+     */
+    onReconnectError?: (info: WSReconnectErrorInfo) => void;
 }
 /** Resolved auth credential: either apiKey or token must be provided */
 type GranularAuth = string;
@@ -401,11 +417,28 @@ interface Prompt {
     options?: string[];
     defaultValue?: unknown;
 }
+interface WSDisconnectInfo {
+    code?: number;
+    reason?: string;
+    wasClean?: boolean;
+    unexpected: boolean;
+    timestamp: number;
+    reconnectScheduled: boolean;
+    reconnectDelayMs?: number;
+}
+interface WSReconnectErrorInfo {
+    sessionId: string;
+    error: string;
+    timestamp: number;
+}
 interface WSClientOptions {
     url: string;
     sessionId: string;
     token: string;
+    tokenProvider?: AccessTokenProvider;
     WebSocketCtor?: any;
+    onUnexpectedClose?: (info: WSDisconnectInfo) => void;
+    onReconnectError?: (info: WSReconnectErrorInfo) => void;
 }
 interface RPCRequest {
     type: 'rpc';
@@ -636,4 +669,4 @@ interface DeleteResponse {
     deleted: boolean;
 }
 
-export type { ManifestOperation as $, AssignmentListResponse as A, BuildPolicy as B, ConnectOptions as C, DomainState as D, EnvironmentData as E, BuildListResponse as F, GranularOptions as G, JobStatus as H, InstanceToolHandler as I, Job as J, JobSubmitResult as K, Prompt as L, ModelRef as M, RPCRequest as N, RPCResponse as O, PublishToolsResult as P, SyncMessage as Q, RecordUserOptions as R, SandboxListResponse as S, ToolWithHandler as T, User as U, RPCRequestFromServer as V, WSClientOptions as W, ToolInvokeParams as X, ToolResultParams as Y, ManifestPropertySpec as Z, ManifestRelationshipDef as _, ToolHandler as a, ManifestImport as a0, ManifestVolume as a1, APIError as a2, ToolInfo as b, ToolsChangedEvent as c, GraphQLResult as d, DefineRelationshipOptions as e, RelationshipInfo as f, ManifestContent as g, RecordObjectOptions as h, RecordObjectResult as i, Sandbox as j, CreateSandboxData as k, DeleteResponse as l, PermissionProfile as m, CreatePermissionProfileData as n, CreateEnvironmentData as o, Subject as p, ToolSchema as q, GranularAuth as r, PermissionRules as s, PermissionProfileListResponse as t, Assignment as u, EnvironmentListResponse as v, Manifest as w, ManifestListResponse as x, BuildStatus as y, Build as z };
+export type { ToolInvokeParams as $, AssignmentListResponse as A, BuildPolicy as B, ConnectOptions as C, DomainState as D, EnvironmentData as E, BuildStatus as F, GranularOptions as G, Build as H, InstanceToolHandler as I, Job as J, BuildListResponse as K, JobStatus as L, ModelRef as M, JobSubmitResult as N, Prompt as O, PublishToolsResult as P, WSDisconnectInfo as Q, RecordUserOptions as R, SandboxListResponse as S, ToolWithHandler as T, User as U, WSReconnectErrorInfo as V, WSClientOptions as W, RPCRequest as X, RPCResponse as Y, SyncMessage as Z, RPCRequestFromServer as _, ToolHandler as a, ToolResultParams as a0, ManifestPropertySpec as a1, ManifestRelationshipDef as a2, ManifestOperation as a3, ManifestImport as a4, ManifestVolume as a5, APIError as a6, ToolInfo as b, ToolsChangedEvent as c, GraphQLResult as d, DefineRelationshipOptions as e, RelationshipInfo as f, ManifestContent as g, RecordObjectOptions as h, RecordObjectResult as i, Sandbox as j, CreateSandboxData as k, DeleteResponse as l, PermissionProfile as m, CreatePermissionProfileData as n, CreateEnvironmentData as o, Subject as p, ToolSchema as q, AccessTokenProvider as r, EndpointMode as s, GranularAuth as t, PermissionRules as u, PermissionProfileListResponse as v, Assignment as w, EnvironmentListResponse as x, Manifest as y, ManifestListResponse as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@granular-software/sdk",
-  "version": "0.3.3",
+  "version": "0.4.1",
   "description": "TypeScript SDK and CLI for Granular - define, build, and deploy AI sandboxes",
   "main": "dist/index.js",
   "module": "dist/index.mjs",