@backblaze-labs/b2-sdk 0.1.0 → 0.2.0

package/dist/http/user-agent.js.map

@@ -1 +1 @@
-{"version":3,"file":"user-agent.js","sources":["../../src/http/user-agent.ts"],"sourcesContent":["import { VERSION } from '../version.ts'\n\n/**\n * Stable identifier Backblaze can grep server logs for to find every request\n * issued by this SDK regardless of how the User-Agent comment evolves.\n * Treat as part of the public contract: do NOT rename without coordinating.\n */\nexport const SDK_PRODUCT = 'b2-sdk-typescript'\n\n/**\n * The npm package name. Embedded in the User-Agent comment alongside\n * {@link SDK_PRODUCT} so log queries that grep on either token work.\n */\nexport const SDK_PACKAGE = '@backblaze-labs/b2-sdk'\n\n/** Detected runtime + OS information for the User-Agent comment. */\ninterface Platform {\n  /** Runtime identifier: `node/<x.y.z>`, `bun/<x.y.z>`, `deno/<x.y.z>`, `browser`, or `unknown`. */\n  readonly runtime: string\n  /** OS identifier (`linux`, `darwin`, `win32`, etc.) when available, or `undefined`. */\n  readonly os: string | undefined\n  /** CPU architecture (`x64`, `arm64`, etc.) when available, or `undefined`. */\n  readonly arch: string | undefined\n}\n\n/**\n * Best-effort detection of the JS runtime and host OS. Used to populate the\n * User-Agent comment so server-side logs can spot Bun/Deno adoption and\n * triage OS-specific issues without asking for a repro environment.\n *\n * @returns The detected runtime, OS, and architecture tokens.\n */\nfunction detectPlatform(): Platform {\n  const g = globalThis as Record<string, unknown>\n\n  // Deno: Deno.version.deno, Deno.build.{os,arch}.\n  if (typeof g['Deno'] !== 'undefined') {\n    const deno = g['Deno'] as {\n      version?: { deno?: string }\n      build?: { os?: string; arch?: string }\n    }\n    return {\n      runtime: deno.version?.deno ? `deno/${deno.version.deno}` : 'deno',\n      os: deno.build?.os,\n      arch: deno.build?.arch,\n    }\n  }\n\n  // Bun: globalThis.Bun.version, process.platform/arch (Bun is Node-compat).\n  if (typeof g['Bun'] !== 'undefined') {\n    const bun = g['Bun'] as { version?: string }\n    const proc = g['process'] as { platform?: string; arch?: string } | undefined\n    return {\n      runtime: bun.version ? `bun/${bun.version}` : 'bun',\n      os: proc?.platform,\n      arch: proc?.arch,\n    }\n  }\n\n  // Node: process.versions.node, process.platform, process.arch.\n  if (typeof g['process'] !== 'undefined') {\n    const proc = g['process'] as {\n      versions?: { node?: string }\n      platform?: string\n      arch?: string\n    }\n    if (proc.versions?.node) {\n      return {\n        runtime: `node/${proc.versions.node}`,\n        os: proc.platform,\n        arch: proc.arch,\n      }\n    }\n  }\n\n  // Browsers (and other navigator-only runtimes like Cloudflare Workers,\n  // Vercel Edge, etc.). We deliberately do NOT parse the existing navigator\n  // UA — that's noisy, often spoofed, and the request layer already adds the\n  // browser's own UA on top.\n  if (typeof g['navigator'] !== 'undefined') {\n    return { runtime: 'browser', os: undefined, arch: undefined }\n  }\n\n  return { runtime: 'unknown', os: undefined, arch: undefined }\n}\n\n/**\n * Build the User-Agent header value the SDK sends on every B2 request.\n *\n * The product token, npm package name, language label, runtime, OS, and\n * architecture are emitted in that order, separated by semicolons inside a\n * single parenthesised comment block. OS and architecture are omitted on\n * runtimes that don't expose them (notably browsers). A custom prefix passed\n * via `B2ClientOptions.userAgent` is prepended verbatim so app-level\n * identifiers come first. See the README \"Identifying your traffic\" section\n * for examples.\n *\n * @param custom - Optional prefix prepended to the default User-Agent.\n *\n * @returns The formatted User-Agent header string.\n */\nexport function getUserAgent(custom?: string): string {\n  const { runtime, os, arch } = detectPlatform()\n  const parts = ['typescript', SDK_PACKAGE, runtime]\n  if (os !== undefined) parts.push(os)\n  if (arch !== undefined) parts.push(arch)\n  const base = `${SDK_PRODUCT}/${VERSION} (${parts.join('; ')})`\n  return custom ? `${custom} ${base}` : base\n}\n"],"names":[],"mappings":";AAOO,MAAM,cAAc;AAMpB,MAAM,cAAc;AAmB3B,SAAS,iBAA2B;AAClC,QAAM,IAAI;AAGV,MAAI,OAAO,EAAE,MAAM,MAAM,aAAa;AACpC,UAAM,OAAO,EAAE,MAAM;AAIrB,WAAO;AAAA,MACL,SAAS,KAAK,SAAS,OAAO,QAAQ,KAAK,QAAQ,IAAI,KAAK;AAAA,MAC5D,IAAI,KAAK,OAAO;AAAA,MAChB,MAAM,KAAK,OAAO;AAAA,IAAA;AAAA,EAEtB;AAGA,MAAI,OAAO,EAAE,KAAK,MAAM,aAAa;AACnC,UAAM,MAAM,EAAE,KAAK;AACnB,UAAM,OAAO,EAAE,SAAS;AACxB,WAAO;AAAA,MACL,SAAS,IAAI,UAAU,OAAO,IAAI,OAAO,KAAK;AAAA,MAC9C,IAAI,MAAM;AAAA,MACV,MAAM,MAAM;AAAA,IAAA;AAAA,EAEhB;AAGA,MAAI,OAAO,EAAE,SAAS,MAAM,aAAa;AACvC,UAAM,OAAO,EAAE,SAAS;AAKxB,QAAI,KAAK,UAAU,MAAM;AACvB,aAAO;AAAA,QACL,SAAS,QAAQ,KAAK,SAAS,IAAI;AAAA,QACnC,IAAI,KAAK;AAAA,QACT,MAAM,KAAK;AAAA,MAAA;AAAA,IAEf;AAAA,EACF;AAMA,MAAI,OAAO,EAAE,WAAW,MAAM,aAAa;AACzC,WAAO,EAAE,SAAS,WAAW,IAAI,QAAW,MAAM,OAAA;AAAA,EACpD;AAEA,SAAO,EAAE,SAAS,WAAW,IAAI,QAAW,MAAM,OAAA;AACpD;AAiBO,SAAS,aAAa,QAAyB;AACpD,QAAM,EAAE,SAAS,IAAI,KAAA,IAAS,eAAA;AAC9B,QAAM,QAAQ,CAAC,cAAc,aAAa,OAAO;AACjD,MAAI,OAAO,OAAW,OAAM,KAAK,EAAE;AACnC,MAAI,SAAS,OAAW,OAAM,KAAK,IAAI;AACvC,QAAM,OAAO,GAAG,WAAW,IAAI,OAAO,KAAK,MAAM,KAAK,IAAI,CAAC;AAC3D,SAAO,SAAS,GAAG,MAAM,IAAI,IAAI,KAAK;AACxC;"}
+{"version":3,"file":"user-agent.js","names":[],"sources":["../../src/http/user-agent.ts"],"sourcesContent":["import { VERSION } from '../version.ts'\n\n/**\n * Stable identifier Backblaze can grep server logs for to find every request\n * issued by this SDK regardless of how the User-Agent comment evolves.\n * Treat as part of the public contract: do NOT rename without coordinating.\n */\nexport const SDK_PRODUCT = 'b2-sdk-typescript'\n\n/**\n * The npm package name. Embedded in the User-Agent comment alongside\n * {@link SDK_PRODUCT} so log queries that grep on either token work.\n */\nexport const SDK_PACKAGE = '@backblaze-labs/b2-sdk'\n\n/** Detected runtime + OS information for the User-Agent comment. */\ninterface Platform {\n  /** Runtime identifier: `node/<x.y.z>`, `bun/<x.y.z>`, `deno/<x.y.z>`, `browser`, or `unknown`. */\n  readonly runtime: string\n  /** OS identifier (`linux`, `darwin`, `win32`, etc.) when available, or `undefined`. */\n  readonly os: string | undefined\n  /** CPU architecture (`x64`, `arm64`, etc.) when available, or `undefined`. */\n  readonly arch: string | undefined\n}\n\n/**\n * Best-effort detection of the JS runtime and host OS. Used to populate the\n * User-Agent comment so server-side logs can spot Bun/Deno adoption and\n * triage OS-specific issues without asking for a repro environment.\n *\n * @returns The detected runtime, OS, and architecture tokens.\n */\nfunction detectPlatform(): Platform {\n  const g = globalThis as Record<string, unknown>\n\n  // Deno: Deno.version.deno, Deno.build.{os,arch}.\n  if (typeof g['Deno'] !== 'undefined') {\n    const deno = g['Deno'] as {\n      version?: { deno?: string }\n      build?: { os?: string; arch?: string }\n    }\n    return {\n      runtime: deno.version?.deno ? `deno/${deno.version.deno}` : 'deno',\n      os: deno.build?.os,\n      arch: deno.build?.arch,\n    }\n  }\n\n  // Bun: globalThis.Bun.version, process.platform/arch (Bun is Node-compat).\n  if (typeof g['Bun'] !== 'undefined') {\n    const bun = g['Bun'] as { version?: string }\n    const proc = g['process'] as { platform?: string; arch?: string } | undefined\n    return {\n      runtime: bun.version ? `bun/${bun.version}` : 'bun',\n      os: proc?.platform,\n      arch: proc?.arch,\n    }\n  }\n\n  // Node: process.versions.node, process.platform, process.arch.\n  if (typeof g['process'] !== 'undefined') {\n    const proc = g['process'] as {\n      versions?: { node?: string }\n      platform?: string\n      arch?: string\n    }\n    if (proc.versions?.node) {\n      return {\n        runtime: `node/${proc.versions.node}`,\n        os: proc.platform,\n        arch: proc.arch,\n      }\n    }\n  }\n\n  // Browsers (and other navigator-only runtimes like Cloudflare Workers,\n  // Vercel Edge, etc.). We deliberately do NOT parse the existing navigator\n  // UA — that's noisy, often spoofed, and the request layer already adds the\n  // browser's own UA on top.\n  if (typeof g['navigator'] !== 'undefined') {\n    return { runtime: 'browser', os: undefined, arch: undefined }\n  }\n\n  return { runtime: 'unknown', os: undefined, arch: undefined }\n}\n\n/**\n * Build the User-Agent header value the SDK sends on every B2 request.\n *\n * The product token, npm package name, language label, runtime, OS, and\n * architecture are emitted in that order, separated by semicolons inside a\n * single parenthesised comment block. OS and architecture are omitted on\n * runtimes that don't expose them (notably browsers). A custom prefix passed\n * via `B2ClientOptions.userAgent` is prepended verbatim so app-level\n * identifiers come first. See the README \"Identifying your traffic\" section\n * for examples.\n *\n * @param custom - Optional prefix prepended to the default User-Agent.\n *\n * @returns The formatted User-Agent header string.\n */\nexport function getUserAgent(custom?: string): string {\n  const { runtime, os, arch } = detectPlatform()\n  const parts = ['typescript', SDK_PACKAGE, runtime]\n  if (os !== undefined) parts.push(os)\n  if (arch !== undefined) parts.push(arch)\n  const base = `${SDK_PRODUCT}/${VERSION} (${parts.join('; ')})`\n  return custom ? `${custom} ${base}` : base\n}\n"],"mappings":";;;;;;;AAOA,IAAa,cAAc;;;;;AAM3B,IAAa,cAAc;;;;;;;;AAmB3B,SAAS,iBAA2B;CAClC,MAAM,IAAI;CAGV,IAAI,OAAO,EAAE,YAAY,aAAa;EACpC,MAAM,OAAO,EAAE;EAIf,OAAO;GACL,SAAS,KAAK,SAAS,OAAO,QAAQ,KAAK,QAAQ,SAAS;GAC5D,IAAI,KAAK,OAAO;GAChB,MAAM,KAAK,OAAO;EACpB;CACF;CAGA,IAAI,OAAO,EAAE,WAAW,aAAa;EACnC,MAAM,MAAM,EAAE;EACd,MAAM,OAAO,EAAE;EACf,OAAO;GACL,SAAS,IAAI,UAAU,OAAO,IAAI,YAAY;GAC9C,IAAI,MAAM;GACV,MAAM,MAAM;EACd;CACF;CAGA,IAAI,OAAO,EAAE,eAAe,aAAa;EACvC,MAAM,OAAO,EAAE;EAKf,IAAI,KAAK,UAAU,MACjB,OAAO;GACL,SAAS,QAAQ,KAAK,SAAS;GAC/B,IAAI,KAAK;GACT,MAAM,KAAK;EACb;CAEJ;CAMA,IAAI,OAAO,EAAE,iBAAiB,aAC5B,OAAO;EAAE,SAAS;EAAW,IAAI,KAAA;EAAW,MAAM,KAAA;CAAU;CAG9D,OAAO;EAAE,SAAS;EAAW,IAAI,KAAA;EAAW,MAAM,KAAA;CAAU;AAC9D;;;;;;;;;;;;;;;;AAiBA,SAAgB,aAAa,QAAyB;CACpD,MAAM,EAAE,SAAS,IAAI,SAAS,eAAe;CAC7C,MAAM,QAAQ;EAAC;EAAc;EAAa;CAAO;CACjD,IAAI,OAAO,KAAA,GAAW,MAAM,KAAK,EAAE;CACnC,IAAI,SAAS,KAAA,GAAW,MAAM,KAAK,IAAI;CACvC,MAAM,OAAO,GAAG,YAAY,GAAG,QAAQ,IAAI,MAAM,KAAK,IAAI,EAAE;CAC5D,OAAO,SAAS,GAAG,OAAO,GAAG,SAAS;AACxC"}

