@fragno-dev/upload 0.1.1 → 0.1.3

package/dist/node/storage/r2-binding.js

@@ -0,0 +1,245 @@
+import { assertFileKey } from "../file-key.js";
+import { appendStorageObjectKeyVersionSegment } from "./object-key.js";
+
+//#region src/storage/r2-binding.ts
+const BYTES_IN_MIB = 1024 * 1024;
+const BYTES_IN_GIB = 1024 * BYTES_IN_MIB;
+const DEFAULT_MAX_STORAGE_KEY_LENGTH_BYTES = 1024;
+const DEFAULT_UPLOAD_EXPIRES_IN_SECONDS = 3600;
+const DEFAULT_CONTENT_TYPE = "application/octet-stream";
+const DEFAULT_MIN_MULTIPART_PART_SIZE_BYTES = 5 * BYTES_IN_MIB;
+const DEFAULT_MAX_MULTIPART_PART_SIZE_BYTES = 5 * BYTES_IN_GIB;
+const DEFAULT_MAX_MULTIPART_PARTS = 1e4;
+const DEFAULT_MULTIPART_PART_SIZE_BYTES = 8 * BYTES_IN_MIB;
+const normalizePrefix = (prefix) => {
+	if (!prefix) return "";
+	const segments = prefix.split("/").filter(Boolean);
+	for (const segment of segments) if (segment === "." || segment === "..") throw new Error("Storage key prefix cannot include '.' or '..' segments");
+	return segments.join("/");
+};
+const normalizeProvider = (provider) => {
+	const normalized = provider.trim();
+	if (normalized.length === 0 || normalized === "." || normalized === ".." || normalized.includes("/") || normalized.includes("\\")) throw new Error("Invalid provider");
+	return normalized;
+};
+const resolveMetadataSize = (metadata) => {
+	if (!metadata) return 0;
+	const serialized = JSON.stringify(metadata);
+	return new TextEncoder().encode(serialized).byteLength;
+};
+const divideCeil = (numerator, denominator) => (numerator + denominator - 1n) / denominator;
+const resolveEtag = (result) => result.httpEtag ?? result.etag;
+const assertSizeMatches = (input) => {
+	if (input.expected === void 0 || input.expected === null) return;
+	if (input.actual === void 0 || input.actual === null) return;
+	if (input.expected !== input.actual) throw new Error("Upload size mismatch");
+};
+const normalizeUploadedPart = (uploadedPart, fallbackPartNumber) => {
+	if (!uploadedPart || typeof uploadedPart !== "object") throw new Error("STORAGE_ERROR");
+	const part = uploadedPart;
+	if (typeof part.etag !== "string" || part.etag.length === 0) throw new Error("STORAGE_ERROR");
+	return {
+		etag: part.etag,
+		partNumber: typeof part.partNumber === "number" ? part.partNumber : fallbackPartNumber
+	};
+};
+const takeBytesFromChunks = (chunks, size) => {
+	const part = new Uint8Array(size);
+	let offset = 0;
+	while (offset < size) {
+		const chunk = chunks[0];
+		if (!chunk) throw new Error("STORAGE_ERROR");
+		const remaining = size - offset;
+		if (chunk.byteLength <= remaining) {
+			part.set(chunk, offset);
+			offset += chunk.byteLength;
+			chunks.shift();
+			continue;
+		}
+		part.set(chunk.subarray(0, remaining), offset);
+		chunks[0] = chunk.subarray(remaining);
+		offset += remaining;
+	}
+	return part;
+};
+function createR2BindingStorageAdapter(options) {
+	const storageKeyPrefix = normalizePrefix(options.storageKeyPrefix ?? "");
+	const maxStorageKeyLengthBytes = options.maxStorageKeyLengthBytes ?? DEFAULT_MAX_STORAGE_KEY_LENGTH_BYTES;
+	const uploadExpiresInSeconds = options.uploadExpiresInSeconds ?? DEFAULT_UPLOAD_EXPIRES_IN_SECONDS;
+	const maxSingleUploadBytes = options.maxSingleUploadBytes;
+	const maxMultipartUploadBytes = options.maxMultipartUploadBytes;
+	const multipartThresholdBytes = options.multipartThresholdBytes ?? maxSingleUploadBytes;
+	const multipartPartSizeBytes = options.multipartPartSizeBytes ?? DEFAULT_MULTIPART_PART_SIZE_BYTES;
+	const minMultipartPartSizeBytes = DEFAULT_MIN_MULTIPART_PART_SIZE_BYTES;
+	const maxMultipartPartSizeBytes = DEFAULT_MAX_MULTIPART_PART_SIZE_BYTES;
+	const maxMultipartParts = DEFAULT_MAX_MULTIPART_PARTS;
+	const maxUploadBytes = options.maxMultipartUploadBytes ?? options.maxSingleUploadBytes;
+	const maxMetadataBytes = options.maxMetadataBytes;
+	const defaultContentType = options.defaultContentType ?? DEFAULT_CONTENT_TYPE;
+	if (multipartPartSizeBytes < minMultipartPartSizeBytes) throw new Error(`Multipart part size must be at least ${minMultipartPartSizeBytes} bytes for R2 uploads`);
+	if (multipartPartSizeBytes > maxMultipartPartSizeBytes) throw new Error(`Multipart part size must be at most ${maxMultipartPartSizeBytes} bytes for R2 uploads`);
+	const resolveStorageKey = (input) => {
+		const storageKey = [
+			storageKeyPrefix,
+			normalizeProvider(input.provider),
+			assertFileKey(input.fileKey)
+		].filter(Boolean).join("/");
+		if (storageKey.length === 0) throw new Error("Storage key cannot be empty");
+		if (new TextEncoder().encode(storageKey).byteLength > maxStorageKeyLengthBytes) throw new Error("Storage key exceeds maximum length");
+		return storageKey;
+	};
+	const resolveMultipartPartSize = (sizeBytes) => {
+		let partSize = multipartPartSizeBytes;
+		if (sizeBytes !== void 0 && sizeBytes !== null && sizeBytes > 0n) {
+			const minPartSizeForLimit = divideCeil(sizeBytes, BigInt(maxMultipartParts));
+			if (minPartSizeForLimit > BigInt(maxMultipartPartSizeBytes)) throw new Error("Multipart upload exceeds maximum number of parts");
+			if (minPartSizeForLimit > BigInt(partSize)) partSize = Number(minPartSizeForLimit);
+		}
+		if (partSize < minMultipartPartSizeBytes) throw new Error("Multipart part size is smaller than minimum allowed size");
+		if (partSize > maxMultipartPartSizeBytes) throw new Error("Multipart part size exceeds maximum allowed size");
+		return partSize;
+	};
+	const shouldUseMultipartUpload = (sizeBytes) => {
+		if (sizeBytes === void 0 || sizeBytes === null || sizeBytes <= 0n) return false;
+		if (multipartThresholdBytes !== void 0 && sizeBytes >= BigInt(multipartThresholdBytes)) return true;
+		if (maxSingleUploadBytes !== void 0 && sizeBytes > BigInt(maxSingleUploadBytes)) return true;
+		return false;
+	};
+	const writeMultipartStream = async (input) => {
+		const multipartUpload = await options.bucket.createMultipartUpload(input.storageKey, { httpMetadata: input.contentType ? { contentType: input.contentType } : void 0 });
+		if (!multipartUpload.uploadId) throw new Error("STORAGE_ERROR");
+		const uploadedParts = [];
+		const reader = input.body.getReader();
+		const bufferedChunks = [];
+		let bufferedBytes = 0;
+		let partNumber = 1;
+		let uploadedBytes = 0n;
+		try {
+			while (true) {
+				const { done, value } = await reader.read();
+				if (done) break;
+				if (!value || value.byteLength === 0) continue;
+				uploadedBytes += BigInt(value.byteLength);
+				bufferedChunks.push(value);
+				bufferedBytes += value.byteLength;
+				while (bufferedBytes >= input.partSizeBytes) {
+					if (partNumber > maxMultipartParts) throw new Error("Multipart upload exceeds maximum number of parts");
+					const part = takeBytesFromChunks(bufferedChunks, input.partSizeBytes);
+					bufferedBytes -= input.partSizeBytes;
+					const uploadedPart = await multipartUpload.uploadPart(partNumber, part);
+					uploadedParts.push(normalizeUploadedPart(uploadedPart, partNumber));
+					partNumber += 1;
+				}
+			}
+			assertSizeMatches({
+				expected: input.sizeBytes,
+				actual: uploadedBytes
+			});
+			if (bufferedBytes > 0 || uploadedParts.length === 0) {
+				if (partNumber > maxMultipartParts) throw new Error("Multipart upload exceeds maximum number of parts");
+				const finalPart = bufferedBytes > 0 ? takeBytesFromChunks(bufferedChunks, bufferedBytes) : new Uint8Array(0);
+				bufferedBytes = 0;
+				const uploadedPart = await multipartUpload.uploadPart(partNumber, finalPart);
+				uploadedParts.push(normalizeUploadedPart(uploadedPart, partNumber));
+			}
+			const completed = await multipartUpload.complete(uploadedParts);
+			return {
+				...resolveEtag(completed) ? { etag: resolveEtag(completed) } : {},
+				sizeBytes: uploadedBytes
+			};
+		} catch (error) {
+			try {
+				await multipartUpload.abort();
+			} catch {}
+			throw error;
+		} finally {
+			reader.releaseLock();
+		}
+	};
+	return {
+		name: "r2-binding",
+		capabilities: {
+			directUpload: false,
+			multipartUpload: true,
+			signedDownload: false,
+			proxyUpload: true
+		},
+		limits: {
+			maxSingleUploadBytes,
+			maxMultipartUploadBytes,
+			minMultipartPartSizeBytes,
+			maxMultipartPartSizeBytes,
+			maxMultipartParts,
+			maxStorageKeyLengthBytes,
+			maxMetadataBytes
+		},
+		recommendations: {
+			uploadExpiresInSeconds,
+			signedUrlExpiresInSeconds: options.signedUrlExpiresInSeconds,
+			directUploadThresholdBytes: options.directUploadThresholdBytes,
+			multipartThresholdBytes,
+			multipartPartSizeBytes
+		},
+		resolveStorageKey,
+		initUpload: async ({ provider, fileKey, sizeBytes, metadata, objectKeyVersionSegment }) => {
+			const storageKey = appendStorageObjectKeyVersionSegment(resolveStorageKey({
+				provider,
+				fileKey
+			}), objectKeyVersionSegment, maxStorageKeyLengthBytes);
+			if (maxUploadBytes !== void 0 && sizeBytes > BigInt(maxUploadBytes)) throw new Error("Upload exceeds maximum upload size");
+			if (maxMetadataBytes !== void 0 && resolveMetadataSize(metadata) > maxMetadataBytes) throw new Error("Metadata exceeds maximum size");
+			return {
+				strategy: "proxy",
+				storageKey,
+				expiresAt: new Date(Date.now() + uploadExpiresInSeconds * 1e3)
+			};
+		},
+		writeStream: async ({ storageKey, body, contentType, sizeBytes }) => {
+			if (maxUploadBytes !== void 0 && sizeBytes !== void 0 && sizeBytes !== null && sizeBytes > BigInt(maxUploadBytes)) throw new Error("Upload exceeds maximum upload size");
+			if (shouldUseMultipartUpload(sizeBytes)) return writeMultipartStream({
+				storageKey,
+				body,
+				contentType,
+				sizeBytes,
+				partSizeBytes: resolveMultipartPartSize(sizeBytes)
+			});
+			const result = await options.bucket.put(storageKey, body, { httpMetadata: contentType ? { contentType } : void 0 });
+			const size = typeof result.size === "number" ? BigInt(result.size) : sizeBytes ?? void 0;
+			assertSizeMatches({
+				expected: sizeBytes,
+				actual: size
+			});
+			const etag = resolveEtag(result);
+			return {
+				...etag ? { etag } : {},
+				...size !== void 0 ? { sizeBytes: size } : {}
+			};
+		},
+		deleteObject: async ({ storageKey }) => {
+			await options.bucket.delete(storageKey);
+		},
+		getDownloadStream: async ({ storageKey }) => {
+			const object = await options.bucket.get(storageKey);
+			if (!object || !object.body) throw new Error("STORAGE_ERROR");
+			const headers = new Headers();
+			headers.set("Content-Type", object.httpMetadata?.contentType || defaultContentType);
+			headers.set("ETag", object.httpEtag);
+			headers.set("Content-Length", object.size.toString());
+			return new Response(object.body, { headers });
+		}
+	};
+}
+const isR2BindingBucket = (candidate) => {
+	if (!candidate || typeof candidate !== "object") return false;
+	const bucket = candidate;
+	return typeof bucket.put === "function" && typeof bucket.get === "function" && typeof bucket.delete === "function" && typeof bucket.createMultipartUpload === "function";
+};
+const resolveR2BindingBucket = (bindings, bindingName) => {
+	const candidate = bindings[bindingName];
+	if (!isR2BindingBucket(candidate)) throw new Error(`Upload R2 bucket binding '${bindingName}' is not configured.`);
+	return candidate;
+};
+
+//#endregion
+export { createR2BindingStorageAdapter, resolveR2BindingBucket };
+//# sourceMappingURL=r2-binding.js.map

