@backblaze-labs/b2-sdk 0.1.0 → 0.3.0

package/dist/internal/b2-naming.d.cts

@@ -0,0 +1,43 @@
+/** 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;
+/** Reserved prefix: B2 forbids consumer-created buckets starting with `b2-`. */
+export declare const BUCKET_NAME_RESERVED_PREFIX = "b2-";
+/** Max file-name length is 1024 bytes, UTF-8 encoded. */
+export declare const FILE_NAME_MAX_BYTES = 1024;
+/**
+ * B2 bucket names may contain letters, digits, hyphens, and periods, but
+ * cannot start/end with punctuation or contain adjacent periods.
+ *
+ * @param name - Candidate bucket name.
+ *
+ * @returns Whether the name satisfies the shared B2 bucket-name shape rules.
+ */
+export declare function hasValidB2BucketNameShape(name: string): boolean;
+/**
+ * Checks whether a candidate bucket name is formatted as an IPv4 address.
+ *
+ * @param name - Candidate bucket name.
+ *
+ * @returns Whether the name is an IPv4-address-form string.
+ */
+export declare function isB2BucketNameIpv4Address(name: string): boolean;
+/**
+ * Checks for control characters that B2 rejects in names and HTTP header values.
+ *
+ * @param name - Candidate name.
+ *
+ * @returns Whether the name contains a rejected control character.
+ */
+export declare function hasB2FileNameControlCharacter(name: string): boolean;
+/**
+ * Enforces the 1024-byte B2 file-name limit. Very long strings fail before
+ * full UTF-8 encoding so untrusted input cannot force unbounded allocation.
+ *
+ * @param name - Candidate file name.
+ *
+ * @returns The UTF-8 byte length when it is within the B2 limit, otherwise `null`.
+ */
+export declare function getB2FileNameByteLength(name: string): number | null;
+//# sourceMappingURL=b2-naming.d.ts.map

package/dist/internal/b2-naming.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"b2-naming.d.ts","sourceRoot":"","sources":["../../src/internal/b2-naming.js"],"names":[],"mappings":"AAGA,4FAA4F;AAC5F,eAAO,MAAM,eAAe,IAAI,CAAA;AAChC,4FAA4F;AAC5F,eAAO,MAAM,eAAe,KAAK,CAAA;AACjC,gFAAgF;AAChF,eAAO,MAAM,2BAA2B,QAAQ,CAAA;AAChD,yDAAyD;AACzD,eAAO,MAAM,mBAAmB,OAAO,CAAA;AAKvC;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE/D;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAG/D;AAED;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEnE;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAKnE"}

package/dist/internal/b2-naming.d.ts

@@ -0,0 +1,43 @@
+/** 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;
+/** Reserved prefix: B2 forbids consumer-created buckets starting with `b2-`. */
+export declare const BUCKET_NAME_RESERVED_PREFIX = "b2-";
+/** Max file-name length is 1024 bytes, UTF-8 encoded. */
+export declare const FILE_NAME_MAX_BYTES = 1024;
+/**
+ * B2 bucket names may contain letters, digits, hyphens, and periods, but
+ * cannot start/end with punctuation or contain adjacent periods.
+ *
+ * @param name - Candidate bucket name.
+ *
+ * @returns Whether the name satisfies the shared B2 bucket-name shape rules.
+ */
+export declare function hasValidB2BucketNameShape(name: string): boolean;
+/**
+ * Checks whether a candidate bucket name is formatted as an IPv4 address.
+ *
+ * @param name - Candidate bucket name.
+ *
+ * @returns Whether the name is an IPv4-address-form string.
+ */
+export declare function isB2BucketNameIpv4Address(name: string): boolean;
+/**
+ * Checks for control characters that B2 rejects in names and HTTP header values.
+ *
+ * @param name - Candidate name.
+ *
+ * @returns Whether the name contains a rejected control character.
+ */
+export declare function hasB2FileNameControlCharacter(name: string): boolean;
+/**
+ * Enforces the 1024-byte B2 file-name limit. Very long strings fail before
+ * full UTF-8 encoding so untrusted input cannot force unbounded allocation.
+ *
+ * @param name - Candidate file name.
+ *
+ * @returns The UTF-8 byte length when it is within the B2 limit, otherwise `null`.
+ */
+export declare function getB2FileNameByteLength(name: string): number | null;
+//# sourceMappingURL=b2-naming.d.ts.map

