romm-uploader 0.1.1-beta.0

package/.env.example

@@ -0,0 +1,7 @@
+# RomM Connection Settings
+ROMM_BASE_URL=https://your-romm-instance.com
+ROMM_USERNAME=your_username
+ROMM_PASSWORD=your_password
+
+# Optional: Override cache locations
+# XDG_CACHE_HOME=/custom/cache/path

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Josh
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,228 @@
+# RomM Uploader CLI
+
+A Linux-first TypeScript CLI for uploading ROMs to your [RomM](https://romm.app/) instance.
+
+## Features
+
+- 🔐 OAuth2 authentication with token caching
+- 🔍 Checksum-based duplicate detection (CRC32, MD5, SHA1)
+- 💾 Local checksum cache for faster re-runs
+- 📁 Support for files, directories, and glob patterns
+- 🎮 Platform discovery and resolution
+- 🧪 Dry-run mode for testing
+- 📊 JSON output for scripting
+
+## Prerequisites
+
+- Node.js 18+ 
+- RomM instance (v4.5.0+)
+
+## Installation
+
+```bash
+# Run without installing
+npx romm-uploader --help
+
+# Or install globally
+npm install -g romm-uploader
+```
+
+## Usage
+
+### Basic Upload
+
+```bash
+# Using environment variables
+export ROMM_BASE_URL=https://romm.example.com
+export ROMM_USERNAME=admin
+export ROMM_PASSWORD=secret
+
+romm-uploader --platform snes "Super Mario World.smc"
+```
+
+### With CLI Options
+
+```bash
+romm-uploader \
+  --base-url https://romm.example.com \
+  --username admin \
+  --password secret \
+  --platform gba \
+  ~/roms/gameboy/*.gba
+```
+
+### List Platforms
+
+```bash
+romm-uploader --list-platforms
+```
+
+### Dry Run
+
+```bash
+romm-uploader --dry-run --platform psx ~/roms/playstation/
+```
+
+### Multiple Input Methods
+
+```bash
+romm-uploader \
+  --platform snes \
+  --upload-file "game1.smc" \
+  --upload-file "game2.smc" \
+  --upload-dir ~/roms/more/ \
+  --glob "*.sfc"
+```
+
+## Configuration
+
+Configuration precedence (highest to lowest):
+1. CLI options
+2. Environment variables
+3. Defaults
+
+### Environment Variables
+
+| Variable | Description |
+|----------|-------------|
+| `ROMM_BASE_URL` | RomM instance URL |
+| `ROMM_USERNAME` | Username for authentication |
+| `ROMM_PASSWORD` | Password for authentication |
+
+Copy `.env.example` to `.env` and fill in your values.
+
+## CLI Options
+
+### Connection Options
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `--base-url <url>` | RomM base URL | `ROMM_BASE_URL` env |
+| `--username <user>` | Username | `ROMM_USERNAME` env |
+| `--password <pass>` | Password | `ROMM_PASSWORD` env |
+
+### Platform Options
+
+| Option | Description |
+|--------|-------------|
+| `--platform <value>` | Target platform (slug, name, or ID) |
+| `--list-platforms` | List available platforms and exit |
+
+### Input Options
+
+| Option | Description |
+|--------|-------------|
+| `[paths...]` | Positional file/directory paths |
+| `--upload-file <path>` | Specific file to upload (repeatable) |
+| `--upload-dir <path>` | Directory to upload from (repeatable) |
+| `--glob <pattern>` | Glob pattern for files (repeatable) |
+| `--recursive` | Include nested directories |
+
+### Checksum Options
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `--checksum <algo>` | Additional hash algorithm | - |
+| `--cache-enabled <bool>` | Enable checksum cache | `true` |
+| `--cache-max-mb <n>` | Cache size limit | `4` |
+| `--cache-path <path>` | Custom cache location | XDG default |
+
+### Auth Options
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `--auth-cache-enabled <bool>` | Enable token cache | `true` |
+| `--auth-cache-path <path>` | Custom auth cache location | XDG default |
+| `--auth-reauth-skew-seconds <n>` | Early refresh window | `60` |
+
+### Request Options
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `--request-timeout-seconds <n>` | HTTP timeout | `60` |
+| `--retry-count <n>` | Retry attempts | `0` |
+
+### Behavior Options
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `--dry-run` | Check only, no upload | `false` |
+| `--concurrency <n>` | Parallel processing | `3` |
+
+### Output Options
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `--json` | JSON output | `false` |
+| `--verbose` | Debug logging | `false` |
+
+## Exit Codes
+
+| Code | Meaning |
+|------|---------|
+| `0` | Success (all files processed) |
+| `1` | Partial/complete failure |
+| `2` | Invalid usage/configuration |
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Run in development mode
+npm run dev -- --help
+
+# Build
+npm run build
+
+# Release gate (must pass before publish)
+npm run release:check
+
+# Run tests
+npm test
+
+# Lint
+npm run lint
+
+# Format
+npm run format
+```
+
+## Project Structure
+
+```
+.
+├── src/
+│   ├── cli.ts                 # Entry point
+│   ├── config.ts              # Configuration management
+│   ├── types.ts               # Type definitions
+│   ├── files/
+│   │   └── discover-files.ts  # File discovery
+│   ├── checksum/
+│   │   └── compute-checksum.ts # Hash computation
+│   ├── cache/
+│   │   └── checksum-cache.ts  # Checksum caching
+│   ├── romm/
+│   │   └── client.ts          # RomM API client
+│   ├── output/
+│   │   └── reporter.ts        # Output formatting
+│   └── workflow/
+│       └── process-roms.ts    # Main workflow
+├── test/
+│   ├── unit/                  # Unit tests
+│   └── integration/           # Integration tests
+├── docs/
+│   └── api-notes.md           # RomM API documentation
+└── package.json
+```
+
+## Release Notes
+
+- `npm publish` is guarded by `prepublishOnly`, which runs `npm run release:check`.
+- `npm run release:check` runs typecheck, lint, tests, and package dry-run.
+- Build output is cleaned before compile to prevent stale artifacts.
+
+## License
+
+MIT

package/dist/cache/checksum-cache.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Checksum cache module
+ * Local disk cache for checksum reuse across runs
+ */
+import { ChecksumCacheEntry, ChecksumData } from '../types.js';
+export interface ChecksumCacheOptions {
+    enabled: boolean;
+    maxMb: number;
+    cachePath?: string;
+}
+/**
+ * Get cached checksum for a file if valid
+ * Validation: absolute path + file size + modification time
+ */
+export declare function getCachedChecksum(filePath: string, size: number, mtime: number, options: ChecksumCacheOptions): Promise<ChecksumData | null>;
+/**
+ * Store checksum in cache
+ */
+export declare function setCachedChecksum(entry: ChecksumCacheEntry, options: ChecksumCacheOptions): Promise<void>;
+//# sourceMappingURL=checksum-cache.d.ts.map

package/dist/cache/checksum-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checksum-cache.d.ts","sourceRoot":"","sources":["../../src/cache/checksum-cache.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAK/D,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AA8GD;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAkB9B;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,kBAAkB,EACzB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,IAAI,CAAC,CAef"}

package/dist/cache/checksum-cache.js

@@ -0,0 +1,134 @@
+/**
+ * Checksum cache module
+ * Local disk cache for checksum reuse across runs
+ */
+import { readFile, writeFile, mkdir } from 'fs/promises';
+import { existsSync } from 'fs';
+import { dirname } from 'path';
+// In-memory cache
+const cache = {
+    entries: new Map(),
+    totalSize: 0,
+};
+let cacheLoaded = false;
+/**
+ * Get default cache path based on XDG spec
+ */
+function getDefaultCachePath() {
+    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`;
+}
+/**
+ * Load cache from disk
+ */
+async function loadCache(cachePath) {
+    if (cacheLoaded)
+        return;
+    try {
+        if (!existsSync(cachePath)) {
+            cacheLoaded = true;
+            return;
+        }
+        const data = await readFile(cachePath, 'utf-8');
+        const parsed = JSON.parse(data);
+        if (parsed.entries) {
+            for (const [key, entry] of Object.entries(parsed.entries)) {
+                cache.entries.set(key, entry);
+            }
+        }
+        cacheLoaded = true;
+    }
+    catch {
+        // If cache is corrupt, start fresh
+        cache.entries.clear();
+        cacheLoaded = true;
+    }
+}
+/**
+ * Save cache to disk
+ */
+async function saveCache(cachePath) {
+    try {
+        const dir = dirname(cachePath);
+        if (!existsSync(dir)) {
+            await mkdir(dir, { recursive: true });
+        }
+        const data = {
+            entries: Object.fromEntries(cache.entries),
+            version: 1,
+        };
+        await writeFile(cachePath, JSON.stringify(data, null, 2));
+    }
+    catch (error) {
+        console.warn(`⚠️  Warning: Failed to save checksum cache: ${error instanceof Error ? error.message : 'Unknown error'}`);
+    }
+}
+/**
+ * Calculate approximate size of cache entry in bytes
+ */
+function calculateEntrySize(entry) {
+    return (entry.path.length +
+        8 + // size (number)
+        8 + // mtime (number)
+        (entry.checksums.crc32?.length ?? 0) +
+        (entry.checksums.md5?.length ?? 0) +
+        (entry.checksums.sha1?.length ?? 0) +
+        100 // overhead
+    );
+}
+/**
+ * Evict oldest entries to stay under max size (LRU)
+ */
+function evictOldEntries(maxBytes) {
+    const entriesArray = Array.from(cache.entries.entries());
+    let currentSize = entriesArray.reduce((sum, [, entry]) => sum + calculateEntrySize(entry), 0);
+    // Sort by mtime (oldest first)
+    entriesArray.sort((a, b) => a[1].mtime - b[1].mtime);
+    for (const [key, entry] of entriesArray) {
+        if (currentSize <= maxBytes)
+            break;
+        const entrySize = calculateEntrySize(entry);
+        cache.entries.delete(key);
+        currentSize -= entrySize;
+    }
+}
+/**
+ * Get cached checksum for a file if valid
+ * Validation: absolute path + file size + modification time
+ */
+export async function getCachedChecksum(filePath, size, mtime, options) {
+    if (!options.enabled)
+        return null;
+    const cachePath = options.cachePath ?? getDefaultCachePath();
+    await loadCache(cachePath);
+    const entry = cache.entries.get(filePath);
+    if (!entry)
+        return null;
+    // Validate cache entry
+    if (entry.size !== size || entry.mtime !== mtime) {
+        // Cache invalid - file changed
+        cache.entries.delete(filePath);
+        return null;
+    }
+    return entry.checksums;
+}
+/**
+ * Store checksum in cache
+ */
+export async function setCachedChecksum(entry, options) {
+    if (!options.enabled)
+        return;
+    const cachePath = options.cachePath ?? getDefaultCachePath();
+    await loadCache(cachePath);
+    // Add new entry
+    cache.entries.set(entry.path, entry);
+    // Evict old entries if over size limit
+    const maxBytes = options.maxMb * 1024 * 1024;
+    evictOldEntries(maxBytes);
+    // Save to disk
+    await saveCache(cachePath);
+}
+//# sourceMappingURL=checksum-cache.js.map