package/dist/index.cjs

@@ -1,78 +1,102 @@
-"use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const client = require("./client.cjs");
-const bucket = require("./bucket.cjs");
-const object = require("./object.cjs");
-const raw_index = require("./raw/index.cjs");
-const errors_index = require("./errors/index.cjs");
-const inMemory = require("./auth/in-memory.cjs");
-const hash = require("./streams/hash.cjs");
-const source = require("./streams/source.cjs");
-const transport = require("./http/transport.cjs");
-const urlGuard = require("./http/url-guard.cjs");
-const encryption = require("./types/encryption.cjs");
-const paginator = require("./util/paginator.cjs");
-const bucket$1 = require("./types/bucket.cjs");
-const auth = require("./types/auth.cjs");
-const notifications = require("./types/notifications.cjs");
-const file = require("./types/file.cjs");
-const lock = require("./types/lock.cjs");
-const ids = require("./types/ids.cjs");
-const version = require("./version.cjs");
-exports.B2Client = client.B2Client;
-exports.Bucket = bucket.Bucket;
-exports.B2Object = object.B2Object;
-exports.RawClient = raw_index.RawClient;
-exports.AccessDeniedError = errors_index.AccessDeniedError;
-exports.B2Error = errors_index.B2Error;
-exports.B2InsufficientCapabilityError = errors_index.B2InsufficientCapabilityError;
-exports.B2SsrfError = errors_index.B2SsrfError;
-exports.BadAuthTokenError = errors_index.BadAuthTokenError;
-exports.BadRequestError = errors_index.BadRequestError;
-exports.BadUploadUrlError = errors_index.BadUploadUrlError;
-exports.CapExceededError = errors_index.CapExceededError;
-exports.ChecksumMismatchError = errors_index.ChecksumMismatchError;
-exports.DuplicateBucketNameError = errors_index.DuplicateBucketNameError;
-exports.ExpiredAuthTokenError = errors_index.ExpiredAuthTokenError;
-exports.FileNotPresentError = errors_index.FileNotPresentError;
-exports.NetworkError = errors_index.NetworkError;
-exports.RequestTimeoutError = errors_index.RequestTimeoutError;
-exports.ServiceUnavailableError = errors_index.ServiceUnavailableError;
-exports.TooManyRequestsError = errors_index.TooManyRequestsError;
-exports.classifyError = errors_index.classifyError;
-exports.InMemoryAccountInfo = inMemory.InMemoryAccountInfo;
-exports.IncrementalSha1 = hash.IncrementalSha1;
-exports.sha1Hex = hash.sha1Hex;
-exports.BlobSource = source.BlobSource;
-exports.BufferSource = source.BufferSource;
-exports.StreamSource = source.StreamSource;
-exports.toContentSource = source.toContentSource;
-exports.FetchTransport = transport.FetchTransport;
-exports.RetryTransport = transport.RetryTransport;
-exports.UrlGuard = urlGuard.UrlGuard;
-exports.deriveAllowedSuffixes = urlGuard.deriveAllowedSuffixes;
-exports.EncryptionAlgorithm = encryption.EncryptionAlgorithm;
-exports.EncryptionKey = encryption.EncryptionKey;
-exports.EncryptionMode = encryption.EncryptionMode;
-exports.SSE_B2 = encryption.SSE_B2;
-exports.SSE_NONE = encryption.SSE_NONE;
-exports.sseCustomer = encryption.sseCustomer;
-exports.paginateItems = paginator.paginateItems;
-exports.paginatePages = paginator.paginatePages;
-exports.BucketRetentionMode = bucket$1.BucketRetentionMode;
-exports.BucketType = bucket$1.BucketType;
-exports.CorsOperation = bucket$1.CorsOperation;
-exports.Capability = auth.Capability;
-exports.EventType = notifications.EventType;
-exports.FileAction = file.FileAction;
-exports.MetadataDirective = file.MetadataDirective;
-exports.LegalHoldValue = lock.LegalHoldValue;
-exports.RetentionMode = lock.RetentionMode;
-exports.accountId = ids.accountId;
-exports.applicationKeyId = ids.applicationKeyId;
-exports.bucketId = ids.bucketId;
-exports.fileId = ids.fileId;
-exports.keyId = ids.keyId;
-exports.largeFileId = ids.largeFileId;
-exports.VERSION = version.VERSION;
-//# sourceMappingURL=index.cjs.map
+const require_in_memory = require("./auth/in-memory.cjs");
+const require_file = require("./types/file.cjs");
+const require_ids = require("./types/ids.cjs");
+const require_errors = require("./types/errors.cjs");
+const require_errors_index = require("./errors/index.cjs");
+const require_hash = require("./streams/hash.cjs");
+const require_file_source = require("./streams/file-source.cjs");
+const require_source = require("./streams/source.cjs");
+const require_bucket = require("./types/bucket.cjs");
+const require_encryption = require("./types/encryption.cjs");
+const require_object = require("./object.cjs");
+const require_paginator = require("./util/paginator.cjs");
+const require_bucket$1 = require("./bucket.cjs");
+const require_url_guard = require("./http/url-guard.cjs");
+const require_version = require("./version.cjs");
+const require_transport = require("./http/transport.cjs");
+const require_raw_index = require("./raw/index.cjs");
+const require_client = require("./client.cjs");
+const require_auth = require("./types/auth.cjs");
+const require_lock = require("./types/lock.cjs");
+const require_notifications = require("./types/notifications.cjs");
+exports.AccessDeniedError = require_errors_index.AccessDeniedError;
+exports.B2Client = require_client.B2Client;
+exports.B2Error = require_errors_index.B2Error;
+exports.B2InsufficientCapabilityError = require_errors_index.B2InsufficientCapabilityError;
+exports.B2Object = require_object.B2Object;
+exports.B2RealmConfigurationError = require_errors_index.B2RealmConfigurationError;
+exports.B2RedirectError = require_errors_index.B2RedirectError;
+exports.B2SsrfError = require_errors_index.B2SsrfError;
+exports.BadAuthTokenError = require_errors_index.BadAuthTokenError;
+exports.BadBucketIdError = require_errors_index.BadBucketIdError;
+exports.BadJsonError = require_errors_index.BadJsonError;
+exports.BadRequestError = require_errors_index.BadRequestError;
+exports.BadUploadUrlError = require_errors_index.BadUploadUrlError;
+exports.BlobSource = require_source.BlobSource;
+exports.Bucket = require_bucket$1.Bucket;
+exports.BucketRetentionMode = require_bucket.BucketRetentionMode;
+exports.BucketType = require_bucket.BucketType;
+exports.BufferSource = require_source.BufferSource;
+exports.CapExceededError = require_errors_index.CapExceededError;
+exports.Capability = require_auth.Capability;
+exports.ChecksumMismatchError = require_errors_index.ChecksumMismatchError;
+exports.ConflictError = require_errors_index.ConflictError;
+exports.CorsOperation = require_bucket.CorsOperation;
+exports.DuplicateBucketNameError = require_errors_index.DuplicateBucketNameError;
+exports.EncryptionAlgorithm = require_encryption.EncryptionAlgorithm;
+exports.EncryptionKey = require_encryption.EncryptionKey;
+exports.EncryptionMode = require_encryption.EncryptionMode;
+exports.EventType = require_notifications.EventType;
+exports.ExpiredAuthTokenError = require_errors_index.ExpiredAuthTokenError;
+exports.FetchTransport = require_transport.FetchTransport;
+exports.FileAction = require_file.FileAction;
+exports.FileNotPresentError = require_errors_index.FileNotPresentError;
+exports.FileSource = require_file_source.FileSource;
+exports.FinishLargeFileResponseBodyError = require_errors_index.FinishLargeFileResponseBodyError;
+exports.InMemoryAccountInfo = require_in_memory.InMemoryAccountInfo;
+exports.IncrementalSha1 = require_hash.IncrementalSha1;
+exports.InternalError = require_errors_index.InternalError;
+exports.InvalidBucketIdError = require_errors_index.InvalidBucketIdError;
+exports.InvalidBucketInfoError = require_errors_index.InvalidBucketInfoError;
+exports.InvalidBucketNameError = require_errors_index.InvalidBucketNameError;
+exports.InvalidFileIdError = require_errors_index.InvalidFileIdError;
+exports.InvalidFileInfoError = require_errors_index.InvalidFileInfoError;
+exports.InvalidFileNameError = require_errors_index.InvalidFileNameError;
+exports.InvalidPartNumberError = require_errors_index.InvalidPartNumberError;
+exports.KNOWN_B2_ERROR_CODES = require_errors.KNOWN_B2_ERROR_CODES;
+exports.LegalHoldValue = require_lock.LegalHoldValue;
+exports.MetadataDirective = require_file.MetadataDirective;
+exports.MethodNotAllowedError = require_errors_index.MethodNotAllowedError;
+exports.NetworkError = require_errors_index.NetworkError;
+exports.NotFoundError = require_errors_index.NotFoundError;
+exports.OutOfRangeError = require_errors_index.OutOfRangeError;
+exports.RangeNotSatisfiableError = require_errors_index.RangeNotSatisfiableError;
+exports.RawClient = require_raw_index.RawClient;
+exports.RequestTimeoutError = require_errors_index.RequestTimeoutError;
+exports.ResumeFileIdMismatchError = require_errors_index.ResumeFileIdMismatchError;
+exports.RetentionMode = require_lock.RetentionMode;
+exports.RetryTransport = require_transport.RetryTransport;
+exports.SSE_B2 = require_encryption.SSE_B2;
+exports.SSE_NONE = require_encryption.SSE_NONE;
+exports.ServiceUnavailableError = require_errors_index.ServiceUnavailableError;
+exports.StreamSource = require_source.StreamSource;
+exports.TooManyBucketsError = require_errors_index.TooManyBucketsError;
+exports.TooManyFilesError = require_errors_index.TooManyFilesError;
+exports.TooManyRequestsError = require_errors_index.TooManyRequestsError;
+exports.UploadResponseBodyError = require_errors_index.UploadResponseBodyError;
+exports.UrlGuard = require_url_guard.UrlGuard;
+exports.VERSION = require_version.VERSION;
+exports.accountId = require_ids.accountId;
+exports.applicationKeyId = require_ids.applicationKeyId;
+exports.bucketId = require_ids.bucketId;
+exports.classifyError = require_errors_index.classifyError;
+exports.deriveAllowedSuffixes = require_url_guard.deriveAllowedSuffixes;
+exports.fileId = require_ids.fileId;
+exports.keyId = require_ids.keyId;
+exports.largeFileId = require_ids.largeFileId;
+exports.paginateItems = require_paginator.paginateItems;
+exports.paginatePages = require_paginator.paginatePages;
+exports.sha1Hex = require_hash.sha1Hex;
+exports.sseCustomer = require_encryption.sseCustomer;
+exports.toContentSource = require_source.toContentSource;