package/dist/internal/b2-naming.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"b2-naming.d.ts","sourceRoot":"","sources":["../../src/internal/b2-naming.js"],"names":[],"mappings":"AAGA,4FAA4F;AAC5F,eAAO,MAAM,eAAe,IAAI,CAAA;AAChC,4FAA4F;AAC5F,eAAO,MAAM,eAAe,KAAK,CAAA;AACjC,gFAAgF;AAChF,eAAO,MAAM,2BAA2B,QAAQ,CAAA;AAChD,yDAAyD;AACzD,eAAO,MAAM,mBAAmB,OAAO,CAAA;AAKvC;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE/D;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAG/D;AAED;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEnE;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAKnE"}

package/dist/internal/b2-naming.js

@@ -0,0 +1,60 @@
+import { utf8Encoder } from "../util/text-codec.js";
+import { hasHttpHeaderControlCharacter } from "../util/http.js";
+//#region src/internal/b2-naming.ts
+/** Minimum B2 bucket-name length per https://www.backblaze.com/apidocs/b2-create-bucket. */
+var BUCKET_NAME_MIN = 6;
+/** Maximum B2 bucket-name length per https://www.backblaze.com/apidocs/b2-create-bucket. */
+var BUCKET_NAME_MAX = 63;
+/** Max file-name length is 1024 bytes, UTF-8 encoded. */
+var FILE_NAME_MAX_BYTES = 1024;
+var BUCKET_NAME_REGEX = /^[a-zA-Z0-9](?:[a-zA-Z0-9.-]*[a-zA-Z0-9])?$/;
+var IPV4_ADDRESS_SHAPE = /^\d{1,3}(?:\.\d{1,3}){3}$/;
+/**
+* B2 bucket names may contain letters, digits, hyphens, and periods, but
+* cannot start/end with punctuation or contain adjacent periods.
+*
+* @param name - Candidate bucket name.
+*
+* @returns Whether the name satisfies the shared B2 bucket-name shape rules.
+*/
+function hasValidB2BucketNameShape(name) {
+	return BUCKET_NAME_REGEX.test(name) && !name.includes("..") && !isB2BucketNameIpv4Address(name);
+}
+/**
+* Checks whether a candidate bucket name is formatted as an IPv4 address.
+*
+* @param name - Candidate bucket name.
+*
+* @returns Whether the name is an IPv4-address-form string.
+*/
+function isB2BucketNameIpv4Address(name) {
+	if (!IPV4_ADDRESS_SHAPE.test(name)) return false;
+	return name.split(".").every((part) => Number(part) <= 255);
+}
+/**
+* Checks for control characters that B2 rejects in names and HTTP header values.
+*
+* @param name - Candidate name.
+*
+* @returns Whether the name contains a rejected control character.
+*/
+function hasB2FileNameControlCharacter(name) {
+	return hasHttpHeaderControlCharacter(name);
+}
+/**
+* Enforces the 1024-byte B2 file-name limit. Very long strings fail before
+* full UTF-8 encoding so untrusted input cannot force unbounded allocation.
+*
+* @param name - Candidate file name.
+*
+* @returns The UTF-8 byte length when it is within the B2 limit, otherwise `null`.
+*/
+function getB2FileNameByteLength(name) {
+	if (name.length > 1024) return null;
+	const bytes = utf8Encoder.encode(name);
+	return bytes.byteLength > 1024 ? null : bytes.byteLength;
+}
+//#endregion
+export { BUCKET_NAME_MAX, BUCKET_NAME_MIN, FILE_NAME_MAX_BYTES, getB2FileNameByteLength, hasB2FileNameControlCharacter, hasValidB2BucketNameShape, isB2BucketNameIpv4Address };
+
+//# sourceMappingURL=b2-naming.js.map