package/dist/node/storage/r2-binding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"r2-binding.js","names":["uploadedParts: R2BindingUploadedPart[]","bufferedChunks: Uint8Array[]"],"sources":["../../../src/storage/r2-binding.ts"],"sourcesContent":["import { assertFileKey } from \"../file-key\";\nimport { appendStorageObjectKeyVersionSegment } from \"./object-key\";\nimport type { StorageAdapter } from \"./types\";\n\nconst BYTES_IN_MIB = 1024 * 1024;\nconst BYTES_IN_GIB = 1024 * BYTES_IN_MIB;\nconst DEFAULT_MAX_STORAGE_KEY_LENGTH_BYTES = 1024;\nconst DEFAULT_UPLOAD_EXPIRES_IN_SECONDS = 60 * 60;\nconst DEFAULT_CONTENT_TYPE = \"application/octet-stream\";\nconst DEFAULT_MIN_MULTIPART_PART_SIZE_BYTES = 5 * BYTES_IN_MIB;\nconst DEFAULT_MAX_MULTIPART_PART_SIZE_BYTES = 5 * BYTES_IN_GIB;\nconst DEFAULT_MAX_MULTIPART_PARTS = 10_000;\nconst DEFAULT_MULTIPART_PART_SIZE_BYTES = 8 * BYTES_IN_MIB;\n\ntype R2BindingPutResult = {\n  httpEtag?: string;\n  etag?: string;\n  size?: number;\n};\n\ntype R2BindingGetResult = {\n  body: ReadableStream<Uint8Array> | null;\n  size: number;\n  httpEtag: string;\n  httpMetadata?: {\n    contentType?: string;\n  };\n};\n\ntype R2BindingUploadedPart = {\n  etag: string;\n  partNumber: number;\n};\n\ntype R2BindingMultipartUpload = {\n  uploadId: string;\n  uploadPart: (partNumber: number, value: unknown) => Promise<R2BindingUploadedPart>;\n  complete: (parts: R2BindingUploadedPart[]) => Promise<R2BindingPutResult>;\n  abort: () => Promise<void>;\n};\n\nexport type R2BindingBucket = {\n  put: (\n    key: string,\n    value: unknown,\n    options?: {\n      httpMetadata?: {\n        contentType?: string;\n      };\n    },\n  ) => Promise<R2BindingPutResult>;\n  get: (key: string) => Promise<R2BindingGetResult | null>;\n  delete: (key: string) => Promise<void>;\n  createMultipartUpload: (\n    key: string,\n    options?: {\n      httpMetadata?: {\n        contentType?: string;\n      };\n    },\n  ) => Promise<R2BindingMultipartUpload>;\n};\n\nexport type R2BindingStorageAdapterOptions = {\n  bucket: R2BindingBucket;\n  storageKeyPrefix?: string;\n  directUploadThresholdBytes?: number;\n  multipartThresholdBytes?: number;\n  multipartPartSizeBytes?: number;\n  uploadExpiresInSeconds?: number;\n  signedUrlExpiresInSeconds?: number;\n  maxSingleUploadBytes?: number;\n  maxMultipartUploadBytes?: number;\n  maxStorageKeyLengthBytes?: number;\n  maxMetadataBytes?: number;\n  defaultContentType?: string;\n};\n\nconst normalizePrefix = (prefix: string): string => {\n  if (!prefix) {\n    return \"\";\n  }\n\n  const segments = prefix.split(\"/\").filter(Boolean);\n  for (const segment of segments) {\n    if (segment === \".\" || segment === \"..\") {\n      throw new Error(\"Storage key prefix cannot include '.' or '..' segments\");\n    }\n  }\n\n  return segments.join(\"/\");\n};\n\nconst normalizeProvider = (provider: string): string => {\n  const normalized = provider.trim();\n  if (\n    normalized.length === 0 ||\n    normalized === \".\" ||\n    normalized === \"..\" ||\n    normalized.includes(\"/\") ||\n    normalized.includes(\"\\\\\")\n  ) {\n    throw new Error(\"Invalid provider\");\n  }\n\n  return normalized;\n};\n\nconst resolveMetadataSize = (metadata?: Record<string, unknown> | null) => {\n  if (!metadata) {\n    return 0;\n  }\n\n  const serialized = JSON.stringify(metadata);\n  return new TextEncoder().encode(serialized).byteLength;\n};\n\nconst divideCeil = (numerator: bigint, denominator: bigint) =>\n  (numerator + denominator - 1n) / denominator;\n\nconst resolveEtag = (result: { httpEtag?: string; etag?: string }) =>\n  result.httpEtag ?? result.etag;\n\nconst assertSizeMatches = (input: { expected?: bigint | null; actual?: bigint | null }) => {\n  if (input.expected === undefined || input.expected === null) {\n    return;\n  }\n  if (input.actual === undefined || input.actual === null) {\n    return;\n  }\n  if (input.expected !== input.actual) {\n    throw new Error(\"Upload size mismatch\");\n  }\n};\n\nconst normalizeUploadedPart = (\n  uploadedPart: unknown,\n  fallbackPartNumber: number,\n): R2BindingUploadedPart => {\n  if (!uploadedPart || typeof uploadedPart !== \"object\") {\n    throw new Error(\"STORAGE_ERROR\");\n  }\n\n  const part = uploadedPart as Partial<R2BindingUploadedPart>;\n  if (typeof part.etag !== \"string\" || part.etag.length === 0) {\n    throw new Error(\"STORAGE_ERROR\");\n  }\n\n  return {\n    etag: part.etag,\n    partNumber: typeof part.partNumber === \"number\" ? part.partNumber : fallbackPartNumber,\n  };\n};\n\nconst takeBytesFromChunks = (chunks: Uint8Array[], size: number) => {\n  const part = new Uint8Array(size);\n  let offset = 0;\n\n  while (offset < size) {\n    const chunk = chunks[0];\n    if (!chunk) {\n      throw new Error(\"STORAGE_ERROR\");\n    }\n\n    const remaining = size - offset;\n    if (chunk.byteLength <= remaining) {\n      part.set(chunk, offset);\n      offset += chunk.byteLength;\n      chunks.shift();\n      continue;\n    }\n\n    part.set(chunk.subarray(0, remaining), offset);\n    chunks[0] = chunk.subarray(remaining);\n    offset += remaining;\n  }\n\n  return part;\n};\n\nexport function createR2BindingStorageAdapter(\n  options: R2BindingStorageAdapterOptions,\n): StorageAdapter {\n  const storageKeyPrefix = normalizePrefix(options.storageKeyPrefix ?? \"\");\n  const maxStorageKeyLengthBytes =\n    options.maxStorageKeyLengthBytes ?? DEFAULT_MAX_STORAGE_KEY_LENGTH_BYTES;\n  const uploadExpiresInSeconds =\n    options.uploadExpiresInSeconds ?? DEFAULT_UPLOAD_EXPIRES_IN_SECONDS;\n  const maxSingleUploadBytes = options.maxSingleUploadBytes;\n  const maxMultipartUploadBytes = options.maxMultipartUploadBytes;\n  const multipartThresholdBytes = options.multipartThresholdBytes ?? maxSingleUploadBytes;\n  const multipartPartSizeBytes =\n    options.multipartPartSizeBytes ?? DEFAULT_MULTIPART_PART_SIZE_BYTES;\n  const minMultipartPartSizeBytes = DEFAULT_MIN_MULTIPART_PART_SIZE_BYTES;\n  const maxMultipartPartSizeBytes = DEFAULT_MAX_MULTIPART_PART_SIZE_BYTES;\n  const maxMultipartParts = DEFAULT_MAX_MULTIPART_PARTS;\n  const maxUploadBytes = options.maxMultipartUploadBytes ?? options.maxSingleUploadBytes;\n  const maxMetadataBytes = options.maxMetadataBytes;\n  const defaultContentType = options.defaultContentType ?? DEFAULT_CONTENT_TYPE;\n\n  if (multipartPartSizeBytes < minMultipartPartSizeBytes) {\n    throw new Error(\n      `Multipart part size must be at least ${minMultipartPartSizeBytes} bytes for R2 uploads`,\n    );\n  }\n  if (multipartPartSizeBytes > maxMultipartPartSizeBytes) {\n    throw new Error(\n      `Multipart part size must be at most ${maxMultipartPartSizeBytes} bytes for R2 uploads`,\n    );\n  }\n\n  const resolveStorageKey = (input: { provider: string; fileKey: string }) => {\n    const provider = normalizeProvider(input.provider);\n    const fileKey = assertFileKey(input.fileKey);\n    const storageKey = [storageKeyPrefix, provider, fileKey].filter(Boolean).join(\"/\");\n\n    if (storageKey.length === 0) {\n      throw new Error(\"Storage key cannot be empty\");\n    }\n\n    if (new TextEncoder().encode(storageKey).byteLength > maxStorageKeyLengthBytes) {\n      throw new Error(\"Storage key exceeds maximum length\");\n    }\n\n    return storageKey;\n  };\n\n  const resolveMultipartPartSize = (sizeBytes?: bigint | null) => {\n    let partSize = multipartPartSizeBytes;\n\n    if (sizeBytes !== undefined && sizeBytes !== null && sizeBytes > 0n) {\n      const minPartSizeForLimit = divideCeil(sizeBytes, BigInt(maxMultipartParts));\n      if (minPartSizeForLimit > BigInt(maxMultipartPartSizeBytes)) {\n        throw new Error(\"Multipart upload exceeds maximum number of parts\");\n      }\n      if (minPartSizeForLimit > BigInt(partSize)) {\n        partSize = Number(minPartSizeForLimit);\n      }\n    }\n\n    if (partSize < minMultipartPartSizeBytes) {\n      throw new Error(\"Multipart part size is smaller than minimum allowed size\");\n    }\n    if (partSize > maxMultipartPartSizeBytes) {\n      throw new Error(\"Multipart part size exceeds maximum allowed size\");\n    }\n\n    return partSize;\n  };\n\n  // FIXME: This decision currently trusts caller-provided sizeBytes. To enforce\n  // maxSingleUploadBytes/maxMultipartUploadBytes for unknown or underreported streams,\n  // the proxy path needs real byte counting while reading the body.\n  const shouldUseMultipartUpload = (sizeBytes?: bigint | null) => {\n    if (sizeBytes === undefined || sizeBytes === null || sizeBytes <= 0n) {\n      return false;\n    }\n\n    if (multipartThresholdBytes !== undefined && sizeBytes >= BigInt(multipartThresholdBytes)) {\n      return true;\n    }\n\n    if (maxSingleUploadBytes !== undefined && sizeBytes > BigInt(maxSingleUploadBytes)) {\n      return true;\n    }\n\n    return false;\n  };\n\n  const writeMultipartStream = async (input: {\n    storageKey: string;\n    body: ReadableStream<Uint8Array>;\n    contentType?: string | null;\n    sizeBytes?: bigint | null;\n    partSizeBytes: number;\n  }) => {\n    const multipartUpload = await options.bucket.createMultipartUpload(input.storageKey, {\n      httpMetadata: input.contentType ? { contentType: input.contentType } : undefined,\n    });\n\n    if (!multipartUpload.uploadId) {\n      throw new Error(\"STORAGE_ERROR\");\n    }\n\n    const uploadedParts: R2BindingUploadedPart[] = [];\n    const reader = input.body.getReader();\n    const bufferedChunks: Uint8Array[] = [];\n    let bufferedBytes = 0;\n    let partNumber = 1;\n    let uploadedBytes = 0n;\n\n    try {\n      while (true) {\n        const { done, value } = await reader.read();\n        if (done) {\n          break;\n        }\n        if (!value || value.byteLength === 0) {\n          continue;\n        }\n\n        uploadedBytes += BigInt(value.byteLength);\n        // TODO: Enforce the effective max upload bytes from uploadedBytes while streaming,\n        // instead of relying on input.sizeBytes to reject oversized proxy uploads.\n        bufferedChunks.push(value);\n        bufferedBytes += value.byteLength;\n\n        while (bufferedBytes >= input.partSizeBytes) {\n          if (partNumber > maxMultipartParts) {\n            throw new Error(\"Multipart upload exceeds maximum number of parts\");\n          }\n\n          const part = takeBytesFromChunks(bufferedChunks, input.partSizeBytes);\n          bufferedBytes -= input.partSizeBytes;\n\n          const uploadedPart = await multipartUpload.uploadPart(partNumber, part);\n          uploadedParts.push(normalizeUploadedPart(uploadedPart, partNumber));\n          partNumber += 1;\n        }\n      }\n\n      assertSizeMatches({ expected: input.sizeBytes, actual: uploadedBytes });\n\n      if (bufferedBytes > 0 || uploadedParts.length === 0) {\n        if (partNumber > maxMultipartParts) {\n          throw new Error(\"Multipart upload exceeds maximum number of parts\");\n        }\n\n        const finalPart =\n          bufferedBytes > 0\n            ? takeBytesFromChunks(bufferedChunks, bufferedBytes)\n            : new Uint8Array(0);\n        bufferedBytes = 0;\n\n        const uploadedPart = await multipartUpload.uploadPart(partNumber, finalPart);\n        uploadedParts.push(normalizeUploadedPart(uploadedPart, partNumber));\n      }\n\n      const completed = await multipartUpload.complete(uploadedParts);\n      return {\n        ...(resolveEtag(completed) ? { etag: resolveEtag(completed) } : {}),\n        sizeBytes: uploadedBytes,\n      };\n    } catch (error) {\n      try {\n        await multipartUpload.abort();\n      } catch {\n        // Ignore abort failures to preserve the original storage error.\n      }\n      throw error;\n    } finally {\n      reader.releaseLock();\n    }\n  };\n\n  return {\n    name: \"r2-binding\",\n    capabilities: {\n      directUpload: false,\n      multipartUpload: true,\n      signedDownload: false,\n      proxyUpload: true,\n    },\n    limits: {\n      maxSingleUploadBytes,\n      maxMultipartUploadBytes,\n      minMultipartPartSizeBytes,\n      maxMultipartPartSizeBytes,\n      maxMultipartParts,\n      maxStorageKeyLengthBytes,\n      maxMetadataBytes,\n    },\n    recommendations: {\n      uploadExpiresInSeconds,\n      signedUrlExpiresInSeconds: options.signedUrlExpiresInSeconds,\n      directUploadThresholdBytes: options.directUploadThresholdBytes,\n      multipartThresholdBytes,\n      multipartPartSizeBytes,\n    },\n    resolveStorageKey,\n    initUpload: async ({ provider, fileKey, sizeBytes, metadata, objectKeyVersionSegment }) => {\n      const storageKey = appendStorageObjectKeyVersionSegment(\n        resolveStorageKey({ provider, fileKey }),\n        objectKeyVersionSegment,\n        maxStorageKeyLengthBytes,\n      );\n\n      if (maxUploadBytes !== undefined && sizeBytes > BigInt(maxUploadBytes)) {\n        throw new Error(\"Upload exceeds maximum upload size\");\n      }\n\n      if (maxMetadataBytes !== undefined && resolveMetadataSize(metadata) > maxMetadataBytes) {\n        throw new Error(\"Metadata exceeds maximum size\");\n      }\n\n      return {\n        strategy: \"proxy\",\n        storageKey,\n        expiresAt: new Date(Date.now() + uploadExpiresInSeconds * 1000),\n      };\n    },\n    writeStream: async ({ storageKey, body, contentType, sizeBytes }) => {\n      if (\n        maxUploadBytes !== undefined &&\n        sizeBytes !== undefined &&\n        sizeBytes !== null &&\n        sizeBytes > BigInt(maxUploadBytes)\n      ) {\n        throw new Error(\"Upload exceeds maximum upload size\");\n      }\n\n      if (shouldUseMultipartUpload(sizeBytes)) {\n        const partSizeBytes = resolveMultipartPartSize(sizeBytes);\n        return writeMultipartStream({\n          storageKey,\n          body,\n          contentType,\n          sizeBytes,\n          partSizeBytes,\n        });\n      }\n\n      // TODO: Wrap the single-put body in a counting/limiting stream so unknown or\n      // underreported sizeBytes cannot bypass configured max upload limits.\n      const result = await options.bucket.put(storageKey, body, {\n        httpMetadata: contentType ? { contentType } : undefined,\n      });\n\n      const size = typeof result.size === \"number\" ? BigInt(result.size) : (sizeBytes ?? undefined);\n      assertSizeMatches({ expected: sizeBytes, actual: size });\n      const etag = resolveEtag(result);\n\n      return {\n        ...(etag ? { etag } : {}),\n        ...(size !== undefined ? { sizeBytes: size } : {}),\n      };\n    },\n    deleteObject: async ({ storageKey }) => {\n      await options.bucket.delete(storageKey);\n    },\n    getDownloadStream: async ({ storageKey }) => {\n      const object = await options.bucket.get(storageKey);\n      if (!object || !object.body) {\n        throw new Error(\"STORAGE_ERROR\");\n      }\n\n      const headers = new Headers();\n      headers.set(\"Content-Type\", object.httpMetadata?.contentType || defaultContentType);\n      headers.set(\"ETag\", object.httpEtag);\n      headers.set(\"Content-Length\", object.size.toString());\n\n      return new Response(object.body, { headers });\n    },\n  };\n}\n\nconst isR2BindingBucket = (candidate: unknown): candidate is R2BindingBucket => {\n  if (!candidate || typeof candidate !== \"object\") {\n    return false;\n  }\n\n  const bucket = candidate as Partial<R2BindingBucket>;\n  return (\n    typeof bucket.put === \"function\" &&\n    typeof bucket.get === \"function\" &&\n    typeof bucket.delete === \"function\" &&\n    typeof bucket.createMultipartUpload === \"function\"\n  );\n};\n\nexport const resolveR2BindingBucket = (\n  bindings: Record<string, unknown>,\n  bindingName: string,\n): R2BindingBucket => {\n  const candidate = bindings[bindingName];\n  if (!isR2BindingBucket(candidate)) {\n    throw new Error(`Upload R2 bucket binding '${bindingName}' is not configured.`);\n  }\n  return candidate;\n};\n"],"mappings":"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"}

