@statelyai/sdk 0.5.0 → 0.6.0

package/dist/index.d.mts

@@ -1,117 +1,35 @@
-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-BfezxFKJ.mjs";
-import { a as ProjectMachine, c as StudioClientOptions, i as ProjectData, l as VerifyApiKeyResponse, n as ExtractedMachine, o as StudioApiError, r as GetMachineOptions, s as StudioClient, t as ExtractMachinesResponse, u as createStatelyClient } from "./studio-D2uQhrvX.mjs";
-import { PlanSyncOptions, PullSyncResult, ResolvedSyncInput, SyncInputFormat, SyncPlan, SyncPlanSummary } from "./sync.mjs";
-import { a as EmbedMode, c as ExportFormatMap, f as UploadResult, i as EmbedEventName, l as InitOptions, n as EmbedEventHandler, o as ExportCallOptions, r as EmbedEventMap, s as ExportFormat, t as CommentsConfig } from "./protocol-B1cNV7QB.mjs";
+import { StatelyApiClientOptions, StatelyApiError, StatelyApiUrlOptions, createStatelyApiClient, createStatelyApiUrl } from "./api.mjs";
+import { ConnectedRepo, CreateMachineFromDefinitionInput, CreateMachineFromTemplateInput, CreateMachineInput, CreateMachineTemplate, CreateProjectInput, EnsureProjectInput, ExtractMachinesResponse, ExtractedMachine, GetMachineOptions, ProjectData, ProjectMachine, ProjectVisibility, RepoType, StudioApiError, StudioClient, StudioClientOptions, StudioMachineRecord, VerifyApiKeyResponse, XStateVersion, createStatelyClient } from "./studio.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-CB-ALrdk.mjs";
+import { PlanSyncOptions, PullSyncResult, PushSyncOptions, PushSyncProjectOptions, PushSyncResult, ResolvedSyncInput, SyncInputFormat, SyncPlan, SyncPlanSummary } from "./sync.mjs";
+import { a as EmbedMode, c as ExportFormatMap, f as ProjectEmbedMachine, i as EmbedEventName, l as InitOptions, m as UploadResult, n as EmbedEventHandler, o as ExportCallOptions, r as EmbedEventMap, s as ExportFormat, t as CommentsConfig } from "./protocol-CEbWQPYe.mjs";
 import { AssetConfig, StatelyEmbed, StatelyEmbedOptions, createStatelyEmbed } from "./embed.mjs";
-import { a as ManualActorOptions, c as createPostMessageTransport, i as InspectorEvents, l as createWebSocketTransport, n as CreateInspectorOptions, o as createStatelyInspector, r as Inspector, s as Transport, t as AdoptedActor } from "./inspect-WUC2inmJ.mjs";
+import { a as ManualActorOptions, c as createPostMessageTransport, i as InspectorEvents, l as createWebSocketTransport, n as CreateInspectorOptions, o as createStatelyInspector, r as Inspector, s as Transport, t as AdoptedActor } from "./inspect-DIxB2Tr3.mjs";
 import { ActionLocation, GraphPatch } from "./patchTypes.mjs";
+import { CodeGenGraph, MachineConfigOptions, RawCode, graphToMachineConfig, raw, serializeJS } from "@statelyai/graph-tools";
 import { JSONSchema7 } from "json-schema";
-import { UnknownMachineConfig } from "xstate";
 