package/dist/index.d.cts

@@ -7,33 +7,39 @@
  *
  * @packageDocumentation
  */
-export { B2Client, type B2ClientOptions, type CapabilityCheckResult } from './client.js';
+export type { AccountInfo, AuthContextAwareAccountInfo, UploadUrlEntry, } from './auth/account-info.js';
+export { InMemoryAccountInfo } from './auth/in-memory.js';
 export { Bucket, type DeleteAllDeleteEvent, type DeleteAllErrorEvent, type DeleteAllEvent, type DeleteAllSkipEvent, type DeleteError, type DeleteManyResult, type DeleteTarget, } from './bucket.js';
+export { B2Client, type B2ClientOptions, type CapabilityCheckResult } from './client.js';
+export type { DownloadResult, HeadResult } from './download/single.js';
+export type { B2ErrorOptions } from './errors/index.js';
+export { AccessDeniedError, B2Error, B2InsufficientCapabilityError, B2RealmConfigurationError, B2RedirectError, B2SsrfError, BadAuthTokenError, BadBucketIdError, BadJsonError, BadRequestError, BadUploadUrlError, CapExceededError, ChecksumMismatchError, ConflictError, classifyError, DuplicateBucketNameError, ExpiredAuthTokenError, FileNotPresentError, FinishLargeFileResponseBodyError, InternalError, InvalidBucketIdError, InvalidBucketInfoError, InvalidBucketNameError, InvalidFileIdError, InvalidFileInfoError, InvalidFileNameError, InvalidPartNumberError, MethodNotAllowedError, NetworkError, NotFoundError, OutOfRangeError, RangeNotSatisfiableError, RequestTimeoutError, ResumeFileIdMismatchError, ServiceUnavailableError, TooManyBucketsError, TooManyFilesError, TooManyRequestsError, UploadResponseBodyError, } from './errors/index.js';
+export type { RetryOptions } from './http/retry.js';
+export type { HttpRequest, HttpResponse, HttpTransport, RetryTransportOptions, } from './http/transport.js';
+export { FetchTransport, RetryTransport } from './http/transport.js';
+export { deriveAllowedSuffixes, UrlGuard } from './http/url-guard.js';
 export { B2Object, type DownloadCallOptions, type HeadCallOptions } from './object.js';
