statelyai 0.7.11 → 0.8.0

package/README.md

@@ -173,6 +173,14 @@ the credential so a later command can retry.
 Project-wide discovery identifies configured JavaScript and TypeScript files
 that import XState and call `createMachine(...)` or `.createMachine(...)`.
 
+<!-- resolveApiBaseUrl and DEFAULT_STATELY_API_BASE_URL from src/projectConfig.ts -->
+
+Remote commands call the server-owned `/api/v1` resource contract on the editor
+API server. Existing configs need no change: a `studioUrl` pointing at hosted
+Stately (`stately.ai` or `www.stately.ai`) resolves to
+`https://editor.stately.ai` at request time, and the file is never rewritten for
+this. Any other `studioUrl`, such as a self-hosted origin, is used as-is.
+
 Mutating project commands rewrite legacy configs with one `sources` entry to
 the current top-level shape. `status` and `push --dry-run` normalize legacy
 config in memory without writing it. Multiple legacy entries cannot be merged

package/dist/bin.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { S as run } from "./cli-Duxz6wQc.mjs";
+import { S as run } from "./cli-Dc8HDZ6q.mjs";
 
 //#region src/bin.ts
 run();

package/dist/{cli-Duxz6wQc.mjs → cli-Dc8HDZ6q.mjs}