package/dist/cache/checksum-cache.js.map

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

package/dist/checksum/compute-checksum.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Checksum computation module
+ * Streaming hash computation for sha1, md5, crc32
+ */
+import { ChecksumData } from '../types.js';
+/**
+ * Compute checksums for a file using streaming to avoid high memory usage
+ * Always computes: sha1, md5, crc32
+ * Optionally computes additional algorithms specified in options
+ */
+export declare function computeChecksums(filePath: string, _extraAlgorithms: string[]): Promise<ChecksumData>;
+/**
+ * Compute checksums for multiple files
+ */
+export declare function computeChecksumsForFiles(filePaths: string[], onProgress?: (filePath: string, checksums: ChecksumData) => void): Promise<Map<string, ChecksumData>>;
+//# sourceMappingURL=compute-checksum.d.ts.map

package/dist/checksum/compute-checksum.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compute-checksum.d.ts","sourceRoot":"","sources":["../../src/checksum/compute-checksum.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAsB3C;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,MAAM,EAChB,gBAAgB,EAAE,MAAM,EAAE,GACzB,OAAO,CAAC,YAAY,CAAC,CA+BvB;AAED;;GAEG;AACH,wBAAsB,wBAAwB,CAC5C,SAAS,EAAE,MAAM,EAAE,EACnB,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,YAAY,KAAK,IAAI,GAC/D,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAcpC"}

