romm-uploader 0.1.1-beta.0

package/dist/output/records.d.ts

@@ -0,0 +1,16 @@
+import { ChecksumData, FileInfo } from '../types.js';
+export declare function formatDryRecord(options: {
+    file: FileInfo;
+    checksums: ChecksumData;
+    cached: boolean;
+    exists?: boolean;
+    romName?: string;
+}): string;
+export declare function formatUploadRecord(options: {
+    status: 'uploaded' | 'skipped' | 'failed';
+    file: FileInfo;
+    reason?: string;
+    romName?: string;
+    error?: string;
+}): string;
+//# sourceMappingURL=records.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"records.d.ts","sourceRoot":"","sources":["../../src/output/records.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AASrD,wBAAgB,eAAe,CAAC,OAAO,EAAE;IACvC,IAAI,EAAE,QAAQ,CAAC;IACf,SAAS,EAAE,YAAY,CAAC;IACxB,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GAAG,MAAM,CAaT;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE;IAC1C,MAAM,EAAE,UAAU,GAAG,SAAS,GAAG,QAAQ,CAAC;IAC1C,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,MAAM,CAaT"}

package/dist/output/records.js

@@ -0,0 +1,31 @@
+function toKeyValuePairs(fields) {
+    return fields
+        .filter(([, value]) => value !== undefined)
+        .map(([key, value]) => `${key}=${value}`)
+        .join('\t');
+}
+export function formatDryRecord(options) {
+    const { file, checksums, cached, exists, romName } = options;
+    const status = exists === true ? 'existing' : exists === false ? 'new' : 'unknown';
+    const kv = toKeyValuePairs([
+        ['source', cached ? 'cache' : 'computed'],
+        ['crc32', checksums.crc32],
+        ['md5', checksums.md5],
+        ['sha1', checksums.sha1],
+        ['rom', romName],
+    ]);
+    return `${status}\t${file.absolutePath}\t${kv}`;
+}
+export function formatUploadRecord(options) {
+    const { status, file, reason, romName, error } = options;
+    const kv = toKeyValuePairs([
+        ['reason', reason],
+        ['rom', romName],
+        ['error', error],
+    ]);
+    if (!kv) {
+        return `${status}\t${file.absolutePath}`;
+    }
+    return `${status}\t${file.absolutePath}\t${kv}`;
+}
+//# sourceMappingURL=records.js.map

package/dist/output/records.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"records.js","sourceRoot":"","sources":["../../src/output/records.ts"],"names":[],"mappings":"AAEA,SAAS,eAAe,CAAC,MAA2C;IAClE,OAAO,MAAM;SACV,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,KAAK,SAAS,CAAC;SAC1C,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,IAAI,KAAK,EAAE,CAAC;SACxC,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAM/B;IACC,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;IAC7D,MAAM,MAAM,GAAG,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IAEnF,MAAM,EAAE,GAAG,eAAe,CAAC;QACzB,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC;QACzC,CAAC,OAAO,EAAE,SAAS,CAAC,KAAK,CAAC;QAC1B,CAAC,KAAK,EAAE,SAAS,CAAC,GAAG,CAAC;QACtB,CAAC,MAAM,EAAE,SAAS,CAAC,IAAI,CAAC;QACxB,CAAC,KAAK,EAAE,OAAO,CAAC;KACjB,CAAC,CAAC;IAEH,OAAO,GAAG,MAAM,KAAK,IAAI,CAAC,YAAY,KAAK,EAAE,EAAE,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,OAMlC;IACC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC;IACzD,MAAM,EAAE,GAAG,eAAe,CAAC;QACzB,CAAC,QAAQ,EAAE,MAAM,CAAC;QAClB,CAAC,KAAK,EAAE,OAAO,CAAC;QAChB,CAAC,OAAO,EAAE,KAAK,CAAC;KACjB,CAAC,CAAC;IAEH,IAAI,CAAC,EAAE,EAAE,CAAC;QACR,OAAO,GAAG,MAAM,KAAK,IAAI,CAAC,YAAY,EAAE,CAAC;IAC3C,CAAC;IAED,OAAO,GAAG,MAAM,KAAK,IAAI,CAAC,YAAY,KAAK,EAAE,EAAE,CAAC;AAClD,CAAC"}

