@statelyai/sdk 0.5.1 → 0.6.1

package/dist/assetStorage.mjs

@@ -0,0 +1,99 @@
+//#region src/assetStorage.ts
+function sanitizeFileName(name) {
+	return name.replace(/[^A-Za-z0-9._-]+/g, "-").replace(/^-+|-+$/g, "");
+}
+function defaultObjectKey({ file, stateNodeId }) {
+	const fileName = sanitizeFileName(file.name) || "asset";
+	return `${stateNodeId}/${crypto.randomUUID()}-${fileName}`;
+}
+function createProjectObjectKey(projectVersionId) {
+	return ({ file }) => {
+		const fileName = sanitizeFileName(file.name) || "asset";
+		return `${projectVersionId}/${crypto.randomUUID()}-${fileName}`;
+	};
+}
+function joinUrl(baseUrl, key) {
+	return `${baseUrl.replace(/\/+$/, "")}/${key.split("/").map(encodeURIComponent).join("/")}`;
+}
+async function uploadToTarget(target, file) {
+	if (target.method === "POST" || target.fields) {
+		const formData = new FormData();
+		Object.entries(target.fields ?? {}).forEach(([name, value]) => {
+			formData.append(name, value);
+		});
+		formData.append("file", file);
+		const response = await fetch(target.uploadUrl, {
+			method: "POST",
+			body: formData
+		});
+		if (!response.ok) throw new Error(`Asset upload failed with ${response.status}`);
+		return;
+	}
+	const response = await fetch(target.uploadUrl, {
+		method: target.method ?? "PUT",
+		headers: {
+			"Content-Type": file.type || "application/octet-stream",
+			...target.headers
+		},
+		body: file
+	});
+	if (!response.ok) throw new Error(`Asset upload failed with ${response.status}`);
+}
+function createS3AssetUploadAdapter(options) {
+	return {
+		accept: options.accept,
+		maxFileSize: options.maxFileSize,
+		async upload(request) {
+			const key = await (options.key ?? defaultObjectKey)(request);
+			const target = await options.getUploadTarget({
+				...request,
+				key,
+				contentType: request.file.type || "application/octet-stream",
+				bucket: options.bucket
+			});
+			await uploadToTarget(target, request.file);
+			const url = target.publicUrl ?? (options.publicBaseUrl ? joinUrl(options.publicBaseUrl, key) : void 0);
+			if (!url) throw new Error("S3 asset upload adapter requires a publicUrl or publicBaseUrl");
+			return {
+				url,
+				name: request.file.name,
+				metadata: {
+					bucket: options.bucket,
+					key
+				}
+			};
+		}
+	};
+}
+function createSupabaseAssetUploadAdapter(options) {
+	const bucket = options.bucket ?? "assets";
+	return {
+		accept: options.accept,
+		maxFileSize: options.maxFileSize,
+		async upload(request) {
+			const storage = options.client.storage.from(bucket);
+			const key = await (options.key ?? (options.projectVersionId ? createProjectObjectKey(options.projectVersionId) : defaultObjectKey))(request);
+			const { data, error } = await storage.upload(key, request.file, {
+				cacheControl: options.cacheControl,
+				contentType: request.file.type || "application/octet-stream",
+				upsert: options.upsert
+			});
+			if (error) throw new Error(error.message);
+			if (!data?.path) throw new Error("Supabase asset upload did not return a path");
+			const publicUrl = storage.getPublicUrl?.(data.path)?.data.publicUrl ?? (options.publicBaseUrl ? joinUrl(options.publicBaseUrl, data.path) : void 0);
+			if (!publicUrl) throw new Error("Supabase asset upload adapter requires getPublicUrl or publicBaseUrl");
+			return {
+				url: publicUrl,
+				name: request.file.name,
+				metadata: {
+					bucket,
+					path: data.path,
+					key: data.path
+				}
+			};
+		}
+	};
+}
+
+//#endregion
+export { createS3AssetUploadAdapter, createSupabaseAssetUploadAdapter };

package/dist/cli.d.mts

@@ -1,9 +1,60 @@
-import "./graph-BfezxFKJ.mjs";
+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";
 
 //#region src/cli.d.ts