package/dist/checksum/compute-checksum.js

@@ -0,0 +1,71 @@
+/**
+ * Checksum computation module
+ * Streaming hash computation for sha1, md5, crc32
+ */
+import { createHash } from 'crypto';
+import { createReadStream } from 'fs';
+/**
+ * Calculate CRC32 checksum
+ * Using a simple implementation (could be optimized with a lookup table)
+ */
+function calculateCrc32(buffer) {
+    let crc = 0xffffffff;
+    for (let i = 0; i < buffer.length; i++) {
+        crc ^= buffer[i];
+        for (let j = 0; j < 8; j++) {
+            crc = (crc >>> 1) ^ (crc & 1 ? 0xedb88320 : 0);
+        }
+    }
+    crc = (crc ^ 0xffffffff) >>> 0;
+    return crc.toString(16).padStart(8, '0').toUpperCase();
+}
+/**
+ * Compute checksums for a file using streaming to avoid high memory usage
+ * Always computes: sha1, md5, crc32
+ * Optionally computes additional algorithms specified in options
+ */
+export async function computeChecksums(filePath, _extraAlgorithms) {
+    return new Promise((resolve, reject) => {
+        const md5Hash = createHash('md5');
+        const sha1Hash = createHash('sha1');
+        const crcChunks = [];
+        const stream = createReadStream(filePath);
+        stream.on('data', (chunk) => {
+            const bufferChunk = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
+            md5Hash.update(bufferChunk);
+            sha1Hash.update(bufferChunk);
+            crcChunks.push(bufferChunk);
+        });
+        stream.on('end', () => {
+            // Combine all chunks for CRC32 (could be optimized for very large files)
+            const combinedBuffer = Buffer.concat(crcChunks);
+            const crc32 = calculateCrc32(combinedBuffer);
+            resolve({
+                crc32,
+                md5: md5Hash.digest('hex'),
+                sha1: sha1Hash.digest('hex'),
+            });
+        });
+        stream.on('error', (error) => {
+            reject(new Error(`Failed to compute checksums for ${filePath}: ${error.message}`));
+        });
+    });
+}
+/**
+ * Compute checksums for multiple files
+ */
+export async function computeChecksumsForFiles(filePaths, onProgress) {
+    const results = new Map();
+    for (const filePath of filePaths) {
+        try {
+            const checksums = await computeChecksums(filePath, []);
+            results.set(filePath, checksums);
+            onProgress?.(filePath, checksums);
+        }
+        catch (error) {
+            console.error(`❌ Error computing checksums for ${filePath}:`, error instanceof Error ? error.message : error);
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=compute-checksum.js.map

package/dist/checksum/compute-checksum.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+/**
+ * RomM Uploader CLI
+ * Linux-first TypeScript CLI for uploading ROMs to RomM
+ */
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;GAGG"}