package/dist/internal/b2-naming.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"b2-naming.js","names":[],"sources":["../../src/internal/b2-naming.ts"],"sourcesContent":["import { hasHttpHeaderControlCharacter } from '../util/http.ts'\nimport { utf8Encoder } from '../util/text-codec.ts'\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/** Reserved prefix: B2 forbids consumer-created buckets starting with `b2-`. */\nexport const BUCKET_NAME_RESERVED_PREFIX = 'b2-'\n/** Max file-name length is 1024 bytes, UTF-8 encoded. */\nexport const FILE_NAME_MAX_BYTES = 1024\n\nconst BUCKET_NAME_REGEX = /^[a-zA-Z0-9](?:[a-zA-Z0-9.-]*[a-zA-Z0-9])?$/\nconst IPV4_ADDRESS_SHAPE = /^\\d{1,3}(?:\\.\\d{1,3}){3}$/\n\n/**\n * B2 bucket names may contain letters, digits, hyphens, and periods, but\n * cannot start/end with punctuation or contain adjacent periods.\n *\n * @param name - Candidate bucket name.\n *\n * @returns Whether the name satisfies the shared B2 bucket-name shape rules.\n */\nexport function hasValidB2BucketNameShape(name: string): boolean {\n  return BUCKET_NAME_REGEX.test(name) && !name.includes('..') && !isB2BucketNameIpv4Address(name)\n}\n\n/**\n * Checks whether a candidate bucket name is formatted as an IPv4 address.\n *\n * @param name - Candidate bucket name.\n *\n * @returns Whether the name is an IPv4-address-form string.\n */\nexport function isB2BucketNameIpv4Address(name: string): boolean {\n  if (!IPV4_ADDRESS_SHAPE.test(name)) return false\n  return name.split('.').every((part) => Number(part) <= 255)\n}\n\n/**\n * Checks for control characters that B2 rejects in names and HTTP header values.\n *\n * @param name - Candidate name.\n *\n * @returns Whether the name contains a rejected control character.\n */\nexport function hasB2FileNameControlCharacter(name: string): boolean {\n  return hasHttpHeaderControlCharacter(name)\n}\n\n/**\n * Enforces the 1024-byte B2 file-name limit. Very long strings fail before\n * full UTF-8 encoding so untrusted input cannot force unbounded allocation.\n *\n * @param name - Candidate file name.\n *\n * @returns The UTF-8 byte length when it is within the B2 limit, otherwise `null`.\n */\nexport function getB2FileNameByteLength(name: string): number | null {\n  if (name.length > FILE_NAME_MAX_BYTES) return null\n\n  const bytes = utf8Encoder.encode(name)\n  return bytes.byteLength > FILE_NAME_MAX_BYTES ? null : bytes.byteLength\n}\n"],"mappings":";;;;AAIA,IAAa,kBAAkB;;AAE/B,IAAa,kBAAkB;;AAI/B,IAAa,sBAAsB;AAEnC,IAAM,oBAAoB;AAC1B,IAAM,qBAAqB;;;;;;;;;AAU3B,SAAgB,0BAA0B,MAAuB;CAC/D,OAAO,kBAAkB,KAAK,IAAI,KAAK,CAAC,KAAK,SAAS,IAAI,KAAK,CAAC,0BAA0B,IAAI;AAChG;;;;;;;;AASA,SAAgB,0BAA0B,MAAuB;CAC/D,IAAI,CAAC,mBAAmB,KAAK,IAAI,GAAG,OAAO;CAC3C,OAAO,KAAK,MAAM,GAAG,CAAC,CAAC,OAAO,SAAS,OAAO,IAAI,KAAK,GAAG;AAC5D;;;;;;;;AASA,SAAgB,8BAA8B,MAAuB;CACnE,OAAO,8BAA8B,IAAI;AAC3C;;;;;;;;;AAUA,SAAgB,wBAAwB,MAA6B;CACnE,IAAI,KAAK,SAAA,MAA8B,OAAO;CAE9C,MAAM,QAAQ,YAAY,OAAO,IAAI;CACrC,OAAO,MAAM,aAAA,OAAmC,OAAO,MAAM;AAC/D"}

