@backblaze-labs/b2-sdk 0.3.0 → 0.4.0

package/dist/version.cjs

@@ -1,18 +1,70 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 //#region src/version.ts
 /**
 * Current SDK version. Read directly from package.json so there is no
 * second-source-of-truth to keep in sync — bumping `version` in package.json
-* automatically propagates here, into the SDK's User-Agent header, and into
-* the published artifact.
+* automatically propagates here and into the published artifact. The outbound
+* SDK User-Agent uses the resolved product version segment so source, CI,
+* `npm pack`, and prerelease builds advertise `dev` instead of a real-looking
+* release number.
 *
 * Works in every runtime the SDK targets:
 *   - Node 22.3+, Bun, Deno: native JSON import attributes.
-*   - Vite builds: the JSON import is replaced with a version-only shim so
-*     published runtime chunks do not carry unrelated package metadata.
+*   - Vite builds: the JSON import is replaced with a version-only shim, and
+*     the publish path injects the release-channel define as `published`.
+*     Other builds leave the define absent, so runtime chunks do not carry
+*     unrelated package metadata.
 *   - Vitest browser mode: Vite handles the import the same way as build.
 */
 var VERSION = require("./_virtual/_b2-sdk-version-json.cjs").default.version;
+var configuredReleaseSignal = "published";
+function isStableSemver(version) {
+	return !(version.split("+", 1)[0] ?? version).includes("-");
+}
+/**
+* Resolve build version metadata from a version and positive release signal.
+*
+* @param version - Build semver read from package.json.
+* @param releaseSignal - Build-time release signal. Only `published` enables
+* the published channel, and prerelease semvers still resolve to `dev`.
+*
+* @returns The release-channel decision and User-Agent version segment.
+*/
+function resolveVersion(version, releaseSignal = "dev") {
+	const isStableVersion = isStableSemver(version);
+	const isRelease = releaseSignal === "published" && isStableVersion;
+	return {
+		version,
+		releaseChannel: isRelease ? "published" : "dev",
+		isPublishedRelease: isRelease,
+		productVersion: isRelease ? version : "dev"
+	};
+}
+var resolvedVersion = resolveVersion(VERSION, configuredReleaseSignal);
+/**
+* Current release channel. Defaults to `dev` unless the publish path injected
+* the positive release signal for a stable semver.
+*/
+var RELEASE_CHANNEL = resolvedVersion.releaseChannel;
+/**
+* Whether the current artifact is a stable package built through the publish path.
+*/
+var isPublishedRelease = resolvedVersion.isPublishedRelease;
+/**
+* Version segment for the SDK User-Agent product token.
+* Kept as a function because it is derived resolver output consumed by the
+* User-Agent builder, not a second version constant for callers to maintain.
+*
+* @returns The package semver for stable published releases, otherwise `dev`.
+*/
+function productVersion() {
+	return resolvedVersion.productVersion;
+}
 //#endregion
+exports.RELEASE_CHANNEL = RELEASE_CHANNEL;
 exports.VERSION = VERSION;
+exports.isPublishedRelease = isPublishedRelease;
+exports.productVersion = productVersion;
+exports.resolveVersion = resolveVersion;
 
 //# sourceMappingURL=version.cjs.map