package/dist/output/reporter.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Output reporter module
+ * Plain text and JSON output formatting
+ */
+import { FileResult, RunSummary } from '../types.js';
+export interface ReporterOptions {
+    json: boolean;
+    verbose: boolean;
+}
+export declare class Reporter {
+    private options;
+    constructor(options: ReporterOptions);
+    /**
+     * Report file discovery results
+     */
+    reportDiscovery(fileCount: number): void;
+    /**
+     * Report checksum computation
+     */
+    reportChecksum(filePath: string, algorithm: string): void;
+    /**
+     * Report file result
+     */
+    reportFileResult(result: FileResult): void;
+    /**
+     * Report final summary
+     */
+    reportSummary(summary: RunSummary): void;
+    /**
+     * Report platforms list
+     */
+    reportPlatforms(platforms: Array<{
+        id: number;
+        slug: string;
+        name: string;
+    }>): void;
+}
+//# sourceMappingURL=reporter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reporter.d.ts","sourceRoot":"","sources":["../../src/output/reporter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAErD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,qBAAa,QAAQ;IACnB,OAAO,CAAC,OAAO,CAAkB;gBAErB,OAAO,EAAE,eAAe;IAIpC;;OAEG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAKxC;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAKzD;;OAEG;IACH,gBAAgB,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAU1C;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI;IAcxC;;OAEG;IACH,eAAe,CAAC,SAAS,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,IAAI;CAWpF"}

package/dist/output/reporter.js

@@ -0,0 +1,66 @@
+/**
+ * Output reporter module
+ * Plain text and JSON output formatting
+ */
+export class Reporter {
+    options;
+    constructor(options) {
+        this.options = options;
+    }
+    /**
+     * Report file discovery results
+     */
+    reportDiscovery(fileCount) {
+        if (this.options.json)
+            return;
+        console.log(`discovered ${fileCount} files`);
+    }
+    /**
+     * Report checksum computation
+     */
+    reportChecksum(filePath, algorithm) {
+        if (!this.options.verbose)
+            return;
+        console.log(`checksum ${algorithm} ${filePath}`);
+    }
+    /**
+     * Report file result
+     */
+    reportFileResult(result) {
+        if (this.options.json)
+            return;
+        console.log(`${result.status}\t${result.path}`);
+        if (result.error) {
+            console.log(`   Error: ${result.error}`);
+        }
+    }
+    /**
+     * Report final summary
+     */
+    reportSummary(summary) {
+        if (this.options.json) {
+            console.log(JSON.stringify({ summary }, null, 2));
+            return;
+        }
+        console.log('summary');
+        console.log(`total_scanned=${summary.totalScanned}`);
+        console.log(`already_existing=${summary.alreadyExisting}`);
+        console.log(`uploaded=${summary.uploaded}`);
+        console.log(`failed=${summary.failed}`);
+        console.log(`elapsed_seconds=${(summary.elapsedMs / 1000).toFixed(2)}`);
+    }
+    /**
+     * Report platforms list
+     */
+    reportPlatforms(platforms) {
+        if (this.options.json) {
+            console.log(JSON.stringify({ platforms }, null, 2));
+            return;
+        }
+        console.log('id\tslug\tname');
+        platforms.forEach((p) => {
+            console.log(`${p.id}\t${p.slug}\t${p.name}`);
+        });
+    }
+}
+//# sourceMappingURL=reporter.js.map