-//#region src/codegenTypes.d.ts
-interface CodeGenAction {
-  type: string;
-  params?: Record<string, unknown>;
-}
-interface CodeGenGuard {
-  type: string;
-  code?: string;
-  params?: Record<string, unknown>;
-}
-interface CodeGenInvoke {
-  src: string;
-  id: string;
-  input?: unknown;
-}
-interface CodeGenNodeData {
-  nodeId?: string | null;
-  key: string;
-  type?: 'normal' | 'parallel' | 'final' | 'history' | null;
-  initialId?: string | null;
-  history?: 'shallow' | 'deep' | boolean;
-  entry?: CodeGenAction[];
-  exit?: CodeGenAction[];
-  invokes?: CodeGenInvoke[];
-  tags?: Array<string | {
-    name: string;
-  }>;
-  description?: string | null;
-  meta?: Record<string, unknown> | null;
-  color?: string;
-  parentId?: string | null;
-  temp?: boolean;
-}
-interface CodeGenEdgeData {
-  eventType: string;
-  transitionType?: 'normal' | 'targetless' | 'reenter';
-  guard?: CodeGenGuard | null;
-  actions?: CodeGenAction[];
-  description?: string | null;
-  color?: string;
-  meta?: Record<string, unknown> | null;
-  temp?: boolean;
-}
-interface CodeGenImplementation {
-  id: string;
-  name: string;
-  description?: string | null;
-  icon?: string;
-  paramsSchema?: JSONSchema7 | null;
-  code?: {
-    body: string;
-    lang?: string;
-  } | null;
-}
-interface CodeGenActorImplementation {
-  id: string;
-  name: string;
-  description?: string | null;
-  icon?: string;
-  inputSchema?: JSONSchema7 | null;
-  outputSchema?: JSONSchema7 | null;
-  code?: {
-    body: string;
-    lang?: string;
-  } | null;
-}
-interface CodeGenGraphData {
-  schemas?: {
-    context?: Record<string, JSONSchema7> | null;
-    events?: Record<string, JSONSchema7> | null;
-    input?: JSONSchema7 | null;
-    output?: JSONSchema7 | null;
-  } | null;
-  implementations?: {
-    actions: CodeGenImplementation[];
-    guards: CodeGenImplementation[];
-    actors: CodeGenActorImplementation[];
-    delays: CodeGenImplementation[];
-  } | null;
-}
-interface CodeGenNode {
-  id: string;
-  parentId?: string | null;
-  data: CodeGenNodeData;
-}
-interface CodeGenEdge {
-  id: string;
-  sourceId: string;
-  targetId: string;
-  data: CodeGenEdgeData;
-}
-interface CodeGenGraph {
-  id: string;
-  nodes: CodeGenNode[];
-  edges: CodeGenEdge[];
-  data: CodeGenGraphData;
-}
-//#endregion
-//#region src/graphToMachineConfig.d.ts
-interface MachineConfigOptions {
-  showDescriptions?: boolean;
-  showMeta?: boolean;
-}
-declare function graphToMachineConfig(graph: CodeGenGraph, options?: MachineConfigOptions): UnknownMachineConfig;
+//#region src/statelyPragma.d.ts
+interface StatelyPragma {
+  tag: '@statelyai';
+  id?: string;
+  fields: Record<string, string>;
+  start: number;
+  end: number;
+}
+interface StatelyPragmaAttachment {
+  machineStart: number;
+  attachStart: number;
+  pragma?: StatelyPragma;
+}
+interface UpsertStatelyPragmaOptions {
+  fileName?: string;
+  machineIndex?: number;
+  lineEnding?: '\n' | '\r\n';
+}
+declare function findStatelyPragmaAttachments(sourceText: string, fileName?: string): StatelyPragmaAttachment[];
+declare function getStatelyPragma(sourceText: string, fileName?: string, machineIndex?: number): StatelyPragma | undefined;
+declare function upsertStatelyPragma(sourceText: string, id: string, options?: UpsertStatelyPragmaOptions): string;
 //#endregion
 //#region src/graphToXStateTS.d.ts
 interface XStateTSOptions extends MachineConfigOptions {
@@ -119,21 +37,6 @@ interface XStateTSOptions extends MachineConfigOptions {
 }
 declare function graphToXStateTS(graph: CodeGenGraph, options?: XStateTSOptions): string;
 //#endregion
-//#region src/serializeJS.d.ts
-/**
- * Serializes JavaScript values as JS source code (not JSON).
- * - Unquoted keys for valid identifiers
- * - Single-quoted strings
- * - Omits undefined values
- * - Supports RawCode for verbatim expressions
- */
-declare class RawCode {
-  code: string;
-  constructor(code: string);
-}
-declare function raw(code: string): RawCode;
-declare function serializeJS(value: unknown, indent?: number, step?: number): string;
-//#endregion
 //#region src/jsonSchemaToTSType.d.ts
 declare function jsonSchemaToTSType(schema: JSONSchema7 | undefined | null): string;
 /**
@@ -147,4 +50,4 @@ declare function contextSchemaToTSType(context: Record<string, JSONSchema7> | nu
  */
 declare function eventsSchemaToTSType(events: Record<string, JSONSchema7> | null | undefined): string | null;
 //#endregion
-export { type ActionLocation, type AdoptedActor, type AssetConfig, type CodeGenGraph, type CommentsConfig, type CreateInspectorOptions, type DigraphAction, type DigraphConfig, type DigraphEdgeConfig, type DigraphNodeConfig, type EmbedEventHandler, type EmbedEventMap, type EmbedEventName, type EmbedMode, type EventTypeData, type ExportCallOptions, type ExportFormat, type ExportFormatMap, type ExtractMachinesResponse, type ExtractedMachine, type GetMachineOptions, type GraphPatch, type InitOptions, type Inspector, type InspectorEvents, type MachineConfigOptions, type ManualActorOptions, type PlanSyncOptions, type ProjectData, type ProjectMachine, type PullSyncResult, RawCode, type ResolvedSyncInput, type StateNodeJSONData, type StatelyAction, type StatelyEdgeData, type StatelyEmbed, type StatelyEmbedOptions, type StatelyGraph, type StatelyGraphData, type StatelyGuard, type StatelyInvoke, type StatelyNodeData, type StudioAction, StudioApiError, type StudioClient, type StudioClientOptions, type StudioEdge, type StudioMachine, type StudioNode, type SyncInputFormat, type SyncPlan, type SyncPlanSummary, type Transport, type UploadResult, type VerifyApiKeyResponse, type XStateTSOptions, contextSchemaToTSType, createPostMessageTransport, createStatelyClient, createStatelyEmbed, createStatelyInspector, createWebSocketTransport, eventsSchemaToTSType, fromStudioMachine, graphToMachineConfig, graphToXStateTS, jsonSchemaToTSType, raw, serializeJS, studioMachineConverter, toStudioMachine };
+export { type ActionLocation, type AdoptedActor, type AssetConfig, type CodeGenGraph, type CommentsConfig, type ConnectedRepo, type CreateInspectorOptions, type CreateMachineFromDefinitionInput, type CreateMachineFromTemplateInput, type CreateMachineInput, type CreateMachineTemplate, type CreateProjectInput, type DigraphAction, type DigraphConfig, type DigraphEdgeConfig, type DigraphNodeConfig, type EmbedEventHandler, type EmbedEventMap, type EmbedEventName, type EmbedMode, type EnsureProjectInput, type EventTypeData, type ExportCallOptions, type ExportFormat, type ExportFormatMap, type ExtractMachinesResponse, type ExtractedMachine, type GetMachineOptions, type GraphPatch, type InitOptions, type Inspector, type InspectorEvents, type MachineConfigOptions, type ManualActorOptions, type PlanSyncOptions, type ProjectData, type ProjectEmbedMachine, type ProjectMachine, type ProjectVisibility, type PullSyncResult, type PushSyncOptions, type PushSyncProjectOptions, type PushSyncResult, RawCode, type RepoType, type ResolvedSyncInput, type StateNodeJSONData, type StatelyAction, type StatelyApiClientOptions, StatelyApiError, type StatelyApiUrlOptions, type StatelyEdgeData, type StatelyEmbed, type StatelyEmbedOptions, type StatelyGraph, type StatelyGraphData, type StatelyGuard, type StatelyInvoke, type StatelyNodeData, type StatelyPragma, type StatelyPragmaAttachment, type StudioAction, StudioApiError, type StudioClient, type StudioClientOptions, type StudioEdge, type StudioMachine, type StudioMachineRecord, type StudioNode, type SyncInputFormat, type SyncPlan, type SyncPlanSummary, type Transport, type UploadResult, type UpsertStatelyPragmaOptions, type VerifyApiKeyResponse, type XStateTSOptions, type XStateVersion, contextSchemaToTSType, createPostMessageTransport, createStatelyApiClient, createStatelyApiUrl, createStatelyClient, createStatelyEmbed, createStatelyInspector, createWebSocketTransport, eventsSchemaToTSType, findStatelyPragmaAttachments, fromStudioMachine, getStatelyPragma, graphToMachineConfig, graphToXStateTS, jsonSchemaToTSType, raw, serializeJS, studioMachineConverter, toStudioMachine, upsertStatelyPragma };

package/dist/index.mjs

@@ -1,8 +1,9 @@
-import { n as createWebSocketTransport, t as createPostMessageTransport } from "./transport-lomH7b0v.mjs";
+import { n as createWebSocketTransport, t as createPostMessageTransport } from "./transport-C0eTgNNu.mjs";
 import { createStatelyEmbed } from "./embed.mjs";
 import { createStatelyInspector } from "./inspect.mjs";
 import { StudioApiError, createStatelyClient } from "./studio.mjs";
+import { StatelyApiError, createStatelyApiClient, createStatelyApiUrl } from "./api.mjs";
+import { a as RawCode, c as graphToMachineConfig, d as upsertStatelyPragma, i as jsonSchemaToTSType, l as findStatelyPragmaAttachments, n as contextSchemaToTSType, o as raw, r as eventsSchemaToTSType, s as serializeJS, t as graphToXStateTS, u as getStatelyPragma } from "./graphToXStateTS-CvXM8wHL.mjs";
 import { fromStudioMachine, studioMachineConverter, toStudioMachine } from "./graph.mjs";
-import { a as graphToMachineConfig, c as serializeJS, i as jsonSchemaToTSType, n as contextSchemaToTSType, o as RawCode, r as eventsSchemaToTSType, s as raw, t as graphToXStateTS } from "./graphToXStateTS-BSUj97r0.mjs";
 
-export { RawCode, StudioApiError, contextSchemaToTSType, createPostMessageTransport, createStatelyClient, createStatelyEmbed, createStatelyInspector, createWebSocketTransport, eventsSchemaToTSType, fromStudioMachine, graphToMachineConfig, graphToXStateTS, jsonSchemaToTSType, raw, serializeJS, studioMachineConverter, toStudioMachine };
+export { RawCode, StatelyApiError, StudioApiError, contextSchemaToTSType, createPostMessageTransport, createStatelyApiClient, createStatelyApiUrl, createStatelyClient, createStatelyEmbed, createStatelyInspector, createWebSocketTransport, eventsSchemaToTSType, findStatelyPragmaAttachments, fromStudioMachine, getStatelyPragma, graphToMachineConfig, graphToXStateTS, jsonSchemaToTSType, raw, serializeJS, studioMachineConverter, toStudioMachine, upsertStatelyPragma };

package/dist/{inspect-WUC2inmJ.d.mts → inspect-DIxB2Tr3.d.mts}

@@ -1,4 +1,4 @@
-import { c as ExportFormatMap, d as ProtocolMessage, o as ExportCallOptions, r as EmbedEventMap, s as ExportFormat } from "./protocol-B1cNV7QB.mjs";
+import { c as ExportFormatMap, o as ExportCallOptions, p as ProtocolMessage, r as EmbedEventMap, s as ExportFormat } from "./protocol-CEbWQPYe.mjs";
 
 //#region src/transport.d.ts
 interface Transport {

package/dist/inspect.d.mts

@@ -1,3 +1,3 @@
-import { a as EmbedMode, c as ExportFormatMap, i as EmbedEventName, n as EmbedEventHandler, o as ExportCallOptions, r as EmbedEventMap, s as ExportFormat } from "./protocol-B1cNV7QB.mjs";
-import { a as ManualActorOptions, i as InspectorEvents, n as CreateInspectorOptions, o as createStatelyInspector, r as Inspector, s as Transport, t as AdoptedActor } from "./inspect-WUC2inmJ.mjs";
+import { a as EmbedMode, c as ExportFormatMap, i as EmbedEventName, n as EmbedEventHandler, o as ExportCallOptions, r as EmbedEventMap, s as ExportFormat } from "./protocol-CEbWQPYe.mjs";
+import { a as ManualActorOptions, i as InspectorEvents, n as CreateInspectorOptions, o as createStatelyInspector, r as Inspector, s as Transport, t as AdoptedActor } from "./inspect-DIxB2Tr3.mjs";
 export { AdoptedActor, CreateInspectorOptions, EmbedEventHandler, EmbedEventMap, EmbedEventName, EmbedMode, ExportCallOptions, ExportFormat, ExportFormatMap, Inspector, InspectorEvents, ManualActorOptions, Transport, createStatelyInspector };

package/dist/inspect.mjs

@@ -1,4 +1,4 @@
-import { i as createPendingExportManager, n as createWebSocketTransport, r as createEventRegistry } from "./transport-lomH7b0v.mjs";
+import { i as createPendingExportManager, n as createWebSocketTransport, r as createEventRegistry } from "./transport-C0eTgNNu.mjs";
 
 //#region src/inspect.ts
 const defaultSerializeSnapshot = (snapshot) => ({

package/dist/patchTypes.d.mts

@@ -8,6 +8,7 @@ type ActionLocation = {
   edgeId: string;
   group: 'transition';
 };
+type ImplementationSourceType = 'action' | 'guard' | 'actor' | 'delay';
 type GraphPatch = {
   op: 'createNode';
   description?: string;
@@ -163,6 +164,29 @@ type GraphPatch = {
   description?: string;
   nodeId: string;
   invokeId: string;
+} | {
+  op: 'createImplementation';
+  description?: string;
+  sourceType: ImplementationSourceType;
+  implementation: {
+    id: string;
+    name?: string;
+    code?: string;
+  };
+} | {
+  op: 'updateImplementation';
+  description?: string;
+  sourceType: ImplementationSourceType;
+  implementationId: string;
+  data: {
+    name?: string;
+    code?: string;
+  };
+} | {
+  op: 'deleteImplementation';
+  description?: string;
+  sourceType: ImplementationSourceType;
+  implementationId: string;
 } | {
   op: 'setGuard';
   description?: string;
@@ -222,4 +246,4 @@ type GraphPatch = {
   };
 };
 //#endregion
-export { ActionLocation, CanvasColor, EditorStateType, GraphPatch };
+export { ActionLocation, CanvasColor, EditorStateType, GraphPatch, ImplementationSourceType };

package/dist/{protocol-B1cNV7QB.d.mts → protocol-CEbWQPYe.d.mts}

@@ -7,6 +7,11 @@ interface CommentsConfig {
   authEndpoint?: string;
   baseUrl?: string;
 }
+interface ProjectEmbedMachine {
+  id: string;
+  name?: string;
+  machine: unknown;
+}
 interface ValidationIssue {
   nodeIds: string[];
   edgeIds: string[];
@@ -62,6 +67,10 @@ interface ExportFormatMap {
     };
     result: Record<string, unknown>;
   };
+  xgraph: {
+    options: object;
+    result: Record<string, unknown>;
+  };
   digraph: {
     options: object;
     result: Record<string, unknown>;
@@ -70,7 +79,7 @@ interface ExportFormatMap {
     options: object;
     result: string;
   };
-  rtk: {
+  redux: {
     options: object;
     result: string;
   };
@@ -101,17 +110,20 @@ interface EmbedEventMap {
   };
   loaded: {
     graph: unknown;
+    machineId?: string;
     sourceLocations?: MachineSourceLocations;
   };
   change: {
     graph: unknown;
     machineConfig: unknown;
+    machineId?: string;
     patches?: unknown[];
     sourceLocations?: MachineSourceLocations;
   };
   save: {
     graph: unknown;
     machineConfig: unknown;
+    machineId?: string;
     patches?: unknown[];
     validations?: ValidationIssue[];
     sourceLocations?: MachineSourceLocations;
@@ -124,10 +136,13 @@ interface EmbedEventMap {
     snapshot: unknown;
     event: unknown | null;
   };
+  machineSelected: {
+    machineId: string;
+  };
 }
 type EmbedEventName = keyof EmbedEventMap;
 type EmbedEventHandler<K extends EmbedEventName> = (data: EmbedEventMap[K]) => void;
-interface InitOptions {
+interface MachineInitOptions {
   machine: unknown;
   format?: string;
   mode?: EmbedMode;
@@ -158,6 +173,25 @@ interface InitOptions {
     mode?: 'structural' | 'all';
   };
 }
+interface ProjectInitOptions {
+  machines: ProjectEmbedMachine[];
+  currentMachineId?: string;
+  mode?: EmbedMode;
+  theme?: 'light' | 'dark';
+  readOnly?: boolean;
+  depth?: number;
+  panels?: {
+    leftPanels?: string[];
+    rightPanels?: string[];
+    activePanels?: string[];
+  };
+  commentsByMachineId?: Record<string, CommentsConfig>;
+  unsavedIndicator?: {
+    enabled?: boolean;
+    mode?: 'structural' | 'all';
+  };
+}
+type InitOptions = MachineInitOptions | ProjectInitOptions;
 interface InitMessage {
   type: '@statelyai.init';
   machine: unknown;
@@ -179,6 +213,34 @@ interface InitMessage {
   /** Optional session id override (multiplexed clients only). */
   sessionId?: string;
 }
+interface ProjectInitMessage {
+  type: '@statelyai.project.init';
+  machines: ProjectEmbedMachine[];
+  currentMachineId?: string;
+  mode?: EmbedMode;
+  theme?: 'light' | 'dark';
+  readOnly?: boolean;
+  depth?: number;
+  leftPanels?: string[];
+  rightPanels?: string[];
+  activePanels?: string[];
+  commentsByMachineId?: Record<string, CommentsConfig>;
+  unsavedIndicator?: {
+    enabled?: boolean;
+    mode?: 'structural' | 'all';
+  };
+  sessionId?: string;
+}
+interface ProjectUpdateMessage {
+  type: '@statelyai.project.update';
+  machines: ProjectEmbedMachine[];
+  currentMachineId?: string;
+  commentsByMachineId?: Record<string, CommentsConfig>;
+}
+interface ProjectSelectMachineMessage {
+  type: '@statelyai.project.selectMachine';
+  machineId: string;
+}
 interface UpdateMessage {
   type: '@statelyai.update';
   machine: unknown;
@@ -276,12 +338,14 @@ interface ReadyMessage {
 interface LoadedMessage {
   type: '@statelyai.loaded';
   graph: unknown;
+  machineId?: string;
   sourceLocations?: MachineSourceLocations;
 }
 interface ChangeMessage {
   type: '@statelyai.change';
   graph: unknown;
   machineConfig: unknown;
+  machineId?: string;
   patches?: unknown[];
   sourceLocations?: MachineSourceLocations;
 }
@@ -289,10 +353,15 @@ interface SaveMessage {
   type: '@statelyai.save';
   graph: unknown;
   machineConfig: unknown;
+  machineId?: string;
   patches?: unknown[];
   validations?: ValidationIssue[];
   sourceLocations?: MachineSourceLocations;
 }
+interface ProjectMachineSelectedMessage {
+  type: '@statelyai.project.machineSelected';
+  machineId: string;
+}
 interface RetrievedMessage {
   type: '@statelyai.retrieved';
   requestId: string;
@@ -345,9 +414,9 @@ interface UploadResponseMessage {
   result: UploadResult;
 }
 /** All messages a client (embed/inspector) can send to the viz. */
-type ClientMessage = InitMessage | UpdateMessage | SetModeMessage | SetThemeMessage | SetSettingsMessage | RetrieveMessage | ToastMessage | InspectSnapshotMessage | SystemInitMessage | SystemActorRegisteredMessage | SystemActorSnapshotMessage | SystemActorStoppedMessage | UploadCapabilitiesMessage | UploadResponseMessage | ErrorMessage;
+type ClientMessage = InitMessage | ProjectInitMessage | ProjectUpdateMessage | ProjectSelectMachineMessage | UpdateMessage | SetModeMessage | SetThemeMessage | SetSettingsMessage | RetrieveMessage | ToastMessage | InspectSnapshotMessage | SystemInitMessage | SystemActorRegisteredMessage | SystemActorSnapshotMessage | SystemActorStoppedMessage | UploadCapabilitiesMessage | UploadResponseMessage | ErrorMessage;
 /** All messages the viz can send back to a client. */
-type VizMessage = ReadyMessage | LoadedMessage | ChangeMessage | SaveMessage | RetrievedMessage | ErrorMessage | UploadRequestMessage;
+type VizMessage = ReadyMessage | LoadedMessage | ChangeMessage | SaveMessage | ProjectMachineSelectedMessage | RetrievedMessage | ErrorMessage | UploadRequestMessage;
 interface RegisterMessage {
   type: '@statelyai.register';
   role: 'client' | 'viz';
@@ -394,4 +463,4 @@ type SessionMessage = RegisterMessage | RegisteredMessage | RequestOpenMessage |
 /** Any valid protocol message. */
 type ProtocolMessage = ClientMessage | VizMessage | SessionMessage;
 //#endregion
-export { EmbedMode as a, ExportFormatMap as c, ProtocolMessage as d, UploadResult as f, EmbedEventName as i, InitOptions as l, EmbedEventHandler as n, ExportCallOptions as o, EmbedEventMap as r, ExportFormat as s, CommentsConfig as t, MachineSourceLocations as u };
+export { EmbedMode as a, ExportFormatMap as c, MachineSourceLocations as d, ProjectEmbedMachine as f, EmbedEventName as i, InitOptions as l, UploadResult as m, EmbedEventHandler as n, ExportCallOptions as o, ProtocolMessage as p, EmbedEventMap as r, ExportFormat as s, CommentsConfig as t, MachineInitOptions as u };

package/dist/studio.d.mts

@@ -1,2 +1,112 @@
-import { a as ProjectMachine, c as StudioClientOptions, i as ProjectData, l as VerifyApiKeyResponse, n as ExtractedMachine, o as StudioApiError, r as GetMachineOptions, s as StudioClient, t as ExtractMachinesResponse, u as createStatelyClient } from "./studio-D2uQhrvX.mjs";
-export { ExtractMachinesResponse, ExtractedMachine, GetMachineOptions, ProjectData, ProjectMachine, StudioApiError, StudioClient, StudioClientOptions, VerifyApiKeyResponse, createStatelyClient };
+//#region src/studio.d.ts
+interface StudioClientOptions {
+  baseUrl?: string;
+  apiKey?: string;
+  fetch?: typeof fetch;
+}
+interface VerifyApiKeyResponse {
+  valid: boolean;
+}
+type ProjectVisibility = 'Public' | 'Private' | 'Unlisted';
+type RepoType = 'GITHUB';
+interface ConnectedRepo {
+  id?: string;
+  type?: RepoType;
+  url: string;
+  owner: string;
+  repo: string;
+  branch: string;
+  treeSha: string;
+  autoSync?: boolean;
+  pathForNewFiles?: string;
+  selectedPaths?: string[];
+  lastSyncedAt?: string;
+}
+interface ProjectMachine {
+  machineId: string;
+  name: string;
+}
+interface ProjectData {
+  projectId: string;
+  machines: ProjectMachine[];
+  id?: string;
+  name?: string;
+  description?: string | null;
+  keywords?: string[];
+  visibility?: ProjectVisibility;
+  projectVersionId?: string;
+  connectedRepo?: ConnectedRepo | null;
+}
+interface ExtractedMachine {
+  id?: string;
+  config: Record<string, unknown>;
+  setupConfig?: Record<string, unknown>;
+  implementations?: Record<string, unknown>;
+  _type: 'setup.createMachine' | 'createMachine';
+}
+interface ExtractMachinesResponse {
+  machines: ExtractedMachine[];
+  error?: string;
+}
+interface GetMachineOptions {
+  version?: string;
+}
+interface CreateProjectInput {
+  name: string;
+  visibility: ProjectVisibility;
+  description?: string;
+  keywords?: string[];
+  repo?: ConnectedRepo;
+}
+interface EnsureProjectInput extends CreateProjectInput {
+  matchConnectedRepo?: boolean;
+}
+type XStateVersion = 4 | 5;
+type CreateMachineTemplate = 'blank' | 'starter';
+interface CreateMachineFromDefinitionInput<TDefinition = Record<string, unknown>> {
+  projectVersionId: string;
+  definition: TDefinition;
+  xstateVersion?: XStateVersion;
+}
+interface CreateMachineFromTemplateInput {
+  projectVersionId: string;
+  name: string;
+  template: CreateMachineTemplate;
+  xstateVersion?: XStateVersion;
+}
+type CreateMachineInput<TDefinition = Record<string, unknown>> = CreateMachineFromDefinitionInput<TDefinition> | CreateMachineFromTemplateInput;
+interface StudioMachineRecord<TDefinition = Record<string, unknown>> {
+  id: string;
+  name: string;
+  definition: TDefinition;
+  projectVersionId?: string;
+  [key: string]: unknown;
+}
+declare class StudioApiError extends Error {
+  readonly status: number;
+  constructor(message: string, status: number);
+}
+interface StudioClient {
+  auth: {
+    verify(apiKey?: string): Promise<VerifyApiKeyResponse>;
+  };
+  projects: {
+    list(): Promise<ProjectData[]>;
+    create(input: CreateProjectInput): Promise<ProjectData>;
+    ensure(input: EnsureProjectInput): Promise<ProjectData>;
+    get(projectId: string): Promise<ProjectData>;
+  };
+  machines: {
+    create<TMachine = Record<string, unknown>>(input: CreateMachineInput<TMachine>): Promise<StudioMachineRecord<TMachine>>;
+    createMany<TMachine = Record<string, unknown>>(input: CreateMachineInput<TMachine>): Promise<Array<StudioMachineRecord<TMachine>>>;
+    get<TMachine = Record<string, unknown>>(machineId: string, options?: GetMachineOptions): Promise<TMachine>;
+  };
+  code: {
+    extractMachines(code: string, options?: {
+      apiKey?: string | null;
+    }): Promise<ExtractMachinesResponse>;
+  };
+}
+declare function createStatelyClient(options?: StudioClientOptions): StudioClient;
+//#endregion
+export { ConnectedRepo, CreateMachineFromDefinitionInput, CreateMachineFromTemplateInput, CreateMachineInput, CreateMachineTemplate, CreateProjectInput, EnsureProjectInput, ExtractMachinesResponse, ExtractedMachine, GetMachineOptions, ProjectData, ProjectMachine, ProjectVisibility, RepoType, StudioApiError, StudioClient, StudioClientOptions, StudioMachineRecord, VerifyApiKeyResponse, XStateVersion, createStatelyClient };

package/dist/studio.mjs

@@ -19,6 +19,37 @@ async function parseJson(response) {
 	if (!response.headers.get("content-type")?.includes("application/json")) return null;
 	return response.json().catch(() => null);
 }
+function getErrorMessage(data, status) {
+	if (typeof data === "object" && data !== null) {
+		if ("error" in data && typeof data.error === "string") return data.error;
+		if ("error" in data) {
+			const error = data.error;
+			if (typeof error === "object" && error !== null && "json" in error) {
+				const errorJson = error.json;
+				if (typeof errorJson === "object" && errorJson !== null && "message" in errorJson && typeof errorJson.message === "string") return errorJson.message;
+			}
+		}
+	}
+	if (Array.isArray(data)) for (const item of data) {
+		const message = getErrorMessage(item, status);
+		if (message !== `HTTP ${status}`) return message;
+	}
+	return `HTTP ${status}`;
+}
+function unwrapResponseData(data) {
+	if (typeof data === "object" && data !== null && "data" in data) return data.data;
+	return data;
+}
+function normalizeRepoUrl(url) {
+	if (!url) return;
+	return url.replace(/\.git$/i, "").replace(/\/+$/, "");
+}
+function connectedReposMatch(left, right) {
+	if (!left || !right) return false;
+	const normalizedLeft = normalizeRepoUrl(left.url);
+	const normalizedRight = normalizeRepoUrl(right.url);
+	return normalizedLeft != null && normalizedRight != null && normalizedLeft === normalizedRight && left.branch === right.branch || left.owner === right.owner && left.repo === right.repo && left.branch === right.branch;
+}
 function createStatelyClient(options = {}) {
 	const baseUrl = options.baseUrl ?? "https://stately.ai";
 	const fetchImpl = getFetch(options.fetch);
@@ -31,22 +62,53 @@ function createStatelyClient(options = {}) {
 			headers
 		});
 		const data = await parseJson(response);
-		if (!response.ok) throw new StudioApiError(typeof data === "object" && data !== null && "error" in data && typeof data.error === "string" ? data.error : `HTTP ${response.status}`, response.status);
-		return data;
+		if (!response.ok) throw new StudioApiError(getErrorMessage(data, response.status), response.status);
+		return unwrapResponseData(data);
 	}
 	return {
 		auth: { verify(apiKey) {
 			return request("/verify", { method: "GET" }, apiKey);
 		} },
-		projects: { get(projectId) {
-			return request(`/projects/${encodeURIComponent(projectId)}`, { method: "GET" });
-		} },
-		machines: { get(machineId, getOptions = {}) {
-			const search = new URLSearchParams();
-			if (getOptions.version) search.set("version", getOptions.version);
-			const suffix = search.size > 0 ? `?${search.toString()}` : "";
-			return request(`/machines/${encodeURIComponent(machineId)}${suffix}`, { method: "GET" });
-		} },
+		projects: {
+			list() {
+				return request("/projects", { method: "GET" });
+			},
+			create(input) {
+				return request("/projects/create", {
+					method: "POST",
+					headers: { "Content-Type": "application/json" },
+					body: JSON.stringify(input)
+				});
+			},
+			async ensure(input) {
+				if (input.repo && input.matchConnectedRepo !== false) {
+					const existingProject = (await this.list()).find((project) => connectedReposMatch(project.connectedRepo, input.repo));
+					if (existingProject) return existingProject;
+				}
+				return this.create(input);
+			},
+			get(projectId) {
+				return request(`/projects/${encodeURIComponent(projectId)}`, { method: "GET" });
+			}
+		},
+		machines: {
+			async create(input) {
+				return request("/machines/create", {
+					method: "POST",
+					headers: { "Content-Type": "application/json" },
+					body: JSON.stringify(input)
+				});
+			},
+			async createMany(input) {
+				return [await this.create(input)];
+			},
+			get(machineId, getOptions = {}) {
+				const search = new URLSearchParams();
+				if (getOptions.version) search.set("version", getOptions.version);
+				const suffix = search.size > 0 ? `?${search.toString()}` : "";
+				return request(`/machines/${encodeURIComponent(machineId)}${suffix}`, { method: "GET" });
+			}
+		},
 		code: { extractMachines(code, extractOptions = {}) {
 			const apiKey = extractOptions.apiKey ?? options.apiKey ?? "anonymous";
 			return request("/code", {