+interface StatelySourceConfig {
+  include: string[];
+  exclude?: string[];
+  format: 'xstate' | 'redux' | 'zustand' | 'xgraph' | 'digraph' | 'mermaid' | 'scxml' | 'json' | 'asl-json' | 'asl-yaml' | 'auto';
+  xstateVersion?: number;
+}
+interface StatelyProjectConfig {
+  $schema: string;
+  version: string;
+  projectId: string;
+  studioUrl: string;
+  defaultXStateVersion: number;
+  sources: StatelySourceConfig[];
+}
+interface InitProjectOptions {
+  apiKey: string;
+  baseUrl?: string;
+  cwd?: string;
+  client?: StudioClient;
+  configPath?: string;
+  defaultXStateVersion?: number;
+  force?: boolean;
+  project?: Partial<CreateProjectInput>;
+}
+interface InitProjectResult {
+  config: StatelyProjectConfig;
+  configPath: string;
+  project: ProjectData;
+}
+declare function createStatelyProjectConfig(options: {
+  projectId: string;
+  studioUrl: string;
+  defaultXStateVersion?: number;
+}): StatelyProjectConfig;
+type ApiKeyResolution = {
+  apiKey: string;
+  detail: string;
+  source: 'env' | 'flag' | 'stored';
+} | {
+  apiKey?: undefined;
+  detail?: undefined;
+  source: 'missing';
+};
+declare function getEnvApiKey(): {
+  apiKey: string;
+  variable: 'NEXT_PUBLIC_STATELY_API_KEY' | 'STATELY_API_KEY';
+} | undefined;
+declare function resolveApiKey(explicitApiKey?: string): Promise<ApiKeyResolution>;
+declare function inferInitProjectName(cwd: string, repo?: ConnectedRepo): string;
+declare function initProject(options: InitProjectOptions): Promise<InitProjectResult>;
 declare function formatPlanSummary(plan: SyncPlan): string;
 declare abstract class BaseSyncCommand extends Command {
   static enableJsonFlag: boolean;
@@ -71,12 +122,59 @@ declare class OpenCommand extends Command {
   };
   run(): Promise<void>;
 }
+declare class InitCommand extends Command {
+  static enableJsonFlag: boolean;
+  static summary: string;
+  static description: string;
+  static flags: {
+    help: _oclif_core_interfaces0.BooleanFlag<void>;
+    'api-key': _oclif_core_interfaces0.OptionFlag<string | undefined, _oclif_core_interfaces0.CustomOptions>;
+    'base-url': _oclif_core_interfaces0.OptionFlag<string | undefined, _oclif_core_interfaces0.CustomOptions>;
+    name: _oclif_core_interfaces0.OptionFlag<string | undefined, _oclif_core_interfaces0.CustomOptions>;
+    visibility: _oclif_core_interfaces0.OptionFlag<string, _oclif_core_interfaces0.CustomOptions>;
+    force: _oclif_core_interfaces0.BooleanFlag<boolean>;
+  };
+  run(): Promise<void>;
+}
+declare class LoginCommand extends Command {
+  static enableJsonFlag: boolean;
+  static summary: string;
+  static description: string;
+  static flags: {
+    help: _oclif_core_interfaces0.BooleanFlag<void>;
+    'api-key': _oclif_core_interfaces0.OptionFlag<string | undefined, _oclif_core_interfaces0.CustomOptions>;
+    stdin: _oclif_core_interfaces0.BooleanFlag<boolean>;
+  };
+  run(): Promise<void>;
+}
+declare class LogoutCommand extends Command {
+  static enableJsonFlag: boolean;
+  static summary: string;
+  static description: string;
+  static flags: {
+    help: _oclif_core_interfaces0.BooleanFlag<void>;
+  };
+  run(): Promise<void>;
+}
+declare class AuthStatusCommand extends Command {
+  static enableJsonFlag: boolean;
+  static summary: string;
+  static description: string;
+  static flags: {
+    help: _oclif_core_interfaces0.BooleanFlag<void>;
+  };
+  run(): Promise<void>;
+}
 declare const COMMANDS: {
   plan: typeof PlanCommand;
   diff: typeof DiffCommand;
   pull: typeof PullCommand;
   open: typeof OpenCommand;
+  init: typeof InitCommand;
+  login: typeof LoginCommand;
+  logout: typeof LogoutCommand;
+  'auth:status': typeof AuthStatusCommand;
 };
 declare function run(argv?: string[], entryUrl?: string): Promise<void>;
 //#endregion
-export { COMMANDS, formatPlanSummary, run };
+export { ApiKeyResolution, COMMANDS, InitProjectOptions, InitProjectResult, StatelyProjectConfig, StatelySourceConfig, createStatelyProjectConfig, formatPlanSummary, getEnvApiKey, inferInitProjectName, initProject, resolveApiKey, run };