@fragno-dev/upload 0.1.1

package/dist/node/cli/commands/files/download.d.ts

@@ -0,0 +1,49 @@
+import * as gunshi0 from "gunshi";
+
+//#region src/cli/commands/files/download.d.ts
+declare const filesDownloadCommand: gunshi0.Command<{
+  "file-key": {
+    type: "string";
+    description: string;
+  };
+  "key-parts": {
+    type: "string";
+    description: string;
+  };
+  output: {
+    type: "string";
+    short: string;
+    description: string;
+  };
+  stdout: {
+    type: "boolean";
+    description: string;
+  };
+  "base-url": {
+    readonly type: "string";
+    readonly short: "b";
+    readonly description: "Upload fragment base URL (env: FRAGNO_UPLOAD_BASE_URL)";
+  };
+  header: {
+    readonly type: "string";
+    readonly short: "H";
+    readonly description: "Extra HTTP header (repeatable), format: 'Name: value' (env: FRAGNO_UPLOAD_HEADERS)";
+    readonly multiple: true;
+  };
+  timeout: {
+    readonly type: "number";
+    readonly description: "Request timeout in ms (env: FRAGNO_UPLOAD_TIMEOUT_MS, default: 15000)";
+  };
+  retries: {
+    readonly type: "number";
+    readonly description: "Retry count for network/5xx/429 (env: FRAGNO_UPLOAD_RETRIES, default: 2)";
+  };
+  "retry-delay": {
+    readonly type: "number";
+    readonly description: "Delay between retries in ms (env: FRAGNO_UPLOAD_RETRY_DELAY_MS, default: 500)";
+  };
+}>;
+//# sourceMappingURL=download.d.ts.map
+//#endregion
+export { filesDownloadCommand };
+//# sourceMappingURL=download.d.ts.map

package/dist/node/cli/commands/files/download.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"download.d.ts","names":[],"sources":["../../../../../src/cli/commands/files/download.ts"],"sourcesContent":[],"mappings":";;;cAOa,sBAyEX,OAAA,CAzE+B;;;IAApB,WAAA,EAAA,MAyEX"}

package/dist/node/cli/commands/files/download.js

@@ -0,0 +1,65 @@
+import { baseArgs, createClientFromContext, resolveFileKeyValue } from "../../utils/options.js";
+import { createWriteStream } from "node:fs";
+import { Readable } from "node:stream";
+import { pipeline } from "node:stream/promises";
+import { define } from "gunshi";
+
+//#region src/cli/commands/files/download.ts
+const filesDownloadCommand = define({
+	name: "download",
+	description: "Download file contents",
+	args: {
+		...baseArgs,
+		"file-key": {
+			type: "string",
+			description: "File key (encoded)"
+		},
+		"key-parts": {
+			type: "string",
+			description: "File key parts as JSON array"
+		},
+		output: {
+			type: "string",
+			short: "o",
+			description: "Output file path"
+		},
+		stdout: {
+			type: "boolean",
+			description: "Write content to stdout"
+		}
+	},
+	run: async (ctx) => {
+		const resolvedKey = resolveFileKeyValue({
+			fileKey: ctx.values["file-key"],
+			keyParts: ctx.values["key-parts"]
+		});
+		const outputPath = ctx.values["output"];
+		const toStdout = Boolean(ctx.values["stdout"]);
+		if (!outputPath && !toStdout) throw new Error("Provide --output or --stdout.");
+		const client = createClientFromContext(ctx);
+		let response;
+		try {
+			const download = await client.getDownloadUrl(resolvedKey.fileKey);
+			response = await fetch(download.url, {
+				method: "GET",
+				headers: download.headers
+			});
+			if (!response.ok) throw new Error(`Download failed (${response.status})`);
+		} catch (error) {
+			if ((error instanceof Error ? error.code : void 0) !== "SIGNED_URL_UNSUPPORTED") throw error;
+			response = await client.downloadContent(resolvedKey.fileKey);
+		}
+		if (!response.body) throw new Error("Response has no body");
+		const bodyStream = Readable.fromWeb(response.body);
+		if (toStdout) {
+			await pipeline(bodyStream, process.stdout);
+			return;
+		}
+		await pipeline(bodyStream, createWriteStream(outputPath));
+		console.log(`Downloaded to ${outputPath}`);
+	}
+});
+
+//#endregion
+export { filesDownloadCommand };
+//# sourceMappingURL=download.js.map