package/dist/internal/upload-retry-options.cjs

@@ -0,0 +1,21 @@
+//#region src/internal/upload-retry-options.ts
+/**
+* Merges client upload retry defaults with a per-call override.
+* @param defaults - Resolved client upload retry defaults.
+* @param override - Per-call retry option overrides, if any.
+*
+* @returns Retry options for one high-level upload operation.
+*
+* @internal
+*/
+function mergeUploadRetryOptions(defaults, override) {
+	if (override === void 0) return defaults;
+	return {
+		...defaults,
+		...override
+	};
+}
+//#endregion
+exports.mergeUploadRetryOptions = mergeUploadRetryOptions;
+
+//# sourceMappingURL=upload-retry-options.cjs.map

package/dist/internal/upload-retry-options.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload-retry-options.cjs","names":[],"sources":["../../src/internal/upload-retry-options.ts"],"sourcesContent":["import type { RetryOptions } from '../http/retry.ts'\n\n/**\n * Merges client upload retry defaults with a per-call override.\n * @param defaults - Resolved client upload retry defaults.\n * @param override - Per-call retry option overrides, if any.\n *\n * @returns Retry options for one high-level upload operation.\n *\n * @internal\n */\nexport function mergeUploadRetryOptions(\n  defaults: RetryOptions,\n  override: Partial<RetryOptions> | undefined,\n): RetryOptions {\n  if (override === undefined) return defaults\n  return { ...defaults, ...override }\n}\n"],"mappings":";;;;;;;;;;AAWA,SAAgB,wBACd,UACA,UACc;CACd,IAAI,aAAa,KAAA,GAAW,OAAO;CACnC,OAAO;EAAE,GAAG;EAAU,GAAG;CAAS;AACpC"}

package/dist/internal/upload-retry-options.d.cts

@@ -0,0 +1,12 @@
+import { RetryOptions } from '../http/retry.js';
+/**
+ * Merges client upload retry defaults with a per-call override.
+ * @param defaults - Resolved client upload retry defaults.
+ * @param override - Per-call retry option overrides, if any.
+ *
+ * @returns Retry options for one high-level upload operation.
+ *
+ * @internal
+ */
+export declare function mergeUploadRetryOptions(defaults: RetryOptions, override: Partial<RetryOptions> | undefined): RetryOptions;
+//# sourceMappingURL=upload-retry-options.d.ts.map

package/dist/internal/upload-retry-options.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload-retry-options.d.ts","sourceRoot":"","sources":["../../src/internal/upload-retry-options.js"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAEpD;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,YAAY,EACtB,QAAQ,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,SAAS,GAC1C,YAAY,CAGd"}

package/dist/internal/upload-retry-options.d.ts

@@ -0,0 +1,12 @@
+import { RetryOptions } from '../http/retry.js';
+/**
+ * Merges client upload retry defaults with a per-call override.
+ * @param defaults - Resolved client upload retry defaults.
+ * @param override - Per-call retry option overrides, if any.
+ *
+ * @returns Retry options for one high-level upload operation.
+ *
+ * @internal
+ */
+export declare function mergeUploadRetryOptions(defaults: RetryOptions, override: Partial<RetryOptions> | undefined): RetryOptions;
+//# sourceMappingURL=upload-retry-options.d.ts.map

package/dist/internal/upload-retry-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload-retry-options.d.ts","sourceRoot":"","sources":["../../src/internal/upload-retry-options.js"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAEpD;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,YAAY,EACtB,QAAQ,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,SAAS,GAC1C,YAAY,CAGd"}

package/dist/internal/upload-retry-options.js

