@usestatemachines/cli 0.0.0-stage → 0.1.0

package/dist/io-types.d.ts

@@ -0,0 +1,127 @@
+export interface EffectOptions {
+    readonly signal: AbortSignal;
+    readonly deadline: number | null;
+}
+export interface ProcessOwner {
+    readonly hostname: string;
+    readonly pid: number;
+}
+export interface HostSnapshot {
+    readonly environment: Readonly<Record<string, string | undefined>>;
+    readonly terminal: 'both' | 'stdin' | 'stdout' | 'none';
+    readonly platform: 'linux' | 'darwin' | 'win32';
+    readonly cwd: string;
+    readonly home: string;
+    readonly configHome: string;
+    readonly nodeVersion: string;
+    readonly owner: ProcessOwner;
+}
+export interface OutputStream {
+    write(value: string | Uint8Array): Promise<void>;
+}
+export type FileInspection = {
+    readonly kind: 'missing';
+} | {
+    readonly kind: 'file' | 'directory' | 'symlink' | 'other';
+    readonly mode: number;
+};
+export interface SafeFiles {
+    read(path: string, options: EffectOptions): Promise<string | null>;
+    readBytes(path: string, options: EffectOptions): Promise<Uint8Array | null>;
+    atomicWrite(path: string, content: string, privacy: 'private' | 'private-file' | 'public', options: EffectOptions): Promise<void>;
+    createIfMissing(path: string, content: string, privacy: 'private' | 'private-file' | 'public', options: EffectOptions): Promise<boolean>;
+    remove(path: string, options: EffectOptions): Promise<void>;
+    inspect(path: string, options: EffectOptions): Promise<FileInspection>;
+    withLock<Value>(path: string, options: EffectOptions, action: () => Promise<Value>): Promise<Value>;
+    findRepositoryRoot(from: string, options: EffectOptions): Promise<string | null>;
+}
+export interface ProxyConfig {
+    readonly http: string | null;
+    readonly https: string | null;
+    readonly noProxy: string | null;
+}
+export interface HttpLease {
+    readonly fetch: typeof fetch;
+    close(): Promise<void>;
+}
+export type KeychainRequest = {
+    readonly kind: 'probe';
+} | {
+    readonly kind: 'get' | 'delete';
+    readonly service: string;
+    readonly account: string;
+} | {
+    readonly kind: 'set';
+    readonly service: string;
+    readonly account: string;
+    readonly value: string;
+};
+export type KeychainResult = {
+    readonly kind: 'value';
+    readonly value: string;
+} | {
+    readonly kind: 'available' | 'missing' | 'written' | 'deleted' | 'module-unavailable' | 'operation-failed' | 'timed-out' | 'invalid-helper-response';
+};
+export interface NativeKeychainEffects {
+    executeInChild(request: KeychainRequest, options: EffectOptions): Promise<KeychainResult>;
+}
+export interface Prompter {
+    confirm(question: string, options: EffectOptions): Promise<boolean>;
+    select<Value extends string>(question: string, choices: readonly {
+        readonly value: Value;
+        readonly label: string;
+    }[], options: EffectOptions): Promise<Value>;
+    multiselect<Value extends string>(question: string, choices: readonly {
+        readonly value: Value;
+        readonly label: string;
+    }[], initialValues: readonly Value[], options: EffectOptions): Promise<readonly Value[]>;
+}
+export interface ChildHost {
+    run(spec: {
+        readonly command: string;
+        readonly args: readonly string[];
+        readonly environment: Readonly<Record<string, string>>;
+        readonly cwd: string;
+        readonly stdin: 'inherit' | 'ignore';
+        readonly output: 'inherit' | 'stderr';
+        readonly options: EffectOptions;
+    }): Promise<ChildResult>;
+    liveness(owner: ProcessOwner, options: EffectOptions): Promise<'alive' | 'dead' | 'unknown'>;
+}
+export type ChildResult = {
+    readonly kind: 'exit';
+    readonly code: number;
+} | {
+    readonly kind: 'signal';
+    readonly signal: NodeJS.Signals;
+};
+export interface GitHost {
+    fileStatus(target: {
+        readonly repositoryRoot: string;
+        readonly path: string;
+    }, options: EffectOptions): Promise<{
+        readonly tracked: boolean;
+        readonly ignored: boolean;
+    }>;
+}
+export interface Io {
+    readonly host: HostSnapshot;
+    readonly stdout: OutputStream;
+    readonly stderr: OutputStream;
+    readonly stdin: AsyncIterable<Uint8Array>;
+    readonly signal: AbortSignal;
+    readonly files: SafeFiles;
+    readonly nativeKeychain: NativeKeychainEffects;
+    readonly prompt: Prompter;
+    readonly child: ChildHost;
+    readonly git: GitHost;
+    now(): number;
+    sleep(milliseconds: number, options: EffectOptions): Promise<void>;
+    randomBytes(length: number): Uint8Array;
+    http(proxy: ProxyConfig, options: EffectOptions): Promise<HttpLease>;
+    detectAgent(): Promise<{
+        readonly name: string;
+    } | null>;
+    openBrowser(url: string, options: EffectOptions): Promise<'opened' | 'failed'>;
+    close(): Promise<void>;
+}

package/dist/io-types.js

@@ -0,0 +1 @@
+export {};

package/dist/io.d.ts

@@ -0,0 +1,13 @@
+import type { ChildResult, EffectOptions, GitHost, HttpLease, Io, KeychainRequest, KeychainResult, ProcessOwner, ProxyConfig, SafeFiles } from './io-types.js';
+export declare function createSystemFiles(local?: ProcessOwner): SafeFiles;
+export declare function createSystemGit(): GitHost;
+export declare function createNativeExecutor(helper?: URL): (request: KeychainRequest, options: EffectOptions) => Promise<KeychainResult>;
+type NativeModule = {
+    readonly Entry: new (service: string, account: string, options?: import('@napi-rs/keyring').EntryOptions) => Pick<import('@napi-rs/keyring').Entry, 'getPassword' | 'setPassword' | 'deleteCredential'>;
+};
+export declare function nativeOperation(request: KeychainRequest, load?: () => Promise<NativeModule>): Promise<KeychainResult>;
+export declare function runNativeHelper(): void;
+export declare function createHttpLease(proxy: ProxyConfig, options: EffectOptions): Promise<HttpLease>;
+export declare function createSystemIo(): Io;
+export declare function runProcess(main: (argv: readonly string[], io: Io) => Promise<number | ChildResult>): Promise<void>;
+export {};