package/dist/node/cli/commands/files/download.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"download.js","names":["response: Response"],"sources":["../../../../../src/cli/commands/files/download.ts"],"sourcesContent":["import { define } from \"gunshi\";\nimport { createWriteStream } from \"node:fs\";\nimport { Readable } from \"node:stream\";\nimport type { ReadableStream as NodeReadableStream } from \"node:stream/web\";\nimport { pipeline } from \"node:stream/promises\";\nimport { baseArgs, createClientFromContext, resolveFileKeyValue } from \"../../utils/options.js\";\n\nexport const filesDownloadCommand = define({\n  name: \"download\",\n  description: \"Download file contents\",\n  args: {\n    ...baseArgs,\n    \"file-key\": {\n      type: \"string\",\n      description: \"File key (encoded)\",\n    },\n    \"key-parts\": {\n      type: \"string\",\n      description: \"File key parts as JSON array\",\n    },\n    output: {\n      type: \"string\",\n      short: \"o\",\n      description: \"Output file path\",\n    },\n    stdout: {\n      type: \"boolean\",\n      description: \"Write content to stdout\",\n    },\n  },\n  run: async (ctx) => {\n    const resolvedKey = resolveFileKeyValue({\n      fileKey: ctx.values[\"file-key\"] as string | undefined,\n      keyParts: ctx.values[\"key-parts\"] as string | undefined,\n    });\n\n    const outputPath = ctx.values[\"output\"] as string | undefined;\n    const toStdout = Boolean(ctx.values[\"stdout\"]);\n\n    if (!outputPath && !toStdout) {\n      throw new Error(\"Provide --output or --stdout.\");\n    }\n\n    const client = createClientFromContext(ctx);\n\n    let response: Response;\n    try {\n      const download = (await client.getDownloadUrl(resolvedKey.fileKey)) as {\n        url: string;\n        headers?: Record<string, string>;\n      };\n      response = await fetch(download.url, {\n        method: \"GET\",\n        headers: download.headers,\n      });\n      if (!response.ok) {\n        throw new Error(`Download failed (${response.status})`);\n      }\n    } catch (error) {\n      const code = error instanceof Error ? (error as Error & { code?: string }).code : undefined;\n      if (code !== \"SIGNED_URL_UNSUPPORTED\") {\n        throw error;\n      }\n      response = await client.downloadContent(resolvedKey.fileKey);\n    }\n\n    if (!response.body) {\n      throw new Error(\"Response has no body\");\n    }\n\n    const bodyStream = Readable.fromWeb(response.body as unknown as NodeReadableStream);\n\n    if (toStdout) {\n      await pipeline(bodyStream, process.stdout);\n      return;\n    }\n\n    await pipeline(bodyStream, createWriteStream(outputPath as string));\n    console.log(`Downloaded to ${outputPath}`);\n  },\n});\n"],"mappings":";;;;;;;AAOA,MAAa,uBAAuB,OAAO;CACzC,MAAM;CACN,aAAa;CACb,MAAM;EACJ,GAAG;EACH,YAAY;GACV,MAAM;GACN,aAAa;GACd;EACD,aAAa;GACX,MAAM;GACN,aAAa;GACd;EACD,QAAQ;GACN,MAAM;GACN,OAAO;GACP,aAAa;GACd;EACD,QAAQ;GACN,MAAM;GACN,aAAa;GACd;EACF;CACD,KAAK,OAAO,QAAQ;EAClB,MAAM,cAAc,oBAAoB;GACtC,SAAS,IAAI,OAAO;GACpB,UAAU,IAAI,OAAO;GACtB,CAAC;EAEF,MAAM,aAAa,IAAI,OAAO;EAC9B,MAAM,WAAW,QAAQ,IAAI,OAAO,UAAU;AAE9C,MAAI,CAAC,cAAc,CAAC,SAClB,OAAM,IAAI,MAAM,gCAAgC;EAGlD,MAAM,SAAS,wBAAwB,IAAI;EAE3C,IAAIA;AACJ,MAAI;GACF,MAAM,WAAY,MAAM,OAAO,eAAe,YAAY,QAAQ;AAIlE,cAAW,MAAM,MAAM,SAAS,KAAK;IACnC,QAAQ;IACR,SAAS,SAAS;IACnB,CAAC;AACF,OAAI,CAAC,SAAS,GACZ,OAAM,IAAI,MAAM,oBAAoB,SAAS,OAAO,GAAG;WAElD,OAAO;AAEd,QADa,iBAAiB,QAAS,MAAoC,OAAO,YACrE,yBACX,OAAM;AAER,cAAW,MAAM,OAAO,gBAAgB,YAAY,QAAQ;;AAG9D,MAAI,CAAC,SAAS,KACZ,OAAM,IAAI,MAAM,uBAAuB;EAGzC,MAAM,aAAa,SAAS,QAAQ,SAAS,KAAsC;AAEnF,MAAI,UAAU;AACZ,SAAM,SAAS,YAAY,QAAQ,OAAO;AAC1C;;AAGF,QAAM,SAAS,YAAY,kBAAkB,WAAqB,CAAC;AACnE,UAAQ,IAAI,iBAAiB,aAAa;;CAE7C,CAAC"}

package/dist/node/cli/commands/files/get.d.ts

@@ -0,0 +1,40 @@
+import * as gunshi9 from "gunshi";
+
+//#region src/cli/commands/files/get.d.ts
+declare const filesGetCommand: gunshi9.Command<{
+  "file-key": {
+    type: "string";
+    description: string;
+  };
+  "key-parts": {
+    type: "string";
+    description: string;
+  };
+  "base-url": {
+    readonly type: "string";
+    readonly short: "b";
+    readonly description: "Upload fragment base URL (env: FRAGNO_UPLOAD_BASE_URL)";
+  };
+  header: {
+    readonly type: "string";
+    readonly short: "H";
+    readonly description: "Extra HTTP header (repeatable), format: 'Name: value' (env: FRAGNO_UPLOAD_HEADERS)";
+    readonly multiple: true;
+  };
+  timeout: {
+    readonly type: "number";
+    readonly description: "Request timeout in ms (env: FRAGNO_UPLOAD_TIMEOUT_MS, default: 15000)";
+  };
+  retries: {
+    readonly type: "number";
+    readonly description: "Retry count for network/5xx/429 (env: FRAGNO_UPLOAD_RETRIES, default: 2)";
+  };
+  "retry-delay": {
+    readonly type: "number";
+    readonly description: "Delay between retries in ms (env: FRAGNO_UPLOAD_RETRY_DELAY_MS, default: 500)";
+  };
+}>;
+//# sourceMappingURL=get.d.ts.map
+//#endregion
+export { filesGetCommand };
+//# sourceMappingURL=get.d.ts.map

