@blackasteroid/riu 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Pablo Morales / BlackAsteroid
+
+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,371 @@
+# rust-icon-uploader (`riu`)
+
+Automate uploading **icon-only Rust workshop skins** from the command line.
+
+`riu` generates the right `manifest.txt`, validates your icon PNG, and pushes the workshop item to Steam — interactively (Ink TUI) or headless via JSON (agent-friendly). Every command supports `--dry-run` against a mock Steam client so you can exercise the whole pipeline without `libsteam_api.dylib`.
+
+---
+
+## Why this exists
+
+Most Rust items aren't on Facepunch's official skinnable list (UAV, Patrol Signal, etc.), so you can't make traditional texture skins for them. But there's a workaround: you can upload a workshop item with an **empty `Textures` block** and Rust will use the workshop preview image as the in-game inventory icon.
+
+Doing this by hand is tedious. There's a Windows-only Unity tool called *Rust Custom Icons* that automates the upload, but if you're on macOS or want to script it from CI / an agent, you're stuck. `riu` is the cross-platform replacement — Node.js, no Bun, no Zig, no Windows.
+
+---
+
+## Install
+
+```bash
+git clone git@github.com:BlackAsteroid/rust-icon-uploader.git
+cd rust-icon-uploader
+npm install
+npm run build
+npm link            # makes the `riu` command available globally
+```
+
+Requires **Node.js 20+**.
+
+---
+
+## Prerequisites for real uploads
+
+`--dry-run` works on any machine. For real uploads you need:
+
+1. **Steam client running**, logged into the account that owns Rust (AppID 252490).
+2. **`libsteam_api.dylib`** — `riu init` and `riu install-sdk` will **auto-detect and copy this from your local Rust install** (it ships as `RustClient.app/Contents/PlugIns/libsteam_api.bundle`, a flat universal Mach-O). You don't need to download anything from Valve.
+
+If you don't have Rust installed locally, you can also:
+- Install Spacewar (free, AppID 480) which ships the SDK reference binaries
+- Pass `--from <path>` to `riu install-sdk` with a manually-acquired dylib
+- Register as a Steamworks partner (free) and download the SDK from <https://partner.steamgames.com>
+
+Run `riu doctor` after setup to verify everything is wired up.
+
+---
+
+## Quick start
+
+```bash
+# 1. one-time setup — auto-detects libsteam_api.dylib from your Rust install
+riu init                           # interactive: only asks for SteamID
+# or headless:
+riu init --json '{"authorId":"76561198xxxxxxxxx"}' --force
+
+# 2. verify the environment
+riu doctor
+
+# 3. generate a skin folder from one of the example icons
+riu new
+
+# 4. upload it (use --dry-run first to confirm without touching Steam)
+riu upload ./skins/my-uav-skin --dry-run
+riu upload ./skins/my-uav-skin
+
+# 5. see what you've uploaded
+riu list
+```
+
+---
+
+## Command reference
+
+All commands accept `--json [payload]` for headless / agent use and `--dry-run` to use the mock Steam client.
+
+### `riu init`
+
+One-time setup wizard. Asks for SDK path, SteamID64, default tags, etc., and writes them to `~/Library/Application Support/rust-icon-uploader-nodejs/config.json` (macOS).
+
+```bash
+# interactive
+riu init
+
+# headless (for agents / CI)
+riu init --json '{
+  "steamSdkPath": "/Users/me/steamworks_sdk",
+  "authorId": "76561198194158447",
+  "defaultTags": ["Version3", "Skin"]
+}' --force
+
+# show current config
+riu init --show
+riu init --show --json
+```
+
+Flags:
+- `--show` print current config
+- `--force` overwrite existing config
+- `--dry-run` validate without writing
+- `--json [payload]` headless mode (payload required for write, omit for `--show`)
+
+### `riu install-sdk`
+
+Auto-locates `libsteam_api.dylib` (or `.bundle`) from a local Steam game install and copies it to `~/.riu/sdk/libsteam_api.dylib`. Updates the existing config to point at the managed location.
+
+```bash
+riu install-sdk                    # auto-locate and install
+riu install-sdk --dry-run --json   # show what would be installed
+riu install-sdk --from /path/to/libsteam_api.dylib   # explicit source
+riu install-sdk --force            # reinstall over existing
+```
+
+This command is run automatically by `riu init` if no `steamSdkPath` is provided. Useful as a standalone after installing Rust on a new machine.
+
+### `riu doctor`
+
+Diagnostic check: verifies config exists, dylib is present, Steam is running, SteamID format is valid, AppID is set. Exits non-zero if any check fails.
+
+```bash
+riu doctor
+riu doctor --json
+```
+
+### `riu new`
+
+Generates a complete skin folder (`manifest.txt` + `icon.png`).
+
+```bash
+# interactive Ink wizard
+riu new
+
+# headless
+riu new --json '{
+  "itemType": "Grenade",
+  "title": "UAV Custom Icon",
+  "description": "BusinessCore UAV signal",
+  "tags": ["Version3", "Skin"],
+  "iconPath": "/path/to/uav.png",
+  "outputDir": "./skins/uav"
+}'
+
+# validate without writing
+riu new --json '{...}' --dry-run
+```
+
+**Icon validation** (sharp): PNG, square, dimensions in {256, 512, 1024, 2048}, ≤1MB. RGBA preferred.
+
+**Known item types**: Grenade (UAV / Patrol Signal), Rock, Pistol, Rifle, Shotgun, SMG, Bow, Sword, Spear, Knife, Axe, Hammer, Tool, Hat, Shirt, Pants, Boots, Gloves, Container, SleepingBag, Furniture. Pass `"allowCustomItemType": true` in the payload to use a string outside this list.
+
+### `riu upload [skin-dir]`
+
+Uploads a single skin folder to the workshop.
+
+```bash
+# positional arg
+riu upload ./skins/uav
+
+# with overrides
+riu upload ./skins/uav --title "Custom UAV v2" --tags "Version3,Skin,UAV"
+
+# headless JSON
+riu upload --json '{
+  "skinDir": "./skins/uav",
+  "title": "UAV Custom Icon",
+  "description": "...",
+  "tags": ["Version3","Skin"]
+}'
+
+# dry run with mock client (no Steam contact)
+riu upload ./skins/uav --dry-run
+```
+
+Interactive mode shows a staged Ink progress UI (validating → creating → configuring → uploading → submitting → done). JSON mode skips the UI and emits a single result document.
+
+### `riu upload-all <parent-dir>`
+
+Bulk-uploads every skin folder under a parent directory in sequence.
+
+```bash
+riu upload-all ./skins
+riu upload-all ./skins --dry-run --json
+riu upload-all ./skins --filter Grenade --limit 5
+```
+
+**Resume support**: on success, the returned `PublishedFileId` is written back into `manifest.txt`. On re-run, any folder whose manifest already has `PublishedFileId` is skipped without contacting Steam — so partial-failure recovery is automatic.
+
+**JSON mode**: emits an NDJSON event stream so agents can consume progress live:
+
+```jsonl
+{"event":"start","total":3,"dryRun":true}
+{"event":"item","index":1,"title":"uav","status":"uploading"}
+{"event":"item","index":1,"title":"uav","status":"success","publishedFileId":"9000000001","url":"..."}
+{"event":"item","index":2,"title":"patrol","status":"skipped","reason":"already published"}
+{"event":"summary","total":3,"success":2,"skipped":1,"failed":0}
+```
+
+Flags:
+- `--filter <itemType>` only upload skins matching the category
+- `--limit <n>` cap number of uploads (testing)
+- `--continue-on-error` keep going if one fails (default: true)
+- `--dry-run` mock client
+- `--json` NDJSON output
+
+### `riu list`
+
+Show skins uploaded via this tool (read from local cache).
+
+```bash
+riu list
+riu list --json
+riu list --filter Grenade
+riu list --include-dry-run
+```
+
+By default, dry-run uploads are filtered out so the list reflects real workshop items only.
+
+### `riu update <published-file-id>`
+
+Re-upload the icon for an existing workshop item.
+
+```bash
+# uses cached skinDir if available
+riu update 3248306153 --note "icon refresh"
+
+# or specify the folder explicitly
+riu update 3248306153 --skin-dir ./skins/uav --note "tweaked colors"
+
+# headless
+riu update --json '{
+  "publishedFileId": "3248306153",
+  "skinDir": "./skins/uav",
+  "note": "icon refresh"
+}'
+```
+
+---
+
+## Agent / scripting integration
+
+`--json` makes every command machine-consumable. The pattern most agents will want is:
+
+```bash
+riu init --force --json '{"steamSdkPath":"...","authorId":"..."}'
+riu new --json '{"itemType":"Grenade","title":"...","iconPath":"...","outputDir":"./skin-x"}'
+riu upload ./skin-x --json
+```
+
+Or all-at-once from a folder of pre-generated skins:
+
+```bash
+riu upload-all ./generated-skins --json | while read line; do
+  echo "$line" | jq -r '. | "\(.event): \(.title // "")"'
+done
+```
+
+**Exit codes**:
+- `0` success
+- `1` runtime error (missing config, Steam init failed, network)
+- `2` validation error (bad input, malformed JSON, schema failure)
+
+**Error shape** in JSON mode:
+```json
+{"status":"error","error":{"message":"...","field":"steamSdkPath"}}
+```
+
+---
+
+## Mock / dry-run mode
+
+`--dry-run` swaps the real Steam client for a `MockSteamClient` that:
+- Does **not** load `libsteam_api.dylib` (works on any machine)
+- Does **not** require Steam to be running
+- Returns synthetic `9_xxx_xxx_xxx` PublishedFileIds
+- Writes cache entries with `dryRun: true` so `riu list` filters them by default
+
+This means **`scripts/e2e-dry-run.sh` works on any machine, in CI, anywhere** — no Steam SDK required. Useful for:
+- CI smoke tests
+- Agent tool development
+- Validating manifests before a real run
+- Demos
+
+---
+
+## How the icon-only skin trick works
+
+A normal Rust workshop skin replaces an item's textures (diffuse, normal, etc.) by setting non-empty entries in the manifest's `Textures` dictionary. Rust's workshop client downloads those textures, applies them to the item's material at runtime, and the item *looks* different in-world.
+
+For items NOT on Facepunch's skinnable list, that texture-replacement path doesn't work — Rust has no skinnable material for them. But the workshop client still downloads the **preview image** of every workshop item the player is subscribed to and uses it as the inventory icon. So if you upload a workshop item with:
+
+```json
+{
+  "Version": 3,
+  "ItemType": "Grenade",
+  "Groups": [{
+    "Textures": {},     ← empty, no texture overrides
+    "Floats": {...},
+    "Colors": {...}
+  }]
+}
+```
+
+…Rust will recognize the workshop item, see no textures to apply, and just use the **preview image** as the in-game icon for items of that ItemType. That's the entire trick.
+
+---
+
+## Project layout
+
+```
+src/
+├── cli.tsx                 # commander entrypoint
+├── commands/               # one file per CLI command
+│   ├── init.tsx
+│   ├── doctor.tsx
+│   ├── new.tsx
+│   ├── upload.tsx
+│   ├── list.tsx
+│   ├── update.tsx
+│   └── upload-all.tsx
+├── ui/                     # Ink components
+│   ├── InitWizard.tsx
+│   ├── NewSkinWizard.tsx
+│   ├── UploadProgress.tsx
+│   └── BulkUploadProgress.tsx
+├── steam/                  # Steam UGC layer (mockable)
+│   ├── types.ts
+│   ├── client.ts           # real, wraps steamworks-ffi-node
+│   └── mock.ts             # fake, used by --dry-run
+├── manifest/               # pure functions, unit tested
+│   ├── itemTypes.ts
+│   ├── builder.ts
+│   ├── writer.ts
+│   └── __tests__/
+├── config/                 # conf-backed user config + Zod schema
+├── cache/                  # uploads.json local cache
+└── utils/                  # iconValidator, slugify
+```
+
+---
+
+## Development
+
+```bash
+npm run dev -- new           # run via tsx without building
+npm run build                # tsc → dist/
+npm run typecheck            # tsc --noEmit
+npm test                     # node:test unit tests
+bash scripts/e2e-dry-run.sh  # full dry-run smoke test
+```
+
+Test config gets stored in a temp dir via `RIU_CONFIG_DIR` so it never touches your real config.
+
+---
+
+## Troubleshooting
+
+**`Steamworks SDK not ready: no Steam library found`**
+The path you gave `riu init` doesn't contain `libsteam_api.dylib`. Run `riu doctor` for a clear report.
+
+**`Steam init failed`**
+Steam isn't running, or the account isn't logged in, or it doesn't own AppID 252490 (Rust). The `steam_appid.txt` file is automatically managed in cwd — leftover copies are deleted on `riu shutdown`.
+
+**`createItem returned null`**
+Steam refused to create the workshop item. Common cause: the account hasn't accepted the workshop legal agreement. Visit any workshop submission page in a browser to accept it.
+
+**`icon validation failed: must be square`**
+Resize your PNG to 256/512/1024/2048 px. Sharp can do it: `npx sharp-cli resize 512 512 < bad.png > good.png`.
+
+---
+
+## License
+
+MIT

