flingit 0.0.11 → 0.0.13

package/dist/cli/utils/cli-io.d.ts

@@ -0,0 +1,350 @@
+/**
+ * Consolidated I/O abstraction interfaces for CLI commands.
+ *
+ * These interfaces allow CLI command logic to be tested without mocking
+ * individual modules. Tests can provide fake implementations.
+ *
+ * Interface hierarchy:
+ * - Shared base interfaces (ConsoleIO, ProcessIO, FileIO) are used across commands
+ * - Command-specific interfaces extend the base where needed
+ * - Each command defines its own combined IO interface using these building blocks
+ */
+import type Database from "better-sqlite3";
+import type { ChildProcess, SpawnOptions as NodeSpawnOptions } from "node:child_process";
+import type { BuildContext, BuildOptions } from "esbuild";
+/**
+ * Base console output interface for CLI commands.
+ * All methods take single string messages.
+ */
+export interface ConsoleIO {
+    log(message: string): void;
+    error(message: string): void;
+    warn(message: string): void;
+}
+/**
+ * Console interface with writeProgress() for progress indicators.
+ * Used by: admin usage command
+ */
+export interface ConsoleIOWithProgress extends ConsoleIO {
+    /** Write to stderr without newline (for progress indicators) */
+    writeProgress(message: string): void;
+}
+/**
+ * Base process interface with core functionality.
+ * Used by: most CLI commands
+ */
+export interface ProcessIO {
+    exit(code: number): never;
+    cwd(): string;
+    env: Record<string, string | undefined>;
+}
+/**
+ * Process interface with stdio streams.
+ * Used by: login, project, feedback
+ */
+export interface ProcessIOWithStdio extends ProcessIO {
+    stdin: NodeJS.ReadStream;
+    stdout: NodeJS.WriteStream;
+}
+/**
+ * Process interface with platform and stdio.
+ * Used by: plugin
+ */
+export interface ProcessIOWithPlatformAndStdio extends ProcessIOWithStdio {
+    platform: NodeJS.Platform;
+}
+/**
+ * Process interface with signal handlers.
+ * Used by: tunnel
+ */
+export interface ProcessIOWithSignals extends ProcessIO {
+    on(event: "SIGINT" | "SIGTERM", listener: () => void): void;
+}
+/**
+ * Full process interface with all extensions (for launch, dev, etc.).
+ * Extends ProcessIOWithStdio (which includes stdio, cwd, env, exit) and
+ * ProcessIOWithSignals (which includes signal handlers).
+ */
+export interface ProcessIOFull extends ProcessIOWithStdio, ProcessIOWithSignals {
+    chdir(dir: string): void;
+    execPath?: string;
+    platform: NodeJS.Platform;
+}
+/**
+ * Base file system interface - just exists check.
+ * Used by: logs, tunnel
+ */
+export interface FileIO {
+    exists(path: string): boolean;
+}
+/**
+ * File interface with sync reading.
+ * Used by: push
+ */
+export interface FileIOWithRead extends FileIO {
+    readFileSync(path: string, encoding: BufferEncoding): string;
+}
+export interface ReadFileString {
+    readFileString(path: string): string | null;
+}
+export interface ReadFileBuffer {
+    readFileBuffer(path: string): Buffer | null;
+}
+export interface WriteFileString {
+    writeFileString(path: string, data: string, options?: {
+        mode?: number;
+    }): void;
+}
+export interface WriteFileBuffer {
+    writeFileBuffer(path: string, data: Buffer): void;
+}
+export interface Mkdir {
+    mkdir(path: string, options?: {
+        recursive?: boolean;
+    }): void;
+}
+export interface DbFileIO extends FileIO, Mkdir {
+    remove(path: string, options?: {
+        force?: boolean;
+    }): void;
+}
+export interface StorageFileIO extends FileIO, ReadFileBuffer, WriteFileBuffer {
+    stat(path: string): {
+        size: number;
+    };
+}
+export interface LaunchFileIO extends FileIO, Mkdir {
+    isProjectRoot(path: string): boolean;
+    isDirEmpty(path: string): boolean;
+}
+export interface OnboardingFileIO extends FileIO, Mkdir, ReadFileString, WriteFileString {
+    delete(path: string): void;
+}
+export interface InitFileIO extends FileIO, Mkdir, ReadFileString, WriteFileString {
+    copy(src: string, dest: string, options?: {
+        recursive?: boolean;
+    }): void;
+    readdir(path: string): string[];
+}
+export interface DevFileIO extends FileIO, Mkdir, WriteFileString {
+}
+export interface ConfigFileIO extends FileIO, Mkdir, ReadFileString, WriteFileString {
+    delete(path: string): void;
+    rename(src: string, dest: string): void;
+}
+export interface SpinnerIO {
+    start(message: string): void;
+    stop(message: string, exitCode?: number): void;
+}
+export interface UserIO {
+    select<T extends string>(opts: {
+        message: string;
+        options: Array<{
+            value: T;
+            label: string;
+            hint?: string;
+        }>;
+    }): Promise<T | symbol>;
+    text(opts: {
+        message: string;
+        placeholder?: string;
+        validate?: (value: string) => string | undefined;
+    }): Promise<string | symbol>;
+    isCancel(value: unknown): value is symbol;
+    intro?(message: string): void;
+    outro?(message: string): void;
+    cancel?(message: string): void;
+    password?(opts: {
+        message: string;
+        validate?: (value: string) => string | undefined;
+    }): Promise<string | symbol>;
+    confirm?(opts: {
+        message: string;
+        initialValue?: boolean;
+    }): Promise<boolean | symbol>;
+    spinner?(): SpinnerIO;
+    log?: {
+        info(message: string): void;
+        warn(message: string): void;
+        message(message: string): void;
+    };
+}
+/**
+ * Simple readline-based prompt.
+ * Used by: login, plugin
+ */
+export interface SimplePromptIO {
+    prompt(question: string): Promise<string>;
+}
+/**
+ * Simple readline-based confirm.
+ * Used by: project
+ */
+export interface SimpleConfirmIO {
+    confirm(question: string): Promise<boolean>;
+}
+/**
+ * Simple prompt with multiline support.
+ * Used by: feedback
+ */
+export interface SimplePromptIOWithMultiline extends SimplePromptIO {
+    promptMultiline(): Promise<string>;
+}
+export interface NetworkIO {
+    fetch(url: string, options?: RequestInit): Promise<Response>;
+}
+export interface BrowserIO {
+    open(url: string): void;
+}
+export interface TimingIO {
+    sleep(ms: number): Promise<void>;
+}
+/**
+ * Readable stream interface for spawn stdout/stderr.
+ */
+export interface SpawnReadableStream {
+    on(event: "data", listener: (data: Buffer) => void): this;
+}
+/**
+ * Result of spawning a child process.
+ * Properties like stdout/stderr are optional depending on stdio options.
+ */
+export interface SpawnResult {
+    stdout: SpawnReadableStream | null;
+    stderr: SpawnReadableStream | null;
+    on(event: "error", listener: (error: Error) => void): this;
+    on(event: "close" | "exit", listener: (code: number | null) => void): this;
+    kill(signal?: NodeJS.Signals | number): boolean;
+    unref(): void;
+}
+export type StdioOption = "inherit" | "pipe" | "ignore";
+export interface SpawnOptions {
+    cwd?: string;
+    stdio?: StdioOption | [StdioOption, StdioOption, StdioOption];
+    env?: Record<string, string | undefined>;
+    detached?: boolean;
+}
+export type SpawnFn = (command: string, args: string[], options: SpawnOptions) => SpawnResult;
+export interface ClaudeCodeIO {
+    isInstalled(): boolean;
+    getNotInstalledError(): string;
+}
+export interface DatabaseIO {
+    open(path: string, options?: Database.Options): Database.Database;
+}
+export interface LaunchPaths {
+    flingHome: string;
+    cwd: string;
+    homedir: string;
+}
+export interface InitPaths {
+    flingRoot: string;
+    templateDir: string;
+}
+export interface InitMeta {
+    packageName: string;
+    packageVersion: string;
+    isDevelopmentMode: boolean;
+}
+export interface DbIO {
+    file: DbFileIO;
+    process: ProcessIO;
+    database: DatabaseIO;
+    console: ConsoleIO;
+}
+export interface StorageIO {
+    file: StorageFileIO;
+    process: ProcessIOWithStdio;
+    console: ConsoleIO;
+}
+export interface LaunchIO {
+    user: UserIO;
+    file: LaunchFileIO;
+    paths: LaunchPaths;
+    process: ProcessIO & {
+        chdir(dir: string): void;
+    };
+    console: ConsoleIO;
+    spawn: SpawnFn;
+    claudeCode: ClaudeCodeIO;
+}
+export interface OnboardingIO {
+    user: UserIO & {
+        intro(message: string): void;
+        outro(message: string): void;
+        cancel(message: string): void;
+        password(opts: {
+            message: string;
+            validate?: (value: string) => string | undefined;
+        }): Promise<string | symbol>;
+        confirm(opts: {
+            message: string;
+            initialValue?: boolean;
+        }): Promise<boolean | symbol>;
+        spinner(): SpinnerIO;
+        log: {
+            info(message: string): void;
+            warn(message: string): void;
+            message(message: string): void;
+        };
+    };
+    file: OnboardingFileIO;
+    network: NetworkIO;
+}
+export interface InitIO {
+    file: InitFileIO;
+    process: ProcessIO;
+    console: ConsoleIO;
+    paths: InitPaths;
+    meta: InitMeta;
+    registry: {
+        register(path: string): void;
+    };
+}
+export interface UpgradeIO {
+    file: InitFileIO;
+    process: ProcessIO;
+    console: ConsoleIO;
+    paths: InitPaths;
+    project: {
+        findEnclosingProject(startDir: string): string | null;
+        hasSymlinkInPath(targetPath: string, basePath: string): boolean;
+    };
+}
+export interface DevPaths {
+    nodeRuntimePath: string;
+    honoNodeServerPath: string;
+}
+export interface DevIO {
+    file: DevFileIO;
+    process: ProcessIOWithStdio & ProcessIOWithSignals & {
+        execPath: string;
+    };
+    console: ConsoleIO;
+    paths: DevPaths;
+    project: {
+        hasWorkerEntry(cwd: string): boolean;
+        getWorkerEntryPath(cwd: string): string;
+    };
+    spawn(command: string, args: string[], options?: NodeSpawnOptions): ChildProcess;
+    esbuild: {
+        context(options: BuildOptions): Promise<BuildContext>;
+    };
+}
+export interface ConfigIO {
+    file: ConfigFileIO;
+    env: {
+        homedir(): string;
+        get(name: string): string | undefined;
+    };
+    console: {
+        error(message: string): void;
+    };
+}
+/**
+ * Result from promptNewProject.
+ * - string: path to project directory (existing or new)
+ * - null: user cancelled
+ */
+export type PromptNewProjectResult = string | null;
+//# sourceMappingURL=cli-io.d.ts.map