package/dist/node/cli/commands/files/get.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get.d.ts","names":[],"sources":["../../../../../src/cli/commands/files/get.ts"],"sourcesContent":[],"mappings":";;;cAGa,iBAwBX,OAAA,CAxB0B;;;IAAf,WAAA,EAAA,MAwBX"}

package/dist/node/cli/commands/files/get.js

@@ -0,0 +1,31 @@
+import { baseArgs, createClientFromContext, resolveFileKeyValue } from "../../utils/options.js";
+import { define } from "gunshi";
+
+//#region src/cli/commands/files/get.ts
+const filesGetCommand = define({
+	name: "get",
+	description: "Get file metadata",
+	args: {
+		...baseArgs,
+		"file-key": {
+			type: "string",
+			description: "File key (encoded)"
+		},
+		"key-parts": {
+			type: "string",
+			description: "File key parts as JSON array"
+		}
+	},
+	run: async (ctx) => {
+		const resolvedKey = resolveFileKeyValue({
+			fileKey: ctx.values["file-key"],
+			keyParts: ctx.values["key-parts"]
+		});
+		const response = await createClientFromContext(ctx).getFile(resolvedKey.fileKey);
+		console.log(JSON.stringify(response, null, 2));
+	}
+});
+
+//#endregion
+export { filesGetCommand };
+//# sourceMappingURL=get.js.map

package/dist/node/cli/commands/files/get.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get.js","names":[],"sources":["../../../../../src/cli/commands/files/get.ts"],"sourcesContent":["import { define } from \"gunshi\";\nimport { baseArgs, createClientFromContext, resolveFileKeyValue } from \"../../utils/options.js\";\n\nexport const filesGetCommand = define({\n  name: \"get\",\n  description: \"Get file metadata\",\n  args: {\n    ...baseArgs,\n    \"file-key\": {\n      type: \"string\",\n      description: \"File key (encoded)\",\n    },\n    \"key-parts\": {\n      type: \"string\",\n      description: \"File key parts as JSON array\",\n    },\n  },\n  run: async (ctx) => {\n    const resolvedKey = resolveFileKeyValue({\n      fileKey: ctx.values[\"file-key\"] as string | undefined,\n      keyParts: ctx.values[\"key-parts\"] as string | undefined,\n    });\n\n    const client = createClientFromContext(ctx);\n    const response = await client.getFile(resolvedKey.fileKey);\n    console.log(JSON.stringify(response, null, 2));\n  },\n});\n"],"mappings":";;;;AAGA,MAAa,kBAAkB,OAAO;CACpC,MAAM;CACN,aAAa;CACb,MAAM;EACJ,GAAG;EACH,YAAY;GACV,MAAM;GACN,aAAa;GACd;EACD,aAAa;GACX,MAAM;GACN,aAAa;GACd;EACF;CACD,KAAK,OAAO,QAAQ;EAClB,MAAM,cAAc,oBAAoB;GACtC,SAAS,IAAI,OAAO;GACpB,UAAU,IAAI,OAAO;GACtB,CAAC;EAGF,MAAM,WAAW,MADF,wBAAwB,IAAI,CACb,QAAQ,YAAY,QAAQ;AAC1D,UAAQ,IAAI,KAAK,UAAU,UAAU,MAAM,EAAE,CAAC;;CAEjD,CAAC"}

package/dist/node/cli/commands/files/list.d.ts

@@ -0,0 +1,56 @@
+import * as gunshi12 from "gunshi";
+
+//#region src/cli/commands/files/list.d.ts
+declare const filesListCommand: gunshi12.Command<{
+  prefix: {
+    type: "string";
+    description: string;
+  };
+  "prefix-parts": {
+    type: "string";
+    description: string;
+  };
+  cursor: {
+    type: "string";
+    description: string;
+  };
+  "page-size": {
+    type: "number";
+    description: string;
+  };
+  status: {
+    type: "string";
+    description: string;
+  };
+  "uploader-id": {
+    type: "string";
+    description: string;
+  };
+  "base-url": {
+    readonly type: "string";
+    readonly short: "b";
+    readonly description: "Upload fragment base URL (env: FRAGNO_UPLOAD_BASE_URL)";
+  };
+  header: {
+    readonly type: "string";
+    readonly short: "H";
+    readonly description: "Extra HTTP header (repeatable), format: 'Name: value' (env: FRAGNO_UPLOAD_HEADERS)";
+    readonly multiple: true;
+  };
+  timeout: {
+    readonly type: "number";
+    readonly description: "Request timeout in ms (env: FRAGNO_UPLOAD_TIMEOUT_MS, default: 15000)";
+  };
+  retries: {
+    readonly type: "number";
+    readonly description: "Retry count for network/5xx/429 (env: FRAGNO_UPLOAD_RETRIES, default: 2)";
+  };
+  "retry-delay": {
+    readonly type: "number";
+    readonly description: "Delay between retries in ms (env: FRAGNO_UPLOAD_RETRY_DELAY_MS, default: 500)";
+  };
+}>;
+//# sourceMappingURL=list.d.ts.map
+//#endregion
+export { filesListCommand };
+//# sourceMappingURL=list.d.ts.map

