@fragno-dev/upload 0.1.1

package/dist/node/cli/commands/uploads/parts-list.d.ts

@@ -0,0 +1,37 @@
+import * as gunshi5 from "gunshi";
+
+//#region src/cli/commands/uploads/parts-list.d.ts
+declare const uploadsPartsListCommand: gunshi5.Command<{
+  "upload-id": {
+    type: "string";
+    short: 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=parts-list.d.ts.map
+//#endregion
+export { uploadsPartsListCommand };
+//# sourceMappingURL=parts-list.d.ts.map

package/dist/node/cli/commands/uploads/parts-list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parts-list.d.ts","names":[],"sources":["../../../../../src/cli/commands/uploads/parts-list.ts"],"sourcesContent":[],"mappings":";;;cAGa,yBAqBX,OAAA,CArBkC;;;IAAvB,KAAA,EAAA,MAAA"}

package/dist/node/cli/commands/uploads/parts-list.js

@@ -0,0 +1,26 @@
+import { baseArgs, createClientFromContext } from "../../utils/options.js";
+import { define } from "gunshi";
+
+//#region src/cli/commands/uploads/parts-list.ts
+const uploadsPartsListCommand = define({
+	name: "parts-list",
+	description: "List uploaded parts",
+	args: {
+		...baseArgs,
+		"upload-id": {
+			type: "string",
+			short: "i",
+			description: "Upload id"
+		}
+	},
+	run: async (ctx) => {
+		const uploadId = ctx.values["upload-id"];
+		if (!uploadId) throw new Error("Missing --upload-id");
+		const response = await createClientFromContext(ctx).listParts(uploadId);
+		console.log(JSON.stringify(response, null, 2));
+	}
+});
+
+//#endregion
+export { uploadsPartsListCommand };
+//# sourceMappingURL=parts-list.js.map

package/dist/node/cli/commands/uploads/parts-list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parts-list.js","names":[],"sources":["../../../../../src/cli/commands/uploads/parts-list.ts"],"sourcesContent":["import { define } from \"gunshi\";\nimport { baseArgs, createClientFromContext } from \"../../utils/options.js\";\n\nexport const uploadsPartsListCommand = define({\n  name: \"parts-list\",\n  description: \"List uploaded parts\",\n  args: {\n    ...baseArgs,\n    \"upload-id\": {\n      type: \"string\",\n      short: \"i\",\n      description: \"Upload id\",\n    },\n  },\n  run: async (ctx) => {\n    const uploadId = ctx.values[\"upload-id\"] as string | undefined;\n    if (!uploadId) {\n      throw new Error(\"Missing --upload-id\");\n    }\n\n    const client = createClientFromContext(ctx);\n    const response = await client.listParts(uploadId);\n    console.log(JSON.stringify(response, null, 2));\n  },\n});\n"],"mappings":";;;;AAGA,MAAa,0BAA0B,OAAO;CAC5C,MAAM;CACN,aAAa;CACb,MAAM;EACJ,GAAG;EACH,aAAa;GACX,MAAM;GACN,OAAO;GACP,aAAa;GACd;EACF;CACD,KAAK,OAAO,QAAQ;EAClB,MAAM,WAAW,IAAI,OAAO;AAC5B,MAAI,CAAC,SACH,OAAM,IAAI,MAAM,sBAAsB;EAIxC,MAAM,WAAW,MADF,wBAAwB,IAAI,CACb,UAAU,SAAS;AACjD,UAAQ,IAAI,KAAK,UAAU,UAAU,MAAM,EAAE,CAAC;;CAEjD,CAAC"}

package/dist/node/cli/commands/uploads/parts-urls.d.ts

