@backblaze-labs/b2-sdk 0.1.0 → 0.2.0

package/dist/simulator/validation.cjs

@@ -1,174 +1,212 @@
-"use strict";
-Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const textCodec = require("../util/text-codec.cjs");
-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-";
+const require_text_codec = require("../util/text-codec.cjs");
+const require_b2_naming = require("../internal/b2-naming.cjs");
+//#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 (require_b2_naming.isB2BucketNameIpv4Address(name)) return {
+		code: "invalid_bucket_name",
+		message: "bucketName must not be formatted as an IPv4 address"
+	};
+	if (!require_b2_naming.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 = textCodec.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 (require_b2_naming.getB2FileNameByteLength(name) === null) return {
+		code: "invalid_file_name",
+		message: "fileName exceeds the 1024-byte UTF-8 limit"
+	};
+	if (require_b2_naming.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 = textCodec.utf8Encoder.encode(key).byteLength;
-    const valueBytes = textCodec.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 = require_text_codec.utf8Encoder.encode(key).byteLength;
+		const valueBytes = require_text_codec.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 = textCodec.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 (require_text_codec.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;
 }
+//#endregion
 exports.BUCKET_INFO_MAX_KEYS = BUCKET_INFO_MAX_KEYS;
 exports.BUCKET_INFO_VALUE_MAX = BUCKET_INFO_VALUE_MAX;
-exports.BUCKET_NAME_MAX = BUCKET_NAME_MAX;
-exports.BUCKET_NAME_MIN = BUCKET_NAME_MIN;
+exports.BUCKET_NAME_MAX = require_b2_naming.BUCKET_NAME_MAX;
+exports.BUCKET_NAME_MIN = require_b2_naming.BUCKET_NAME_MIN;
 exports.FILE_INFO_TOTAL_MAX = FILE_INFO_TOTAL_MAX;
 exports.FILE_INFO_VALUE_MAX = FILE_INFO_VALUE_MAX;
-exports.FILE_NAME_MAX_BYTES = FILE_NAME_MAX_BYTES;
+exports.FILE_NAME_MAX_BYTES = require_b2_naming.FILE_NAME_MAX_BYTES;
 exports.LIST_ENDPOINT_CAPS = LIST_ENDPOINT_CAPS;
 exports.validateBucketInfo = validateBucketInfo;
 exports.validateBucketName = validateBucketName;
 exports.validateFileInfo = validateFileInfo;
 exports.validateFileName = validateFileName;
 exports.validateMaxCount = validateMaxCount;
-//# sourceMappingURL=validation.cjs.map
+
+//# sourceMappingURL=validation.cjs.map

package/dist/simulator/validation.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"validation.cjs","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":["utf8Encoder"],"mappings":"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"}
+{"version":3,"file":"validation.cjs","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/simulator/validation.d.cts

@@ -1,27 +1,10 @@
-/**
- * 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
- */
+import { BUCKET_NAME_MAX, BUCKET_NAME_MIN, FILE_NAME_MAX_BYTES } from '../internal/b2-naming.js';
 /** Shape returned by validation functions when input is rejected. */
 export interface ValidationError {
     readonly code: string;
     readonly message: string;
 }
-/** Minimum B2 bucket-name length per https://www.backblaze.com/apidocs/b2-create-bucket. */
-export declare const BUCKET_NAME_MIN = 6;
-/** Maximum B2 bucket-name length per https://www.backblaze.com/apidocs/b2-create-bucket. */
-export declare const BUCKET_NAME_MAX = 63;
+export { BUCKET_NAME_MAX, BUCKET_NAME_MIN };
 /**
  * Validates a bucket name against B2's documented rules.
  *
@@ -32,8 +15,7 @@ export declare const BUCKET_NAME_MAX = 63;
  * @see https://www.backblaze.com/apidocs/b2-create-bucket
  */
 export declare function validateBucketName(name: string): ValidationError | null;
-/** Max file-name length is 1024 BYTES (UTF-8 encoded), not chars. */
-export declare const FILE_NAME_MAX_BYTES = 1024;
+export { FILE_NAME_MAX_BYTES };
 /**
  * Validates a file name against B2's documented rules. Mirrors the
  * server-side checks B2 runs on `b2_upload_file` / `b2_hide_file` /

package/dist/simulator/validation.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/simulator/validation.js"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,qEAAqE;AACrE,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB;AAMD,4FAA4F;AAC5F,eAAO,MAAM,eAAe,IAAI,CAAA;AAChC,4FAA4F;AAC5F,eAAO,MAAM,eAAe,KAAK,CAAA;AAMjC;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAqBvE;AAMD,qEAAqE;AACrE,eAAO,MAAM,mBAAmB,OAAO,CAAA;AAIvC;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAsCrE;AAMD,iEAAiE;AACjE,eAAO,MAAM,mBAAmB,OAAO,CAAA;AACvC,uCAAuC;AACvC,eAAO,MAAM,mBAAmB,OAAO,CAAA;AAIvC;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,eAAe,GAAG,IAAI,CA6BrF;AAED,4CAA4C;AAC5C,eAAO,MAAM,oBAAoB,KAAK,CAAA;AACtC,yCAAyC;AACzC,eAAO,MAAM,qBAAqB,OAAO,CAAA;AAIzC;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,eAAe,GAAG,IAAI,CA8BvF;AAMD;;;GAGG;AACH,eAAO,MAAM,kBAAkB;IAC7B,6CAA6C;;IAE7C,gDAAgD;;IAEhD,yDAAyD;;IAEzD,sCAAsC;;IAEtC,wCAAwC;;CAEhC,CAAA;AAEV;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,QAAQ,EAAE,MAAM,OAAO,kBAAkB,GACxC,eAAe,GAAG,IAAI,CAgBxB"}
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/simulator/validation.js"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EACL,eAAe,EACf,eAAe,EAEf,mBAAmB,EAKpB,MAAM,0BAA0B,CAAA;AAGjC,qEAAqE;AACrE,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB;AAMD,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,CAAA;AAE3C;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CA2BvE;AAMD,OAAO,EAAE,mBAAmB,EAAE,CAAA;AAE9B;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAmCrE;AAMD,iEAAiE;AACjE,eAAO,MAAM,mBAAmB,OAAO,CAAA;AACvC,uCAAuC;AACvC,eAAO,MAAM,mBAAmB,OAAO,CAAA;AAIvC;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,eAAe,GAAG,IAAI,CA6BrF;AAED,4CAA4C;AAC5C,eAAO,MAAM,oBAAoB,KAAK,CAAA;AACtC,yCAAyC;AACzC,eAAO,MAAM,qBAAqB,OAAO,CAAA;AAIzC;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,eAAe,GAAG,IAAI,CA8BvF;AAMD;;;GAGG;AACH,eAAO,MAAM,kBAAkB;IAC7B,6CAA6C;;IAE7C,gDAAgD;;IAEhD,yDAAyD;;IAEzD,sCAAsC;;IAEtC,wCAAwC;;CAEhC,CAAA;AAEV;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,QAAQ,EAAE,MAAM,OAAO,kBAAkB,GACxC,eAAe,GAAG,IAAI,CAgBxB"}

package/dist/simulator/validation.d.ts

@@ -1,27 +1,10 @@
-/**
- * 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
- */
+import { BUCKET_NAME_MAX, BUCKET_NAME_MIN, FILE_NAME_MAX_BYTES } from '../internal/b2-naming.js';
 /** Shape returned by validation functions when input is rejected. */
 export interface ValidationError {
     readonly code: string;
     readonly message: string;
 }
-/** Minimum B2 bucket-name length per https://www.backblaze.com/apidocs/b2-create-bucket. */
-export declare const BUCKET_NAME_MIN = 6;
-/** Maximum B2 bucket-name length per https://www.backblaze.com/apidocs/b2-create-bucket. */
-export declare const BUCKET_NAME_MAX = 63;
+export { BUCKET_NAME_MAX, BUCKET_NAME_MIN };
 /**
  * Validates a bucket name against B2's documented rules.
  *
@@ -32,8 +15,7 @@ export declare const BUCKET_NAME_MAX = 63;
  * @see https://www.backblaze.com/apidocs/b2-create-bucket
  */
 export declare function validateBucketName(name: string): ValidationError | null;
-/** Max file-name length is 1024 BYTES (UTF-8 encoded), not chars. */
-export declare const FILE_NAME_MAX_BYTES = 1024;
+export { FILE_NAME_MAX_BYTES };
 /**
  * Validates a file name against B2's documented rules. Mirrors the
  * server-side checks B2 runs on `b2_upload_file` / `b2_hide_file` /

package/dist/simulator/validation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/simulator/validation.js"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,qEAAqE;AACrE,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB;AAMD,4FAA4F;AAC5F,eAAO,MAAM,eAAe,IAAI,CAAA;AAChC,4FAA4F;AAC5F,eAAO,MAAM,eAAe,KAAK,CAAA;AAMjC;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAqBvE;AAMD,qEAAqE;AACrE,eAAO,MAAM,mBAAmB,OAAO,CAAA;AAIvC;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAsCrE;AAMD,iEAAiE;AACjE,eAAO,MAAM,mBAAmB,OAAO,CAAA;AACvC,uCAAuC;AACvC,eAAO,MAAM,mBAAmB,OAAO,CAAA;AAIvC;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,eAAe,GAAG,IAAI,CA6BrF;AAED,4CAA4C;AAC5C,eAAO,MAAM,oBAAoB,KAAK,CAAA;AACtC,yCAAyC;AACzC,eAAO,MAAM,qBAAqB,OAAO,CAAA;AAIzC;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,eAAe,GAAG,IAAI,CA8BvF;AAMD;;;GAGG;AACH,eAAO,MAAM,kBAAkB;IAC7B,6CAA6C;;IAE7C,gDAAgD;;IAEhD,yDAAyD;;IAEzD,sCAAsC;;IAEtC,wCAAwC;;CAEhC,CAAA;AAEV;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,QAAQ,EAAE,MAAM,OAAO,kBAAkB,GACxC,eAAe,GAAG,IAAI,CAgBxB"}
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/simulator/validation.js"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EACL,eAAe,EACf,eAAe,EAEf,mBAAmB,EAKpB,MAAM,0BAA0B,CAAA;AAGjC,qEAAqE;AACrE,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB;AAMD,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,CAAA;AAE3C;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CA2BvE;AAMD,OAAO,EAAE,mBAAmB,EAAE,CAAA;AAE9B;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAmCrE;AAMD,iEAAiE;AACjE,eAAO,MAAM,mBAAmB,OAAO,CAAA;AACvC,uCAAuC;AACvC,eAAO,MAAM,mBAAmB,OAAO,CAAA;AAIvC;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,eAAe,GAAG,IAAI,CA6BrF;AAED,4CAA4C;AAC5C,eAAO,MAAM,oBAAoB,KAAK,CAAA;AACtC,yCAAyC;AACzC,eAAO,MAAM,qBAAqB,OAAO,CAAA;AAIzC;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,eAAe,GAAG,IAAI,CA8BvF;AAMD;;;GAGG;AACH,eAAO,MAAM,kBAAkB;IAC7B,6CAA6C;;IAE7C,gDAAgD;;IAEhD,yDAAyD;;IAEzD,sCAAsC;;IAEtC,wCAAwC;;CAEhC,CAAA;AAEV;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,QAAQ,EAAE,MAAM,OAAO,kBAAkB,GACxC,eAAe,GAAG,IAAI,CAgBxB"}