package/dist/node/cli/commands/files/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","names":[],"sources":["../../../../../src/cli/commands/files/list.ts"],"sourcesContent":[],"mappings":";;;cAGa,kBA+CX,QAAA,CA/C2B;;;IAAhB,WAAA,EAAA,MA+CX"}

package/dist/node/cli/commands/files/list.js

@@ -0,0 +1,53 @@
+import { baseArgs, createClientFromContext, resolvePrefixValue } from "../../utils/options.js";
+import { define } from "gunshi";
+
+//#region src/cli/commands/files/list.ts
+const filesListCommand = define({
+	name: "list",
+	description: "List files",
+	args: {
+		...baseArgs,
+		prefix: {
+			type: "string",
+			description: "File key prefix (must end with '.')"
+		},
+		"prefix-parts": {
+			type: "string",
+			description: "File key prefix parts as JSON array"
+		},
+		cursor: {
+			type: "string",
+			description: "Cursor for pagination"
+		},
+		"page-size": {
+			type: "number",
+			description: "Page size for pagination"
+		},
+		status: {
+			type: "string",
+			description: "Filter by status (ready, deleted)"
+		},
+		"uploader-id": {
+			type: "string",
+			description: "Filter by uploader id"
+		}
+	},
+	run: async (ctx) => {
+		const prefix = resolvePrefixValue({
+			prefix: ctx.values["prefix"],
+			prefixParts: ctx.values["prefix-parts"]
+		});
+		const response = await createClientFromContext(ctx).listFiles({
+			prefix,
+			cursor: ctx.values["cursor"],
+			pageSize: ctx.values["page-size"],
+			status: ctx.values["status"],
+			uploaderId: ctx.values["uploader-id"]
+		});
+		console.log(JSON.stringify(response, null, 2));
+	}
+});
+
+//#endregion
+export { filesListCommand };
+//# sourceMappingURL=list.js.map

package/dist/node/cli/commands/files/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","names":[],"sources":["../../../../../src/cli/commands/files/list.ts"],"sourcesContent":["import { define } from \"gunshi\";\nimport { baseArgs, createClientFromContext, resolvePrefixValue } from \"../../utils/options.js\";\n\nexport const filesListCommand = define({\n  name: \"list\",\n  description: \"List files\",\n  args: {\n    ...baseArgs,\n    prefix: {\n      type: \"string\",\n      description: \"File key prefix (must end with '.')\",\n    },\n    \"prefix-parts\": {\n      type: \"string\",\n      description: \"File key prefix parts as JSON array\",\n    },\n    cursor: {\n      type: \"string\",\n      description: \"Cursor for pagination\",\n    },\n    \"page-size\": {\n      type: \"number\",\n      description: \"Page size for pagination\",\n    },\n    status: {\n      type: \"string\",\n      description: \"Filter by status (ready, deleted)\",\n    },\n    \"uploader-id\": {\n      type: \"string\",\n      description: \"Filter by uploader id\",\n    },\n  },\n  run: async (ctx) => {\n    const prefix = resolvePrefixValue({\n      prefix: ctx.values[\"prefix\"] as string | undefined,\n      prefixParts: ctx.values[\"prefix-parts\"] as string | undefined,\n    });\n\n    const client = createClientFromContext(ctx);\n    const response = await client.listFiles({\n      prefix,\n      cursor: ctx.values[\"cursor\"] as string | undefined,\n      pageSize: ctx.values[\"page-size\"] as number | undefined,\n      status: ctx.values[\"status\"] as string | undefined,\n      uploaderId: ctx.values[\"uploader-id\"] as string | undefined,\n    });\n\n    console.log(JSON.stringify(response, null, 2));\n  },\n});\n"],"mappings":";;;;AAGA,MAAa,mBAAmB,OAAO;CACrC,MAAM;CACN,aAAa;CACb,MAAM;EACJ,GAAG;EACH,QAAQ;GACN,MAAM;GACN,aAAa;GACd;EACD,gBAAgB;GACd,MAAM;GACN,aAAa;GACd;EACD,QAAQ;GACN,MAAM;GACN,aAAa;GACd;EACD,aAAa;GACX,MAAM;GACN,aAAa;GACd;EACD,QAAQ;GACN,MAAM;GACN,aAAa;GACd;EACD,eAAe;GACb,MAAM;GACN,aAAa;GACd;EACF;CACD,KAAK,OAAO,QAAQ;EAClB,MAAM,SAAS,mBAAmB;GAChC,QAAQ,IAAI,OAAO;GACnB,aAAa,IAAI,OAAO;GACzB,CAAC;EAGF,MAAM,WAAW,MADF,wBAAwB,IAAI,CACb,UAAU;GACtC;GACA,QAAQ,IAAI,OAAO;GACnB,UAAU,IAAI,OAAO;GACrB,QAAQ,IAAI,OAAO;GACnB,YAAY,IAAI,OAAO;GACxB,CAAC;AAEF,UAAQ,IAAI,KAAK,UAAU,UAAU,MAAM,EAAE,CAAC;;CAEjD,CAAC"}

package/dist/node/cli/commands/files/update.d.ts