package/dist/output/reporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reporter.js","sourceRoot":"","sources":["../../src/output/reporter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AASH,MAAM,OAAO,QAAQ;IACX,OAAO,CAAkB;IAEjC,YAAY,OAAwB;QAClC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,eAAe,CAAC,SAAiB;QAC/B,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI;YAAE,OAAO;QAC9B,OAAO,CAAC,GAAG,CAAC,cAAc,SAAS,QAAQ,CAAC,CAAC;IAC/C,CAAC;IAED;;OAEG;IACH,cAAc,CAAC,QAAgB,EAAE,SAAiB;QAChD,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO;YAAE,OAAO;QAClC,OAAO,CAAC,GAAG,CAAC,YAAY,SAAS,IAAI,QAAQ,EAAE,CAAC,CAAC;IACnD,CAAC;IAED;;OAEG;IACH,gBAAgB,CAAC,MAAkB;QACjC,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI;YAAE,OAAO;QAE9B,OAAO,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QAEhD,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YACjB,OAAO,CAAC,GAAG,CAAC,aAAa,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,OAAmB;QAC/B,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;YACtB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YAClD,OAAO;QACT,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACvB,OAAO,CAAC,GAAG,CAAC,iBAAiB,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;QACrD,OAAO,CAAC,GAAG,CAAC,oBAAoB,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;QAC3D,OAAO,CAAC,GAAG,CAAC,YAAY,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC5C,OAAO,CAAC,GAAG,CAAC,UAAU,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QACxC,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAC1E,CAAC;IAED;;OAEG;IACH,eAAe,CAAC,SAA4D;QAC1E,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;YACtB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YACpD,OAAO;QACT,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;QAC9B,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE;YACtB,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QAC/C,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/romm/auth-cache.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Authentication token cache
+ * Persists tokens to disk for reuse across runs
+ */
+import { AuthTokenCache } from '../types.js';
+export interface AuthCacheOptions {
+    enabled: boolean;
+    cachePath?: string;
+    reauthSkewSeconds: number;
+}
+/**
+ * Get default auth cache path based on XDG spec
+ */
+export declare function getDefaultAuthCachePath(): string;
+/**
+ * Get cached token if valid
+ */
+export declare function getCachedToken(baseUrl: string, username: string, options: AuthCacheOptions): Promise<AuthTokenCache | null>;
+/**
+ * Store token in cache
+ */
+export declare function setCachedToken(baseUrl: string, username: string, token: AuthTokenCache, options: AuthCacheOptions): Promise<void>;
+/**
+ * Clear cached token
+ */
+export declare function clearCachedToken(baseUrl: string, username: string, options: AuthCacheOptions): Promise<void>;
+//# sourceMappingURL=auth-cache.d.ts.map

package/dist/romm/auth-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-cache.d.ts","sourceRoot":"","sources":["../../src/romm/auth-cache.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAK7C,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,CAMhD;AA2DD;;GAEG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAyBhC;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,IAAI,CAAC,CAef;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,IAAI,CAAC,CASf"}

package/dist/romm/auth-cache.js