-export type { UploadWriteHandle } from './upload/stream.js';
-export { RawClient, type RawClientOptions, type DownloadFileOptions, type SseCDownloadKey, } from './raw/index.js';
-export { B2Error, ExpiredAuthTokenError, BadAuthTokenError, ServiceUnavailableError, RequestTimeoutError, TooManyRequestsError, CapExceededError, AccessDeniedError, FileNotPresentError, DuplicateBucketNameError, BadRequestError, BadUploadUrlError, ChecksumMismatchError, B2InsufficientCapabilityError, B2SsrfError, NetworkError, classifyError, } from './errors/index.js';
-export { InMemoryAccountInfo } from './auth/in-memory.js';
-export type { AccountInfo, UploadUrlEntry } from './auth/account-info.js';
+export { type DownloadFileOptions, RawClient, type RawClientOptions, type RawRequestOptions, type SseCDownloadKey, } from './raw/index.js';
 export { IncrementalSha1, sha1Hex } from './streams/hash.js';
-export { toContentSource, BlobSource, BufferSource, StreamSource } from './streams/source.js';
-export type { ContentSource } from './streams/source.js';
 export type { ProgressEvent, ProgressListener } from './streams/progress.js';
-export { FetchTransport, RetryTransport } from './http/transport.js';
-export type { HttpTransport, HttpRequest, HttpResponse, RetryTransportOptions, } from './http/transport.js';
-export { UrlGuard, deriveAllowedSuffixes } from './http/url-guard.js';
-export type { RetryOptions } from './http/retry.js';
-export type { DownloadResult, HeadResult } from './download/single.js';
-export { EncryptionKey, SSE_B2, SSE_NONE, sseCustomer } from './types/encryption.js';
-export { paginateItems, paginatePages } from './util/paginator.js';
-export type { PageFetcher, PaginatorOptions } from './util/paginator.js';
-export { BucketRetentionMode, BucketType, CorsOperation } from './types/bucket.js';
+export type { ContentSource, FileSourcePath } from './streams/source.js';
+export { BlobSource, BufferSource, FileSource, StreamSource, toContentSource, } from './streams/source.js';
 export { Capability } from './types/auth.js';