@@ -0,0 +1,56 @@
+import * as gunshi14 from "gunshi";
+
+//#region src/cli/commands/files/update.d.ts
+declare const filesUpdateCommand: gunshi14.Command<{
+  "file-key": {
+    type: "string";
+    description: string;
+  };
+  "key-parts": {
+    type: "string";
+    description: string;
+  };
+  filename: {
+    type: "string";
+    description: string;
+  };
+  visibility: {
+    type: "string";
+    description: string;
+  };
+  tags: {
+    type: "string";
+    description: string;
+  };
+  metadata: {
+    type: "string";
+    description: string;
+  };
+  "base-url": {
+    readonly type: "string";
+    readonly short: "b";
+    readonly description: "Upload fragment base URL (env: FRAGNO_UPLOAD_BASE_URL)";
+  };
+  header: {
+    readonly type: "string";
+    readonly short: "H";
+    readonly description: "Extra HTTP header (repeatable), format: 'Name: value' (env: FRAGNO_UPLOAD_HEADERS)";
+    readonly multiple: true;
+  };
+  timeout: {
+    readonly type: "number";
+    readonly description: "Request timeout in ms (env: FRAGNO_UPLOAD_TIMEOUT_MS, default: 15000)";
+  };
+  retries: {
+    readonly type: "number";
+    readonly description: "Retry count for network/5xx/429 (env: FRAGNO_UPLOAD_RETRIES, default: 2)";
+  };
+  "retry-delay": {
+    readonly type: "number";
+    readonly description: "Delay between retries in ms (env: FRAGNO_UPLOAD_RETRY_DELAY_MS, default: 500)";
+  };
+}>;
+//# sourceMappingURL=update.d.ts.map
+//#endregion
+export { filesUpdateCommand };
+//# sourceMappingURL=update.d.ts.map

package/dist/node/cli/commands/files/update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.d.ts","names":[],"sources":["../../../../../src/cli/commands/files/update.ts"],"sourcesContent":[],"mappings":";;;cAQa,oBA6DX,QAAA,CA7D6B;;;IAAlB,WAAA,EAAA,MA6DX"}

package/dist/node/cli/commands/files/update.js

@@ -0,0 +1,53 @@
+import { baseArgs, createClientFromContext, parseJsonValue, resolveFileKeyValue } from "../../utils/options.js";
+import { define } from "gunshi";
+
+//#region src/cli/commands/files/update.ts
+const filesUpdateCommand = define({
+	name: "update",
+	description: "Update file metadata",
+	args: {
+		...baseArgs,
+		"file-key": {
+			type: "string",
+			description: "File key (encoded)"
+		},
+		"key-parts": {
+			type: "string",
+			description: "File key parts as JSON array"
+		},
+		filename: {
+			type: "string",
+			description: "New filename"
+		},
+		visibility: {
+			type: "string",
+			description: "Visibility (private, public, unlisted)"
+		},
+		tags: {
+			type: "string",
+			description: "Tags JSON array or null"
+		},
+		metadata: {
+			type: "string",
+			description: "Metadata JSON object or null"
+		}
+	},
+	run: async (ctx) => {
+		const resolvedKey = resolveFileKeyValue({
+			fileKey: ctx.values["file-key"],
+			keyParts: ctx.values["key-parts"]
+		});
+		const payload = {};
+		if (ctx.values["filename"]) payload["filename"] = ctx.values["filename"];
+		if (ctx.values["visibility"]) payload["visibility"] = ctx.values["visibility"];
+		if (ctx.values["tags"] !== void 0) payload["tags"] = parseJsonValue("tags", ctx.values["tags"]);
+		if (ctx.values["metadata"] !== void 0) payload["metadata"] = parseJsonValue("metadata", ctx.values["metadata"]);
+		if (Object.keys(payload).length === 0) throw new Error("Provide at least one field to update.");
+		const response = await createClientFromContext(ctx).updateFile(resolvedKey.fileKey, payload);
+		console.log(JSON.stringify(response, null, 2));
+	}
+});
+
+//#endregion
+export { filesUpdateCommand };
+//# sourceMappingURL=update.js.map