@@ -0,0 +1,115 @@
+/**
+ * Authentication token cache
+ * Persists tokens to disk for reuse across runs
+ */
+import { readFile, writeFile, mkdir } from 'fs/promises';
+import { existsSync } from 'fs';
+import { dirname } from 'path';
+/**
+ * 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`;
+}
+/**
+ * Generate cache key from base URL and username
+ */
+function getCacheKey(baseUrl, username) {
+    return `${baseUrl}:${username}`;
+}
+/**
+ * Load cache from disk
+ */
+async function loadCache(cachePath) {
+    try {
+        if (!existsSync(cachePath)) {
+            return {};
+        }
+        const data = await readFile(cachePath, 'utf-8');
+        return JSON.parse(data);
+    }
+    catch {
+        // If cache is corrupt, start fresh
+        return {};
+    }
+}
+/**
+ * Save cache to disk atomically
+ */
+async function saveCache(cachePath, data) {
+    try {
+        const dir = dirname(cachePath);
+        if (!existsSync(dir)) {
+            await mkdir(dir, { recursive: true, mode: 0o700 });
+        }
+        // Write to temp file then rename for atomic operation
+        const tempPath = `${cachePath}.tmp`;
+        await writeFile(tempPath, JSON.stringify(data, null, 2), { mode: 0o600 });
+        // Rename is atomic on POSIX systems
+        const { rename } = await import('fs/promises');
+        await rename(tempPath, cachePath);
+    }
+    catch (error) {
+        console.warn(`⚠️  Warning: Failed to save auth cache: ${error instanceof Error ? error.message : 'Unknown error'}`);
+    }
+}
+/**
+ * Get cached token if valid
+ */
+export async function getCachedToken(baseUrl, username, options) {
+    if (!options.enabled)
+        return null;
+    const cachePath = options.cachePath ?? getDefaultAuthCachePath();
+    const cache = await loadCache(cachePath);
+    const key = getCacheKey(baseUrl, username);
+    const entry = cache[key];
+    if (!entry)
+        return null;
+    // Check if token is still valid (with skew)
+    const now = Date.now();
+    const validUntil = entry.expiresAtEpochMs - (options.reauthSkewSeconds * 1000);
+    if (now >= validUntil) {
+        // Token expired or will expire soon
+        return null;
+    }
+    return {
+        accessToken: entry.accessToken,
+        tokenType: entry.tokenType,
+        expiresAtEpochMs: entry.expiresAtEpochMs,
+        issuedAtEpochMs: entry.issuedAtEpochMs,
+    };
+}
+/**
+ * Store token in cache
+ */
+export async function setCachedToken(baseUrl, username, token, options) {
+    if (!options.enabled)
+        return;
+    const cachePath = options.cachePath ?? getDefaultAuthCachePath();
+    const cache = await loadCache(cachePath);
+    const key = getCacheKey(baseUrl, username);
+    cache[key] = {
+        accessToken: token.accessToken,
+        tokenType: token.tokenType,
+        expiresAtEpochMs: token.expiresAtEpochMs,
+        issuedAtEpochMs: token.issuedAtEpochMs,
+    };
+    await saveCache(cachePath, cache);
+}
+/**
+ * Clear cached token
+ */
+export async function clearCachedToken(baseUrl, username, options) {
+    if (!options.enabled)
+        return;
+    const cachePath = options.cachePath ?? getDefaultAuthCachePath();
+    const cache = await loadCache(cachePath);
+    const key = getCacheKey(baseUrl, username);
+    delete cache[key];
+    await saveCache(cachePath, cache);
+}
+//# sourceMappingURL=auth-cache.js.map

package/dist/romm/auth-cache.js.map

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

package/dist/romm/client-http.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Shared HTTP retry behavior for RomM client operations.
+ */
+export declare function fetchWithRetry(url: string, options: RequestInit, requestTimeoutSeconds: number, retryCount: number, attempt?: number): Promise<Response>;
+//# sourceMappingURL=client-http.d.ts.map

package/dist/romm/client-http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-http.d.ts","sourceRoot":"","sources":["../../src/romm/client-http.ts"],"names":[],"mappings":"AAAA;;GAEG;AAYH,wBAAsB,cAAc,CAClC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,WAAW,EACpB,qBAAqB,EAAE,MAAM,EAC7B,UAAU,EAAE,MAAM,EAClB,OAAO,SAAI,GACV,OAAO,CAAC,QAAQ,CAAC,CAqCnB"}

package/dist/romm/client-http.js

@@ -0,0 +1,44 @@
+/**
+ * Shared HTTP retry behavior for RomM client operations.
+ */
+const RETRYABLE_STATUS_CODES = [408, 429, 500, 502, 503, 504];
+function calculateBackoff(attempt) {
+    const baseDelay = 500;
+    const maxDelay = 5000;
+    const delay = Math.min(baseDelay * Math.pow(2, attempt), maxDelay);
+    const jitter = delay * 0.1 * (Math.random() * 2 - 1);
+    return delay + jitter;
+}
+export async function fetchWithRetry(url, options, requestTimeoutSeconds, retryCount, attempt = 0) {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), requestTimeoutSeconds * 1000);
+    try {
+        const response = await fetch(url, {
+            ...options,
+            signal: controller.signal,
+        });
+        if (retryCount > 0 &&
+            attempt < retryCount &&
+            (RETRYABLE_STATUS_CODES.includes(response.status) || !response.ok)) {
+            const delay = calculateBackoff(attempt);
+            await new Promise((resolve) => setTimeout(resolve, delay));
+            return fetchWithRetry(url, options, requestTimeoutSeconds, retryCount, attempt + 1);
+        }
+        return response;
+    }
+    catch (error) {
+        if (retryCount > 0 &&
+            attempt < retryCount &&
+            error instanceof Error &&
+            (error.name === 'TypeError' || error.name === 'FetchError')) {
+            const delay = calculateBackoff(attempt);
+            await new Promise((resolve) => setTimeout(resolve, delay));
+            return fetchWithRetry(url, options, requestTimeoutSeconds, retryCount, attempt + 1);
+        }
+        throw error;
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+}
+//# sourceMappingURL=client-http.js.map