@@ -1048,6 +1048,42 @@ function describeCredentialBackend(backend, location) {
 const STATELY_CONFIG_FILE = "statelyai.json";
 const STATELY_CONFIG_SCHEMA_URL = "https://stately.ai/schemas/statelyai.json";
 const STATELY_CONFIG_VERSION = "1.0.0";
+/**
+* Base URL of the deployment that hosts the owned resource contract
+* (`/api/v1/*`). Matches the SDK default.
+*/
+const DEFAULT_STATELY_API_BASE_URL = "https://editor.stately.ai";
+/**
+* Hosts of the legacy hosted Studio. `statelyai.json#studioUrl` values that
+* point at them predate the editor-hosted API and must be redirected.
+*/
+const HOSTED_STUDIO_HOSTNAMES = new Set(["stately.ai", "www.stately.ai"]);
+/**
+* Maps a configured `statelyai.json#studioUrl` (or a `--base-url` flag) to the
+* base URL of the editor API that serves our owned contract.
+*
+* Hosted legacy values (`https://stately.ai`, `http://www.stately.ai/`, ...)
+* resolve to {@link DEFAULT_STATELY_API_BASE_URL}. Anything else is used as-is
+* (minus trailing slashes): self-hosted editor deployments already point at the
+* server that hosts `/api/v1`.
+*
+* This is a read-only compatibility shim: the CLI never rewrites
+* `statelyai.json` because of it.
+*/
+function resolveApiBaseUrl(studioUrl) {
+	const trimmed = studioUrl?.trim();
+	if (!trimmed) return DEFAULT_STATELY_API_BASE_URL;
+	const parsed = tryParseUrl(trimmed) ?? tryParseUrl(`https://${trimmed}`);
+	if (parsed && HOSTED_STUDIO_HOSTNAMES.has(parsed.hostname.toLowerCase())) return DEFAULT_STATELY_API_BASE_URL;
+	return trimmed.replace(/\/+$/, "");
+}
+function tryParseUrl(value) {
+	try {
+		return new URL(value);
+	} catch {
+		return;
+	}
+}
 const DEFAULT_SOURCE_EXCLUDES = ["**/*.test.*", "**/*.spec.*"];
 const CODE_SOURCE_EXTENSIONS = new Set([
 	".ts",
@@ -1861,7 +1897,7 @@ async function discoverRemoteProjectMachineTargets(options) {
 	if (!newMachineDir) return [];
 	const targets = [];
 	const reservedRelativePaths = /* @__PURE__ */ new Set();
-	for (const machine of options.project.machines) {
+	for (const machine of options.machines) {
 		const candidate = machine;
 		const machineId = typeof candidate.machineId === "string" ? candidate.machineId : typeof candidate.id === "string" ? candidate.id : void 0;
 		if (!machineId || options.linkedMachineIds.has(machineId)) continue;
@@ -1899,6 +1935,7 @@ async function discoverRemoteProjectMachineTargets(options) {
 async function initProject(options) {
 	const cwd = path.resolve(options.cwd ?? process.cwd());
 	const studioUrl = getResolvedStudioUrl(options.baseUrl);
+	const apiBaseUrl = resolveApiBaseUrl(studioUrl);
 	const configPath = path.resolve(cwd, options.configPath ?? STATELY_CONFIG_FILE);
 	const defaultXStateVersion = Math.max(5, options.defaultXStateVersion ?? 5);
 	const existingConfig = !options.force ? await readStatelyProjectConfig({
@@ -1915,7 +1952,7 @@ async function initProject(options) {
 		if (existingConfig.config.projectId) {
 			const client = options.client ?? createStatelyClient({
 				apiKey: options.apiKey,
-				baseUrl: studioUrl
+				baseUrl: apiBaseUrl
 			});
 			return {
 				config: existingConfig.config,
@@ -1936,7 +1973,7 @@ async function initProject(options) {
 	}
 	const client = options.client ?? createStatelyClient({
 		apiKey: options.apiKey,
-		baseUrl: studioUrl
+		baseUrl: apiBaseUrl
 	});
 	const inferredRepo = options.project?.repo ?? await inferConnectedRepoFromCwd(cwd);
 	const projectInput = {
@@ -2060,11 +2097,10 @@ async function resolveConfiguredProject(options) {
 		rewriteIfNeeded: options.rewriteIfNeeded ?? true
 	});
 	if (!config.projectId) throw new Error("This is a local-only project. Run `statelyai init` to connect it to Stately Studio.");
-	const studioUrl = options.baseUrl ?? config.studioUrl;
 	return {
 		client: options.client ?? createStatelyClient({
 			apiKey: options.apiKey,
-			baseUrl: studioUrl
+			baseUrl: resolveApiBaseUrl(options.baseUrl ?? config.studioUrl)
 		}),
 		config,
 		configPath,
@@ -2080,13 +2116,14 @@ async function resolveConfiguredPullTargets(options) {
 	const linkedTargets = await discoverLinkedPullTargets(files);
 	const linkedMachineIds = new Set(linkedTargets.map((linkedTarget) => linkedTarget.machineId));
 	const project = await client.projects.get(config.projectId);
+	const machines = await client.projects.listMachines(config.projectId);
 	const skipped = [];
 	let remoteOnlyTargets = [];
 	try {
 		remoteOnlyTargets = await discoverRemoteProjectMachineTargets({
 			rootDir: path.dirname(configPath),
 			config,
-			project,
+			machines,
 			linkedMachineIds,
 			client
 		});
@@ -2098,6 +2135,7 @@ async function resolveConfiguredPullTargets(options) {
 		config,
 		configPath,
 		linkedTargets,
+		machines,
 		project,
 		remoteOnlyTargets,
 		skipped,
@@ -2167,11 +2205,13 @@ async function resolveProjectStatus(options = {}) {
 		};
 	}
 	const apiKey = options.apiKey ?? (options.client ? void 0 : (await resolveApiKey()).apiKey);
-	const project = await (options.client ?? createStatelyClient({
+	const client = options.client ?? createStatelyClient({
 		apiKey,
-		baseUrl: studioUrl
-	})).projects.get(config.projectId);
-	const remoteById = new Map(project.machines.flatMap((machine) => {
+		baseUrl: resolveApiBaseUrl(studioUrl)
+	});
+	const project = await client.projects.get(config.projectId);
+	const remoteMachines = await client.projects.listMachines(config.projectId);
+	const remoteById = new Map(remoteMachines.flatMap((machine) => {
 		const id = getProjectMachineId(machine);
 		return id ? [[id, machine]] : [];
 	}));
@@ -2195,7 +2235,7 @@ async function resolveProjectStatus(options = {}) {
 			url: buildMachineEditorUrl(studioUrl, config.projectId, machine.id)
 		};
 	});
-	for (const remote of project.machines) {
+	for (const remote of remoteMachines) {
 		const id = getProjectMachineId(remote);
 		if (!id || linkedIds.has(id)) continue;
 		machines.push({
@@ -2287,7 +2327,7 @@ async function createSemanticDiff(source, target, baseUrl) {
 		source,
 		target,
 		apiKey: (await resolveApiKey()).apiKey,
-		baseUrl: baseUrl ?? getDefaultBaseUrl()
+		baseUrl: resolveApiBaseUrl(baseUrl ?? getDefaultBaseUrl())
 	});
 }
 var PlanCommand = class PlanCommand extends ParsedSyncCommand {
@@ -2339,29 +2379,29 @@ var PullCommand = class PullCommand extends ParsedSyncCommand {
 		const apiKey = (await resolveApiKey()).apiKey;
 		if (!args.source) {
 			this.log(colorize("Resolving configured project and linked source files...", ANSI_CYAN));
-			const { config, linkedTargets, project, remoteOnlyTargets, skipped, rewriteStatus } = await resolveConfiguredPullTargets({
+			const { config, linkedTargets, machines, remoteOnlyTargets, skipped, rewriteStatus } = await resolveConfiguredPullTargets({
 				apiKey,
 				baseUrl: flags["base-url"],
 				configPath: flags.config
 			});
 			if (rewriteStatus.reason === "multiple-legacy-sources") this.log("Legacy statelyai.json detected with multiple sources entries. It cannot be rewritten automatically without losing information, so please update it manually.");
 			if (linkedTargets.length === 0 && remoteOnlyTargets.length === 0) {
-				if (project.machines.length > 0 && !config.newMachinesDir) {
+				if (machines.length > 0 && !config.newMachinesDir) {
 					this.log(formatSectionLabel("Skipped:", "warning"));
 					this.log(formatMissingNewMachineDirMessage({
 						config,
-						remoteMachineCount: project.machines.length
+						remoteMachineCount: machines.length
 					}));
 					return;
 				}
 				this.log("No linked local machine files or remote-only project machines were discovered.");
 				return;
 			}
-			if (project.machines.length > linkedTargets.length && !config.newMachinesDir) {
+			if (machines.length > linkedTargets.length && !config.newMachinesDir) {
 				this.log(formatSectionLabel("Skipped:", "warning"));
 				this.log(formatMissingNewMachineDirMessage({
 					config,
-					remoteMachineCount: project.machines.length - linkedTargets.length
+					remoteMachineCount: machines.length - linkedTargets.length
 				}));
 			}
 			this.log(colorize(`Processing ${linkedTargets.length} ${pluralize(linkedTargets.length, "linked file")}${remoteOnlyTargets.length > 0 ? ` and ${remoteOnlyTargets.length} ${pluralize(remoteOnlyTargets.length, "new remote machine")}` : ""}...`, ANSI_CYAN));
@@ -2379,7 +2419,7 @@ var PullCommand = class PullCommand extends ParsedSyncCommand {
 						source: linkedTarget.machineId,
 						target: targetPath,
 						apiKey,
-						baseUrl: flags["base-url"] ?? config.studioUrl
+						baseUrl: resolveApiBaseUrl(flags["base-url"] ?? config.studioUrl)
 					});
 					pulled.push(`${linkedTarget.file.relativePath}: ${formatSecondaryText(result.source.locator)}`);
 				} catch (error) {
@@ -2394,7 +2434,7 @@ var PullCommand = class PullCommand extends ParsedSyncCommand {
 						source: remoteTarget.machineId,
 						target: remoteTarget.filePath,
 						apiKey,
-						baseUrl: flags["base-url"] ?? config.studioUrl
+						baseUrl: resolveApiBaseUrl(flags["base-url"] ?? config.studioUrl)
 					});
 					created.push(`${remoteTarget.relativePath}: ${formatSecondaryText(result.source.locator)}`);
 				} catch (error) {
@@ -2422,7 +2462,7 @@ var PullCommand = class PullCommand extends ParsedSyncCommand {
 			source,
 			target,
 			apiKey,
-			baseUrl: flags["base-url"] ?? getDefaultBaseUrl()
+			baseUrl: resolveApiBaseUrl(flags["base-url"] ?? getDefaultBaseUrl())
 		});
 		this.log(`${formatSectionLabel("Pulled:", "success")} ${formatSecondaryText(result.source.locator)} -> ${result.outputPath}\nTarget: ${result.target.kind} (${result.target.format})`);
 	}
@@ -2515,7 +2555,7 @@ var PushCommand = class PushCommand extends Command {
 				result = await pushLocalMachineLinks({
 					source: file.filePath,
 					apiKey: resolvedApiKey.apiKey,
-					baseUrl: flags["base-url"] ?? config.studioUrl,
+					baseUrl: resolveApiBaseUrl(flags["base-url"] ?? config.studioUrl),
 					client,
 					project: { projectId: config.projectId },
 					xstateVersion: Math.max(5, file.source.xstateVersion ?? config.defaultXStateVersion)
@@ -2534,7 +2574,7 @@ var PushCommand = class PushCommand extends Command {
 					result = await pushLocalMachineLinks({
 						source: file.filePath,
 						apiKey: resolvedApiKey.apiKey,
-						baseUrl: flags["base-url"] ?? config.studioUrl,
+						baseUrl: resolveApiBaseUrl(flags["base-url"] ?? config.studioUrl),
 						client,
 						project: { projectId: config.projectId },
 						xstateVersion: Math.max(5, file.source.xstateVersion ?? config.defaultXStateVersion),

package/dist/index.d.mts

@@ -1,5 +1,5 @@
 import { Command } from "@oclif/core";
-import { ConnectedRepo, CreateProjectInput, OAuthAuthorizationServerMetadata, OAuthProtectedResourceMetadata, ProjectData, StudioClient } from "@statelyai/sdk";
+import { ConnectedRepo, CreateProjectInput, OAuthAuthorizationServerMetadata, OAuthProtectedResourceMetadata, ProjectData, ProjectMachineSummary, StudioClient } from "@statelyai/sdk";
 import { SyncPlan } from "@statelyai/sdk/sync";
 import * as _oclif_core_interfaces0 from "@oclif/core/interfaces";
 
@@ -100,6 +100,8 @@ interface ResolvedConfiguredPullTargets {
   config: StatelyProjectConfig;
   configPath: string;
   linkedTargets: LinkedPullTarget[];
+  /** Remote project machines, including names when the server supplies them. */
+  machines: ProjectMachineSummary[];
   project: ProjectData;
   remoteOnlyTargets: RemoteProjectMachineTarget[];
   skipped: string[];
@@ -195,7 +197,7 @@ declare function discoverLinkedPullTargets(files: DiscoveredSourceFile[]): Promi
 declare function discoverRemoteProjectMachineTargets(options: {
   rootDir: string;
   config: StatelyProjectConfig;
-  project: ProjectData;
+  machines: ProjectMachineSummary[];
   linkedMachineIds: Set<string>;
   client?: Pick<StudioClient, 'machines'>;
 }): Promise<RemoteProjectMachineTarget[]>;

package/dist/index.mjs

@@ -1,3 +1,3 @@
-import { C as scanProjectMachines, S as run, T as createStatelyProjectConfig, _ as isFileGitDirty, a as discoverMachinesInSource, b as resolveCredentialStatus, c as formatDiscoveredMachines, d as formatProjectStatus, f as formatStoredCredentialSource, g as initProject, h as inferInitProjectName, i as discoverLinkedPullTargets, l as formatMissingNewMachineDirMessage, m as getEnvCredential, n as buildOAuthLoginStart, o as discoverOAuthLogin, p as getEnvApiKey, r as classifyPushCandidates, s as discoverRemoteProjectMachineTargets, t as COMMANDS, u as formatPlanSummary, v as resolveApiKey, w as scanProjectSources, x as resolveProjectStatus, y as resolveConfiguredPullTargets } from "./cli-Duxz6wQc.mjs";
+import { C as scanProjectMachines, S as run, T as createStatelyProjectConfig, _ as isFileGitDirty, a as discoverMachinesInSource, b as resolveCredentialStatus, c as formatDiscoveredMachines, d as formatProjectStatus, f as formatStoredCredentialSource, g as initProject, h as inferInitProjectName, i as discoverLinkedPullTargets, l as formatMissingNewMachineDirMessage, m as getEnvCredential, n as buildOAuthLoginStart, o as discoverOAuthLogin, p as getEnvApiKey, r as classifyPushCandidates, s as discoverRemoteProjectMachineTargets, t as COMMANDS, u as formatPlanSummary, v as resolveApiKey, w as scanProjectSources, x as resolveProjectStatus, y as resolveConfiguredPullTargets } from "./cli-Dc8HDZ6q.mjs";
 
 export { COMMANDS, buildOAuthLoginStart, classifyPushCandidates, createStatelyProjectConfig, discoverLinkedPullTargets, discoverMachinesInSource, discoverOAuthLogin, discoverRemoteProjectMachineTargets, formatDiscoveredMachines, formatMissingNewMachineDirMessage, formatPlanSummary, formatProjectStatus, formatStoredCredentialSource, getEnvApiKey, getEnvCredential, inferInitProjectName, initProject, isFileGitDirty, resolveApiKey, resolveConfiguredPullTargets, resolveCredentialStatus, resolveProjectStatus, run, scanProjectMachines, scanProjectSources };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "statelyai",
-  "version": "0.7.11",
+  "version": "0.8.0",
   "description": "Command-line tools for Stately",
   "license": "MIT",
   "type": "module",
@@ -21,7 +21,7 @@
   },
   "dependencies": {
     "@oclif/core": "^4.10.3",
-    "@statelyai/sdk": "0.14.1"
+    "@statelyai/sdk": "0.15.0"
   },
   "devDependencies": {
     "tsdown": "0.21.0-beta.2",