@@ -0,0 +1,46 @@
+import * as gunshi4 from "gunshi";
+
+//#region src/cli/commands/uploads/parts-urls.d.ts
+declare const uploadsPartsUrlsCommand: gunshi4.Command<{
+  "upload-id": {
+    type: "string";
+    short: string;
+    description: string;
+  };
+  parts: {
+    type: "string";
+    description: string;
+  };
+  part: {
+    type: "number";
+    multiple: true;
+    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=parts-urls.d.ts.map
+//#endregion
+export { uploadsPartsUrlsCommand };
+//# sourceMappingURL=parts-urls.d.ts.map

package/dist/node/cli/commands/uploads/parts-urls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parts-urls.d.ts","names":[],"sources":["../../../../../src/cli/commands/uploads/parts-urls.ts"],"sourcesContent":[],"mappings":";;;cAiCa,yBAmCX,OAAA,CAnCkC;;;IAAvB,KAAA,EAAA,MAAA"}

package/dist/node/cli/commands/uploads/parts-urls.js

@@ -0,0 +1,57 @@
+import { baseArgs, createClientFromContext, parseJsonValue } from "../../utils/options.js";
+import { define } from "gunshi";
+
+//#region src/cli/commands/uploads/parts-urls.ts
+const parsePartNumbers = (rawParts, rawPart) => {
+	const parts = [];
+	if (rawParts) {
+		const parsed = parseJsonValue("parts", String(rawParts));
+		if (!Array.isArray(parsed)) throw new Error("--parts must be a JSON array of numbers");
+		for (const value of parsed) {
+			if (typeof value !== "number" || !Number.isInteger(value) || value < 1) throw new Error("--parts must be a JSON array of positive integers");
+			parts.push(value);
+		}
+	}
+	if (rawPart) {
+		const items = Array.isArray(rawPart) ? rawPart : [rawPart];
+		for (const value of items) {
+			const parsed = Number(value);
+			if (!Number.isInteger(parsed) || parsed < 1) throw new Error("--part must be a positive integer");
+			parts.push(parsed);
+		}
+	}
+	return Array.from(new Set(parts));
+};
+const uploadsPartsUrlsCommand = define({
+	name: "parts-urls",
+	description: "Get signed URLs for multipart upload",
+	args: {
+		...baseArgs,
+		"upload-id": {
+			type: "string",
+			short: "i",
+			description: "Upload id"
+		},
+		parts: {
+			type: "string",
+			description: "JSON array of part numbers"
+		},
+		part: {
+			type: "number",
+			multiple: true,
+			description: "Part number (repeatable)"
+		}
+	},
+	run: async (ctx) => {
+		const uploadId = ctx.values["upload-id"];
+		if (!uploadId) throw new Error("Missing --upload-id");
+		const partNumbers = parsePartNumbers(ctx.values["parts"], ctx.values["part"]);
+		if (!partNumbers.length) throw new Error("Provide --parts or at least one --part");
+		const response = await createClientFromContext(ctx).getPartUrls(uploadId, partNumbers);
+		console.log(JSON.stringify(response, null, 2));
+	}
+});
+
+//#endregion
+export { uploadsPartsUrlsCommand };
+//# sourceMappingURL=parts-urls.js.map

package/dist/node/cli/commands/uploads/parts-urls.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parts-urls.js","names":["parts: number[]"],"sources":["../../../../../src/cli/commands/uploads/parts-urls.ts"],"sourcesContent":["import { define } from \"gunshi\";\nimport { baseArgs, createClientFromContext, parseJsonValue } from \"../../utils/options.js\";\n\nconst parsePartNumbers = (rawParts: unknown, rawPart: unknown): number[] => {\n  const parts: number[] = [];\n\n  if (rawParts) {\n    const parsed = parseJsonValue(\"parts\", String(rawParts));\n    if (!Array.isArray(parsed)) {\n      throw new Error(\"--parts must be a JSON array of numbers\");\n    }\n    for (const value of parsed) {\n      if (typeof value !== \"number\" || !Number.isInteger(value) || value < 1) {\n        throw new Error(\"--parts must be a JSON array of positive integers\");\n      }\n      parts.push(value);\n    }\n  }\n\n  if (rawPart) {\n    const items = Array.isArray(rawPart) ? rawPart : [rawPart];\n    for (const value of items) {\n      const parsed = Number(value);\n      if (!Number.isInteger(parsed) || parsed < 1) {\n        throw new Error(\"--part must be a positive integer\");\n      }\n      parts.push(parsed);\n    }\n  }\n\n  return Array.from(new Set(parts));\n};\n\nexport const uploadsPartsUrlsCommand = define({\n  name: \"parts-urls\",\n  description: \"Get signed URLs for multipart upload\",\n  args: {\n    ...baseArgs,\n    \"upload-id\": {\n      type: \"string\",\n      short: \"i\",\n      description: \"Upload id\",\n    },\n    parts: {\n      type: \"string\",\n      description: \"JSON array of part numbers\",\n    },\n    part: {\n      type: \"number\",\n      multiple: true,\n      description: \"Part number (repeatable)\",\n    },\n  },\n  run: async (ctx) => {\n    const uploadId = ctx.values[\"upload-id\"] as string | undefined;\n    if (!uploadId) {\n      throw new Error(\"Missing --upload-id\");\n    }\n\n    const partNumbers = parsePartNumbers(ctx.values[\"parts\"], ctx.values[\"part\"]);\n    if (!partNumbers.length) {\n      throw new Error(\"Provide --parts or at least one --part\");\n    }\n\n    const client = createClientFromContext(ctx);\n    const response = await client.getPartUrls(uploadId, partNumbers);\n    console.log(JSON.stringify(response, null, 2));\n  },\n});\n"],"mappings":";;;;AAGA,MAAM,oBAAoB,UAAmB,YAA+B;CAC1E,MAAMA,QAAkB,EAAE;AAE1B,KAAI,UAAU;EACZ,MAAM,SAAS,eAAe,SAAS,OAAO,SAAS,CAAC;AACxD,MAAI,CAAC,MAAM,QAAQ,OAAO,CACxB,OAAM,IAAI,MAAM,0CAA0C;AAE5D,OAAK,MAAM,SAAS,QAAQ;AAC1B,OAAI,OAAO,UAAU,YAAY,CAAC,OAAO,UAAU,MAAM,IAAI,QAAQ,EACnE,OAAM,IAAI,MAAM,oDAAoD;AAEtE,SAAM,KAAK,MAAM;;;AAIrB,KAAI,SAAS;EACX,MAAM,QAAQ,MAAM,QAAQ,QAAQ,GAAG,UAAU,CAAC,QAAQ;AAC1D,OAAK,MAAM,SAAS,OAAO;GACzB,MAAM,SAAS,OAAO,MAAM;AAC5B,OAAI,CAAC,OAAO,UAAU,OAAO,IAAI,SAAS,EACxC,OAAM,IAAI,MAAM,oCAAoC;AAEtD,SAAM,KAAK,OAAO;;;AAItB,QAAO,MAAM,KAAK,IAAI,IAAI,MAAM,CAAC;;AAGnC,MAAa,0BAA0B,OAAO;CAC5C,MAAM;CACN,aAAa;CACb,MAAM;EACJ,GAAG;EACH,aAAa;GACX,MAAM;GACN,OAAO;GACP,aAAa;GACd;EACD,OAAO;GACL,MAAM;GACN,aAAa;GACd;EACD,MAAM;GACJ,MAAM;GACN,UAAU;GACV,aAAa;GACd;EACF;CACD,KAAK,OAAO,QAAQ;EAClB,MAAM,WAAW,IAAI,OAAO;AAC5B,MAAI,CAAC,SACH,OAAM,IAAI,MAAM,sBAAsB;EAGxC,MAAM,cAAc,iBAAiB,IAAI,OAAO,UAAU,IAAI,OAAO,QAAQ;AAC7E,MAAI,CAAC,YAAY,OACf,OAAM,IAAI,MAAM,yCAAyC;EAI3D,MAAM,WAAW,MADF,wBAAwB,IAAI,CACb,YAAY,UAAU,YAAY;AAChE,UAAQ,IAAI,KAAK,UAAU,UAAU,MAAM,EAAE,CAAC;;CAEjD,CAAC"}

