@statelyai/sdk 0.27.0 → 0.28.0

package/dist/embed.d.mts

@@ -109,10 +109,7 @@ interface StatelyEmbedOptions extends Partial<MachineInitOptions> {
   onViewModeChanged?: (viewMode: 'graph' | 'list') => void;
   onPanelChanged?: (event: EmbedEventMap['panelChanged']) => void;
   onModeChanged?: (event: EmbedEventMap['modeChanged']) => void;
-  onError?: (error: {
-    code: string;
-    message: string;
-  }) => void;
+  onError?: (error: EmbedEventMap['error']) => void;
   onCapabilityDenied?: (event: CapabilityDeniedEvent) => void;
 }
 interface StatelyEmbed {

package/dist/embed.mjs

@@ -1,4 +1,4 @@
-import { a as createEventRegistry, o as createPendingExportManager, r as createPostMessageTransport, s as toInitMessage, t as SDK_VERSION } from "./version-7SUCFMqb.mjs";
+import { a as createEventRegistry, o as createPendingExportManager, r as createPostMessageTransport, s as toInitMessage, t as SDK_VERSION } from "./version-D_SqbrSy.mjs";
 import { t as EDITOR_PROTOCOL_VERSION } from "./editorHostProtocol-Bko7wge8.mjs";
 
 //#region src/embed.ts
@@ -364,7 +364,9 @@ function createStatelyEmbed(options) {
 				const error = data;
 				const err = {
 					code: error.code,
-					message: error.message
+					message: error.message,
+					...error.machineId !== void 0 ? { machineId: error.machineId } : {},
+					...error.details !== void 0 ? { details: error.details } : {}
 				};
 				exportManager.reject(new Error(err.message), error.requestId);
 				options.onError?.(err);

package/dist/index.mjs

@@ -1,13 +1,13 @@
 import "./openapi-BTDjYWXd.mjs";
 import { EMBED_DOCUMENT_LANGUAGES, EMBED_DOCUMENT_LIMITS, INSPECTION_PROTOCOL_VERSION, INSPECTION_ROOM_QUERY_PARAM, assertEmbedExamples, createInspectionActorId, createInspectionRoomUrls, getInspectionRoomId, isEmbedExample, isEmbedExampleMachine } from "./protocol.mjs";
-import { i as createWebSocketTransport, r as createPostMessageTransport } from "./version-7SUCFMqb.mjs";
+import { i as createWebSocketTransport, r as createPostMessageTransport } from "./version-D_SqbrSy.mjs";
 import { t as EDITOR_PROTOCOL_VERSION } from "./editorHostProtocol-Bko7wge8.mjs";
 import { createStatelyEmbed } from "./embed.mjs";
 import { i as fetchEditorSyncAccess, r as createRemoteEditorSyncBackend, t as EditorHostSession } from "./editorHostSession-shrjfosC.mjs";
 import { n as StudioApiError, r as createStatelyClient, t as DEFAULT_STATELY_BASE_URL } from "./studio-CNkxMZyz.mjs";
-import { a as RawCode, d as getXStateFSMCompatibilityIssues, g as jsonSchemaToTSType, h as graphToXStateTS, m as graphToXStateFSM, n as getStatelyPragma, p as graphToMachineConfig, r as upsertStatelyPragma, s as contextSchemaToTSType, t as findStatelyPragmaAttachments, u as eventsSchemaToTSType, v as raw, y as serializeJS } from "./statelyPragma-DD7wx7-b.mjs";
+import { a as RawCode, d as getXStateFSMCompatibilityIssues, g as jsonSchemaToTSType, h as graphToXStateTS, m as graphToXStateFSM, n as getStatelyPragma, p as graphToMachineConfig, r as upsertStatelyPragma, s as contextSchemaToTSType, t as findStatelyPragmaAttachments, u as eventsSchemaToTSType, v as raw, y as serializeJS } from "./statelyPragma-ByF0-L-N.mjs";
 import { createS3AssetUploadAdapter, createSupabaseAssetUploadAdapter } from "./assetStorage.mjs";
-import { n as createStatelyInspector, t as createInspector } from "./inspect-_E2lVbQA.mjs";
+import { n as createStatelyInspector, t as createInspector } from "./inspect-DSDnyzZ5.mjs";
 import { createAuthorizationHeader, getCredentialToken } from "./auth.mjs";
 import { buildAuthorizeUrl, createPkcePair, discoverAuthorizationServer, discoverProtectedResource, exchangeCodeForToken, refreshToken, registerOAuthClient } from "./oauth.mjs";
 import { StatelyApiError, createStatelyApiClient, createStatelyApiUrl } from "./api.mjs";

package/dist/{inspect-_E2lVbQA.mjs → inspect-DSDnyzZ5.mjs}

@@ -1,5 +1,5 @@
 import { INSPECTION_PROTOCOL_VERSION, createInspectionRoomUrls, getInspectionRoomId } from "./protocol.mjs";
-import { a as createEventRegistry, i as createWebSocketTransport, n as inspectionRuntime, o as createPendingExportManager, t as SDK_VERSION } from "./version-7SUCFMqb.mjs";
+import { a as createEventRegistry, i as createWebSocketTransport, n as inspectionRuntime, o as createPendingExportManager, t as SDK_VERSION } from "./version-D_SqbrSy.mjs";
 
 //#region src/openBrowser.ts
 async function openBrowser(url) {
@@ -360,7 +360,7 @@ function createInspector(options = {}) {
 		return {
 			sourceStateId: typeof source === "string" ? source : source?.id ?? null,
 			targetStateIds: targets.map((target) => typeof target === "string" ? target : target.id ?? "").filter(Boolean),
-			...(raw?.eventType ?? json?.eventType) && { eventType: raw?.eventType ?? json?.eventType },
+			...(raw?.eventType ?? json?.eventType) !== void 0 && { eventType: raw?.eventType ?? json?.eventType },
 			...(raw?.reenter ?? json?.reenter) !== void 0 && { reenter: raw?.reenter ?? json?.reenter }
 		};
 	}

package/dist/inspect.mjs

@@ -1,4 +1,4 @@
-import "./version-7SUCFMqb.mjs";
-import { n as createStatelyInspector, t as createInspector } from "./inspect-_E2lVbQA.mjs";
+import "./version-D_SqbrSy.mjs";
+import { n as createStatelyInspector, t as createInspector } from "./inspect-DSDnyzZ5.mjs";
 
 export { createInspector, createStatelyInspector };

package/dist/protocol.d.mts

@@ -254,8 +254,10 @@ interface EmbedEventMap {
     sourceLocations?: MachineSourceLocations;
   };
   error: {
-    code: string;
+    code: ErrorCode;
     message: string;
+    machineId?: string;
+    details?: string[];
   };
   capabilityDenied: CapabilityDeniedEvent;
   snapshot: {
@@ -706,10 +708,24 @@ interface RetrievedMessage {
   requestId: string;
   data: unknown;
 }
+/**
+ * Error codes the editor emits. Open-ended (`string`) so an older SDK keeps
+ * forwarding codes a newer editor adds.
+ *
+ * - `unsupported_protocol` — editor/SDK protocol versions disagree.
+ * - `conversion_failed` — a machine source could not be converted to a graph.
+ * - `invalid_graph` — a host-supplied graph is structurally invalid; see `details`.
+ * - `render_failed` — the editor threw while rendering a machine.
+ */
+type ErrorCode = 'unsupported_protocol' | 'conversion_failed' | 'invalid_graph' | 'render_failed' | (string & {});
 interface ErrorMessage {
   type: '@statelyai.error';
-  code: string;
+  code: ErrorCode;
   message: string;
+  /** Machine the error belongs to, when the editor knows which one failed. */
+  machineId?: string;
+  /** Per-problem explanations, e.g. one line per structural graph error. */
+  details?: string[];
   requestId?: string;
 }
 interface CapabilityDeniedMessage extends CapabilityDeniedEvent {
@@ -800,4 +816,4 @@ declare const PREFIX = "@statelyai.";
 /** Current WebSocket inspection protocol version. */
 declare const INSPECTION_PROTOCOL_VERSION = 2;
 //#endregion
-export { ActorSystemEntry, CapabilityDeniedCapability, CapabilityDeniedEvent, CapabilityDeniedMessage, ChangeMessage, ClientMessage, ClipboardReadMessage, ClipboardReadResponseMessage, ClipboardWriteMessage, ClipboardWriteResponseMessage, CommentsConfig, EMBED_DOCUMENT_LANGUAGES, EMBED_DOCUMENT_LIMITS, EditorCapabilities, EditorHandshakeMessage, EmbedDocument, EmbedDocumentLanguage, EmbedEventHandler, EmbedEventMap, EmbedEventName, EmbedExample, EmbedExtensionsManifest, EmbedFormatManifest, EmbedMode, type EmbedPanelConfig, type EmbedPanelPosition, ErrorMessage, ExportCallOptions, ExportFormat, ExportFormatMap, ExtensionCallMessage, ExtensionResultMessage, INSPECTION_PROTOCOL_VERSION, INSPECTION_ROOM_QUERY_PARAM, InitMessage, InitOptions, InspectSnapshotMessage, InspectionAction, InspectionClientMetadata, InspectionRoomUrls, InspectionSentEvent, InspectionTakenTransition, LoadedMessage, MachineInitOptions, MachineSourceLocations, MachineVersionAutoSaveOptions, ModeChangedMessage, PREFIX, PanelChangedMessage, ProjectEmbedMachine, ProjectInitMessage, ProjectInitOptions, ProjectMachineSelectedMessage, ProjectSelectMachineMessage, ProjectSetWorkspaceOpenMessage, ProjectUpdateMessage, ProjectWorkspaceAction, ProjectWorkspaceActionIcon, ProjectWorkspaceActionMessage, ProjectWorkspaceCapabilities, ProjectWorkspaceConfig, ProjectWorkspaceMachine, ProjectWorkspaceMachineOrigin, ProjectWorkspaceOpenChangedMessage, ProjectWorkspaceProject, ProtocolMessage, ReadOnlyReason, ReadyMessage, RegisterMessage, RegisteredMessage, RetrieveMessage, RetrievedMessage, SaveMessage, SavedMessage, SessionMessage, SetApiKeyMessage, SetModeMessage, SetSettingsMessage, SetThemeMessage, SourceLocation, SourceRange, StateSourceLocation, SystemActorEventMessage, SystemActorRegisteredMessage, SystemActorSnapshotMessage, SystemActorStoppedMessage, SystemInitMessage, SystemSelectActorMessage, ToastMessage, UpdateMessage, UploadCapabilitiesMessage, UploadFileInfo, UploadRequestMessage, UploadResponseMessage, UploadResult, ValidationIssue, VersionSaveRequestedMessage, ViewModeChangedMessage, VizMessage, assertEmbedExamples, createInspectionActorId, createInspectionRoomUrls, getInspectionRoomId, isEmbedExample, isEmbedExampleMachine };
+export { ActorSystemEntry, CapabilityDeniedCapability, CapabilityDeniedEvent, CapabilityDeniedMessage, ChangeMessage, ClientMessage, ClipboardReadMessage, ClipboardReadResponseMessage, ClipboardWriteMessage, ClipboardWriteResponseMessage, CommentsConfig, EMBED_DOCUMENT_LANGUAGES, EMBED_DOCUMENT_LIMITS, EditorCapabilities, EditorHandshakeMessage, EmbedDocument, EmbedDocumentLanguage, EmbedEventHandler, EmbedEventMap, EmbedEventName, EmbedExample, EmbedExtensionsManifest, EmbedFormatManifest, EmbedMode, type EmbedPanelConfig, type EmbedPanelPosition, ErrorCode, ErrorMessage, ExportCallOptions, ExportFormat, ExportFormatMap, ExtensionCallMessage, ExtensionResultMessage, INSPECTION_PROTOCOL_VERSION, INSPECTION_ROOM_QUERY_PARAM, InitMessage, InitOptions, InspectSnapshotMessage, InspectionAction, InspectionClientMetadata, InspectionRoomUrls, InspectionSentEvent, InspectionTakenTransition, LoadedMessage, MachineInitOptions, MachineSourceLocations, MachineVersionAutoSaveOptions, ModeChangedMessage, PREFIX, PanelChangedMessage, ProjectEmbedMachine, ProjectInitMessage, ProjectInitOptions, ProjectMachineSelectedMessage, ProjectSelectMachineMessage, ProjectSetWorkspaceOpenMessage, ProjectUpdateMessage, ProjectWorkspaceAction, ProjectWorkspaceActionIcon, ProjectWorkspaceActionMessage, ProjectWorkspaceCapabilities, ProjectWorkspaceConfig, ProjectWorkspaceMachine, ProjectWorkspaceMachineOrigin, ProjectWorkspaceOpenChangedMessage, ProjectWorkspaceProject, ProtocolMessage, ReadOnlyReason, ReadyMessage, RegisterMessage, RegisteredMessage, RetrieveMessage, RetrievedMessage, SaveMessage, SavedMessage, SessionMessage, SetApiKeyMessage, SetModeMessage, SetSettingsMessage, SetThemeMessage, SourceLocation, SourceRange, StateSourceLocation, SystemActorEventMessage, SystemActorRegisteredMessage, SystemActorSnapshotMessage, SystemActorStoppedMessage, SystemInitMessage, SystemSelectActorMessage, ToastMessage, UpdateMessage, UploadCapabilitiesMessage, UploadFileInfo, UploadRequestMessage, UploadResponseMessage, UploadResult, ValidationIssue, VersionSaveRequestedMessage, ViewModeChangedMessage, VizMessage, assertEmbedExamples, createInspectionActorId, createInspectionRoomUrls, getInspectionRoomId, isEmbedExample, isEmbedExampleMachine };

package/dist/{statelyPragma-DD7wx7-b.mjs → statelyPragma-ByF0-L-N.mjs}

@@ -3535,7 +3535,7 @@ function deepSimplify(config) {
 	return config;
 }
 function buildMeta(meta, color) {
-	if (isCodeExpression$2(meta)) return meta;
+	if (isCodeExpression$3(meta)) return meta;
 	const result = {};
 	if (meta) {
 		for (const [k, v] of Object.entries(meta)) if (v !== void 0 && v !== null) result[k] = v;
@@ -3543,7 +3543,7 @@ function buildMeta(meta, color) {
 	if (color) result["@statelyai.color"] = color;
 	return Object.keys(result).length > 0 ? result : void 0;
 }
-function isCodeExpression$2(value) {
+function isCodeExpression$3(value) {
 	return Boolean(value && typeof value === "object" && !Array.isArray(value) && value["@type"] === "code" && typeof value.expr === "string");
 }
 /** Format event param — supports { type: string } (new) and plain string (legacy) */
@@ -3554,7 +3554,7 @@ function formatEventParam(event) {
 }
 function formatStringParam(value) {
 	if (typeof value === "string") return `'${value}'`;
-	return isCodeExpression$2(value) ? serializeJS(value) : "undefined";
+	return isCodeExpression$3(value) ? serializeJS(value) : "undefined";
 }
 function formatInlineObject(value) {
 	return `{ ${Object.entries(value).filter(([, item]) => item !== void 0).map(([key, item]) => `${formatObjectKey(key)}: ${serializeJS(item)}`).join(", ")} }`;
@@ -3692,6 +3692,7 @@ const XSTATE_BUILT_IN_ACTIONS = {
 		importKind: "named",
 		paramsSchema: builtInActionParamSchemas["xstate.assign"],
 		emit(params) {
+			if (isCodeExpression$3(params?.assignment)) return `assign(${serializeJS(params.assignment)})`;
 			const assignments = params?.assignment && typeof params.assignment === "object" && !Array.isArray(params.assignment) ? params.assignment : params;
 			const entries = Object.entries(assignments ?? {}).filter(([k, v]) => k && v !== void 0);
 			if (entries.length === 0) return "assign({})";
@@ -6366,7 +6367,7 @@ function getXStateFSMCompatibilityIssues(graph) {
 		if (!edge.data.eventType) issues.add("eventless transitions");
 		if (!stateIds.has(edge.targetId) && edge.data.transitionType !== "targetless") issues.add("transitions outside the flat state set");
 		if (edge.data.guard || edge.data.actions?.length || edge.data.matches || edge.data.input !== void 0 || edge.data.transitionType === "reenter") issues.add("guards, actions, matching, transition input, or reentry");
-		if (isCodeExpression$1(edge.data.context)) issues.add("dynamic transition context");
+		if (isCodeExpression$2(edge.data.context)) issues.add("dynamic transition context");
 	}
 	if ([...eventCounts.values()].some((count) => count > 1)) issues.add("multiple transitions for one event");
 	return [...issues];
@@ -6408,7 +6409,7 @@ function buildState(graph, state, stateById) {
 }
 function buildTransition$1(edge, stateById) {
 	const target = edge.data.transitionType === "targetless" ? void 0 : stateById.get(edge.targetId)?.data.key;
-	const context = isCodeExpression$1(edge.data.context) ? void 0 : edge.data.context;
+	const context = isCodeExpression$2(edge.data.context) ? void 0 : edge.data.context;
 	if (context !== void 0) return {
 		target,
 		context
@@ -6446,7 +6447,7 @@ function eventPayloadType(schema) {
 		required
 	});
 }
-function isCodeExpression$1(value) {
+function isCodeExpression$2(value) {
 	return !!value && typeof value === "object" && !Array.isArray(value) && value["@type"] === "code";
 }
 const colorSchema = _enum([

package/dist/sync.mjs

@@ -1,6 +1,6 @@
 import "./openapi-BTDjYWXd.mjs";
 import { r as createStatelyClient } from "./studio-CNkxMZyz.mjs";
-import { _ as normalizeMachineProfile, b as xstateSourceToConfig, c as detectXStateSourceProfile, f as graphChangeToPatchesResult, h as graphToXStateTS, i as INLINE_EXPRESSION_DIRECTIVE_FIELDS, l as diffGraphsSemantically, n as getStatelyPragma, o as alignCompareGraphIds, p as graphToMachineConfig, r as upsertStatelyPragma, t as findStatelyPragmaAttachments, y as serializeJS } from "./statelyPragma-DD7wx7-b.mjs";
+import { _ as normalizeMachineProfile, b as xstateSourceToConfig, c as detectXStateSourceProfile, f as graphChangeToPatchesResult, h as graphToXStateTS, i as INLINE_EXPRESSION_DIRECTIVE_FIELDS, l as diffGraphsSemantically, n as getStatelyPragma, o as alignCompareGraphIds, p as graphToMachineConfig, r as upsertStatelyPragma, t as findStatelyPragmaAttachments, y as serializeJS } from "./statelyPragma-ByF0-L-N.mjs";
 import { fromStudioMachine, toStudioMachine } from "./graph.mjs";
 import * as ts$1 from "typescript";
 import ts from "typescript";

package/dist/{version-7SUCFMqb.mjs → version-D_SqbrSy.mjs}

@@ -364,7 +364,7 @@ function createWebSocketTransport(options) {
 
 //#endregion
 //#region src/version.ts
-const SDK_VERSION = "0.27.0";
+const SDK_VERSION = "0.28.0";
 function inspectionRuntime() {
 	if (typeof window !== "undefined") return "browser";
 	if (typeof process !== "undefined" && process.versions?.node) return "node";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@statelyai/sdk",
-  "version": "0.27.0",
+  "version": "0.28.0",
   "license": "MIT",
   "bin": {
     "stately-sdk": "./dist/bin.mjs"
@@ -93,8 +93,8 @@
     "jsdom": "^27.4.0",
     "tsdown": "0.21.0-beta.2",
     "vitest": "^3.2.4",
-    "@statelyai/api-contract": "0.3.13",
-    "@statelyai/graph-tools": "0.5.0"
+    "@statelyai/api-contract": "0.3.15",
+    "@statelyai/graph-tools": "0.6.0"
   },
   "engines": {
     "node": ">=22.4"