upfilesh 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Perry Raskin
+
+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,78 @@
+# upfile-cli
+
+Upload any file from your terminal. Get a permanent URL instantly.
+
+→ [upfile.sh](https://upfile.sh)
+
+## Install
+
+```bash
+yarn global add upfile-cli
+```
+
+## Setup
+
+```bash
+upfile config set api-key YOUR_API_KEY
+```
+
+Get your API key at [upfile.sh](https://upfile.sh).
+
+## Usage
+
+```bash
+# Public — permanent URL, anyone can access
+upfile screenshot.png
+# https://cdn.upfile.sh/xK9mZ.png
+
+# Expiring — self-destructs after TTL (seconds)
+upfile report.pdf --expiry 3600
+
+# Private — auth-gated, only you can access
+upfile secret.pdf --private
+
+# JSON output — for AI agents and scripts
+upfile screenshot.png --json
+
+# Pipe from stdin — capture and upload in one line
+screencapture -x - | upfile
+cat file.txt | upfile --json
+```
+
+## Options
+
+| Flag | Description |
+|------|-------------|
+| `--private` | Private file, requires auth to access |
+| `--expiry <sec>` | Expiring URL with TTL in seconds |
+| `--json` | Full JSON response (url, id, visibility, expires_at) |
+
+## JSON response
+
+```json
+{
+  "id": "xK9mZaBcDe",
+  "url": "https://cdn.upfile.sh/xK9mZaBcDe.png",
+  "visibility": "public",
+  "size": 84231,
+  "type": "image/png",
+  "expires_at": null,
+  "created_at": "2026-03-02T03:00:00.000Z"
+}
+```
+
+## Config
+
+```bash
+upfile config set api-key <key>      # save API key
+upfile config set endpoint <url>     # self-hosted endpoint
+upfile config get                    # view current config
+```
+
+Config stored at `~/.upfile/config.json`.
+
+## Environment variables
+
+| Var | Description |
+|-----|-------------|
+| `UPFILE_API_KEY` | API key (overrides config file) |

package/bin/upfile

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+require("../dist/index.js");

package/dist/config.js

@@ -0,0 +1,24 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_ENDPOINT = void 0;
+exports.loadConfig = loadConfig;
+exports.saveConfig = saveConfig;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const os_1 = __importDefault(require("os"));
+const CONFIG_DIR = path_1.default.join(os_1.default.homedir(), ".upfile");
+const CONFIG_FILE = path_1.default.join(CONFIG_DIR, "config.json");
+function loadConfig() {
+    if (!fs_1.default.existsSync(CONFIG_FILE))
+        return {};
+    return JSON.parse(fs_1.default.readFileSync(CONFIG_FILE, "utf-8"));
+}
+function saveConfig(patch) {
+    fs_1.default.mkdirSync(CONFIG_DIR, { recursive: true });
+    const existing = loadConfig();
+    fs_1.default.writeFileSync(CONFIG_FILE, JSON.stringify({ ...existing, ...patch }, null, 2));
+}
+exports.DEFAULT_ENDPOINT = "https://api.upfile.sh";

package/dist/index.js

@@ -0,0 +1,156 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const path_1 = __importDefault(require("path"));
+const upload_js_1 = require("./upload.js");
+const config_js_1 = require("./config.js");
+const args = process.argv.slice(2);
+function flag(name) {
+    const i = args.findIndex(a => a === `--${name}`);
+    if (i === -1)
+        return undefined;
+    return args[i + 1];
+}
+function hasFlag(name) {
+    return args.includes(`--${name}`);
+}
+function formatSize(bytes) {
+    if (bytes < 1024)
+        return `${bytes}B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(1)}KB`;
+    return `${(bytes / (1024 * 1024)).toFixed(1)}MB`;
+}
+async function main() {
+    const cmd = args[0];
+    // upfile signup --email me@example.com [--owner-email owner@example.com]
+    if (cmd === "signup") {
+        const email = flag("email");
+        const ownerEmail = flag("owner-email");
+        if (!email) {
+            console.error("Usage: upfile signup --email your@email.com [--owner-email owner@company.com]");
+            process.exit(1);
+        }
+        const result = await (0, upload_js_1.signup)(email, ownerEmail);
+        console.log("✓ Account created");
+        console.log(`API key: ${result.api_key}`);
+        console.log(`Tier: ${result.tier} (${result.storage_limit_gb}GB)`);
+        (0, config_js_1.saveConfig)({ apiKey: result.api_key });
+        console.log("\nKey saved. You're ready to upload.");
+        return;
+    }
+    // upfile status
+    if (cmd === "status") {
+        const status = await (0, upload_js_1.getStatus)();
+        console.log(`Tier: ${status.tier}`);
+        console.log(`Storage: ${status.storage_used_gb}GB / ${status.storage_limit_gb}GB`);
+        return;
+    }
+    // upfile upgrade
+    if (cmd === "upgrade") {
+        const result = await (0, upload_js_1.getUpgradeUrl)();
+        if (result.checkout_url) {
+            console.log(`Upgrade link: ${result.checkout_url}`);
+            console.log(`Sent to: ${result.message}`);
+        }
+        else {
+            console.log("Manual upgrade:");
+            console.log(result.message);
+            console.log(`Price: ${result.price}`);
+        }
+        return;
+    }
+    // upfile config set/get
+    if (cmd === "config") {
+        if (args[1] === "set") {
+            const [, , , key, value] = args;
+            if (!key || !value) {
+                console.error("Usage: upfile config set <key> <value>");
+                process.exit(1);
+            }
+            if (key === "api-key")
+                (0, config_js_1.saveConfig)({ apiKey: value });
+            else if (key === "endpoint")
+                (0, config_js_1.saveConfig)({ endpoint: value });
+            else {
+                console.error(`Unknown config key: ${key}`);
+                process.exit(1);
+            }
+            console.log(`✓ ${key} saved`);
+        }
+        else {
+            console.log(JSON.stringify((0, config_js_1.loadConfig)(), null, 2));
+        }
+        return;
+    }
+    // upfile ls [--limit N]
+    if (cmd === "ls" || cmd === "list") {
+        const limit = parseInt(flag("limit") || "20");
+        const isJson = hasFlag("json");
+        const files = await (0, upload_js_1.listFiles)(limit);
+        if (isJson) {
+            console.log(JSON.stringify(files, null, 2));
+            return;
+        }
+        if (files.length === 0) {
+            console.log("No files yet.");
+            return;
+        }
+        for (const f of files) {
+            const expires = f.expires_at ? ` (expires ${new Date(f.expires_at).toLocaleDateString()})` : "";
+            console.log(`${f.id}  ${formatSize(f.size).padEnd(8)}  [${f.visibility}]${expires}`);
+            console.log(`       ${f.url}`);
+        }
+        return;
+    }
+    // upfile rm <id>
+    if (cmd === "rm" || cmd === "delete") {
+        const id = args[1];
+        if (!id) {
+            console.error("Usage: upfile rm <id>");
+            process.exit(1);
+        }
+        await (0, upload_js_1.deleteFile)(id);
+        console.log(`✓ deleted ${id}`);
+        return;
+    }
+    // upfile <file> [flags] OR stdin pipe
+    const isJson = hasFlag("json");
+    const isPrivate = hasFlag("private");
+    const ttl = flag("expiry") ? parseInt(flag("expiry")) : undefined;
+    const visibility = isPrivate ? "private" : ttl ? "expiring" : "public";
+    const opts = { visibility, ttl, json: isJson };
+    let result;
+    if (!process.stdin.isTTY && !cmd) {
+        result = await (0, upload_js_1.uploadStdin)(opts);
+    }
+    else {
+        const filePath = args.find(a => !a.startsWith("--"));
+        if (!filePath) {
+            console.error([
+                "Usage:",
+                "  upfile signup --email <email> [--owner-email <email>]  create account",
+                "  upfile status                                           check storage",
+                "  upfile upgrade                                          get upgrade link",
+                "  upfile <file>                                          upload file (public)",
+                "  upfile <file> --private                               private file",
+                "  upfile <file> --expiry <seconds>                     expiring URL",
+                "  upfile <file> --json                                  JSON output",
+                "  cat file | upfile                                      pipe from stdin",
+                "  upfile ls [--limit N] [--json]                         list your files",
+                "  upfile rm <id>                                        delete a file",
+                "  upfile config set api-key <key>",
+                "  upfile config set endpoint <url>",
+            ].join("\n"));
+            process.exit(1);
+        }
+        result = await (0, upload_js_1.uploadFile)(path_1.default.resolve(filePath), opts);
+    }
+    if (isJson)
+        console.log(JSON.stringify(result, null, 2));
+    else
+        console.log(result.url);
+}
+main().catch(e => { console.error(e.message); process.exit(1); });

package/dist/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/upload.js

@@ -0,0 +1,116 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.signup = signup;
+exports.getStatus = getStatus;
+exports.getUpgradeUrl = getUpgradeUrl;
+exports.uploadFile = uploadFile;
+exports.uploadStdin = uploadStdin;
+exports.listFiles = listFiles;
+exports.deleteFile = deleteFile;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const form_data_1 = __importDefault(require("form-data"));
+const node_fetch_1 = __importDefault(require("node-fetch"));
+const config_js_1 = require("./config.js");
+function getAuth() {
+    const config = (0, config_js_1.loadConfig)();
+    const apiKey = config.apiKey || process.env.UPFILE_API_KEY;
+    const endpoint = config.endpoint || config_js_1.DEFAULT_ENDPOINT;
+    if (!apiKey)
+        throw new Error("No API key. Run: upfile signup --email your@email.com");
+    return { apiKey, endpoint };
+}
+async function signup(email, ownerEmail) {
+    const { endpoint } = getAuth();
+    const res = await (0, node_fetch_1.default)(`${endpoint}/signup`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ email, owner_email: ownerEmail }),
+    });
+    if (!res.ok)
+        throw new Error(`Signup failed (${res.status}): ${await res.text()}`);
+    return res.json();
+}
+async function getStatus() {
+    const { apiKey, endpoint } = getAuth();
+    const res = await (0, node_fetch_1.default)(`${endpoint}/status`, {
+        headers: { Authorization: `Bearer ${apiKey}` },
+    });
+    if (!res.ok)
+        throw new Error(`Status check failed (${res.status}): ${await res.text()}`);
+    const data = await res.json();
+    return data;
+}
+async function getUpgradeUrl() {
+    const { apiKey, endpoint } = getAuth();
+    const res = await (0, node_fetch_1.default)(`${endpoint}/upgrade`, {
+        headers: { Authorization: `Bearer ${apiKey}` },
+    });
+    if (!res.ok)
+        throw new Error(`Upgrade check failed (${res.status}): ${await res.text()}`);
+    return res.json();
+}
+async function uploadFile(filePath, opts) {
+    const { apiKey, endpoint } = getAuth();
+    const form = new form_data_1.default();
+    form.append("file", fs_1.default.createReadStream(filePath), path_1.default.basename(filePath));
+    form.append("visibility", opts.visibility);
+    if (opts.ttl)
+        form.append("ttl", String(opts.ttl));
+    const res = await (0, node_fetch_1.default)(`${endpoint}/upload`, {
+        method: "POST",
+        headers: { Authorization: `Bearer ${apiKey}`, ...form.getHeaders() },
+        body: form,
+    });
+    if (!res.ok) {
+        const err = await res.json().catch(async () => ({ error: await res.text() }));
+        const errorObj = err;
+        if (errorObj.error?.includes("Storage limit")) {
+            throw new Error(`Storage limit reached (${errorObj.storage_used_gb}GB / ${errorObj.limit_gb}GB). ${errorObj.message}`);
+        }
+        throw new Error(`Upload failed (${res.status}): ${errorObj.error || await res.text()}`);
+    }
+    return res.json();
+}
+async function uploadStdin(opts) {
+    const { apiKey, endpoint } = getAuth();
+    const chunks = [];
+    for await (const chunk of process.stdin)
+        chunks.push(chunk);
+    const buffer = Buffer.concat(chunks);
+    const form = new form_data_1.default();
+    form.append("file", buffer, { filename: "upload.bin", contentType: "application/octet-stream" });
+    form.append("visibility", opts.visibility);
+    if (opts.ttl)
+        form.append("ttl", String(opts.ttl));
+    const res = await (0, node_fetch_1.default)(`${endpoint}/upload`, {
+        method: "POST",
+        headers: { Authorization: `Bearer ${apiKey}`, ...form.getHeaders() },
+        body: form,
+    });
+    if (!res.ok)
+        throw new Error(`Upload failed (${res.status}): ${await res.text()}`);
+    return res.json();
+}
+async function listFiles(limit = 20) {
+    const { apiKey, endpoint } = getAuth();
+    const res = await (0, node_fetch_1.default)(`${endpoint}/files?limit=${limit}`, {
+        headers: { Authorization: `Bearer ${apiKey}` },
+    });
+    if (!res.ok)
+        throw new Error(`List failed (${res.status}): ${await res.text()}`);
+    const data = await res.json();
+    return data.files;
+}
+async function deleteFile(id) {
+    const { apiKey, endpoint } = getAuth();
+    const res = await (0, node_fetch_1.default)(`${endpoint}/f/${id}`, {
+        method: "DELETE",
+        headers: { Authorization: `Bearer ${apiKey}` },
+    });
+    if (!res.ok)
+        throw new Error(`Delete failed (${res.status}): ${await res.text()}`);
+}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "upfilesh",
+  "version": "0.1.0",
+  "description": "Instant file uploads from the command line — upfile.sh",
+  "bin": {
+    "upfile": "./bin/upfile"
+  },
+  "main": "dist/index.js",
+  "files": [
+    "bin/",
+    "dist/",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "ts-node src/index.ts",
+    "prepublishOnly": "yarn build"
+  },
+  "keywords": [
+    "upload",
+    "file-sharing",
+    "cli",
+    "cdn",
+    "ai-agents",
+    "terminal",
+    "command-line"
+  ],
+  "author": "Perry Raskin <perry@upfile.sh>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/upfilesh/cli.git"
+  },
+  "bugs": {
+    "url": "https://github.com/upfilesh/cli/issues"
+  },
+  "homepage": "https://upfile.sh",
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "form-data": "^4.0.0",
+    "node-fetch": "^3.3.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.4.0",
+    "ts-node": "^10.9.0"
+  }
+}