package/dist/romm/client-http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-http.js","sourceRoot":"","sources":["../../src/romm/client-http.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,sBAAsB,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;AAE9D,SAAS,gBAAgB,CAAC,OAAe;IACvC,MAAM,SAAS,GAAG,GAAG,CAAC;IACtB,MAAM,QAAQ,GAAG,IAAI,CAAC;IACtB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,QAAQ,CAAC,CAAC;IACnE,MAAM,MAAM,GAAG,KAAK,GAAG,GAAG,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IACrD,OAAO,KAAK,GAAG,MAAM,CAAC;AACxB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,GAAW,EACX,OAAoB,EACpB,qBAA6B,EAC7B,UAAkB,EAClB,OAAO,GAAG,CAAC;IAEX,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,qBAAqB,GAAG,IAAI,CAAC,CAAC;IAEnF,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAChC,GAAG,OAAO;YACV,MAAM,EAAE,UAAU,CAAC,MAAM;SAC1B,CAAC,CAAC;QAEH,IACE,UAAU,GAAG,CAAC;YACd,OAAO,GAAG,UAAU;YACpB,CAAC,sBAAsB,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,EAClE,CAAC;YACD,MAAM,KAAK,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;YACxC,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;YAC3D,OAAO,cAAc,CAAC,GAAG,EAAE,OAAO,EAAE,qBAAqB,EAAE,UAAU,EAAE,OAAO,GAAG,CAAC,CAAC,CAAC;QACtF,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IACE,UAAU,GAAG,CAAC;YACd,OAAO,GAAG,UAAU;YACpB,KAAK,YAAY,KAAK;YACtB,CAAC,KAAK,CAAC,IAAI,KAAK,WAAW,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,CAAC,EAC3D,CAAC;YACD,MAAM,KAAK,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;YACxC,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;YAC3D,OAAO,cAAc,CAAC,GAAG,EAAE,OAAO,EAAE,qBAAqB,EAAE,UAAU,EAAE,OAAO,GAAG,CAAC,CAAC,CAAC;QACtF,CAAC;QAED,MAAM,KAAK,CAAC;IACd,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,OAAO,CAAC,CAAC;IACxB,CAAC;AACH,CAAC"}

package/dist/romm/client-mappers.d.ts

@@ -0,0 +1,18 @@
+import { Platform, RomLookupResult } from '../types.js';
+import { RommFilesResponse, RommPlatformResponse, RommRomResponse } from './client-types.js';
+export declare function mapPlatform(response: RommPlatformResponse): Platform;
+export declare function mapPlatforms(responses: RommPlatformResponse[]): Platform[];
+export declare function mapLookupResult(response: RommRomResponse): RomLookupResult;
+export declare function mapFilesByFilename(response: RommFilesResponse): Array<{
+    id: number;
+    name: string;
+    platformId: number;
+    platformSlug: string;
+    fileName: string;
+    fileSize: number;
+    crcHash?: string;
+    md5Hash?: string;
+    sha1Hash?: string;
+}>;
+export declare function resolvePlatformId(platforms: Platform[], platformValue: string): number;
+//# sourceMappingURL=client-mappers.d.ts.map

package/dist/romm/client-mappers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-mappers.d.ts","sourceRoot":"","sources":["../../src/romm/client-mappers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAE7F,wBAAgB,WAAW,CAAC,QAAQ,EAAE,oBAAoB,GAAG,QAAQ,CAQpE;AAED,wBAAgB,YAAY,CAAC,SAAS,EAAE,oBAAoB,EAAE,GAAG,QAAQ,EAAE,CAE1E;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,eAAe,GAAG,eAAe,CAgB1E;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,iBAAiB,GAC9D,KAAK,CAAC;IACJ,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC,CAYD;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,QAAQ,EAAE,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CA+BtF"}

