@statelyai/sdk 0.21.0 → 0.22.1

package/README.md

@@ -37,6 +37,7 @@ embed.init({
   format: 'xstate',
   mode: 'editing',
   theme: 'dark',
+  settings: { canvas: { viewMode: 'list' } },
   documents: [
     { path: 'README.md', content: '# How this workflow works' },
     { path: 'src/machine.ts', content: machineSource },
@@ -44,6 +45,9 @@ embed.init({
 });
 ```
 
+Use `viewMode: 'list'` on `createStatelyEmbed` to add `?view=list` to the
+iframe URL, or subscribe to `viewModeChanged` when the user switches views.
+
 Custom profiles and formats can be supplied when the embed is created. Their
 serializable manifests are sent to the iframe; detector, importer, exporter,
 and validator implementations remain in the host and are called asynchronously.
@@ -90,6 +94,9 @@ CLI and editor-extension hosts use `EditorHostSession` from
 clipboard requests, and editor protocol negotiation. Use
 `createRemoteEditorSyncBackend` for two-way validation of the versioned Editor
 Sync HTTP contract.
+Remote authentication failures are surfaced as `EditorSyncError` with HTTP
+status and protocol error code metadata so hosts can refresh credentials and
+retry once without depending on response-message text.
 Hosts keep ownership of files, credentials, UI, and transport adapters.
 
 Key capabilities:

package/dist/{editorHostSession-CCTwvUOB.mjs → editorHostSession-BZE_Wm0m.mjs}

@@ -1,9 +1,13 @@
-import { t as EDITOR_PROTOCOL_VERSION } from "./editorHostProtocol-D_h4y3rX.mjs";
-import { c as object, f as unknown, i as custom, l as record, n as array, o as literal, r as boolean, s as number, t as _enum, u as string } from "./schemas-b9wG-zYl.mjs";
+import { c as object, f as unknown, i as custom, l as record, n as array, o as literal, r as boolean, s as number, t as _enum, u as string } from "./openapi-BTDjYWXd.mjs";
+import { t as EDITOR_PROTOCOL_VERSION } from "./editorHostProtocol-Bko7wge8.mjs";
 
 //#region ../api-contract/dist/editor-sync.mjs
 const EDITOR_SYNC_PROTOCOL_VERSION = 1;
 const EDITOR_SYNC_PROTOCOL_HEADER = "X-Stately-Editor-Sync-Version";
+const editorSyncErrorResponseSchema = object({
+	error: string(),
+	code: string().optional()
+}).passthrough();
 const editorCapabilitiesSchema = object({
 	edit: boolean().optional(),
 	export: boolean().optional(),
@@ -102,6 +106,16 @@ const editorSyncAccessResponseSchema = object({ access: editorSyncAccessSchema }
 
 //#endregion
 //#region src/editorHostSession.ts
+var EditorSyncError = class extends Error {
+	status;
+	code;
+	constructor(message, status, code) {
+		super(message);
+		this.name = "EditorSyncError";
+		this.status = status;
+		this.code = code;
+	}
+};
 function createRemoteEditorSyncBackend(options) {
 	const fetchImpl = options.fetch ?? globalThis.fetch;
 	async function post(pathname, body) {
@@ -118,10 +132,7 @@ function createRemoteEditorSyncBackend(options) {
 		});
 		assertEditorSyncResponseProtocol(response);
 		const data = await response.json().catch(() => null);
-		if (!response.ok) {
-			const message = data && typeof data === "object" && "error" in data && typeof data.error === "string" ? data.error : `HTTP ${response.status}`;
-			throw new Error(message);
-		}
+		if (!response.ok) throwEditorSyncError(response.status, data);
 		return data;
 	}
 	return {
@@ -144,12 +155,14 @@ async function fetchEditorSyncAccess(options) {
 	});
 	assertEditorSyncResponseProtocol(response);
 	const data = await response.json().catch(() => null);
-	if (!response.ok) {
-		const message = data && typeof data === "object" && "error" in data && typeof data.error === "string" ? data.error : `HTTP ${response.status}`;
-		throw new Error(message);
-	}
+	if (!response.ok) throwEditorSyncError(response.status, data);
 	return editorSyncAccessResponseSchema.parse(data).access;
 }
+function throwEditorSyncError(status, data) {
+	const parsed = editorSyncErrorResponseSchema.safeParse(data);
+	const error = parsed.success ? parsed.data : void 0;
+	throw new EditorSyncError(error?.error ?? `HTTP ${status}`, status, error?.code);
+}
 function assertEditorSyncResponseProtocol(response) {
 	const selectedVersion = response.headers.get(EDITOR_SYNC_PROTOCOL_HEADER);
 	if (selectedVersion === null || selectedVersion === String(EDITOR_SYNC_PROTOCOL_VERSION)) return;
@@ -476,4 +489,4 @@ function stateSourceLocationUris(sourceLocations) {
 }
 
 //#endregion
-export { createRemoteEditorSyncBackend as n, fetchEditorSyncAccess as r, EditorHostSession as t };
+export { fetchEditorSyncAccess as i, EditorSyncError as n, createRemoteEditorSyncBackend as r, EditorHostSession as t };

package/dist/{editorHostSession-lL7wPLnL.d.mts → editorHostSession-CMwC9KKh.d.mts}

@@ -125,6 +125,11 @@ interface RemoteEditorSyncBackendOptions {
   apiKey?: string;
   fetch?: typeof globalThis.fetch;
 }
+declare class EditorSyncError extends Error {
+  readonly status: number;
+  readonly code: string | undefined;
+  constructor(message: string, status: number, code?: string);
+}
 declare function createRemoteEditorSyncBackend(options: RemoteEditorSyncBackendOptions): EditorSyncBackend;
 declare function fetchEditorSyncAccess(options: RemoteEditorSyncBackendOptions): Promise<EditorSyncAccess>;
 interface EditorSourceHost {
@@ -181,4 +186,4 @@ declare class EditorHostSession {
   private resolveRetrieved;
 }
 //#endregion
-export { RemoteEditorSyncBackendOptions as a, EDITOR_PROTOCOL_VERSION as c, EditorHostInitOptions as d, EditorHostOutboundMessage as f, EditorSyncBackend as i, EditorHostExportFormat as l, EditorHostSessionOptions as n, createRemoteEditorSyncBackend as o, EditorHostValidationIssue as p, EditorSourceHost as r, fetchEditorSyncAccess as s, EditorHostSession as t, EditorHostInboundMessage as u };
+export { EditorSyncError as a, fetchEditorSyncAccess as c, EditorHostInboundMessage as d, EditorHostInitOptions as f, EditorSyncBackend as i, EDITOR_PROTOCOL_VERSION as l, EditorHostValidationIssue as m, EditorHostSessionOptions as n, RemoteEditorSyncBackendOptions as o, EditorHostOutboundMessage as p, EditorSourceHost as r, createRemoteEditorSyncBackend as s, EditorHostSession as t, EditorHostExportFormat as u };

package/dist/editorHostSession.d.mts

@@ -1,2 +1,2 @@
-import { a as RemoteEditorSyncBackendOptions, c as EDITOR_PROTOCOL_VERSION, d as EditorHostInitOptions, f as EditorHostOutboundMessage, i as EditorSyncBackend, l as EditorHostExportFormat, n as EditorHostSessionOptions, o as createRemoteEditorSyncBackend, p as EditorHostValidationIssue, r as EditorSourceHost, s as fetchEditorSyncAccess, t as EditorHostSession, u as EditorHostInboundMessage } from "./editorHostSession-lL7wPLnL.mjs";
-export { EDITOR_PROTOCOL_VERSION, EditorHostExportFormat, EditorHostInboundMessage, EditorHostInitOptions, EditorHostOutboundMessage, EditorHostSession, EditorHostSessionOptions, EditorHostValidationIssue, EditorSourceHost, EditorSyncBackend, RemoteEditorSyncBackendOptions, createRemoteEditorSyncBackend, fetchEditorSyncAccess };
+import { a as EditorSyncError, c as fetchEditorSyncAccess, d as EditorHostInboundMessage, f as EditorHostInitOptions, i as EditorSyncBackend, l as EDITOR_PROTOCOL_VERSION, m as EditorHostValidationIssue, n as EditorHostSessionOptions, o as RemoteEditorSyncBackendOptions, p as EditorHostOutboundMessage, r as EditorSourceHost, s as createRemoteEditorSyncBackend, t as EditorHostSession, u as EditorHostExportFormat } from "./editorHostSession-CMwC9KKh.mjs";
+export { EDITOR_PROTOCOL_VERSION, EditorHostExportFormat, EditorHostInboundMessage, EditorHostInitOptions, EditorHostOutboundMessage, EditorHostSession, EditorHostSessionOptions, EditorHostValidationIssue, EditorSourceHost, EditorSyncBackend, EditorSyncError, RemoteEditorSyncBackendOptions, createRemoteEditorSyncBackend, fetchEditorSyncAccess };

package/dist/editorHostSession.mjs

@@ -1,4 +1,5 @@
-import { t as EDITOR_PROTOCOL_VERSION } from "./editorHostProtocol-D_h4y3rX.mjs";
-import { n as createRemoteEditorSyncBackend, r as fetchEditorSyncAccess, t as EditorHostSession } from "./editorHostSession-CCTwvUOB.mjs";
+import "./openapi-BTDjYWXd.mjs";
+import { t as EDITOR_PROTOCOL_VERSION } from "./editorHostProtocol-Bko7wge8.mjs";
+import { i as fetchEditorSyncAccess, n as EditorSyncError, r as createRemoteEditorSyncBackend, t as EditorHostSession } from "./editorHostSession-BZE_Wm0m.mjs";
 
-export { EDITOR_PROTOCOL_VERSION, EditorHostSession, createRemoteEditorSyncBackend, fetchEditorSyncAccess };
+export { EDITOR_PROTOCOL_VERSION, EditorHostSession, EditorSyncError, createRemoteEditorSyncBackend, fetchEditorSyncAccess };

package/dist/embed.d.mts

@@ -1,5 +1,5 @@
-import { l as ProfileManifest } from "./index-BABex8NE.mjs";
-import { i as StatelyGraph } from "./graph-B4WM_nYg.mjs";
+import { i as ProfileManifest } from "./index-D_pO_Pr8.mjs";
+import { i as StatelyGraph } from "./graph-1fwR0Ynl.mjs";
 import { CapabilityDeniedEvent, CommentsConfig, EditorCapabilities, EmbedDocument, EmbedDocumentLanguage, EmbedEventHandler, EmbedEventMap, EmbedEventName, EmbedExtensionsManifest, EmbedMode, ExportCallOptions, ExportFormat, ExportFormatMap, InitOptions, MachineInitOptions, MachineSourceLocations, ProjectEmbedMachine, UploadResult } from "./protocol.mjs";
 import { AssetUploadAdapter } from "./assetStorage.mjs";
 
@@ -72,6 +72,8 @@ type EmbedFormatDefinition = {
 interface StatelyEmbedOptions extends Partial<MachineInitOptions> {
   baseUrl: string;
   apiKey?: string;
+  /** Initial canvas view. Also reflected in the iframe URL as `?view=`. */
+  viewMode?: 'graph' | 'list';
   origin?: string;
   /**
    * Optional iframe to attach to immediately. Equivalent to calling
@@ -97,6 +99,7 @@ interface StatelyEmbedOptions extends Partial<MachineInitOptions> {
   onLoaded?: (graph: StatelyGraph) => void;
   onChange?: (graph: StatelyGraph, machineConfig: unknown) => void;
   onSave?: (graph: StatelyGraph, machineConfig: unknown) => void;
+  onViewModeChanged?: (viewMode: 'graph' | 'list') => void;
   onError?: (error: {
     code: string;
     message: string;

package/dist/embed.mjs

@@ -1,5 +1,5 @@
-import { a as createEventRegistry, o as createPendingExportManager, r as createPostMessageTransport, s as toInitMessage, t as SDK_VERSION } from "./version-CNeiHhaT.mjs";
-import { t as EDITOR_PROTOCOL_VERSION } from "./editorHostProtocol-D_h4y3rX.mjs";
+import { a as createEventRegistry, o as createPendingExportManager, r as createPostMessageTransport, s as toInitMessage, t as SDK_VERSION } from "./version-yzel-kpS.mjs";
+import { t as EDITOR_PROTOCOL_VERSION } from "./editorHostProtocol-Bko7wge8.mjs";
 
 //#region src/embed.ts
 function isRecord(value) {
@@ -29,6 +29,7 @@ function buildEmbedUrl(options) {
 	const base = options.baseUrl.replace(/\/+$/, "") + "/embed";
 	const url = new URL(base);
 	if (options.apiKey) url.searchParams.set("api_key", options.apiKey);
+	if (options.viewMode) url.searchParams.set("view", options.viewMode);
 	return url.toString();
 }
 function serializeExtensions(options) {
@@ -80,6 +81,7 @@ function extractInitOptions(options) {
 		capabilities: options.capabilities,
 		panels: options.panels,
 		commentsByMachineId: options.commentsByMachineId,
+		settings: options.settings,
 		unsavedIndicator: options.unsavedIndicator
 	};
 	if (options.machine !== void 0) return {
@@ -96,6 +98,7 @@ function extractInitOptions(options) {
 		panels: options.panels,
 		comments: options.comments,
 		sourceLocations: options.sourceLocations,
+		settings: options.settings,
 		unsavedIndicator: options.unsavedIndicator
 	};
 	return null;
@@ -275,6 +278,15 @@ function createStatelyEmbed(options) {
 			case "@statelyai.project.machineSelected":
 				events.emit("machineSelected", { machineId: String(data.machineId) });
 				break;
+			case "@statelyai.viewModeChanged": {
+				const viewMode = data;
+				options.onViewModeChanged?.(viewMode.viewMode);
+				events.emit("viewModeChanged", {
+					viewMode: viewMode.viewMode,
+					machineId: viewMode.machineId
+				});
+				break;
+			}
 			case "@statelyai.retrieved": {
 				const retrieved = data;
 				exportManager.resolve(retrieved.requestId, retrieved.data);

package/dist/{graph-B4WM_nYg.d.mts → graph-1fwR0Ynl.d.mts}

@@ -1,4 +1,4 @@
-import { r as CodeExpression } from "./index-BABex8NE.mjs";
+import { t as CodeExpression } from "./index-D_pO_Pr8.mjs";
 import * as _statelyai_graph0 from "@statelyai/graph";
 import { Graph } from "@statelyai/graph";
 

package/dist/graph.d.mts

@@ -1,2 +1,2 @@
-import { _ as studioMachineConverter, a as StatelyGraphData, c as StatelyInvoke, d as StudioAction, f as StudioEdge, g as fromStudioMachine, h as StudioNode, i as StatelyGraph, l as StatelyNodeData, m as StudioMachine, n as StatelyActorImplementation, o as StatelyGuard, p as StudioEventTypeData, r as StatelyEdgeData, s as StatelyImplementation, t as StatelyAction, u as StatelyTagImplementation, v as toStudioMachine } from "./graph-B4WM_nYg.mjs";
+import { _ as studioMachineConverter, a as StatelyGraphData, c as StatelyInvoke, d as StudioAction, f as StudioEdge, g as fromStudioMachine, h as StudioNode, i as StatelyGraph, l as StatelyNodeData, m as StudioMachine, n as StatelyActorImplementation, o as StatelyGuard, p as StudioEventTypeData, r as StatelyEdgeData, s as StatelyImplementation, t as StatelyAction, u as StatelyTagImplementation, v as toStudioMachine } from "./graph-1fwR0Ynl.mjs";
 export { StatelyAction, StatelyActorImplementation, StatelyEdgeData, StatelyGraph, StatelyGraphData, StatelyGuard, StatelyImplementation, StatelyInvoke, StatelyNodeData, StatelyTagImplementation, StudioAction, StudioEdge, StudioEventTypeData, StudioMachine, StudioNode, fromStudioMachine, studioMachineConverter, toStudioMachine };