@statelyai/sdk 0.14.2 → 0.15.0

package/dist/studio.d.mts

@@ -1,125 +1,2 @@
-import { n as StatelyCredential, t as StatelyAuthMode } from "./auth-D9-iLi-S.mjs";
-
-//#region src/studio.d.ts
-interface StudioClientOptions {
-  baseUrl?: string;
-  credential?: StatelyCredential;
-  /** @deprecated Use credential: { type: 'api_key', token }. */
-  apiKey?: string;
-  authMode?: StatelyAuthMode;
-  fetch?: typeof fetch;
-}
-interface VerifyApiKeyResponse {
-  valid: boolean;
-}
-type ProjectVisibility = 'Public' | 'Private' | 'Unlisted';
-type RepoType = 'GITHUB';
-interface ConnectedRepo {
-  id?: string;
-  type?: RepoType;
-  url: string;
-  owner: string;
-  repo: string;
-  branch: string;
-  treeSha: string;
-  autoSync?: boolean;
-  pathForNewFiles?: string;
-  selectedPaths?: string[];
-  lastSyncedAt?: string;
-}
-interface ProjectMachine {
-  machineId: string;
-  name: string;
-}
-interface ProjectData {
-  projectId: string;
-  machines: ProjectMachine[];
-  id?: string;
-  name?: string;
-  description?: string | null;
-  keywords?: string[];
-  visibility?: ProjectVisibility;
-  projectVersionId?: string;
-  connectedRepo?: ConnectedRepo | null;
-}
-interface ExtractedMachine {
-  id?: string;
-  config: Record<string, unknown>;
-  setupConfig?: Record<string, unknown>;
-  implementations?: Record<string, unknown>;
-  _type: 'setup.createMachine' | 'createMachine';
-}
-interface ExtractMachinesResponse {
-  machines: ExtractedMachine[];
-  error?: string;
-}
-interface GetMachineOptions {
-  version?: string;
-}
-interface CreateProjectInput {
-  name: string;
-  visibility: ProjectVisibility;
-  description?: string;
-  keywords?: string[];
-  repo?: ConnectedRepo;
-}
-interface EnsureProjectInput extends CreateProjectInput {
-  matchConnectedRepo?: boolean;
-}
-type XStateVersion = 4 | 5;
-type CreateMachineTemplate = 'blank' | 'starter';
-interface CreateMachineFromDefinitionInput<TDefinition = Record<string, unknown>> {
-  projectVersionId: string;
-  definition: TDefinition;
-  xstateVersion?: XStateVersion;
-}
-interface CreateMachineFromTemplateInput {
-  projectVersionId: string;
-  name: string;
-  template: CreateMachineTemplate;
-  xstateVersion?: XStateVersion;
-}
-type CreateMachineInput<TDefinition = Record<string, unknown>> = CreateMachineFromDefinitionInput<TDefinition> | CreateMachineFromTemplateInput;
-interface UpdateMachineInput<TDefinition = Record<string, unknown>> {
-  id: string;
-  name?: string;
-  definition?: TDefinition;
-}
-interface StudioMachineRecord<TDefinition = Record<string, unknown>> {
-  id: string;
-  name: string;
-  definition: TDefinition;
-  projectVersionId?: string;
-  [key: string]: unknown;
-}
-declare class StudioApiError extends Error {
-  readonly status: number;
-  constructor(message: string, status: number);
-}
-interface StudioClient {
-  auth: {
-    verify(credential?: StatelyCredential | string): Promise<VerifyApiKeyResponse>;
-  };
-  projects: {
-    list(): Promise<ProjectData[]>;
-    create(input: CreateProjectInput): Promise<ProjectData>;
-    ensure(input: EnsureProjectInput): Promise<ProjectData>;
-    get(projectId: string): Promise<ProjectData>;
-  };
-  machines: {
-    create<TMachine = Record<string, unknown>>(input: CreateMachineInput<TMachine>): Promise<StudioMachineRecord<TMachine>>;
-    createMany<TMachine = Record<string, unknown>>(input: CreateMachineInput<TMachine>): Promise<Array<StudioMachineRecord<TMachine>>>;
-    update<TMachine = Record<string, unknown>>(input: UpdateMachineInput<TMachine>): Promise<StudioMachineRecord<TMachine>>;
-    get<TMachine = Record<string, unknown>>(machineId: string, options?: GetMachineOptions): Promise<TMachine>;
-  };
-  code: {
-    extractMachines(code: string, options?: {
-      credential?: StatelyCredential | null; /** @deprecated Use credential. */
-      apiKey?: string | null;
-      authMode?: StatelyAuthMode;
-    }): Promise<ExtractMachinesResponse>;
-  };
-}
-declare function createStatelyClient(options?: StudioClientOptions): StudioClient;
-//#endregion
-export { ConnectedRepo, CreateMachineFromDefinitionInput, CreateMachineFromTemplateInput, CreateMachineInput, CreateMachineTemplate, CreateProjectInput, EnsureProjectInput, ExtractMachinesResponse, ExtractedMachine, GetMachineOptions, ProjectData, ProjectMachine, ProjectVisibility, RepoType, StudioApiError, StudioClient, StudioClientOptions, StudioMachineRecord, UpdateMachineInput, VerifyApiKeyResponse, XStateVersion, createStatelyClient };
+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-Da5pyxv6.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,172 +1,3 @@
-import { createAuthorizationHeader, getCredentialToken } from "./auth.mjs";
+import { n as StudioApiError, r as createStatelyClient, t as DEFAULT_STATELY_BASE_URL } from "./studio-txdyJHD7.mjs";
 