package/dist/version.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"version.cjs","names":[],"sources":["../src/version.ts"],"sourcesContent":["import pkg from '../package.json' with { type: 'json' }\n\n/**\n * Current SDK version. Read directly from package.json so there is no\n * second-source-of-truth to keep in sync — bumping `version` in package.json\n * automatically propagates here, into the SDK's User-Agent header, and into\n * the published artifact.\n *\n * Works in every runtime the SDK targets:\n *   - Node 22.3+, Bun, Deno: native JSON import attributes.\n *   - Vite builds: the JSON import is replaced with a version-only shim so\n *     published runtime chunks do not carry unrelated package metadata.\n *   - Vitest browser mode: Vite handles the import the same way as build.\n */\nexport const VERSION: string = pkg.version\n"],"mappings":";;;;;;;;;;;;;AAcA,IAAa,uDAAkB,CAAA,CAAA,QAAI"}
+{"version":3,"file":"version.cjs","names":[],"sources":["../src/version.ts"],"sourcesContent":["import pkg from '../package.json' with { type: 'json' }\n\ndeclare const __B2_SDK_RELEASE_CHANNEL__: string | undefined\n\n/**\n * Release channel used to decide what the SDK advertises in its User-Agent\n * product token.\n */\nexport type ReleaseChannel = 'dev' | 'published'\n\n/**\n * Resolved version metadata for the current build.\n */\nexport interface VersionResolution {\n  /** Build semver read from package.json. */\n  readonly version: string\n  /** Release channel after applying the positive release signal. */\n  readonly releaseChannel: ReleaseChannel\n  /** Whether this build is a stable package published through the release path. */\n  readonly isPublishedRelease: boolean\n  /** Version segment for the SDK User-Agent product token. */\n  readonly productVersion: string\n}\n\n/**\n * Current SDK version. Read directly from package.json so there is no\n * second-source-of-truth to keep in sync — bumping `version` in package.json\n * automatically propagates here and into the published artifact. The outbound\n * SDK User-Agent uses the resolved product version segment so source, CI,\n * `npm pack`, and prerelease builds advertise `dev` instead of a real-looking\n * release number.\n *\n * Works in every runtime the SDK targets:\n *   - Node 22.3+, Bun, Deno: native JSON import attributes.\n *   - Vite builds: the JSON import is replaced with a version-only shim, and\n *     the publish path injects the release-channel define as `published`.\n *     Other builds leave the define absent, so runtime chunks do not carry\n *     unrelated package metadata.\n *   - Vitest browser mode: Vite handles the import the same way as build.\n */\nexport const VERSION: string = pkg.version\n\nconst configuredReleaseSignal =\n  typeof __B2_SDK_RELEASE_CHANNEL__ === 'string' ? __B2_SDK_RELEASE_CHANNEL__ : 'dev'\n\nfunction isStableSemver(version: string): boolean {\n  const versionWithoutBuildMetadata = version.split('+', 1)[0] ?? version\n  return !versionWithoutBuildMetadata.includes('-')\n}\n\n/**\n * Resolve build version metadata from a version and positive release signal.\n *\n * @param version - Build semver read from package.json.\n * @param releaseSignal - Build-time release signal. Only `published` enables\n * the published channel, and prerelease semvers still resolve to `dev`.\n *\n * @returns The release-channel decision and User-Agent version segment.\n */\nexport function resolveVersion(\n  version: string,\n  releaseSignal: string | undefined = 'dev',\n): VersionResolution {\n  const isStableVersion = isStableSemver(version)\n  const isRelease = releaseSignal === 'published' && isStableVersion\n  const releaseChannel = isRelease ? 'published' : 'dev'\n\n  return {\n    version,\n    releaseChannel,\n    isPublishedRelease: isRelease,\n    productVersion: isRelease ? version : 'dev',\n  }\n}\n\nconst resolvedVersion = resolveVersion(VERSION, configuredReleaseSignal)\n\n/**\n * Current release channel. Defaults to `dev` unless the publish path injected\n * the positive release signal for a stable semver.\n */\nexport const RELEASE_CHANNEL: ReleaseChannel = resolvedVersion.releaseChannel\n\n/**\n * Whether the current artifact is a stable package built through the publish path.\n */\nexport const isPublishedRelease: boolean = resolvedVersion.isPublishedRelease\n\n/**\n * Version segment for the SDK User-Agent product token.\n * Kept as a function because it is derived resolver output consumed by the\n * User-Agent builder, not a second version constant for callers to maintain.\n *\n * @returns The package semver for stable published releases, otherwise `dev`.\n */\nexport function productVersion(): string {\n  return resolvedVersion.productVersion\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAwCA,IAAa,uDAAkB,CAAA,CAAA,QAAI;AAEnC,IAAM,0BAAA;AAGN,SAAS,eAAe,SAA0B;CAEhD,OAAO,EAD6B,QAAQ,MAAM,KAAK,CAAC,CAAC,CAAC,MAAM,QAAA,CAC5B,SAAS,GAAG;AAClD;;;;;;;;;;AAWA,SAAgB,eACd,SACA,gBAAoC,OACjB;CACnB,MAAM,kBAAkB,eAAe,OAAO;CAC9C,MAAM,YAAY,kBAAkB,eAAe;CAGnD,OAAO;EACL;EACA,gBAJqB,YAAY,cAAc;EAK/C,oBAAoB;EACpB,gBAAgB,YAAY,UAAU;CACxC;AACF;AAEA,IAAM,kBAAkB,eAAe,SAAS,uBAAuB;;;;;AAMvE,IAAa,kBAAkC,gBAAgB;;;;AAK/D,IAAa,qBAA8B,gBAAgB;;;;;;;;AAS3D,SAAgB,iBAAyB;CACvC,OAAO,gBAAgB;AACzB"}

package/dist/version.d.cts

@@ -1,14 +1,63 @@
+/**
+ * Release channel used to decide what the SDK advertises in its User-Agent
+ * product token.
+ */
+export type ReleaseChannel = 'dev' | 'published';
+/**
+ * Resolved version metadata for the current build.
+ */
+export interface VersionResolution {
+    /** Build semver read from package.json. */
+    readonly version: string;
+    /** Release channel after applying the positive release signal. */
+    readonly releaseChannel: ReleaseChannel;
+    /** Whether this build is a stable package published through the release path. */
+    readonly isPublishedRelease: boolean;
+    /** Version segment for the SDK User-Agent product token. */
+    readonly productVersion: string;
+}
 /**
  * Current SDK version. Read directly from package.json so there is no
  * second-source-of-truth to keep in sync — bumping `version` in package.json
- * automatically propagates here, into the SDK's User-Agent header, and into
- * the published artifact.
+ * automatically propagates here and into the published artifact. The outbound
+ * SDK User-Agent uses the resolved product version segment so source, CI,
+ * `npm pack`, and prerelease builds advertise `dev` instead of a real-looking
+ * release number.
  *
  * Works in every runtime the SDK targets:
  *   - Node 22.3+, Bun, Deno: native JSON import attributes.
- *   - Vite builds: the JSON import is replaced with a version-only shim so
- *     published runtime chunks do not carry unrelated package metadata.
+ *   - Vite builds: the JSON import is replaced with a version-only shim, and
+ *     the publish path injects the release-channel define as `published`.
+ *     Other builds leave the define absent, so runtime chunks do not carry
+ *     unrelated package metadata.
  *   - Vitest browser mode: Vite handles the import the same way as build.
  */
 export declare const VERSION: string;
+/**
+ * Resolve build version metadata from a version and positive release signal.
+ *
+ * @param version - Build semver read from package.json.
+ * @param releaseSignal - Build-time release signal. Only `published` enables
+ * the published channel, and prerelease semvers still resolve to `dev`.
+ *
+ * @returns The release-channel decision and User-Agent version segment.
+ */
+export declare function resolveVersion(version: string, releaseSignal?: string | undefined): VersionResolution;
+/**
+ * Current release channel. Defaults to `dev` unless the publish path injected
+ * the positive release signal for a stable semver.
+ */
+export declare const RELEASE_CHANNEL: ReleaseChannel;
+/**
+ * Whether the current artifact is a stable package built through the publish path.
+ */
+export declare const isPublishedRelease: boolean;
+/**
+ * Version segment for the SDK User-Agent product token.
+ * Kept as a function because it is derived resolver output consumed by the
+ * User-Agent builder, not a second version constant for callers to maintain.
+ *
+ * @returns The package semver for stable published releases, otherwise `dev`.
+ */
+export declare function productVersion(): string;
 //# sourceMappingURL=version.d.ts.map

package/dist/version.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.js"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,OAAO,EAAE,MAAoB,CAAA"}
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.js"],"names":[],"mappings":"AAIA;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,WAAW,CAAA;AAEhD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,2CAA2C;IAC3C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,kEAAkE;IAClE,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAA;IACvC,iFAAiF;IACjF,QAAQ,CAAC,kBAAkB,EAAE,OAAO,CAAA;IACpC,4DAA4D;IAC5D,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;CAChC;AAED;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,OAAO,EAAE,MAAoB,CAAA;AAU1C;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,aAAa,GAAE,MAAM,GAAG,SAAiB,GACxC,iBAAiB,CAWnB;AAID;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,cAA+C,CAAA;AAE7E;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,OAA4C,CAAA;AAE7E;;;;;;GAMG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC"}

