@statelyai/sdk 0.18.0 → 0.20.1

package/dist/editorHostSession-lL7wPLnL.d.mts

@@ -0,0 +1,184 @@
+import { a as EditorSyncParseRequest, d as EditorSyncTextReplacement, f as MachineSourceLocations, i as EditorSyncApplyResponse, n as EditorSyncAccess, o as EditorSyncParseResponse, r as EditorSyncApplyRequest, s as EditorSyncSourceDocument, t as EditorCapabilities } from "./editor-sync-types-C-zWaaVk.mjs";
+
+//#region src/editorHostProtocol.d.ts
+declare const EDITOR_PROTOCOL_VERSION = 1;
+type EditorHostExportFormat = 'xstate-v6' | 'xstate' | 'async' | 'xstate-json' | 'xgraph' | 'digraph' | 'd2' | 'mermaid' | 'redux' | 'zustand' | 'asl-json' | 'asl-yaml' | 'scxml';
+interface EditorHostValidationIssue {
+  nodeIds: string[];
+  edgeIds: string[];
+  level: 'info' | 'warning' | 'error';
+  message: string;
+}
+type EditorHostInboundMessage = {
+  type: '@statelyai.ready';
+  version?: string;
+  protocolVersion?: number;
+} | {
+  type: '@statelyai.loaded';
+  graph: unknown;
+  sourceLocations?: MachineSourceLocations;
+} | {
+  type: '@statelyai.change';
+  graph: unknown;
+  machineConfig: unknown;
+  patches?: unknown[];
+  sourceLocations?: MachineSourceLocations;
+} | {
+  type: '@statelyai.save';
+  graph: unknown;
+  machineConfig: unknown;
+  patches?: unknown[];
+  validations?: EditorHostValidationIssue[];
+  sourceLocations?: MachineSourceLocations;
+} | {
+  type: '@statelyai.retrieved';
+  requestId: string;
+  data: unknown;
+} | {
+  type: '@statelyai.error';
+  code: string;
+  message: string;
+  requestId?: string;
+} | {
+  type: '@statelyai.clipboardRead';
+  requestId: string;
+} | {
+  type: '@statelyai.clipboardWrite';
+  requestId: string;
+  text: string;
+};
+interface EditorHostInitOptions {
+  settings?: Record<string, unknown>;
+  leftPanels?: string[];
+  rightPanels?: string[];
+  activePanels?: string[];
+  unsavedIndicator?: {
+    enabled?: boolean;
+    mode?: 'structural' | 'all';
+  };
+}
+type EditorHostOutboundMessage = {
+  type: '@statelyai.init';
+  machine: unknown;
+  format?: string;
+  mode?: 'editing' | 'viewing';
+  theme?: 'light' | 'dark';
+  readOnly?: boolean;
+  readOnlyReason?: 'free-plan' | 'access-unverified';
+  capabilities?: EditorCapabilities;
+  sourceLocations?: MachineSourceLocations;
+  settings?: Record<string, unknown>;
+  leftPanels?: string[];
+  rightPanels?: string[];
+  activePanels?: string[];
+  unsavedIndicator?: {
+    enabled?: boolean;
+    mode?: 'structural' | 'all';
+  };
+} | {
+  type: '@statelyai.setApiKey';
+  apiKey: string;
+} | {
+  type: '@statelyai.handshake';
+  protocolVersion: number;
+  client?: {
+    name: string;
+    version: string;
+  };
+} | {
+  type: '@statelyai.update';
+  machine: unknown;
+  format?: string;
+  sourceLocations?: MachineSourceLocations;
+} | {
+  type: '@statelyai.saved';
+  graph: unknown;
+} | {
+  type: '@statelyai.retrieve';
+  requestId: string;
+  format: EditorHostExportFormat;
+} | {
+  type: '@statelyai.toast';
+  message: string;
+  toastType?: 'success' | 'error' | 'info' | 'warning';
+} | {
+  type: '@statelyai.error';
+  code: string;
+  message: string;
+} | {
+  type: '@statelyai.clipboardReadResponse';
+  requestId: string;
+  text: string;
+} | {
+  type: '@statelyai.clipboardWriteResponse';
+  requestId: string;
+  ok: boolean;
+};
+//#endregion
+//#region src/editorHostSession.d.ts
+interface EditorSyncBackend {
+  parse(request: EditorSyncParseRequest): Promise<EditorSyncParseResponse>;
+  apply(request: EditorSyncApplyRequest): Promise<EditorSyncApplyResponse>;
+}
+interface RemoteEditorSyncBackendOptions {
+  editorUrl: string;
+  apiKey?: string;
+  fetch?: typeof globalThis.fetch;
+}
+declare function createRemoteEditorSyncBackend(options: RemoteEditorSyncBackendOptions): EditorSyncBackend;
+declare function fetchEditorSyncAccess(options: RemoteEditorSyncBackendOptions): Promise<EditorSyncAccess>;
+interface EditorSourceHost {
+  rootUri: string;
+  rootFileName: string;
+  rootDir: string;
+  collectDocuments(extraUris?: readonly string[]): Promise<EditorSyncSourceDocument[]>;
+  applyReplacements(replacements: EditorSyncTextReplacement[], rootUri: string): Promise<string[]>;
+  saveDocuments?(uris: string[]): Promise<void>;
+  watchSavedDocuments?(listener: (uri: string) => void | Promise<void>): {
+    dispose(): void;
+  };
+  getPreserveStatelyMetadata?(uri: string): boolean;
+}
+interface EditorHostSessionOptions {
+  source: EditorSourceHost;
+  sync: EditorSyncBackend;
+  send(message: EditorHostOutboundMessage): void;
+  access?: EditorSyncAccess;
+  apiKey?: string;
+  getTheme?(): 'light' | 'dark';
+  showError?(message: string): void;
+  readClipboard?(): Promise<string>;
+  writeClipboard?(text: string): Promise<void>;
+  init?: EditorHostInitOptions;
+  client?: {
+    name: string;
+    version: string;
+  };
+}
+declare class EditorHostSession {
+  private options;
+  private editorProtocolState;
+  private currentGraph;
+  private lastPersistedGraph;
+  private currentFormat;
+  private currentSourceLocations;
+  private access;
+  private watchedSourceUris;
+  private selfEditCount;
+  private watcher;
+  private retrieveRequestCount;
+  private pendingRetrievals;
+  constructor(options: EditorHostSessionOptions);
+  dispose(): void;
+  notifySavedDocument(uri?: string): Promise<void>;
+  receive(message: EditorHostInboundMessage): Promise<void>;
+  private initialize;
+  private save;
+  private handleSavedDocument;
+  private updateWatchedSourceUris;
+  private getSerializedPayload;
+  private requestSerialized;
+  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 };