package/dist/cli/utils/cli-io.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-io.d.ts","sourceRoot":"","sources":["../../../src/cli/utils/cli-io.ts"],"names":[],"mappings":"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"}

package/dist/cli/utils/cli-io.js

@@ -0,0 +1,13 @@
+/**
+ * Consolidated I/O abstraction interfaces for CLI commands.
+ *
+ * These interfaces allow CLI command logic to be tested without mocking
+ * individual modules. Tests can provide fake implementations.
+ *
+ * Interface hierarchy:
+ * - Shared base interfaces (ConsoleIO, ProcessIO, FileIO) are used across commands
+ * - Command-specific interfaces extend the base where needed
+ * - Each command defines its own combined IO interface using these building blocks
+ */
+export {};
+//# sourceMappingURL=cli-io.js.map

package/dist/cli/utils/cli-io.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-io.js","sourceRoot":"","sources":["../../../src/cli/utils/cli-io.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG"}

package/dist/cli/utils/config.d.ts

@@ -1,7 +1,65 @@
 /**
  * Platform configuration utilities.
- * Stores token and API URL in ~/.fling/ (or FLING_CONFIG_DIR if set)
+ * Stores token and API URL in ~/.config/fling/ (XDG Base Directory spec).
+ *
+ * Priority for config directory:
+ * 1. FLING_CONFIG_DIR environment variable (explicit override)
+ * 2. XDG_CONFIG_HOME/fling (if XDG_CONFIG_HOME is set)
+ * 3. ~/.config/fling (XDG default)
+ *
+ * Automatic migration: If ~/.fling exists but the new location doesn't,
+ * config is automatically migrated with a one-time notice.
  */