package/dist/version.d.ts

@@ -1,14 +1,63 @@
+/**
+ * Release channel used to decide what the SDK advertises in its User-Agent
+ * product token.
+ */
+export type ReleaseChannel = 'dev' | 'published';
+/**
+ * Resolved version metadata for the current build.
+ */
+export interface VersionResolution {
+    /** Build semver read from package.json. */
+    readonly version: string;
+    /** Release channel after applying the positive release signal. */
+    readonly releaseChannel: ReleaseChannel;
+    /** Whether this build is a stable package published through the release path. */
+    readonly isPublishedRelease: boolean;
+    /** Version segment for the SDK User-Agent product token. */
+    readonly productVersion: string;
+}
 /**
  * Current SDK version. Read directly from package.json so there is no
  * second-source-of-truth to keep in sync — bumping `version` in package.json
- * automatically propagates here, into the SDK's User-Agent header, and into
- * the published artifact.
+ * automatically propagates here and into the published artifact. The outbound
+ * SDK User-Agent uses the resolved product version segment so source, CI,
+ * `npm pack`, and prerelease builds advertise `dev` instead of a real-looking
+ * release number.
  *
  * Works in every runtime the SDK targets:
  *   - Node 22.3+, Bun, Deno: native JSON import attributes.
- *   - Vite builds: the JSON import is replaced with a version-only shim so
- *     published runtime chunks do not carry unrelated package metadata.
+ *   - Vite builds: the JSON import is replaced with a version-only shim, and
+ *     the publish path injects the release-channel define as `published`.
+ *     Other builds leave the define absent, so runtime chunks do not carry
+ *     unrelated package metadata.
  *   - Vitest browser mode: Vite handles the import the same way as build.
  */
 export declare const VERSION: string;
