romm-uploader 0.1.1-beta.0

package/dist/cli.js

@@ -0,0 +1,165 @@
+#!/usr/bin/env node
+/**
+ * RomM Uploader CLI
+ * Linux-first TypeScript CLI for uploading ROMs to RomM
+ */
+import { Command } from 'commander';
+import { resolveConfig, validateConfig } from './config.js';
+import { Reporter } from './output/reporter.js';
+import { createClient } from './workflow/create-client.js';
+import { runDryMode } from './workflow/run-dry.js';
+import { runUploadMode } from './workflow/run-upload.js';
+const program = new Command();
+program
+    .name('romm-uploader')
+    .description('Upload ROMs to your RomM instance')
+    .version('0.1.0')
+    .argument('[paths...]', 'ROM file or directory paths to process')
+    // Core connection options
+    .option('--base-url <url>', 'ROMM base URL (or ROMM_BASE_URL env var)')
+    .option('--username <user>', 'ROMM username (or ROMM_USERNAME env var)')
+    .option('--password <pass>', 'ROMM password (or ROMM_PASSWORD env var)')
+    // Platform options
+    .option('--platform <value>', 'Target platform (slug, name, or numeric ID)')
+    // Explicit input options
+    .option('--upload-file <path>', 'Upload a specific file (repeatable)', collect, [])
+    .option('--upload-dir <path>', 'Upload all files in directory (repeatable)', collect, [])
+    .option('--glob <pattern>', 'Upload files matching glob pattern (repeatable)', collect, [])
+    // Checksum options
+    .option('--checksum <algo>', 'Additional hash algorithm for reporting (repeatable)', collect, [])
+    .option('--cache-enabled <true|false>', 'Enable disk checksum cache', parseBoolean, true)
+    .option('--cache-max-mb <n>', 'Checksum cache size cap in MB', parseInteger, 4)
+    .option('--cache-path <path>', 'Override checksum cache file location')
+    // Auth options
+    .option('--auth-cache-enabled <true|false>', 'Enable auth token cache', parseBoolean, true)
+    .option('--auth-cache-path <path>', 'Override auth token cache file location')
+    .option('--auth-reauth-skew-seconds <n>', 'Refresh/re-auth early window before expiry', parseInteger, 60)
+    // Request options
+    .option('--request-timeout-seconds <n>', 'HTTP request timeout', parseInteger, 60)
+    .option('--retry-count <n>', 'Retry attempts for transient failures', parseInteger, 0)
+    // Behavior options
+    .option('--recursive', 'Include nested files when directory path passed', false)
+    .option('--dry-run', 'Run checksum + existence checks only, no upload', false)
+    .option('--concurrency <n>', 'Parallel file processing count', parseInteger, 3)
+    // Output options
+    .option('--json', 'Output structured JSON for scripting', false)
+    .option('--verbose', 'Enable detailed operational output', false)
+    .option('--list-platforms', 'Print available platforms and exit', false);
+/**
+ * Collect multiple option values into an array
+ */
+function collect(value, previous) {
+    return previous.concat([value]);
+}
+/**
+ * Parse boolean option value
+ */
+function parseBoolean(value) {
+    return value.toLowerCase() === 'true';
+}
+/**
+ * Parse integer option value
+ */
+function parseInteger(value) {
+    return Number.parseInt(value, 10);
+}
+/**
+ * Convert Commander options to our CliOptions format
+ */
+function convertOptions(opts, paths) {
+    return resolveConfig({
+        baseUrl: opts.baseUrl,
+        username: opts.username,
+        password: opts.password,
+        platform: opts.platform,
+        paths,
+        uploadFiles: opts.uploadFile,
+        uploadDirs: opts.uploadDir,
+        globs: opts.glob,
+        checksum: opts.checksum,
+        cacheEnabled: opts.cacheEnabled,
+        cacheMaxMb: opts.cacheMaxMb,
+        cachePath: opts.cachePath,
+        authCacheEnabled: opts.authCacheEnabled,
+        authCachePath: opts.authCachePath,
+        authReauthSkewSeconds: opts.authReauthSkewSeconds,
+        requestTimeoutSeconds: opts.requestTimeoutSeconds,
+        retryCount: opts.retryCount,
+        recursive: opts.recursive,
+        dryRun: opts.dryRun,
+        concurrency: opts.concurrency,
+        json: opts.json,
+        verbose: opts.verbose,
+        listPlatforms: opts.listPlatforms,
+    });
+}
+/**
+ * Handle --list-platforms command
+ */
+async function handleListPlatforms(config) {
+    const reporter = new Reporter({ json: config.json, verbose: config.verbose });
+    const client = await createClient(config);
+    if (!config.password) {
+        console.error('error: password required (--password or ROMM_PASSWORD)');
+        console.error('error: cached tokens are not yet supported for this operation');
+        return 2;
+    }
+    try {
+        await client.authenticate();
+        const platforms = await client.getPlatforms();
+        reporter.reportPlatforms(platforms);
+        return 0;
+    }
+    catch (error) {
+        console.error('error: failed to list platforms:', error instanceof Error ? error.message : error);
+        return 1;
+    }
+}
+/**
+ * Main entry point
+ */
+async function main() {
+    program.parse();
+    const paths = program.args;
+    const opts = program.opts();
+    const config = convertOptions(opts, paths);
+    if (!config.dryRun) {
+        const errors = validateConfig(config);
+        if (errors.length > 0) {
+            console.error('error: configuration invalid:');
+            errors.forEach((err) => console.error(`  - ${err}`));
+            process.exit(2);
+        }
+    }
+    else {
+        const hasFiles = config.paths.length > 0 ||
+            config.uploadFiles.length > 0 ||
+            config.uploadDirs.length > 0 ||
+            config.globs.length > 0;
+        if (!hasFiles) {
+            console.error('error: no files specified (use paths, --upload-file, --upload-dir, or --glob)');
+            process.exit(2);
+        }
+    }
+    if (config.listPlatforms) {
+        process.exit(await handleListPlatforms(config));
+    }
+    if (config.dryRun) {
+        process.exit(await runDryMode(config));
+    }
+    if (!config.platform) {
+        console.error('error: --platform is required for upload');
+        console.error('hint: use --list-platforms');
+        process.exit(2);
+    }
+    if (!config.password) {
+        console.error('error: password required (--password or ROMM_PASSWORD)');
+        process.exit(2);
+    }
+    process.exit(await runUploadMode(config));
+}
+main().catch((error) => {
+    console.error('error: fatal:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,34 @@
+export { CliOptions } from './types.js';
+/**
+ * Configuration management for romm-uploader
+ * Handles CLI args and environment variables with proper precedence
+ */
+import { CliOptions } from './types.js';
+/** Default configuration values */
+export declare const defaults: {
+    readonly cacheEnabled: true;
+    readonly cacheMaxMb: 4;
+    readonly authCacheEnabled: true;
+    readonly authReauthSkewSeconds: 60;
+    readonly requestTimeoutSeconds: 60;
+    readonly retryCount: 0;
+    readonly concurrency: 3;
+};
+/**
+ * Resolve configuration from CLI options and environment variables
+ * CLI options take precedence over environment variables
+ */
+export declare function resolveConfig(cliOptions: Partial<CliOptions>): CliOptions;
+/**
+ * Validate configuration and return any errors
+ */
+export declare function validateConfig(config: CliOptions): string[];
+/**
+ * Get default auth cache path based on XDG spec
+ */
+export declare function getDefaultAuthCachePath(): string;
+/**
+ * Get default checksum cache path based on XDG spec
+ */
+export declare function getDefaultChecksumCachePath(): string;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,mCAAmC;AACnC,eAAO,MAAM,QAAQ;;;;;;;;CAQX,CAAC;AASX;;;GAGG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,UAAU,CA6CzE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,EAAE,CAgB3D;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,CAMhD;AAED;;GAEG;AACH,wBAAgB,2BAA2B,IAAI,MAAM,CAMpD"}

package/dist/config.js

@@ -0,0 +1,95 @@
+/** Default configuration values */
+export const defaults = {
+    cacheEnabled: true,
+    cacheMaxMb: 4,
+    authCacheEnabled: true,
+    authReauthSkewSeconds: 60,
+    requestTimeoutSeconds: 60,
+    retryCount: 0,
+    concurrency: 3,
+};
+/** Environment variable names */
+const envVars = {
+    baseUrl: 'ROMM_BASE_URL',
+    username: 'ROMM_USERNAME',
+    password: 'ROMM_PASSWORD',
+};
+/**
+ * Resolve configuration from CLI options and environment variables
+ * CLI options take precedence over environment variables
+ */
+export function resolveConfig(cliOptions) {
+    const baseUrl = cliOptions.baseUrl ?? process.env[envVars.baseUrl] ?? '';
+    const username = cliOptions.username ?? process.env[envVars.username] ?? '';
+    const password = cliOptions.password ?? process.env[envVars.password];
+    return {
+        // Core connection
+        baseUrl,
+        username,
+        password,
+        // Platform
+        platform: cliOptions.platform,
+        // Input (arrays default to empty)
+        paths: cliOptions.paths ?? [],
+        uploadFiles: cliOptions.uploadFiles ?? [],
+        uploadDirs: cliOptions.uploadDirs ?? [],
+        globs: cliOptions.globs ?? [],
+        // Checksum
+        checksum: cliOptions.checksum ?? [],
+        cacheEnabled: cliOptions.cacheEnabled ?? defaults.cacheEnabled,
+        cacheMaxMb: cliOptions.cacheMaxMb ?? defaults.cacheMaxMb,
+        cachePath: cliOptions.cachePath,
+        // Auth
+        authCacheEnabled: cliOptions.authCacheEnabled ?? defaults.authCacheEnabled,
+        authCachePath: cliOptions.authCachePath,
+        authReauthSkewSeconds: cliOptions.authReauthSkewSeconds ?? defaults.authReauthSkewSeconds,
+        // Request
+        requestTimeoutSeconds: cliOptions.requestTimeoutSeconds ?? defaults.requestTimeoutSeconds,
+        retryCount: cliOptions.retryCount ?? defaults.retryCount,
+        // Behavior
+        recursive: cliOptions.recursive ?? false,
+        dryRun: cliOptions.dryRun ?? false,
+        concurrency: cliOptions.concurrency ?? defaults.concurrency,
+        // Output
+        json: cliOptions.json ?? false,
+        verbose: cliOptions.verbose ?? false,
+        listPlatforms: cliOptions.listPlatforms ?? false,
+    };
+}
+/**
+ * Validate configuration and return any errors
+ */
+export function validateConfig(config) {
+    const errors = [];
+    if (!config.baseUrl) {
+        errors.push('Missing required option: --base-url (or ROMM_BASE_URL env var)');
+    }
+    if (!config.username) {
+        errors.push('Missing required option: --username (or ROMM_USERNAME env var)');
+    }
+    // Password is required unless we're just listing platforms (and even then we need auth per PLAN)
+    // Per PLAN: "all ROMM API operations require authentication, including --list-platforms"
+    // But password may be omitted when a valid cached token exists
+    return errors;
+}
+/**
+ * Get default auth cache path based on XDG spec
+ */
+export function getDefaultAuthCachePath() {
+    const xdgCacheHome = process.env.XDG_CACHE_HOME;
+    if (xdgCacheHome) {
+        return `${xdgCacheHome}/romm-uploader/auth-token-cache.json`;
+    }
+    return `${process.env.HOME ?? '~'}/.cache/romm-uploader/auth-token-cache.json`;
+}
+/**
+ * Get default checksum cache path based on XDG spec
+ */
+export function getDefaultChecksumCachePath() {
+    const xdgCacheHome = process.env.XDG_CACHE_HOME;
+    if (xdgCacheHome) {
+        return `${xdgCacheHome}/romm-uploader/checksum-cache.json`;
+    }
+    return `${process.env.HOME ?? '~'}/.cache/romm-uploader/checksum-cache.json`;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AASA,mCAAmC;AACnC,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,YAAY,EAAE,IAAI;IAClB,UAAU,EAAE,CAAC;IACb,gBAAgB,EAAE,IAAI;IACtB,qBAAqB,EAAE,EAAE;IACzB,qBAAqB,EAAE,EAAE;IACzB,UAAU,EAAE,CAAC;IACb,WAAW,EAAE,CAAC;CACN,CAAC;AAEX,iCAAiC;AACjC,MAAM,OAAO,GAAG;IACd,OAAO,EAAE,eAAe;IACxB,QAAQ,EAAE,eAAe;IACzB,QAAQ,EAAE,eAAe;CACjB,CAAC;AAEX;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,UAA+B;IAC3D,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;IACzE,MAAM,QAAQ,GAAG,UAAU,CAAC,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;IAC5E,MAAM,QAAQ,GAAG,UAAU,CAAC,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAEtE,OAAO;QACL,kBAAkB;QAClB,OAAO;QACP,QAAQ;QACR,QAAQ;QAER,WAAW;QACX,QAAQ,EAAE,UAAU,CAAC,QAAQ;QAE7B,kCAAkC;QAClC,KAAK,EAAE,UAAU,CAAC,KAAK,IAAI,EAAE;QAC7B,WAAW,EAAE,UAAU,CAAC,WAAW,IAAI,EAAE;QACzC,UAAU,EAAE,UAAU,CAAC,UAAU,IAAI,EAAE;QACvC,KAAK,EAAE,UAAU,CAAC,KAAK,IAAI,EAAE;QAE7B,WAAW;QACX,QAAQ,EAAE,UAAU,CAAC,QAAQ,IAAI,EAAE;QACnC,YAAY,EAAE,UAAU,CAAC,YAAY,IAAI,QAAQ,CAAC,YAAY;QAC9D,UAAU,EAAE,UAAU,CAAC,UAAU,IAAI,QAAQ,CAAC,UAAU;QACxD,SAAS,EAAE,UAAU,CAAC,SAAS;QAE/B,OAAO;QACP,gBAAgB,EAAE,UAAU,CAAC,gBAAgB,IAAI,QAAQ,CAAC,gBAAgB;QAC1E,aAAa,EAAE,UAAU,CAAC,aAAa;QACvC,qBAAqB,EAAE,UAAU,CAAC,qBAAqB,IAAI,QAAQ,CAAC,qBAAqB;QAEzF,UAAU;QACV,qBAAqB,EAAE,UAAU,CAAC,qBAAqB,IAAI,QAAQ,CAAC,qBAAqB;QACzF,UAAU,EAAE,UAAU,CAAC,UAAU,IAAI,QAAQ,CAAC,UAAU;QAExD,WAAW;QACX,SAAS,EAAE,UAAU,CAAC,SAAS,IAAI,KAAK;QACxC,MAAM,EAAE,UAAU,CAAC,MAAM,IAAI,KAAK;QAClC,WAAW,EAAE,UAAU,CAAC,WAAW,IAAI,QAAQ,CAAC,WAAW;QAE3D,SAAS;QACT,IAAI,EAAE,UAAU,CAAC,IAAI,IAAI,KAAK;QAC9B,OAAO,EAAE,UAAU,CAAC,OAAO,IAAI,KAAK;QACpC,aAAa,EAAE,UAAU,CAAC,aAAa,IAAI,KAAK;KACjD,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,MAAkB;IAC/C,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,CAAC,IAAI,CAAC,gEAAgE,CAAC,CAAC;IAChF,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;QACrB,MAAM,CAAC,IAAI,CAAC,gEAAgE,CAAC,CAAC;IAChF,CAAC;IAED,iGAAiG;IACjG,yFAAyF;IACzF,+DAA+D;IAE/D,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB;IACrC,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;IAChD,IAAI,YAAY,EAAE,CAAC;QACjB,OAAO,GAAG,YAAY,sCAAsC,CAAC;IAC/D,CAAC;IACD,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,GAAG,6CAA6C,CAAC;AACjF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,2BAA2B;IACzC,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;IAChD,IAAI,YAAY,EAAE,CAAC;QACjB,OAAO,GAAG,YAAY,oCAAoC,CAAC;IAC7D,CAAC;IACD,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,GAAG,2CAA2C,CAAC;AAC/E,CAAC"}

package/dist/files/discover-files.d.ts

@@ -0,0 +1,9 @@
+import { FileInfo } from '../types.js';
+import { DiscoverOptions } from './discover-types.js';
+/**
+ * Discover files from all input sources
+ * Per PLAN: positional paths, --upload-file, --upload-dir, --glob
+ * Returns merged, deduplicated list
+ */
+export declare function discoverFiles(options: DiscoverOptions): Promise<FileInfo[]>;
+//# sourceMappingURL=discover-files.d.ts.map

package/dist/files/discover-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discover-files.d.ts","sourceRoot":"","sources":["../../src/files/discover-files.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAqBtD;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAoBjF"}

package/dist/files/discover-files.js

@@ -0,0 +1,34 @@
+import { discoverFromGlobs, discoverFromPaths, discoverFromUploadDirs, discoverFromUploadFiles, } from './discover-sources.js';
+function deduplicateFiles(files) {
+    const seen = new Set();
+    const unique = [];
+    for (const file of files) {
+        if (seen.has(file.absolutePath))
+            continue;
+        seen.add(file.absolutePath);
+        unique.push(file);
+    }
+    return unique;
+}
+/**
+ * Discover files from all input sources
+ * Per PLAN: positional paths, --upload-file, --upload-dir, --glob
+ * Returns merged, deduplicated list
+ */
+export async function discoverFiles(options) {
+    const allFiles = [];
+    if (options.paths.length > 0) {
+        allFiles.push(...(await discoverFromPaths(options.paths, options.recursive)));
+    }
+    if (options.uploadFiles.length > 0) {
+        allFiles.push(...(await discoverFromUploadFiles(options.uploadFiles)));
+    }
+    if (options.uploadDirs.length > 0) {
+        allFiles.push(...(await discoverFromUploadDirs(options.uploadDirs, options.recursive)));
+    }
+    if (options.globs.length > 0) {
+        allFiles.push(...(await discoverFromGlobs(options.globs)));
+    }
+    return deduplicateFiles(allFiles);
+}
+//# sourceMappingURL=discover-files.js.map

package/dist/files/discover-files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discover-files.js","sourceRoot":"","sources":["../../src/files/discover-files.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,uBAAuB,CAAC;AAE/B,SAAS,gBAAgB,CAAC,KAAiB;IACzC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,MAAM,GAAe,EAAE,CAAC;IAE9B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC;YAAE,SAAS;QAC1C,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAC5B,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpB,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,OAAwB;IAC1D,MAAM,QAAQ,GAAe,EAAE,CAAC;IAEhC,IAAI,OAAO,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7B,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,iBAAiB,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IAChF,CAAC;IAED,IAAI,OAAO,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACnC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,uBAAuB,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IACzE,CAAC;IAED,IAAI,OAAO,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,sBAAsB,CAAC,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IAC1F,CAAC;IAED,IAAI,OAAO,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7B,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,iBAAiB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC7D,CAAC;IAED,OAAO,gBAAgB,CAAC,QAAQ,CAAC,CAAC;AACpC,CAAC"}

package/dist/files/discover-sources.d.ts

@@ -0,0 +1,6 @@
+import { FileInfo } from '../types.js';
+export declare function discoverFromPaths(paths: string[], recursive: boolean): Promise<FileInfo[]>;
+export declare function discoverFromUploadFiles(filePaths: string[]): Promise<FileInfo[]>;
+export declare function discoverFromUploadDirs(dirPaths: string[], recursive: boolean): Promise<FileInfo[]>;
+export declare function discoverFromGlobs(patterns: string[]): Promise<FileInfo[]>;
+//# sourceMappingURL=discover-sources.d.ts.map

package/dist/files/discover-sources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discover-sources.d.ts","sourceRoot":"","sources":["../../src/files/discover-sources.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAGvC,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CA2BhG;AAED,wBAAsB,uBAAuB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAWtF;AAED,wBAAsB,sBAAsB,CAC1C,QAAQ,EAAE,MAAM,EAAE,EAClB,SAAS,EAAE,OAAO,GACjB,OAAO,CAAC,QAAQ,EAAE,CAAC,CAuBrB;AAED,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAQ/E"}

package/dist/files/discover-sources.js

@@ -0,0 +1,69 @@
+import { promises as fs } from 'fs';
+import { resolve } from 'path';
+import fg from 'fast-glob';
+import { collectFileInfos, listDirectoryFiles, toFileInfo, warn } from './file-info.js';
+export async function discoverFromPaths(paths, recursive) {
+    const files = [];
+    for (const inputPath of paths) {
+        const absolutePath = resolve(inputPath);
+        try {
+            const stats = await fs.stat(absolutePath);
+            if (stats.isFile()) {
+                const info = await toFileInfo(absolutePath);
+                if (info)
+                    files.push(info);
+                continue;
+            }
+            if (stats.isDirectory()) {
+                const discovered = await listDirectoryFiles(absolutePath, recursive);
+                files.push(...(await collectFileInfos(discovered)));
+            }
+        }
+        catch (error) {
+            warn(`Cannot access ${inputPath}: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    return files;
+}
+export async function discoverFromUploadFiles(filePaths) {
+    const files = [];
+    for (const filePath of filePaths) {
+        const info = await toFileInfo(filePath);
+        if (info) {
+            files.push(info);
+        }
+        else {
+            warn(`Cannot read file ${filePath}`);
+        }
+    }
+    return files;
+}
+export async function discoverFromUploadDirs(dirPaths, recursive) {
+    const files = [];
+    for (const dirPath of dirPaths) {
+        try {
+            const absoluteDir = resolve(dirPath);
+            const stats = await fs.stat(absoluteDir);
+            if (!stats.isDirectory()) {
+                warn(`${dirPath} is not a directory`);
+                continue;
+            }
+            const discovered = await listDirectoryFiles(absoluteDir, recursive);
+            files.push(...(await collectFileInfos(discovered)));
+        }
+        catch (error) {
+            warn(`Cannot access directory ${dirPath}: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    return files;
+}
+export async function discoverFromGlobs(patterns) {
+    const globFiles = await fg(patterns, {
+        absolute: true,
+        onlyFiles: true,
+        dot: false,
+    });
+    globFiles.sort();
+    return collectFileInfos(globFiles);
+}
+//# sourceMappingURL=discover-sources.js.map

package/dist/files/discover-sources.js.map

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

package/dist/files/discover-types.d.ts

@@ -0,0 +1,8 @@
+export interface DiscoverOptions {
+    paths: string[];
+    uploadFiles: string[];
+    uploadDirs: string[];
+    globs: string[];
+    recursive: boolean;
+}
+//# sourceMappingURL=discover-types.d.ts.map

package/dist/files/discover-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discover-types.d.ts","sourceRoot":"","sources":["../../src/files/discover-types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;CACpB"}

package/dist/files/discover-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=discover-types.js.map

package/dist/files/discover-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discover-types.js","sourceRoot":"","sources":["../../src/files/discover-types.ts"],"names":[],"mappings":""}

package/dist/files/file-info.d.ts

@@ -0,0 +1,6 @@
+import { FileInfo } from '../types.js';
+export declare function warn(message: string): void;
+export declare function toFileInfo(filePath: string): Promise<FileInfo | null>;
+export declare function collectFileInfos(paths: string[]): Promise<FileInfo[]>;
+export declare function listDirectoryFiles(directory: string, recursive: boolean): Promise<string[]>;
+//# sourceMappingURL=file-info.d.ts.map

package/dist/files/file-info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-info.d.ts","sourceRoot":"","sources":["../../src/files/file-info.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE1C;AAED,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAc3E;AAED,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAS3E;AAED,wBAAsB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAUjG"}

package/dist/files/file-info.js

@@ -0,0 +1,44 @@
+import { promises as fs } from 'fs';
+import { resolve } from 'path';
+import fg from 'fast-glob';
+export function warn(message) {
+    console.warn(`⚠️  Warning: ${message}`);
+}
+export async function toFileInfo(filePath) {
+    try {
+        const absolutePath = resolve(filePath);
+        const stats = await fs.stat(absolutePath);
+        if (!stats.isFile())
+            return null;
+        return {
+            absolutePath,
+            size: stats.size,
+            mtime: stats.mtime.getTime(),
+        };
+    }
+    catch {
+        return null;
+    }
+}
+export async function collectFileInfos(paths) {
+    const results = [];
+    for (const filePath of paths) {
+        const info = await toFileInfo(filePath);
+        if (info) {
+            results.push(info);
+        }
+    }
+    return results;
+}
+export async function listDirectoryFiles(directory, recursive) {
+    const pattern = recursive ? '**/*' : '*';
+    const files = await fg(pattern, {
+        cwd: directory,
+        absolute: true,
+        onlyFiles: true,
+        dot: false,
+    });
+    files.sort();
+    return files;
+}
+//# sourceMappingURL=file-info.js.map

package/dist/files/file-info.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-info.js","sourceRoot":"","sources":["../../src/files/file-info.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,IAAI,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAC/B,OAAO,EAAE,MAAM,WAAW,CAAC;AAG3B,MAAM,UAAU,IAAI,CAAC,OAAe;IAClC,OAAO,CAAC,IAAI,CAAC,gBAAgB,OAAO,EAAE,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,QAAgB;IAC/C,IAAI,CAAC;QACH,MAAM,YAAY,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;QACvC,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAC1C,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE;YAAE,OAAO,IAAI,CAAC;QAEjC,OAAO;YACL,YAAY;YACZ,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE;SAC7B,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,KAAe;IACpD,MAAM,OAAO,GAAe,EAAE,CAAC;IAC/B,KAAK,MAAM,QAAQ,IAAI,KAAK,EAAE,CAAC;QAC7B,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,QAAQ,CAAC,CAAC;QACxC,IAAI,IAAI,EAAE,CAAC;YACT,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,SAAiB,EAAE,SAAkB;IAC5E,MAAM,OAAO,GAAG,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC;IACzC,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,OAAO,EAAE;QAC9B,GAAG,EAAE,SAAS;QACd,QAAQ,EAAE,IAAI;QACd,SAAS,EAAE,IAAI;QACf,GAAG,EAAE,KAAK;KACX,CAAC,CAAC;IACH,KAAK,CAAC,IAAI,EAAE,CAAC;IACb,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/output/planner.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Print planned actions based on configuration
+ */
+import type { CliOptions } from '../types.js';
+export declare function printPlannedActions(config: CliOptions): void;
+//# sourceMappingURL=planner.d.ts.map

package/dist/output/planner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planner.d.ts","sourceRoot":"","sources":["../../src/output/planner.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAmF5D"}

package/dist/output/planner.js

@@ -0,0 +1,77 @@
+/**
+ * Print planned actions based on configuration
+ */
+export function printPlannedActions(config) {
+    process.stderr.write('\nplan:\n');
+    // Connection info
+    process.stderr.write(`base_url=${config.baseUrl || '(not set)'}\n`);
+    process.stderr.write(`username=${config.username || '(not set)'}\n`);
+    process.stderr.write(`Password: ${config.password ? '(provided)' : '(not set; cached token may be used if available)'}`);
+    process.stderr.write('\n');
+    // Platform
+    if (config.platform) {
+        process.stderr.write(`platform=${config.platform}\n`);
+    }
+    else if (config.listPlatforms) {
+        process.stderr.write('mode=list-platforms\n');
+    }
+    else {
+        process.stderr.write('platform=(not set)\n');
+    }
+    // Input sources
+    process.stderr.write('inputs:\n');
+    if (config.paths.length > 0) {
+        process.stderr.write(`  paths=${config.paths.length}\n`);
+        config.paths.forEach((p) => process.stderr.write(`    ${p}\n`));
+    }
+    if (config.uploadFiles.length > 0) {
+        process.stderr.write(`  upload_file=${config.uploadFiles.length}\n`);
+        config.uploadFiles.forEach((p) => process.stderr.write(`    ${p}\n`));
+    }
+    if (config.uploadDirs.length > 0) {
+        process.stderr.write(`  upload_dir=${config.uploadDirs.length}\n`);
+        config.uploadDirs.forEach((p) => process.stderr.write(`    ${p}\n`));
+    }
+    if (config.globs.length > 0) {
+        process.stderr.write(`  glob=${config.globs.length}\n`);
+        config.globs.forEach((p) => process.stderr.write(`    ${p}\n`));
+    }
+    if (config.paths.length === 0 &&
+        config.uploadFiles.length === 0 &&
+        config.uploadDirs.length === 0 &&
+        config.globs.length === 0 &&
+        !config.listPlatforms) {
+        process.stderr.write('  (none)\n');
+    }
+    // Checksum settings
+    process.stderr.write('checksum:\n');
+    process.stderr.write(`  cache_enabled=${config.cacheEnabled}\n`);
+    process.stderr.write(`  cache_max_mb=${config.cacheMaxMb}\n`);
+    if (config.cachePath) {
+        process.stderr.write(`  cache_path=${config.cachePath}\n`);
+    }
+    if (config.checksum.length > 0) {
+        process.stderr.write(`  additional=${config.checksum.join(', ')}\n`);
+    }
+    // Auth settings
+    process.stderr.write('auth:\n');
+    process.stderr.write(`  cache_enabled=${config.authCacheEnabled}\n`);
+    if (config.authCachePath) {
+        process.stderr.write(`  cache_path=${config.authCachePath}\n`);
+    }
+    process.stderr.write(`  reauth_skew_seconds=${config.authReauthSkewSeconds}\n`);
+    // Request settings
+    process.stderr.write('request:\n');
+    process.stderr.write(`  timeout_seconds=${config.requestTimeoutSeconds}\n`);
+    process.stderr.write(`  retry_count=${config.retryCount}\n`);
+    // Behavior
+    process.stderr.write('behavior:\n');
+    process.stderr.write(`  recursive=${config.recursive}\n`);
+    process.stderr.write(`  dry_run=${config.dryRun}\n`);
+    process.stderr.write(`  concurrency=${config.concurrency}\n`);
+    // Output
+    process.stderr.write('output:\n');
+    process.stderr.write(`  json=${config.json}\n`);
+    process.stderr.write(`  verbose=${config.verbose}\n`);
+}
+//# sourceMappingURL=planner.js.map

package/dist/output/planner.js.map

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