-export { EncryptionAlgorithm, EncryptionMode } from './types/encryption.js';
-export { EventType } from './types/notifications.js';
+export { BucketRetentionMode, BucketType, CorsOperation } from './types/bucket.js';
+export { EncryptionAlgorithm, EncryptionKey, EncryptionMode, SSE_B2, SSE_NONE, sseCustomer, } from './types/encryption.js';
+export { KNOWN_B2_ERROR_CODES } from './types/errors.js';
 export { FileAction, MetadataDirective } from './types/file.js';
-export { LegalHoldValue, RetentionMode } from './types/lock.js';
-export type * from './types/index.js';
 export { accountId, applicationKeyId, bucketId, fileId, keyId, largeFileId, } from './types/ids.js';
+export type * from './types/index.js';
+export { LegalHoldValue, RetentionMode } from './types/lock.js';
+export { EventType } from './types/notifications.js';
+export type { AmbiguousFinishCleanupFailureEvent, CancelLargeFileCleanupFailureEvent, CleanupFailureEvent, CleanupFailureListener, CleanupFailureOptions, } from './upload/cancel.js';
+export type { ResumePartReusedEvent, ResumePartReusedListener, } from './upload/large.js';
+export type { B2ObjectUploadOptions, B2ObjectWriteStreamOptions, BucketUploadOptions, HighLevelUploadOptions, UploadOptions, } from './upload/options.js';
+export type { ResumeCandidateRejectedEvent, ResumeCandidateRejectedListener, ResumeCandidateRejectedReason, } from './upload/resume.js';
+export type { UploadRetryEvent, UploadRetryListener, UploadRetryOptions } from './upload/retry.js';
+export type { UploadWriteHandle } from './upload/stream.js';
+export type { PageFetcher, PaginatorOptions } from './util/paginator.js';
+export { paginateItems, paginatePages } from './util/paginator.js';
 export { VERSION } from './version.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.js"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,QAAQ,EAAE,KAAK,eAAe,EAAE,KAAK,qBAAqB,EAAE,MAAM,aAAa,CAAA;AACxF,OAAO,EACL,MAAM,EACN,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,KAAK,YAAY,GAClB,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,QAAQ,EAAE,KAAK,mBAAmB,EAAE,KAAK,eAAe,EAAE,MAAM,aAAa,CAAA;AAEtF,YAAY,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAE3D,OAAO,EACL,SAAS,EACT,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,eAAe,GACrB,MAAM,gBAAgB,CAAA;AAEvB,OAAO,EACL,OAAO,EACP,qBAAqB,EACrB,iBAAiB,EACjB,uBAAuB,EACvB,mBAAmB,EACnB,oBAAoB,EACpB,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,wBAAwB,EACxB,eAAe,EACf,iBAAiB,EACjB,qBAAqB,EACrB,6BAA6B,EAC7B,WAAW,EACX,YAAY,EACZ,aAAa,GACd,MAAM,mBAAmB,CAAA;AAE1B,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AACzD,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AAEzE,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAC5D,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAC7F,YAAY,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACxD,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAE5E,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACpE,YAAY,EACV,aAAa,EACb,WAAW,EACX,YAAY,EACZ,qBAAqB,GACtB,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EAAE,QAAQ,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAA;AACrE,YAAY,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAEnD,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AAEtE,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAKpF,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAClE,YAAY,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAOxE,OAAO,EAAE,mBAAmB,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAClF,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC5C,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAC3E,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAA;AACpD,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AAC/D,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAE/D,mBAAmB,kBAAkB,CAAA;AAQrC,OAAO,EACL,SAAS,EACT,gBAAgB,EAChB,QAAQ,EACR,MAAM,EACN,KAAK,EACL,WAAW,GACZ,MAAM,gBAAgB,CAAA;AAEvB,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.js"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -7,33 +7,39 @@
  *
  * @packageDocumentation
  */