+/**
+ * Resolve build version metadata from a version and positive release signal.
+ *
+ * @param version - Build semver read from package.json.
+ * @param releaseSignal - Build-time release signal. Only `published` enables
+ * the published channel, and prerelease semvers still resolve to `dev`.
+ *
+ * @returns The release-channel decision and User-Agent version segment.
+ */
+export declare function resolveVersion(version: string, releaseSignal?: string | undefined): VersionResolution;
+/**
+ * Current release channel. Defaults to `dev` unless the publish path injected
+ * the positive release signal for a stable semver.
+ */
+export declare const RELEASE_CHANNEL: ReleaseChannel;
+/**
+ * Whether the current artifact is a stable package built through the publish path.
+ */
+export declare const isPublishedRelease: boolean;
+/**
+ * Version segment for the SDK User-Agent product token.
+ * Kept as a function because it is derived resolver output consumed by the
+ * User-Agent builder, not a second version constant for callers to maintain.
+ *
+ * @returns The package semver for stable published releases, otherwise `dev`.
+ */
+export declare function productVersion(): string;
 //# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.js"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,OAAO,EAAE,MAAoB,CAAA"}
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.js"],"names":[],"mappings":"AAIA;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,WAAW,CAAA;AAEhD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,2CAA2C;IAC3C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,kEAAkE;IAClE,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAA;IACvC,iFAAiF;IACjF,QAAQ,CAAC,kBAAkB,EAAE,OAAO,CAAA;IACpC,4DAA4D;IAC5D,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;CAChC;AAED;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,OAAO,EAAE,MAAoB,CAAA;AAU1C;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,aAAa,GAAE,MAAM,GAAG,SAAiB,GACxC,iBAAiB,CAWnB;AAID;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,cAA+C,CAAA;AAE7E;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,OAA4C,CAAA;AAE7E;;;;;;GAMG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC"}

