@buildinternet/uploads 0.10.1 → 0.11.1

package/dist/commands.d.ts

@@ -1,4 +1,4 @@
-import { type UploadsClient } from "./client.js";
+import { type PutResult, type UploadsClient } from "./client.js";
 import { type CommandFlags } from "./cli-args.js";
 import { type ResolvedConfig } from "./config.js";
 import { type GhTarget } from "./github.js";
@@ -6,6 +6,11 @@ import { type CommandRunner } from "./github-gh.js";
 import { type OptimizeImageOptions, type OptimizeImageResult } from "./optimize.js";
 import { type FrameResult } from "./frame.js";
 import type { PutDefaults } from "./config-file.js";
+/** Parallel fan-out for multi-file put/attach (matches files-sdk bulk default). */
+export declare const UPLOAD_BATCH_CONCURRENCY = 8;
+/** @deprecated Use UPLOAD_BATCH_CONCURRENCY. */
+export declare const ATTACH_CONCURRENCY = 8;
+export { formatUsageHuman } from "./format-usage.js";
 export interface CliContext {
     config: ResolvedConfig;
     client: UploadsClient;
@@ -41,6 +46,92 @@ export declare function syncAttachmentsComment(client: UploadsClient, target: Gh
     action: "created" | "updated" | "skipped";
     count: number;
 }>;
+export type AttachUploadItem = PutResult & {
+    file: string;
+    markdown: string;
+    optimize: {
+        optimized: boolean;
+        skippedReason?: OptimizeImageResult["skippedReason"];
+        originalBytes: number;
+        outputBytes: number;
+        filename: string;
+    };
+    frame?: PreparedUpload["frame"];
+};
+export type AttachFailure = {
+    file: string;
+    error: {
+        message: string;
+        code?: string;
+        status?: number;
+    };
+};
+/**
+ * Prepare + put each path as a PR/issue attachment with bounded concurrency.
+ * Per-file errors collect in `failures` (does not throw). `firstError` is the
+ * original cause of the first failure — for rethrowing single-file CLI paths.
+ */
+export declare function uploadAttachments(opts: {
+    client: UploadsClient;
+    target: GhTarget;
+    files: readonly string[];
+    contentType?: string;
+    optimize: OptimizeImageOptions;
+    frame: {
+        frameId?: string;
+        frameUrl?: string;
+        frameFit?: "cover" | "contain";
+    };
+    metadata?: Record<string, string>;
+    /** Provenance `client` field (default uploads-cli). */
+    provenanceClient?: string;
+    concurrency?: number;
+}): Promise<{
+    uploads: AttachUploadItem[];
+    failures: AttachFailure[];
+    firstError?: unknown;
+}>;
+export type PutUploadItem = PutResult & {
+    file: string;
+    markdown: string;
+    optimize: AttachUploadItem["optimize"];
+    frame?: PreparedUpload["frame"];
+};
+/**
+ * Prepare + put each path with put-style key resolution and bounded concurrency.
+ * Same partial-failure shape as uploadAttachments.
+ */
+export declare function uploadPuts(opts: {
+    client: UploadsClient;
+    files: readonly string[];
+    /** Single-file --name leaf override. */
+    nameOverride?: string;
+    /** Single-file --key. */
+    explicitKey?: string;
+    ghTarget?: GhTarget;
+    prefix?: string;
+    repo?: string;
+    ref?: string;
+    deriveRepoFromGit?: boolean;
+    contentType?: string;
+    dryRun?: boolean;
+    optimize: OptimizeImageOptions;
+    frame: {
+        frameId?: string;
+        frameUrl?: string;
+        frameFit?: "cover" | "contain";
+    };
+    metadata?: Record<string, string>;
+    provenanceClient?: string;
+    /** When set, used as alt for every file; else each file's basename. */
+    alt?: string;
+    width?: number;
+    concurrency?: number;
+}): Promise<{
+    uploads: PutUploadItem[];
+    failures: AttachFailure[];
+    firstError?: unknown;
+}>;
 export declare function runAttach(ctx: CliContext, args: string[], help?: boolean, run?: CommandRunner): Promise<number>;
 export declare function runPut(ctx: CliContext, args: string[], help?: boolean, run?: CommandRunner): Promise<number>;
 export declare function runGallery(ctx: CliContext, args: string[], help?: boolean): Promise<number>;