package/dist/node/storage/r2.d.ts

@@ -1,4 +1,4 @@
-import { FileKeyEncoded, FileKeyParts } from "../keys.js";
+import { FileKey } from "../file-key.js";
 import { StorageAdapterCapabilities, StorageAdapterRecommendations, UploadChecksum } from "./types.js";
 import { S3CompatibleStorageAdapterOptions } from "./s3.js";
 
@@ -20,16 +20,17 @@ declare function createR2StorageAdapter(options: R2StorageAdapterOptions): {
   capabilities: StorageAdapterCapabilities;
   recommendations?: StorageAdapterRecommendations;
   resolveStorageKey(input: {
-    fileKey: FileKeyEncoded;
-    fileKeyParts: FileKeyParts;
+    provider: string;
+    fileKey: FileKey;
   }): string;
   initUpload(input: {
-    fileKey: FileKeyEncoded;
-    fileKeyParts: FileKeyParts;
+    provider: string;
+    fileKey: FileKey;
     sizeBytes: bigint;
     contentType: string;
     checksum?: UploadChecksum | null;
     metadata?: Record<string, unknown> | null;
+    objectKeyVersionSegment?: string;
   }): Promise<{
     strategy: "direct-single" | "direct-multipart" | "proxy";
     storageKey: string;

package/dist/node/storage/r2.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"r2.d.ts","names":[],"sources":["../../../src/storage/r2.ts"],"sourcesContent":[],"mappings":";;;;;KAIY,uBAAA,GAA0B,KACpC;;;iBAMc,sBAAA,UAAgC;EAPpC,IAAA,EAAA,MAAA;EAAuB,MAAA,EAAA;IACjC,gBAAA,EAAA,MAAA;IADoC,oBAAA,CAAA,EAAA,MAAA;IAAI,uBAAA,CAAA,EAAA,MAAA;IAO1B,yBAAsB,CAAA,EAAA,MAAA;IAAA,yBAAA,CAAA,EAAA,MAAA;IAAU,iBAAA,CAAA,EAAA,MAAA;IAAuB,wBAAA,CAAA,EAAA,MAAA;;gBAAA;;;;;MAgBwvB,MAAA;;IAAiQ,OAAA,gBAAA;;IAAsR,SAAA,EAAA,MAAA;;;eAAvhB;;;;;;;IAAunD,SAAA,CAAA,EAAA,MAAA;oBAAt3C;;;;;;;;;;cAAsR;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAAgmC"}
+{"version":3,"file":"r2.d.ts","names":[],"sources":["../../../src/storage/r2.ts"],"sourcesContent":[],"mappings":";;;;;KAIY,uBAAA,GAA0B,KACpC;;;iBAMc,sBAAA,UAAgC;EAPpC,IAAA,EAAA,MAAA;EAAuB,MAAA,EAAA;IACjC,gBAAA,EAAA,MAAA;IADoC,oBAAA,CAAA,EAAA,MAAA;IAAI,uBAAA,CAAA,EAAA,MAAA;IAO1B,yBAAsB,CAAA,EAAA,MAAA;IAAA,yBAAA,CAAA,EAAA,MAAA;IAAU,iBAAA,CAAA,EAAA,MAAA;IAAuB,wBAAA,CAAA,EAAA,MAAA;;gBAAA;;;IAgBq0B,QAAA,EAAA,MAAA;;MAAuS,MAAA;;IAAsR,QAAA,EAAA,MAAA;;;;;eAA7jB;;;;;IAAqqD,eAAA,CAAA,EAAA,MAAA;;;;oBAA93C;;;;;;;;;;cAAsR;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAAwmC"}

package/dist/node/storage/s3.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"s3.d.ts","names":[],"sources":["../../../src/storage/s3.ts"],"sourcesContent":[],"mappings":";;;KAmBY,aAAA;;EAAA,GAAA,EAAA,MAAA;EAAa,OAAA,CAAA,EAGb,MAHa,CAAA,MAAA,EAAA,MAAA,CAAA;MAGb,CAAA,EAAA,MAAA,GACM,UADN,GAAA,IAAA;kBACM,CAAA,EAAA,MAAA;CAAU;AAIhB,KAAA,QAAA,GAAQ;EAAA,IAAA,EAAA,CAAA,KAAA,EACJ,aADI,EAAA,GACc,OADd,CAAA;IACJ,GAAA,EAAA,MAAA;IAAkD,OAAA,EAAA,MAAA,CAAA,MAAA,EAAA,MAAA,CAAA;;SAC/C,EAAA,CAAA,KAAA,EAAA,aAAA,EAAA,GAAkB,OAAlB,CAAA;IAAmD,GAAA,EAAA,MAAA;IAAjC,OAAA,CAAA,EAAiC,MAAjC,CAAA,MAAA,EAAA,MAAA,CAAA;EAAO,CAAA,CAAA;AAG5C,CAAA;AAqRgB,KArRJ,iCAAA,GAqRoC;EAAA,MAAA,EAAA,MAAA;UACrC,EAAA,MAAA;QACR,EApRO,QAoRP;EAAc,gBAAA,CAAA,EAAA,MAAA;;;;;;;;;;;;;;;iBAFD,gCAAA,UACL,oCACR"}
+{"version":3,"file":"s3.d.ts","names":[],"sources":["../../../src/storage/s3.ts"],"sourcesContent":[],"mappings":";;;KAqBY,aAAA;;EAAA,GAAA,EAAA,MAAA;EAAa,OAAA,CAAA,EAGb,MAHa,CAAA,MAAA,EAAA,MAAA,CAAA;MAGb,CAAA,EAAA,MAAA,GACM,UADN,GAAA,IAAA;kBACM,CAAA,EAAA,MAAA;CAAU;AAIhB,KAAA,QAAA,GAAQ;EAAA,IAAA,EAAA,CAAA,KAAA,EACJ,aADI,EAAA,GACc,OADd,CAAA;IACJ,GAAA,EAAA,MAAA;IAAkD,OAAA,EAAA,MAAA,CAAA,MAAA,EAAA,MAAA,CAAA;;SAC/C,EAAA,CAAA,KAAA,EAAA,aAAA,EAAA,GAAkB,OAAlB,CAAA;IAAmD,GAAA,EAAA,MAAA;IAAjC,OAAA,CAAA,EAAiC,MAAjC,CAAA,MAAA,EAAA,MAAA,CAAA;EAAO,CAAA,CAAA;AAG5C,CAAA;AA4RgB,KA5RJ,iCAAA,GA4RoC;EAAA,MAAA,EAAA,MAAA;UACrC,EAAA,MAAA;QACR,EA3RO,QA2RP;EAAc,gBAAA,CAAA,EAAA,MAAA;;;;;;;;;;;;;;;iBAFD,gCAAA,UACL,oCACR"}