package/dist/version.js

@@ -3,17 +3,64 @@ import _b2_sdk_version_json_default from "./_virtual/_b2-sdk-version-json.js";
 /**
 * Current SDK version. Read directly from package.json so there is no
 * second-source-of-truth to keep in sync — bumping `version` in package.json
-* automatically propagates here, into the SDK's User-Agent header, and into
-* the published artifact.
+* automatically propagates here and into the published artifact. The outbound
+* SDK User-Agent uses the resolved product version segment so source, CI,
+* `npm pack`, and prerelease builds advertise `dev` instead of a real-looking
+* release number.
 *
 * Works in every runtime the SDK targets:
 *   - Node 22.3+, Bun, Deno: native JSON import attributes.
-*   - Vite builds: the JSON import is replaced with a version-only shim so
-*     published runtime chunks do not carry unrelated package metadata.
+*   - Vite builds: the JSON import is replaced with a version-only shim, and
+*     the publish path injects the release-channel define as `published`.
+*     Other builds leave the define absent, so runtime chunks do not carry
+*     unrelated package metadata.
 *   - Vitest browser mode: Vite handles the import the same way as build.
 */
 var VERSION = _b2_sdk_version_json_default.version;
+var configuredReleaseSignal = "published";
+function isStableSemver(version) {
+	return !(version.split("+", 1)[0] ?? version).includes("-");
+}
+/**
+* Resolve build version metadata from a version and positive release signal.
+*
+* @param version - Build semver read from package.json.
+* @param releaseSignal - Build-time release signal. Only `published` enables
+* the published channel, and prerelease semvers still resolve to `dev`.
+*
+* @returns The release-channel decision and User-Agent version segment.
+*/
+function resolveVersion(version, releaseSignal = "dev") {
+	const isStableVersion = isStableSemver(version);
+	const isRelease = releaseSignal === "published" && isStableVersion;
+	return {
+		version,
+		releaseChannel: isRelease ? "published" : "dev",
+		isPublishedRelease: isRelease,
+		productVersion: isRelease ? version : "dev"
+	};
+}
+var resolvedVersion = resolveVersion(VERSION, configuredReleaseSignal);
+/**
+* Current release channel. Defaults to `dev` unless the publish path injected
+* the positive release signal for a stable semver.
+*/
+var RELEASE_CHANNEL = resolvedVersion.releaseChannel;
+/**
+* Whether the current artifact is a stable package built through the publish path.
+*/
+var isPublishedRelease = resolvedVersion.isPublishedRelease;
+/**
+* Version segment for the SDK User-Agent product token.
+* Kept as a function because it is derived resolver output consumed by the
+* User-Agent builder, not a second version constant for callers to maintain.
+*
+* @returns The package semver for stable published releases, otherwise `dev`.
+*/
+function productVersion() {
+	return resolvedVersion.productVersion;
+}
 //#endregion
-export { VERSION };
+export { RELEASE_CHANNEL, VERSION, isPublishedRelease, productVersion, resolveVersion };
 
 //# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -1 +1 @@