package/dist/romm/client-mappers.js

@@ -0,0 +1,66 @@
+export function mapPlatform(response) {
+    return {
+        id: response.id,
+        slug: response.slug,
+        fsSlug: response.fs_slug,
+        name: response.name,
+        customName: response.custom_name,
+    };
+}
+export function mapPlatforms(responses) {
+    return responses.map(mapPlatform);
+}
+export function mapLookupResult(response) {
+    return {
+        exists: true,
+        rom: {
+            id: response.id,
+            name: response.name,
+            platformId: response.platform_id,
+            platformSlug: response.platform_slug,
+            fileName: response.file_name,
+            fileSize: response.file_size,
+            crcHash: response.crc_hash,
+            md5Hash: response.md5_hash,
+            sha1Hash: response.sha1_hash,
+            raHash: response.ra_hash,
+        },
+    };
+}
+export function mapFilesByFilename(response) {
+    return response.items.map((item) => ({
+        id: item.id,
+        name: item.name,
+        platformId: item.platform_id,
+        platformSlug: item.platform_slug,
+        fileName: item.file_name,
+        fileSize: item.file_size,
+        crcHash: item.crc_hash,
+        md5Hash: item.md5_hash,
+        sha1Hash: item.sha1_hash,
+    }));
+}
+export function resolvePlatformId(platforms, platformValue) {
+    const numericId = Number.parseInt(platformValue, 10);
+    if (!Number.isNaN(numericId)) {
+        const platform = platforms.find((p) => p.id === numericId);
+        if (platform)
+            return platform.id;
+        throw new Error(`Platform ID ${platformValue} not found`);
+    }
+    const slugMatch = platforms.find((p) => p.slug === platformValue);
+    if (slugMatch)
+        return slugMatch.id;
+    const nameMatches = platforms.filter((p) => p.name.toLowerCase() === platformValue.toLowerCase());
+    if (nameMatches.length === 1) {
+        return nameMatches[0].id;
+    }
+    if (nameMatches.length > 1) {
+        throw new Error(`Platform name "${platformValue}" is ambiguous. ` +
+            `Multiple matches: ${nameMatches.map((p) => `${p.name} (ID: ${p.id})`).join(', ')}. ` +
+            `Please use the platform ID or slug.`);
+    }
+    throw new Error(`Platform "${platformValue}" not found. ` +
+        `Use --list-platforms to see available platforms.`);
+}
+//# sourceMappingURL=client-mappers.js.map

package/dist/romm/client-mappers.js.map

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

package/dist/romm/client-session.d.ts

@@ -0,0 +1,23 @@
+import { RommClientOptions } from './client.js';
+interface RommSessionDeps {
+    fetchWithRetry: (url: string, options: RequestInit) => Promise<Response>;
+    getUrl: (path: string) => string;
+}
+/**
+ * Manages auth/session state for the RomM API client.
+ */
+export declare class RommSession {
+    private _options;
+    private _deps;
+    private _tokenCache?;
+    private _accessToken?;
+    private _authAttempted;
+    constructor(options: RommClientOptions, deps: RommSessionDeps);
+    get accessToken(): string | undefined;
+    initialize(): Promise<void>;
+    ensureAuthenticated(): Promise<string>;
+    authenticate(): Promise<void>;
+    fetch(path: string, options?: RequestInit): Promise<Response>;
+}
+export {};
+//# sourceMappingURL=client-session.d.ts.map

package/dist/romm/client-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-session.d.ts","sourceRoot":"","sources":["../../src/romm/client-session.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD,UAAU,eAAe;IACvB,cAAc,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IACzE,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;CAClC;AAED;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAoB;IACpC,OAAO,CAAC,KAAK,CAAkB;IAC/B,OAAO,CAAC,WAAW,CAAC,CAAiB;IACrC,OAAO,CAAC,YAAY,CAAC,CAAS;IAC9B,OAAO,CAAC,cAAc,CAAS;gBAEnB,OAAO,EAAE,iBAAiB,EAAE,IAAI,EAAE,eAAe;IAM7D,IAAI,WAAW,IAAI,MAAM,GAAG,SAAS,CAEpC;IAEK,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAe3B,mBAAmB,IAAI,OAAO,CAAC,MAAM,CAAC;IAQtC,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAuD7B,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,QAAQ,CAAC;CAmCxE"}

