@backblaze-labs/b2-sdk 0.1.0 → 0.2.0

package/dist/simulator/validation.js

@@ -1,174 +1,200 @@
 import { utf8Encoder } from "../util/text-codec.js";
-const BUCKET_NAME_MIN = 6;
-const BUCKET_NAME_MAX = 63;
-const BUCKET_NAME_REGEX = /^[a-zA-Z0-9][a-zA-Z0-9-]*[a-zA-Z0-9]$/;
-const BUCKET_NAME_RESERVED_PREFIX = "b2-";
+import { BUCKET_NAME_MAX, BUCKET_NAME_MIN, FILE_NAME_MAX_BYTES, getB2FileNameByteLength, hasB2FileNameControlCharacter, hasValidB2BucketNameShape, isB2BucketNameIpv4Address } from "../internal/b2-naming.js";
+//#region src/simulator/validation.ts
+/**
+* B2 spec-compliance validation helpers for the simulator.
+*
+* Each function mirrors a documented B2 input limit (file name length,
+* bucket name regex, file-info byte budget, etc.). Validators return
+* `null` for valid input or a `{ code, message }` pair that the handler
+* converts into a synthetic `400`/`403` response with the right B2
+* error code.
+*
+* Keeping validation in one module makes the simulator's "what does B2
+* reject?" surface auditable in a single file. Doc references inline at
+* each rule so the spec source is immediate.
+*
+* @packageDocumentation
+*/
+/**
+* Validates a bucket name against B2's documented rules.
+*
+* @param name - Caller-supplied bucket name.
+*
+* @returns A `{ code, message }` pair on failure, or `null` when valid.
+*
+* @see https://www.backblaze.com/apidocs/b2-create-bucket
+*/
 function validateBucketName(name) {
-  if (typeof name !== "string" || name.length < BUCKET_NAME_MIN || name.length > BUCKET_NAME_MAX) {
-    return {
-      code: "invalid_bucket_name",
-      message: `bucketName must be ${BUCKET_NAME_MIN}-${BUCKET_NAME_MAX} characters`
-    };
-  }
-  if (!BUCKET_NAME_REGEX.test(name)) {
-    return {
-      code: "invalid_bucket_name",
-      message: "bucketName must contain only letters, digits, and hyphens; cannot start or end with a hyphen"
-    };
-  }
-  if (name.startsWith(BUCKET_NAME_RESERVED_PREFIX)) {
-    return {
-      code: "invalid_bucket_name",
-      message: `bucketName cannot start with the reserved prefix "${BUCKET_NAME_RESERVED_PREFIX}"`
-    };
-  }
-  return null;
+	if (typeof name !== "string" || name.length < 6 || name.length > 63) return {
+		code: "invalid_bucket_name",
+		message: `bucketName must be 6-63 characters`
+	};
+	if (isB2BucketNameIpv4Address(name)) return {
+		code: "invalid_bucket_name",
+		message: "bucketName must not be formatted as an IPv4 address"
+	};
+	if (!hasValidB2BucketNameShape(name)) return {
+		code: "invalid_bucket_name",
+		message: "bucketName must contain only letters, digits, hyphens, and periods; cannot start or end with punctuation or contain consecutive periods"
+	};
+	if (name.startsWith("b2-")) return {
+		code: "invalid_bucket_name",
+		message: `bucketName cannot start with the reserved prefix "b2-"`
+	};
+	return null;
 }
-const FILE_NAME_MAX_BYTES = 1024;
-const FILE_NAME_DEL = 127;
+/**
+* Validates a file name against B2's documented rules. Mirrors the
+* server-side checks B2 runs on `b2_upload_file` / `b2_hide_file` /
+* `b2_start_large_file` / `b2_copy_file` filename inputs.
+*
+* @param name - Caller-supplied file name (raw, unencoded).
+*
+* @returns A `{ code, message }` pair on failure, or `null` when valid.
+*
+* @see https://www.backblaze.com/apidocs/b2-upload-file
+*/
 function validateFileName(name) {
-  if (typeof name !== "string" || name.length === 0) {
-    return { code: "invalid_file_name", message: "fileName must be a non-empty string" };
-  }
-  const bytes = utf8Encoder.encode(name);
-  if (bytes.byteLength > FILE_NAME_MAX_BYTES) {
-    return {
-      code: "invalid_file_name",
-      message: `fileName exceeds the 1024-byte UTF-8 limit (got ${bytes.byteLength})`
-    };
-  }
-  for (let i = 0; i < name.length; i++) {
-    const code = name.charCodeAt(i);
-    if (code < 32 || code === FILE_NAME_DEL) {
-      return {
-        code: "invalid_file_name",
-        message: "fileName must not contain control characters (U+0000-U+001F or U+007F)"
-      };
-    }
-  }
-  if (name === "." || name === "..") {
-    return {
-      code: "invalid_file_name",
-      message: 'fileName cannot be exactly "." or ".."'
-    };
-  }
-  if (name.startsWith("/") || name.endsWith("/") || name.includes("//")) {
-    return {
-      code: "invalid_file_name",
-      message: 'fileName cannot start with "/", end with "/", or contain "//"'
-    };
-  }
-  return null;
+	if (typeof name !== "string" || name.length === 0) return {
+		code: "invalid_file_name",
+		message: "fileName must be a non-empty string"
+	};
+	if (getB2FileNameByteLength(name) === null) return {
+		code: "invalid_file_name",
+		message: "fileName exceeds the 1024-byte UTF-8 limit"
+	};
+	if (hasB2FileNameControlCharacter(name)) return {
+		code: "invalid_file_name",
+		message: "fileName must not contain control characters (U+0000-U+001F or U+007F)"
+	};
+	if (name === "." || name === "..") return {
+		code: "invalid_file_name",
+		message: "fileName cannot be exactly \".\" or \"..\""
+	};
+	if (name.startsWith("/") || name.endsWith("/") || name.includes("//")) return {
+		code: "invalid_file_name",
+		message: "fileName cannot start with \"/\", end with \"/\", or contain \"//\""
+	};
+	return null;
 }