-{"version":3,"file":"version.js","names":[],"sources":["../src/version.ts"],"sourcesContent":["import pkg from '../package.json' with { type: 'json' }\n\n/**\n * Current SDK version. Read directly from package.json so there is no\n * second-source-of-truth to keep in sync — bumping `version` in package.json\n * automatically propagates here, into the SDK's User-Agent header, and into\n * the published artifact.\n *\n * Works in every runtime the SDK targets:\n *   - Node 22.3+, Bun, Deno: native JSON import attributes.\n *   - Vite builds: the JSON import is replaced with a version-only shim so\n *     published runtime chunks do not carry unrelated package metadata.\n *   - Vitest browser mode: Vite handles the import the same way as build.\n */\nexport const VERSION: string = pkg.version\n"],"mappings":";;;;;;;;;;;;;;AAcA,IAAa,UAAkB,6BAAI"}
+{"version":3,"file":"version.js","names":[],"sources":["../src/version.ts"],"sourcesContent":["import pkg from '../package.json' with { type: 'json' }\n\ndeclare const __B2_SDK_RELEASE_CHANNEL__: string | undefined\n\n/**\n * Release channel used to decide what the SDK advertises in its User-Agent\n * product token.\n */\nexport type ReleaseChannel = 'dev' | 'published'\n\n/**\n * Resolved version metadata for the current build.\n */\nexport interface VersionResolution {\n  /** Build semver read from package.json. */\n  readonly version: string\n  /** Release channel after applying the positive release signal. */\n  readonly releaseChannel: ReleaseChannel\n  /** Whether this build is a stable package published through the release path. */\n  readonly isPublishedRelease: boolean\n  /** Version segment for the SDK User-Agent product token. */\n  readonly productVersion: string\n}\n\n/**\n * Current SDK version. Read directly from package.json so there is no\n * second-source-of-truth to keep in sync — bumping `version` in package.json\n * automatically propagates here and into the published artifact. The outbound\n * SDK User-Agent uses the resolved product version segment so source, CI,\n * `npm pack`, and prerelease builds advertise `dev` instead of a real-looking\n * release number.\n *\n * Works in every runtime the SDK targets:\n *   - Node 22.3+, Bun, Deno: native JSON import attributes.\n *   - Vite builds: the JSON import is replaced with a version-only shim, and\n *     the publish path injects the release-channel define as `published`.\n *     Other builds leave the define absent, so runtime chunks do not carry\n *     unrelated package metadata.\n *   - Vitest browser mode: Vite handles the import the same way as build.\n */\nexport const VERSION: string = pkg.version\n\nconst configuredReleaseSignal =\n  typeof __B2_SDK_RELEASE_CHANNEL__ === 'string' ? __B2_SDK_RELEASE_CHANNEL__ : 'dev'\n\nfunction isStableSemver(version: string): boolean {\n  const versionWithoutBuildMetadata = version.split('+', 1)[0] ?? version\n  return !versionWithoutBuildMetadata.includes('-')\n}\n\n/**\n * Resolve build version metadata from a version and positive release signal.\n *\n * @param version - Build semver read from package.json.\n * @param releaseSignal - Build-time release signal. Only `published` enables\n * the published channel, and prerelease semvers still resolve to `dev`.\n *\n * @returns The release-channel decision and User-Agent version segment.\n */\nexport function resolveVersion(\n  version: string,\n  releaseSignal: string | undefined = 'dev',\n): VersionResolution {\n  const isStableVersion = isStableSemver(version)\n  const isRelease = releaseSignal === 'published' && isStableVersion\n  const releaseChannel = isRelease ? 'published' : 'dev'\n\n  return {\n    version,\n    releaseChannel,\n    isPublishedRelease: isRelease,\n    productVersion: isRelease ? version : 'dev',\n  }\n}\n\nconst resolvedVersion = resolveVersion(VERSION, configuredReleaseSignal)\n\n/**\n * Current release channel. Defaults to `dev` unless the publish path injected\n * the positive release signal for a stable semver.\n */\nexport const RELEASE_CHANNEL: ReleaseChannel = resolvedVersion.releaseChannel\n\n/**\n * Whether the current artifact is a stable package built through the publish path.\n */\nexport const isPublishedRelease: boolean = resolvedVersion.isPublishedRelease\n\n/**\n * Version segment for the SDK User-Agent product token.\n * Kept as a function because it is derived resolver output consumed by the\n * User-Agent builder, not a second version constant for callers to maintain.\n *\n * @returns The package semver for stable published releases, otherwise `dev`.\n */\nexport function productVersion(): string {\n  return resolvedVersion.productVersion\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAwCA,IAAa,UAAkB,6BAAI;AAEnC,IAAM,0BAAA;AAGN,SAAS,eAAe,SAA0B;CAEhD,OAAO,EAD6B,QAAQ,MAAM,KAAK,CAAC,CAAC,CAAC,MAAM,QAAA,CAC5B,SAAS,GAAG;AAClD;;;;;;;;;;AAWA,SAAgB,eACd,SACA,gBAAoC,OACjB;CACnB,MAAM,kBAAkB,eAAe,OAAO;CAC9C,MAAM,YAAY,kBAAkB,eAAe;CAGnD,OAAO;EACL;EACA,gBAJqB,YAAY,cAAc;EAK/C,oBAAoB;EACpB,gBAAgB,YAAY,UAAU;CACxC;AACF;AAEA,IAAM,kBAAkB,eAAe,SAAS,uBAAuB;;;;;AAMvE,IAAa,kBAAkC,gBAAgB;;;;AAK/D,IAAa,qBAA8B,gBAAgB;;;;;;;;AAS3D,SAAgB,iBAAyB;CACvC,OAAO,gBAAgB;AACzB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@backblaze-labs/b2-sdk",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "The official Backblaze B2 Cloud Storage SDK for TypeScript and JavaScript",
   "license": "MIT",
   "type": "module",
@@ -194,6 +194,7 @@
   },
   "scripts": {
     "build": "vite build && node scripts/build-cts-types.mjs",
+    "build:release": "node scripts/build-release-artifact.mjs",
     "test": "vitest run",
     "test:slow": "vitest run --config vitest.slow.config.ts",
     "test:all": "vitest run && vitest run --config vitest.slow.config.ts",
@@ -205,19 +206,25 @@
     "lint:fix": "biome check --write .",
     "lint:docs": "eslint src/ --no-warn-ignored",
     "lint:docs:fix": "eslint src/ --fix --no-warn-ignored",
-    "lint:spelling": "cspell --no-progress --gitignore \"src/**/*.ts\" \"examples/**/*.ts\" \"examples/**/*.md\" \"adr/**/*.md\" \"*.md\" \"CLAUDE.md\"",
+    "lint:spelling": "cspell --no-progress --gitignore \"src/**/*.ts\" \"examples/**/*.ts\" \"examples/**/*.md\" \"docs/**/*.md\" \"*.md\"",
+    "audit:deps": "node scripts/audit-dependencies.mjs",
+    "test:audit:deps": "node --test scripts/audit-dependencies.test.mjs",
+    "test:release-channel": "node --test scripts/verify-release-channel.test.mjs",
     "typecheck": "tsc --noEmit",
     "typecheck:examples": "tsc --noEmit -p examples/tsconfig.json",
     "docs": "typedoc",
     "docs:watch": "typedoc --watch",
-    "clean": "rm -rf dist docs",
+    "clean": "rm -rf dist api-docs",
     "version": "node scripts/cut-changelog.mjs && git add CHANGELOG.md",
     "verify:metadata": "node --test scripts/verify-package-metadata.test.mjs && node scripts/verify-package-metadata.mjs",
     "verify:release": "node scripts/verify-release-workflow.mjs",
+    "verify:release-channel": "node scripts/verify-release-channel.mjs",
+    "verify:ci-docs-filter": "node --test scripts/verify-docs-only-classifier.test.mjs",
+    "verify:docs-consistency": "node --test scripts/verify-docs-consistency.test.mjs",
     "verify:exports": "node scripts/verify-package-exports.mjs",
     "verify:release-workflow": "node scripts/verify-release-workflow.mjs",
     "smoke:published": "node scripts/smoke-published-package.mjs",
     "test:smoke-published": "node --test scripts/smoke-published-package.test.mjs",
-    "verify": "pnpm run lint && pnpm run lint:docs && pnpm run lint:spelling && pnpm run typecheck && pnpm run typecheck:examples && pnpm run test && pnpm run build && pnpm run docs && pnpm run verify:metadata && pnpm run verify:release && pnpm run verify:exports"
+    "verify": "pnpm run lint && pnpm run lint:docs && pnpm run lint:spelling && pnpm run typecheck && pnpm run typecheck:examples && pnpm run test:audit:deps && pnpm run test && pnpm run test:release-channel && pnpm run build && pnpm run verify:release-channel && pnpm run docs && pnpm run verify:metadata && pnpm run verify:release && pnpm run verify:ci-docs-filter && pnpm run verify:docs-consistency && pnpm run verify:exports"
   }
 }