-export { B2Client, type B2ClientOptions, type CapabilityCheckResult } from './client.js';
+export type { AccountInfo, AuthContextAwareAccountInfo, UploadUrlEntry, } from './auth/account-info.js';
+export { InMemoryAccountInfo } from './auth/in-memory.js';
 export { Bucket, type DeleteAllDeleteEvent, type DeleteAllErrorEvent, type DeleteAllEvent, type DeleteAllSkipEvent, type DeleteError, type DeleteManyResult, type DeleteTarget, } from './bucket.js';
+export { B2Client, type B2ClientOptions, type CapabilityCheckResult } from './client.js';
+export type { DownloadResult, HeadResult } from './download/single.js';
+export type { B2ErrorOptions } from './errors/index.js';
+export { AccessDeniedError, B2Error, B2InsufficientCapabilityError, B2RealmConfigurationError, B2RedirectError, B2SsrfError, BadAuthTokenError, BadBucketIdError, BadJsonError, BadRequestError, BadUploadUrlError, CapExceededError, ChecksumMismatchError, ConflictError, classifyError, DuplicateBucketNameError, ExpiredAuthTokenError, FileNotPresentError, FinishLargeFileResponseBodyError, InternalError, InvalidBucketIdError, InvalidBucketInfoError, InvalidBucketNameError, InvalidFileIdError, InvalidFileInfoError, InvalidFileNameError, InvalidPartNumberError, MethodNotAllowedError, NetworkError, NotFoundError, OutOfRangeError, RangeNotSatisfiableError, RequestTimeoutError, ResumeFileIdMismatchError, ServiceUnavailableError, TooManyBucketsError, TooManyFilesError, TooManyRequestsError, UploadResponseBodyError, } from './errors/index.js';
+export type { RetryOptions } from './http/retry.js';
+export type { HttpRequest, HttpResponse, HttpTransport, RetryTransportOptions, } from './http/transport.js';
+export { FetchTransport, RetryTransport } from './http/transport.js';
+export { deriveAllowedSuffixes, UrlGuard } from './http/url-guard.js';
 export { B2Object, type DownloadCallOptions, type HeadCallOptions } from './object.js';
-export type { UploadWriteHandle } from './upload/stream.js';
-export { RawClient, type RawClientOptions, type DownloadFileOptions, type SseCDownloadKey, } from './raw/index.js';
-export { B2Error, ExpiredAuthTokenError, BadAuthTokenError, ServiceUnavailableError, RequestTimeoutError, TooManyRequestsError, CapExceededError, AccessDeniedError, FileNotPresentError, DuplicateBucketNameError, BadRequestError, BadUploadUrlError, ChecksumMismatchError, B2InsufficientCapabilityError, B2SsrfError, NetworkError, classifyError, } from './errors/index.js';
-export { InMemoryAccountInfo } from './auth/in-memory.js';
-export type { AccountInfo, UploadUrlEntry } from './auth/account-info.js';
+export { type DownloadFileOptions, RawClient, type RawClientOptions, type RawRequestOptions, type SseCDownloadKey, } from './raw/index.js';
 export { IncrementalSha1, sha1Hex } from './streams/hash.js';
-export { toContentSource, BlobSource, BufferSource, StreamSource } from './streams/source.js';
-export type { ContentSource } from './streams/source.js';
 export type { ProgressEvent, ProgressListener } from './streams/progress.js';
