@usestatemachines/cli 0.0.0-stage → 0.1.0

package/dist/text.js

@@ -0,0 +1,19 @@
+import { stripVTControlCharacters } from 'node:util';
+export function untrustedText(value) {
+    return stripVTControlCharacters(value).replace(/[\p{Cc}\p{Cf}\p{Zl}\p{Zp}]/gu, '');
+}
+export function untrustedResult(value) {
+    if (typeof value === 'string') {
+        return untrustedText(value);
+    }
+    if (value === null || typeof value !== 'object') {
+        return value;
+    }
+    if (Array.isArray(value)) {
+        return value.map(untrustedResult);
+    }
+    return Object.fromEntries(Object.entries(value).map(([key, item]) => [
+        untrustedText(key),
+        untrustedResult(item),
+    ]));
+}

package/dist/update.d.ts

@@ -0,0 +1,22 @@
+import type { Presentation } from './context-types.js';
+import type { EffectOptions, Io } from './io-types.js';
+export interface LatestVersion {
+    readonly current: string;
+    readonly latest: string | null;
+    readonly newer: boolean;
+    readonly command: string;
+}
+export declare function updateCommand(io: Io): string;
+export declare function checkLatest(input: {
+    io: Io;
+    version: string;
+    options?: EffectOptions;
+}): Promise<LatestVersion>;
+export declare function notifyUpdate(input: {
+    io: Io;
+    presentation: Presentation;
+    version: string;
+    agent: {
+        readonly name: string;
+    } | null;
+}): Promise<void>;

package/dist/update.js

@@ -0,0 +1,126 @@
+import { join } from 'node:path';
+import { z } from 'zod';
+import { withinDeadline } from './api-internal.js';
+import { CliError } from './errors.js';
+const versionSchema = z
+    .string()
+    .regex(/^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?(?:\+[0-9A-Za-z.-]+)?$/);
+const cacheSchema = z.strictObject({
+    version: z.literal(1),
+    checkedAt: z.number().finite(),
+    latest: versionSchema.nullable(),
+});
+function newerVersion(latest, current) {
+    const target = latest.split(/[.-]/).slice(0, 3).map(Number);
+    const present = current.split(/[.-]/).slice(0, 3).map(Number);
+    for (let index = 0; index < 3; index++) {
+        const next = target[index] ?? 0;
+        const previous = present[index] ?? 0;
+        if (next !== previous) {
+            return next > previous;
+        }
+    }
+    return current.includes('-') && !latest.includes('-');
+}
+export function updateCommand(io) {
+    return io.host.environment.npm_command === 'exec' ||
+        /npx(?:-cli)?(?:\.js)?$/.test(io.host.environment.npm_execpath ?? '')
+        ? 'npx @usestatemachines/cli@latest'
+        : 'npm install --global @usestatemachines/cli@latest';
+}
+export async function checkLatest(input) {
+    const { io, version } = input;
+    const options = {
+        signal: input.options?.signal ?? io.signal,
+        deadline: Math.min(input.options?.deadline ?? Infinity, io.now() + 2000),
+    };
+    const path = join(io.host.configHome, 'update.json');
+    const make = (latest) => ({
+        current: version,
+        latest,
+        newer: latest !== null && newerVersion(latest, version),
+        command: updateCommand(io),
+    });
+    return withinDeadline(io, options, async (signal) => {
+        const effects = { ...options, signal };
+        const state = await io.files.withLock(join(io.host.configHome, '.update.lock'), effects, async () => {
+            const text = await io.files.read(path, effects);
+            let cached = null;
+            if (text !== null) {
+                try {
+                    const result = cacheSchema.safeParse(JSON.parse(text));
+                    if (result.success) {
+                        cached = result.data;
+                    }
+                }
+                catch { }
+            }
+            if (cached !== null &&
+                cached.checkedAt <= io.now() &&
+                io.now() - cached.checkedAt < 24 * 60 * 60 * 1000) {
+                return { kind: 'cached', latest: cached.latest };
+            }
+            const checkedAt = io.now();
+            await io.files.atomicWrite(path, JSON.stringify({ version: 1, checkedAt, latest: null }), 'private', effects);
+            return { kind: 'fetch', checkedAt };
+        });
+        if (state.kind === 'cached') {
+            return make(state.latest);
+        }
+        const environment = io.host.environment;
+        const lease = await io.http({
+            http: environment.HTTP_PROXY ?? environment.http_proxy ?? null,
+            https: environment.HTTPS_PROXY ?? environment.https_proxy ?? null,
+            noProxy: environment.NO_PROXY ?? environment.no_proxy ?? null,
+        }, effects);
+        try {
+            const response = await lease.fetch('https://registry.npmjs.org/@usestatemachines%2fcli/latest', { headers: { accept: 'application/json' }, redirect: 'manual', signal });
+            if (!response.ok) {
+                throw new CliError('cli.network');
+            }
+            const parsed = z
+                .object({ version: versionSchema })
+                .safeParse(await response.json());
+            if (!parsed.success) {
+                throw new CliError('cli.invalid_response');
+            }
+            await io.files.withLock(join(io.host.configHome, '.update.lock'), effects, async () => {
+                const text = await io.files.read(path, effects);
+                if (text === null) {
+                    return;
+                }
+                const cached = cacheSchema.safeParse(JSON.parse(text));
+                if (cached.success && cached.data.checkedAt === state.checkedAt) {
+                    await io.files.atomicWrite(path, JSON.stringify({
+                        version: 1,
+                        checkedAt: state.checkedAt,
+                        latest: parsed.data.version,
+                    }), 'private', effects);
+                }
+            });
+            return make(parsed.data.version);
+        }
+        finally {
+            await lease.close();
+        }
+    });
+}
+export async function notifyUpdate(input) {
+    const env = input.io.host.environment;
+    if (input.presentation.mode !== 'interactive' ||
+        input.agent !== null ||
+        env.CI !== undefined ||
+        env.STATEMACHINES_NO_UPDATE_NOTIFIER === '1' ||
+        env.NO_UPDATE_NOTIFIER !== undefined ||
+        env.npm_command === 'exec' ||
+        /npx/.test(env.npm_execpath ?? '')) {
+        return;
+    }
+    try {
+        const latest = await checkLatest(input);
+        if (latest.newer) {
+            await input.io.stderr.write(`State Machines CLI ${latest.latest} is available. Update with ${latest.command}.\n`);
+        }
+    }
+    catch { }
+}