package/dist/cache/uploads.js

@@ -0,0 +1,48 @@
+// Local cache of skins uploaded via this tool. Lives at <cacheDir>/uploads.json.
+//
+// Used by `riu list` (display) and `riu update` (look up skin folder by file
+// ID). Cache is append-only — failures don't pollute it because we only
+// write after a successful upload.
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+function cacheFilePath(cacheDir) {
+    return join(cacheDir, "uploads.json");
+}
+export function readCache(cacheDir) {
+    const path = cacheFilePath(cacheDir);
+    if (!existsSync(path)) {
+        return { uploads: [] };
+    }
+    try {
+        const raw = readFileSync(path, "utf8");
+        const parsed = JSON.parse(raw);
+        if (!parsed.uploads || !Array.isArray(parsed.uploads)) {
+            return { uploads: [] };
+        }
+        return parsed;
+    }
+    catch {
+        return { uploads: [] };
+    }
+}
+export function appendUpload(cacheDir, entry) {
+    const path = cacheFilePath(cacheDir);
+    mkdirSync(dirname(path), { recursive: true });
+    const cache = readCache(cacheDir);
+    cache.uploads.push(entry);
+    writeFileSync(path, JSON.stringify(cache, null, 2) + "\n", "utf8");
+}
+export function findUpload(cacheDir, publishedFileId) {
+    const cache = readCache(cacheDir);
+    return cache.uploads.find((u) => u.publishedFileId === publishedFileId);
+}
+export function updateUploadTimestamp(cacheDir, publishedFileId) {
+    const path = cacheFilePath(cacheDir);
+    const cache = readCache(cacheDir);
+    const entry = cache.uploads.find((u) => u.publishedFileId === publishedFileId);
+    if (entry) {
+        entry.uploadedAt = new Date().toISOString();
+        writeFileSync(path, JSON.stringify(cache, null, 2) + "\n", "utf8");
+    }
+}
+//# sourceMappingURL=uploads.js.map

