@statelyai/sdk 0.7.0 → 0.7.1

package/dist/assetStorage.d.mts

@@ -1,4 +1,4 @@
-import { m as UploadResult } from "./protocol-DN4mH4jR.mjs";
+import { m as UploadResult } from "./protocol-s9zwsiCW.mjs";
 
 //#region src/assetStorage.d.ts
 interface AssetUploadContext {

package/dist/cli.d.mts

@@ -1,5 +1,4 @@
 import { ConnectedRepo, CreateProjectInput, ProjectData, StudioClient } from "./studio.mjs";
-import "./graph-DpBGHZwl.mjs";
 import { SyncPlan } from "./sync.mjs";
 import { Command } from "@oclif/core";
 import * as _oclif_core_interfaces0 from "@oclif/core/interfaces";
@@ -43,7 +42,6 @@ interface InitProjectResult {
 }
 interface ScanProjectSourcesOptions {
   cwd?: string;
-  client: StudioClient;
   defaultXStateVersion?: number;
 }
 type ApiKeyResolution = {

package/dist/cli.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import { createStatelyClient } from "./studio.mjs";
 import { u as getStatelyPragma } from "./graphToXStateTS-Gzh0ZqbN.mjs";
-import { planSync, pullSync, pushLocalMachineLinks } from "./sync.mjs";
+import { n as pullSync, r as pushLocalMachineLinks, t as planSync } from "./sync-DLkTmSyA.mjs";
 import fs from "node:fs/promises";
 import * as path$1 from "node:path";
 import path from "node:path";
@@ -951,6 +951,7 @@ const CODE_SOURCE_EXTENSIONS = new Set([
 	".mjs",
 	".cjs"
 ]);
+const execFileAsync$1 = promisify(execFile);
 function createStatelyProjectConfig(options) {
 	const defaultXStateVersion = options.defaultXStateVersion ?? 5;
 	return {
@@ -962,12 +963,26 @@ function createStatelyProjectConfig(options) {
 		sources: []
 	};
 }
+function normalizeSourceConfig(source) {
+	return {
+		include: [...source.include ?? []],
+		exclude: source.exclude == null ? [...DEFAULT_SOURCE_EXCLUDES] : [...source.exclude],
+		format: source.format ?? "xstate",
+		...source.xstateVersion == null ? {} : { xstateVersion: source.xstateVersion }
+	};
+}
+function normalizeProjectConfig(config) {
+	return {
+		...config,
+		sources: (config.sources ?? []).map((source) => normalizeSourceConfig(source))
+	};
+}
 async function readStatelyProjectConfig(options = {}) {
 	const rootDir = path.resolve(options.cwd ?? process.cwd());
 	const configPath = path.resolve(rootDir, options.configPath ?? STATELY_CONFIG_FILE);
 	const raw = await fs.readFile(configPath, "utf8");
 	return {
-		config: JSON.parse(raw),
+		config: normalizeProjectConfig(JSON.parse(raw)),
 		configPath,
 		rootDir
 	};
@@ -987,6 +1002,27 @@ async function walkFiles(rootDir, currentDir = rootDir) {
 	}
 	return files;
 }
+async function filterGitIgnoredPaths(rootDir, relativeFiles) {
+	try {
+		const { stdout } = await execFileAsync$1("git", [
+			"ls-files",
+			"--others",
+			"--ignored",
+			"--exclude-standard",
+			"--directory"
+		], { cwd: rootDir });
+		const ignoredEntries = stdout.split(/\r?\n/).map((entry) => entry.trim()).filter(Boolean);
+		if (ignoredEntries.length === 0) return relativeFiles;
+		return relativeFiles.filter((relativePath) => {
+			return !ignoredEntries.some((ignoredEntry) => {
+				if (ignoredEntry.endsWith("/")) return relativePath.startsWith(ignoredEntry);
+				return relativePath === ignoredEntry;
+			});
+		});
+	} catch {
+		return relativeFiles;
+	}
+}
 function isCodeSourceFile(relativePath) {
 	return CODE_SOURCE_EXTENSIONS.has(path.extname(relativePath).toLowerCase());
 }
@@ -1031,7 +1067,8 @@ function matchesAny(patterns, relativePath) {
 	return (patterns ?? []).some((pattern) => matchesGlob(relativePath, pattern));
 }
 async function discoverCodeSourceFiles(options = {}) {
-	return (await walkFiles(path.resolve(options.cwd ?? process.cwd()))).filter((relativePath) => isCodeSourceFile(relativePath)).filter((relativePath) => !matchesAny(DEFAULT_SOURCE_EXCLUDES, relativePath)).sort((left, right) => left.localeCompare(right));
+	const rootDir = path.resolve(options.cwd ?? process.cwd());
+	return (await filterGitIgnoredPaths(rootDir, await walkFiles(rootDir))).filter((relativePath) => isCodeSourceFile(relativePath)).filter((relativePath) => !matchesAny(DEFAULT_SOURCE_EXCLUDES, relativePath)).sort((left, right) => left.localeCompare(right));
 }
 function createSuggestedSource(include) {
 	return {
@@ -1080,7 +1117,7 @@ async function discoverStatelySourceFiles(options = {}) {
 		config: options.config,
 		rootDir: path.resolve(options.cwd ?? process.cwd())
 	} : await readStatelyProjectConfig(options);
-	const relativeFiles = await walkFiles(rootDir);
+	const relativeFiles = await filterGitIgnoredPaths(rootDir, await walkFiles(rootDir));
 	const discovered = /* @__PURE__ */ new Map();
 	for (const source of config.sources) for (const relativePath of relativeFiles) {
 		if (!matchesAny(source.include, relativePath)) continue;
@@ -1098,6 +1135,7 @@ async function discoverStatelySourceFiles(options = {}) {
 //#endregion
 //#region src/cli.ts
 const execFileAsync = promisify(execFile);
+const STATELY_API_KEY_SETTINGS_URL = "https://stately.ai/registry/user/my-settings?tab=API+Key";
 function loadLocalEnv() {
 	if (typeof process.loadEnvFile !== "function") return;
 	const cwdEnvPath = path.join(process.cwd(), ".env.local");
@@ -1248,6 +1286,12 @@ function normalizeApiKey(value) {
 	const trimmed = value?.trim();
 	return trimmed ? trimmed : void 0;
 }
+function pluralize(count, singular, plural = `${singular}s`) {
+	return count === 1 ? singular : plural;
+}
+function getMissingApiKeyMessage() {
+	return `No API key configured. Use \`statelyai login\`, set \`STATELY_API_KEY\`, or pass \`--api-key\`.\nGet or create an API key at ${STATELY_API_KEY_SETTINGS_URL}`;
+}
 async function fileExists(filePath) {
 	try {
 		await fs.access(filePath);
@@ -1293,17 +1337,15 @@ async function scanProjectSources(options) {
 	const machineRelativePaths = [];
 	for (const relativePath of candidateRelativePaths) {
 		const filePath = path.join(cwd, relativePath);
-		const contents = await fs.readFile(filePath, "utf8");
-		let extracted;
-		try {
-			extracted = await options.client.code.extractMachines(contents);
-		} catch {
-			continue;
-		}
-		if (extracted.machines.length > 0) machineRelativePaths.push(relativePath);
+		if (looksLikeXStateMachineSource(await fs.readFile(filePath, "utf8"))) machineRelativePaths.push(relativePath);
 	}
 	return suggestStatelySourceConfigs(machineRelativePaths, Math.max(5, options.defaultXStateVersion ?? 5));
 }
+function looksLikeXStateMachineSource(source) {
+	const hasXStateImport = /from\s+['"]xstate(?:\/[^'"]+)?['"]/.test(source) || /require\(\s*['"]xstate(?:\/[^'"]+)?['"]\s*\)/.test(source);
+	const hasMachineFactory = /\bcreateMachine\s*\(/.test(source) || /\.createMachine\s*\(/.test(source);
+	return hasXStateImport && hasMachineFactory;
+}
 function supportsMachineDiscovery(file) {
 	return file.source.format === "xstate" || file.source.format === "auto";
 }
@@ -1441,6 +1483,7 @@ var PullCommand = class PullCommand extends ParsedSyncCommand {
 			target = localCandidate;
 		}
 		if (!target) this.error("Missing target path. Pass `statelyai pull <machine-id|url> <file>` or `statelyai pull <linked-file>`.");
+		this.log(`Pulling ${source} into ${target}...`);
 		const result = await pullSync({
 			source,
 			target,
@@ -1467,7 +1510,8 @@ var PushCommand = class PushCommand extends Command {
 	async run() {
 		const { args, flags } = await this.parse(PushCommand);
 		const resolvedApiKey = await resolveApiKey(flags["api-key"]);
-		if (!resolvedApiKey.apiKey) this.error("No API key configured. Use `statelyai login`, set `STATELY_API_KEY`, or pass `--api-key`.");
+		if (!resolvedApiKey.apiKey) this.error(getMissingApiKeyMessage());
+		this.log("Resolving configured project and source files...");
 		const { client, config, files } = await resolveConfiguredProject({
 			apiKey: resolvedApiKey.apiKey,
 			baseUrl: flags["base-url"],
@@ -1486,10 +1530,12 @@ var PushCommand = class PushCommand extends Command {
 			this.log("No matching local machine source files were discovered.");
 			return;
 		}
+		this.log(`Processing ${candidateFiles.length} ${pluralize(candidateFiles.length, "source file")}...`);
 		const linked = [];
 		const refreshed = [];
 		const skipped = [];
 		for (const file of candidateFiles) {
+			this.log(`Pushing ${file.relativePath}...`);
 			if (!supportsMachineDiscovery(file)) {
 				skipped.push(`${file.relativePath}: unsupported format ${file.source.format}`);
 				continue;
@@ -1586,7 +1632,8 @@ var InitCommand = class InitCommand extends Command {
 	async run() {
 		const { flags } = await this.parse(InitCommand);
 		const resolvedApiKey = await resolveApiKey(flags["api-key"]);
-		if (!resolvedApiKey.apiKey) this.error("No API key configured. Use `statelyai login`, set `STATELY_API_KEY`, or pass `--api-key`.");
+		if (!resolvedApiKey.apiKey) this.error(getMissingApiKeyMessage());
+		this.log("Creating or reusing remote project...");
 		const result = await initProject({
 			apiKey: resolvedApiKey.apiKey,
 			baseUrl: flags["base-url"],
@@ -1597,13 +1644,9 @@ var InitCommand = class InitCommand extends Command {
 			}
 		});
 		if (flags.scan) {
-			const scanClient = createStatelyClient({
-				apiKey: resolvedApiKey.apiKey,
-				baseUrl: flags["base-url"] ?? result.config.studioUrl
-			});
+			this.log("Scanning local source files...");
 			const suggestions = await scanProjectSources({
 				cwd: path.dirname(result.configPath),
-				client: scanClient,
 				defaultXStateVersion: result.config.defaultXStateVersion
 			});
 			if (suggestions.length === 0) {
@@ -1640,8 +1683,9 @@ var LoginCommand = class LoginCommand extends Command {
 	async run() {
 		const { flags } = await this.parse(LoginCommand);
 		if (flags.stdin && flags["api-key"]) this.error("Pass either --api-key or --stdin, not both.");
+		if (!flags["api-key"] && !flags.stdin && process.stdin.isTTY && process.stdout.isTTY) this.log(`Get or create an API key at ${STATELY_API_KEY_SETTINGS_URL}`);
 		const apiKey = normalizeApiKey(flags["api-key"] ?? (!process.stdin.isTTY || flags.stdin ? await readApiKeyFromStdin() : await promptForApiKey()));
-		if (!apiKey) this.error("API key cannot be empty.");
+		if (!apiKey) this.error(`API key cannot be empty.\nGet or create an API key at ${STATELY_API_KEY_SETTINGS_URL}`);
 		const stored = await setStoredApiKey(apiKey);
 		this.log(`Stored API key in ${describeCredentialBackend(stored.backend, stored.location)}.`);
 	}
@@ -1677,7 +1721,7 @@ var AuthStatusCommand = class extends Command {
 			this.log(`API key source: stored credential (${describeCredentialBackend(storedApiKey.backend, storedApiKey.location)}).`);
 			return;
 		}
-		this.log("No API key configured. Use `statelyai login`, set `STATELY_API_KEY`, or pass `--api-key`.");
+		this.log(getMissingApiKeyMessage());
 	}
 };
 const COMMANDS = {

package/dist/embed.d.mts

@@ -1,4 +1,4 @@
-import { a as EmbedMode, c as ExportFormatMap, d as MachineSourceLocations, 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, u as MachineInitOptions } from "./protocol-DN4mH4jR.mjs";
+import { a as EmbedMode, c as ExportFormatMap, d as MachineSourceLocations, 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, u as MachineInitOptions } from "./protocol-s9zwsiCW.mjs";
 import { AssetUploadAdapter } from "./assetStorage.mjs";
 
 //#region src/embed.d.ts

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

package/dist/index.d.mts

@@ -1,14 +1,14 @@
 import { StatelyApiClientOptions, StatelyApiError, StatelyApiUrlOptions, createStatelyApiClient, createStatelyApiUrl } from "./api.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-DN4mH4jR.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-s9zwsiCW.mjs";
 import { AssetUploadAdapter, AssetUploadContext, AssetUploadRequest, CreateS3AssetUploadAdapterOptions, CreateSupabaseAssetUploadAdapterOptions, S3UploadTarget, SupabaseStorageClient, createS3AssetUploadAdapter, createSupabaseAssetUploadAdapter } from "./assetStorage.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 { 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-DpBGHZwl.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-zuNj3kfa.mjs";
 import { PlanSyncOptions, PullSyncResult, PushLocalMachineLinksResult, PushSyncOptions, PushSyncProjectOptions, PushSyncResult, ResolvedSyncInput, SyncInputFormat, SyncPlan, SyncPlanSummary } from "./sync.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-Bg9FTvb3.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-YoEwfiKb.mjs";
 import { ActionLocation, GraphPatch } from "./patchTypes.mjs";
-import { JSONSchema7 } from "json-schema";
 import { UnknownMachineConfig } from "xstate";
+import { JSONSchema7 } from "json-schema";
 
 //#region src/statelyPragma.d.ts
 interface StatelyPragma {

package/dist/{inspect-Bg9FTvb3.d.mts → inspect-YoEwfiKb.d.mts}

@@ -1,4 +1,4 @@
-import { c as ExportFormatMap, o as ExportCallOptions, p as ProtocolMessage, r as EmbedEventMap, s as ExportFormat } from "./protocol-DN4mH4jR.mjs";
+import { c as ExportFormatMap, o as ExportCallOptions, p as ProtocolMessage, r as EmbedEventMap, s as ExportFormat } from "./protocol-s9zwsiCW.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-DN4mH4jR.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-Bg9FTvb3.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-s9zwsiCW.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-YoEwfiKb.mjs";
 export { AdoptedActor, CreateInspectorOptions, EmbedEventHandler, EmbedEventMap, EmbedEventName, EmbedMode, ExportCallOptions, ExportFormat, ExportFormatMap, Inspector, InspectorEvents, ManualActorOptions, Transport, createStatelyInspector };

package/dist/studio.mjs

@@ -40,6 +40,14 @@ function unwrapResponseData(data) {
 	if (typeof data === "object" && data !== null && "data" in data) return data.data;
 	return data;
 }
+function normalizeProjectData(project) {
+	if (project.projectVersionId) return project;
+	if (project.projectId && project.id) return {
+		...project,
+		projectVersionId: project.id
+	};
+	return project;
+}
 function normalizeRepoUrl(url) {
 	if (!url) return;
 	return url.replace(/\.git$/i, "").replace(/\/+$/, "");
@@ -71,14 +79,14 @@ function createStatelyClient(options = {}) {
 		} },
 		projects: {
 			list() {
-				return request("/projects", { method: "GET" });
+				return request("/projects", { method: "GET" }).then((projects) => projects.map(normalizeProjectData));
 			},
 			create(input) {
 				return request("/projects/create", {
 					method: "POST",
 					headers: { "Content-Type": "application/json" },
 					body: JSON.stringify(input)
-				});
+				}).then(normalizeProjectData);
 			},
 			async ensure(input) {
 				if (input.repo && input.matchConnectedRepo !== false) {
@@ -88,7 +96,7 @@ function createStatelyClient(options = {}) {
 				return this.create(input);
 			},
 			get(projectId) {
-				return request(`/projects/${encodeURIComponent(projectId)}`, { method: "GET" });
+				return request(`/projects/${encodeURIComponent(projectId)}`, { method: "GET" }).then(normalizeProjectData);
 			}
 		},
 		machines: {