package/dist/node/cli/commands/files/update.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.js","names":["payload: Record<string, unknown>"],"sources":["../../../../../src/cli/commands/files/update.ts"],"sourcesContent":["import { define } from \"gunshi\";\nimport {\n  baseArgs,\n  createClientFromContext,\n  parseJsonValue,\n  resolveFileKeyValue,\n} from \"../../utils/options.js\";\n\nexport const filesUpdateCommand = define({\n  name: \"update\",\n  description: \"Update file metadata\",\n  args: {\n    ...baseArgs,\n    \"file-key\": {\n      type: \"string\",\n      description: \"File key (encoded)\",\n    },\n    \"key-parts\": {\n      type: \"string\",\n      description: \"File key parts as JSON array\",\n    },\n    filename: {\n      type: \"string\",\n      description: \"New filename\",\n    },\n    visibility: {\n      type: \"string\",\n      description: \"Visibility (private, public, unlisted)\",\n    },\n    tags: {\n      type: \"string\",\n      description: \"Tags JSON array or null\",\n    },\n    metadata: {\n      type: \"string\",\n      description: \"Metadata JSON object or null\",\n    },\n  },\n  run: async (ctx) => {\n    const resolvedKey = resolveFileKeyValue({\n      fileKey: ctx.values[\"file-key\"] as string | undefined,\n      keyParts: ctx.values[\"key-parts\"] as string | undefined,\n    });\n\n    const payload: Record<string, unknown> = {};\n    if (ctx.values[\"filename\"]) {\n      payload[\"filename\"] = ctx.values[\"filename\"] as string;\n    }\n    if (ctx.values[\"visibility\"]) {\n      payload[\"visibility\"] = ctx.values[\"visibility\"] as string;\n    }\n    if (ctx.values[\"tags\"] !== undefined) {\n      payload[\"tags\"] = parseJsonValue(\"tags\", ctx.values[\"tags\"] as string | undefined);\n    }\n    if (ctx.values[\"metadata\"] !== undefined) {\n      payload[\"metadata\"] = parseJsonValue(\n        \"metadata\",\n        ctx.values[\"metadata\"] as string | undefined,\n      );\n    }\n\n    if (Object.keys(payload).length === 0) {\n      throw new Error(\"Provide at least one field to update.\");\n    }\n\n    const client = createClientFromContext(ctx);\n    const response = await client.updateFile(resolvedKey.fileKey, payload);\n    console.log(JSON.stringify(response, null, 2));\n  },\n});\n"],"mappings":";;;;AAQA,MAAa,qBAAqB,OAAO;CACvC,MAAM;CACN,aAAa;CACb,MAAM;EACJ,GAAG;EACH,YAAY;GACV,MAAM;GACN,aAAa;GACd;EACD,aAAa;GACX,MAAM;GACN,aAAa;GACd;EACD,UAAU;GACR,MAAM;GACN,aAAa;GACd;EACD,YAAY;GACV,MAAM;GACN,aAAa;GACd;EACD,MAAM;GACJ,MAAM;GACN,aAAa;GACd;EACD,UAAU;GACR,MAAM;GACN,aAAa;GACd;EACF;CACD,KAAK,OAAO,QAAQ;EAClB,MAAM,cAAc,oBAAoB;GACtC,SAAS,IAAI,OAAO;GACpB,UAAU,IAAI,OAAO;GACtB,CAAC;EAEF,MAAMA,UAAmC,EAAE;AAC3C,MAAI,IAAI,OAAO,YACb,SAAQ,cAAc,IAAI,OAAO;AAEnC,MAAI,IAAI,OAAO,cACb,SAAQ,gBAAgB,IAAI,OAAO;AAErC,MAAI,IAAI,OAAO,YAAY,OACzB,SAAQ,UAAU,eAAe,QAAQ,IAAI,OAAO,QAA8B;AAEpF,MAAI,IAAI,OAAO,gBAAgB,OAC7B,SAAQ,cAAc,eACpB,YACA,IAAI,OAAO,YACZ;AAGH,MAAI,OAAO,KAAK,QAAQ,CAAC,WAAW,EAClC,OAAM,IAAI,MAAM,wCAAwC;EAI1D,MAAM,WAAW,MADF,wBAAwB,IAAI,CACb,WAAW,YAAY,SAAS,QAAQ;AACtE,UAAQ,IAAI,KAAK,UAAU,UAAU,MAAM,EAAE,CAAC;;CAEjD,CAAC"}

package/dist/node/cli/commands/files/upload.d.ts

@@ -0,0 +1,73 @@
+import * as gunshi11 from "gunshi";
+
+//#region src/cli/commands/files/upload.d.ts
+declare const filesUploadCommand: gunshi11.Command<{
+  file: {
+    type: "string";
+    short: string;
+    description: string;
+  };
+  "file-key": {
+    type: "string";
+    description: string;
+  };
+  "key-parts": {
+    type: "string";
+    description: string;
+  };
+  filename: {
+    type: "string";
+    description: string;
+  };
+  "content-type": {
+    type: "string";
+    description: string;
+  };
+  checksum: {
+    type: "string";
+    description: string;
+  };
+  tags: {
+    type: "string";
+    description: string;
+  };
+  visibility: {
+    type: "string";
+    description: string;
+  };
+  "uploader-id": {
+    type: "string";
+    description: string;
+  };
+  metadata: {
+    type: "string";
+    description: string;
+  };
+  "base-url": {
+    readonly type: "string";
+    readonly short: "b";
+    readonly description: "Upload fragment base URL (env: FRAGNO_UPLOAD_BASE_URL)";
+  };
+  header: {
+    readonly type: "string";
+    readonly short: "H";
+    readonly description: "Extra HTTP header (repeatable), format: 'Name: value' (env: FRAGNO_UPLOAD_HEADERS)";
+    readonly multiple: true;
+  };
+  timeout: {
+    readonly type: "number";
+    readonly description: "Request timeout in ms (env: FRAGNO_UPLOAD_TIMEOUT_MS, default: 15000)";
+  };
+  retries: {
+    readonly type: "number";
+    readonly description: "Retry count for network/5xx/429 (env: FRAGNO_UPLOAD_RETRIES, default: 2)";
+  };
+  "retry-delay": {
+    readonly type: "number";
+    readonly description: "Delay between retries in ms (env: FRAGNO_UPLOAD_RETRY_DELAY_MS, default: 500)";
+  };
+}>;
+//# sourceMappingURL=upload.d.ts.map
+//#endregion
+export { filesUploadCommand };
+//# sourceMappingURL=upload.d.ts.map

package/dist/node/cli/commands/files/upload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload.d.ts","names":[],"sources":["../../../../../src/cli/commands/files/upload.ts"],"sourcesContent":[],"mappings":";;;cAYa,oBAuGX,QAAA,CAvG6B;;;IAAlB,KAAA,EAAA,MAAA"}

package/dist/node/cli/commands/files/upload.js