@@ -0,0 +1,21 @@
+//#region src/internal/upload-retry-options.ts
+/**
+* Merges client upload retry defaults with a per-call override.
+* @param defaults - Resolved client upload retry defaults.
+* @param override - Per-call retry option overrides, if any.
+*
+* @returns Retry options for one high-level upload operation.
+*
+* @internal
+*/
+function mergeUploadRetryOptions(defaults, override) {
+	if (override === void 0) return defaults;
+	return {
+		...defaults,
+		...override
+	};
+}
+//#endregion
+export { mergeUploadRetryOptions };
+
+//# sourceMappingURL=upload-retry-options.js.map

package/dist/internal/upload-retry-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload-retry-options.js","names":[],"sources":["../../src/internal/upload-retry-options.ts"],"sourcesContent":["import type { RetryOptions } from '../http/retry.ts'\n\n/**\n * Merges client upload retry defaults with a per-call override.\n * @param defaults - Resolved client upload retry defaults.\n * @param override - Per-call retry option overrides, if any.\n *\n * @returns Retry options for one high-level upload operation.\n *\n * @internal\n */\nexport function mergeUploadRetryOptions(\n  defaults: RetryOptions,\n  override: Partial<RetryOptions> | undefined,\n): RetryOptions {\n  if (override === undefined) return defaults\n  return { ...defaults, ...override }\n}\n"],"mappings":";;;;;;;;;;AAWA,SAAgB,wBACd,UACA,UACc;CACd,IAAI,aAAa,KAAA,GAAW,OAAO;CACnC,OAAO;EAAE,GAAG;EAAU,GAAG;CAAS;AACpC"}

package/dist/internal/url-redaction.cjs

@@ -0,0 +1,31 @@
+//#region src/internal/url-redaction.ts
+/**
+* Redact a URL before including it in an error message.
+*
+* @param url - Absolute URL, relative URL, or parsed URL to redact.
+* @param options - Optional base URL and invalid-URL placeholder.
+*
+* @returns A URL string with userinfo, query string, fragment, and path
+* segments removed.
+*/
+function redactUrlForError(url, options = {}) {
+	try {
+		const parsed = url instanceof URL ? new URL(url) : options.baseUrl !== void 0 ? new URL(url, options.baseUrl) : new URL(url);
+		if (parsed.protocol !== "http:" && parsed.protocol !== "https:") return options.invalidUrlLabel ?? "<invalid URL>";
+		parsed.username = "";
+		parsed.password = "";
+		parsed.search = "";
+		parsed.hash = "";
+		parsed.pathname = redactPathname(parsed.pathname);
+		return parsed.toString();
+	} catch {
+		return options.invalidUrlLabel ?? "<invalid URL>";
+	}
+}
+function redactPathname(pathname) {
+	return pathname.split("/").some(Boolean) ? "/..." : pathname;
+}
+//#endregion
+exports.redactUrlForError = redactUrlForError;
+
+//# sourceMappingURL=url-redaction.cjs.map