package/dist/node/cli/commands/uploads/progress.d.ts

@@ -0,0 +1,45 @@
+import * as gunshi3 from "gunshi";
+
+//#region src/cli/commands/uploads/progress.d.ts
+declare const uploadsProgressCommand: gunshi3.Command<{
+  "upload-id": {
+    type: "string";
+    short: string;
+    description: string;
+  };
+  "bytes-uploaded": {
+    type: "number";
+    description: string;
+  };
+  "parts-uploaded": {
+    type: "number";
+    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=progress.d.ts.map
+//#endregion
+export { uploadsProgressCommand };
+//# sourceMappingURL=progress.d.ts.map

package/dist/node/cli/commands/uploads/progress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress.d.ts","names":[],"sources":["../../../../../src/cli/commands/uploads/progress.ts"],"sourcesContent":[],"mappings":";;;cAGa,wBAoCX,OAAA,CApCiC;;;IAAtB,KAAA,EAAA,MAAA"}

package/dist/node/cli/commands/uploads/progress.js

@@ -0,0 +1,40 @@
+import { baseArgs, createClientFromContext } from "../../utils/options.js";
+import { define } from "gunshi";
+
+//#region src/cli/commands/uploads/progress.ts
+const uploadsProgressCommand = define({
+	name: "progress",
+	description: "Record upload progress",
+	args: {
+		...baseArgs,
+		"upload-id": {
+			type: "string",
+			short: "i",
+			description: "Upload id"
+		},
+		"bytes-uploaded": {
+			type: "number",
+			description: "Total bytes uploaded"
+		},
+		"parts-uploaded": {
+			type: "number",
+			description: "Total parts uploaded"
+		}
+	},
+	run: async (ctx) => {
+		const uploadId = ctx.values["upload-id"];
+		if (!uploadId) throw new Error("Missing --upload-id");
+		const bytesUploaded = ctx.values["bytes-uploaded"];
+		const partsUploaded = ctx.values["parts-uploaded"];
+		if (bytesUploaded === void 0 && partsUploaded === void 0) throw new Error("Provide --bytes-uploaded, --parts-uploaded, or both.");
+		const response = await createClientFromContext(ctx).reportProgress(uploadId, {
+			bytesUploaded,
+			partsUploaded
+		});
+		console.log(JSON.stringify(response, null, 2));
+	}
+});
+
+//#endregion
+export { uploadsProgressCommand };
+//# sourceMappingURL=progress.js.map

package/dist/node/cli/commands/uploads/progress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress.js","names":[],"sources":["../../../../../src/cli/commands/uploads/progress.ts"],"sourcesContent":["import { define } from \"gunshi\";\nimport { baseArgs, createClientFromContext } from \"../../utils/options.js\";\n\nexport const uploadsProgressCommand = define({\n  name: \"progress\",\n  description: \"Record upload progress\",\n  args: {\n    ...baseArgs,\n    \"upload-id\": {\n      type: \"string\",\n      short: \"i\",\n      description: \"Upload id\",\n    },\n    \"bytes-uploaded\": {\n      type: \"number\",\n      description: \"Total bytes uploaded\",\n    },\n    \"parts-uploaded\": {\n      type: \"number\",\n      description: \"Total parts uploaded\",\n    },\n  },\n  run: async (ctx) => {\n    const uploadId = ctx.values[\"upload-id\"] as string | undefined;\n    if (!uploadId) {\n      throw new Error(\"Missing --upload-id\");\n    }\n\n    const bytesUploaded = ctx.values[\"bytes-uploaded\"] as number | undefined;\n    const partsUploaded = ctx.values[\"parts-uploaded\"] as number | undefined;\n\n    if (bytesUploaded === undefined && partsUploaded === undefined) {\n      throw new Error(\"Provide --bytes-uploaded, --parts-uploaded, or both.\");\n    }\n\n    const client = createClientFromContext(ctx);\n    const response = await client.reportProgress(uploadId, { bytesUploaded, partsUploaded });\n    console.log(JSON.stringify(response, null, 2));\n  },\n});\n"],"mappings":";;;;AAGA,MAAa,yBAAyB,OAAO;CAC3C,MAAM;CACN,aAAa;CACb,MAAM;EACJ,GAAG;EACH,aAAa;GACX,MAAM;GACN,OAAO;GACP,aAAa;GACd;EACD,kBAAkB;GAChB,MAAM;GACN,aAAa;GACd;EACD,kBAAkB;GAChB,MAAM;GACN,aAAa;GACd;EACF;CACD,KAAK,OAAO,QAAQ;EAClB,MAAM,WAAW,IAAI,OAAO;AAC5B,MAAI,CAAC,SACH,OAAM,IAAI,MAAM,sBAAsB;EAGxC,MAAM,gBAAgB,IAAI,OAAO;EACjC,MAAM,gBAAgB,IAAI,OAAO;AAEjC,MAAI,kBAAkB,UAAa,kBAAkB,OACnD,OAAM,IAAI,MAAM,uDAAuD;EAIzE,MAAM,WAAW,MADF,wBAAwB,IAAI,CACb,eAAe,UAAU;GAAE;GAAe;GAAe,CAAC;AACxF,UAAQ,IAAI,KAAK,UAAU,UAAU,MAAM,EAAE,CAAC;;CAEjD,CAAC"}