package/dist/cache/uploads.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uploads.js","sourceRoot":"","sources":["../../src/cache/uploads.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,EAAE;AACF,6EAA6E;AAC7E,wEAAwE;AACxE,mCAAmC;AAEnC,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAoB1C,SAAS,aAAa,CAAC,QAAgB;IACrC,OAAO,IAAI,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,QAAgB;IACxC,MAAM,IAAI,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;IACrC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACtB,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IACzB,CAAC;IACD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACvC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAc,CAAC;QAC5C,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;YACtD,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;QACzB,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IACzB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,QAAgB,EAAE,KAAmB;IAChE,MAAM,IAAI,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;IACrC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9C,MAAM,KAAK,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;IAClC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC1B,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC;AACrE,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,QAAgB,EAAE,eAAuB;IAClE,MAAM,KAAK,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;IAClC,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,eAAe,KAAK,eAAe,CAAC,CAAC;AAC1E,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,QAAgB,EAAE,eAAuB;IAC7E,MAAM,IAAI,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;IACrC,MAAM,KAAK,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;IAClC,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,eAAe,KAAK,eAAe,CAAC,CAAC;IAC/E,IAAI,KAAK,EAAE,CAAC;QACV,KAAK,CAAC,UAAU,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC5C,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC;IACrE,CAAC;AACH,CAAC"}