+import type { ConfigIO } from "./cli-io.js";
+/**
+ * Get the legacy config directory path (~/.fling).
+ */
+export declare function getLegacyConfigDir(io: ConfigIO): string;
+/**
+ * Get the XDG-compliant config directory path.
+ * Respects XDG_CONFIG_HOME if set, otherwise defaults to ~/.config/fling.
+ */
+export declare function getXdgConfigDir(io: ConfigIO): string;
+/**
+ * Migrate config from legacy ~/.fling to XDG location if needed.
+ * Returns true if migration was performed, false otherwise.
+ */
+export declare function migrateConfig(io: ConfigIO): boolean;
+/**
+ * Get the configuration directory.
+ * Priority: FLING_CONFIG_DIR > XDG_CONFIG_HOME/fling > ~/.config/fling
+ */
+export declare function getConfigDirWithIO(io: ConfigIO, attemptMigration?: boolean): string;
+/**
+ * Get the stored API token, or null if not logged in.
+ * Empty or whitespace-only tokens are treated as null.
+ */
+export declare function getTokenWithIO(io: ConfigIO, configDir: string): string | null;
+/**
+ * Store the API token.
+ */
+export declare function setTokenWithIO(io: ConfigIO, configDir: string, token: string): void;
+/**
+ * Remove the stored token.
+ */
+export declare function clearTokenWithIO(io: ConfigIO, configDir: string): void;
+/**
+ * Get the API URL.
+ * Priority: FLING_API_URL env var > config file > default
+ */
+export declare function getApiUrlWithIO(io: ConfigIO, configDir: string): string;
+/**
+ * Set the API URL (for development/testing).
+ */
+export declare function setApiUrlWithIO(io: ConfigIO, configDir: string, url: string): void;
+/**
+ * Reset the migration flag. Used for testing.
+ */
+export declare function resetMigrationFlag(): void;
+/**
+ * Reset the cached config dir. Used for testing.
+ */
+export declare function resetConfigDirCache(): void;
 /**
  * Get the stored API token, or null if not logged in.
  */