-//#region src/studio.ts
-var StudioApiError = class extends Error {
-	status;
-	constructor(message, status) {
-		super(message);
-		this.name = "StudioApiError";
-		this.status = status;
-	}
-};
-function getFetch(fetchImpl) {
-	const resolvedFetch = fetchImpl ?? globalThis.fetch;
-	if (!resolvedFetch) throw new Error("No fetch implementation available. Pass one via createStatelyClient({ fetch }).");
-	return resolvedFetch;
-}
-function joinApiUrl(baseUrl, path) {
-	return `${baseUrl.replace(/\/+$/, "")}/registry/api/v1${path}`;
-}
-async function parseJson(response) {
-	if (!response.headers.get("content-type")?.includes("application/json")) return null;
-	return response.json().catch(() => null);
-}
-function getErrorMessage(data, status) {
-	if (typeof data === "object" && data !== null) {
-		if ("error" in data && typeof data.error === "string") return data.error;
-		if ("error" in data) {
-			const error = data.error;
-			if (typeof error === "object" && error !== null && "json" in error) {
-				const errorJson = error.json;
-				if (typeof errorJson === "object" && errorJson !== null && "message" in errorJson && typeof errorJson.message === "string") return errorJson.message;
-			}
-		}
-	}
-	if (Array.isArray(data)) for (const item of data) {
-		const message = getErrorMessage(item, status);
-		if (message !== `HTTP ${status}`) return message;
-	}
-	return `HTTP ${status}`;
-}
-function unwrapResponseData(data) {
-	if (typeof data === "object" && data !== null && "data" in data) return data.data;
-	return data;
-}
-function normalizeProjectMachine(machine) {
-	if (typeof machine !== "object" || machine === null) return null;
-	const candidate = machine;
-	const machineId = typeof candidate.machineId === "string" ? candidate.machineId : typeof candidate.id === "string" ? candidate.id : void 0;
-	if (!machineId) return null;
-	return {
-		machineId,
-		name: typeof candidate.name === "string" && candidate.name.trim().length > 0 ? candidate.name : typeof candidate.key === "string" && candidate.key.trim().length > 0 ? candidate.key : machineId
-	};
-}
-function normalizeProjectData(project) {
-	const machines = Array.isArray(project.machines) ? project.machines.map((machine) => normalizeProjectMachine(machine)).filter((machine) => machine != null) : [];
-	if (project.projectVersionId) return {
-		...project,
-		machines
-	};
-	if (project.projectId && project.id) return {
-		...project,
-		machines,
-		projectVersionId: project.id
-	};
-	return {
-		...project,
-		machines
-	};
-}
-function normalizeRepoUrl(url) {
-	if (!url) return;
-	return url.replace(/\.git$/i, "").replace(/\/+$/, "");
-}
-function connectedReposMatch(left, right) {
-	if (!left || !right) return false;
-	const normalizedLeft = normalizeRepoUrl(left.url);
-	const normalizedRight = normalizeRepoUrl(right.url);
-	return normalizedLeft != null && normalizedRight != null && normalizedLeft === normalizedRight && left.branch === right.branch || left.owner === right.owner && left.repo === right.repo && left.branch === right.branch;
-}
-function createStatelyClient(options = {}) {
-	const baseUrl = options.baseUrl ?? "https://stately.ai";
-	const fetchImpl = getFetch(options.fetch);
-	const defaultCredential = options.credential ?? (options.apiKey ? {
-		type: "api_key",
-		token: options.apiKey
-	} : void 0);
-	const defaultAuthMode = options.authMode ?? "auto";
-	async function request(path, init = {}, credentialOverride, authModeOverride) {
-		const headers = new Headers(init.headers);
-		const authMode = authModeOverride ?? defaultAuthMode;
-		const credential = credentialOverride ?? defaultCredential;
-		if (authMode !== "none") {
-			const token = getCredentialToken(credential);
-			if (authMode === "bearer" && (!token || !credential)) throw new StudioApiError("No Stately credential configured. Pass createStatelyClient({ credential }) or use authMode: \"auto\" to let the server decide whether authentication is required.", 401);
-			if (token && credential) headers.set("Authorization", createAuthorizationHeader(credential));
-		}
-		const response = await fetchImpl(joinApiUrl(baseUrl, path), {
-			...init,
-			headers
-		});
-		const data = await parseJson(response);
-		if (!response.ok) throw new StudioApiError(getErrorMessage(data, response.status), response.status);
-		return unwrapResponseData(data);
-	}
-	return {
-		auth: { verify(credential) {
-			return request("/verify", { method: "GET" }, credential);
-		} },
-		projects: {
-			list() {
-				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) {
-					const existingProject = (await this.list()).find((project) => connectedReposMatch(project.connectedRepo, input.repo));
-					if (existingProject) return existingProject;
-				}
-				return this.create(input);
-			},
-			get(projectId) {
-				return request(`/projects/${encodeURIComponent(projectId)}`, { method: "GET" }).then(normalizeProjectData);
-			}
-		},
-		machines: {
-			async create(input) {
-				return request("/machines/create", {
-					method: "POST",
-					headers: { "Content-Type": "application/json" },
-					body: JSON.stringify(input)
-				});
-			},
-			async createMany(input) {
-				return [await this.create(input)];
-			},
-			update(input) {
-				return request(`/machines/${encodeURIComponent(input.id)}`, {
-					method: "PATCH",
-					headers: { "Content-Type": "application/json" },
-					body: JSON.stringify(input)
-				});
-			},
-			get(machineId, getOptions = {}) {
-				const search = new URLSearchParams();
-				if (getOptions.version) search.set("version", getOptions.version);
-				const suffix = search.size > 0 ? `?${search.toString()}` : "";
-				return request(`/machines/${encodeURIComponent(machineId)}${suffix}`, { method: "GET" });
-			}
-		},
-		code: { extractMachines(code, extractOptions = {}) {
-			const credential = extractOptions.credential ?? (extractOptions.apiKey ? {
-				type: "api_key",
-				token: extractOptions.apiKey
-			} : void 0);
-			return request("/code", {
-				method: "POST",
-				headers: { "Content-Type": "application/json" },
-				body: JSON.stringify({ code })
-			}, credential, extractOptions.authMode);
-		} }
-	};
-}
-
-//#endregion
-export { StudioApiError, createStatelyClient };
+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-3oSqiY4N.mjs";
-import { CreateProjectInput, ProjectData, StudioClient, StudioMachineRecord, XStateVersion } from "./studio.mjs";
+import { b as DigraphConfig, i as StatelyGraph } from "./graph-DuOeLGvh.mjs";
+import { C as StudioMachineRecord, L as XStateVersion, g as ProjectData, o as CreateProjectInput, x as StudioClient } from "./studio-Da5pyxv6.mjs";
 import { GraphDiff } from "@statelyai/graph";
 
 //#region src/sync.d.ts

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-CO36Ks-i.mjs";
+import { r as createStatelyClient } from "./studio-txdyJHD7.mjs";
+import { i as INLINE_EXPRESSION_DIRECTIVE_FIELDS, m as xstateSourceToConfig, n as getStatelyPragma, p as serializeJS, r as upsertStatelyPragma, s as detectXStateSourceProfile, t as findStatelyPragmaAttachments, u as graphToXStateTS } from "./statelyPragma-Bm9O4XV6.mjs";
 import { fromStudioMachine, toStudioMachine } from "./graph.mjs";
 import * as ts$1 from "typescript";
 import ts from "typescript";
