@statelyai/sdk 0.12.1 → 0.12.3

package/README.md

@@ -30,11 +30,14 @@ embed.init({
 
 Restrict an embed by passing a resolved access policy:
 
+<!-- restricted MachineInitOptions from src/protocol.ts -->
+
 ```ts
 embed.init({
   machine: myMachineConfig,
   mode: 'viewing',
   readOnly: true,
+  readOnlyReason: 'free-plan',
   capabilities: {
     edit: false,
     export: false,
@@ -51,6 +54,10 @@ embed.on('capabilityDenied', (event) => {
 });
 ```
 
+`readOnlyReason: 'free-plan'` shows a persistent **Upgrade to edit** action.
+Use `access-unverified` when reopening or signing in, rather than upgrading, is
+the appropriate recovery action.
+
 Key capabilities:
 
 - **Mount or attach** to any container element or existing iframe

package/dist/embed.mjs

@@ -1,4 +1,4 @@
-import { a as toInitMessage, i as createPendingExportManager, r as createEventRegistry, t as createPostMessageTransport } from "./transport-D0nlFaLn.mjs";
+import { a as toInitMessage, i as createPendingExportManager, r as createEventRegistry, t as createPostMessageTransport } from "./transport-DysvAtl5.mjs";
 
 //#region src/embed.ts
 function buildEmbedUrl(options) {
@@ -26,6 +26,7 @@ function extractInitOptions(options) {
 		mode: options.mode,
 		theme: options.theme,
 		readOnly: options.readOnly,
+		readOnlyReason: options.readOnlyReason,
 		depth: options.depth,
 		capabilities: options.capabilities,
 		panels: options.panels,

package/dist/{graph-Bm4_GZX_.d.mts → graph-Dq5ycdSq.d.mts}

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

package/dist/graph.d.mts

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

package/dist/{index-BpUKBSiq.d.mts → index-BRW2DecD.d.mts}

@@ -2473,8 +2473,8 @@ declare const actionLocationSchema: ZodUnion<readonly [ZodObject<{
 }, $strip>]>;
 type ActionLocation = output<typeof actionLocationSchema>;
 declare const implementationSourceTypeSchema: ZodEnum<{
-  action: "action";
   guard: "guard";
+  action: "action";
   actor: "actor";
   delay: "delay";
 }>;
@@ -2745,8 +2745,8 @@ declare const graphPatchSchema: ZodDiscriminatedUnion<[ZodObject<{
   op: ZodLiteral<"createImplementation">;
   description: ZodOptional<ZodString>;
   sourceType: ZodEnum<{
-    action: "action";
     guard: "guard";
+    action: "action";
     actor: "actor";
     delay: "delay";
   }>;
@@ -2759,8 +2759,8 @@ declare const graphPatchSchema: ZodDiscriminatedUnion<[ZodObject<{
   op: ZodLiteral<"updateImplementation">;
   description: ZodOptional<ZodString>;
   sourceType: ZodEnum<{
-    action: "action";
     guard: "guard";
+    action: "action";
     actor: "actor";
     delay: "delay";
   }>;
@@ -2773,8 +2773,8 @@ declare const graphPatchSchema: ZodDiscriminatedUnion<[ZodObject<{
   op: ZodLiteral<"deleteImplementation">;
   description: ZodOptional<ZodString>;
   sourceType: ZodEnum<{
-    action: "action";
     guard: "guard";
+    action: "action";
     actor: "actor";
     delay: "delay";
   }>;

package/dist/index.d.mts

@@ -3,13 +3,12 @@ import { CapabilityDeniedCapability, CapabilityDeniedEvent, CommentsConfig, Edit
 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-DO1-eQcU.mjs";
 import { AssetConfig, StatelyEmbed, StatelyEmbedOptions, createStatelyEmbed } from "./embed.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-BpUKBSiq.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-Bm4_GZX_.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-BRW2DecD.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-Dq5ycdSq.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-BmZUcnZB.mjs";
 import { ConnectedRepo, CreateMachineFromDefinitionInput, CreateMachineFromTemplateInput, CreateMachineInput, CreateMachineTemplate, CreateProjectInput, EnsureProjectInput, ExtractMachinesResponse, ExtractedMachine, GetMachineOptions, ProjectData, ProjectMachine, ProjectVisibility, RepoType, StudioApiError, StudioClient, StudioClientOptions, StudioMachineRecord, UpdateMachineInput, VerifyApiKeyResponse, XStateVersion, createStatelyClient } from "./studio.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";
-
 //#region src/statelyPragma.d.ts
 interface StatelyPragma {
   tag: '@statelyai';

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { n as createWebSocketTransport, t as createPostMessageTransport } from "./transport-D0nlFaLn.mjs";
+import { n as createWebSocketTransport, t as createPostMessageTransport } from "./transport-DysvAtl5.mjs";
 import { createStatelyEmbed } from "./embed.mjs";
 import { createS3AssetUploadAdapter, createSupabaseAssetUploadAdapter } from "./assetStorage.mjs";
 import { createStatelyInspector } from "./inspect.mjs";
@@ -6,7 +6,7 @@ import { createAuthorizationHeader, getCredentialToken } from "./auth.mjs";
 import { StudioApiError, createStatelyClient } from "./studio.mjs";
 import { buildAuthorizeUrl, createPkcePair, discoverAuthorizationServer, discoverProtectedResource, exchangeCodeForToken, refreshToken, registerOAuthClient } from "./oauth.mjs";
 import { StatelyApiError, createStatelyApiClient, createStatelyApiUrl } from "./api.mjs";
-import { a as eventsSchemaToTSType, c as jsonSchemaToTSType, f as findStatelyPragmaAttachments, l as raw, m as upsertStatelyPragma, n as RawCode, o as graphToMachineConfig, p as getStatelyPragma, r as contextSchemaToTSType, s as graphToXStateTS, u as serializeJS } from "./dist-cQdIPK_n.mjs";
+import { a as eventsSchemaToTSType, c as jsonSchemaToTSType, f as findStatelyPragmaAttachments, l as raw, m as upsertStatelyPragma, n as RawCode, o as graphToMachineConfig, p as getStatelyPragma, r as contextSchemaToTSType, s as graphToXStateTS, u as serializeJS } from "./dist-C-AdA8Iw.mjs";
 import { fromStudioMachine, studioMachineConverter, toStudioMachine } from "./graph.mjs";
 
 export { RawCode, StatelyApiError, StudioApiError, buildAuthorizeUrl, contextSchemaToTSType, createAuthorizationHeader, createPkcePair, createPostMessageTransport, createS3AssetUploadAdapter, createStatelyApiClient, createStatelyApiUrl, createStatelyClient, createStatelyEmbed, createStatelyInspector, createSupabaseAssetUploadAdapter, createWebSocketTransport, discoverAuthorizationServer, discoverProtectedResource, eventsSchemaToTSType, exchangeCodeForToken, findStatelyPragmaAttachments, fromStudioMachine, getCredentialToken, getStatelyPragma, graphToMachineConfig, graphToXStateTS, jsonSchemaToTSType, raw, refreshToken, registerOAuthClient, serializeJS, studioMachineConverter, toStudioMachine, upsertStatelyPragma };

package/dist/inspect.mjs

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

package/dist/patchTypes.d.mts

@@ -1,2 +1,2 @@
-import { a as EditorStateType, n as CanvasColor, o as GraphPatch, s as ImplementationSourceType, t as ActionLocation } from "./index-BpUKBSiq.mjs";
+import { a as EditorStateType, n as CanvasColor, o as GraphPatch, s as ImplementationSourceType, t as ActionLocation } from "./index-BRW2DecD.mjs";
 export { type ActionLocation, type CanvasColor, type EditorStateType, type GraphPatch, type ImplementationSourceType };

package/dist/protocol.d.mts

@@ -29,6 +29,7 @@ interface EditorCapabilities {
   panels?: string[];
   commands?: string[];
 }
+type ReadOnlyReason = "free-plan" | "access-unverified";
 type CapabilityDeniedCapability = "edit" | "export" | "ai" | "simulate" | "inspect" | "navigateHierarchy" | "panel" | "mode";
 interface CapabilityDeniedEvent {
   capability: CapabilityDeniedCapability;
@@ -178,6 +179,7 @@ interface MachineInitOptions {
   mode?: EmbedMode;
   theme?: "light" | "dark";
   readOnly?: boolean;
+  readOnlyReason?: ReadOnlyReason;
   depth?: number;
   capabilities?: EditorCapabilities;
   panels?: {
@@ -233,6 +235,7 @@ interface InitMessage {
   mode?: EmbedMode;
   theme?: "light" | "dark";
   readOnly?: boolean;
+  readOnlyReason?: ReadOnlyReason;
   depth?: number;
   capabilities?: EditorCapabilities;
   leftPanels?: string[];
@@ -249,6 +252,10 @@ interface InitMessage {
   /** Optional session id override (multiplexed clients only). */
   sessionId?: string;
 }
+interface SetApiKeyMessage {
+  type: "@statelyai.setApiKey";
+  apiKey: string;
+}
 interface ProjectInitMessage {
   type: "@statelyai.project.init";
   machines: ProjectEmbedMachine[];
@@ -456,7 +463,7 @@ interface UploadResponseMessage {
   result: UploadResult;
 }
 /** All messages a client (embed/inspector) can send to the viz. */
-type ClientMessage = InitMessage | ProjectInitMessage | ProjectUpdateMessage | ProjectSelectMachineMessage | UpdateMessage | SetModeMessage | SetThemeMessage | SetSettingsMessage | RetrieveMessage | ToastMessage | InspectSnapshotMessage | SystemInitMessage | SystemActorRegisteredMessage | SystemActorSnapshotMessage | SystemActorStoppedMessage | UploadCapabilitiesMessage | UploadResponseMessage | ErrorMessage;
+type ClientMessage = InitMessage | SetApiKeyMessage | 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 | ProjectMachineSelectedMessage | RetrievedMessage | ErrorMessage | CapabilityDeniedMessage | UploadRequestMessage;
 interface RegisterMessage {
@@ -506,4 +513,4 @@ type SessionMessage = RegisterMessage | RegisteredMessage | RequestOpenMessage |
 type ProtocolMessage = ClientMessage | VizMessage | SessionMessage;
 declare const PREFIX = "@statelyai.";
 //#endregion
-export { ActorSystemEntry, AddSessionMessage, CapabilityDeniedCapability, CapabilityDeniedEvent, CapabilityDeniedMessage, ChangeMessage, ClientMessage, CommentsConfig, EditorCapabilities, EmbedEventHandler, EmbedEventMap, EmbedEventName, EmbedMode, ErrorMessage, ExportCallOptions, ExportFormat, ExportFormatMap, InitMessage, InitOptions, InspectSnapshotMessage, LoadedMessage, MachineInitOptions, MachineSourceLocations, PREFIX, ProjectEmbedMachine, ProjectInitMessage, ProjectInitOptions, ProjectMachineSelectedMessage, ProjectSelectMachineMessage, ProjectUpdateMessage, ProtocolMessage, ReadyMessage, RegisterMessage, RegisteredMessage, RequestOpenMessage, RetrieveMessage, RetrievedMessage, SaveMessage, SessionAddedMessage, SessionMessage, SetModeMessage, SetSettingsMessage, SetThemeMessage, SourceLocation, SourceRange, StateSourceLocation, SystemActorRegisteredMessage, SystemActorSnapshotMessage, SystemActorStoppedMessage, SystemInitMessage, ToastMessage, UpdateMessage, UploadCapabilitiesMessage, UploadFileInfo, UploadRequestMessage, UploadResponseMessage, UploadResult, ValidationIssue, VizMessage };
+export { ActorSystemEntry, AddSessionMessage, CapabilityDeniedCapability, CapabilityDeniedEvent, CapabilityDeniedMessage, ChangeMessage, ClientMessage, CommentsConfig, EditorCapabilities, EmbedEventHandler, EmbedEventMap, EmbedEventName, EmbedMode, ErrorMessage, ExportCallOptions, ExportFormat, ExportFormatMap, InitMessage, InitOptions, InspectSnapshotMessage, LoadedMessage, MachineInitOptions, MachineSourceLocations, PREFIX, ProjectEmbedMachine, ProjectInitMessage, ProjectInitOptions, ProjectMachineSelectedMessage, ProjectSelectMachineMessage, ProjectUpdateMessage, ProtocolMessage, ReadOnlyReason, ReadyMessage, RegisterMessage, RegisteredMessage, RequestOpenMessage, RetrieveMessage, RetrievedMessage, SaveMessage, SessionAddedMessage, SessionMessage, SetApiKeyMessage, SetModeMessage, SetSettingsMessage, SetThemeMessage, SourceLocation, SourceRange, StateSourceLocation, SystemActorRegisteredMessage, SystemActorSnapshotMessage, SystemActorStoppedMessage, SystemInitMessage, ToastMessage, UpdateMessage, UploadCapabilitiesMessage, UploadFileInfo, UploadRequestMessage, UploadResponseMessage, UploadResult, ValidationIssue, VizMessage };

package/dist/sync.d.mts

@@ -1,4 +1,4 @@
-import { b as DigraphConfig, i as StatelyGraph } from "./graph-Bm4_GZX_.mjs";
+import { b as DigraphConfig, i as StatelyGraph } from "./graph-Dq5ycdSq.mjs";
 import { CreateProjectInput, ProjectData, StudioClient, StudioMachineRecord, XStateVersion } from "./studio.mjs";
 import { GraphDiff } from "@statelyai/graph";
 

package/dist/sync.mjs

@@ -1,5 +1,5 @@
 import { createStatelyClient } from "./studio.mjs";
-import { d as xstateSourceToConfig, f as findStatelyPragmaAttachments, i as detectXStateSourceProfile, m as upsertStatelyPragma, p as getStatelyPragma, s as graphToXStateTS, t as INLINE_EXPRESSION_DIRECTIVE_FIELDS, u as serializeJS } from "./dist-cQdIPK_n.mjs";
+import { d as xstateSourceToConfig, f as findStatelyPragmaAttachments, i as detectXStateSourceProfile, m as upsertStatelyPragma, p as getStatelyPragma, s as graphToXStateTS, t as INLINE_EXPRESSION_DIRECTIVE_FIELDS, u as serializeJS } from "./dist-C-AdA8Iw.mjs";
 import { fromStudioMachine, toStudioMachine } from "./graph.mjs";
 import * as ts$1 from "typescript";
 import ts from "typescript";

package/dist/{transport-D0nlFaLn.mjs → transport-DysvAtl5.mjs}

@@ -113,6 +113,7 @@ function toInitMessage(options) {
 		mode: options.mode,
 		theme: options.theme,
 		readOnly: options.readOnly,
+		readOnlyReason: options.readOnlyReason,
 		depth: options.depth,
 		capabilities: options.capabilities,
 		leftPanels: options.panels?.leftPanels,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@statelyai/sdk",
-  "version": "0.12.1",
+  "version": "0.12.3",
   "license": "MIT",
   "files": [
     "dist",
@@ -76,7 +76,7 @@
     "jsdom": "^27.4.0",
     "tsdown": "0.21.0-beta.2",
     "vitest": "^3.2.4",
-    "@statelyai/graph-tools": "0.0.3"
+    "@statelyai/graph-tools": "0.0.4"
   },
   "scripts": {
     "build": "tsdown",