package/dist/romm/client-session.js

@@ -0,0 +1,116 @@
+import { clearCachedToken, getCachedToken, setCachedToken } from './auth-cache.js';
+/**
+ * Manages auth/session state for the RomM API client.
+ */
+export class RommSession {
+    _options;
+    _deps;
+    _tokenCache;
+    _accessToken;
+    _authAttempted = false;
+    constructor(options, deps) {
+        this._options = options;
+        this._deps = deps;
+        this._tokenCache = undefined;
+    }
+    get accessToken() {
+        return this._accessToken;
+    }
+    async initialize() {
+        if (!this._options.authCacheEnabled)
+            return;
+        const cached = await getCachedToken(this._options.baseUrl, this._options.username, {
+            enabled: this._options.authCacheEnabled,
+            cachePath: this._options.authCachePath,
+            reauthSkewSeconds: this._options.authReauthSkewSeconds,
+        });
+        if (cached) {
+            this._tokenCache = cached;
+            this._accessToken = cached.accessToken;
+        }
+    }
+    async ensureAuthenticated() {
+        if (!this._accessToken) {
+            await this.authenticate();
+        }
+        return this._accessToken;
+    }
+    async authenticate() {
+        if (!this._options.password) {
+            throw new Error('Password required for authentication');
+        }
+        const url = this._deps.getUrl('/token');
+        const body = new URLSearchParams({
+            grant_type: 'password',
+            username: this._options.username,
+            password: this._options.password,
+            scope: 'roms.read roms.write platforms.read',
+        });
+        try {
+            const response = await this._deps.fetchWithRetry(url, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/x-www-form-urlencoded',
+                },
+                body,
+            });
+            if (!response.ok) {
+                const error = await response.text();
+                throw new Error(`Authentication failed: ${response.status} ${error}`);
+            }
+            const data = (await response.json());
+            this._accessToken = data.access_token;
+            if (this._options.authCacheEnabled) {
+                this._tokenCache = {
+                    accessToken: data.access_token,
+                    tokenType: data.token_type,
+                    expiresAtEpochMs: Date.now() + data.expires * 1000,
+                    issuedAtEpochMs: Date.now(),
+                };
+                await setCachedToken(this._options.baseUrl, this._options.username, this._tokenCache, {
+                    enabled: this._options.authCacheEnabled,
+                    cachePath: this._options.authCachePath,
+                    reauthSkewSeconds: this._options.authReauthSkewSeconds,
+                });
+            }
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                if (error.name === 'TypeError' && error.message.includes('fetch failed')) {
+                    throw new Error(`Cannot connect to ${this._options.baseUrl}. Is the RomM server running?`);
+                }
+            }
+            throw error;
+        }
+    }
+    async fetch(path, options = {}) {
+        const accessToken = await this.ensureAuthenticated();
+        const url = this._deps.getUrl(path);
+        const headers = {
+            ...options.headers,
+            Authorization: `Bearer ${accessToken}`,
+        };
+        const response = await this._deps.fetchWithRetry(url, { ...options, headers });
+        if (response.status === 401 && !this._authAttempted) {
+            this._authAttempted = true;
+            this._accessToken = undefined;
+            await clearCachedToken(this._options.baseUrl, this._options.username, {
+                enabled: this._options.authCacheEnabled,
+                cachePath: this._options.authCachePath,
+                reauthSkewSeconds: this._options.authReauthSkewSeconds,
+            });
+            await this.authenticate();
+            const retryAccessToken = await this.ensureAuthenticated();
+            return this._deps.fetchWithRetry(url, {
+                ...options,
+                headers: {
+                    ...options.headers,
+                    Authorization: `Bearer ${retryAccessToken}`,
+                },
+            });
+        }
+        this._authAttempted = false;
+        return response;
+    }
+}
+//# sourceMappingURL=client-session.js.map

package/dist/romm/client-session.js.map

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