@statelyai/sdk 0.32.0 → 0.34.0

package/dist/{studio-rSI54Ese.mjs → studio-BZP6DaIO.mjs}

@@ -145,15 +145,11 @@ const entitlementsResultSchema = object({
 	}).nullable(),
 	entitlements: array(string())
 });
-const projectSummarySchema = object({
-	projectId: string(),
-	projectVersionId: string(),
-	name: string(),
-	description: string().nullable(),
-	visibility: projectVisibilitySchema,
-	createdAt: string(),
-	updatedAt: string()
-});
+/**
+* Which editor format a machine's stored definition is in: `digraph` is the
+* original (legacy) editor's format, `xgraph` the current one.
+*/
+const machineDefinitionFormatSchema = _enum(["digraph", "xgraph"]);
 /**
 * `name` and `updatedAt` are optional: some upstream project envelopes only
 * return machine ids. Providers that can supply them cheaply should.
@@ -161,13 +157,31 @@ const projectSummarySchema = object({
 const projectMachineSummarySchema = object({
 	machineId: string(),
 	name: string().optional(),
-	updatedAt: string().optional()
+	updatedAt: string().optional(),
+	format: machineDefinitionFormatSchema.optional()
+});
+/**
+* A project list row. It carries the project's machine roster, not just its
+* metadata, so a client can mount a whole workspace from one `projects.list`
+* response and fetch definitions lazily.
+*/
+const projectSummarySchema = object({
+	projectId: string(),
+	projectVersionId: string(),
+	name: string(),
+	description: string().nullable(),
+	visibility: projectVisibilitySchema,
+	createdAt: string(),
+	updatedAt: string(),
+	rootMachineId: string().nullable().optional(),
+	machines: array(projectMachineSummarySchema).optional(),
+	permissions: object({ canEdit: boolean() }).optional(),
+	allowedVisibility: array(projectVisibilitySchema).optional()
 });
 const projectSchema = projectSummarySchema.extend({
 	rootMachineId: string().nullable(),
 	machines: array(projectMachineSummarySchema),
-	permissions: object({ canEdit: boolean() }),
-	allowedVisibility: array(projectVisibilitySchema).optional()
+	permissions: object({ canEdit: boolean() })
 });
 const machineSchema = object({
 	machineId: string(),
@@ -177,7 +191,8 @@ const machineSchema = object({
 	definition: unknown(),
 	graph: xgraphSchema.optional(),
 	createdAt: string().optional(),
-	updatedAt: string().optional()
+	updatedAt: string().optional(),
+	format: machineDefinitionFormatSchema.optional()
 });
 const machineVersionSchema = object({
 	machineVersionId: string(),
@@ -186,7 +201,8 @@ const machineVersionSchema = object({
 	name: string(),
 	definition: unknown(),
 	createdAt: string(),
-	updatedAt: string()
+	updatedAt: string(),
+	format: machineDefinitionFormatSchema.optional()
 });
 /** Version-history row without the definition payload. */
 const machineVersionSummarySchema = object({
@@ -197,7 +213,8 @@ const machineVersionSummarySchema = object({
 	status: string(),
 	parentVersionId: string().nullable(),
 	createdAt: string(),
-	updatedAt: string()
+	updatedAt: string(),
+	format: machineDefinitionFormatSchema.optional()
 });
 /** Result of converting a machine's stored definition to XGraph in place. */
 const machinesConvertResultSchema = object({
@@ -249,6 +266,18 @@ const machinesRestoreLegacyResultSchema = object({
 		name: string().nullable()
 	})
 });
+/**
+* Result of restoring a machine to one of its own versions.
+*
+* `capturedVersion` is the new version holding the machine's *pre-restore*
+* definition, so the restore itself is undoable. It is `null` when the restore
+* was a no-op (the machine already held that version's definition), which is
+* the signal that no history row was added.
+*/
+const machinesRestoreVersionResultSchema = object({
+	machine: machineSchema,
+	capturedVersion: machineVersionSummarySchema.nullable()
+});
 const extractedMachinesSchema = object({ machines: array(object({
 	config: record(string(), unknown()),
 	machineIndex: number().int().nonnegative().optional()
@@ -306,6 +335,7 @@ const machinesRestoreLegacyRequestSchema = object({
 	expectedUpdatedAt: string().min(1),
 	reason: string().optional()
 });
+const machinesRestoreVersionRequestSchema = object({ expectedUpdatedAt: string().min(1).optional() });
 const codeExtractMachinesRequestSchema = object({
 	code: string().min(1),
 	xstateVersion: xstateVersionSchema.optional()
@@ -328,6 +358,7 @@ const machinesConvertDefinitionResponseSchema = machinesConvertResultSchema;
 const machinesForkResponseSchema = machinesForkResultSchema;
 const machinesGetLegacyVersionResponseSchema = machineLegacyVersionSchema;
 const machinesRestoreLegacyResponseSchema = machinesRestoreLegacyResultSchema;
+const machinesRestoreVersionResponseSchema = machinesRestoreVersionResultSchema;
 const codeExtractMachinesResponseSchema = extractedMachinesSchema;
 /**
 * Request/response schema pairs keyed by resource capability name. Kept here
@@ -376,6 +407,10 @@ const resourceOperationSchemas = {
 	"machines.restoreLegacy": {
 		request: machinesRestoreLegacyRequestSchema,
 		response: machinesRestoreLegacyResponseSchema
+	},
+	"machines.restoreVersion": {
+		request: machinesRestoreVersionRequestSchema,
+		response: machinesRestoreVersionResponseSchema
 	}
 };
 /** Provider-independent operations implemented by this repository. */

package/dist/{studio-DV5IIGhV.d.mts → studio-CKdEPGKY.d.mts}

@@ -1,5 +1,5 @@
-import { A as ZodObject, D as ZodLiteral, E as ZodEnum, F as ZodUnknown, I as output, L as $loose, M as ZodRecord, N as ZodString, O as ZodNullable, P as ZodUnion, R as $strip, T as ZodBoolean, j as ZodOptional, k as ZodNumber, w as ZodArray } from "./index-DlOZxzrW.mjs";
-import { n as StatelyCredential, t as StatelyAuthMode } from "./auth-Dg7prjeL.mjs";
+import { A as ZodObject, D as ZodLiteral, E as ZodEnum, F as ZodUnknown, I as output, L as $loose, M as ZodRecord, N as ZodString, O as ZodNullable, P as ZodUnion, R as $strip, T as ZodBoolean, j as ZodOptional, k as ZodNumber, w as ZodArray } from "./index-DZivqh0u.mjs";
+import { n as StatelyCredential, t as StatelyAuthMode } from "./auth-CVFc85uF.mjs";
 
 //#region ../api-contract/dist/errors.d.mts
 /**
@@ -55,6 +55,25 @@ type VerifyResult = output<typeof verifyResultSchema>;
  * `entitlements` is an open set of provider-defined strings; unknown values are
  * ignored rather than rejected.
  */
+/**
+ * `name` and `updatedAt` are optional: some upstream project envelopes only
+ * return machine ids. Providers that can supply them cheaply should.
+ */
+declare const projectMachineSummarySchema: ZodObject<{
+  machineId: ZodString;
+  name: ZodOptional<ZodString>;
+  updatedAt: ZodOptional<ZodString>;
+  format: ZodOptional<ZodEnum<{
+    digraph: "digraph";
+    xgraph: "xgraph";
+  }>>;
+}, $strip>;
+type ProjectMachineSummary = output<typeof projectMachineSummarySchema>;
+/**
+ * A project list row. It carries the project's machine roster, not just its
+ * metadata, so a client can mount a whole workspace from one `projects.list`
+ * response and fetch definitions lazily.
+ */
 declare const projectSummarySchema: ZodObject<{
   projectId: ZodString;
   projectVersionId: ZodString;
@@ -67,18 +86,26 @@ declare const projectSummarySchema: ZodObject<{
   }>;
   createdAt: ZodString;
   updatedAt: ZodString;
+  rootMachineId: ZodOptional<ZodNullable<ZodString>>;
+  machines: ZodOptional<ZodArray<ZodObject<{
+    machineId: ZodString;
+    name: ZodOptional<ZodString>;
+    updatedAt: ZodOptional<ZodString>;
+    format: ZodOptional<ZodEnum<{
+      digraph: "digraph";
+      xgraph: "xgraph";
+    }>>;
+  }, $strip>>>;
+  permissions: ZodOptional<ZodObject<{
+    canEdit: ZodBoolean;
+  }, $strip>>;
+  allowedVisibility: ZodOptional<ZodArray<ZodEnum<{
+    public: "public";
+    unlisted: "unlisted";
+    private: "private";
+  }>>>;
 }, $strip>;
 type ProjectSummary = output<typeof projectSummarySchema>;
-/**
- * `name` and `updatedAt` are optional: some upstream project envelopes only
- * return machine ids. Providers that can supply them cheaply should.
- */
-declare const projectMachineSummarySchema: ZodObject<{
-  machineId: ZodString;
-  name: ZodOptional<ZodString>;
-  updatedAt: ZodOptional<ZodString>;
-}, $strip>;
-type ProjectMachineSummary = output<typeof projectMachineSummarySchema>;
 declare const projectSchema: ZodObject<{
   projectId: ZodString;
   projectVersionId: ZodString;
@@ -91,20 +118,24 @@ declare const projectSchema: ZodObject<{
   }>;
   createdAt: ZodString;
   updatedAt: ZodString;
+  allowedVisibility: ZodOptional<ZodArray<ZodEnum<{
+    public: "public";
+    unlisted: "unlisted";
+    private: "private";
+  }>>>;
   rootMachineId: ZodNullable<ZodString>;
   machines: ZodArray<ZodObject<{
     machineId: ZodString;
     name: ZodOptional<ZodString>;
     updatedAt: ZodOptional<ZodString>;
+    format: ZodOptional<ZodEnum<{
+      digraph: "digraph";
+      xgraph: "xgraph";
+    }>>;
   }, $strip>>;
   permissions: ZodObject<{
     canEdit: ZodBoolean;
   }, $strip>;
-  allowedVisibility: ZodOptional<ZodArray<ZodEnum<{
-    public: "public";
-    unlisted: "unlisted";
-    private: "private";
-  }>>>;
 }, $strip>;
 type Project = output<typeof projectSchema>;
 declare const machineSchema: ZodObject<{
@@ -169,6 +200,10 @@ declare const machineSchema: ZodObject<{
   }, $loose>>;
   createdAt: ZodOptional<ZodString>;
   updatedAt: ZodOptional<ZodString>;
+  format: ZodOptional<ZodEnum<{
+    digraph: "digraph";
+    xgraph: "xgraph";
+  }>>;
 }, $strip>;
 type Machine = output<typeof machineSchema>;
 declare const machineVersionSchema: ZodObject<{
@@ -179,6 +214,10 @@ declare const machineVersionSchema: ZodObject<{
   definition: ZodUnknown;
   createdAt: ZodString;
   updatedAt: ZodString;
+  format: ZodOptional<ZodEnum<{
+    digraph: "digraph";
+    xgraph: "xgraph";
+  }>>;
 }, $strip>;
 type MachineVersion = output<typeof machineVersionSchema>;
 /** Version-history row without the definition payload. */

package/dist/studio.d.mts

@@ -1,2 +1,2 @@
-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, p as LegacyExtractMachinesOptions, 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-DV5IIGhV.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, p as LegacyExtractMachinesOptions, 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-CKdEPGKY.mjs";
 export { ConnectedRepo, CreateMachineFromDefinitionInput, CreateMachineFromTemplateInput, CreateMachineInput, CreateMachineTemplate, CreateProjectInput, DEFAULT_STATELY_BASE_URL, EnsureProjectInput, ExtractMachinesInput, ExtractMachinesResponse, ExtractedMachine, ExtractedMachines, GetMachineOptions, LegacyExtractMachinesOptions, LegacyProjectVisibility, LegacyUpdateMachineInput, Machine, MachineVersion, Project, ProjectData, ProjectMachine, ProjectMachineSummary, ProjectSummary, ProjectVisibility, RepoType, ResourceErrorCode, StudioApiError, StudioApiErrorOptions, StudioClient, StudioClientOptions, StudioMachineRecord, StudioRequestOptions, UpdateMachineInput, UpdateProjectInput, VerifyApiKeyResponse, VerifyResult, XStateVersion, createStatelyClient };

package/dist/studio.mjs

@@ -1,4 +1,4 @@
 import "./openapi-BTDjYWXd.mjs";
-import { n as StudioApiError, r as createStatelyClient, t as DEFAULT_STATELY_BASE_URL } from "./studio-rSI54Ese.mjs";
+import { n as StudioApiError, r as createStatelyClient, t as DEFAULT_STATELY_BASE_URL } from "./studio-BZP6DaIO.mjs";
 
 export { DEFAULT_STATELY_BASE_URL, StudioApiError, createStatelyClient };

package/dist/sync.d.mts

@@ -1,5 +1,5 @@
-import { b as DigraphConfig, i as StatelyGraph } from "./graph-CR_g-mOq.mjs";
-import { C as StudioMachineRecord, L as XStateVersion, g as ProjectData, o as CreateProjectInput, x as StudioClient } from "./studio-DV5IIGhV.mjs";
+import { b as DigraphConfig, i as StatelyGraph } from "./graph-Ciocekxl.mjs";
+import { C as StudioMachineRecord, L as XStateVersion, g as ProjectData, o as CreateProjectInput, x as StudioClient } from "./studio-CKdEPGKY.mjs";
 import { GraphDiff } from "@statelyai/graph";
 
 //#region src/sync.d.ts

package/dist/sync.mjs

@@ -1,7 +1,7 @@
 import "./openapi-BTDjYWXd.mjs";
-import { r as createStatelyClient } from "./studio-rSI54Ese.mjs";
-import { S as toXStateV6MachineConfig, a as alignCompareGraphIds, c as diffGraphsSemantically, d as getDelayKeyFromEventType, g as graphToXStateTS, i as XSTATE_V6_FN_TRANSITION_META, m as graphToMachineConfig, p as graphChangeToPatchesResult, r as XSTATE_V6_BRANCH_DESCRIPTION_META, s as detectXStateSourceProfile, t as INLINE_EXPRESSION_DIRECTIVE_FIELDS, u as extractXStateMachineConfigEntries, x as serializeJS, y as normalizeMachineProfile } from "./dist-wbhkeGh6.mjs";
-import { n as getStatelyPragma, r as upsertStatelyPragma, t as findStatelyPragmaAttachments } from "./statelyPragma-D46lczJR.mjs";
+import { r as createStatelyClient } from "./studio-BZP6DaIO.mjs";
+import { C as toXStateV6MachineConfig, S as serializeJS, a as alignCompareGraphIds, b as normalizeMachineProfile, c as diffGraphsSemantically, d as getDelayKeyFromEventType, g as graphToXStateTS, i as XSTATE_V6_FN_TRANSITION_META, m as graphToMachineConfig, p as graphChangeToPatchesResult, r as XSTATE_V6_BRANCH_DESCRIPTION_META, s as detectXStateSourceProfile, t as INLINE_EXPRESSION_DIRECTIVE_FIELDS, u as extractXStateMachineConfigEntries, v as isCodeExpression } from "./dist-NJFkDQjK.mjs";
+import { n as getStatelyPragma, r as upsertStatelyPragma, t as findStatelyPragmaAttachments } from "./statelyPragma-YtVaBuIe.mjs";
 import { fromStudioMachine, toStudioMachine } from "./graph.mjs";
 import * as ts$1 from "typescript";
 import ts from "typescript";
@@ -2585,7 +2585,7 @@ function collectCodeImports(value) {
 			for (const child of item) visit(child);
 			return;
 		}
-		if (isInlineExpressionDirective(item)) {
+		if (isCodeExpression(item)) {
 			const itemImports = item.imports;
 			if (Array.isArray(itemImports)) {
 				for (const candidate of itemImports) if (isCodeImport(candidate)) imports.push(candidate);
@@ -3481,14 +3481,9 @@ function containsRawCodeLike(value) {
 	return Boolean(value) && typeof value === "object" && Object.values(value).some(containsRawCodeLike);
 }
 function inlineExpressionDirectiveToExpression(value) {
-	if (!isInlineExpressionDirective(value)) return null;
+	if (!isCodeExpression(value)) return null;
 	return ts$1.factory.createIdentifier(value.expr);
 }
-function isInlineExpressionDirective(value) {
-	if (!value || typeof value !== "object" || Array.isArray(value)) return false;
-	const directive = value;
-	return directive["@type"] === "code" && typeof directive.expr === "string";
-}
 function getPreservedPropertyInitializer(propertyName, nextValue, existingInitializer) {
 	if (propertyName !== "description" || typeof nextValue !== "string" || !existingInitializer) return null;
 	if (ts$1.isStringLiteralLike(existingInitializer)) return existingInitializer.text === nextValue ? existingInitializer : null;

package/dist/{version-1vqjW2Am.mjs → version-DxDSBJta.mjs}

@@ -1,4 +1,4 @@
-import { EMBED_DOCUMENT_LANGUAGES, EMBED_DOCUMENT_LIMITS, INSPECTION_PROTOCOL_VERSION, PREFIX, assertEmbedExamples } from "./protocol.mjs";
+import { a as PREFIX, n as EMBED_DOCUMENT_LIMITS, o as assertEmbedExamples, r as INSPECTION_PROTOCOL_VERSION, t as EMBED_DOCUMENT_LANGUAGES } from "./protocol-BsBGRISR.mjs";
 
 //#region src/clientUtils.ts
 const embedDocumentLanguages = new Set(EMBED_DOCUMENT_LANGUAGES);
@@ -147,7 +147,7 @@ function toInitMessage(options) {
 		commentsByMachineId: options.commentsByMachineId,
 		projectWorkspace: options.projectWorkspace,
 		projectWorkspaceOpen: options.projectWorkspaceOpen,
-		settings: options.settings,
+		settings: settingsWithViewMode(options),
 		unsavedIndicator: options.unsavedIndicator,
 		versionAutoSave: options.versionAutoSave
 	};
@@ -167,11 +167,23 @@ function toInitMessage(options) {
 		panels: options.panels,
 		comments: options.comments,
 		sourceLocations: options.sourceLocations,
-		settings: options.settings,
+		settings: settingsWithViewMode(options),
 		unsavedIndicator: options.unsavedIndicator,
 		versionAutoSave: options.versionAutoSave
 	};
 }
+/** Resolve the view shorthand without replacing unrelated embed settings. */
+function settingsWithViewMode(options) {
+	if (!options.viewMode) return options.settings;
+	const canvas = options.settings?.canvas;
+	return {
+		...options.settings,
+		canvas: {
+			...canvas && typeof canvas === "object" && !Array.isArray(canvas) ? canvas : {},
+			viewMode: options.viewMode
+		}
+	};
+}
 
 //#endregion
 //#region src/transport.ts
@@ -366,7 +378,7 @@ function createWebSocketTransport(options) {
 
 //#endregion
 //#region src/version.ts
-const SDK_VERSION = "0.32.0";
+const SDK_VERSION = "0.34.0";
 function inspectionRuntime() {
 	if (typeof window !== "undefined") return "browser";
 	if (typeof process !== "undefined" && process.versions?.node) return "node";
@@ -374,4 +386,4 @@ function inspectionRuntime() {
 }
 
 //#endregion
-export { createEventRegistry as a, createWebSocketTransport as i, inspectionRuntime as n, createPendingExportManager as o, createPostMessageTransport as r, toInitMessage as s, SDK_VERSION as t };
+export { assertEmbedDocuments as a, createPendingExportManager as c, createWebSocketTransport as i, settingsWithViewMode as l, inspectionRuntime as n, assertEmbedPanels as o, createPostMessageTransport as r, createEventRegistry as s, SDK_VERSION as t, toInitMessage as u };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@statelyai/sdk",
-  "version": "0.32.0",
+  "version": "0.34.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.5.0",
-    "@statelyai/graph-tools": "0.8.3"
+    "@statelyai/api-contract": "0.5.1",
+    "@statelyai/graph-tools": "0.8.4"
   },
   "engines": {
     "node": ">=22.4"