@@ -0,0 +1,87 @@
+import { baseArgs, createClientFromContext, parseJsonValue, resolveFileKeyValue } from "../../utils/options.js";
+import { promises } from "node:fs";
+import path from "node:path";
+import { define } from "gunshi";
+
+//#region src/cli/commands/files/upload.ts
+const DEFAULT_CONTENT_TYPE = "application/octet-stream";
+const filesUploadCommand = define({
+	name: "upload",
+	description: "Upload a file via the /files endpoint",
+	args: {
+		...baseArgs,
+		file: {
+			type: "string",
+			short: "f",
+			description: "Path to file"
+		},
+		"file-key": {
+			type: "string",
+			description: "File key (encoded)"
+		},
+		"key-parts": {
+			type: "string",
+			description: "File key parts as JSON array"
+		},
+		filename: {
+			type: "string",
+			description: "Override filename"
+		},
+		"content-type": {
+			type: "string",
+			description: "Content type (default: application/octet-stream)"
+		},
+		checksum: {
+			type: "string",
+			description: "Checksum JSON"
+		},
+		tags: {
+			type: "string",
+			description: "Tags as JSON array"
+		},
+		visibility: {
+			type: "string",
+			description: "Visibility (private, public, unlisted)"
+		},
+		"uploader-id": {
+			type: "string",
+			description: "Uploader id"
+		},
+		metadata: {
+			type: "string",
+			description: "Metadata JSON object"
+		}
+	},
+	run: async (ctx) => {
+		const filePath = ctx.values["file"];
+		if (!filePath) throw new Error("Missing --file");
+		const fileBuffer = await promises.readFile(filePath);
+		const filename = ctx.values["filename"] ?? path.basename(filePath);
+		const contentType = ctx.values["content-type"] ?? DEFAULT_CONTENT_TYPE;
+		const resolvedKey = resolveFileKeyValue({
+			fileKey: ctx.values["file-key"],
+			keyParts: ctx.values["key-parts"]
+		});
+		const checksum = parseJsonValue("checksum", ctx.values["checksum"]);
+		const tags = parseJsonValue("tags", ctx.values["tags"]);
+		const metadata = parseJsonValue("metadata", ctx.values["metadata"]);
+		const form = new FormData();
+		form.append("file", new File([fileBuffer], filename, { type: contentType }));
+		if (resolvedKey.fileKey) form.append("fileKey", resolvedKey.fileKey);
+		if (resolvedKey.keyParts) form.append("keyParts", JSON.stringify(resolvedKey.keyParts));
+		if (checksum !== void 0) form.append("checksum", JSON.stringify(checksum));
+		if (tags !== void 0) form.append("tags", JSON.stringify(tags));
+		if (metadata !== void 0) form.append("metadata", JSON.stringify(metadata));
+		const uploaderId = ctx.values["uploader-id"];
+		if (uploaderId) form.append("uploaderId", uploaderId);
+		const visibility = ctx.values["visibility"];
+		if (visibility) form.append("visibility", visibility);
+		if (ctx.values["filename"]) form.append("filename", filename);
+		const response = await createClientFromContext(ctx).createFile(form);
+		console.log(JSON.stringify(response, null, 2));
+	}
+});
+
+//#endregion
+export { filesUploadCommand };
+//# sourceMappingURL=upload.js.map