package/dist/node/cli/commands/uploads/transfer.d.ts

@@ -0,0 +1,73 @@
+import * as gunshi10 from "gunshi";
+
+//#region src/cli/commands/uploads/transfer.d.ts
+declare const uploadsTransferCommand: gunshi10.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=transfer.d.ts.map
+//#endregion
+export { uploadsTransferCommand };
+//# sourceMappingURL=transfer.d.ts.map

package/dist/node/cli/commands/uploads/transfer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transfer.d.ts","names":[],"sources":["../../../../../src/cli/commands/uploads/transfer.ts"],"sourcesContent":[],"mappings":";;;cAaa,wBAmMX,QAAA,CAnMiC;;;IAAtB,KAAA,EAAA,MAAA"}

package/dist/node/cli/commands/uploads/transfer.js

@@ -0,0 +1,170 @@
+import { baseArgs, createClientFromContext, parseJsonValue, resolveOptionalFileKeyValue } from "../../utils/options.js";
+import { createReadStream, promises } from "node:fs";
+import path from "node:path";
+import { Readable } from "node:stream";
+import { define } from "gunshi";
+
+//#region src/cli/commands/uploads/transfer.ts
+const DEFAULT_CONTENT_TYPE = "application/octet-stream";
+const uploadsTransferCommand = define({
+	name: "transfer",
+	description: "Create an upload and transfer a file",
+	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, e.g. '{\"algo\":\"sha256\",\"value\":\"...\"}'"
+		},
+		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 resolvedKey = resolveOptionalFileKeyValue({
+			fileKey: ctx.values["file-key"],
+			keyParts: ctx.values["key-parts"]
+		});
+		if (!resolvedKey.fileKey && !resolvedKey.keyParts) throw new Error("Missing file key. Provide --file-key or --key-parts.");
+		const sizeBytes = (await promises.stat(filePath)).size;
+		const filename = ctx.values["filename"] ?? path.basename(filePath);
+		const contentType = ctx.values["content-type"] ?? DEFAULT_CONTENT_TYPE;
+		const checksum = parseJsonValue("checksum", ctx.values["checksum"]);
+		const tags = parseJsonValue("tags", ctx.values["tags"]);
+		const metadata = parseJsonValue("metadata", ctx.values["metadata"]);
+		const client = createClientFromContext(ctx);
+		const upload = await client.createUpload({
+			fileKey: resolvedKey.fileKey,
+			keyParts: resolvedKey.keyParts,
+			filename,
+			sizeBytes,
+			contentType,
+			checksum,
+			tags,
+			visibility: ctx.values["visibility"],
+			uploaderId: ctx.values["uploader-id"],
+			metadata
+		});
+		if (upload.strategy === "direct-single") {
+			if (!upload.upload.uploadUrl) throw new Error("Missing upload URL for direct upload");
+			const headers = new Headers(upload.upload.uploadHeaders ?? {});
+			headers.set("Content-Length", String(sizeBytes));
+			const init = {
+				method: "PUT",
+				headers,
+				body: Readable.toWeb(createReadStream(filePath)),
+				duplex: "half"
+			};
+			const response$1 = await fetch(upload.upload.uploadUrl, init);
+			if (!response$1.ok) throw new Error(`Direct upload failed (${response$1.status})`);
+			await client.reportProgress(upload.uploadId, {
+				bytesUploaded: sizeBytes,
+				partsUploaded: 1
+			});
+			const file = await client.completeUpload(upload.uploadId, []);
+			console.log(JSON.stringify({
+				upload,
+				file
+			}, null, 2));
+			return;
+		}
+		if (upload.strategy === "direct-multipart") {
+			const partSizeBytes = upload.upload.partSizeBytes;
+			if (!partSizeBytes) throw new Error("Missing multipart part size from server");
+			const totalParts = Math.ceil(sizeBytes / partSizeBytes);
+			if (upload.upload.maxParts && totalParts > upload.upload.maxParts) throw new Error("Multipart upload exceeds maximum parts");
+			const partNumbers = Array.from({ length: totalParts }, (_, index) => index + 1);
+			const orderedParts = (await client.getPartUrls(upload.uploadId, partNumbers)).parts.sort((a, b) => a.partNumber - b.partNumber);
+			const completedParts = [];
+			const completionParts = [];
+			let bytesUploaded = 0;
+			let partsUploaded = 0;
+			for (const part of orderedParts) {
+				const start = (part.partNumber - 1) * partSizeBytes;
+				const length = Math.min(partSizeBytes, sizeBytes - start);
+				const end = start + length - 1;
+				const headers = new Headers(part.headers ?? {});
+				headers.set("Content-Length", String(length));
+				const init = {
+					method: "PUT",
+					headers,
+					body: Readable.toWeb(createReadStream(filePath, {
+						start,
+						end
+					})),
+					duplex: "half"
+				};
+				const response$1 = await fetch(part.url, init);
+				if (!response$1.ok) throw new Error(`Multipart upload failed (${response$1.status})`);
+				const etag = response$1.headers.get("etag") ?? response$1.headers.get("ETag");
+				if (!etag) throw new Error("Missing ETag for uploaded part");
+				completedParts.push({
+					partNumber: part.partNumber,
+					etag,
+					sizeBytes: length
+				});
+				completionParts.push({
+					partNumber: part.partNumber,
+					etag
+				});
+				bytesUploaded += length;
+				partsUploaded += 1;
+				await client.reportProgress(upload.uploadId, {
+					bytesUploaded,
+					partsUploaded
+				});
+			}
+			await client.completeParts(upload.uploadId, completedParts);
+			const file = await client.completeUpload(upload.uploadId, completionParts);
+			console.log(JSON.stringify({
+				upload,
+				file
+			}, null, 2));
+			return;
+		}
+		const response = await client.uploadContent(upload.uploadId, Readable.toWeb(createReadStream(filePath)), contentType);
+		console.log(JSON.stringify({
+			upload,
+			file: response
+		}, null, 2));
+	}
+});
+
+//#endregion
+export { uploadsTransferCommand };
+//# sourceMappingURL=transfer.js.map