package/dist/editorHostSession.d.mts

@@ -0,0 +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 };

package/dist/editorHostSession.mjs

@@ -0,0 +1,4 @@
+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";
+
+export { EDITOR_PROTOCOL_VERSION, EditorHostSession, createRemoteEditorSyncBackend, fetchEditorSyncAccess };

package/dist/embed.d.mts

@@ -1,4 +1,4 @@
-import { i as StatelyGraph } from "./graph-DuOeLGvh.mjs";
+import { i as StatelyGraph } from "./graph-yDK-MM3G.mjs";
 import { CapabilityDeniedEvent, CommentsConfig, EditorCapabilities, EmbedDocument, EmbedDocumentLanguage, EmbedEventHandler, EmbedEventMap, EmbedEventName, EmbedMode, ExportCallOptions, ExportFormat, ExportFormatMap, InitOptions, MachineInitOptions, MachineSourceLocations, ProjectEmbedMachine, UploadResult } from "./protocol.mjs";
 import { AssetUploadAdapter } from "./assetStorage.mjs";
 

package/dist/embed.mjs

@@ -1,4 +1,5 @@
-import { a as toInitMessage, i as createPendingExportManager, r as createEventRegistry, t as createPostMessageTransport } from "./transport-CyCrdKyz.mjs";
+import { a as createEventRegistry, o as createPendingExportManager, r as createPostMessageTransport, s as toInitMessage, t as SDK_VERSION } from "./version-YJizbJxR.mjs";
+import { t as EDITOR_PROTOCOL_VERSION } from "./editorHostProtocol-D_h4y3rX.mjs";
 
 //#region src/embed.ts
 function buildEmbedUrl(options) {
@@ -45,6 +46,7 @@ function createStatelyEmbed(options) {
 	let transport = null;
 	let ownedIframe = false;
 	let destroyed = false;
+	let editorProtocolCompatible;
 	const pendingMessages = [];
 	const events = createEventRegistry();
 	const exportManager = createPendingExportManager((message) => send(message));
@@ -56,6 +58,7 @@ function createStatelyEmbed(options) {
 	const assetAccept = options.assets?.accept ?? assetUploadAdapter?.accept;
 	const assetMaxFileSize = options.assets?.maxFileSize ?? assetUploadAdapter?.maxFileSize;
 	function send(msg) {
+		if (editorProtocolCompatible === false) return;
 		if (!transport?.ready) {
 			pendingMessages.push(msg);
 			return;
@@ -63,7 +66,7 @@ function createStatelyEmbed(options) {
 		transport.send(msg);
 	}
 	function flush() {
-		if (!transport) return;
+		if (!transport || editorProtocolCompatible === false) return;
 		while (pendingMessages.length > 0) {
 			const msg = pendingMessages.shift();
 			transport.send(msg);
@@ -74,6 +77,27 @@ function createStatelyEmbed(options) {
 		switch (data.type) {
 			case "@statelyai.ready": {
 				const ready = data;
+				if (ready.protocolVersion !== void 0) {
+					if (ready.protocolVersion !== EDITOR_PROTOCOL_VERSION) {
+						editorProtocolCompatible = false;
+						const error = {
+							code: "unsupported_protocol",
+							message: `Editor protocol ${ready.protocolVersion} is unsupported; this SDK supports ${EDITOR_PROTOCOL_VERSION}.`
+						};
+						options.onError?.(error);
+						events.emit("error", error);
+						break;
+					}
+					editorProtocolCompatible = true;
+					send({
+						type: "@statelyai.handshake",
+						protocolVersion: EDITOR_PROTOCOL_VERSION,
+						client: {
+							name: "@statelyai/sdk",
+							version: SDK_VERSION
+						}
+					});
+				} else editorProtocolCompatible = true;
 				flush();
 				if (uploadAsset) send({
 					type: "@statelyai.uploadCapabilities",
@@ -189,6 +213,7 @@ function createStatelyEmbed(options) {
 	}
 	function replaceTransport(nextTransport) {
 		transport?.destroy();
+		editorProtocolCompatible = void 0;
 		transport = nextTransport;
 	}
 	function setupTransport(el) {
@@ -198,7 +223,10 @@ function createStatelyEmbed(options) {
 		});
 		replaceTransport(nextTransport);
 		nextTransport.onMessage(handleMessage);
-		nextTransport.onReady(flush);
+		nextTransport.onReady(() => {
+			editorProtocolCompatible ??= true;
+			flush();
+		});
 	}
 	const embed = {
 		attach(el) {

package/dist/{graph-DuOeLGvh.d.mts → graph-yDK-MM3G.d.mts}

@@ -1,4 +1,4 @@
-import { r as CodeExpression } from "./index-ag6K2iAS.mjs";
+import { r as CodeExpression } from "./index-BAkQThnl.mjs";
 import * as _statelyai_graph0 from "@statelyai/graph";
 import { Graph } from "@statelyai/graph";
 
@@ -204,7 +204,7 @@ interface DigraphData {
 }
 interface DigraphConfig {
   id: string;
-  profile?: 'xstate-v5' | 'xstate-v6-alpha';
+  profile?: `@${string}/${string}@${string}` | 'xstate-v5' | 'xstate-v6-alpha';
   rootNode: DigraphNodeConfig;
   edges: DigraphEdgeConfig[];
   context: Record<string, JsonItem> | JsonExpressionString;
@@ -335,7 +335,7 @@ interface StatelyEdgeData {
   meta?: Record<string, unknown> | null;
 }
 interface StatelyGraphData {
-  profile?: 'xstate-v5' | 'xstate-v6-alpha';
+  profile?: `@${string}/${string}@${string}` | 'xstate-v5' | 'xstate-v6-alpha';
   schemas?: {
     context?: Record<string, SimpleJsonSchema> | null;
     events?: Record<string, SimpleJsonSchemaObject> | null;
@@ -385,7 +385,9 @@ interface StatelyTagImplementation {
   icon?: string;
   color?: string;
 }
-type StatelyGraph = Graph<StatelyNodeData, StatelyEdgeData, StatelyGraphData>;
+type StatelyGraph = Graph<StatelyNodeData, StatelyEdgeData, StatelyGraphData> & {
+  xgraphSchemaVersion?: '1.0.0';
+};
 type StudioMachine = DigraphConfig;
 type StudioNode = DigraphNodeConfig;
 type StudioEdge = DigraphEdgeConfig;

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-DuOeLGvh.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-yDK-MM3G.mjs";
 export { StatelyAction, StatelyActorImplementation, StatelyEdgeData, StatelyGraph, StatelyGraphData, StatelyGuard, StatelyImplementation, StatelyInvoke, StatelyNodeData, StatelyTagImplementation, StudioAction, StudioEdge, StudioEventTypeData, StudioMachine, StudioNode, fromStudioMachine, studioMachineConverter, toStudioMachine };

package/dist/{index-ag6K2iAS.d.mts → index-BAkQThnl.d.mts}

@@ -2276,10 +2276,14 @@ interface JSONSchema7 {
 }
 //#endregion
 //#region ../graph-tools/dist/index.d.mts
+declare const LEGACY_MACHINE_PROFILES: readonly ["xstate-v5", "xstate-v6-alpha"];
+type LegacyMachineProfile = (typeof LEGACY_MACHINE_PROFILES)[number];
 //#endregion
-//#region src/machineProfile.d.ts
-declare const MACHINE_PROFILES: readonly ["xstate-v5", "xstate-v6-alpha"];
-type MachineProfile = (typeof MACHINE_PROFILES)[number];
+//#region src/profiles/profileRefs.d.ts
+type ProfileName = `@${string}/${string}`;
+type ProfileSpecifier = `${ProfileName}@${string}`;
+type ResolvedProfileRef = ProfileSpecifier;
+type ProfileRefInput = ResolvedProfileRef | LegacyMachineProfile;
 //#endregion
 //#region src/codegenTypes.d.ts
 interface CodeGenAction {
@@ -2384,7 +2388,7 @@ interface CodeGenActorImplementation {
   } | null;
 }
 interface CodeGenGraphData {
-  profile?: MachineProfile;
+  profile?: ProfileRefInput;
   context?: Record<string, unknown> | CodeExpression | null;
   schemas?: {
     context?: Record<string, JSONSchema7> | null;
@@ -2445,11 +2449,7 @@ declare class RawCode {
 }
 declare function raw(code: string): RawCode;
 declare function serializeJS(value: unknown, indent?: number, step?: number): string; //#endregion
-//#region src/v6Simulation.d.ts
-/**
- * Adapts Viz's serializable choice projection to XState v6's executable
- * `choice` function. Other v6 config stays untouched.
- */
+//#region src/profiles/xgraphMetadata.d.ts
 //#endregion
 //#region src/graphToXStateTS.d.ts
 interface XStateTSOptions extends MachineConfigOptions {

package/dist/index.d.mts

@@ -1,12 +1,13 @@
 import { StatelyApiClientOptions, StatelyApiError, StatelyApiUrlOptions, createStatelyApiClient, createStatelyApiUrl } from "./api.mjs";
-import { _ as serializeJS, c as MachineConfigOptions, d as contextSchemaToTSType, f as eventsSchemaToTSType, g as raw, h as jsonSchemaToTSType, i as CodeGenGraph, l as RawCode, m as graphToXStateTS, o as GraphPatch, p as graphToMachineConfig, t as ActionLocation, u as XStateTSOptions } from "./index-ag6K2iAS.mjs";
-import { C as EventTypeData, S as DigraphNodeConfig, _ as studioMachineConverter, a as StatelyGraphData, b as DigraphConfig, c as StatelyInvoke, d as StudioAction, f as StudioEdge, g as fromStudioMachine, h as StudioNode, i as StatelyGraph, l as StatelyNodeData, m as StudioMachine, o as StatelyGuard, r as StatelyEdgeData, t as StatelyAction, v as toStudioMachine, w as StateNodeJSONData, x as DigraphEdgeConfig, y as DigraphAction } from "./graph-DuOeLGvh.mjs";
+import { _ as serializeJS, c as MachineConfigOptions, d as contextSchemaToTSType, f as eventsSchemaToTSType, g as raw, h as jsonSchemaToTSType, i as CodeGenGraph, l as RawCode, m as graphToXStateTS, o as GraphPatch, p as graphToMachineConfig, t as ActionLocation, u as XStateTSOptions } from "./index-BAkQThnl.mjs";
+import { C as EventTypeData, S as DigraphNodeConfig, _ as studioMachineConverter, a as StatelyGraphData, b as DigraphConfig, c as StatelyInvoke, d as StudioAction, f as StudioEdge, g as fromStudioMachine, h as StudioNode, i as StatelyGraph, l as StatelyNodeData, m as StudioMachine, o as StatelyGuard, r as StatelyEdgeData, t as StatelyAction, v as toStudioMachine, w as StateNodeJSONData, x as DigraphEdgeConfig, y as DigraphAction } from "./graph-yDK-MM3G.mjs";
 import { CapabilityDeniedCapability, CapabilityDeniedEvent, CommentsConfig, EMBED_DOCUMENT_LANGUAGES, EMBED_DOCUMENT_LIMITS, EditorCapabilities, EmbedDocument, EmbedDocumentLanguage, EmbedEventHandler, EmbedEventMap, EmbedEventName, EmbedMode, ExportCallOptions, ExportFormat, ExportFormatMap, INSPECTION_PROTOCOL_VERSION, INSPECTION_ROOM_QUERY_PARAM, InitOptions, InspectionAction, InspectionSentEvent, InspectionTakenTransition, ProjectEmbedMachine, UploadResult, createInspectionActorId, createInspectionRoomUrls, getInspectionRoomId } from "./protocol.mjs";
 import { AssetUploadAdapter, AssetUploadContext, AssetUploadRequest, CreateS3AssetUploadAdapterOptions, CreateSupabaseAssetUploadAdapterOptions, S3UploadTarget, SupabaseStorageClient, createS3AssetUploadAdapter, createSupabaseAssetUploadAdapter } from "./assetStorage.mjs";
-import { i as getCredentialToken, n as StatelyCredential, r as createAuthorizationHeader, t as StatelyAuthMode } from "./auth-2Thaw42j.mjs";
+import { i as getCredentialToken, n as StatelyCredential, r as createAuthorizationHeader, t as StatelyAuthMode } from "./auth-B0ZTKri2.mjs";
+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";
 import { AssetConfig, StatelyEmbed, StatelyEmbedOptions, createStatelyEmbed } from "./embed.mjs";
-import { a as InspectedTransition, c as InspectorInspectionEvent, d as createStatelyInspector, f as Transport, h as createWebSocketTransport, i as InspectedSnapshot, l as ManualActorOptions, m as createPostMessageTransport, n as CreateInspectorOptions, o as Inspector, p as TransportFailure, r as InspectedEvent, s as InspectorEvents, t as AdoptedActor, u as createInspector } from "./inspect-BZFzyeew.mjs";
-import { A as Machine, C as StudioMachineRecord, D as VerifyApiKeyResponse, E as UpdateProjectInput, F as ProjectVisibility, I as VerifyResult, L as XStateVersion, M as Project, N as ProjectMachineSummary, O as createStatelyClient, P as ProjectSummary, R as ResourceErrorCode, S as StudioClientOptions, T as UpdateMachineInput, _ as ProjectMachine, a as CreateMachineTemplate, b as StudioApiErrorOptions, c as EnsureProjectInput, d as ExtractedMachine, f as GetMachineOptions, g as ProjectData, h as LegacyUpdateMachineInput, i as CreateMachineInput, j as MachineVersion, k as ExtractedMachines, l as ExtractMachinesInput, m as LegacyProjectVisibility, n as CreateMachineFromDefinitionInput, o as CreateProjectInput, r as CreateMachineFromTemplateInput, s as DEFAULT_STATELY_BASE_URL, t as ConnectedRepo, u as ExtractMachinesResponse, v as RepoType, w as StudioRequestOptions, x as StudioClient, y as StudioApiError } from "./studio-Bk_u41gu.mjs";
+import { a as InspectedTransition, c as InspectorInspectionEvent, d as createStatelyInspector, f as Transport, h as createWebSocketTransport, i as InspectedSnapshot, l as ManualActorOptions, m as createPostMessageTransport, n as CreateInspectorOptions, o as Inspector, p as TransportFailure, r as InspectedEvent, s as InspectorEvents, t as AdoptedActor, u as createInspector } from "./inspect-CGJR4iZK.mjs";
+import { A as Machine, C as StudioMachineRecord, D as VerifyApiKeyResponse, E as UpdateProjectInput, F as ProjectVisibility, I as VerifyResult, L as XStateVersion, M as Project, N as ProjectMachineSummary, O as createStatelyClient, P as ProjectSummary, R as ResourceErrorCode, S as StudioClientOptions, T as UpdateMachineInput, _ as ProjectMachine, a as CreateMachineTemplate, b as StudioApiErrorOptions, c as EnsureProjectInput, d as ExtractedMachine, f as GetMachineOptions, g as ProjectData, h as LegacyUpdateMachineInput, i as CreateMachineInput, j as MachineVersion, k as ExtractedMachines, l as ExtractMachinesInput, m as LegacyProjectVisibility, n as CreateMachineFromDefinitionInput, o as CreateProjectInput, r as CreateMachineFromTemplateInput, s as DEFAULT_STATELY_BASE_URL, t as ConnectedRepo, u as ExtractMachinesResponse, v as RepoType, w as StudioRequestOptions, x as StudioClient, y as StudioApiError } from "./studio-YSppd-am.mjs";
 import { OAuthAuthorizationServerMetadata, OAuthClientRegistrationResponse, OAuthProtectedResourceMetadata, OAuthTokenResponse, PkcePair, buildAuthorizeUrl, createPkcePair, discoverAuthorizationServer, discoverProtectedResource, exchangeCodeForToken, refreshToken, registerOAuthClient } from "./oauth.mjs";
 import { PlanSyncOptions, PullSyncResult, PushLocalMachineLinksResult, PushSyncOptions, PushSyncProjectOptions, PushSyncResult, ResolvedSyncInput, SyncInputFormat, SyncPlan, SyncPlanSummary } from "./sync.mjs";
 import { CreateInspectionRelayOptions, InspectionRelay, InspectionRelayEffect, InspectionRelayPeer, InspectionRelayRole, InspectionRelaySnapshot, createInspectionRelay } from "./relay.mjs";
@@ -32,4 +33,4 @@ declare function findStatelyPragmaAttachments(sourceText: string, fileName?: str
 declare function getStatelyPragma(sourceText: string, fileName?: string, machineIndex?: number): StatelyPragma | undefined;
 declare function upsertStatelyPragma(sourceText: string, id: string, options?: UpsertStatelyPragmaOptions): string;
 //#endregion
-export { type ActionLocation, type AdoptedActor, type AssetConfig, type AssetUploadAdapter, type AssetUploadContext, type AssetUploadRequest, type CapabilityDeniedCapability, type CapabilityDeniedEvent, type CodeGenGraph, type CommentsConfig, type ConnectedRepo, type CreateInspectionRelayOptions, type CreateInspectorOptions, type CreateMachineFromDefinitionInput, type CreateMachineFromTemplateInput, type CreateMachineInput, type CreateMachineTemplate, type CreateProjectInput, type CreateS3AssetUploadAdapterOptions, type CreateSupabaseAssetUploadAdapterOptions, DEFAULT_STATELY_BASE_URL, type DigraphAction, type DigraphConfig, type DigraphEdgeConfig, type DigraphNodeConfig, EMBED_DOCUMENT_LANGUAGES, EMBED_DOCUMENT_LIMITS, type EditorCapabilities, type EmbedDocument, type EmbedDocumentLanguage, type EmbedEventHandler, type EmbedEventMap, type EmbedEventName, type EmbedMode, type EnsureProjectInput, type EventTypeData, type ExportCallOptions, type ExportFormat, type ExportFormatMap, type ExtractMachinesInput, type ExtractMachinesResponse, type ExtractedMachine, type ExtractedMachines, type GetMachineOptions, type GraphPatch, INSPECTION_PROTOCOL_VERSION, INSPECTION_ROOM_QUERY_PARAM, type InitOptions, type InspectedEvent, type InspectedSnapshot, type InspectedTransition, type InspectionAction, type InspectionRelay, type InspectionRelayEffect, type InspectionRelayPeer, type InspectionRelayRole, type InspectionRelaySnapshot, type InspectionSentEvent, type InspectionTakenTransition, type Inspector, type InspectorEvents, type InspectorInspectionEvent, type LegacyProjectVisibility, type LegacyUpdateMachineInput, type Machine, type MachineConfigOptions, type MachineVersion, type ManualActorOptions, type OAuthAuthorizationServerMetadata, type OAuthClientRegistrationResponse, type OAuthProtectedResourceMetadata, type OAuthTokenResponse, type PkcePair, type PlanSyncOptions, type Project, type ProjectData, type ProjectEmbedMachine, type ProjectMachine, type ProjectMachineSummary, type ProjectSummary, type ProjectVisibility, type PullSyncResult, type PushLocalMachineLinksResult, type PushSyncOptions, type PushSyncProjectOptions, type PushSyncResult, RawCode, type RepoType, type ResolvedSyncInput, type ResourceErrorCode, type S3UploadTarget, type StateNodeJSONData, type StatelyAction, type StatelyApiClientOptions, StatelyApiError, type StatelyApiUrlOptions, type StatelyAuthMode, type StatelyCredential, type StatelyEdgeData, type StatelyEmbed, type StatelyEmbedOptions, type StatelyGraph, type StatelyGraphData, type StatelyGuard, type StatelyInvoke, type StatelyNodeData, type StatelyPragma, type StatelyPragmaAttachment, type StudioAction, StudioApiError, type StudioApiErrorOptions, type StudioClient, type StudioClientOptions, type StudioEdge, type StudioMachine, type StudioMachineRecord, type StudioNode, type StudioRequestOptions, type SupabaseStorageClient, type SyncInputFormat, type SyncPlan, type SyncPlanSummary, type Transport, type TransportFailure, type UpdateMachineInput, type UpdateProjectInput, type UploadResult, type UpsertStatelyPragmaOptions, type VerifyApiKeyResponse, type VerifyResult, type XStateTSOptions, type XStateVersion, buildAuthorizeUrl, contextSchemaToTSType, createAuthorizationHeader, createInspectionActorId, createInspectionRelay, createInspectionRoomUrls, createInspector, createPkcePair, createPostMessageTransport, createS3AssetUploadAdapter, createStatelyApiClient, createStatelyApiUrl, createStatelyClient, createStatelyEmbed, createStatelyInspector, createSupabaseAssetUploadAdapter, createWebSocketTransport, discoverAuthorizationServer, discoverProtectedResource, eventsSchemaToTSType, exchangeCodeForToken, findStatelyPragmaAttachments, fromStudioMachine, getCredentialToken, getInspectionRoomId, getStatelyPragma, graphToMachineConfig, graphToXStateTS, jsonSchemaToTSType, raw, refreshToken, registerOAuthClient, serializeJS, studioMachineConverter, toStudioMachine, upsertStatelyPragma };
+export { type ActionLocation, type AdoptedActor, type AssetConfig, type AssetUploadAdapter, type AssetUploadContext, type AssetUploadRequest, type CapabilityDeniedCapability, type CapabilityDeniedEvent, type CodeGenGraph, type CommentsConfig, type ConnectedRepo, type CreateInspectionRelayOptions, type CreateInspectorOptions, type CreateMachineFromDefinitionInput, type CreateMachineFromTemplateInput, type CreateMachineInput, type CreateMachineTemplate, type CreateProjectInput, type CreateS3AssetUploadAdapterOptions, type CreateSupabaseAssetUploadAdapterOptions, DEFAULT_STATELY_BASE_URL, type DigraphAction, type DigraphConfig, type DigraphEdgeConfig, type DigraphNodeConfig, EDITOR_PROTOCOL_VERSION, EMBED_DOCUMENT_LANGUAGES, EMBED_DOCUMENT_LIMITS, type EditorCapabilities, type EditorHostExportFormat, type EditorHostInboundMessage, type EditorHostInitOptions, type EditorHostOutboundMessage, EditorHostSession, type EditorHostSessionOptions, type EditorHostValidationIssue, type EditorSourceHost, type EditorSyncBackend, type EmbedDocument, type EmbedDocumentLanguage, type EmbedEventHandler, type EmbedEventMap, type EmbedEventName, type EmbedMode, type EnsureProjectInput, type EventTypeData, type ExportCallOptions, type ExportFormat, type ExportFormatMap, type ExtractMachinesInput, type ExtractMachinesResponse, type ExtractedMachine, type ExtractedMachines, type GetMachineOptions, type GraphPatch, INSPECTION_PROTOCOL_VERSION, INSPECTION_ROOM_QUERY_PARAM, type InitOptions, type InspectedEvent, type InspectedSnapshot, type InspectedTransition, type InspectionAction, type InspectionRelay, type InspectionRelayEffect, type InspectionRelayPeer, type InspectionRelayRole, type InspectionRelaySnapshot, type InspectionSentEvent, type InspectionTakenTransition, type Inspector, type InspectorEvents, type InspectorInspectionEvent, type LegacyProjectVisibility, type LegacyUpdateMachineInput, type Machine, type MachineConfigOptions, type MachineVersion, type ManualActorOptions, type OAuthAuthorizationServerMetadata, type OAuthClientRegistrationResponse, type OAuthProtectedResourceMetadata, type OAuthTokenResponse, type PkcePair, type PlanSyncOptions, type Project, type ProjectData, type ProjectEmbedMachine, type ProjectMachine, type ProjectMachineSummary, type ProjectSummary, type ProjectVisibility, type PullSyncResult, type PushLocalMachineLinksResult, type PushSyncOptions, type PushSyncProjectOptions, type PushSyncResult, RawCode, type RemoteEditorSyncBackendOptions, type RepoType, type ResolvedSyncInput, type ResourceErrorCode, type S3UploadTarget, type StateNodeJSONData, type StatelyAction, type StatelyApiClientOptions, StatelyApiError, type StatelyApiUrlOptions, type StatelyAuthMode, type StatelyCredential, type StatelyEdgeData, type StatelyEmbed, type StatelyEmbedOptions, type StatelyGraph, type StatelyGraphData, type StatelyGuard, type StatelyInvoke, type StatelyNodeData, type StatelyPragma, type StatelyPragmaAttachment, type StudioAction, StudioApiError, type StudioApiErrorOptions, type StudioClient, type StudioClientOptions, type StudioEdge, type StudioMachine, type StudioMachineRecord, type StudioNode, type StudioRequestOptions, type SupabaseStorageClient, type SyncInputFormat, type SyncPlan, type SyncPlanSummary, type Transport, type TransportFailure, type UpdateMachineInput, type UpdateProjectInput, type UploadResult, type UpsertStatelyPragmaOptions, type VerifyApiKeyResponse, type VerifyResult, type XStateTSOptions, type XStateVersion, buildAuthorizeUrl, contextSchemaToTSType, createAuthorizationHeader, createInspectionActorId, createInspectionRelay, createInspectionRoomUrls, createInspector, createPkcePair, createPostMessageTransport, createRemoteEditorSyncBackend, createS3AssetUploadAdapter, createStatelyApiClient, createStatelyApiUrl, createStatelyClient, createStatelyEmbed, createStatelyInspector, createSupabaseAssetUploadAdapter, createWebSocketTransport, discoverAuthorizationServer, discoverProtectedResource, eventsSchemaToTSType, exchangeCodeForToken, fetchEditorSyncAccess, findStatelyPragmaAttachments, fromStudioMachine, getCredentialToken, getInspectionRoomId, getStatelyPragma, graphToMachineConfig, graphToXStateTS, jsonSchemaToTSType, raw, refreshToken, registerOAuthClient, serializeJS, studioMachineConverter, toStudioMachine, upsertStatelyPragma };

package/dist/index.mjs

@@ -1,14 +1,16 @@
 import { EMBED_DOCUMENT_LANGUAGES, EMBED_DOCUMENT_LIMITS, INSPECTION_PROTOCOL_VERSION, INSPECTION_ROOM_QUERY_PARAM, createInspectionActorId, createInspectionRoomUrls, getInspectionRoomId } from "./protocol.mjs";
-import { n as createWebSocketTransport, t as createPostMessageTransport } from "./transport-CyCrdKyz.mjs";
+import { i as createWebSocketTransport, r as createPostMessageTransport } from "./version-YJizbJxR.mjs";
+import { t as EDITOR_PROTOCOL_VERSION } from "./editorHostProtocol-D_h4y3rX.mjs";
 import { createStatelyEmbed } from "./embed.mjs";
+import { n as createRemoteEditorSyncBackend, r as fetchEditorSyncAccess, t as EditorHostSession } from "./editorHostSession-CCTwvUOB.mjs";
+import { n as StudioApiError, r as createStatelyClient, t as DEFAULT_STATELY_BASE_URL } from "./studio-DHGspwII.mjs";
+import { a as RawCode, c as eventsSchemaToTSType, d as jsonSchemaToTSType, l as graphToMachineConfig, m as serializeJS, n as getStatelyPragma, o as contextSchemaToTSType, p as raw, r as upsertStatelyPragma, t as findStatelyPragmaAttachments, u as graphToXStateTS } from "./statelyPragma-CIzsR_Sx.mjs";
 import { createS3AssetUploadAdapter, createSupabaseAssetUploadAdapter } from "./assetStorage.mjs";
-import { n as createStatelyInspector, t as createInspector } from "./inspect-llcqYpZ1.mjs";
-import { n as StudioApiError, r as createStatelyClient, t as DEFAULT_STATELY_BASE_URL } from "./studio-txdyJHD7.mjs";
-import { a as RawCode, c as eventsSchemaToTSType, d as jsonSchemaToTSType, f as raw, l as graphToMachineConfig, n as getStatelyPragma, o as contextSchemaToTSType, p as serializeJS, r as upsertStatelyPragma, t as findStatelyPragmaAttachments, u as graphToXStateTS } from "./statelyPragma-Bm9O4XV6.mjs";
+import { n as createStatelyInspector, t as createInspector } from "./inspect-DWu20a8g.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";
 import { fromStudioMachine, studioMachineConverter, toStudioMachine } from "./graph.mjs";
 import { createInspectionRelay } from "./relay.mjs";
 
-export { DEFAULT_STATELY_BASE_URL, EMBED_DOCUMENT_LANGUAGES, EMBED_DOCUMENT_LIMITS, INSPECTION_PROTOCOL_VERSION, INSPECTION_ROOM_QUERY_PARAM, RawCode, StatelyApiError, StudioApiError, buildAuthorizeUrl, contextSchemaToTSType, createAuthorizationHeader, createInspectionActorId, createInspectionRelay, createInspectionRoomUrls, createInspector, createPkcePair, createPostMessageTransport, createS3AssetUploadAdapter, createStatelyApiClient, createStatelyApiUrl, createStatelyClient, createStatelyEmbed, createStatelyInspector, createSupabaseAssetUploadAdapter, createWebSocketTransport, discoverAuthorizationServer, discoverProtectedResource, eventsSchemaToTSType, exchangeCodeForToken, findStatelyPragmaAttachments, fromStudioMachine, getCredentialToken, getInspectionRoomId, getStatelyPragma, graphToMachineConfig, graphToXStateTS, jsonSchemaToTSType, raw, refreshToken, registerOAuthClient, serializeJS, studioMachineConverter, toStudioMachine, upsertStatelyPragma };
+export { DEFAULT_STATELY_BASE_URL, EDITOR_PROTOCOL_VERSION, EMBED_DOCUMENT_LANGUAGES, EMBED_DOCUMENT_LIMITS, EditorHostSession, INSPECTION_PROTOCOL_VERSION, INSPECTION_ROOM_QUERY_PARAM, RawCode, StatelyApiError, StudioApiError, buildAuthorizeUrl, contextSchemaToTSType, createAuthorizationHeader, createInspectionActorId, createInspectionRelay, createInspectionRoomUrls, createInspector, createPkcePair, createPostMessageTransport, createRemoteEditorSyncBackend, createS3AssetUploadAdapter, createStatelyApiClient, createStatelyApiUrl, createStatelyClient, createStatelyEmbed, createStatelyInspector, createSupabaseAssetUploadAdapter, createWebSocketTransport, discoverAuthorizationServer, discoverProtectedResource, eventsSchemaToTSType, exchangeCodeForToken, fetchEditorSyncAccess, findStatelyPragmaAttachments, fromStudioMachine, getCredentialToken, getInspectionRoomId, getStatelyPragma, graphToMachineConfig, graphToXStateTS, jsonSchemaToTSType, raw, refreshToken, registerOAuthClient, serializeJS, studioMachineConverter, toStudioMachine, upsertStatelyPragma };

package/dist/{inspect-BZFzyeew.d.mts → inspect-CGJR4iZK.d.mts}

@@ -62,7 +62,7 @@ interface InspectorInspectionEvent {
   readonly actorRef: unknown;
 }
 interface AdoptedActor {
-  /** XState process-local `actor.sessionId`. Pair with inspector.producerId. */
+  /** Producer-local session id; defaults to XState's `actor.sessionId`. */
   sessionId: string;
   /** System-local `actor.id`. */
   actorId: string;
@@ -137,7 +137,10 @@ interface CreateInspectorOptions {
   url?: string;
   /** Unguessable inspection room capability. Defaults to a random UUID. */
   roomId?: string;
-  /** Stable identity for this producer connection. Defaults to a random UUID. */
+  /**
+   * Stable identity for this producer across reconnects and restored Inspector
+   * instances. Defaults to a random UUID.
+   */
   producerId?: string;
   /**
    * Inspector UI base URL when hosted separately from the WebSocket relay. The
@@ -172,6 +175,13 @@ interface CreateInspectorOptions {
    * @deprecated Use {@link extractMachine}; it also accepts source strings.
    */
   extractMachineConfig?: (actor: any, source?: unknown) => unknown;
+  /**
+   * Resolve the producer-local identity used for an actor on the inspection
+   * wire. Defaults to XState's runtime `actor.sessionId`. The resolver runs
+   * once per runtime actor and must return a non-empty id that is unique among
+   * all actors observed by this inspector.
+   */
+  resolveSessionId?: (actor: any, defaultSessionId: string) => string;
   /** Selected actor session id to focus on first. */
   selectedSessionId?: string;
   /** @deprecated Use {@link selectedSessionId}. */
@@ -193,7 +203,7 @@ interface CreateInspectorOptions {
   transport?: Transport;
 }
 interface Inspector {
-  /** Snapshot of this producer's actors keyed by XState `sessionId`. */
+  /** Snapshot of this producer's actors keyed by resolved `sessionId`. */
   readonly actors: ReadonlyMap<string, AdoptedActor>;
   /** Unguessable inspection room capability. */
   readonly roomId: string;