-export { FetchTransport, RetryTransport } from './http/transport.js';
-export type { HttpTransport, HttpRequest, HttpResponse, RetryTransportOptions, } from './http/transport.js';
-export { UrlGuard, deriveAllowedSuffixes } from './http/url-guard.js';
-export type { RetryOptions } from './http/retry.js';
-export type { DownloadResult, HeadResult } from './download/single.js';
-export { EncryptionKey, SSE_B2, SSE_NONE, sseCustomer } from './types/encryption.js';
-export { paginateItems, paginatePages } from './util/paginator.js';
-export type { PageFetcher, PaginatorOptions } from './util/paginator.js';
-export { BucketRetentionMode, BucketType, CorsOperation } from './types/bucket.js';
+export type { ContentSource, FileSourcePath } from './streams/source.js';
+export { BlobSource, BufferSource, FileSource, StreamSource, toContentSource, } from './streams/source.js';
 export { Capability } from './types/auth.js';
-export { EncryptionAlgorithm, EncryptionMode } from './types/encryption.js';
-export { EventType } from './types/notifications.js';
+export { BucketRetentionMode, BucketType, CorsOperation } from './types/bucket.js';
+export { EncryptionAlgorithm, EncryptionKey, EncryptionMode, SSE_B2, SSE_NONE, sseCustomer, } from './types/encryption.js';
+export { KNOWN_B2_ERROR_CODES } from './types/errors.js';
 export { FileAction, MetadataDirective } from './types/file.js';
-export { LegalHoldValue, RetentionMode } from './types/lock.js';
-export type * from './types/index.js';
 export { accountId, applicationKeyId, bucketId, fileId, keyId, largeFileId, } from './types/ids.js';
+export type * from './types/index.js';
+export { LegalHoldValue, RetentionMode } from './types/lock.js';
+export { EventType } from './types/notifications.js';
+export type { AmbiguousFinishCleanupFailureEvent, CancelLargeFileCleanupFailureEvent, CleanupFailureEvent, CleanupFailureListener, CleanupFailureOptions, } from './upload/cancel.js';
+export type { ResumePartReusedEvent, ResumePartReusedListener, } from './upload/large.js';
+export type { B2ObjectUploadOptions, B2ObjectWriteStreamOptions, BucketUploadOptions, HighLevelUploadOptions, UploadOptions, } from './upload/options.js';
+export type { ResumeCandidateRejectedEvent, ResumeCandidateRejectedListener, ResumeCandidateRejectedReason, } from './upload/resume.js';
+export type { UploadRetryEvent, UploadRetryListener, UploadRetryOptions } from './upload/retry.js';
+export type { UploadWriteHandle } from './upload/stream.js';
+export type { PageFetcher, PaginatorOptions } from './util/paginator.js';
+export { paginateItems, paginatePages } from './util/paginator.js';
 export { VERSION } from './version.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.js"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,QAAQ,EAAE,KAAK,eAAe,EAAE,KAAK,qBAAqB,EAAE,MAAM,aAAa,CAAA;AACxF,OAAO,EACL,MAAM,EACN,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,KAAK,YAAY,GAClB,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,QAAQ,EAAE,KAAK,mBAAmB,EAAE,KAAK,eAAe,EAAE,MAAM,aAAa,CAAA;AAEtF,YAAY,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAE3D,OAAO,EACL,SAAS,EACT,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,eAAe,GACrB,MAAM,gBAAgB,CAAA;AAEvB,OAAO,EACL,OAAO,EACP,qBAAqB,EACrB,iBAAiB,EACjB,uBAAuB,EACvB,mBAAmB,EACnB,oBAAoB,EACpB,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,wBAAwB,EACxB,eAAe,EACf,iBAAiB,EACjB,qBAAqB,EACrB,6BAA6B,EAC7B,WAAW,EACX,YAAY,EACZ,aAAa,GACd,MAAM,mBAAmB,CAAA;AAE1B,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AACzD,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AAEzE,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAC5D,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAC7F,YAAY,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACxD,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAE5E,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACpE,YAAY,EACV,aAAa,EACb,WAAW,EACX,YAAY,EACZ,qBAAqB,GACtB,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EAAE,QAAQ,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAA;AACrE,YAAY,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAEnD,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AAEtE,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAKpF,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAClE,YAAY,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAOxE,OAAO,EAAE,mBAAmB,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAClF,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC5C,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAC3E,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAA;AACpD,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AAC/D,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAE/D,mBAAmB,kBAAkB,CAAA;AAQrC,OAAO,EACL,SAAS,EACT,gBAAgB,EAChB,QAAQ,EACR,MAAM,EACN,KAAK,EACL,WAAW,GACZ,MAAM,gBAAgB,CAAA;AAEvB,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.js"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -1,78 +1,22 @@
-import { B2Client } from "./client.js";
-import { Bucket } from "./bucket.js";
-import { B2Object } from "./object.js";
-import { RawClient } from "./raw/index.js";
-import { AccessDeniedError, B2Error, B2InsufficientCapabilityError, B2SsrfError, BadAuthTokenError, BadRequestError, BadUploadUrlError, CapExceededError, ChecksumMismatchError, DuplicateBucketNameError, ExpiredAuthTokenError, FileNotPresentError, NetworkError, RequestTimeoutError, ServiceUnavailableError, TooManyRequestsError, classifyError } from "./errors/index.js";
 import { InMemoryAccountInfo } from "./auth/in-memory.js";
+import { FileAction, MetadataDirective } from "./types/file.js";
+import { accountId, applicationKeyId, bucketId, fileId, keyId, largeFileId } from "./types/ids.js";
+import { KNOWN_B2_ERROR_CODES } from "./types/errors.js";
+import { AccessDeniedError, B2Error, B2InsufficientCapabilityError, B2RealmConfigurationError, B2RedirectError, B2SsrfError, BadAuthTokenError, BadBucketIdError, BadJsonError, BadRequestError, BadUploadUrlError, CapExceededError, ChecksumMismatchError, ConflictError, DuplicateBucketNameError, ExpiredAuthTokenError, FileNotPresentError, FinishLargeFileResponseBodyError, InternalError, InvalidBucketIdError, InvalidBucketInfoError, InvalidBucketNameError, InvalidFileIdError, InvalidFileInfoError, InvalidFileNameError, InvalidPartNumberError, MethodNotAllowedError, NetworkError, NotFoundError, OutOfRangeError, RangeNotSatisfiableError, RequestTimeoutError, ResumeFileIdMismatchError, ServiceUnavailableError, TooManyBucketsError, TooManyFilesError, TooManyRequestsError, UploadResponseBodyError, classifyError } from "./errors/index.js";
 import { IncrementalSha1, sha1Hex } from "./streams/hash.js";
