@statelyai/sdk 0.12.2 → 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/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";

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/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[];
@@ -510,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, SetApiKeyMessage, 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/{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.2",
+  "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",