@proseql/cli 0.2.4

package/dist/config/discovery.js

@@ -0,0 +1,171 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { Data, Effect } from "effect";
+// ============================================================================
+// Config Discovery Error
+// ============================================================================
+/**
+ * Error thrown when no config file can be found.
+ */
+export class ConfigNotFoundError extends Data.TaggedError("ConfigNotFoundError") {
+}
+// ============================================================================
+// Config File Names (in priority order)
+// ============================================================================
+const CONFIG_FILE_NAMES = [
+    "proseql.config.ts",
+    "proseql.config.js",
+    "proseql.config.json",
+];
+// ============================================================================
+// Discovery Functions
+// ============================================================================
+/**
+ * Check if a file exists at the given path.
+ */
+function fileExists(filePath) {
+    try {
+        return fs.existsSync(filePath) && fs.statSync(filePath).isFile();
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Check if a directory exists at the given path.
+ */
+function directoryExists(dirPath) {
+    try {
+        return fs.existsSync(dirPath) && fs.statSync(dirPath).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Get the parent directory of a path.
+ * Returns null if at filesystem root.
+ */
+function getParentDirectory(dirPath) {
+    const parent = path.dirname(dirPath);
+    // If dirname returns the same path, we're at the root
+    return parent === dirPath ? null : parent;
+}
+/**
+ * Search for a config file in a single directory.
+ * Returns the first matching config file path, or null if none found.
+ */
+function findConfigInDirectory(dirPath) {
+    for (const configName of CONFIG_FILE_NAMES) {
+        const configPath = path.join(dirPath, configName);
+        if (fileExists(configPath)) {
+            return configPath;
+        }
+    }
+    return null;
+}
+/**
+ * Walk from the start directory upward to the filesystem root,
+ * collecting all directories searched.
+ */
+function* walkUpward(startDir) {
+    let currentDir = startDir;
+    while (currentDir !== null) {
+        yield currentDir;
+        currentDir = getParentDirectory(currentDir);
+    }
+}
+/**
+ * Discover a proseql config file.
+ *
+ * If `overridePath` is provided, it is validated and returned directly.
+ * Otherwise, the function walks from `cwd` upward, checking for:
+ * - `proseql.config.ts`
+ * - `proseql.config.js`
+ * - `proseql.config.json`
+ *
+ * Returns the absolute path to the config file.
+ * Fails with ConfigNotFoundError if no config file is found.
+ *
+ * @param cwd - The directory to start searching from
+ * @param overridePath - Optional explicit path to a config file
+ */
+export function discoverConfig(cwd, overridePath) {
+    return Effect.gen(function* () {
+        // If an override path is provided, validate and return it
+        if (overridePath !== undefined) {
+            const absoluteOverridePath = path.isAbsolute(overridePath)
+                ? overridePath
+                : path.resolve(cwd, overridePath);
+            if (fileExists(absoluteOverridePath)) {
+                return absoluteOverridePath;
+            }
+            // Override path was specified but doesn't exist
+            return yield* Effect.fail(new ConfigNotFoundError({
+                searchedPaths: [absoluteOverridePath],
+                message: `Config file not found: ${absoluteOverridePath}`,
+            }));
+        }
+        // Normalize and resolve the starting directory
+        const startDir = path.resolve(cwd);
+        // Validate that the starting directory exists
+        if (!directoryExists(startDir)) {
+            return yield* Effect.fail(new ConfigNotFoundError({
+                searchedPaths: [],
+                message: `Starting directory does not exist: ${startDir}`,
+            }));
+        }
+        // Track all directories searched for error reporting
+        const searchedPaths = [];
+        // Walk upward from cwd to filesystem root
+        for (const dir of walkUpward(startDir)) {
+            const configPath = findConfigInDirectory(dir);
+            if (configPath !== null) {
+                return configPath;
+            }
+            // Track all config file paths that were checked in this directory
+            for (const configName of CONFIG_FILE_NAMES) {
+                searchedPaths.push(path.join(dir, configName));
+            }
+        }
+        // No config file found anywhere
+        return yield* Effect.fail(new ConfigNotFoundError({
+            searchedPaths,
+            message: `No proseql config file found. Searched from ${startDir} to filesystem root.\nLooking for: ${CONFIG_FILE_NAMES.join(", ")}`,
+        }));
+    });
+}
+/**
+ * Synchronous version of discoverConfig for use in contexts
+ * where Effect is not available.
+ *
+ * @throws Error if no config file is found
+ */
+export function discoverConfigSync(cwd, overridePath) {
+    // If an override path is provided, validate and return it
+    if (overridePath !== undefined) {
+        const absoluteOverridePath = path.isAbsolute(overridePath)
+            ? overridePath
+            : path.resolve(cwd, overridePath);
+        if (fileExists(absoluteOverridePath)) {
+            return absoluteOverridePath;
+        }
+        throw new Error(`Config file not found: ${absoluteOverridePath}`);
+    }
+    // Normalize and resolve the starting directory
+    const startDir = path.resolve(cwd);
+    // Validate that the starting directory exists
+    if (!directoryExists(startDir)) {
+        throw new Error(`Starting directory does not exist: ${startDir}`);
+    }
+    // Walk upward from cwd to filesystem root
+    for (const dir of walkUpward(startDir)) {
+        const configPath = findConfigInDirectory(dir);
+        if (configPath !== null) {
+            return configPath;
+        }
+    }
+    // No config file found anywhere
+    throw new Error(`No proseql config file found. Searched from ${startDir} to filesystem root.\nLooking for: ${CONFIG_FILE_NAMES.join(", ")}`);
+}
+//# sourceMappingURL=discovery.js.map

package/dist/config/discovery.js.map

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

package/dist/config/loader.d.ts

@@ -0,0 +1,49 @@
+import type { DatabaseConfig } from "@proseql/core";
+import { Effect } from "effect";
+declare const ConfigLoadError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }) => import("effect/Cause").YieldableError & {
+    readonly _tag: "ConfigLoadError";
+} & Readonly<A>;
+/**
+ * Error thrown when a config file cannot be loaded.
+ */
+export declare class ConfigLoadError extends ConfigLoadError_base<{
+    readonly configPath: string;
+    readonly reason: string;
+    readonly message: string;
+}> {
+}
+declare const ConfigValidationError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }) => import("effect/Cause").YieldableError & {
+    readonly _tag: "ConfigValidationError";
+} & Readonly<A>;
+/**
+ * Error thrown when a config file has an invalid structure.
+ */
+export declare class ConfigValidationError extends ConfigValidationError_base<{
+    readonly configPath: string;
+    readonly reason: string;
+    readonly message: string;
+}> {
+}
+/**
+ * Load a proseql configuration file.
+ *
+ * Supports three file formats:
+ * - `.ts` - TypeScript (imported via Bun)
+ * - `.js` - JavaScript (dynamic import)
+ * - `.json` - JSON (parsed with JSON.parse)
+ *
+ * The config file should export a DatabaseConfig object as its default export.
+ *
+ * @param configPath - Absolute path to the config file
+ * @returns The validated DatabaseConfig
+ */
+export declare function loadConfig(configPath: string): Effect.Effect<DatabaseConfig, ConfigLoadError | ConfigValidationError>;
+/**
+ * Synchronous version of loadConfig for use in contexts
+ * where Effect is not available.
+ *
+ * @throws Error if config cannot be loaded or is invalid
+ */
+export declare function loadConfigAsync(configPath: string): Promise<DatabaseConfig>;
+export {};
+//# sourceMappingURL=loader.d.ts.map