package/dist/internal/url-redaction.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-redaction.cjs","names":[],"sources":["../../src/internal/url-redaction.ts"],"sourcesContent":["export interface RedactUrlForErrorOptions {\n  /** Base URL used to resolve relative URL inputs. */\n  readonly baseUrl?: string\n  /** Placeholder returned when parsing fails. */\n  readonly invalidUrlLabel?: string\n}\n\n/**\n * Redact a URL before including it in an error message.\n *\n * @param url - Absolute URL, relative URL, or parsed URL to redact.\n * @param options - Optional base URL and invalid-URL placeholder.\n *\n * @returns A URL string with userinfo, query string, fragment, and path\n * segments removed.\n */\nexport function redactUrlForError(\n  url: string | URL,\n  options: RedactUrlForErrorOptions = {},\n): string {\n  try {\n    const parsed =\n      url instanceof URL\n        ? new URL(url)\n        : options.baseUrl !== undefined\n          ? new URL(url, options.baseUrl)\n          : new URL(url)\n    if (parsed.protocol !== 'http:' && parsed.protocol !== 'https:') {\n      return options.invalidUrlLabel ?? '<invalid URL>'\n    }\n    parsed.username = ''\n    parsed.password = ''\n    parsed.search = ''\n    parsed.hash = ''\n    parsed.pathname = redactPathname(parsed.pathname)\n    return parsed.toString()\n  } catch {\n    return options.invalidUrlLabel ?? '<invalid URL>'\n  }\n}\n\nfunction redactPathname(pathname: string): string {\n  return pathname.split('/').some(Boolean) ? '/...' : pathname\n}\n"],"mappings":";;;;;;;;;;AAgBA,SAAgB,kBACd,KACA,UAAoC,CAAC,GAC7B;CACR,IAAI;EACF,MAAM,SACJ,eAAe,MACX,IAAI,IAAI,GAAG,IACX,QAAQ,YAAY,KAAA,IAClB,IAAI,IAAI,KAAK,QAAQ,OAAO,IAC5B,IAAI,IAAI,GAAG;EACnB,IAAI,OAAO,aAAa,WAAW,OAAO,aAAa,UACrD,OAAO,QAAQ,mBAAmB;EAEpC,OAAO,WAAW;EAClB,OAAO,WAAW;EAClB,OAAO,SAAS;EAChB,OAAO,OAAO;EACd,OAAO,WAAW,eAAe,OAAO,QAAQ;EAChD,OAAO,OAAO,SAAS;CACzB,QAAQ;EACN,OAAO,QAAQ,mBAAmB;CACpC;AACF;AAEA,SAAS,eAAe,UAA0B;CAChD,OAAO,SAAS,MAAM,GAAG,CAAC,CAAC,KAAK,OAAO,IAAI,SAAS;AACtD"}

package/dist/internal/url-redaction.d.cts

@@ -0,0 +1,17 @@
+export interface RedactUrlForErrorOptions {
+    /** Base URL used to resolve relative URL inputs. */
+    readonly baseUrl?: string;
+    /** Placeholder returned when parsing fails. */
+    readonly invalidUrlLabel?: string;
+}
+/**
+ * Redact a URL before including it in an error message.
+ *
+ * @param url - Absolute URL, relative URL, or parsed URL to redact.
+ * @param options - Optional base URL and invalid-URL placeholder.
+ *
+ * @returns A URL string with userinfo, query string, fragment, and path
+ * segments removed.
+ */
+export declare function redactUrlForError(url: string | URL, options?: RedactUrlForErrorOptions): string;
+//# sourceMappingURL=url-redaction.d.ts.map

package/dist/internal/url-redaction.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-redaction.d.ts","sourceRoot":"","sources":["../../src/internal/url-redaction.js"],"names":[],"mappings":"AAAA,MAAM,WAAW,wBAAwB;IACvC,oDAAoD;IACpD,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB,+CAA+C;IAC/C,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CAClC;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,MAAM,GAAG,GAAG,EACjB,OAAO,GAAE,wBAA6B,GACrC,MAAM,CAoBR"}

package/dist/internal/url-redaction.d.ts

@@ -0,0 +1,17 @@
+export interface RedactUrlForErrorOptions {
+    /** Base URL used to resolve relative URL inputs. */
+    readonly baseUrl?: string;
+    /** Placeholder returned when parsing fails. */
+    readonly invalidUrlLabel?: string;
+}
+/**
+ * Redact a URL before including it in an error message.
+ *
+ * @param url - Absolute URL, relative URL, or parsed URL to redact.
+ * @param options - Optional base URL and invalid-URL placeholder.
+ *
+ * @returns A URL string with userinfo, query string, fragment, and path
+ * segments removed.
+ */
+export declare function redactUrlForError(url: string | URL, options?: RedactUrlForErrorOptions): string;
+//# sourceMappingURL=url-redaction.d.ts.map

package/dist/internal/url-redaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-redaction.d.ts","sourceRoot":"","sources":["../../src/internal/url-redaction.js"],"names":[],"mappings":"AAAA,MAAM,WAAW,wBAAwB;IACvC,oDAAoD;IACpD,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB,+CAA+C;IAC/C,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CAClC;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,MAAM,GAAG,GAAG,EACjB,OAAO,GAAE,wBAA6B,GACrC,MAAM,CAoBR"}