package/dist/cli.js

@@ -0,0 +1,196 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+import { VERSION } from "./version.js";
+import { maybeRunUpdateCheck } from "./utils/updateCheck.js";
+// Background update check (skipped automatically for --json, --version, --help,
+// and the `upgrade` subcommand). Notice prints to stderr if an update is found.
+maybeRunUpdateCheck(process.argv);
+function notImplemented(name, opts, payload) {
+    const msg = {
+        command: name,
+        status: "not_implemented",
+        note: "scaffold only — implementation lands in a follow-up issue",
+        options: opts,
+        payload: payload ?? null,
+    };
+    if (opts.json) {
+        process.stdout.write(JSON.stringify(msg) + "\n");
+    }
+    else {
+        console.log(`[${name}] not implemented yet`);
+        if (opts.dryRun)
+            console.log("  (dry-run mode)");
+        if (payload !== undefined)
+            console.log("  payload:", payload);
+    }
+}
+function parseJsonFlag(raw) {
+    if (raw === undefined)
+        return undefined;
+    // `--json` (no value) → boolean true; `--json '{...}'` → parsed object
+    if (raw === "" || raw === "true")
+        return true;
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        // commander gave us a non-JSON string → treat as boolean true
+        return true;
+    }
+}
+const program = new Command();
+program
+    .name("riu")
+    .description("Rust workshop icon uploader — automate icon-only skin uploads")
+    .version(VERSION, "-v, --version", "print version");
+program
+    .command("init")
+    .description("one-time setup wizard")
+    .option("--json [payload]", "JSON config payload OR flag for JSON output")
+    .option("--dry-run", "validate without writing config")
+    .option("--show", "print current config and exit")
+    .option("--force", "overwrite existing config without prompting")
+    .action(async (rawOpts) => {
+    const parsed = parseJsonFlag(rawOpts.json);
+    const { runInit } = await import("./commands/init.js");
+    await runInit({
+        jsonFlag: rawOpts.json !== undefined,
+        jsonPayload: typeof parsed === "object" && parsed !== null ? parsed : undefined,
+        show: rawOpts.show ?? false,
+        force: rawOpts.force ?? false,
+        dryRun: rawOpts.dryRun ?? false,
+    });
+});
+program
+    .command("upgrade")
+    .description("upgrade riu to the latest version on npm")
+    .option("--check", "only check for updates, don't install")
+    .option("--dry-run", "show what would be run without installing")
+    .option("--json", "structured JSON output")
+    .action(async (rawOpts) => {
+    const { runUpgrade } = await import("./commands/upgrade.js");
+    await runUpgrade({
+        check: rawOpts.check ?? false,
+        dryRun: rawOpts.dryRun ?? false,
+        json: rawOpts.json ?? false,
+    });
+});
+program
+    .command("install-sdk")
+    .description("auto-locate libsteam_api.dylib from a local Steam game install and copy it to ~/.riu/sdk/")
+    .option("--from <path>", "install from an explicit path instead of auto-locating")
+    .option("--force", "reinstall even if SDK is already present")
+    .option("--dry-run", "show what would be installed without copying")
+    .option("--json", "structured JSON output")
+    .action(async (rawOpts) => {
+    const { runInstallSdk } = await import("./commands/install-sdk.js");
+    runInstallSdk({
+        from: rawOpts.from,
+        force: rawOpts.force ?? false,
+        dryRun: rawOpts.dryRun ?? false,
+        json: rawOpts.json ?? false,
+    });
+});
+program
+    .command("doctor")
+    .description("validate Steam SDK + dylib + auth + Rust running")
+    .option("--json", "structured JSON output")
+    .action(async (rawOpts) => {
+    const { runDoctor } = await import("./commands/doctor.js");
+    runDoctor({ json: rawOpts.json ?? false });
+});
+program
+    .command("new")
+    .description("generate a skin folder (manifest.txt + icon.png)")
+    .option("--json [payload]", "JSON payload OR flag for JSON output")
+    .option("--dry-run", "validate but don't write files")
+    .action(async (rawOpts) => {
+    const parsed = parseJsonFlag(rawOpts.json);
+    const { runNew } = await import("./commands/new.js");
+    await runNew({
+        jsonFlag: rawOpts.json !== undefined,
+        jsonPayload: typeof parsed === "object" && parsed !== null ? parsed : undefined,
+        dryRun: rawOpts.dryRun ?? false,
+    });
+});
+program
+    .command("upload")
+    .description("upload a single skin folder to the Rust workshop")
+    .argument("[skin-dir]", "path to skin folder containing manifest.txt + icon.png")
+    .option("--json [payload]", "JSON payload OR flag for JSON output")
+    .option("--dry-run", "use mock Steam client, don't actually upload")
+    .option("--title <title>", "override workshop item title")
+    .option("--description <desc>", "override workshop item description")
+    .option("--tags <tags>", "comma-separated tags")
+    .action(async (skinDir, rawOpts) => {
+    const parsed = parseJsonFlag(rawOpts.json);
+    const { runUpload } = await import("./commands/upload.js");
+    await runUpload({
+        jsonFlag: rawOpts.json !== undefined,
+        jsonPayload: typeof parsed === "object" && parsed !== null ? parsed : undefined,
+        dryRun: rawOpts.dryRun ?? false,
+        title: rawOpts.title,
+        description: rawOpts.description,
+        tags: rawOpts.tags,
+        positionalSkinDir: skinDir,
+    });
+});
+program
+    .command("upload-all")
+    .description("bulk upload a parent folder of skin folders")
+    .argument("<parent-dir>", "directory containing one subfolder per skin")
+    .option("--json", "NDJSON event stream output")
+    .option("--dry-run", "use mock Steam client")
+    .option("--continue-on-error", "keep going if one skin fails", true)
+    .option("--limit <n>", "only upload first N skins", (v) => parseInt(v, 10))
+    .option("--filter <itemType>", "only upload skins matching this itemType")
+    .action(async (parentDir, rawOpts) => {
+    const { runUploadAll } = await import("./commands/upload-all.js");
+    await runUploadAll({
+        parentDir,
+        jsonFlag: rawOpts.json ?? false,
+        dryRun: rawOpts.dryRun ?? false,
+        continueOnError: rawOpts.continueOnError ?? true,
+        limit: rawOpts.limit,
+        filter: rawOpts.filter,
+    });
+});
+program
+    .command("list")
+    .description("list skins uploaded via this tool")
+    .option("--json", "structured JSON output")
+    .option("--filter <itemType>", "only show skins matching this itemType")
+    .option("--include-dry-run", "include dry-run uploads in the output")
+    .action(async (rawOpts) => {
+    const { runList } = await import("./commands/list.js");
+    runList({
+        json: rawOpts.json ?? false,
+        filter: rawOpts.filter,
+        includeDryRun: rawOpts.includeDryRun ?? false,
+    });
+});
+program
+    .command("update")
+    .description("re-upload icon for an existing workshop item")
+    .argument("<published-file-id>", "PublishedFileId from a previous upload")
+    .option("--skin-dir <dir>", "skin folder if not in local cache")
+    .option("--note <note>", "change note for the update", "icon update")
+    .option("--json [payload]", "JSON payload OR flag for JSON output")
+    .option("--dry-run", "use mock Steam client")
+    .action(async (publishedFileId, rawOpts) => {
+    const parsed = parseJsonFlag(rawOpts.json);
+    const { runUpdate } = await import("./commands/update.js");
+    await runUpdate({
+        jsonFlag: rawOpts.json !== undefined,
+        jsonPayload: typeof parsed === "object" && parsed !== null ? parsed : undefined,
+        dryRun: rawOpts.dryRun ?? false,
+        publishedFileId,
+        skinDir: rawOpts.skinDir,
+        note: rawOpts.note ?? "icon update",
+    });
+});
+program.parseAsync(process.argv).catch((err) => {
+    process.stderr.write(`error: ${err instanceof Error ? err.message : String(err)}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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