-const FILE_INFO_TOTAL_MAX = 2048;
-const FILE_INFO_VALUE_MAX = 2048;
-const FILE_INFO_KEY_REGEX = /^[a-zA-Z0-9_-]+$/;
+/** Per-file fileInfo total size cap (sum of key+value bytes). */
+var FILE_INFO_TOTAL_MAX = 2048;
+/** Per-key fileInfo value byte cap. */
+var FILE_INFO_VALUE_MAX = 2048;
+/** Allowed key character set (case-insensitive). */
+var FILE_INFO_KEY_REGEX = /^[a-zA-Z0-9_-]+$/;
+/**
+* Validates a `fileInfo` record against B2's byte-budget and
+* key-shape rules.
+*
+* @param info - Caller-supplied fileInfo record.
+*
+* @returns A `{ code, message }` pair on failure, or `null` when valid.
+*
+* @see https://www.backblaze.com/apidocs/b2-upload-file
+*/
 function validateFileInfo(info) {
-  let total = 0;
-  for (const [key, value] of Object.entries(info)) {
-    if (!FILE_INFO_KEY_REGEX.test(key)) {
-      return {
-        code: "invalid_file_info",
-        message: `fileInfo key "${key}" must match ^[a-zA-Z0-9_-]+$`
-      };
-    }
-    if (typeof value !== "string") {
-      return { code: "invalid_file_info", message: `fileInfo value for "${key}" must be a string` };
-    }
-    const keyBytes = utf8Encoder.encode(key).byteLength;
-    const valueBytes = utf8Encoder.encode(value).byteLength;
-    if (valueBytes > FILE_INFO_VALUE_MAX) {
-      return {
-        code: "invalid_file_info",
-        message: `fileInfo value for "${key}" exceeds ${FILE_INFO_VALUE_MAX} bytes`
-      };
-    }
-    total += keyBytes + valueBytes;
-  }
-  if (total > FILE_INFO_TOTAL_MAX) {
-    return {
-      code: "invalid_file_info",
-      message: `fileInfo total size ${total} bytes exceeds the ${FILE_INFO_TOTAL_MAX}-byte limit`
-    };
-  }
-  return null;
+	let total = 0;
+	for (const [key, value] of Object.entries(info)) {
+		if (!FILE_INFO_KEY_REGEX.test(key)) return {
+			code: "invalid_file_info",
+			message: `fileInfo key "${key}" must match ^[a-zA-Z0-9_-]+$`
+		};
+		if (typeof value !== "string") return {
+			code: "invalid_file_info",
+			message: `fileInfo value for "${key}" must be a string`
+		};
+		const keyBytes = utf8Encoder.encode(key).byteLength;
+		const valueBytes = utf8Encoder.encode(value).byteLength;
+		if (valueBytes > 2048) return {
+			code: "invalid_file_info",
+			message: `fileInfo value for "${key}" exceeds ${FILE_INFO_VALUE_MAX} bytes`
+		};
+		total += keyBytes + valueBytes;
+	}
+	if (total > 2048) return {
+		code: "invalid_file_info",
+		message: `fileInfo total size ${total} bytes exceeds the ${FILE_INFO_TOTAL_MAX}-byte limit`
+	};
+	return null;
 }
-const BUCKET_INFO_MAX_KEYS = 10;
-const BUCKET_INFO_VALUE_MAX = 2048;
-const BUCKET_INFO_KEY_REGEX = /^[a-zA-Z0-9_-]+$/;
+/** Per-bucket bucketInfo total max keys. */
+var BUCKET_INFO_MAX_KEYS = 10;
+/** Per-key bucketInfo value byte cap. */
+var BUCKET_INFO_VALUE_MAX = 2048;
+/** Allowed key character set for bucketInfo. */
+var BUCKET_INFO_KEY_REGEX = /^[a-zA-Z0-9_-]+$/;
+/**
+* Validates a `bucketInfo` record against B2's per-bucket metadata rules.
+*
+* @param info - Caller-supplied bucketInfo record.
+*
+* @returns A `{ code, message }` pair on failure, or `null` when valid.
+*
+* @see https://www.backblaze.com/apidocs/b2-create-bucket
+*/
 function validateBucketInfo(info) {
-  const entries = Object.entries(info);
-  if (entries.length > BUCKET_INFO_MAX_KEYS) {
-    return {
-      code: "invalid_bucket_info",
-      message: `bucketInfo cannot have more than ${BUCKET_INFO_MAX_KEYS} keys (got ${entries.length})`
-    };
-  }
-  for (const [key, value] of entries) {
-    if (!BUCKET_INFO_KEY_REGEX.test(key)) {
-      return {
-        code: "invalid_bucket_info",
-        message: `bucketInfo key "${key}" must match ^[a-zA-Z0-9_-]+$`
-      };
-    }
-    if (typeof value !== "string") {
-      return {
-        code: "invalid_bucket_info",
-        message: `bucketInfo value for "${key}" must be a string`
-      };
-    }
-    const valueBytes = utf8Encoder.encode(value).byteLength;
-    if (valueBytes > BUCKET_INFO_VALUE_MAX) {
-      return {
-        code: "invalid_bucket_info",
-        message: `bucketInfo value for "${key}" exceeds ${BUCKET_INFO_VALUE_MAX} bytes`
-      };
-    }
-  }
-  return null;
+	const entries = Object.entries(info);
+	if (entries.length > 10) return {
+		code: "invalid_bucket_info",
+		message: `bucketInfo cannot have more than 10 keys (got ${entries.length})`
+	};
+	for (const [key, value] of entries) {
+		if (!BUCKET_INFO_KEY_REGEX.test(key)) return {
+			code: "invalid_bucket_info",
+			message: `bucketInfo key "${key}" must match ^[a-zA-Z0-9_-]+$`
+		};
+		if (typeof value !== "string") return {
+			code: "invalid_bucket_info",
+			message: `bucketInfo value for "${key}" must be a string`
+		};
+		if (utf8Encoder.encode(value).byteLength > 2048) return {
+			code: "invalid_bucket_info",
+			message: `bucketInfo value for "${key}" exceeds ${BUCKET_INFO_VALUE_MAX} bytes`
+		};
+	}
+	return null;
 }