package/dist/internal/url-redaction.js

@@ -0,0 +1,31 @@
+//#region src/internal/url-redaction.ts
+/**
+* Redact a URL before including it in an error message.
+*
+* @param url - Absolute URL, relative URL, or parsed URL to redact.
+* @param options - Optional base URL and invalid-URL placeholder.
+*
+* @returns A URL string with userinfo, query string, fragment, and path
+* segments removed.
+*/
+function redactUrlForError(url, options = {}) {
+	try {
+		const parsed = url instanceof URL ? new URL(url) : options.baseUrl !== void 0 ? new URL(url, options.baseUrl) : new URL(url);
+		if (parsed.protocol !== "http:" && parsed.protocol !== "https:") return options.invalidUrlLabel ?? "<invalid URL>";
+		parsed.username = "";
+		parsed.password = "";
+		parsed.search = "";
+		parsed.hash = "";
+		parsed.pathname = redactPathname(parsed.pathname);
+		return parsed.toString();
+	} catch {
+		return options.invalidUrlLabel ?? "<invalid URL>";
+	}
+}
+function redactPathname(pathname) {
+	return pathname.split("/").some(Boolean) ? "/..." : pathname;
+}
+//#endregion
+export { redactUrlForError };
+
+//# sourceMappingURL=url-redaction.js.map

package/dist/internal/url-redaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-redaction.js","names":[],"sources":["../../src/internal/url-redaction.ts"],"sourcesContent":["export interface RedactUrlForErrorOptions {\n  /** Base URL used to resolve relative URL inputs. */\n  readonly baseUrl?: string\n  /** Placeholder returned when parsing fails. */\n  readonly invalidUrlLabel?: string\n}\n\n/**\n * Redact a URL before including it in an error message.\n *\n * @param url - Absolute URL, relative URL, or parsed URL to redact.\n * @param options - Optional base URL and invalid-URL placeholder.\n *\n * @returns A URL string with userinfo, query string, fragment, and path\n * segments removed.\n */\nexport function redactUrlForError(\n  url: string | URL,\n  options: RedactUrlForErrorOptions = {},\n): string {\n  try {\n    const parsed =\n      url instanceof URL\n        ? new URL(url)\n        : options.baseUrl !== undefined\n          ? new URL(url, options.baseUrl)\n          : new URL(url)\n    if (parsed.protocol !== 'http:' && parsed.protocol !== 'https:') {\n      return options.invalidUrlLabel ?? '<invalid URL>'\n    }\n    parsed.username = ''\n    parsed.password = ''\n    parsed.search = ''\n    parsed.hash = ''\n    parsed.pathname = redactPathname(parsed.pathname)\n    return parsed.toString()\n  } catch {\n    return options.invalidUrlLabel ?? '<invalid URL>'\n  }\n}\n\nfunction redactPathname(pathname: string): string {\n  return pathname.split('/').some(Boolean) ? '/...' : pathname\n}\n"],"mappings":";;;;;;;;;;AAgBA,SAAgB,kBACd,KACA,UAAoC,CAAC,GAC7B;CACR,IAAI;EACF,MAAM,SACJ,eAAe,MACX,IAAI,IAAI,GAAG,IACX,QAAQ,YAAY,KAAA,IAClB,IAAI,IAAI,KAAK,QAAQ,OAAO,IAC5B,IAAI,IAAI,GAAG;EACnB,IAAI,OAAO,aAAa,WAAW,OAAO,aAAa,UACrD,OAAO,QAAQ,mBAAmB;EAEpC,OAAO,WAAW;EAClB,OAAO,WAAW;EAClB,OAAO,SAAS;EAChB,OAAO,OAAO;EACd,OAAO,WAAW,eAAe,OAAO,QAAQ;EAChD,OAAO,OAAO,SAAS;CACzB,QAAQ;EACN,OAAO,QAAQ,mBAAmB;CACpC;AACF;AAEA,SAAS,eAAe,UAA0B;CAChD,OAAO,SAAS,MAAM,GAAG,CAAC,CAAC,KAAK,OAAO,IAAI,SAAS;AACtD"}