package/dist/config/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/config/loader.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAQ,MAAM,EAAE,MAAM,QAAQ,CAAC;;;;AAMtC;;GAEG;AACH,qBAAa,eAAgB,SAAQ,qBAAoC;IACxE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CACzB,CAAC;CAAG;;;;AAEL;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,2BAEzC;IACD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CACzB,CAAC;CAAG;AAqLL;;;;;;;;;;;;GAYG;AACH,wBAAgB,UAAU,CACzB,UAAU,EAAE,MAAM,GAChB,MAAM,CAAC,MAAM,CAAC,cAAc,EAAE,eAAe,GAAG,qBAAqB,CAAC,CAmCxE;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CACpC,UAAU,EAAE,MAAM,GAChB,OAAO,CAAC,cAAc,CAAC,CAEzB"}

package/dist/config/loader.js

@@ -0,0 +1,195 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { Data, Effect } from "effect";
+// ============================================================================
+// Config Loading Errors
+// ============================================================================
+/**
+ * Error thrown when a config file cannot be loaded.
+ */
+export class ConfigLoadError extends Data.TaggedError("ConfigLoadError") {
+}
+/**
+ * Error thrown when a config file has an invalid structure.
+ */
+export class ConfigValidationError extends Data.TaggedError("ConfigValidationError") {
+}
+// ============================================================================
+// Supported Extensions
+// ============================================================================
+const SUPPORTED_EXTENSIONS = [".ts", ".js", ".json"];
+/**
+ * Check if a file extension is supported.
+ */
+function isSupportedExtension(ext) {
+    return SUPPORTED_EXTENSIONS.includes(ext);
+}
+// ============================================================================
+// Config Loading Functions
+// ============================================================================
+/**
+ * Load a JSON config file.
+ */
+function loadJsonConfig(configPath) {
+    return Effect.gen(function* () {
+        try {
+            const content = fs.readFileSync(configPath, "utf-8");
+            return JSON.parse(content);
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            return yield* Effect.fail(new ConfigLoadError({
+                configPath,
+                reason: `Failed to parse JSON config: ${errorMessage}`,
+                message: `Failed to load config from ${configPath}: ${errorMessage}`,
+            }));
+        }
+    });
+}
+/**
+ * Load a TypeScript or JavaScript config file using dynamic import.
+ * Bun handles TypeScript natively, so this works for both .ts and .js.
+ */
+function loadModuleConfig(configPath) {
+    // Use file:// URL for dynamic import to work correctly
+    const fileUrl = `file://${configPath}`;
+    return Effect.tryPromise({
+        try: async () => {
+            const module = (await import(fileUrl));
+            // Config should be the default export
+            if ("default" in module) {
+                return module.default;
+            }
+            // If no default export, try to use the module itself
+            // (in case the config is exported as module.exports = {...})
+            return module;
+        },
+        catch: (error) => {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            return new ConfigLoadError({
+                configPath,
+                reason: `Failed to import config module: ${errorMessage}`,
+                message: `Failed to load config from ${configPath}: ${errorMessage}`,
+            });
+        },
+    });
+}
+/**
+ * Validate that a loaded config object has the correct structure.
+ * A valid DatabaseConfig is a Record<string, CollectionConfig> where
+ * each CollectionConfig has at least a `schema` and `relationships` field.
+ */
+function validateConfigStructure(config, configPath) {
+    return Effect.gen(function* () {
+        // Must be a non-null object
+        if (config === null || typeof config !== "object") {
+            return yield* Effect.fail(new ConfigValidationError({
+                configPath,
+                reason: "Config must be an object",
+                message: `Invalid config in ${configPath}: Config must be an object, got ${typeof config}`,
+            }));
+        }
+        // Must be a plain object (not an array)
+        if (Array.isArray(config)) {
+            return yield* Effect.fail(new ConfigValidationError({
+                configPath,
+                reason: "Config must be an object, not an array",
+                message: `Invalid config in ${configPath}: Config must be an object, got array`,
+            }));
+        }
+        const configObj = config;
+        // Check each collection
+        for (const [collectionName, collectionConfig] of Object.entries(configObj)) {
+            // Each collection config must be an object
+            if (collectionConfig === null ||
+                typeof collectionConfig !== "object" ||
+                Array.isArray(collectionConfig)) {
+                return yield* Effect.fail(new ConfigValidationError({
+                    configPath,
+                    reason: `Collection '${collectionName}' must be an object`,
+                    message: `Invalid config in ${configPath}: Collection '${collectionName}' must be an object`,
+                }));
+            }
+            const collection = collectionConfig;
+            // Must have a schema field
+            if (!("schema" in collection)) {
+                return yield* Effect.fail(new ConfigValidationError({
+                    configPath,
+                    reason: `Collection '${collectionName}' is missing required field 'schema'`,
+                    message: `Invalid config in ${configPath}: Collection '${collectionName}' is missing required field 'schema'`,
+                }));
+            }
+            // Must have a relationships field
+            if (!("relationships" in collection)) {
+                return yield* Effect.fail(new ConfigValidationError({
+                    configPath,
+                    reason: `Collection '${collectionName}' is missing required field 'relationships'`,
+                    message: `Invalid config in ${configPath}: Collection '${collectionName}' is missing required field 'relationships'`,
+                }));
+            }
+            // Relationships must be an object
+            if (collection.relationships === null ||
+                typeof collection.relationships !== "object" ||
+                Array.isArray(collection.relationships)) {
+                return yield* Effect.fail(new ConfigValidationError({
+                    configPath,
+                    reason: `Collection '${collectionName}' field 'relationships' must be an object`,
+                    message: `Invalid config in ${configPath}: Collection '${collectionName}' field 'relationships' must be an object`,
+                }));
+            }
+        }
+        // Config is valid
+        return configObj;
+    });
+}
+// ============================================================================
+// Main Export
+// ============================================================================
+/**
+ * Load a proseql configuration file.
+ *
+ * Supports three file formats:
+ * - `.ts` - TypeScript (imported via Bun)
+ * - `.js` - JavaScript (dynamic import)
+ * - `.json` - JSON (parsed with JSON.parse)
+ *
+ * The config file should export a DatabaseConfig object as its default export.
+ *
+ * @param configPath - Absolute path to the config file
+ * @returns The validated DatabaseConfig
+ */
+export function loadConfig(configPath) {
+    return Effect.gen(function* () {
+        // Ensure the path is absolute
+        const absolutePath = path.isAbsolute(configPath)
+            ? configPath
+            : path.resolve(process.cwd(), configPath);
+        // Get file extension
+        const ext = path.extname(absolutePath).toLowerCase();
+        // Validate extension
+        if (!isSupportedExtension(ext)) {
+            return yield* Effect.fail(new ConfigLoadError({
+                configPath: absolutePath,
+                reason: `Unsupported config file extension: ${ext}`,
+                message: `Cannot load config from ${absolutePath}: Unsupported extension '${ext}'. Use .ts, .js, or .json`,
+            }));
+        }
+        // Load the raw config based on extension
+        const rawConfig = ext === ".json"
+            ? yield* loadJsonConfig(absolutePath)
+            : yield* loadModuleConfig(absolutePath);
+        // Validate the config structure
+        const validatedConfig = yield* validateConfigStructure(rawConfig, absolutePath);
+        return validatedConfig;
+    });
+}
+/**
+ * Synchronous version of loadConfig for use in contexts
+ * where Effect is not available.
+ *
+ * @throws Error if config cannot be loaded or is invalid
+ */
+export async function loadConfigAsync(configPath) {
+    return Effect.runPromise(loadConfig(configPath));
+}
+//# sourceMappingURL=loader.js.map