package/dist/node/cli/commands/uploads/transfer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transfer.js","names":["fs","init: RequestInit & { duplex?: \"half\" }","response","completedParts: { partNumber: number; etag: string; sizeBytes: number }[]","completionParts: { partNumber: number; etag: string }[]"],"sources":["../../../../../src/cli/commands/uploads/transfer.ts"],"sourcesContent":["import { define } from \"gunshi\";\nimport { createReadStream, promises as fs } from \"node:fs\";\nimport path from \"node:path\";\nimport { Readable } from \"node:stream\";\nimport {\n  baseArgs,\n  createClientFromContext,\n  parseJsonValue,\n  resolveOptionalFileKeyValue,\n} from \"../../utils/options.js\";\n\nconst DEFAULT_CONTENT_TYPE = \"application/octet-stream\";\n\nexport const uploadsTransferCommand = define({\n  name: \"transfer\",\n  description: \"Create an upload and transfer a file\",\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, e.g. \\'{\"algo\":\"sha256\",\"value\":\"...\"}\\'',\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 resolvedKey = resolveOptionalFileKeyValue({\n      fileKey: ctx.values[\"file-key\"] as string | undefined,\n      keyParts: ctx.values[\"key-parts\"] as string | undefined,\n    });\n\n    if (!resolvedKey.fileKey && !resolvedKey.keyParts) {\n      throw new Error(\"Missing file key. Provide --file-key or --key-parts.\");\n    }\n\n    const stats = await fs.stat(filePath);\n    const sizeBytes = stats.size;\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 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 client = createClientFromContext(ctx);\n    const upload = (await client.createUpload({\n      fileKey: resolvedKey.fileKey,\n      keyParts: resolvedKey.keyParts,\n      filename,\n      sizeBytes,\n      contentType,\n      checksum,\n      tags,\n      visibility: ctx.values[\"visibility\"] as string | undefined,\n      uploaderId: ctx.values[\"uploader-id\"] as string | undefined,\n      metadata,\n    })) as {\n      uploadId: string;\n      strategy: \"direct-single\" | \"direct-multipart\" | \"proxy\";\n      upload: {\n        partSizeBytes?: number;\n        maxParts?: number;\n        uploadUrl?: string;\n        uploadHeaders?: Record<string, string>;\n      };\n    };\n\n    if (upload.strategy === \"direct-single\") {\n      if (!upload.upload.uploadUrl) {\n        throw new Error(\"Missing upload URL for direct upload\");\n      }\n\n      const headers = new Headers(upload.upload.uploadHeaders ?? {});\n      headers.set(\"Content-Length\", String(sizeBytes));\n      const init: RequestInit & { duplex?: \"half\" } = {\n        method: \"PUT\",\n        headers,\n        body: Readable.toWeb(createReadStream(filePath)) as BodyInit,\n        duplex: \"half\",\n      };\n      const response = await fetch(upload.upload.uploadUrl, init);\n\n      if (!response.ok) {\n        throw new Error(`Direct upload failed (${response.status})`);\n      }\n\n      await client.reportProgress(upload.uploadId, {\n        bytesUploaded: sizeBytes,\n        partsUploaded: 1,\n      });\n\n      const file = await client.completeUpload(upload.uploadId, []);\n      console.log(JSON.stringify({ upload, file }, null, 2));\n      return;\n    }\n\n    if (upload.strategy === \"direct-multipart\") {\n      const partSizeBytes = upload.upload.partSizeBytes;\n      if (!partSizeBytes) {\n        throw new Error(\"Missing multipart part size from server\");\n      }\n\n      const totalParts = Math.ceil(sizeBytes / partSizeBytes);\n      if (upload.upload.maxParts && totalParts > upload.upload.maxParts) {\n        throw new Error(\"Multipart upload exceeds maximum parts\");\n      }\n\n      const partNumbers = Array.from({ length: totalParts }, (_, index) => index + 1);\n      const partUrls = (await client.getPartUrls(upload.uploadId, partNumbers)) as {\n        parts: { partNumber: number; url: string; headers?: Record<string, string> }[];\n      };\n      const orderedParts = partUrls.parts.sort((a, b) => a.partNumber - b.partNumber);\n\n      const completedParts: { partNumber: number; etag: string; sizeBytes: number }[] = [];\n      const completionParts: { partNumber: number; etag: string }[] = [];\n\n      let bytesUploaded = 0;\n      let partsUploaded = 0;\n\n      for (const part of orderedParts) {\n        const start = (part.partNumber - 1) * partSizeBytes;\n        const length = Math.min(partSizeBytes, sizeBytes - start);\n        const end = start + length - 1;\n\n        const headers = new Headers(part.headers ?? {});\n        headers.set(\"Content-Length\", String(length));\n        const init: RequestInit & { duplex?: \"half\" } = {\n          method: \"PUT\",\n          headers,\n          body: Readable.toWeb(createReadStream(filePath, { start, end })) as BodyInit,\n          duplex: \"half\",\n        };\n\n        const response = await fetch(part.url, init);\n\n        if (!response.ok) {\n          throw new Error(`Multipart upload failed (${response.status})`);\n        }\n\n        const etag = response.headers.get(\"etag\") ?? response.headers.get(\"ETag\");\n        if (!etag) {\n          throw new Error(\"Missing ETag for uploaded part\");\n        }\n\n        completedParts.push({ partNumber: part.partNumber, etag, sizeBytes: length });\n        completionParts.push({ partNumber: part.partNumber, etag });\n\n        bytesUploaded += length;\n        partsUploaded += 1;\n        await client.reportProgress(upload.uploadId, {\n          bytesUploaded,\n          partsUploaded,\n        });\n      }\n\n      await client.completeParts(upload.uploadId, completedParts);\n      const file = await client.completeUpload(upload.uploadId, completionParts);\n      console.log(JSON.stringify({ upload, file }, null, 2));\n      return;\n    }\n\n    const response = await client.uploadContent(\n      upload.uploadId,\n      Readable.toWeb(createReadStream(filePath)) as BodyInit,\n      contentType,\n    );\n    console.log(JSON.stringify({ upload, file: response }, null, 2));\n  },\n});\n"],"mappings":"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"}