@@ -24,7 +82,7 @@ export declare function isLoggedIn(): boolean;
 export declare function configDirExists(): boolean;
 /**
  * Get the API URL.
- * Priority: FLING_API_URL env var > ~/.fling/api-url file > default
+ * Priority: FLING_API_URL env var > ~/.config/fling/api-url file > default
  */
 export declare function getApiUrl(): string;
 /**

package/dist/cli/utils/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/cli/utils/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAiCH;;GAEG;AACH,wBAAgB,QAAQ,IAAI,MAAM,GAAG,IAAI,CAKxC;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAG5C;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,IAAI,CAIjC;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,OAAO,CAEpC;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAEzC;AAED;;;GAGG;AACH,wBAAgB,SAAS,IAAI,MAAM,CASlC;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAG3C;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AA2BzF;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,QAAQ,CAAC,CAEnB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,eAAe,GAAG,IAAI,CAE1D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/cli/utils/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAS5C;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,QAAQ,GAAG,MAAM,CAEvD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,QAAQ,GAAG,MAAM,CAMpD;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,QAAQ,GAAG,OAAO,CA8BnD;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,QAAQ,EAAE,gBAAgB,GAAE,OAAc,GAAG,MAAM,CAYzF;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAK7E;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAInF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAGtE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAWvE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAIlF;AASD;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC;AAqBD;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAG1C;AAED;;GAEG;AACH,wBAAgB,QAAQ,IAAI,MAAM,GAAG,IAAI,CAExC;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAE5C;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,IAAI,CAEjC;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,OAAO,CAEpC;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAEzC;AAED;;;GAGG;AACH,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAE3C;AAMD;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AA2BzF;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,QAAQ,CAAC,CAEnB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,eAAe,GAAG,IAAI,CAE1D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC"}