@buildinternet/uploads 0.8.0 → 0.10.0

package/dist/errors.d.ts

@@ -1,4 +1,4 @@
-export type UploadsErrorCode = "MISSING_TOKEN" | "NO_PUBLIC_URL" | "FILE_NOT_FOUND" | "NOT_FOUND" | "UNAUTHORIZED" | "INVALID_KEY" | "KEY_POLICY" | "STORAGE_QUOTA" | "UPLOAD_BUDGET" | "API_ERROR" | "NETWORK" | "USAGE";
+export type UploadsErrorCode = "MISSING_TOKEN" | "NO_PUBLIC_URL" | "FILE_NOT_FOUND" | "NOT_FOUND" | "UNAUTHORIZED" | "INVALID_KEY" | "KEY_POLICY" | "STORAGE_QUOTA" | "UPLOAD_BUDGET" | "GITHUB_REQUIRED" | "API_ERROR" | "NETWORK" | "USAGE";
 export declare class UploadsError extends Error {
     readonly code: UploadsErrorCode;
     readonly status?: number;

package/dist/format-bytes.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Human-readable size for CLI notes (1024-based).
+ * files-sdk has no size formatter — only raw `size` on head/upload results.
+ */
+export declare function formatByteSize(bytes: number): string;

package/dist/format-bytes.js

@@ -0,0 +1,11 @@
+/**
+ * Human-readable size for CLI notes (1024-based).
+ * files-sdk has no size formatter — only raw `size` on head/upload results.
+ */
+export function formatByteSize(bytes) {
+    if (!Number.isFinite(bytes) || bytes <= 0)
+        return "0 B";
+    const units = ["B", "KB", "MB", "GB", "TB"];
+    const exponent = Math.min(Math.floor(Math.log(bytes) / Math.log(1024)), units.length - 1);
+    return `${(bytes / 1024 ** exponent).toFixed(exponent === 0 ? 0 : 1)} ${units[exponent]}`;
+}

package/dist/github-gh.d.ts

@@ -9,6 +9,13 @@ export declare const execRunner: CommandRunner;
 export declare function resolveRepo(explicit: string | undefined, run?: CommandRunner): string;
 /** Resolve the pull request associated with the current branch. */
 export declare function resolveCurrentPullRequest(repo: string, run?: CommandRunner): GhTarget;
+/**
+ * Classify a bare PR/issue number via the GitHub API so the default `put`
+ * path can stamp the right `gh.kind`. Returns undefined on any failure (gh
+ * missing, 404, network) — the caller treats that as "no gh context" and
+ * uploads without metadata.
+ */
+export declare function classifyGhNumber(repo: string, num: number, run?: CommandRunner): GhTarget | undefined;
 /**
  * Create the managed attachments comment, or edit it in place if it already
  * exists. Never touches any other comment. Body is passed via stdin

package/dist/github-gh.js

@@ -61,6 +61,30 @@ export function resolveCurrentPullRequest(repo, run = execRunner) {
     }
     throw new UsageError("could not infer a pull request for the current branch — pass --pr <num> or --issue <num>");
 }
+/**
+ * Classify a bare PR/issue number via the GitHub API so the default `put`
+ * path can stamp the right `gh.kind`. Returns undefined on any failure (gh
+ * missing, 404, network) — the caller treats that as "no gh context" and
+ * uploads without metadata.
+ */
+export function classifyGhNumber(repo, num, run = execRunner) {
+    try {
+        const out = run("gh", [
+            "api",
+            `repos/${repo}/issues/${num}`,
+            "--jq",
+            'if .pull_request then "pull" else "issue" end',
+        ]).trim();
+        if (out === "pull")
+            return { repo, kind: "pull", num };
+        if (out === "issue")
+            return { repo, kind: "issues", num };
+    }
+    catch {
+        // gh missing / not found / network — caller skips
+    }
+    return undefined;
+}
 /**
  * PR comments live on the issues endpoint, so one path covers PRs and issues.
  * Only the first 100 comments are searched (accepted v1 limitation).

package/dist/update-check.d.ts

@@ -23,6 +23,16 @@ export declare function parseSemver(version: string): [number, number, number] |
 export declare function isNewerVersion(latest: string, current: string): boolean;
 export declare function readUpdateCache(path: string): UpdateCache | undefined;
 export declare function writeUpdateCache(path: string, cache: UpdateCache): void;
+export interface UpdateStatus {
+    current: string;
+    latest?: string;
+    updateAvailable: boolean;
+}
+/**
+ * Resolve current vs latest published version (cache + optional network).
+ * Always resolves; never throws. Does not print.
+ */
+export declare function checkForUpdate(opts?: UpdateCheckOptions): Promise<UpdateStatus>;
 /**
  * If a newer published version is known (or can be fetched within the timeout),
  * write a one-line stderr hint. Always resolves; never throws.

package/dist/update-check.js

@@ -69,20 +69,21 @@ export function writeUpdateCache(path, cache) {
     }
 }
 /**
- * If a newer published version is known (or can be fetched within the timeout),
- * write a one-line stderr hint. Always resolves; never throws.
+ * Resolve current vs latest published version (cache + optional network).
+ * Always resolves; never throws. Does not print.
  */
-export async function maybeHintUpdate(opts = {}) {
+export async function checkForUpdate(opts = {}) {
+    const current = opts.currentVersion ?? packageVersion();
     try {
-        if (opts.quiet || opts.command === "mcp")
-            return;
-        if (truthyEnv("UPLOADS_NO_UPDATE") || truthyEnv("NO_UPDATE_NOTIFIER"))
-            return;
-        const current = opts.currentVersion ?? packageVersion();
+        if (opts.quiet || opts.command === "mcp") {
+            return { current, updateAvailable: false };
+        }
+        if (truthyEnv("UPLOADS_NO_UPDATE") || truthyEnv("NO_UPDATE_NOTIFIER")) {
+            return { current, updateAvailable: false };
+        }
         const cachePath = opts.cachePath ?? defaultCachePath();
         const now = opts.now ?? Date.now();
         const ttlMs = opts.ttlMs ?? DEFAULT_TTL_MS;
-        const write = opts.write ?? ((text) => process.stderr.write(text));
         const cached = readUpdateCache(cachePath);
         let latest;
         if (cached && now - cached.checkedAt < ttlMs && cached.current === current) {
@@ -98,9 +99,24 @@ export async function maybeHintUpdate(opts = {}) {
                 latest = cached.latest; // stale cache if network failed
             }
         }
-        if (latest && isNewerVersion(latest, current)) {
-            write(`hint: ${PACKAGE_NAME}@${latest} is available (you have ${current}). Update: npm i -g ${PACKAGE_NAME}\n`);
-        }
+        const updateAvailable = Boolean(latest && isNewerVersion(latest, current));
+        return { current, latest, updateAvailable };
+    }
+    catch {
+        return { current, updateAvailable: false };
+    }
+}
+/**
+ * If a newer published version is known (or can be fetched within the timeout),
+ * write a one-line stderr hint. Always resolves; never throws.
+ */
+export async function maybeHintUpdate(opts = {}) {
+    try {
+        const status = await checkForUpdate(opts);
+        if (!status.updateAvailable || !status.latest)
+            return;
+        const write = opts.write ?? ((text) => process.stderr.write(text));
+        write(`hint: ${PACKAGE_NAME}@${status.latest} is available (you have ${status.current}). Update: npm i -g ${PACKAGE_NAME}\n`);
     }
     catch {
         // Never surface update-check failures.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@buildinternet/uploads",
-  "version": "0.8.0",
+  "version": "0.10.0",
   "description": "CLI and client for uploads.sh — workspace-scoped image hosting for GitHub embeds",
   "type": "module",
   "sideEffects": false,