package/dist/node/cli/commands/files/upload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload.js","names":["fs"],"sources":["../../../../../src/cli/commands/files/upload.ts"],"sourcesContent":["import { define } from \"gunshi\";\nimport { promises as fs } from \"node:fs\";\nimport path from \"node:path\";\nimport {\n  baseArgs,\n  createClientFromContext,\n  parseJsonValue,\n  resolveFileKeyValue,\n} from \"../../utils/options.js\";\n\nconst DEFAULT_CONTENT_TYPE = \"application/octet-stream\";\n\nexport const filesUploadCommand = define({\n  name: \"upload\",\n  description: \"Upload a file via the /files endpoint\",\n  args: {\n    ...baseArgs,\n    file: {\n      type: \"string\",\n      short: \"f\",\n      description: \"Path to file\",\n    },\n    \"file-key\": {\n      type: \"string\",\n      description: \"File key (encoded)\",\n    },\n    \"key-parts\": {\n      type: \"string\",\n      description: \"File key parts as JSON array\",\n    },\n    filename: {\n      type: \"string\",\n      description: \"Override filename\",\n    },\n    \"content-type\": {\n      type: \"string\",\n      description: \"Content type (default: application/octet-stream)\",\n    },\n    checksum: {\n      type: \"string\",\n      description: \"Checksum JSON\",\n    },\n    tags: {\n      type: \"string\",\n      description: \"Tags as JSON array\",\n    },\n    visibility: {\n      type: \"string\",\n      description: \"Visibility (private, public, unlisted)\",\n    },\n    \"uploader-id\": {\n      type: \"string\",\n      description: \"Uploader id\",\n    },\n    metadata: {\n      type: \"string\",\n      description: \"Metadata JSON object\",\n    },\n  },\n  run: async (ctx) => {\n    const filePath = ctx.values[\"file\"] as string | undefined;\n    if (!filePath) {\n      throw new Error(\"Missing --file\");\n    }\n\n    const fileBuffer = await fs.readFile(filePath);\n    const filename = (ctx.values[\"filename\"] as string | undefined) ?? path.basename(filePath);\n    const contentType = (ctx.values[\"content-type\"] as string | undefined) ?? DEFAULT_CONTENT_TYPE;\n\n    const resolvedKey = resolveFileKeyValue({\n      fileKey: ctx.values[\"file-key\"] as string | undefined,\n      keyParts: ctx.values[\"key-parts\"] as string | undefined,\n    });\n\n    const checksum = parseJsonValue(\"checksum\", ctx.values[\"checksum\"] as string | undefined);\n    const tags = parseJsonValue(\"tags\", ctx.values[\"tags\"] as string | undefined);\n    const metadata = parseJsonValue(\"metadata\", ctx.values[\"metadata\"] as string | undefined);\n\n    const form = new FormData();\n    form.append(\"file\", new File([fileBuffer], filename, { type: contentType }));\n\n    if (resolvedKey.fileKey) {\n      form.append(\"fileKey\", resolvedKey.fileKey);\n    }\n    if (resolvedKey.keyParts) {\n      form.append(\"keyParts\", JSON.stringify(resolvedKey.keyParts));\n    }\n    if (checksum !== undefined) {\n      form.append(\"checksum\", JSON.stringify(checksum));\n    }\n    if (tags !== undefined) {\n      form.append(\"tags\", JSON.stringify(tags));\n    }\n    if (metadata !== undefined) {\n      form.append(\"metadata\", JSON.stringify(metadata));\n    }\n\n    const uploaderId = ctx.values[\"uploader-id\"] as string | undefined;\n    if (uploaderId) {\n      form.append(\"uploaderId\", uploaderId);\n    }\n\n    const visibility = ctx.values[\"visibility\"] as string | undefined;\n    if (visibility) {\n      form.append(\"visibility\", visibility);\n    }\n\n    if (ctx.values[\"filename\"]) {\n      form.append(\"filename\", filename);\n    }\n\n    const client = createClientFromContext(ctx);\n    const response = await client.createFile(form);\n    console.log(JSON.stringify(response, null, 2));\n  },\n});\n"],"mappings":";;;;;;AAUA,MAAM,uBAAuB;AAE7B,MAAa,qBAAqB,OAAO;CACvC,MAAM;CACN,aAAa;CACb,MAAM;EACJ,GAAG;EACH,MAAM;GACJ,MAAM;GACN,OAAO;GACP,aAAa;GACd;EACD,YAAY;GACV,MAAM;GACN,aAAa;GACd;EACD,aAAa;GACX,MAAM;GACN,aAAa;GACd;EACD,UAAU;GACR,MAAM;GACN,aAAa;GACd;EACD,gBAAgB;GACd,MAAM;GACN,aAAa;GACd;EACD,UAAU;GACR,MAAM;GACN,aAAa;GACd;EACD,MAAM;GACJ,MAAM;GACN,aAAa;GACd;EACD,YAAY;GACV,MAAM;GACN,aAAa;GACd;EACD,eAAe;GACb,MAAM;GACN,aAAa;GACd;EACD,UAAU;GACR,MAAM;GACN,aAAa;GACd;EACF;CACD,KAAK,OAAO,QAAQ;EAClB,MAAM,WAAW,IAAI,OAAO;AAC5B,MAAI,CAAC,SACH,OAAM,IAAI,MAAM,iBAAiB;EAGnC,MAAM,aAAa,MAAMA,SAAG,SAAS,SAAS;EAC9C,MAAM,WAAY,IAAI,OAAO,eAAsC,KAAK,SAAS,SAAS;EAC1F,MAAM,cAAe,IAAI,OAAO,mBAA0C;EAE1E,MAAM,cAAc,oBAAoB;GACtC,SAAS,IAAI,OAAO;GACpB,UAAU,IAAI,OAAO;GACtB,CAAC;EAEF,MAAM,WAAW,eAAe,YAAY,IAAI,OAAO,YAAkC;EACzF,MAAM,OAAO,eAAe,QAAQ,IAAI,OAAO,QAA8B;EAC7E,MAAM,WAAW,eAAe,YAAY,IAAI,OAAO,YAAkC;EAEzF,MAAM,OAAO,IAAI,UAAU;AAC3B,OAAK,OAAO,QAAQ,IAAI,KAAK,CAAC,WAAW,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC,CAAC;AAE5E,MAAI,YAAY,QACd,MAAK,OAAO,WAAW,YAAY,QAAQ;AAE7C,MAAI,YAAY,SACd,MAAK,OAAO,YAAY,KAAK,UAAU,YAAY,SAAS,CAAC;AAE/D,MAAI,aAAa,OACf,MAAK,OAAO,YAAY,KAAK,UAAU,SAAS,CAAC;AAEnD,MAAI,SAAS,OACX,MAAK,OAAO,QAAQ,KAAK,UAAU,KAAK,CAAC;AAE3C,MAAI,aAAa,OACf,MAAK,OAAO,YAAY,KAAK,UAAU,SAAS,CAAC;EAGnD,MAAM,aAAa,IAAI,OAAO;AAC9B,MAAI,WACF,MAAK,OAAO,cAAc,WAAW;EAGvC,MAAM,aAAa,IAAI,OAAO;AAC9B,MAAI,WACF,MAAK,OAAO,cAAc,WAAW;AAGvC,MAAI,IAAI,OAAO,YACb,MAAK,OAAO,YAAY,SAAS;EAInC,MAAM,WAAW,MADF,wBAAwB,IAAI,CACb,WAAW,KAAK;AAC9C,UAAQ,IAAI,KAAK,UAAU,UAAU,MAAM,EAAE,CAAC;;CAEjD,CAAC"}