package/dist/version.d.ts

@@ -0,0 +1,2 @@
+export declare const cliVersion = "0.1.0";
+export declare const sdkVersion = "0.8.0";

package/dist/version.js

@@ -0,0 +1,2 @@
+export const cliVersion = '0.1.0';
+export const sdkVersion = '0.8.0';

package/package.json

@@ -1,6 +1,55 @@
 {
   "name": "@usestatemachines/cli",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "Command-line client for State Machines",
+  "license": "MIT",
+  "homepage": "https://usestatemachines.com",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/statehq/state.git",
+    "directory": "packages/cli"
+  },
+  "author": "State Machines",
+  "type": "module",
+  "engines": {
+    "node": ">=20.20"
+  },
+  "bin": {
+    "statemachines": "dist/bin.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "@clack/prompts": "1.8.1",
+    "@usestatemachines/sdk": "0.8.0",
+    "@vercel/detect-agent": "1.2.5",
+    "cross-spawn": "7.0.6",
+    "open": "11.0.4",
+    "undici": "7.30.0",
+    "zod": "4.6.5"
+  },
+  "optionalDependencies": {
+    "@napi-rs/keyring": "2.1.1"
+  },
+  "devDependencies": {
+    "@types/cross-spawn": "6.0.6",
+    "@types/node": "24.13.4",
+    "esbuild": "0.28.2",
+    "msw": "2.15.0",
+    "typescript": "7.0.2",
+    "vitest": "5.0.1"
+  },
+  "scripts": {
+    "build": "node scripts/check-node.mjs && node scripts/build-version.mjs && node scripts/build-contracts.mjs && node scripts/build-agents.mjs && tsc --project tsconfig.build.json && node scripts/build-contracts.mjs --copy-runtime",
+    "typecheck": "node scripts/check-node.mjs && tsc --project tsconfig.json",
+    "lint": "node scripts/check-node.mjs && node scripts/build-version.mjs --check && node scripts/build-contracts.mjs --check && node scripts/build-agents.mjs --check && biome ci . && pnpm --dir ../.. exec eslint --config eslint.style.config.mjs packages/cli/src",
+    "startup:check": "node scripts/check-node.mjs && node scripts/check-startup.mjs",
+    "pack:check": "node scripts/check-node.mjs && node scripts/check-pack.mjs",
+    "snapshots:check": "node scripts/check-node.mjs && node scripts/check-snapshots.mjs",
+    "test": "node scripts/check-node.mjs && node scripts/test.mjs",
+    "test:local-stack": "node scripts/check-node.mjs && node scripts/check-local-stack.mjs"
+  }
 }