+import { FileSource } from "./streams/file-source.js";
 import { BlobSource, BufferSource, StreamSource, toContentSource } from "./streams/source.js";
-import { FetchTransport, RetryTransport } from "./http/transport.js";
-import { UrlGuard, deriveAllowedSuffixes } from "./http/url-guard.js";
+import { BucketRetentionMode, BucketType, CorsOperation } from "./types/bucket.js";
 import { EncryptionAlgorithm, EncryptionKey, EncryptionMode, SSE_B2, SSE_NONE, sseCustomer } from "./types/encryption.js";
+import { B2Object } from "./object.js";
 import { paginateItems, paginatePages } from "./util/paginator.js";
-import { BucketRetentionMode, BucketType, CorsOperation } from "./types/bucket.js";
+import { Bucket } from "./bucket.js";
+import { UrlGuard, deriveAllowedSuffixes } from "./http/url-guard.js";
+import { VERSION } from "./version.js";
+import { FetchTransport, RetryTransport } from "./http/transport.js";
+import { RawClient } from "./raw/index.js";
+import { B2Client } from "./client.js";
 import { Capability } from "./types/auth.js";
-import { EventType } from "./types/notifications.js";
-import { FileAction, MetadataDirective } from "./types/file.js";
 import { LegalHoldValue, RetentionMode } from "./types/lock.js";
-import { accountId, applicationKeyId, bucketId, fileId, keyId, largeFileId } from "./types/ids.js";
-import { VERSION } from "./version.js";
-export {
-  AccessDeniedError,
-  B2Client,
-  B2Error,
-  B2InsufficientCapabilityError,
-  B2Object,
-  B2SsrfError,
-  BadAuthTokenError,
-  BadRequestError,
-  BadUploadUrlError,
-  BlobSource,
-  Bucket,
-  BucketRetentionMode,
-  BucketType,
-  BufferSource,
-  CapExceededError,
-  Capability,
-  ChecksumMismatchError,
-  CorsOperation,
-  DuplicateBucketNameError,
-  EncryptionAlgorithm,
-  EncryptionKey,
-  EncryptionMode,
-  EventType,
-  ExpiredAuthTokenError,
-  FetchTransport,
-  FileAction,
-  FileNotPresentError,
-  InMemoryAccountInfo,
-  IncrementalSha1,
-  LegalHoldValue,
-  MetadataDirective,
-  NetworkError,
-  RawClient,
-  RequestTimeoutError,
-  RetentionMode,
-  RetryTransport,
-  SSE_B2,
-  SSE_NONE,
-  ServiceUnavailableError,
-  StreamSource,
-  TooManyRequestsError,
-  UrlGuard,
-  VERSION,
-  accountId,
-  applicationKeyId,
-  bucketId,
-  classifyError,
-  deriveAllowedSuffixes,
-  fileId,
-  keyId,
-  largeFileId,
-  paginateItems,
-  paginatePages,
-  sha1Hex,
-  sseCustomer,
-  toContentSource
-};
-//# sourceMappingURL=index.js.map
+import { EventType } from "./types/notifications.js";
+export { AccessDeniedError, B2Client, B2Error, B2InsufficientCapabilityError, B2Object, B2RealmConfigurationError, B2RedirectError, B2SsrfError, BadAuthTokenError, BadBucketIdError, BadJsonError, BadRequestError, BadUploadUrlError, BlobSource, Bucket, BucketRetentionMode, BucketType, BufferSource, CapExceededError, Capability, ChecksumMismatchError, ConflictError, CorsOperation, DuplicateBucketNameError, EncryptionAlgorithm, EncryptionKey, EncryptionMode, EventType, ExpiredAuthTokenError, FetchTransport, FileAction, FileNotPresentError, FileSource, FinishLargeFileResponseBodyError, InMemoryAccountInfo, IncrementalSha1, InternalError, InvalidBucketIdError, InvalidBucketInfoError, InvalidBucketNameError, InvalidFileIdError, InvalidFileInfoError, InvalidFileNameError, InvalidPartNumberError, KNOWN_B2_ERROR_CODES, LegalHoldValue, MetadataDirective, MethodNotAllowedError, NetworkError, NotFoundError, OutOfRangeError, RangeNotSatisfiableError, RawClient, RequestTimeoutError, ResumeFileIdMismatchError, RetentionMode, RetryTransport, SSE_B2, SSE_NONE, ServiceUnavailableError, StreamSource, TooManyBucketsError, TooManyFilesError, TooManyRequestsError, UploadResponseBodyError, UrlGuard, VERSION, accountId, applicationKeyId, bucketId, classifyError, deriveAllowedSuffixes, fileId, keyId, largeFileId, paginateItems, paginatePages, sha1Hex, sseCustomer, toContentSource };

package/dist/internal/b2-naming.cjs

@@ -0,0 +1,66 @@
+const require_text_codec = require("../util/text-codec.cjs");
+const require_http = require("../util/http.cjs");
+//#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 require_http.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 = require_text_codec.utf8Encoder.encode(name);
+	return bytes.byteLength > 1024 ? null : bytes.byteLength;
+}
+//#endregion
+exports.BUCKET_NAME_MAX = BUCKET_NAME_MAX;
+exports.BUCKET_NAME_MIN = BUCKET_NAME_MIN;
+exports.FILE_NAME_MAX_BYTES = FILE_NAME_MAX_BYTES;
+exports.getB2FileNameByteLength = getB2FileNameByteLength;
+exports.hasB2FileNameControlCharacter = hasB2FileNameControlCharacter;
+exports.hasValidB2BucketNameShape = hasValidB2BucketNameShape;
+exports.isB2BucketNameIpv4Address = isB2BucketNameIpv4Address;
+
+//# sourceMappingURL=b2-naming.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"b2-naming.cjs","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,aAAA,8BAA8B,IAAI;AAC3C;;;;;;;;;AAUA,SAAgB,wBAAwB,MAA6B;CACnE,IAAI,KAAK,SAAA,MAA8B,OAAO;CAE9C,MAAM,QAAQ,mBAAA,YAAY,OAAO,IAAI;CACrC,OAAO,MAAM,aAAA,OAAmC,OAAO,MAAM;AAC/D"}

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"}