-const LIST_ENDPOINT_CAPS = {
-  /** `b2_list_file_names.maxFileCount` cap. */
-  b2_list_file_names: 1e4,
-  /** `b2_list_file_versions.maxFileCount` cap. */
-  b2_list_file_versions: 1e4,
-  /** `b2_list_unfinished_large_files.maxFileCount` cap. */
-  b2_list_unfinished_large_files: 100,
-  /** `b2_list_keys.maxKeyCount` cap. */
-  b2_list_keys: 1e4,
-  /** `b2_list_parts.maxPartCount` cap. */
-  b2_list_parts: 1e4
+/**
+* Per-endpoint upper bound on the `maxFileCount` (or `maxKeyCount` /
+* `maxPartCount`) request field. Sourced from the B2 endpoint docs.
+*/
+var LIST_ENDPOINT_CAPS = {
+	/** `b2_list_file_names.maxFileCount` cap. */
+	b2_list_file_names: 1e4,
+	/** `b2_list_file_versions.maxFileCount` cap. */
+	b2_list_file_versions: 1e4,
+	/** `b2_list_unfinished_large_files.maxFileCount` cap. */
+	b2_list_unfinished_large_files: 100,
+	/** `b2_list_keys.maxKeyCount` cap. */
+	b2_list_keys: 1e4,
+	/** `b2_list_parts.maxPartCount` cap. */
+	b2_list_parts: 1e4
 };
+/**
+* Validates a `maxFileCount` (or `maxKeyCount` / `maxPartCount`) value
+* against the per-endpoint cap documented by B2.
+*
+* @param requested - Caller-supplied count.
+* @param endpoint - Which list endpoint this applies to.
+*
+* @returns A `{ code, message }` pair on failure, or `null` when valid.
+*/
 function validateMaxCount(requested, endpoint) {
-  if (requested === void 0) return null;
-  if (!Number.isInteger(requested) || requested < 1) {
-    return {
-      code: "bad_request",
-      message: `maxFileCount must be a positive integer (got ${requested})`
-    };
-  }
-  const cap = LIST_ENDPOINT_CAPS[endpoint];
-  if (requested > cap) {
-    return {
-      code: "bad_request",
-      message: `maxFileCount ${requested} exceeds the ${endpoint} cap of ${cap}`
-    };
-  }
-  return null;
+	if (requested === void 0) return null;
+	if (!Number.isInteger(requested) || requested < 1) return {
+		code: "bad_request",
+		message: `maxFileCount must be a positive integer (got ${requested})`
+	};
+	const cap = LIST_ENDPOINT_CAPS[endpoint];
+	if (requested > cap) return {
+		code: "bad_request",
+		message: `maxFileCount ${requested} exceeds the ${endpoint} cap of ${cap}`
+	};
+	return null;
 }
-export {
-  BUCKET_INFO_MAX_KEYS,
-  BUCKET_INFO_VALUE_MAX,
-  BUCKET_NAME_MAX,
-  BUCKET_NAME_MIN,
-  FILE_INFO_TOTAL_MAX,
-  FILE_INFO_VALUE_MAX,
-  FILE_NAME_MAX_BYTES,
-  LIST_ENDPOINT_CAPS,
-  validateBucketInfo,
-  validateBucketName,
-  validateFileInfo,
-  validateFileName,
-  validateMaxCount
-};
-//# sourceMappingURL=validation.js.map
+//#endregion
+export { BUCKET_INFO_MAX_KEYS, BUCKET_INFO_VALUE_MAX, BUCKET_NAME_MAX, BUCKET_NAME_MIN, FILE_INFO_TOTAL_MAX, FILE_INFO_VALUE_MAX, FILE_NAME_MAX_BYTES, LIST_ENDPOINT_CAPS, validateBucketInfo, validateBucketName, validateFileInfo, validateFileName, validateMaxCount };
+
+//# sourceMappingURL=validation.js.map

package/dist/simulator/validation.js.map

@@ -1 +1 @@
-{"version":3,"file":"validation.js","sources":["../../src/simulator/validation.ts"],"sourcesContent":["/**\n * B2 spec-compliance validation helpers for the simulator.\n *\n * Each function mirrors a documented B2 input limit (file name length,\n * bucket name regex, file-info byte budget, etc.). Validators return\n * `null` for valid input or a `{ code, message }` pair that the handler\n * converts into a synthetic `400`/`403` response with the right B2\n * error code.\n *\n * Keeping validation in one module makes the simulator's \"what does B2\n * reject?\" surface auditable in a single file. Doc references inline at\n * each rule so the spec source is immediate.\n *\n * @packageDocumentation\n */\n\nimport { utf8Encoder } from '../util/text-codec.ts'\n\n/** Shape returned by validation functions when input is rejected. */\nexport interface ValidationError {\n  readonly code: string\n  readonly message: string\n}\n\n// ---------------------------------------------------------------------------\n// Bucket name (`b2_create_bucket`, `b2_update_bucket`)\n// ---------------------------------------------------------------------------\n\n/** Minimum B2 bucket-name length per https://www.backblaze.com/apidocs/b2-create-bucket. */\nexport const BUCKET_NAME_MIN = 6\n/** Maximum B2 bucket-name length per https://www.backblaze.com/apidocs/b2-create-bucket. */\nexport const BUCKET_NAME_MAX = 63\n/** Bucket-name char set: letters, digits, hyphens. Anchored, leading/trailing hyphens are illegal. */\nconst BUCKET_NAME_REGEX = /^[a-zA-Z0-9][a-zA-Z0-9-]*[a-zA-Z0-9]$/\n/** Reserved prefix — B2 forbids consumer-created buckets starting with `b2-`. */\nconst BUCKET_NAME_RESERVED_PREFIX = 'b2-'\n\n/**\n * Validates a bucket name against B2's documented rules.\n *\n * @param name - Caller-supplied bucket name.\n *\n * @returns A `{ code, message }` pair on failure, or `null` when valid.\n *\n * @see https://www.backblaze.com/apidocs/b2-create-bucket\n */\nexport function validateBucketName(name: string): ValidationError | null {\n  if (typeof name !== 'string' || name.length < BUCKET_NAME_MIN || name.length > BUCKET_NAME_MAX) {\n    return {\n      code: 'invalid_bucket_name',\n      message: `bucketName must be ${BUCKET_NAME_MIN}-${BUCKET_NAME_MAX} characters`,\n    }\n  }\n  if (!BUCKET_NAME_REGEX.test(name)) {\n    return {\n      code: 'invalid_bucket_name',\n      message:\n        'bucketName must contain only letters, digits, and hyphens; cannot start or end with a hyphen',\n    }\n  }\n  if (name.startsWith(BUCKET_NAME_RESERVED_PREFIX)) {\n    return {\n      code: 'invalid_bucket_name',\n      message: `bucketName cannot start with the reserved prefix \"${BUCKET_NAME_RESERVED_PREFIX}\"`,\n    }\n  }\n  return null\n}\n\n// ---------------------------------------------------------------------------\n// File name (every upload / hide / copy entry point)\n// ---------------------------------------------------------------------------\n\n/** Max file-name length is 1024 BYTES (UTF-8 encoded), not chars. */\nexport const FILE_NAME_MAX_BYTES = 1024\n/** Control-character range B2 rejects: U+0000-U+001F (32 codepoints) plus DEL (U+007F). */\nconst FILE_NAME_DEL = 0x7f\n\n/**\n * Validates a file name against B2's documented rules. Mirrors the\n * server-side checks B2 runs on `b2_upload_file` / `b2_hide_file` /\n * `b2_start_large_file` / `b2_copy_file` filename inputs.\n *\n * @param name - Caller-supplied file name (raw, unencoded).\n *\n * @returns A `{ code, message }` pair on failure, or `null` when valid.\n *\n * @see https://www.backblaze.com/apidocs/b2-upload-file\n */\nexport function validateFileName(name: string): ValidationError | null {\n  if (typeof name !== 'string' || name.length === 0) {\n    return { code: 'invalid_file_name', message: 'fileName must be a non-empty string' }\n  }\n  const bytes = utf8Encoder.encode(name)\n  if (bytes.byteLength > FILE_NAME_MAX_BYTES) {\n    return {\n      code: 'invalid_file_name',\n      message: `fileName exceeds the 1024-byte UTF-8 limit (got ${bytes.byteLength})`,\n    }\n  }\n  for (let i = 0; i < name.length; i++) {\n    const code = name.charCodeAt(i)\n    if (code < 0x20 || code === FILE_NAME_DEL) {\n      return {\n        code: 'invalid_file_name',\n        message: 'fileName must not contain control characters (U+0000-U+001F or U+007F)',\n      }\n    }\n  }\n  // Path segments equal to `.` or `..` alone are illegal per B2 docs.\n  // Embedded `..` within a segment (e.g. `a..b`) is fine, and a path\n  // like `../foo` is fine because the SDK doesn't interpret it; only\n  // bare `.` or `..` as a complete name is rejected.\n  if (name === '.' || name === '..') {\n    return {\n      code: 'invalid_file_name',\n      message: 'fileName cannot be exactly \".\" or \"..\"',\n    }\n  }\n  // No leading or trailing slash, no `//`.\n  if (name.startsWith('/') || name.endsWith('/') || name.includes('//')) {\n    return {\n      code: 'invalid_file_name',\n      message: 'fileName cannot start with \"/\", end with \"/\", or contain \"//\"',\n    }\n  }\n  return null\n}\n\n// ---------------------------------------------------------------------------\n// File-info / Bucket-info byte budget\n// ---------------------------------------------------------------------------\n\n/** Per-file fileInfo total size cap (sum of key+value bytes). */\nexport const FILE_INFO_TOTAL_MAX = 2048\n/** Per-key fileInfo value byte cap. */\nexport const FILE_INFO_VALUE_MAX = 2048\n/** Allowed key character set (case-insensitive). */\nconst FILE_INFO_KEY_REGEX = /^[a-zA-Z0-9_-]+$/\n\n/**\n * Validates a `fileInfo` record against B2's byte-budget and\n * key-shape rules.\n *\n * @param info - Caller-supplied fileInfo record.\n *\n * @returns A `{ code, message }` pair on failure, or `null` when valid.\n *\n * @see https://www.backblaze.com/apidocs/b2-upload-file\n */\nexport function validateFileInfo(info: Record<string, string>): ValidationError | null {\n  let total = 0\n  for (const [key, value] of Object.entries(info)) {\n    if (!FILE_INFO_KEY_REGEX.test(key)) {\n      return {\n        code: 'invalid_file_info',\n        message: `fileInfo key \"${key}\" must match ^[a-zA-Z0-9_-]+$`,\n      }\n    }\n    if (typeof value !== 'string') {\n      return { code: 'invalid_file_info', message: `fileInfo value for \"${key}\" must be a string` }\n    }\n    const keyBytes = utf8Encoder.encode(key).byteLength\n    const valueBytes = utf8Encoder.encode(value).byteLength\n    if (valueBytes > FILE_INFO_VALUE_MAX) {\n      return {\n        code: 'invalid_file_info',\n        message: `fileInfo value for \"${key}\" exceeds ${FILE_INFO_VALUE_MAX} bytes`,\n      }\n    }\n    total += keyBytes + valueBytes\n  }\n  if (total > FILE_INFO_TOTAL_MAX) {\n    return {\n      code: 'invalid_file_info',\n      message: `fileInfo total size ${total} bytes exceeds the ${FILE_INFO_TOTAL_MAX}-byte limit`,\n    }\n  }\n  return null\n}\n\n/** Per-bucket bucketInfo total max keys. */\nexport const BUCKET_INFO_MAX_KEYS = 10\n/** Per-key bucketInfo value byte cap. */\nexport const BUCKET_INFO_VALUE_MAX = 2048\n/** Allowed key character set for bucketInfo. */\nconst BUCKET_INFO_KEY_REGEX = /^[a-zA-Z0-9_-]+$/\n\n/**\n * Validates a `bucketInfo` record against B2's per-bucket metadata rules.\n *\n * @param info - Caller-supplied bucketInfo record.\n *\n * @returns A `{ code, message }` pair on failure, or `null` when valid.\n *\n * @see https://www.backblaze.com/apidocs/b2-create-bucket\n */\nexport function validateBucketInfo(info: Record<string, string>): ValidationError | null {\n  const entries = Object.entries(info)\n  if (entries.length > BUCKET_INFO_MAX_KEYS) {\n    return {\n      code: 'invalid_bucket_info',\n      message: `bucketInfo cannot have more than ${BUCKET_INFO_MAX_KEYS} keys (got ${entries.length})`,\n    }\n  }\n  for (const [key, value] of entries) {\n    if (!BUCKET_INFO_KEY_REGEX.test(key)) {\n      return {\n        code: 'invalid_bucket_info',\n        message: `bucketInfo key \"${key}\" must match ^[a-zA-Z0-9_-]+$`,\n      }\n    }\n    if (typeof value !== 'string') {\n      return {\n        code: 'invalid_bucket_info',\n        message: `bucketInfo value for \"${key}\" must be a string`,\n      }\n    }\n    const valueBytes = utf8Encoder.encode(value).byteLength\n    if (valueBytes > BUCKET_INFO_VALUE_MAX) {\n      return {\n        code: 'invalid_bucket_info',\n        message: `bucketInfo value for \"${key}\" exceeds ${BUCKET_INFO_VALUE_MAX} bytes`,\n      }\n    }\n  }\n  return null\n}\n\n// ---------------------------------------------------------------------------\n// maxFileCount caps per endpoint\n// ---------------------------------------------------------------------------\n\n/**\n * Per-endpoint upper bound on the `maxFileCount` (or `maxKeyCount` /\n * `maxPartCount`) request field. Sourced from the B2 endpoint docs.\n */\nexport const LIST_ENDPOINT_CAPS = {\n  /** `b2_list_file_names.maxFileCount` cap. */\n  b2_list_file_names: 10_000,\n  /** `b2_list_file_versions.maxFileCount` cap. */\n  b2_list_file_versions: 10_000,\n  /** `b2_list_unfinished_large_files.maxFileCount` cap. */\n  b2_list_unfinished_large_files: 100,\n  /** `b2_list_keys.maxKeyCount` cap. */\n  b2_list_keys: 10_000,\n  /** `b2_list_parts.maxPartCount` cap. */\n  b2_list_parts: 10_000,\n} as const\n\n/**\n * Validates a `maxFileCount` (or `maxKeyCount` / `maxPartCount`) value\n * against the per-endpoint cap documented by B2.\n *\n * @param requested - Caller-supplied count.\n * @param endpoint - Which list endpoint this applies to.\n *\n * @returns A `{ code, message }` pair on failure, or `null` when valid.\n */\nexport function validateMaxCount(\n  requested: number | undefined,\n  endpoint: keyof typeof LIST_ENDPOINT_CAPS,\n): ValidationError | null {\n  if (requested === undefined) return null\n  if (!Number.isInteger(requested) || requested < 1) {\n    return {\n      code: 'bad_request',\n      message: `maxFileCount must be a positive integer (got ${requested})`,\n    }\n  }\n  const cap = LIST_ENDPOINT_CAPS[endpoint]\n  if (requested > cap) {\n    return {\n      code: 'bad_request',\n      message: `maxFileCount ${requested} exceeds the ${endpoint} cap of ${cap}`,\n    }\n  }\n  return null\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"validation.js","names":[],"sources":["../../src/simulator/validation.ts"],"sourcesContent":["/**\n * B2 spec-compliance validation helpers for the simulator.\n *\n * Each function mirrors a documented B2 input limit (file name length,\n * bucket name regex, file-info byte budget, etc.). Validators return\n * `null` for valid input or a `{ code, message }` pair that the handler\n * converts into a synthetic `400`/`403` response with the right B2\n * error code.\n *\n * Keeping validation in one module makes the simulator's \"what does B2\n * reject?\" surface auditable in a single file. Doc references inline at\n * each rule so the spec source is immediate.\n *\n * @packageDocumentation\n */\n\nimport {\n  BUCKET_NAME_MAX,\n  BUCKET_NAME_MIN,\n  BUCKET_NAME_RESERVED_PREFIX,\n  FILE_NAME_MAX_BYTES,\n  getB2FileNameByteLength,\n  hasB2FileNameControlCharacter,\n  hasValidB2BucketNameShape,\n  isB2BucketNameIpv4Address,\n} from '../internal/b2-naming.ts'\nimport { utf8Encoder } from '../util/text-codec.ts'\n\n/** Shape returned by validation functions when input is rejected. */\nexport interface ValidationError {\n  readonly code: string\n  readonly message: string\n}\n\n// ---------------------------------------------------------------------------\n// Bucket name (`b2_create_bucket`, `b2_update_bucket`)\n// ---------------------------------------------------------------------------\n\nexport { BUCKET_NAME_MAX, BUCKET_NAME_MIN }\n\n/**\n * Validates a bucket name against B2's documented rules.\n *\n * @param name - Caller-supplied bucket name.\n *\n * @returns A `{ code, message }` pair on failure, or `null` when valid.\n *\n * @see https://www.backblaze.com/apidocs/b2-create-bucket\n */\nexport function validateBucketName(name: string): ValidationError | null {\n  if (typeof name !== 'string' || name.length < BUCKET_NAME_MIN || name.length > BUCKET_NAME_MAX) {\n    return {\n      code: 'invalid_bucket_name',\n      message: `bucketName must be ${BUCKET_NAME_MIN}-${BUCKET_NAME_MAX} characters`,\n    }\n  }\n  if (isB2BucketNameIpv4Address(name)) {\n    return {\n      code: 'invalid_bucket_name',\n      message: 'bucketName must not be formatted as an IPv4 address',\n    }\n  }\n  if (!hasValidB2BucketNameShape(name)) {\n    return {\n      code: 'invalid_bucket_name',\n      message:\n        'bucketName must contain only letters, digits, hyphens, and periods; cannot start or end with punctuation or contain consecutive periods',\n    }\n  }\n  if (name.startsWith(BUCKET_NAME_RESERVED_PREFIX)) {\n    return {\n      code: 'invalid_bucket_name',\n      message: `bucketName cannot start with the reserved prefix \"${BUCKET_NAME_RESERVED_PREFIX}\"`,\n    }\n  }\n  return null\n}\n\n// ---------------------------------------------------------------------------\n// File name (every upload / hide / copy entry point)\n// ---------------------------------------------------------------------------\n\nexport { FILE_NAME_MAX_BYTES }\n\n/**\n * Validates a file name against B2's documented rules. Mirrors the\n * server-side checks B2 runs on `b2_upload_file` / `b2_hide_file` /\n * `b2_start_large_file` / `b2_copy_file` filename inputs.\n *\n * @param name - Caller-supplied file name (raw, unencoded).\n *\n * @returns A `{ code, message }` pair on failure, or `null` when valid.\n *\n * @see https://www.backblaze.com/apidocs/b2-upload-file\n */\nexport function validateFileName(name: string): ValidationError | null {\n  if (typeof name !== 'string' || name.length === 0) {\n    return { code: 'invalid_file_name', message: 'fileName must be a non-empty string' }\n  }\n  const byteLength = getB2FileNameByteLength(name)\n  if (byteLength === null) {\n    return {\n      code: 'invalid_file_name',\n      message: 'fileName exceeds the 1024-byte UTF-8 limit',\n    }\n  }\n  if (hasB2FileNameControlCharacter(name)) {\n    return {\n      code: 'invalid_file_name',\n      message: 'fileName must not contain control characters (U+0000-U+001F or U+007F)',\n    }\n  }\n  // Path segments equal to `.` or `..` alone are illegal per B2 docs.\n  // Embedded `..` within a segment (e.g. `a..b`) is fine, and a path\n  // like `../foo` is fine because the SDK doesn't interpret it; only\n  // bare `.` or `..` as a complete name is rejected.\n  if (name === '.' || name === '..') {\n    return {\n      code: 'invalid_file_name',\n      message: 'fileName cannot be exactly \".\" or \"..\"',\n    }\n  }\n  // No leading or trailing slash, no `//`.\n  if (name.startsWith('/') || name.endsWith('/') || name.includes('//')) {\n    return {\n      code: 'invalid_file_name',\n      message: 'fileName cannot start with \"/\", end with \"/\", or contain \"//\"',\n    }\n  }\n  return null\n}\n\n// ---------------------------------------------------------------------------\n// File-info / Bucket-info byte budget\n// ---------------------------------------------------------------------------\n\n/** Per-file fileInfo total size cap (sum of key+value bytes). */\nexport const FILE_INFO_TOTAL_MAX = 2048\n/** Per-key fileInfo value byte cap. */\nexport const FILE_INFO_VALUE_MAX = 2048\n/** Allowed key character set (case-insensitive). */\nconst FILE_INFO_KEY_REGEX = /^[a-zA-Z0-9_-]+$/\n\n/**\n * Validates a `fileInfo` record against B2's byte-budget and\n * key-shape rules.\n *\n * @param info - Caller-supplied fileInfo record.\n *\n * @returns A `{ code, message }` pair on failure, or `null` when valid.\n *\n * @see https://www.backblaze.com/apidocs/b2-upload-file\n */\nexport function validateFileInfo(info: Record<string, string>): ValidationError | null {\n  let total = 0\n  for (const [key, value] of Object.entries(info)) {\n    if (!FILE_INFO_KEY_REGEX.test(key)) {\n      return {\n        code: 'invalid_file_info',\n        message: `fileInfo key \"${key}\" must match ^[a-zA-Z0-9_-]+$`,\n      }\n    }\n    if (typeof value !== 'string') {\n      return { code: 'invalid_file_info', message: `fileInfo value for \"${key}\" must be a string` }\n    }\n    const keyBytes = utf8Encoder.encode(key).byteLength\n    const valueBytes = utf8Encoder.encode(value).byteLength\n    if (valueBytes > FILE_INFO_VALUE_MAX) {\n      return {\n        code: 'invalid_file_info',\n        message: `fileInfo value for \"${key}\" exceeds ${FILE_INFO_VALUE_MAX} bytes`,\n      }\n    }\n    total += keyBytes + valueBytes\n  }\n  if (total > FILE_INFO_TOTAL_MAX) {\n    return {\n      code: 'invalid_file_info',\n      message: `fileInfo total size ${total} bytes exceeds the ${FILE_INFO_TOTAL_MAX}-byte limit`,\n    }\n  }\n  return null\n}\n\n/** Per-bucket bucketInfo total max keys. */\nexport const BUCKET_INFO_MAX_KEYS = 10\n/** Per-key bucketInfo value byte cap. */\nexport const BUCKET_INFO_VALUE_MAX = 2048\n/** Allowed key character set for bucketInfo. */\nconst BUCKET_INFO_KEY_REGEX = /^[a-zA-Z0-9_-]+$/\n\n/**\n * Validates a `bucketInfo` record against B2's per-bucket metadata rules.\n *\n * @param info - Caller-supplied bucketInfo record.\n *\n * @returns A `{ code, message }` pair on failure, or `null` when valid.\n *\n * @see https://www.backblaze.com/apidocs/b2-create-bucket\n */\nexport function validateBucketInfo(info: Record<string, string>): ValidationError | null {\n  const entries = Object.entries(info)\n  if (entries.length > BUCKET_INFO_MAX_KEYS) {\n    return {\n      code: 'invalid_bucket_info',\n      message: `bucketInfo cannot have more than ${BUCKET_INFO_MAX_KEYS} keys (got ${entries.length})`,\n    }\n  }\n  for (const [key, value] of entries) {\n    if (!BUCKET_INFO_KEY_REGEX.test(key)) {\n      return {\n        code: 'invalid_bucket_info',\n        message: `bucketInfo key \"${key}\" must match ^[a-zA-Z0-9_-]+$`,\n      }\n    }\n    if (typeof value !== 'string') {\n      return {\n        code: 'invalid_bucket_info',\n        message: `bucketInfo value for \"${key}\" must be a string`,\n      }\n    }\n    const valueBytes = utf8Encoder.encode(value).byteLength\n    if (valueBytes > BUCKET_INFO_VALUE_MAX) {\n      return {\n        code: 'invalid_bucket_info',\n        message: `bucketInfo value for \"${key}\" exceeds ${BUCKET_INFO_VALUE_MAX} bytes`,\n      }\n    }\n  }\n  return null\n}\n\n// ---------------------------------------------------------------------------\n// maxFileCount caps per endpoint\n// ---------------------------------------------------------------------------\n\n/**\n * Per-endpoint upper bound on the `maxFileCount` (or `maxKeyCount` /\n * `maxPartCount`) request field. Sourced from the B2 endpoint docs.\n */\nexport const LIST_ENDPOINT_CAPS = {\n  /** `b2_list_file_names.maxFileCount` cap. */\n  b2_list_file_names: 10_000,\n  /** `b2_list_file_versions.maxFileCount` cap. */\n  b2_list_file_versions: 10_000,\n  /** `b2_list_unfinished_large_files.maxFileCount` cap. */\n  b2_list_unfinished_large_files: 100,\n  /** `b2_list_keys.maxKeyCount` cap. */\n  b2_list_keys: 10_000,\n  /** `b2_list_parts.maxPartCount` cap. */\n  b2_list_parts: 10_000,\n} as const\n\n/**\n * Validates a `maxFileCount` (or `maxKeyCount` / `maxPartCount`) value\n * against the per-endpoint cap documented by B2.\n *\n * @param requested - Caller-supplied count.\n * @param endpoint - Which list endpoint this applies to.\n *\n * @returns A `{ code, message }` pair on failure, or `null` when valid.\n */\nexport function validateMaxCount(\n  requested: number | undefined,\n  endpoint: keyof typeof LIST_ENDPOINT_CAPS,\n): ValidationError | null {\n  if (requested === undefined) return null\n  if (!Number.isInteger(requested) || requested < 1) {\n    return {\n      code: 'bad_request',\n      message: `maxFileCount must be a positive integer (got ${requested})`,\n    }\n  }\n  const cap = LIST_ENDPOINT_CAPS[endpoint]\n  if (requested > cap) {\n    return {\n      code: 'bad_request',\n      message: `maxFileCount ${requested} exceeds the ${endpoint} cap of ${cap}`,\n    }\n  }\n  return null\n}\n"],"mappings":"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"}

package/dist/streams/collect.cjs

@@ -1,26 +1,76 @@
-"use strict";
-Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-async function collectStream(stream) {
-  const reader = stream.getReader();
-  try {
-    const chunks = [];
-    let total = 0;
-    while (true) {
-      const { done, value } = await reader.read();
-      if (done) break;
-      chunks.push(value);
-      total += value.byteLength;
-    }
-    const result = new Uint8Array(total);
-    let offset = 0;
-    for (const chunk of chunks) {
-      result.set(chunk, offset);
-      offset += chunk.byteLength;
-    }
-    return result;
-  } finally {
-    reader.releaseLock();
-  }
+//#region src/streams/collect.ts
+/**
+* Drain a `ReadableStream<Uint8Array>` into a single contiguous
+* `Uint8Array`. Releases the reader lock on both the happy and error
+* paths so the underlying stream can propagate close / error events to
+* the upstream producer.
+*
+* Used by both `createParallelDownloadStream` (per-range fetch) and
+* `StreamSource.toArrayBuffer` (whole-source materialisation). The two
+* code paths previously hand-rolled the same accumulate-then-concat
+* loop; consolidating here removes ~25 duplicated lines and a class of
+* lock-leak bugs.
+*
+* @param stream - Readable stream to consume. Will be fully drained.
+* @param options - Optional abort signal used to stop a pending read.
+*
+* @returns A new `Uint8Array` containing every byte the stream produced.
+*/
+async function collectStream(stream, options = {}) {
+	const reader = stream.getReader();
+	try {
+		const chunks = [];
+		let total = 0;
+		while (true) {
+			const { done, value } = await readStreamChunkWithSignal(reader, options.signal);
+			if (done) break;
+			chunks.push(value);
+			total += value.byteLength;
+		}
+		const result = new Uint8Array(total);
+		let offset = 0;
+		for (const chunk of chunks) {
+			result.set(chunk, offset);
+			offset += chunk.byteLength;
+		}
+		return result;
+	} finally {
+		reader.releaseLock();
+	}
 }
+/**
+* Reads one chunk and rejects when the supplied signal aborts.
+* @param reader - Stream reader to read from.
+* @param signal - Optional abort signal that cancels the read.
+*
+* @returns The next stream read result.
+*
+* @internal
+*/
+async function readStreamChunkWithSignal(reader, signal) {
+	if (signal === void 0) return reader.read();
+	signal.throwIfAborted();
+	let removeAbortListener;
+	const abortPromise = new Promise((_, reject) => {
+		const onAbort = () => {
+			const reason = abortReason(signal);
+			reject(reason);
+			reader.cancel(reason).catch(() => {});
+		};
+		signal.addEventListener("abort", onAbort, { once: true });
+		removeAbortListener = () => signal.removeEventListener("abort", onAbort);
+	});
+	try {
+		return await Promise.race([reader.read(), abortPromise]);
+	} finally {
+		removeAbortListener?.();
+	}
+}
+function abortReason(signal) {
+	return signal.reason ?? new DOMException("The operation was aborted.", "AbortError");
+}
+//#endregion
 exports.collectStream = collectStream;
-//# sourceMappingURL=collect.cjs.map
+exports.readStreamChunkWithSignal = readStreamChunkWithSignal;
+
+//# sourceMappingURL=collect.cjs.map

package/dist/streams/collect.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"collect.cjs","sources":["../../src/streams/collect.ts"],"sourcesContent":["/**\n * Drain a `ReadableStream<Uint8Array>` into a single contiguous\n * `Uint8Array`. Releases the reader lock on both the happy and error\n * paths so the underlying stream can propagate close / error events to\n * the upstream producer.\n *\n * Used by both `createParallelDownloadStream` (per-range fetch) and\n * `StreamSource.toArrayBuffer` (whole-source materialisation). The two\n * code paths previously hand-rolled the same accumulate-then-concat\n * loop; consolidating here removes ~25 duplicated lines and a class of\n * lock-leak bugs.\n *\n * @param stream - Readable stream to consume. Will be fully drained.\n *\n * @returns A new `Uint8Array` containing every byte the stream produced.\n */\nexport async function collectStream(stream: ReadableStream<Uint8Array>): Promise<Uint8Array> {\n  const reader = stream.getReader()\n  try {\n    const chunks: Uint8Array[] = []\n    let total = 0\n    while (true) {\n      const { done, value } = await reader.read()\n      if (done) break\n      chunks.push(value)\n      total += value.byteLength\n    }\n    const result = new Uint8Array(total)\n    let offset = 0\n    for (const chunk of chunks) {\n      result.set(chunk, offset)\n      offset += chunk.byteLength\n    }\n    return result\n  } finally {\n    // Releasing here lets the underlying stream propagate close / error\n    // events to any upstream producer (e.g. a Node `Readable`) even on\n    // the error path where a mid-read throw left the reader locked.\n    reader.releaseLock()\n  }\n}\n"],"names":[],"mappings":";;AAgBA,eAAsB,cAAc,QAAyD;AAC3F,QAAM,SAAS,OAAO,UAAA;AACtB,MAAI;AACF,UAAM,SAAuB,CAAA;AAC7B,QAAI,QAAQ;AACZ,WAAO,MAAM;AACX,YAAM,EAAE,MAAM,MAAA,IAAU,MAAM,OAAO,KAAA;AACrC,UAAI,KAAM;AACV,aAAO,KAAK,KAAK;AACjB,eAAS,MAAM;AAAA,IACjB;AACA,UAAM,SAAS,IAAI,WAAW,KAAK;AACnC,QAAI,SAAS;AACb,eAAW,SAAS,QAAQ;AAC1B,aAAO,IAAI,OAAO,MAAM;AACxB,gBAAU,MAAM;AAAA,IAClB;AACA,WAAO;AAAA,EACT,UAAA;AAIE,WAAO,YAAA;AAAA,EACT;AACF;;"}
+{"version":3,"file":"collect.cjs","names":[],"sources":["../../src/streams/collect.ts"],"sourcesContent":["/**\n * Drain a `ReadableStream<Uint8Array>` into a single contiguous\n * `Uint8Array`. Releases the reader lock on both the happy and error\n * paths so the underlying stream can propagate close / error events to\n * the upstream producer.\n *\n * Used by both `createParallelDownloadStream` (per-range fetch) and\n * `StreamSource.toArrayBuffer` (whole-source materialisation). The two\n * code paths previously hand-rolled the same accumulate-then-concat\n * loop; consolidating here removes ~25 duplicated lines and a class of\n * lock-leak bugs.\n *\n * @param stream - Readable stream to consume. Will be fully drained.\n * @param options - Optional abort signal used to stop a pending read.\n *\n * @returns A new `Uint8Array` containing every byte the stream produced.\n */\nexport async function collectStream(\n  stream: ReadableStream<Uint8Array>,\n  options: { readonly signal?: AbortSignal } = {},\n): Promise<Uint8Array> {\n  const reader = stream.getReader()\n  try {\n    const chunks: Uint8Array[] = []\n    let total = 0\n    while (true) {\n      const { done, value } = await readStreamChunkWithSignal(reader, options.signal)\n      if (done) break\n      chunks.push(value)\n      total += value.byteLength\n    }\n    const result = new Uint8Array(total)\n    let offset = 0\n    for (const chunk of chunks) {\n      result.set(chunk, offset)\n      offset += chunk.byteLength\n    }\n    return result\n  } finally {\n    // Releasing here lets the underlying stream propagate close / error\n    // events to any upstream producer (e.g. a Node `Readable`) even on\n    // the error path where a mid-read throw left the reader locked.\n    reader.releaseLock()\n  }\n}\n\n/**\n * Reads one chunk and rejects when the supplied signal aborts.\n * @param reader - Stream reader to read from.\n * @param signal - Optional abort signal that cancels the read.\n *\n * @returns The next stream read result.\n *\n * @internal\n */\nexport async function readStreamChunkWithSignal<T>(\n  reader: ReadableStreamDefaultReader<T>,\n  signal: AbortSignal | undefined,\n): Promise<ReadableStreamReadResult<T>> {\n  if (signal === undefined) return reader.read()\n  signal.throwIfAborted()\n\n  let removeAbortListener: (() => void) | undefined\n  const abortPromise = new Promise<never>((_, reject) => {\n    const onAbort = (): void => {\n      const reason = abortReason(signal)\n      reject(reason)\n      void reader.cancel(reason).catch(() => {})\n    }\n    signal.addEventListener('abort', onAbort, { once: true })\n    removeAbortListener = () => signal.removeEventListener('abort', onAbort)\n  })\n\n  try {\n    return await Promise.race([reader.read(), abortPromise])\n  } finally {\n    removeAbortListener?.()\n  }\n}\n\nfunction abortReason(signal: AbortSignal): unknown {\n  return signal.reason ?? new DOMException('The operation was aborted.', 'AbortError')\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAiBA,eAAsB,cACpB,QACA,UAA6C,CAAC,GACzB;CACrB,MAAM,SAAS,OAAO,UAAU;CAChC,IAAI;EACF,MAAM,SAAuB,CAAC;EAC9B,IAAI,QAAQ;EACZ,OAAO,MAAM;GACX,MAAM,EAAE,MAAM,UAAU,MAAM,0BAA0B,QAAQ,QAAQ,MAAM;GAC9E,IAAI,MAAM;GACV,OAAO,KAAK,KAAK;GACjB,SAAS,MAAM;EACjB;EACA,MAAM,SAAS,IAAI,WAAW,KAAK;EACnC,IAAI,SAAS;EACb,KAAK,MAAM,SAAS,QAAQ;GAC1B,OAAO,IAAI,OAAO,MAAM;GACxB,UAAU,MAAM;EAClB;EACA,OAAO;CACT,UAAU;EAIR,OAAO,YAAY;CACrB;AACF;;;;;;;;;;AAWA,eAAsB,0BACpB,QACA,QACsC;CACtC,IAAI,WAAW,KAAA,GAAW,OAAO,OAAO,KAAK;CAC7C,OAAO,eAAe;CAEtB,IAAI;CACJ,MAAM,eAAe,IAAI,SAAgB,GAAG,WAAW;EACrD,MAAM,gBAAsB;GAC1B,MAAM,SAAS,YAAY,MAAM;GACjC,OAAO,MAAM;GACb,OAAY,OAAO,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;EAC3C;EACA,OAAO,iBAAiB,SAAS,SAAS,EAAE,MAAM,KAAK,CAAC;EACxD,4BAA4B,OAAO,oBAAoB,SAAS,OAAO;CACzE,CAAC;CAED,IAAI;EACF,OAAO,MAAM,QAAQ,KAAK,CAAC,OAAO,KAAK,GAAG,YAAY,CAAC;CACzD,UAAU;EACR,sBAAsB;CACxB;AACF;AAEA,SAAS,YAAY,QAA8B;CACjD,OAAO,OAAO,UAAU,IAAI,aAAa,8BAA8B,YAAY;AACrF"}

package/dist/streams/collect.d.cts

@@ -11,8 +11,21 @@
  * lock-leak bugs.
  *
  * @param stream - Readable stream to consume. Will be fully drained.
+ * @param options - Optional abort signal used to stop a pending read.
  *
  * @returns A new `Uint8Array` containing every byte the stream produced.
  */
-export declare function collectStream(stream: ReadableStream<Uint8Array>): Promise<Uint8Array>;
+export declare function collectStream(stream: ReadableStream<Uint8Array>, options?: {
+    readonly signal?: AbortSignal;
+}): Promise<Uint8Array>;
+/**
+ * Reads one chunk and rejects when the supplied signal aborts.
+ * @param reader - Stream reader to read from.
+ * @param signal - Optional abort signal that cancels the read.
+ *
+ * @returns The next stream read result.
+ *
+ * @internal
+ */
+export declare function readStreamChunkWithSignal<T>(reader: ReadableStreamDefaultReader<T>, signal: AbortSignal | undefined): Promise<ReadableStreamReadResult<T>>;
 //# sourceMappingURL=collect.d.ts.map

package/dist/streams/collect.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"collect.d.ts","sourceRoot":"","sources":["../../src/streams/collect.js"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,CAwB3F"}
+{"version":3,"file":"collect.d.ts","sourceRoot":"","sources":["../../src/streams/collect.js"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC,EAClC,OAAO,GAAE;IAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAAO,GAC9C,OAAO,CAAC,UAAU,CAAC,CAwBrB;AAED;;;;;;;;GAQG;AACH,wBAAsB,yBAAyB,CAAC,CAAC,EAC/C,MAAM,EAAE,2BAA2B,CAAC,CAAC,CAAC,EACtC,MAAM,EAAE,WAAW,GAAG,SAAS,GAC9B,OAAO,CAAC,wBAAwB,CAAC,CAAC,CAAC,CAAC,CAoBtC"}

package/dist/streams/collect.d.ts

@@ -11,8 +11,21 @@
  * lock-leak bugs.
  *
  * @param stream - Readable stream to consume. Will be fully drained.
+ * @param options - Optional abort signal used to stop a pending read.
  *
  * @returns A new `Uint8Array` containing every byte the stream produced.
  */
-export declare function collectStream(stream: ReadableStream<Uint8Array>): Promise<Uint8Array>;
+export declare function collectStream(stream: ReadableStream<Uint8Array>, options?: {
+    readonly signal?: AbortSignal;
+}): Promise<Uint8Array>;
+/**
+ * Reads one chunk and rejects when the supplied signal aborts.
+ * @param reader - Stream reader to read from.
+ * @param signal - Optional abort signal that cancels the read.
+ *
+ * @returns The next stream read result.
+ *
+ * @internal
+ */
+export declare function readStreamChunkWithSignal<T>(reader: ReadableStreamDefaultReader<T>, signal: AbortSignal | undefined): Promise<ReadableStreamReadResult<T>>;
 //# sourceMappingURL=collect.d.ts.map

package/dist/streams/collect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"collect.d.ts","sourceRoot":"","sources":["../../src/streams/collect.js"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,CAwB3F"}
+{"version":3,"file":"collect.d.ts","sourceRoot":"","sources":["../../src/streams/collect.js"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC,EAClC,OAAO,GAAE;IAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAAO,GAC9C,OAAO,CAAC,UAAU,CAAC,CAwBrB;AAED;;;;;;;;GAQG;AACH,wBAAsB,yBAAyB,CAAC,CAAC,EAC/C,MAAM,EAAE,2BAA2B,CAAC,CAAC,CAAC,EACtC,MAAM,EAAE,WAAW,GAAG,SAAS,GAC9B,OAAO,CAAC,wBAAwB,CAAC,CAAC,CAAC,CAAC,CAoBtC"}