package/dist/config/loader.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @proseql/cli - Programmatic API
+ *
+ * Re-exports the CLI's public API for programmatic use.
+ */
+export type { OutputFormat, ParsedArgs } from "./main.js";
+export { getOutputFormat, parseArgs, resolveConfig } from "./main.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+/**
+ * @proseql/cli - Programmatic API
+ *
+ * Re-exports the CLI's public API for programmatic use.
+ */
+export { getOutputFormat, parseArgs, resolveConfig } from "./main.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC"}

package/dist/main.d.ts

@@ -0,0 +1,66 @@
+#!/usr/bin/env node
+/**
+ * ProseQL CLI - Command line interface for proseql databases
+ *
+ * Entry point: parses top-level flags and dispatches to command handlers.
+ */
+import type { DatabaseConfig } from "@proseql/core";
+import { type OutputFormat } from "./output/formatter.js";
+/**
+ * Parsed CLI arguments
+ */
+interface ParsedArgs {
+    readonly command: string | undefined;
+    readonly positionalArgs: readonly string[];
+    readonly flags: {
+        readonly help: boolean;
+        readonly version: boolean;
+        readonly config: string | undefined;
+        readonly json: boolean;
+        readonly yaml: boolean;
+        readonly csv: boolean;
+        readonly force: boolean;
+        readonly where: readonly string[];
+        readonly select: string | undefined;
+        readonly sort: string | undefined;
+        readonly limit: number | undefined;
+        readonly data: string | undefined;
+        readonly set: string | undefined;
+        readonly to: string | undefined;
+        readonly format: string | undefined;
+        readonly dryRun: boolean;
+    };
+}
+/**
+ * Determine output format from flags
+ */
+declare function getOutputFormat(flags: ParsedArgs["flags"]): OutputFormat;
+/**
+ * Parse command line arguments
+ */
+declare function parseArgs(argv: readonly string[]): ParsedArgs;
+/**
+ * Print help message
+ */
+declare function printHelp(): void;
+/**
+ * Print version
+ */
+declare function printVersion(): void;
+/**
+ * Resolved config result including both the config and its path.
+ */
+interface ResolvedConfig {
+    readonly config: DatabaseConfig;
+    readonly configPath: string;
+}
+/**
+ * Resolve and load the database config.
+ * Uses the --config flag if provided, otherwise discovers the config file.
+ * Returns both the config and its path (needed for resolving relative file paths).
+ */
+declare function resolveConfig(configOverride: string | undefined): Promise<ResolvedConfig>;
+export { parseArgs, getOutputFormat, printHelp, printVersion, resolveConfig };
+export type { ParsedArgs };
+export type { OutputFormat } from "./output/formatter.js";
+//# sourceMappingURL=main.d.ts.map