package/dist/notifications/index.cjs

@@ -1,7 +1,5 @@
-"use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const webhook = require("./webhook.cjs");
-exports.B2_WEBHOOK_SIGNATURE_HEADER = webhook.B2_WEBHOOK_SIGNATURE_HEADER;
-exports.requireValidWebhook = webhook.requireValidWebhook;
-exports.verifyWebhookSignature = webhook.verifyWebhookSignature;
-//# sourceMappingURL=index.cjs.map
+const require_webhook = require("./webhook.cjs");
+exports.B2_WEBHOOK_SIGNATURE_HEADER = require_webhook.B2_WEBHOOK_SIGNATURE_HEADER;
+exports.requireValidWebhook = require_webhook.requireValidWebhook;
+exports.verifyWebhookSignature = require_webhook.verifyWebhookSignature;

package/dist/notifications/index.d.cts

@@ -1,3 +1,3 @@
-export { B2_WEBHOOK_SIGNATURE_HEADER, requireValidWebhook, verifyWebhookSignature, } from './webhook.js';
 export type { VerifyWebhookOptions, VerifyWebhookResult, WebhookEvent, WebhookPayload, } from './webhook.js';
+export { B2_WEBHOOK_SIGNATURE_HEADER, requireValidWebhook, verifyWebhookSignature, } from './webhook.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/notifications/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/notifications/index.js"],"names":[],"mappings":"AAAA,OAAO,EACL,2BAA2B,EAC3B,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,cAAc,CAAA;AACrB,YAAY,EACV,oBAAoB,EACpB,mBAAmB,EACnB,YAAY,EACZ,cAAc,GACf,MAAM,cAAc,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/notifications/index.js"],"names":[],"mappings":"AAAA,YAAY,EACV,oBAAoB,EACpB,mBAAmB,EACnB,YAAY,EACZ,cAAc,GACf,MAAM,cAAc,CAAA;AACrB,OAAO,EACL,2BAA2B,EAC3B,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,cAAc,CAAA"}

package/dist/notifications/index.d.ts

@@ -1,3 +1,3 @@
-export { B2_WEBHOOK_SIGNATURE_HEADER, requireValidWebhook, verifyWebhookSignature, } from './webhook.js';
 export type { VerifyWebhookOptions, VerifyWebhookResult, WebhookEvent, WebhookPayload, } from './webhook.js';
+export { B2_WEBHOOK_SIGNATURE_HEADER, requireValidWebhook, verifyWebhookSignature, } from './webhook.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/notifications/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/notifications/index.js"],"names":[],"mappings":"AAAA,OAAO,EACL,2BAA2B,EAC3B,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,cAAc,CAAA;AACrB,YAAY,EACV,oBAAoB,EACpB,mBAAmB,EACnB,YAAY,EACZ,cAAc,GACf,MAAM,cAAc,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/notifications/index.js"],"names":[],"mappings":"AAAA,YAAY,EACV,oBAAoB,EACpB,mBAAmB,EACnB,YAAY,EACZ,cAAc,GACf,MAAM,cAAc,CAAA;AACrB,OAAO,EACL,2BAA2B,EAC3B,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,cAAc,CAAA"}

package/dist/notifications/index.js

@@ -1,7 +1,2 @@
 import { B2_WEBHOOK_SIGNATURE_HEADER, requireValidWebhook, verifyWebhookSignature } from "./webhook.js";
-export {
-  B2_WEBHOOK_SIGNATURE_HEADER,
-  requireValidWebhook,
-  verifyWebhookSignature
-};
-//# sourceMappingURL=index.js.map
+export { B2_WEBHOOK_SIGNATURE_HEADER, requireValidWebhook, verifyWebhookSignature };