package/dist/node/cli/index.d.ts

@@ -0,0 +1,27 @@
+#!/usr/bin/env node
+import { uploadsCreateCommand } from "./commands/uploads/create.js";
+import { uploadsGetCommand } from "./commands/uploads/get.js";
+import { uploadsProgressCommand } from "./commands/uploads/progress.js";
+import { uploadsPartsUrlsCommand } from "./commands/uploads/parts-urls.js";
+import { uploadsPartsListCommand } from "./commands/uploads/parts-list.js";
+import { uploadsPartsCompleteCommand } from "./commands/uploads/parts-complete.js";
+import { uploadsCompleteCommand } from "./commands/uploads/complete.js";
+import { uploadsAbortCommand } from "./commands/uploads/abort.js";
+import { uploadsContentCommand } from "./commands/uploads/content.js";
+import { uploadsTransferCommand } from "./commands/uploads/transfer.js";
+import { filesUploadCommand } from "./commands/files/upload.js";
+import { filesListCommand } from "./commands/files/list.js";
+import { filesGetCommand } from "./commands/files/get.js";
+import { filesUpdateCommand } from "./commands/files/update.js";
+import { filesDeleteCommand } from "./commands/files/delete.js";
+import { filesDownloadUrlCommand } from "./commands/files/download-url.js";
+import { filesDownloadCommand } from "./commands/files/download.js";
+import { Args, Command } from "gunshi";
+
+//#region src/cli/index.d.ts
+declare const uploadsCommand: Command<Args>;
+declare const filesCommand: Command<Args>;
+declare function run(): Promise<void>;
+//#endregion
+export { filesCommand, filesDeleteCommand, filesDownloadCommand, filesDownloadUrlCommand, filesGetCommand, filesListCommand, filesUpdateCommand, filesUploadCommand, run, uploadsAbortCommand, uploadsCommand, uploadsCompleteCommand, uploadsContentCommand, uploadsCreateCommand, uploadsGetCommand, uploadsPartsCompleteCommand, uploadsPartsListCommand, uploadsPartsUrlsCommand, uploadsProgressCommand, uploadsTransferCommand };
+//# sourceMappingURL=index.d.ts.map

package/dist/node/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/cli/index.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;;;;;;;;;cA6Ba,gBAAc,QAAA;cAKd,cAAY,QAAA;AALZ,iBA0HS,GAAA,CAAA,CAvHpB,EAuHuB,OAvHvB,CAAA,IAAA,CAAA"}