package/dist/node/storage/s3.js

@@ -1,4 +1,5 @@
-import { encodeFileKey } from "../keys.js";
+import { assertFileKey } from "../file-key.js";
+import { appendStorageObjectKeyVersionSegment } from "./object-key.js";
 import { createHash } from "node:crypto";
 
 //#region src/storage/s3.ts
@@ -21,9 +22,10 @@ const normalizePrefix = (prefix) => {
 	for (const segment of segments) if (segment === "." || segment === "..") throw new Error("Storage key prefix cannot include '.' or '..' segments");
 	return segments.join("/");
 };
-const resolveStorageKeyFromParts = (input) => {
-	const encoded = input.fileKeyParts.length > 0 ? encodeFileKey(input.fileKeyParts) : input.fileKey;
-	return encoded.length > 0 ? encoded.split(".").join("/") : "";
+const normalizeProvider = (provider) => {
+	const normalized = provider.trim();
+	if (normalized.length === 0 || normalized === "." || normalized === ".." || normalized.includes("/") || normalized.includes("\\")) throw new Error("Invalid provider");
+	return normalized;
 };
 const encodePathSegments = (value) => value.split("/").map((segment) => encodeURIComponent(segment)).join("/");
 const joinPathSegments = (...segments) => {
@@ -149,7 +151,11 @@ function createS3CompatibleStorageAdapter(options) {
 	assertExpiresInSeconds(uploadExpiresInSeconds);
 	assertExpiresInSeconds(signedUrlExpiresInSeconds);
 	const resolveStorageKey = (input) => {
-		const storageKey = [storageKeyPrefix, resolveStorageKeyFromParts(input)].filter(Boolean).join("/");
+		const storageKey = [
+			storageKeyPrefix,
+			normalizeProvider(input.provider),
+			assertFileKey(input.fileKey)
+		].filter(Boolean).join("/");
 		if (storageKey.length === 0) throw new Error("Storage key cannot be empty");
 		if (Buffer.byteLength(storageKey, "utf8") > maxStorageKeyLengthBytes) throw new Error("Storage key exceeds maximum length");
 		return storageKey;
@@ -197,12 +203,12 @@ function createS3CompatibleStorageAdapter(options) {
 			multipartPartSizeBytes
 		},
 		resolveStorageKey,
-		initUpload: async ({ fileKey, fileKeyParts, sizeBytes, contentType, metadata, checksum }) => {
+		initUpload: async ({ provider, fileKey, sizeBytes, contentType, metadata, checksum, objectKeyVersionSegment }) => {
 			validateMetadata(metadata);
-			const storageKey = resolveStorageKey({
-				fileKey,
-				fileKeyParts
-			});
+			const storageKey = appendStorageObjectKeyVersionSegment(resolveStorageKey({
+				provider,
+				fileKey
+			}), objectKeyVersionSegment, maxStorageKeyLengthBytes);
 			const expiresAt = new Date(Date.now() + uploadExpiresInSeconds * 1e3);
 			const sizeNumber = Number(sizeBytes);
 			if (Number.isNaN(sizeNumber) || sizeNumber < 0) throw new Error("Upload size must be a non-negative number");

package/dist/node/storage/s3.js.map

@@ -1 +1 @@
-{"version":3,"file":"s3.js","names":["path","signed"],"sources":["../../../src/storage/s3.ts"],"sourcesContent":["import { encodeFileKey, type FileKeyEncoded, type FileKeyParts } from \"../keys\";\nimport { createHash } from \"node:crypto\";\nimport type { StorageAdapter, UploadChecksum } from \"./types\";\n\nconst BYTES_IN_MIB = 1024 * 1024;\nconst BYTES_IN_GIB = 1024 * BYTES_IN_MIB;\nconst BYTES_IN_TIB = 1024 * BYTES_IN_GIB;\n\nconst DEFAULT_MAX_SINGLE_UPLOAD_BYTES = 5 * BYTES_IN_GIB;\nconst DEFAULT_MAX_MULTIPART_UPLOAD_BYTES = 5 * BYTES_IN_TIB;\nconst DEFAULT_MIN_MULTIPART_PART_SIZE_BYTES = 5 * BYTES_IN_MIB;\nconst DEFAULT_MAX_MULTIPART_PART_SIZE_BYTES = 5 * BYTES_IN_GIB;\nconst DEFAULT_MAX_MULTIPART_PARTS = 10_000;\nconst DEFAULT_MAX_STORAGE_KEY_LENGTH_BYTES = 1024;\nconst DEFAULT_UPLOAD_EXPIRES_IN_SECONDS = 60 * 60;\nconst DEFAULT_SIGNED_URL_EXPIRES_IN_SECONDS = 60 * 60;\nconst DEFAULT_MULTIPART_PART_SIZE_BYTES = 8 * BYTES_IN_MIB;\nconst MAX_PRESIGNED_EXPIRES_IN_SECONDS = 60 * 60 * 24 * 7;\n\nexport type S3SignerInput = {\n  method: string;\n  url: string;\n  headers?: Record<string, string>;\n  body?: string | Uint8Array | null;\n  expiresInSeconds?: number;\n};\n\nexport type S3Signer = {\n  sign: (input: S3SignerInput) => Promise<{ url: string; headers: Record<string, string> }>;\n  presign: (input: S3SignerInput) => Promise<{ url: string; headers?: Record<string, string> }>;\n};\n\nexport type S3CompatibleStorageAdapterOptions = {\n  bucket: string;\n  endpoint: string;\n  signer: S3Signer;\n  storageKeyPrefix?: string;\n  pathStyle?: boolean;\n  uploadExpiresInSeconds?: number;\n  signedUrlExpiresInSeconds?: number;\n  directUploadThresholdBytes?: number;\n  multipartThresholdBytes?: number;\n  multipartPartSizeBytes?: number;\n  maxSingleUploadBytes?: number;\n  maxMultipartUploadBytes?: number;\n  minMultipartPartSizeBytes?: number;\n  maxMultipartPartSizeBytes?: number;\n  maxMultipartParts?: number;\n  maxStorageKeyLengthBytes?: number;\n  maxMetadataBytes?: number;\n};\n\nconst normalizePrefix = (prefix: string): string => {\n  if (!prefix) {\n    return \"\";\n  }\n\n  const segments = prefix.split(\"/\").filter(Boolean);\n  for (const segment of segments) {\n    if (segment === \".\" || segment === \"..\") {\n      throw new Error(\"Storage key prefix cannot include '.' or '..' segments\");\n    }\n  }\n\n  return segments.join(\"/\");\n};\n\nconst resolveStorageKeyFromParts = (input: {\n  fileKey: FileKeyEncoded;\n  fileKeyParts: FileKeyParts;\n}): string => {\n  const encoded = input.fileKeyParts.length > 0 ? encodeFileKey(input.fileKeyParts) : input.fileKey;\n  return encoded.length > 0 ? encoded.split(\".\").join(\"/\") : \"\";\n};\n\nconst encodePathSegments = (value: string) =>\n  value\n    .split(\"/\")\n    .map((segment) => encodeURIComponent(segment))\n    .join(\"/\");\n\nconst joinPathSegments = (...segments: (string | undefined)[]) => {\n  const trimmed = segments.filter(Boolean).map((segment) => segment!.replace(/^\\/+|\\/+$/g, \"\"));\n  return trimmed.join(\"/\");\n};\n\nconst parseHex = (value: string, expectedBytes: number) => {\n  const trimmed = value.trim();\n  if (!/^[0-9a-f]+$/i.test(trimmed) || trimmed.length !== expectedBytes * 2) {\n    return null;\n  }\n  return Buffer.from(trimmed, \"hex\");\n};\n\nconst parseBase64 = (value: string, expectedBytes: number) => {\n  const trimmed = value.trim();\n  if (!/^[A-Za-z0-9+/=]+$/.test(trimmed)) {\n    return null;\n  }\n  const buf = Buffer.from(trimmed, \"base64\");\n  if (buf.length !== expectedBytes) {\n    return null;\n  }\n  return buf;\n};\n\nconst normalizeChecksum = (checksum?: UploadChecksum | null) => {\n  if (!checksum) {\n    return null;\n  }\n\n  const expectedBytes = checksum.algo === \"md5\" ? 16 : 32;\n  const raw = checksum.value ?? \"\";\n  const buf = parseHex(raw, expectedBytes) ?? parseBase64(raw, expectedBytes);\n  if (!buf) {\n    throw new Error(\"INVALID_CHECKSUM\");\n  }\n\n  return {\n    algo: checksum.algo,\n    hex: buf.toString(\"hex\"),\n    base64: buf.toString(\"base64\"),\n  };\n};\n\nconst resolveChecksumHeaders = (checksum?: UploadChecksum | null): Record<string, string> => {\n  const normalized = normalizeChecksum(checksum);\n  if (!normalized) {\n    return {};\n  }\n\n  if (normalized.algo === \"md5\") {\n    return { \"Content-MD5\": normalized.base64 };\n  }\n\n  return { \"x-amz-checksum-sha256\": normalized.base64 };\n};\n\nconst normalizeEtag = (etag: string | null) => {\n  if (!etag) {\n    return null;\n  }\n\n  const trimmed = etag.trim().replace(/^W\\//, \"\").replace(/^\"|\"$/g, \"\");\n  if (!/^[0-9a-f]{32}$/i.test(trimmed)) {\n    return null;\n  }\n\n  return trimmed.toLowerCase();\n};\n\nconst computeChecksumFromResponse = async (\n  response: Response,\n  algo: \"md5\" | \"sha256\",\n): Promise<string> => {\n  if (!response.body) {\n    throw new Error(\"STORAGE_ERROR\");\n  }\n\n  const hash = createHash(algo);\n  const reader = response.body.getReader();\n\n  while (true) {\n    const { done, value } = await reader.read();\n    if (done) {\n      break;\n    }\n    if (value) {\n      hash.update(Buffer.from(value));\n    }\n  }\n\n  return hash.digest(\"hex\");\n};\n\nconst parseContentLength = (value: string | null) => {\n  if (!value) {\n    return null;\n  }\n  if (!/^\\d+$/.test(value)) {\n    return null;\n  }\n  return BigInt(value);\n};\n\nconst getHeaderValue = (headers: Headers, name: string) => {\n  const direct = headers.get(name);\n  if (direct !== null) {\n    return direct;\n  }\n  const target = name.toLowerCase();\n  for (const [key, value] of headers.entries()) {\n    if (key.toLowerCase() === target) {\n      return value;\n    }\n  }\n  return null;\n};\n\nconst buildObjectUrl = (input: {\n  endpoint: string;\n  bucket: string;\n  storageKey: string;\n  pathStyle: boolean;\n}) => {\n  const url = new URL(input.endpoint);\n  const encodedKey = encodePathSegments(input.storageKey);\n  const basePath = url.pathname === \"/\" ? \"\" : url.pathname.replace(/\\/+$/g, \"\");\n\n  if (input.pathStyle) {\n    const path = joinPathSegments(basePath, input.bucket, encodedKey);\n    url.pathname = path ? `/${path}` : \"/\";\n    return url;\n  }\n\n  url.hostname = `${input.bucket}.${url.hostname}`;\n  const path = joinPathSegments(basePath, encodedKey);\n  url.pathname = path ? `/${path}` : \"/\";\n  return url;\n};\n\nconst assertExpiresInSeconds = (value: number) => {\n  if (!Number.isFinite(value) || value <= 0) {\n    throw new Error(\"Expiration must be a positive number of seconds\");\n  }\n  if (value > MAX_PRESIGNED_EXPIRES_IN_SECONDS) {\n    throw new Error(\"Expiration exceeds SigV4 maximum of 7 days\");\n  }\n};\n\nconst resolveMetadataSize = (metadata?: Record<string, unknown> | null) => {\n  if (!metadata) {\n    return 0;\n  }\n\n  const serialized = JSON.stringify(metadata);\n  return Buffer.byteLength(serialized, \"utf8\");\n};\n\nconst parseUploadId = (payload: string) => {\n  const match = payload.match(/<UploadId>([^<]+)<\\/UploadId>/);\n  if (!match) {\n    return null;\n  }\n\n  return match[1];\n};\n\nconst escapeXml = (value: string) =>\n  value\n    .replace(/&/g, \"&amp;\")\n    .replace(/</g, \"&lt;\")\n    .replace(/>/g, \"&gt;\")\n    .replace(/\"/g, \"&quot;\")\n    .replace(/'/g, \"&apos;\");\n\nconst buildCompleteMultipartBody = (parts: { partNumber: number; etag: string }[]) => {\n  const sorted = [...parts].sort((a, b) => a.partNumber - b.partNumber);\n  const entries = sorted\n    .map(\n      (part) =>\n        `<Part><PartNumber>${part.partNumber}</PartNumber><ETag>${escapeXml(\n          part.etag,\n        )}</ETag></Part>`,\n    )\n    .join(\"\");\n  return `<?xml version=\"1.0\" encoding=\"UTF-8\"?><CompleteMultipartUpload>${entries}</CompleteMultipartUpload>`;\n};\n\nconst resolveMultipartPartSize = (input: {\n  sizeBytes: bigint;\n  desiredPartSizeBytes: number;\n  minPartSizeBytes: number;\n  maxPartSizeBytes: number;\n  maxParts: number;\n}) => {\n  let partSize = input.desiredPartSizeBytes;\n\n  if (partSize < input.minPartSizeBytes) {\n    partSize = input.minPartSizeBytes;\n  }\n\n  if (partSize > input.maxPartSizeBytes) {\n    throw new Error(\"Multipart part size exceeds maximum allowed size\");\n  }\n\n  const sizeNumber = Number(input.sizeBytes);\n  const minimumPartSizeForLimit = Math.ceil(sizeNumber / input.maxParts);\n\n  if (minimumPartSizeForLimit > partSize) {\n    partSize = minimumPartSizeForLimit;\n  }\n\n  if (partSize < input.minPartSizeBytes) {\n    partSize = input.minPartSizeBytes;\n  }\n\n  if (partSize > input.maxPartSizeBytes) {\n    throw new Error(\"Multipart part size exceeds maximum allowed size\");\n  }\n\n  const partCount = Math.ceil(sizeNumber / partSize);\n  if (partCount > input.maxParts) {\n    throw new Error(\"Multipart upload exceeds maximum number of parts\");\n  }\n\n  return partSize;\n};\n\nexport function createS3CompatibleStorageAdapter(\n  options: S3CompatibleStorageAdapterOptions,\n): StorageAdapter {\n  const storageKeyPrefix = normalizePrefix(options.storageKeyPrefix ?? \"\");\n  const pathStyle = options.pathStyle ?? false;\n  const maxStorageKeyLengthBytes =\n    options.maxStorageKeyLengthBytes ?? DEFAULT_MAX_STORAGE_KEY_LENGTH_BYTES;\n  const maxSingleUploadBytes = options.maxSingleUploadBytes ?? DEFAULT_MAX_SINGLE_UPLOAD_BYTES;\n  const maxMultipartUploadBytes =\n    options.maxMultipartUploadBytes ?? DEFAULT_MAX_MULTIPART_UPLOAD_BYTES;\n  const minMultipartPartSizeBytes =\n    options.minMultipartPartSizeBytes ?? DEFAULT_MIN_MULTIPART_PART_SIZE_BYTES;\n  const maxMultipartPartSizeBytes =\n    options.maxMultipartPartSizeBytes ?? DEFAULT_MAX_MULTIPART_PART_SIZE_BYTES;\n  const maxMultipartParts = options.maxMultipartParts ?? DEFAULT_MAX_MULTIPART_PARTS;\n  const uploadExpiresInSeconds =\n    options.uploadExpiresInSeconds ?? DEFAULT_UPLOAD_EXPIRES_IN_SECONDS;\n  const signedUrlExpiresInSeconds =\n    options.signedUrlExpiresInSeconds ?? DEFAULT_SIGNED_URL_EXPIRES_IN_SECONDS;\n  const directUploadThresholdBytes = options.directUploadThresholdBytes ?? maxSingleUploadBytes;\n  const multipartThresholdBytes = options.multipartThresholdBytes ?? maxSingleUploadBytes;\n  const multipartPartSizeBytes =\n    options.multipartPartSizeBytes ?? DEFAULT_MULTIPART_PART_SIZE_BYTES;\n\n  assertExpiresInSeconds(uploadExpiresInSeconds);\n  assertExpiresInSeconds(signedUrlExpiresInSeconds);\n\n  const resolveStorageKey = (input: { fileKey: FileKeyEncoded; fileKeyParts: FileKeyParts }) => {\n    const baseKey = resolveStorageKeyFromParts(input);\n    const storageKey = [storageKeyPrefix, baseKey].filter(Boolean).join(\"/\");\n\n    if (storageKey.length === 0) {\n      throw new Error(\"Storage key cannot be empty\");\n    }\n\n    if (Buffer.byteLength(storageKey, \"utf8\") > maxStorageKeyLengthBytes) {\n      throw new Error(\"Storage key exceeds maximum length\");\n    }\n\n    return storageKey;\n  };\n\n  const buildUrl = (storageKey: string, queryParams: Record<string, string | undefined> = {}) => {\n    const url = buildObjectUrl({\n      endpoint: options.endpoint,\n      bucket: options.bucket,\n      storageKey,\n      pathStyle,\n    });\n\n    for (const [key, value] of Object.entries(queryParams)) {\n      if (value === undefined) {\n        continue;\n      }\n      url.searchParams.set(key, value);\n    }\n\n    return url;\n  };\n\n  const validateMetadata = (metadata?: Record<string, unknown> | null) => {\n    if (!metadata) {\n      return;\n    }\n\n    if (options.maxMetadataBytes === undefined) {\n      return;\n    }\n\n    if (resolveMetadataSize(metadata) > options.maxMetadataBytes) {\n      throw new Error(\"Metadata exceeds maximum size\");\n    }\n  };\n\n  return {\n    name: \"s3\",\n    capabilities: {\n      directUpload: true,\n      multipartUpload: true,\n      signedDownload: true,\n      proxyUpload: false,\n    },\n    limits: {\n      maxSingleUploadBytes,\n      maxMultipartUploadBytes,\n      minMultipartPartSizeBytes,\n      maxMultipartPartSizeBytes,\n      maxMultipartParts,\n      maxStorageKeyLengthBytes,\n      maxMetadataBytes: options.maxMetadataBytes,\n    },\n    recommendations: {\n      uploadExpiresInSeconds,\n      signedUrlExpiresInSeconds,\n      directUploadThresholdBytes,\n      multipartThresholdBytes,\n      multipartPartSizeBytes,\n    },\n    resolveStorageKey,\n    initUpload: async ({ fileKey, fileKeyParts, sizeBytes, contentType, metadata, checksum }) => {\n      validateMetadata(metadata);\n      const storageKey = resolveStorageKey({ fileKey, fileKeyParts });\n\n      const expiresAt = new Date(Date.now() + uploadExpiresInSeconds * 1000);\n      const sizeNumber = Number(sizeBytes);\n\n      if (Number.isNaN(sizeNumber) || sizeNumber < 0) {\n        throw new Error(\"Upload size must be a non-negative number\");\n      }\n\n      const canMultipart = sizeNumber <= maxMultipartUploadBytes;\n      const canSingle = sizeNumber <= maxSingleUploadBytes;\n\n      if (!canMultipart) {\n        throw new Error(\"Upload exceeds maximum multipart size\");\n      }\n\n      const prefersMultipart = sizeNumber >= multipartThresholdBytes;\n      const canUseSingle = canSingle && sizeNumber <= directUploadThresholdBytes;\n\n      if (prefersMultipart || !canUseSingle) {\n        if (!canMultipart) {\n          throw new Error(\"Upload exceeds maximum multipart size\");\n        }\n\n        const partSizeBytes = resolveMultipartPartSize({\n          sizeBytes,\n          desiredPartSizeBytes: multipartPartSizeBytes,\n          minPartSizeBytes: minMultipartPartSizeBytes,\n          maxPartSizeBytes: maxMultipartPartSizeBytes,\n          maxParts: maxMultipartParts,\n        });\n\n        const createUrl = buildUrl(storageKey, { uploads: \"\" });\n        const signed = await options.signer.sign({\n          method: \"POST\",\n          url: createUrl.toString(),\n          headers: {\n            \"Content-Type\": contentType,\n          },\n        });\n\n        const response = await fetch(signed.url, {\n          method: \"POST\",\n          headers: signed.headers,\n        });\n\n        if (!response.ok) {\n          throw new Error(`Failed to create multipart upload (${response.status})`);\n        }\n\n        const payload = await response.text();\n        const uploadId = parseUploadId(payload);\n        if (!uploadId) {\n          throw new Error(\"Failed to parse multipart upload id\");\n        }\n\n        return {\n          strategy: \"direct-multipart\",\n          storageKey,\n          storageUploadId: uploadId,\n          partSizeBytes,\n          expiresAt,\n        };\n      }\n\n      if (!canSingle) {\n        throw new Error(\"Upload exceeds maximum single upload size\");\n      }\n\n      const uploadUrl = buildUrl(storageKey);\n      const checksumHeaders = resolveChecksumHeaders(checksum);\n      const signed = await options.signer.presign({\n        method: \"PUT\",\n        url: uploadUrl.toString(),\n        headers: {\n          \"Content-Type\": contentType,\n          ...checksumHeaders,\n        },\n        expiresInSeconds: uploadExpiresInSeconds,\n      });\n\n      return {\n        strategy: \"direct-single\",\n        storageKey,\n        expiresAt,\n        uploadUrl: signed.url,\n        uploadHeaders: signed.headers,\n      };\n    },\n    getPartUploadUrls: async ({ storageKey, storageUploadId, partNumbers }) => {\n      for (const partNumber of partNumbers) {\n        if (partNumber < 1 || partNumber > maxMultipartParts) {\n          throw new Error(\"INVALID_REQUEST\");\n        }\n      }\n\n      const urls = await Promise.all(\n        partNumbers.map(async (partNumber) => {\n          const url = buildUrl(storageKey, {\n            partNumber: String(partNumber),\n            uploadId: storageUploadId,\n          });\n          const signed = await options.signer.presign({\n            method: \"PUT\",\n            url: url.toString(),\n            expiresInSeconds: uploadExpiresInSeconds,\n          });\n\n          return {\n            partNumber,\n            url: signed.url,\n            headers: signed.headers,\n          };\n        }),\n      );\n\n      return urls;\n    },\n    completeMultipartUpload: async ({ storageKey, storageUploadId, parts }) => {\n      const url = buildUrl(storageKey, { uploadId: storageUploadId });\n      const body = buildCompleteMultipartBody(parts);\n      const signed = await options.signer.sign({\n        method: \"POST\",\n        url: url.toString(),\n        headers: {\n          \"Content-Type\": \"application/xml\",\n        },\n        body,\n      });\n\n      const response = await fetch(signed.url, {\n        method: \"POST\",\n        headers: signed.headers,\n        body,\n      });\n\n      if (!response.ok) {\n        throw new Error(`Failed to complete multipart upload (${response.status})`);\n      }\n\n      const etag = response.headers.get(\"ETag\") ?? undefined;\n      return { etag };\n    },\n    abortMultipartUpload: async ({ storageKey, storageUploadId }) => {\n      const url = buildUrl(storageKey, { uploadId: storageUploadId });\n      const signed = await options.signer.sign({\n        method: \"DELETE\",\n        url: url.toString(),\n      });\n\n      const response = await fetch(signed.url, {\n        method: \"DELETE\",\n        headers: signed.headers,\n      });\n\n      if (!response.ok) {\n        throw new Error(`Failed to abort multipart upload (${response.status})`);\n      }\n    },\n    finalizeUpload: async ({ storageKey, expectedSizeBytes, checksum }) => {\n      const url = buildUrl(storageKey);\n      const signed = await options.signer.sign({\n        method: \"HEAD\",\n        url: url.toString(),\n      });\n\n      const response = await fetch(signed.url, {\n        method: \"HEAD\",\n        headers: signed.headers,\n      });\n\n      if (!response.ok) {\n        throw new Error(\"STORAGE_ERROR\");\n      }\n\n      const sizeHeader = getHeaderValue(response.headers, \"content-length\");\n      const sizeBytes = parseContentLength(sizeHeader);\n      if (sizeBytes === null) {\n        throw new Error(\"STORAGE_ERROR\");\n      }\n      if (sizeBytes !== expectedSizeBytes) {\n        throw new Error(\"INVALID_CHECKSUM\");\n      }\n\n      const normalized = normalizeChecksum(checksum);\n      if (normalized) {\n        if (normalized.algo === \"md5\") {\n          const etag = normalizeEtag(getHeaderValue(response.headers, \"etag\"));\n          if (etag) {\n            if (etag !== normalized.hex) {\n              throw new Error(\"INVALID_CHECKSUM\");\n            }\n          } else {\n            const signedGet = await options.signer.sign({\n              method: \"GET\",\n              url: buildUrl(storageKey).toString(),\n            });\n            const getResponse = await fetch(signedGet.url, {\n              method: \"GET\",\n              headers: signedGet.headers,\n            });\n            if (!getResponse.ok) {\n              throw new Error(\"STORAGE_ERROR\");\n            }\n            const computed = await computeChecksumFromResponse(getResponse, \"md5\");\n            if (computed !== normalized.hex) {\n              throw new Error(\"INVALID_CHECKSUM\");\n            }\n          }\n        } else {\n          const checksumHeader = getHeaderValue(response.headers, \"x-amz-checksum-sha256\");\n          if (checksumHeader) {\n            const remote = parseBase64(checksumHeader, 32);\n            if (!remote || remote.toString(\"base64\") !== normalized.base64) {\n              throw new Error(\"INVALID_CHECKSUM\");\n            }\n          } else {\n            const signedGet = await options.signer.sign({\n              method: \"GET\",\n              url: buildUrl(storageKey).toString(),\n            });\n            const getResponse = await fetch(signedGet.url, {\n              method: \"GET\",\n              headers: signedGet.headers,\n            });\n            if (!getResponse.ok) {\n              throw new Error(\"STORAGE_ERROR\");\n            }\n            const computed = await computeChecksumFromResponse(getResponse, \"sha256\");\n            if (computed !== normalized.hex) {\n              throw new Error(\"INVALID_CHECKSUM\");\n            }\n          }\n        }\n      }\n\n      const etag = getHeaderValue(response.headers, \"etag\");\n      return { sizeBytes, etag: etag ?? undefined };\n    },\n    deleteObject: async ({ storageKey }) => {\n      const url = buildUrl(storageKey);\n      const signed = await options.signer.sign({\n        method: \"DELETE\",\n        url: url.toString(),\n      });\n\n      const response = await fetch(signed.url, {\n        method: \"DELETE\",\n        headers: signed.headers,\n      });\n\n      if (!response.ok) {\n        throw new Error(`Failed to delete object (${response.status})`);\n      }\n    },\n    getDownloadUrl: async ({ storageKey, expiresInSeconds, contentDisposition, contentType }) => {\n      assertExpiresInSeconds(expiresInSeconds);\n\n      const url = buildUrl(storageKey, {\n        \"response-content-disposition\": contentDisposition,\n        \"response-content-type\": contentType,\n      });\n\n      const signed = await options.signer.presign({\n        method: \"GET\",\n        url: url.toString(),\n        expiresInSeconds,\n      });\n\n      return {\n        url: signed.url,\n        headers: signed.headers,\n        expiresAt: new Date(Date.now() + expiresInSeconds * 1000),\n      };\n    },\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"s3.js","names":["path","signed"],"sources":["../../../src/storage/s3.ts"],"sourcesContent":["import { createHash } from \"node:crypto\";\n\nimport { assertFileKey } from \"../file-key\";\nimport { appendStorageObjectKeyVersionSegment } from \"./object-key\";\nimport type { StorageAdapter, UploadChecksum } from \"./types\";\n\nconst BYTES_IN_MIB = 1024 * 1024;\nconst BYTES_IN_GIB = 1024 * BYTES_IN_MIB;\nconst BYTES_IN_TIB = 1024 * BYTES_IN_GIB;\n\nconst DEFAULT_MAX_SINGLE_UPLOAD_BYTES = 5 * BYTES_IN_GIB;\nconst DEFAULT_MAX_MULTIPART_UPLOAD_BYTES = 5 * BYTES_IN_TIB;\nconst DEFAULT_MIN_MULTIPART_PART_SIZE_BYTES = 5 * BYTES_IN_MIB;\nconst DEFAULT_MAX_MULTIPART_PART_SIZE_BYTES = 5 * BYTES_IN_GIB;\nconst DEFAULT_MAX_MULTIPART_PARTS = 10_000;\nconst DEFAULT_MAX_STORAGE_KEY_LENGTH_BYTES = 1024;\nconst DEFAULT_UPLOAD_EXPIRES_IN_SECONDS = 60 * 60;\nconst DEFAULT_SIGNED_URL_EXPIRES_IN_SECONDS = 60 * 60;\nconst DEFAULT_MULTIPART_PART_SIZE_BYTES = 8 * BYTES_IN_MIB;\nconst MAX_PRESIGNED_EXPIRES_IN_SECONDS = 60 * 60 * 24 * 7;\n\nexport type S3SignerInput = {\n  method: string;\n  url: string;\n  headers?: Record<string, string>;\n  body?: string | Uint8Array | null;\n  expiresInSeconds?: number;\n};\n\nexport type S3Signer = {\n  sign: (input: S3SignerInput) => Promise<{ url: string; headers: Record<string, string> }>;\n  presign: (input: S3SignerInput) => Promise<{ url: string; headers?: Record<string, string> }>;\n};\n\nexport type S3CompatibleStorageAdapterOptions = {\n  bucket: string;\n  endpoint: string;\n  signer: S3Signer;\n  storageKeyPrefix?: string;\n  pathStyle?: boolean;\n  uploadExpiresInSeconds?: number;\n  signedUrlExpiresInSeconds?: number;\n  directUploadThresholdBytes?: number;\n  multipartThresholdBytes?: number;\n  multipartPartSizeBytes?: number;\n  maxSingleUploadBytes?: number;\n  maxMultipartUploadBytes?: number;\n  minMultipartPartSizeBytes?: number;\n  maxMultipartPartSizeBytes?: number;\n  maxMultipartParts?: number;\n  maxStorageKeyLengthBytes?: number;\n  maxMetadataBytes?: number;\n};\n\nconst normalizePrefix = (prefix: string): string => {\n  if (!prefix) {\n    return \"\";\n  }\n\n  const segments = prefix.split(\"/\").filter(Boolean);\n  for (const segment of segments) {\n    if (segment === \".\" || segment === \"..\") {\n      throw new Error(\"Storage key prefix cannot include '.' or '..' segments\");\n    }\n  }\n\n  return segments.join(\"/\");\n};\n\nconst normalizeProvider = (provider: string): string => {\n  const normalized = provider.trim();\n  if (\n    normalized.length === 0 ||\n    normalized === \".\" ||\n    normalized === \"..\" ||\n    normalized.includes(\"/\") ||\n    normalized.includes(\"\\\\\")\n  ) {\n    throw new Error(\"Invalid provider\");\n  }\n\n  return normalized;\n};\n\nconst encodePathSegments = (value: string) =>\n  value\n    .split(\"/\")\n    .map((segment) => encodeURIComponent(segment))\n    .join(\"/\");\n\nconst joinPathSegments = (...segments: (string | undefined)[]) => {\n  const trimmed = segments.filter(Boolean).map((segment) => segment!.replace(/^\\/+|\\/+$/g, \"\"));\n  return trimmed.join(\"/\");\n};\n\nconst parseHex = (value: string, expectedBytes: number) => {\n  const trimmed = value.trim();\n  if (!/^[0-9a-f]+$/i.test(trimmed) || trimmed.length !== expectedBytes * 2) {\n    return null;\n  }\n  return Buffer.from(trimmed, \"hex\");\n};\n\nconst parseBase64 = (value: string, expectedBytes: number) => {\n  const trimmed = value.trim();\n  if (!/^[A-Za-z0-9+/=]+$/.test(trimmed)) {\n    return null;\n  }\n  const buf = Buffer.from(trimmed, \"base64\");\n  if (buf.length !== expectedBytes) {\n    return null;\n  }\n  return buf;\n};\n\nconst normalizeChecksum = (checksum?: UploadChecksum | null) => {\n  if (!checksum) {\n    return null;\n  }\n\n  const expectedBytes = checksum.algo === \"md5\" ? 16 : 32;\n  const raw = checksum.value ?? \"\";\n  const buf = parseHex(raw, expectedBytes) ?? parseBase64(raw, expectedBytes);\n  if (!buf) {\n    throw new Error(\"INVALID_CHECKSUM\");\n  }\n\n  return {\n    algo: checksum.algo,\n    hex: buf.toString(\"hex\"),\n    base64: buf.toString(\"base64\"),\n  };\n};\n\nconst resolveChecksumHeaders = (checksum?: UploadChecksum | null): Record<string, string> => {\n  const normalized = normalizeChecksum(checksum);\n  if (!normalized) {\n    return {};\n  }\n\n  if (normalized.algo === \"md5\") {\n    return { \"Content-MD5\": normalized.base64 };\n  }\n\n  return { \"x-amz-checksum-sha256\": normalized.base64 };\n};\n\nconst normalizeEtag = (etag: string | null) => {\n  if (!etag) {\n    return null;\n  }\n\n  const trimmed = etag.trim().replace(/^W\\//, \"\").replace(/^\"|\"$/g, \"\");\n  if (!/^[0-9a-f]{32}$/i.test(trimmed)) {\n    return null;\n  }\n\n  return trimmed.toLowerCase();\n};\n\nconst computeChecksumFromResponse = async (\n  response: Response,\n  algo: \"md5\" | \"sha256\",\n): Promise<string> => {\n  if (!response.body) {\n    throw new Error(\"STORAGE_ERROR\");\n  }\n\n  const hash = createHash(algo);\n  const reader = response.body.getReader();\n\n  while (true) {\n    const { done, value } = await reader.read();\n    if (done) {\n      break;\n    }\n    if (value) {\n      hash.update(Buffer.from(value));\n    }\n  }\n\n  return hash.digest(\"hex\");\n};\n\nconst parseContentLength = (value: string | null) => {\n  if (!value) {\n    return null;\n  }\n  if (!/^\\d+$/.test(value)) {\n    return null;\n  }\n  return BigInt(value);\n};\n\nconst getHeaderValue = (headers: Headers, name: string) => {\n  const direct = headers.get(name);\n  if (direct !== null) {\n    return direct;\n  }\n  const target = name.toLowerCase();\n  for (const [key, value] of headers.entries()) {\n    if (key.toLowerCase() === target) {\n      return value;\n    }\n  }\n  return null;\n};\n\nconst buildObjectUrl = (input: {\n  endpoint: string;\n  bucket: string;\n  storageKey: string;\n  pathStyle: boolean;\n}) => {\n  const url = new URL(input.endpoint);\n  const encodedKey = encodePathSegments(input.storageKey);\n  const basePath = url.pathname === \"/\" ? \"\" : url.pathname.replace(/\\/+$/g, \"\");\n\n  if (input.pathStyle) {\n    const path = joinPathSegments(basePath, input.bucket, encodedKey);\n    url.pathname = path ? `/${path}` : \"/\";\n    return url;\n  }\n\n  url.hostname = `${input.bucket}.${url.hostname}`;\n  const path = joinPathSegments(basePath, encodedKey);\n  url.pathname = path ? `/${path}` : \"/\";\n  return url;\n};\n\nconst assertExpiresInSeconds = (value: number) => {\n  if (!Number.isFinite(value) || value <= 0) {\n    throw new Error(\"Expiration must be a positive number of seconds\");\n  }\n  if (value > MAX_PRESIGNED_EXPIRES_IN_SECONDS) {\n    throw new Error(\"Expiration exceeds SigV4 maximum of 7 days\");\n  }\n};\n\nconst resolveMetadataSize = (metadata?: Record<string, unknown> | null) => {\n  if (!metadata) {\n    return 0;\n  }\n\n  const serialized = JSON.stringify(metadata);\n  return Buffer.byteLength(serialized, \"utf8\");\n};\n\nconst parseUploadId = (payload: string) => {\n  const match = payload.match(/<UploadId>([^<]+)<\\/UploadId>/);\n  if (!match) {\n    return null;\n  }\n\n  return match[1];\n};\n\nconst escapeXml = (value: string) =>\n  value\n    .replace(/&/g, \"&amp;\")\n    .replace(/</g, \"&lt;\")\n    .replace(/>/g, \"&gt;\")\n    .replace(/\"/g, \"&quot;\")\n    .replace(/'/g, \"&apos;\");\n\nconst buildCompleteMultipartBody = (parts: { partNumber: number; etag: string }[]) => {\n  const sorted = [...parts].sort((a, b) => a.partNumber - b.partNumber);\n  const entries = sorted\n    .map(\n      (part) =>\n        `<Part><PartNumber>${part.partNumber}</PartNumber><ETag>${escapeXml(\n          part.etag,\n        )}</ETag></Part>`,\n    )\n    .join(\"\");\n  return `<?xml version=\"1.0\" encoding=\"UTF-8\"?><CompleteMultipartUpload>${entries}</CompleteMultipartUpload>`;\n};\n\nconst resolveMultipartPartSize = (input: {\n  sizeBytes: bigint;\n  desiredPartSizeBytes: number;\n  minPartSizeBytes: number;\n  maxPartSizeBytes: number;\n  maxParts: number;\n}) => {\n  let partSize = input.desiredPartSizeBytes;\n\n  if (partSize < input.minPartSizeBytes) {\n    partSize = input.minPartSizeBytes;\n  }\n\n  if (partSize > input.maxPartSizeBytes) {\n    throw new Error(\"Multipart part size exceeds maximum allowed size\");\n  }\n\n  const sizeNumber = Number(input.sizeBytes);\n  const minimumPartSizeForLimit = Math.ceil(sizeNumber / input.maxParts);\n\n  if (minimumPartSizeForLimit > partSize) {\n    partSize = minimumPartSizeForLimit;\n  }\n\n  if (partSize < input.minPartSizeBytes) {\n    partSize = input.minPartSizeBytes;\n  }\n\n  if (partSize > input.maxPartSizeBytes) {\n    throw new Error(\"Multipart part size exceeds maximum allowed size\");\n  }\n\n  const partCount = Math.ceil(sizeNumber / partSize);\n  if (partCount > input.maxParts) {\n    throw new Error(\"Multipart upload exceeds maximum number of parts\");\n  }\n\n  return partSize;\n};\n\nexport function createS3CompatibleStorageAdapter(\n  options: S3CompatibleStorageAdapterOptions,\n): StorageAdapter {\n  const storageKeyPrefix = normalizePrefix(options.storageKeyPrefix ?? \"\");\n  const pathStyle = options.pathStyle ?? false;\n  const maxStorageKeyLengthBytes =\n    options.maxStorageKeyLengthBytes ?? DEFAULT_MAX_STORAGE_KEY_LENGTH_BYTES;\n  const maxSingleUploadBytes = options.maxSingleUploadBytes ?? DEFAULT_MAX_SINGLE_UPLOAD_BYTES;\n  const maxMultipartUploadBytes =\n    options.maxMultipartUploadBytes ?? DEFAULT_MAX_MULTIPART_UPLOAD_BYTES;\n  const minMultipartPartSizeBytes =\n    options.minMultipartPartSizeBytes ?? DEFAULT_MIN_MULTIPART_PART_SIZE_BYTES;\n  const maxMultipartPartSizeBytes =\n    options.maxMultipartPartSizeBytes ?? DEFAULT_MAX_MULTIPART_PART_SIZE_BYTES;\n  const maxMultipartParts = options.maxMultipartParts ?? DEFAULT_MAX_MULTIPART_PARTS;\n  const uploadExpiresInSeconds =\n    options.uploadExpiresInSeconds ?? DEFAULT_UPLOAD_EXPIRES_IN_SECONDS;\n  const signedUrlExpiresInSeconds =\n    options.signedUrlExpiresInSeconds ?? DEFAULT_SIGNED_URL_EXPIRES_IN_SECONDS;\n  const directUploadThresholdBytes = options.directUploadThresholdBytes ?? maxSingleUploadBytes;\n  const multipartThresholdBytes = options.multipartThresholdBytes ?? maxSingleUploadBytes;\n  const multipartPartSizeBytes =\n    options.multipartPartSizeBytes ?? DEFAULT_MULTIPART_PART_SIZE_BYTES;\n\n  assertExpiresInSeconds(uploadExpiresInSeconds);\n  assertExpiresInSeconds(signedUrlExpiresInSeconds);\n\n  const resolveStorageKey = (input: { provider: string; fileKey: string }) => {\n    const provider = normalizeProvider(input.provider);\n    const fileKey = assertFileKey(input.fileKey);\n    const storageKey = [storageKeyPrefix, provider, fileKey].filter(Boolean).join(\"/\");\n\n    if (storageKey.length === 0) {\n      throw new Error(\"Storage key cannot be empty\");\n    }\n\n    if (Buffer.byteLength(storageKey, \"utf8\") > maxStorageKeyLengthBytes) {\n      throw new Error(\"Storage key exceeds maximum length\");\n    }\n\n    return storageKey;\n  };\n\n  const buildUrl = (storageKey: string, queryParams: Record<string, string | undefined> = {}) => {\n    const url = buildObjectUrl({\n      endpoint: options.endpoint,\n      bucket: options.bucket,\n      storageKey,\n      pathStyle,\n    });\n\n    for (const [key, value] of Object.entries(queryParams)) {\n      if (value === undefined) {\n        continue;\n      }\n      url.searchParams.set(key, value);\n    }\n\n    return url;\n  };\n\n  const validateMetadata = (metadata?: Record<string, unknown> | null) => {\n    if (!metadata) {\n      return;\n    }\n\n    if (options.maxMetadataBytes === undefined) {\n      return;\n    }\n\n    if (resolveMetadataSize(metadata) > options.maxMetadataBytes) {\n      throw new Error(\"Metadata exceeds maximum size\");\n    }\n  };\n\n  return {\n    name: \"s3\",\n    capabilities: {\n      directUpload: true,\n      multipartUpload: true,\n      signedDownload: true,\n      proxyUpload: false,\n    },\n    limits: {\n      maxSingleUploadBytes,\n      maxMultipartUploadBytes,\n      minMultipartPartSizeBytes,\n      maxMultipartPartSizeBytes,\n      maxMultipartParts,\n      maxStorageKeyLengthBytes,\n      maxMetadataBytes: options.maxMetadataBytes,\n    },\n    recommendations: {\n      uploadExpiresInSeconds,\n      signedUrlExpiresInSeconds,\n      directUploadThresholdBytes,\n      multipartThresholdBytes,\n      multipartPartSizeBytes,\n    },\n    resolveStorageKey,\n    initUpload: async ({\n      provider,\n      fileKey,\n      sizeBytes,\n      contentType,\n      metadata,\n      checksum,\n      objectKeyVersionSegment,\n    }) => {\n      validateMetadata(metadata);\n      const storageKey = appendStorageObjectKeyVersionSegment(\n        resolveStorageKey({ provider, fileKey }),\n        objectKeyVersionSegment,\n        maxStorageKeyLengthBytes,\n      );\n\n      const expiresAt = new Date(Date.now() + uploadExpiresInSeconds * 1000);\n      const sizeNumber = Number(sizeBytes);\n\n      if (Number.isNaN(sizeNumber) || sizeNumber < 0) {\n        throw new Error(\"Upload size must be a non-negative number\");\n      }\n\n      const canMultipart = sizeNumber <= maxMultipartUploadBytes;\n      const canSingle = sizeNumber <= maxSingleUploadBytes;\n\n      if (!canMultipart) {\n        throw new Error(\"Upload exceeds maximum multipart size\");\n      }\n\n      const prefersMultipart = sizeNumber >= multipartThresholdBytes;\n      const canUseSingle = canSingle && sizeNumber <= directUploadThresholdBytes;\n\n      if (prefersMultipart || !canUseSingle) {\n        if (!canMultipart) {\n          throw new Error(\"Upload exceeds maximum multipart size\");\n        }\n\n        const partSizeBytes = resolveMultipartPartSize({\n          sizeBytes,\n          desiredPartSizeBytes: multipartPartSizeBytes,\n          minPartSizeBytes: minMultipartPartSizeBytes,\n          maxPartSizeBytes: maxMultipartPartSizeBytes,\n          maxParts: maxMultipartParts,\n        });\n\n        const createUrl = buildUrl(storageKey, { uploads: \"\" });\n        const signed = await options.signer.sign({\n          method: \"POST\",\n          url: createUrl.toString(),\n          headers: {\n            \"Content-Type\": contentType,\n          },\n        });\n\n        const response = await fetch(signed.url, {\n          method: \"POST\",\n          headers: signed.headers,\n        });\n\n        if (!response.ok) {\n          throw new Error(`Failed to create multipart upload (${response.status})`);\n        }\n\n        const payload = await response.text();\n        const uploadId = parseUploadId(payload);\n        if (!uploadId) {\n          throw new Error(\"Failed to parse multipart upload id\");\n        }\n\n        return {\n          strategy: \"direct-multipart\",\n          storageKey,\n          storageUploadId: uploadId,\n          partSizeBytes,\n          expiresAt,\n        };\n      }\n\n      if (!canSingle) {\n        throw new Error(\"Upload exceeds maximum single upload size\");\n      }\n\n      const uploadUrl = buildUrl(storageKey);\n      const checksumHeaders = resolveChecksumHeaders(checksum);\n      const signed = await options.signer.presign({\n        method: \"PUT\",\n        url: uploadUrl.toString(),\n        headers: {\n          \"Content-Type\": contentType,\n          ...checksumHeaders,\n        },\n        expiresInSeconds: uploadExpiresInSeconds,\n      });\n\n      return {\n        strategy: \"direct-single\",\n        storageKey,\n        expiresAt,\n        uploadUrl: signed.url,\n        uploadHeaders: signed.headers,\n      };\n    },\n    getPartUploadUrls: async ({ storageKey, storageUploadId, partNumbers }) => {\n      for (const partNumber of partNumbers) {\n        if (partNumber < 1 || partNumber > maxMultipartParts) {\n          throw new Error(\"INVALID_REQUEST\");\n        }\n      }\n\n      const urls = await Promise.all(\n        partNumbers.map(async (partNumber) => {\n          const url = buildUrl(storageKey, {\n            partNumber: String(partNumber),\n            uploadId: storageUploadId,\n          });\n          const signed = await options.signer.presign({\n            method: \"PUT\",\n            url: url.toString(),\n            expiresInSeconds: uploadExpiresInSeconds,\n          });\n\n          return {\n            partNumber,\n            url: signed.url,\n            headers: signed.headers,\n          };\n        }),\n      );\n\n      return urls;\n    },\n    completeMultipartUpload: async ({ storageKey, storageUploadId, parts }) => {\n      const url = buildUrl(storageKey, { uploadId: storageUploadId });\n      const body = buildCompleteMultipartBody(parts);\n      const signed = await options.signer.sign({\n        method: \"POST\",\n        url: url.toString(),\n        headers: {\n          \"Content-Type\": \"application/xml\",\n        },\n        body,\n      });\n\n      const response = await fetch(signed.url, {\n        method: \"POST\",\n        headers: signed.headers,\n        body,\n      });\n\n      if (!response.ok) {\n        throw new Error(`Failed to complete multipart upload (${response.status})`);\n      }\n\n      const etag = response.headers.get(\"ETag\") ?? undefined;\n      return { etag };\n    },\n    abortMultipartUpload: async ({ storageKey, storageUploadId }) => {\n      const url = buildUrl(storageKey, { uploadId: storageUploadId });\n      const signed = await options.signer.sign({\n        method: \"DELETE\",\n        url: url.toString(),\n      });\n\n      const response = await fetch(signed.url, {\n        method: \"DELETE\",\n        headers: signed.headers,\n      });\n\n      if (!response.ok) {\n        throw new Error(`Failed to abort multipart upload (${response.status})`);\n      }\n    },\n    finalizeUpload: async ({ storageKey, expectedSizeBytes, checksum }) => {\n      const url = buildUrl(storageKey);\n      const signed = await options.signer.sign({\n        method: \"HEAD\",\n        url: url.toString(),\n      });\n\n      const response = await fetch(signed.url, {\n        method: \"HEAD\",\n        headers: signed.headers,\n      });\n\n      if (!response.ok) {\n        throw new Error(\"STORAGE_ERROR\");\n      }\n\n      const sizeHeader = getHeaderValue(response.headers, \"content-length\");\n      const sizeBytes = parseContentLength(sizeHeader);\n      if (sizeBytes === null) {\n        throw new Error(\"STORAGE_ERROR\");\n      }\n      if (sizeBytes !== expectedSizeBytes) {\n        throw new Error(\"INVALID_CHECKSUM\");\n      }\n\n      const normalized = normalizeChecksum(checksum);\n      if (normalized) {\n        if (normalized.algo === \"md5\") {\n          const etag = normalizeEtag(getHeaderValue(response.headers, \"etag\"));\n          if (etag) {\n            if (etag !== normalized.hex) {\n              throw new Error(\"INVALID_CHECKSUM\");\n            }\n          } else {\n            const signedGet = await options.signer.sign({\n              method: \"GET\",\n              url: buildUrl(storageKey).toString(),\n            });\n            const getResponse = await fetch(signedGet.url, {\n              method: \"GET\",\n              headers: signedGet.headers,\n            });\n            if (!getResponse.ok) {\n              throw new Error(\"STORAGE_ERROR\");\n            }\n            const computed = await computeChecksumFromResponse(getResponse, \"md5\");\n            if (computed !== normalized.hex) {\n              throw new Error(\"INVALID_CHECKSUM\");\n            }\n          }\n        } else {\n          const checksumHeader = getHeaderValue(response.headers, \"x-amz-checksum-sha256\");\n          if (checksumHeader) {\n            const remote = parseBase64(checksumHeader, 32);\n            if (!remote || remote.toString(\"base64\") !== normalized.base64) {\n              throw new Error(\"INVALID_CHECKSUM\");\n            }\n          } else {\n            const signedGet = await options.signer.sign({\n              method: \"GET\",\n              url: buildUrl(storageKey).toString(),\n            });\n            const getResponse = await fetch(signedGet.url, {\n              method: \"GET\",\n              headers: signedGet.headers,\n            });\n            if (!getResponse.ok) {\n              throw new Error(\"STORAGE_ERROR\");\n            }\n            const computed = await computeChecksumFromResponse(getResponse, \"sha256\");\n            if (computed !== normalized.hex) {\n              throw new Error(\"INVALID_CHECKSUM\");\n            }\n          }\n        }\n      }\n\n      const etag = getHeaderValue(response.headers, \"etag\");\n      return { sizeBytes, etag: etag ?? undefined };\n    },\n    deleteObject: async ({ storageKey }) => {\n      const url = buildUrl(storageKey);\n      const signed = await options.signer.sign({\n        method: \"DELETE\",\n        url: url.toString(),\n      });\n\n      const response = await fetch(signed.url, {\n        method: \"DELETE\",\n        headers: signed.headers,\n      });\n\n      if (!response.ok) {\n        throw new Error(`Failed to delete object (${response.status})`);\n      }\n    },\n    getDownloadUrl: async ({ storageKey, expiresInSeconds, contentDisposition, contentType }) => {\n      assertExpiresInSeconds(expiresInSeconds);\n\n      const url = buildUrl(storageKey, {\n        \"response-content-disposition\": contentDisposition,\n        \"response-content-type\": contentType,\n      });\n\n      const signed = await options.signer.presign({\n        method: \"GET\",\n        url: url.toString(),\n        expiresInSeconds,\n      });\n\n      return {\n        url: signed.url,\n        headers: signed.headers,\n        expiresAt: new Date(Date.now() + expiresInSeconds * 1000),\n      };\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/node/storage/types.d.ts

@@ -1,4 +1,4 @@
-import { FileKeyEncoded, FileKeyParts } from "../keys.js";
+import { FileKey } from "../file-key.js";
 
 //#region src/storage/types.d.ts
 type UploadTransport = "direct" | "proxy";
@@ -35,16 +35,17 @@ interface StorageAdapter {
   limits?: StorageAdapterLimits;
   recommendations?: StorageAdapterRecommendations;
   resolveStorageKey(input: {
-    fileKey: FileKeyEncoded;
-    fileKeyParts: FileKeyParts;
+    provider: string;
+    fileKey: FileKey;
   }): string;
   initUpload(input: {
-    fileKey: FileKeyEncoded;
-    fileKeyParts: FileKeyParts;
+    provider: string;
+    fileKey: FileKey;
     sizeBytes: bigint;
     contentType: string;
     checksum?: UploadChecksum | null;
     metadata?: Record<string, unknown> | null;
+    objectKeyVersionSegment?: string;
   }): Promise<{
     strategy: "direct-single" | "direct-multipart" | "proxy";
     storageKey: string;

package/dist/node/storage/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","names":[],"sources":["../../../src/storage/types.ts"],"sourcesContent":[],"mappings":";;;KAEY,eAAA;KACA,UAAA;AADA,UAGK,0BAAA,CAHU;EACf,YAAA,EAAU,OAAA;EAEL,eAAA,EAAA,OAAA;EAOL,cAAA,EAAA,OAAc;EAET,WAAA,EAAA,OAAA;AAUjB;AAQiB,KApBL,cAAA,GAoBmB;EAAA,IAAA,EAAA,QAAA,GAAA,KAAA;OAEf,EAAA,MAAA;;AAEI,UAtBH,oBAAA,CAsBG;sBAGkB,CAAA,EAAA,MAAA;yBAA8B,CAAA,EAAA,MAAA;2BAIvD,CAAA,EAAA,MAAA;2BACK,CAAA,EAAA,MAAA;mBAGH,CAAA,EAAA,MAAA;0BACA,CAAA,EAAA,MAAA;kBAMA,CAAA,EAAA,MAAA;;AALT,UAzBW,6BAAA,CAyBX;wBAgBqD,CAAA,EAAA,MAAA;2BAArD,CAAA,EAAA,MAAA;4BAOA,CAAA,EAAA,MAAA;yBAG2E,CAAA,EAAA,MAAA;wBAKxD,CAAA,EAAA,MAAA;;AAGnB,UAnDW,cAAA,CAmDX;MAMS,EAAA,MAAA;cACT,EAxDU,0BAwDV;QAGyC,CAAA,EA1DpC,oBA0DoC;iBAQR,CAAA,EAjEnB,6BAiEmB;mBAAmC,CAAA,KAAA,EAAA;IAApE,OAAA,EA9DgC,cA8DhC;IAEuD,YAAA,EAhEO,YAgEP;MAAR,MAAA;EAAO,UAAA,CAAA,KAAA,EAAA;aA5D/C;kBACK;;;eAGH;eACA;MACT;;;;;eAKS;;oBAEK;;;;;;;MASd;;;cAAqD;;;;;;;;;MAOrD;;;;;;MAG2E;;;UAKvE,eAAe;;;MAGnB;;;;;;;eAMS;MACT;;;;;;MAGyC;;;;;;MAQzC;;cAAiC;eAAmC;;;;MAErB,QAAQ"}
+{"version":3,"file":"types.d.ts","names":[],"sources":["../../../src/storage/types.ts"],"sourcesContent":[],"mappings":";;;KAEY,eAAA;KACA,UAAA;AADA,UAGK,0BAAA,CAHU;EACf,YAAA,EAAU,OAAA;EAEL,eAAA,EAAA,OAAA;EAOL,cAAA,EAAA,OAAc;EAET,WAAA,EAAA,OAAA;AAUjB;AAQiB,KApBL,cAAA,GAoBmB;EAAA,IAAA,EAAA,QAAA,GAAA,KAAA;OAEf,EAAA,MAAA;;AAEI,UAtBH,oBAAA,CAsBG;sBAGoC,CAAA,EAAA,MAAA;yBAM3C,CAAA,EAAA,MAAA;2BAGE,CAAA,EAAA,MAAA;2BACA,CAAA,EAAA,MAAA;mBAOA,CAAA,EAAA,MAAA;0BAEK,CAAA,EAAA,MAAA;kBAPd,CAAA,EAAA,MAAA;;AAgBA,UA3CW,6BAAA,CA2CX;wBAOA,CAAA,EAAA,MAAA;2BAG2E,CAAA,EAAA,MAAA;4BAKxD,CAAA,EAAA,MAAA;yBAAf,CAAA,EAAA,MAAA;wBAGJ,CAAA,EAAA,MAAA;;AAOA,UA5DW,cAAA,CA4DX;MAGyC,EAAA,MAAA;cAUjC,EAvEE,0BAuEF;QACC,CAAA,EAvEJ,oBAuEI;iBAHT,CAAA,EAnEc,6BAmEd;mBAMuD,CAAA,KAAA,EAAA;IAAR,QAAA,EAAA,MAAA;IAAO,OAAA,EAtEJ,OAsEI;;;;aAhE/C;;;eAGE;eACA;;MAET;;;;;eAKS;;oBAEK;;;;;;;MASd;;;cAAqD;;;;;;;;;MAOrD;;;;;;MAG2E;;;UAKvE,eAAe;;;MAGnB;;;;;;;eAMS;MACT;;;;;;MAGyC;;;;;;MAQzC;;cAEQ;eACC;;;;MAGsC,QAAQ"}

package/dist/node/types.d.ts

@@ -5,7 +5,6 @@ type UploadStatus = "created" | "in_progress" | "completed" | "aborted" | "faile
 type UploadStrategy = "direct-single" | "direct-multipart" | "proxy";
 type FileMetadata = {
   fileKey: string;
-  fileKeyParts: (string | number)[];
   uploaderId: string | null;
   filename: string;
   sizeBytes: number;
@@ -18,7 +17,7 @@ type FileMetadata = {
   tags: string[] | null;
   metadata: Record<string, unknown> | null;
   status: FileStatus;
-  storageProvider: string;
+  provider: string;
   createdAt: string;
   updatedAt: string;
   completedAt: string | null;

package/dist/node/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","names":[],"sources":["../../src/types.ts"],"sourcesContent":[],"mappings":";KAAY,cAAA;AAAA,KAEA,UAAA,GAFc,OAAA,GAAA,SAAA;AAEd,KAEA,YAAA,GAFU,SAAA,GAAA,aAAA,GAAA,WAAA,GAAA,SAAA,GAAA,QAAA,GAAA,SAAA;AAEV,KAQA,cAAA,GARY,eAAA,GAAA,kBAAA,GAAA,OAAA;AAQZ,KAEA,YAAA,GAFc;EAEd,OAAA,EAAA,MAAY;EAAA,YAAA,EAAA,CAAA,MAAA,GAAA,MAAA,CAAA,EAAA;YAQV,EAAA,MAAA,GAAA,IAAA;UAEF,EAAA,MAAA;WACF,EAAA,MAAA;EAAU,WAAA,EAAA,MAAA;;;;;cAHN;;YAEF;UACF"}
+{"version":3,"file":"types.d.ts","names":[],"sources":["../../src/types.ts"],"sourcesContent":[],"mappings":";KAAY,cAAA;AAAA,KAEA,UAAA,GAFc,OAAA,GAAA,SAAA;AAEd,KAEA,YAAA,GAFU,SAAA,GAAA,aAAA,GAAA,WAAA,GAAA,SAAA,GAAA,QAAA,GAAA,SAAA;AAEV,KAQA,cAAA,GARY,eAAA,GAAA,kBAAA,GAAA,OAAA;AAQZ,KAEA,YAAA,GAFc;EAEd,OAAA,EAAA,MAAY;EAAA,UAAA,EAAA,MAAA,GAAA,IAAA;UAOV,EAAA,MAAA;WAEF,EAAA,MAAA;aACF,EAAA,MAAA;EAAU,QAAA,EAAA;;;;cAHN;;YAEF;UACF"}