dropley 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Dropley
+
+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,110 @@
+# dropley
+
+Publish files and static sites to [Dropley](https://dropley.app) from your terminal — no browser, no account.
+
+`dropley` wraps the [Dropley public API](https://dropley.app/api/v1/openapi.json) so agents and humans can publish artifacts and manage them with four commands. Every published artifact gets a shareable URL and a token for later update/delete.
+
+## Install
+
+```sh
+npm install -g dropley
+# or run without installing:
+npx dropley publish ./dist
+```
+
+Requires Node.js ≥ 20. Zero runtime dependencies.
+
+## Quickstart
+
+```sh
+# Publish a directory (static site) — uploads each file, skipping OS junk (.DS_Store, .git, …)
+dropley publish ./dist --expiry 7d
+# url: https://preview.dropley.app/p/aB3cD5eF
+# token: tok_a1b2c3…   ← keep this; needed to update/delete
+
+# A single file is published as the site entry (index.html)
+dropley publish report.html
+
+# Show metadata (public without a token)
+dropley status https://preview.dropley.app/p/aB3cD5eF
+
+# Change expiry (needs the artifact token)
+dropley update aB3cD5eF --expiry 30d
+
+# Delete permanently
+dropley delete aB3cD5eF
+```
+
+## Agent usage
+
+`dropley` is designed for agents: quiet, machine-parsable output on stdout, progress on stderr.
+
+```sh
+# JSON mode — everything needed in one object
+dropley publish ./out --json
+# {
+#   "shortId": "aB3cD5eF",
+#   "url": "https://preview.dropley.app/p/aB3cD5eF",
+#   "expiresAt": "2026-08-30T12:00:00.000Z",
+#   "artifactToken": "tok_a1b2c3…"
+# }
+```
+
+- Exit codes: `0` success, `1` failure (API/network errors), `2` usage error.
+- API errors surface the server's `error`/`code`/`hint` verbatim on stderr, including `RATE_LIMITED` 429 responses with their `Retry-After`.
+- The token returned by `publish` is saved locally (per artifact ID, `0600` perms, `~/.config/dropley/tokens.json` or `$XDG_CONFIG_HOME`/`$DROPLEY_CONFIG_DIR`) and reused by `status`/`update`/`delete` automatically.
+
+See also the Dropley [agent skills](https://github.com/dropley) collection — `npx skills@latest add dropley/docs` for docs on publishing via agents.
+
+## Commands
+
+| Command | Description |
+| --- | --- |
+| `dropley publish <path> [--expiry <t>]` | Publish a file or directory; prints URL + token |
+| `dropley status <url-or-shortId>` | Show artifact metadata |
+| `dropley update <url-or-shortId> --expiry <t>` | Change an artifact's expiry |
+| `dropley delete <url-or-shortId>` | Permanently delete an artifact |
+| `dropley pack <dir> [--out archive.zip]` | Create a byte-reproducible zip (auxiliary; see below) |
+
+### Global options
+
+| Option | Description |
+| --- | --- |
+| `--json` | Machine-readable JSON output on stdout |
+| `--api <url>` | API base URL (default `https://dropley.app`; env `DROPLEY_API` for local previews) |
+| `--token <tok>` | Artifact token (env `DROPLEY_TOKEN`); precedence: `--token` > `DROPLEY_TOKEN` > saved token |
+| `--expiry <t>` | `1d` `3d` `7d` `15d` `30d` `1h`… — server-validated |
+
+### Notes
+
+- **Directory publishes** upload every file as an individual part with its relative path (Dropley requires the site entry to be `index.html` at the root). OS metadata (`.DS_Store`, `Thumbs.db`, `desktop.ini`, `._*`), VCS internals (`.git`, `.hg`, `.svn`) and `node_modules` are skipped.
+- **`dropley pack`** writes a byte-for-byte reproducible zip archive (sorted entries, fixed timestamps, no junk). Dropley serves uploads as-is and does not expand archives, so publish directories directly for hosting — `pack` is for archiving and reproducible builds.
+- 50MB total / 1000 files per artifact (checked locally before upload).
+
+## Development
+
+```sh
+npm install
+npm run lint        # eslint
+npm run typecheck   # tsc --noEmit
+npm test            # vitest (mocked fetch, no network)
+npm run build       # tsc → dist/
+```
+
+## Release
+
+Release: push a `v*` tag; the release workflow runs checks and publishes to npm with `--provenance` via **trusted publishing** (OIDC — no npm token stored in GitHub).
+
+Setup (once, by a maintainer):
+
+1. Make the repo public (trusted publishing is identity-based and works fine on public repos).
+2. On npmjs.com → package settings → **Trusted publishing**: add GitHub owner `dropley`, repository `cli`, environment `npm`, workflow `release.yml`.
+3. On GitHub → repo settings → **Environments** → `npm`: configure required reviewers (the approval gate the publish waits on).
+
+The first publish is always a human step: tag, push, approve the environment.
+
+> Note: if the `dropley` package name is not yet claimed on npm, the very first publish may need a one-time token (npm requires the package to exist before trusted publishing can be configured); trusted publishing takes over for all subsequent releases.
+
+## License
+
+MIT

package/dist/api.d.ts

@@ -0,0 +1,55 @@
+export declare const DEFAULT_BASE_URL = "https://dropley.app";
+export declare class ApiError extends Error {
+    readonly status: number;
+    readonly code?: string;
+    readonly hint?: string;
+    readonly retryAfter?: number;
+    readonly requestId?: string;
+    constructor(message: string, opts: {
+        status: number;
+        code?: string;
+        hint?: string;
+        retryAfter?: number;
+        requestId?: string;
+    });
+}
+export interface CreateResult {
+    shortId: string;
+    url: string;
+    expiresAt: string | null;
+    artifactToken: string;
+}
+export interface ArtifactInfo {
+    shortId: string;
+    status: string;
+    url?: string;
+    expiresAt?: string | null;
+    source?: string;
+    tags?: string[];
+    createdAt?: string;
+    error?: string;
+    [key: string]: unknown;
+}
+export interface UpdateResult {
+    success: boolean;
+    expiresAt?: string | null;
+    source?: string;
+    tags?: string[];
+    [key: string]: unknown;
+}
+export interface UploadPart {
+    /** Path used as the multipart filename and manifest entry (POSIX style). */
+    path: string;
+    contentType: string;
+    data: Uint8Array;
+}
+export declare function createArtifact(baseUrl: string, parts: readonly UploadPart[], opts: {
+    expiry?: string;
+    entry?: string;
+    timeoutMs?: number;
+}): Promise<CreateResult>;
+export declare function getArtifact(baseUrl: string, shortId: string, token?: string): Promise<ArtifactInfo>;
+export declare function updateArtifact(baseUrl: string, shortId: string, token: string, patch: Record<string, unknown>): Promise<UpdateResult>;
+export declare function deleteArtifact(baseUrl: string, shortId: string, token: string): Promise<{
+    success: boolean;
+}>;

package/dist/api.js

@@ -0,0 +1,126 @@
+export const DEFAULT_BASE_URL = 'https://dropley.app';
+export class ApiError extends Error {
+    status;
+    code;
+    hint;
+    retryAfter;
+    requestId;
+    constructor(message, opts) {
+        super(message);
+        this.name = 'ApiError';
+        this.status = opts.status;
+        this.code = opts.code;
+        this.hint = opts.hint;
+        this.retryAfter = opts.retryAfter;
+        this.requestId = opts.requestId;
+    }
+}
+function parseErrorBody(status, text, retryAfterHeader) {
+    let body;
+    try {
+        body = JSON.parse(text);
+    }
+    catch {
+        // non-JSON body (e.g. HTML error page)
+    }
+    if (body && typeof body === 'object') {
+        // Nested rate-limit shape: { error: { code, message } }
+        if (body.error && typeof body.error === 'object') {
+            const nested = body.error;
+            return new ApiError(String(nested.message ?? 'Request failed'), {
+                status,
+                code: nested.code !== undefined ? String(nested.code) : undefined,
+                hint: nested.hint !== undefined ? String(nested.hint) : undefined,
+                retryAfter: parseRetryAfter(retryAfterHeader),
+            });
+        }
+        // Flat shape: { error?, code?, message?, hint? }
+        const flatMessage = firstString(body.message) ??
+            firstString(body.error) ??
+            (body.requestId !== undefined ? `Server error (${String(body.requestId)})` : undefined) ??
+            'Request failed';
+        return new ApiError(flatMessage, {
+            status,
+            code: firstString(body.code),
+            hint: firstString(body.hint),
+            retryAfter: parseRetryAfter(retryAfterHeader),
+            requestId: body.requestId !== undefined ? String(body.requestId) : undefined,
+        });
+    }
+    return new ApiError(text.slice(0, 200) || 'Request failed', {
+        status,
+        retryAfter: parseRetryAfter(retryAfterHeader),
+    });
+}
+function parseRetryAfter(header) {
+    if (!header)
+        return undefined;
+    const n = Number.parseInt(header, 10);
+    return Number.isNaN(n) ? undefined : n;
+}
+function firstString(v) {
+    return typeof v === 'string' && v.length > 0 ? v : undefined;
+}
+async function request(baseUrl, path, init, timeoutMs) {
+    let res;
+    try {
+        res = await fetch(`${baseUrl}${path}`, { ...init, signal: AbortSignal.timeout(timeoutMs) });
+    }
+    catch (err) {
+        if (err.name === 'TimeoutError' || err.name === 'AbortError') {
+            throw new ApiError(`Request timed out after ${timeoutMs / 1000}s`, {
+                status: 0,
+                hint: 'Check your network connection, or point --api at a reachable server.',
+            });
+        }
+        throw new ApiError(`Network error: ${err.message}`, {
+            status: 0,
+            hint: 'Check your network connection, or point --api at a reachable server.',
+        });
+    }
+    if (!res.ok) {
+        const text = await res.text().catch(() => '');
+        throw parseErrorBody(res.status, text, res.headers.get('retry-after'));
+    }
+    return res;
+}
+async function requestJson(baseUrl, path, init, timeoutMs = 30_000) {
+    const res = await request(baseUrl, path, init, timeoutMs);
+    return (await res.json());
+}
+function buildManifest(parts, entry) {
+    return JSON.stringify({
+        manifestVersion: 1,
+        entry,
+        files: parts.map((p) => ({
+            path: p.path,
+            size: p.data.length,
+            contentType: p.contentType,
+        })),
+    });
+}
+export function createArtifact(baseUrl, parts, opts) {
+    const form = new FormData();
+    form.set('manifest', buildManifest(parts, opts.entry ?? 'index.html'));
+    if (opts.expiry !== undefined)
+        form.set('expiry', opts.expiry);
+    for (const part of parts) {
+        form.append('file', new File([part.data], part.path, { type: part.contentType }));
+    }
+    return requestJson(baseUrl, '/api/artifacts', { method: 'POST', body: form }, opts.timeoutMs ?? 300_000);
+}
+export function getArtifact(baseUrl, shortId, token) {
+    const query = token ? `?token=${encodeURIComponent(token)}` : '';
+    return requestJson(baseUrl, `/api/artifacts/${encodeURIComponent(shortId)}${query}`, { method: 'GET' });
+}
+export function updateArtifact(baseUrl, shortId, token, patch) {
+    return requestJson(baseUrl, `/api/artifacts/${encodeURIComponent(shortId)}`, {
+        method: 'PATCH',
+        headers: { 'X-Artifact-Token': token, 'Content-Type': 'application/json' },
+        body: JSON.stringify(patch),
+    });
+}
+export function deleteArtifact(baseUrl, shortId, token) {
+    return requestJson(baseUrl, `/api/artifacts/${encodeURIComponent(shortId)}`, { method: 'DELETE', headers: { 'X-Artifact-Token': token } });
+}
+//# sourceMappingURL=api.js.map

package/dist/api.js.map

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

package/dist/args.d.ts

@@ -0,0 +1,21 @@
+export type FlagKind = 'boolean' | 'value';
+export interface PositionalSpec {
+    name: string;
+    required: boolean;
+    description?: string;
+}
+export interface CommandSpec {
+    summary: string;
+    flags: Record<string, FlagKind>;
+    positionals: PositionalSpec[];
+}
+export declare const GLOBAL_FLAGS: Record<string, FlagKind>;
+export interface ParsedInvocation {
+    command: string;
+    positionals: string[];
+    values: Record<string, string>;
+    flags: Set<string>;
+}
+/** Shape handed to command handlers (everything except the command name). */
+export type ParsedArgs = Omit<ParsedInvocation, 'command'>;
+export declare function parseArgv(argv: readonly string[], specs: Record<string, CommandSpec>): ParsedInvocation;

package/dist/args.js

@@ -0,0 +1,83 @@
+import { UsageError } from './errors.js';
+export const GLOBAL_FLAGS = {
+    json: 'boolean',
+    api: 'value',
+    token: 'value',
+    help: 'boolean',
+    version: 'boolean',
+};
+const VALUE_RE = /^(--[A-Za-z0-9][A-Za-z0-9-]*)=(.*)$/;
+export function parseArgv(argv, specs) {
+    const commandArg = argv[0];
+    if (commandArg === undefined || commandArg === '') {
+        throw new UsageError('Missing command. Run `dropley --help` for usage.');
+    }
+    const spec = specs[commandArg];
+    if (!spec) {
+        throw new UsageError(`Unknown command: ${commandArg}. Run \`dropley --help\` for usage.`);
+    }
+    const flagKinds = { ...GLOBAL_FLAGS, ...spec.flags };
+    const positionals = [];
+    const values = {};
+    const flags = new Set();
+    for (let i = 1; i < argv.length; i++) {
+        const arg = argv[i];
+        if (arg === undefined)
+            break;
+        if (!arg.startsWith('-')) {
+            positionals.push(arg);
+            continue;
+        }
+        if (arg === '--') {
+            for (const rest of argv.slice(i + 1))
+                positionals.push(rest);
+            break;
+        }
+        if (arg === '-') {
+            throw new UsageError("Unexpected argument '-'.");
+        }
+        let name;
+        let inlineValue;
+        const eqMatch = VALUE_RE.exec(arg);
+        if (eqMatch && eqMatch[1] !== undefined) {
+            name = eqMatch[1].slice(2);
+            inlineValue = eqMatch[2] ?? '';
+        }
+        else {
+            name = arg.slice(2);
+        }
+        const kind = flagKinds[name];
+        if (!kind) {
+            throw new UsageError(`Unknown option --${name} for '${commandArg}'.`);
+        }
+        flags.add(name);
+        if (kind === 'boolean') {
+            if (inlineValue !== undefined && inlineValue !== 'true' && inlineValue !== 'false') {
+                throw new UsageError(`Option --${name} does not take a value.`);
+            }
+            if (inlineValue === 'false')
+                flags.delete(name);
+            continue;
+        }
+        const next = argv[i + 1];
+        const value = inlineValue ??
+            (next !== undefined && !next.startsWith('--') ? ((i++, next)) : undefined);
+        if (value === undefined) {
+            throw new UsageError(`Option --${name} requires a value.`);
+        }
+        values[name] = value;
+    }
+    if (flags.has('help') || flags.has('version')) {
+        return { command: commandArg, positionals, values, flags };
+    }
+    const requiredCount = spec.positionals.filter((p) => p.required).length;
+    if (positionals.length < requiredCount) {
+        const missing = spec.positionals[positionals.length];
+        throw new UsageError(`Missing argument: ${missing?.name ?? '<arg>'}.`);
+    }
+    if (positionals.length > spec.positionals.length) {
+        throw new UsageError(`Too many arguments for '${commandArg}' (expected ${spec.positionals.length}).`);
+    }
+    return { command: commandArg, positionals, values, flags };
+}
+//# sourceMappingURL=args.js.map

package/dist/args.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.js","sourceRoot":"","sources":["../src/args.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAgBzC,MAAM,CAAC,MAAM,YAAY,GAA6B;IACpD,IAAI,EAAE,SAAS;IACf,GAAG,EAAE,OAAO;IACZ,KAAK,EAAE,OAAO;IACd,IAAI,EAAE,SAAS;IACf,OAAO,EAAE,SAAS;CACnB,CAAC;AAYF,MAAM,QAAQ,GAAG,qCAAqC,CAAC;AAEvD,MAAM,UAAU,SAAS,CACvB,IAAuB,EACvB,KAAkC;IAElC,MAAM,UAAU,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IAC3B,IAAI,UAAU,KAAK,SAAS,IAAI,UAAU,KAAK,EAAE,EAAE,CAAC;QAClD,MAAM,IAAI,UAAU,CAAC,kDAAkD,CAAC,CAAC;IAC3E,CAAC;IAED,MAAM,IAAI,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC;IAC/B,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,UAAU,CAAC,oBAAoB,UAAU,qCAAqC,CAAC,CAAC;IAC5F,CAAC;IAED,MAAM,SAAS,GAA6B,EAAE,GAAG,YAAY,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;IAC/E,MAAM,WAAW,GAAa,EAAE,CAAC;IACjC,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAEhC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,IAAI,GAAG,KAAK,SAAS;YAAE,MAAM;QAE7B,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACzB,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACtB,SAAS;QACX,CAAC;QACD,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YACjB,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC;gBAAE,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC7D,MAAM;QACR,CAAC;QACD,IAAI,GAAG,KAAK,GAAG,EAAE,CAAC;YAChB,MAAM,IAAI,UAAU,CAAC,0BAA0B,CAAC,CAAC;QACnD,CAAC;QAED,IAAI,IAAY,CAAC;QACjB,IAAI,WAA+B,CAAC;QACpC,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,OAAO,IAAI,OAAO,CAAC,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;YACxC,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAC3B,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACjC,CAAC;aAAM,CAAC;YACN,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACtB,CAAC;QAED,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;QAC7B,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,UAAU,CAAC,oBAAoB,IAAI,SAAS,UAAU,IAAI,CAAC,CAAC;QACxE,CAAC;QACD,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAEhB,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,IAAI,WAAW,KAAK,SAAS,IAAI,WAAW,KAAK,MAAM,IAAI,WAAW,KAAK,OAAO,EAAE,CAAC;gBACnF,MAAM,IAAI,UAAU,CAAC,YAAY,IAAI,yBAAyB,CAAC,CAAC;YAClE,CAAC;YACD,IAAI,WAAW,KAAK,OAAO;gBAAE,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAChD,SAAS;QACX,CAAC;QAED,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACzB,MAAM,KAAK,GACT,WAAW;YACX,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QAC7E,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,MAAM,IAAI,UAAU,CAAC,YAAY,IAAI,oBAAoB,CAAC,CAAC;QAC7D,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;IACvB,CAAC;IAED,IAAI,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;QAC9C,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IAC7D,CAAC;IAED,MAAM,aAAa,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC;IACxE,IAAI,WAAW,CAAC,MAAM,GAAG,aAAa,EAAE,CAAC;QACvC,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QACrD,MAAM,IAAI,UAAU,CAAC,qBAAqB,OAAO,EAAE,IAAI,IAAI,OAAO,GAAG,CAAC,CAAC;IACzE,CAAC;IACD,IAAI,WAAW,CAAC,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC;QACjD,MAAM,IAAI,UAAU,CAClB,2BAA2B,UAAU,eAAe,IAAI,CAAC,WAAW,CAAC,MAAM,IAAI,CAChF,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;AAC7D,CAAC"}

package/dist/bin/dropley.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/bin/dropley.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { main } from '../cli.js';
+process.exitCode = await main();
+//# sourceMappingURL=dropley.js.map

package/dist/bin/dropley.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dropley.js","sourceRoot":"","sources":["../../src/bin/dropley.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,CAAC,QAAQ,GAAG,MAAM,IAAI,EAAE,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+export declare const VERSION: string;
+export declare function main(argv?: readonly string[]): Promise<number>;

package/dist/cli.js

@@ -0,0 +1,112 @@
+import { readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { parseArgv } from './args.js';
+import { ApiError } from './api.js';
+import { EXIT, AuthError, UsageError } from './errors.js';
+import { createIo, formatApiError } from './output.js';
+import { publish } from './commands/publish.js';
+import { status } from './commands/status.js';
+import { update } from './commands/update.js';
+import { del } from './commands/delete.js';
+import { pack } from './commands/pack.js';
+const COMMANDS = {
+    publish: {
+        summary: 'Publish a file or directory and print its public URL + token.',
+        flags: { expiry: 'value' },
+        positionals: [{ name: '<path>', required: true, description: 'File or directory to publish' }],
+        handler: publish,
+    },
+    status: {
+        summary: 'Show metadata for a published artifact.',
+        flags: {},
+        positionals: [{ name: '<url-or-shortId>', required: true }],
+        handler: status,
+    },
+    update: {
+        summary: 'Update an artifact (expiry).',
+        flags: { expiry: 'value' },
+        positionals: [{ name: '<url-or-shortId>', required: true }],
+        handler: update,
+    },
+    delete: {
+        summary: 'Permanently delete an artifact.',
+        flags: {},
+        positionals: [{ name: '<url-or-shortId>', required: true }],
+        handler: del,
+    },
+    pack: {
+        summary: 'Create a byte-reproducible zip archive of a directory.',
+        flags: { out: 'value' },
+        positionals: [{ name: '<dir>', required: true }],
+        handler: pack,
+    },
+};
+export const VERSION = (() => {
+    try {
+        // cli.js sits at <pkgroot>/dist/cli.js in both the repo and installed layout.
+        const pkgUrl = new URL('../package.json', import.meta.url);
+        return (JSON.parse(readFileSync(fileURLToPath(pkgUrl), 'utf8')).version ??
+            '0.0.0-dev');
+    }
+    catch {
+        return '0.0.0-dev';
+    }
+})();
+function usage() {
+    const lines = [
+        `dropley ${VERSION} — publish files and static sites from your terminal`,
+        '',
+        'Usage:',
+        ...Object.entries(COMMANDS).map(([name, spec]) => `  dropley ${name} ${spec.positionals.map((p) => p.name).join(' ')}${Object.keys(spec.flags).length ? ' [options]' : ''}`),
+        '',
+        'Commands:',
+    ];
+    for (const [name, spec] of Object.entries(COMMANDS)) {
+        lines.push(`  ${name.padEnd(10)} ${spec.summary}`);
+    }
+    lines.push('', 'Options:', '  --json          Machine-readable output', '  --api <url>     API base URL (default https://dropley.app; env DROPLEY_API)', '  --token <tok>   Artifact token (env DROPLEY_TOKEN)', '  --expiry <t>    e.g. 1h, 1d, 3d, 7d, 15d, 30d (server-validated)', '', 'Exit codes: 0 success · 1 failure · 2 usage error', 'Docs: https://github.com/dropley/cli');
+    return lines.join('\n');
+}
+export async function main(argv = process.argv.slice(2)) {
+    if (argv.length === 0 || argv[0] === '--help' || argv[0] === '-h' || argv[0] === 'help') {
+        process.stdout.write(`${usage()}\n`);
+        return argv.length === 0 ? EXIT.usage : EXIT.ok;
+    }
+    if (argv[0] === '--version' || argv[0] === '-v' || argv[0] === 'version') {
+        process.stdout.write(`dropley ${VERSION}\n`);
+        return EXIT.ok;
+    }
+    try {
+        const parsed = parseArgv(argv, COMMANDS);
+        if (parsed.flags.has('help')) {
+            process.stdout.write(`${usage()}\n`);
+            return EXIT.ok;
+        }
+        if (parsed.flags.has('version')) {
+            process.stdout.write(`dropley ${VERSION}\n`);
+            return EXIT.ok;
+        }
+        const spec = COMMANDS[parsed.command];
+        if (!spec)
+            throw new UsageError(`Unknown command: ${parsed.command}`);
+        const io = createIo(parsed.flags.has('json'));
+        return await spec.handler(parsed, io);
+    }
+    catch (err) {
+        if (err instanceof UsageError) {
+            process.stderr.write(`${usage()}\n\nerror: ${err.message}\n`);
+            return EXIT.usage;
+        }
+        if (err instanceof AuthError) {
+            process.stderr.write(`${err.message}\n`);
+            return EXIT.failure;
+        }
+        if (err instanceof ApiError) {
+            process.stderr.write(`${formatApiError(err)}\n`);
+            return EXIT.failure;
+        }
+        process.stderr.write(`error: ${err.message ?? String(err)}\nRun \`dropley --help\` for usage.\n`);
+        return EXIT.failure;
+    }
+}
+//# 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/collect.d.ts

@@ -0,0 +1,15 @@
+export declare const MAX_TOTAL_BYTES: number;
+export declare const MAX_FILE_COUNT = 1000;
+export interface CollectedFile {
+    /** Absolute path on disk. */
+    absPath: string;
+    /** Relative POSIX path used as the manifest path and multipart filename. */
+    path: string;
+    size: number;
+}
+/**
+ * Walks a directory recursively and returns every non-junk file, sorted by
+ * relative POSIX path (byte-stable ordering). Junk = OS metadata (.DS_Store,
+ * Thumbs.db, desktop.ini, AppleDouble ._*), VCS internals, and node_modules.
+ */
+export declare function collectFiles(rootDir: string): Promise<CollectedFile[]>;

package/dist/collect.js

@@ -0,0 +1,59 @@
+import { readdir, stat } from 'node:fs/promises';
+import { join } from 'node:path';
+import { UsageError } from './errors.js';
+export const MAX_TOTAL_BYTES = 50 * 1024 * 1024;
+export const MAX_FILE_COUNT = 1000;
+const JUNK_FILES = new Set(['.DS_Store', 'Thumbs.db', 'desktop.ini']);
+const JUNK_DIRS = new Set(['.git', '.hg', '.svn']);
+function isJunkName(name) {
+    return JUNK_FILES.has(name) || name.startsWith('._');
+}
+/**
+ * Walks a directory recursively and returns every non-junk file, sorted by
+ * relative POSIX path (byte-stable ordering). Junk = OS metadata (.DS_Store,
+ * Thumbs.db, desktop.ini, AppleDouble ._*), VCS internals, and node_modules.
+ */
+export async function collectFiles(rootDir) {
+    const out = [];
+    let totalBytes = 0;
+    const walk = async (dir) => {
+        const entries = await readdir(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (entry.name === 'node_modules' && entry.isDirectory())
+                continue;
+            if (entry.isDirectory()) {
+                if (!JUNK_DIRS.has(entry.name))
+                    await walk(join(dir, entry.name));
+                continue;
+            }
+            if (!entry.isFile())
+                continue;
+            if (isJunkName(entry.name))
+                continue;
+            const absPath = join(dir, entry.name);
+            const relPath = absPath.slice(rootDir.length + 1).split('\\').join('/');
+            const size = (await stat(absPath)).size;
+            totalBytes += size;
+            out.push({ absPath, path: relPath, size });
+        }
+    };
+    try {
+        await walk(rootDir);
+    }
+    catch (err) {
+        if (err instanceof UsageError)
+            throw err;
+        throw new UsageError(`Cannot read directory ${rootDir}: ${err.message}`);
+    }
+    out.sort((a, b) => (a.path < b.path ? -1 : a.path > b.path ? 1 : 0));
+    if (out.length === 0)
+        throw new UsageError(`No files found in ${rootDir}.`);
+    if (out.length > MAX_FILE_COUNT) {
+        throw new UsageError(`Too many files: ${out.length} (max ${MAX_FILE_COUNT}). Publish a build output directory instead.`);
+    }
+    if (totalBytes > MAX_TOTAL_BYTES) {
+        throw new UsageError(`Total size ${(totalBytes / 1024 / 1024).toFixed(1)}MB exceeds the ${MAX_TOTAL_BYTES / 1024 / 1024}MB limit.`);
+    }
+    return out;
+}
+//# sourceMappingURL=collect.js.map