@@ -1456,16 +1456,16 @@ function inferXStateTargetLanguage(targetPath) {
 	return /\.(?:c|m)?jsx?$/i.test(targetPath) ? "javascript" : "typescript";
 }
 async function resolveRemoteMachine(machineId, baseUrl, kind, locator, options) {
-	const machineResponse = await (options.client ?? createStatelyClient({
+	const digraph = (await (options.client ?? createStatelyClient({
 		apiKey: options.apiKey,
 		baseUrl,
 		fetch: options.fetch
-	})).machines.get(machineId);
+	})).machines.get(machineId)).definition;
 	return {
 		kind,
 		locator,
 		format: "digraph",
-		graph: fromStudioMachine(machineResponse && typeof machineResponse === "object" && "definition" in machineResponse && machineResponse.definition ? machineResponse.definition : machineResponse),
+		graph: fromStudioMachine(digraph),
 		remoteMachineId: machineId
 	};
 }
@@ -1534,33 +1534,22 @@ function inferDefaultProjectName(sourcePath, repo) {
 	return path.basename(sourcePath, path.extname(sourcePath));
 }
 async function resolvePushProject(client, sourcePath, options) {
-	async function withResolvedProjectVersionId(project, explicitProjectVersionId) {
-		if (project.projectVersionId) return project;
-		if (explicitProjectVersionId) return {
-			...project,
-			projectVersionId: explicitProjectVersionId
-		};
-		const matchedProject = (await client.projects.list()).find((candidate) => {
-			return candidate.projectId === project.projectId || candidate.id != null && project.id != null && candidate.id === project.id;
-		});
-		if (matchedProject?.projectVersionId) return {
-			...project,
-			projectVersionId: matchedProject.projectVersionId
-		};
-		return project;
-	}
 	const explicitProject = options.project;
-	if (explicitProject?.projectVersionId) return withResolvedProjectVersionId(await client.projects.get(explicitProject.projectVersionId), explicitProject.projectVersionId);
-	if (explicitProject?.projectId) return withResolvedProjectVersionId(await client.projects.get(explicitProject.projectId));
+	if (explicitProject?.projectId) return client.projects.get(explicitProject.projectId);
+	if (explicitProject?.projectVersionId) {
+		const matchedProject = (await client.projects.list()).find((candidate) => candidate.projectVersionId === explicitProject.projectVersionId);
+		if (!matchedProject) throw new Error(`No project found for projectVersionId "${explicitProject.projectVersionId}".`);
+		return client.projects.get(matchedProject.projectId);
+	}
 	const inferredRepo = explicitProject?.repo ?? await inferConnectedRepo(sourcePath, options.cwd);
 	const projectInput = {
 		name: explicitProject?.name ?? inferDefaultProjectName(sourcePath, inferredRepo),
-		visibility: explicitProject?.visibility ?? "Private",
+		visibility: explicitProject?.visibility ?? "private",
 		...explicitProject?.description ? { description: explicitProject.description } : {},
 		...explicitProject?.keywords ? { keywords: explicitProject.keywords } : {},
 		...inferredRepo ? { repo: inferredRepo } : {}
 	};
-	return withResolvedProjectVersionId(await client.projects.ensure(projectInput));
+	return client.projects.ensure(projectInput);
 }
 async function pushSync(options) {
 	const client = options.client ?? createStatelyClient({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@statelyai/sdk",
-  "version": "0.14.2",
+  "version": "0.15.0",
   "license": "MIT",
   "files": [
     "dist",
@@ -81,12 +81,13 @@
     "tsdown": "0.21.0-beta.2",
     "vitest": "^3.2.4",
     "ws": "^8.19.0",
-    "@statelyai/graph-tools": "0.0.7"
+    "@statelyai/graph-tools": "0.0.7",
+    "@statelyai/api-contract": "0.0.1"
   },
   "scripts": {
     "build": "tsdown",
     "test": "vitest run",
-    "test:live": "vitest run src/studio.live.integration.test.ts",
+    "test:live": "vitest run --config vitest.live.config.ts",
     "test:watch": "vitest"
   }
 }