package/dist/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":";AAEA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAqBpD,OAAO,EAAU,KAAK,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAIlE;;GAEG;AACH,UAAU,UAAU;IACnB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3C,QAAQ,CAAC,KAAK,EAAE;QACf,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;QACvB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;QAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;QACpC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;QACvB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;QACvB,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;QACtB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;QAExB,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;QAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;QACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;QAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;QACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;QAClC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;QACjC,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,CAAC;QAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;QACpC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;KACzB,CAAC;CACF;AAED;;GAEG;AACH,iBAAS,eAAe,CAAC,KAAK,EAAE,UAAU,CAAC,OAAO,CAAC,GAAG,YAAY,CAKjE;AAED;;GAEG;AACH,iBAAS,SAAS,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,UAAU,CAsHtD;AAED;;GAEG;AACH,iBAAS,SAAS,IAAI,IAAI,CA2DzB;AAED;;GAEG;AACH,iBAAS,YAAY,IAAI,IAAI,CAE5B;AAWD;;GAEG;AACH,UAAU,cAAc;IACvB,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC5B;AAED;;;;GAIG;AACH,iBAAe,aAAa,CAC3B,cAAc,EAAE,MAAM,GAAG,SAAS,GAChC,OAAO,CAAC,cAAc,CAAC,CAgBzB;AAmeD,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,CAAC;AAC9E,YAAY,EAAE,UAAU,EAAE,CAAC;AAC3B,YAAY,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC"}