@backblaze-labs/b2-sdk 0.1.0 → 0.3.0

package/dist/sync/sha1-metadata.d.cts

@@ -0,0 +1,82 @@
+import { FileVersion } from '../types/file.js';
+/** Prefix used to mark SHA-1 metadata that must not prove equality without byte verification. */
+export declare const untrustedSha1Prefix = "unverified:";
+/** SHA-1 has not been computed or populated yet. */
+export interface SyncSha1PendingState {
+    /** State discriminator. */
+    readonly kind: 'pending';
+}
+/** SHA-1 is known to be unavailable for this path. */
+export interface SyncSha1UnavailableState {
+    /** State discriminator. */
+    readonly kind: 'unavailable';
+}
+/** SHA-1 is a normalized 40-character digest that may prove equality. */
+export interface SyncSha1VerifiedState {
+    /** State discriminator. */
+    readonly kind: 'verified';
+    /** Normalized lowercase 40-character SHA-1 digest. */
+    readonly value: string;
+}
+/** SHA-1 metadata is present but cannot prove equality without verification. */
+export interface SyncSha1UntrustedState {
+    /** State discriminator. */
+    readonly kind: 'untrusted';
+    /** Normalized digest when one can be extracted from the raw metadata. */
+    readonly value: string | null;
+    /** Original metadata string supplied by the scanner or B2 file version. */
+    readonly raw: string;
+}
+/** Public SHA-1 state used by sync scanners and low-level compare helpers. */
+export type SyncSha1State = SyncSha1PendingState | SyncSha1UnavailableState | SyncSha1VerifiedState | SyncSha1UntrustedState;
+/**
+ * Marks a verifiable SHA-1 digest as untrusted provider metadata.
+ *
+ * @param sha1 - Verifiable 40-character hexadecimal SHA-1 digest.
+ *
+ * @returns The untrusted SHA-1 sentinel value.
+ *
+ * @throws When the supplied value is not a verifiable SHA-1 digest.
+ */
+export declare function untrustedSha1(sha1: string): string;
+/**
+ * Extracts the best comparable SHA-1 value from a B2 file version.
+ *
+ * B2's primary `contentSha1` is authoritative for single-part uploads when it is a verifiable
+ * digest. Large/multipart B2 files report `contentSha1: null`; `fileInfo.large_file_sha1` is
+ * caller-provided metadata, so it is returned as an untrusted hint that cannot prove equality
+ * until the high-level synchronizer hashes the selected version's bytes.
+ *
+ * @param version - B2 file version metadata.
+ *
+ * @returns A lowercase comparable SHA-1, an untrusted sentinel, or null when unavailable.
+ */
+export declare function selectB2ComparableSha1(version: FileVersion): string | null;
+/**
+ * Returns whether a SHA-1 value is marked as untrusted metadata.
+ *
+ * @param sha1 - Candidate SHA-1 metadata.
+ *
+ * @returns True when the value carries B2's unverified sentinel prefix.
+ */
+export declare function isUntrustedSha1(sha1: string | null | undefined): boolean;
+/**
+ * Parses the public `SyncPath.contentSha1` value into an explicit trust/availability state.
+ *
+ * @param sha1 - The raw `contentSha1` field from a sync path.
+ *
+ * @returns A discriminated state so custom scanners do not need to decode sentinels directly.
+ */
+export declare function parseSyncContentSha1(sha1: string | null | undefined): SyncSha1State;
+/**
+ * Reads an explicit SHA-1 state when present, otherwise parses the compatibility field.
+ *
+ * @param path - Object carrying SHA-1 metadata.
+ *
+ * @returns The explicit or parsed SHA-1 state.
+ */
+export declare function syncSha1StateOf(path: {
+    readonly contentSha1?: string | null;
+    readonly contentSha1State?: SyncSha1State;
+}): SyncSha1State;
+//# sourceMappingURL=sha1-metadata.d.ts.map

package/dist/sync/sha1-metadata.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sha1-metadata.d.ts","sourceRoot":"","sources":["../../src/sync/sha1-metadata.js"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAGnD,iGAAiG;AACjG,eAAO,MAAM,mBAAmB,gBAAgB,CAAA;AAEhD,oDAAoD;AACpD,MAAM,WAAW,oBAAoB;IACnC,2BAA2B;IAC3B,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;CACzB;AAED,sDAAsD;AACtD,MAAM,WAAW,wBAAwB;IACvC,2BAA2B;IAC3B,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAA;CAC7B;AAED,yEAAyE;AACzE,MAAM,WAAW,qBAAqB;IACpC,2BAA2B;IAC3B,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;IACzB,sDAAsD;IACtD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CACvB;AAED,gFAAgF;AAChF,MAAM,WAAW,sBAAsB;IACrC,2BAA2B;IAC3B,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAA;IAC1B,yEAAyE;IACzE,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,2EAA2E;IAC3E,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CACrB;AAED,8EAA8E;AAC9E,MAAM,MAAM,aAAa,GACrB,oBAAoB,GACpB,wBAAwB,GACxB,qBAAqB,GACrB,sBAAsB,CAAA;AAE1B;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAIlD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI,CAU1E;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAExE;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,aAAa,CAanF;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE;IACpC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACpC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,aAAa,CAAA;CAC1C,GAAG,aAAa,CAEhB"}

package/dist/sync/sha1-metadata.d.ts

@@ -0,0 +1,82 @@
+import { FileVersion } from '../types/file.js';
+/** Prefix used to mark SHA-1 metadata that must not prove equality without byte verification. */
+export declare const untrustedSha1Prefix = "unverified:";
+/** SHA-1 has not been computed or populated yet. */
+export interface SyncSha1PendingState {
+    /** State discriminator. */
+    readonly kind: 'pending';
+}
+/** SHA-1 is known to be unavailable for this path. */
+export interface SyncSha1UnavailableState {
+    /** State discriminator. */
+    readonly kind: 'unavailable';
+}
+/** SHA-1 is a normalized 40-character digest that may prove equality. */
+export interface SyncSha1VerifiedState {
+    /** State discriminator. */
+    readonly kind: 'verified';
+    /** Normalized lowercase 40-character SHA-1 digest. */
+    readonly value: string;
+}
+/** SHA-1 metadata is present but cannot prove equality without verification. */
+export interface SyncSha1UntrustedState {
+    /** State discriminator. */
+    readonly kind: 'untrusted';
+    /** Normalized digest when one can be extracted from the raw metadata. */
+    readonly value: string | null;
+    /** Original metadata string supplied by the scanner or B2 file version. */
+    readonly raw: string;
+}
+/** Public SHA-1 state used by sync scanners and low-level compare helpers. */
+export type SyncSha1State = SyncSha1PendingState | SyncSha1UnavailableState | SyncSha1VerifiedState | SyncSha1UntrustedState;
+/**
+ * Marks a verifiable SHA-1 digest as untrusted provider metadata.
+ *
+ * @param sha1 - Verifiable 40-character hexadecimal SHA-1 digest.
+ *
+ * @returns The untrusted SHA-1 sentinel value.
+ *
+ * @throws When the supplied value is not a verifiable SHA-1 digest.
+ */
+export declare function untrustedSha1(sha1: string): string;
+/**
+ * Extracts the best comparable SHA-1 value from a B2 file version.
+ *
+ * B2's primary `contentSha1` is authoritative for single-part uploads when it is a verifiable
+ * digest. Large/multipart B2 files report `contentSha1: null`; `fileInfo.large_file_sha1` is
+ * caller-provided metadata, so it is returned as an untrusted hint that cannot prove equality
+ * until the high-level synchronizer hashes the selected version's bytes.
+ *
+ * @param version - B2 file version metadata.
+ *
+ * @returns A lowercase comparable SHA-1, an untrusted sentinel, or null when unavailable.
+ */
+export declare function selectB2ComparableSha1(version: FileVersion): string | null;
+/**
+ * Returns whether a SHA-1 value is marked as untrusted metadata.
+ *
+ * @param sha1 - Candidate SHA-1 metadata.
+ *
+ * @returns True when the value carries B2's unverified sentinel prefix.
+ */
+export declare function isUntrustedSha1(sha1: string | null | undefined): boolean;
+/**
+ * Parses the public `SyncPath.contentSha1` value into an explicit trust/availability state.
+ *
+ * @param sha1 - The raw `contentSha1` field from a sync path.
+ *
+ * @returns A discriminated state so custom scanners do not need to decode sentinels directly.
+ */
+export declare function parseSyncContentSha1(sha1: string | null | undefined): SyncSha1State;
+/**
+ * Reads an explicit SHA-1 state when present, otherwise parses the compatibility field.
+ *
+ * @param path - Object carrying SHA-1 metadata.
+ *
+ * @returns The explicit or parsed SHA-1 state.
+ */
+export declare function syncSha1StateOf(path: {
+    readonly contentSha1?: string | null;
+    readonly contentSha1State?: SyncSha1State;
+}): SyncSha1State;
+//# sourceMappingURL=sha1-metadata.d.ts.map

package/dist/sync/sha1-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sha1-metadata.d.ts","sourceRoot":"","sources":["../../src/sync/sha1-metadata.js"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAGnD,iGAAiG;AACjG,eAAO,MAAM,mBAAmB,gBAAgB,CAAA;AAEhD,oDAAoD;AACpD,MAAM,WAAW,oBAAoB;IACnC,2BAA2B;IAC3B,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;CACzB;AAED,sDAAsD;AACtD,MAAM,WAAW,wBAAwB;IACvC,2BAA2B;IAC3B,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAA;CAC7B;AAED,yEAAyE;AACzE,MAAM,WAAW,qBAAqB;IACpC,2BAA2B;IAC3B,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;IACzB,sDAAsD;IACtD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CACvB;AAED,gFAAgF;AAChF,MAAM,WAAW,sBAAsB;IACrC,2BAA2B;IAC3B,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAA;IAC1B,yEAAyE;IACzE,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,2EAA2E;IAC3E,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CACrB;AAED,8EAA8E;AAC9E,MAAM,MAAM,aAAa,GACrB,oBAAoB,GACpB,wBAAwB,GACxB,qBAAqB,GACrB,sBAAsB,CAAA;AAE1B;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAIlD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI,CAU1E;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAExE;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,aAAa,CAanF;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE;IACpC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACpC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,aAAa,CAAA;CAC1C,GAAG,aAAa,CAEhB"}

package/dist/sync/sha1-metadata.js

@@ -0,0 +1,89 @@
+import { normalizeVerifiableSha1 } from "../util/sha1.js";
+//#region src/sync/sha1-metadata.ts
+/** Prefix used to mark SHA-1 metadata that must not prove equality without byte verification. */
+var untrustedSha1Prefix = "unverified:";
+/**
+* Marks a verifiable SHA-1 digest as untrusted provider metadata.
+*
+* @param sha1 - Verifiable 40-character hexadecimal SHA-1 digest.
+*
+* @returns The untrusted SHA-1 sentinel value.
+*
+* @throws When the supplied value is not a verifiable SHA-1 digest.
+*/
+function untrustedSha1(sha1) {
+	const normalized = normalizeVerifiableSha1(sha1);
+	if (normalized === null) throw new Error("untrusted SHA-1 metadata must be verifiable");
+	return `${untrustedSha1Prefix}${normalized}`;
+}
+/**
+* Extracts the best comparable SHA-1 value from a B2 file version.
+*
+* B2's primary `contentSha1` is authoritative for single-part uploads when it is a verifiable
+* digest. Large/multipart B2 files report `contentSha1: null`; `fileInfo.large_file_sha1` is
+* caller-provided metadata, so it is returned as an untrusted hint that cannot prove equality
+* until the high-level synchronizer hashes the selected version's bytes.
+*
+* @param version - B2 file version metadata.
+*
+* @returns A lowercase comparable SHA-1, an untrusted sentinel, or null when unavailable.
+*/
+function selectB2ComparableSha1(version) {
+	const originalContentSha1 = version.contentSha1;
+	if (typeof originalContentSha1 === "string") {
+		if (isUntrustedSha1(originalContentSha1)) return originalContentSha1.toLowerCase();
+		return normalizeVerifiableSha1(originalContentSha1) ?? originalContentSha1.toLowerCase();
+	}
+	const largeFileSha1 = normalizeVerifiableSha1(version.fileInfo["large_file_sha1"]);
+	return largeFileSha1 === null ? null : untrustedSha1(largeFileSha1);
+}
+/**
+* Returns whether a SHA-1 value is marked as untrusted metadata.
+*
+* @param sha1 - Candidate SHA-1 metadata.
+*
+* @returns True when the value carries B2's unverified sentinel prefix.
+*/
+function isUntrustedSha1(sha1) {
+	return sha1?.toLowerCase().startsWith("unverified:") ?? false;
+}
+/**
+* Parses the public `SyncPath.contentSha1` value into an explicit trust/availability state.
+*
+* @param sha1 - The raw `contentSha1` field from a sync path.
+*
+* @returns A discriminated state so custom scanners do not need to decode sentinels directly.
+*/
+function parseSyncContentSha1(sha1) {
+	if (sha1 === void 0) return { kind: "pending" };
+	if (sha1 === null) return { kind: "unavailable" };
+	if (isUntrustedSha1(sha1)) return {
+		kind: "untrusted",
+		raw: sha1,
+		value: normalizeVerifiableSha1(sha1.slice(11))
+	};
+	const normalized = normalizeVerifiableSha1(sha1);
+	if (normalized === null) return {
+		kind: "untrusted",
+		raw: sha1,
+		value: null
+	};
+	return {
+		kind: "verified",
+		value: normalized
+	};
+}
+/**
+* Reads an explicit SHA-1 state when present, otherwise parses the compatibility field.
+*
+* @param path - Object carrying SHA-1 metadata.
+*
+* @returns The explicit or parsed SHA-1 state.
+*/
+function syncSha1StateOf(path) {
+	return path.contentSha1State ?? parseSyncContentSha1(path.contentSha1);
+}
+//#endregion
+export { isUntrustedSha1, parseSyncContentSha1, selectB2ComparableSha1, syncSha1StateOf, untrustedSha1, untrustedSha1Prefix };
+
+//# sourceMappingURL=sha1-metadata.js.map

package/dist/sync/sha1-metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sha1-metadata.js","names":[],"sources":["../../src/sync/sha1-metadata.ts"],"sourcesContent":["import type { FileVersion } from '../types/file.ts'\nimport { normalizeVerifiableSha1 } from '../util/sha1.ts'\n\n/** Prefix used to mark SHA-1 metadata that must not prove equality without byte verification. */\nexport const untrustedSha1Prefix = 'unverified:'\n\n/** SHA-1 has not been computed or populated yet. */\nexport interface SyncSha1PendingState {\n  /** State discriminator. */\n  readonly kind: 'pending'\n}\n\n/** SHA-1 is known to be unavailable for this path. */\nexport interface SyncSha1UnavailableState {\n  /** State discriminator. */\n  readonly kind: 'unavailable'\n}\n\n/** SHA-1 is a normalized 40-character digest that may prove equality. */\nexport interface SyncSha1VerifiedState {\n  /** State discriminator. */\n  readonly kind: 'verified'\n  /** Normalized lowercase 40-character SHA-1 digest. */\n  readonly value: string\n}\n\n/** SHA-1 metadata is present but cannot prove equality without verification. */\nexport interface SyncSha1UntrustedState {\n  /** State discriminator. */\n  readonly kind: 'untrusted'\n  /** Normalized digest when one can be extracted from the raw metadata. */\n  readonly value: string | null\n  /** Original metadata string supplied by the scanner or B2 file version. */\n  readonly raw: string\n}\n\n/** Public SHA-1 state used by sync scanners and low-level compare helpers. */\nexport type SyncSha1State =\n  | SyncSha1PendingState\n  | SyncSha1UnavailableState\n  | SyncSha1VerifiedState\n  | SyncSha1UntrustedState\n\n/**\n * Marks a verifiable SHA-1 digest as untrusted provider metadata.\n *\n * @param sha1 - Verifiable 40-character hexadecimal SHA-1 digest.\n *\n * @returns The untrusted SHA-1 sentinel value.\n *\n * @throws When the supplied value is not a verifiable SHA-1 digest.\n */\nexport function untrustedSha1(sha1: string): string {\n  const normalized = normalizeVerifiableSha1(sha1)\n  if (normalized === null) throw new Error('untrusted SHA-1 metadata must be verifiable')\n  return `${untrustedSha1Prefix}${normalized}`\n}\n\n/**\n * Extracts the best comparable SHA-1 value from a B2 file version.\n *\n * B2's primary `contentSha1` is authoritative for single-part uploads when it is a verifiable\n * digest. Large/multipart B2 files report `contentSha1: null`; `fileInfo.large_file_sha1` is\n * caller-provided metadata, so it is returned as an untrusted hint that cannot prove equality\n * until the high-level synchronizer hashes the selected version's bytes.\n *\n * @param version - B2 file version metadata.\n *\n * @returns A lowercase comparable SHA-1, an untrusted sentinel, or null when unavailable.\n */\nexport function selectB2ComparableSha1(version: FileVersion): string | null {\n  const originalContentSha1 = version.contentSha1\n  if (typeof originalContentSha1 === 'string') {\n    if (isUntrustedSha1(originalContentSha1)) return originalContentSha1.toLowerCase()\n    const contentSha1 = normalizeVerifiableSha1(originalContentSha1)\n    return contentSha1 ?? originalContentSha1.toLowerCase()\n  }\n\n  const largeFileSha1 = normalizeVerifiableSha1(version.fileInfo['large_file_sha1'])\n  return largeFileSha1 === null ? null : untrustedSha1(largeFileSha1)\n}\n\n/**\n * Returns whether a SHA-1 value is marked as untrusted metadata.\n *\n * @param sha1 - Candidate SHA-1 metadata.\n *\n * @returns True when the value carries B2's unverified sentinel prefix.\n */\nexport function isUntrustedSha1(sha1: string | null | undefined): boolean {\n  return sha1?.toLowerCase().startsWith(untrustedSha1Prefix) ?? false\n}\n\n/**\n * Parses the public `SyncPath.contentSha1` value into an explicit trust/availability state.\n *\n * @param sha1 - The raw `contentSha1` field from a sync path.\n *\n * @returns A discriminated state so custom scanners do not need to decode sentinels directly.\n */\nexport function parseSyncContentSha1(sha1: string | null | undefined): SyncSha1State {\n  if (sha1 === undefined) return { kind: 'pending' }\n  if (sha1 === null) return { kind: 'unavailable' }\n  if (isUntrustedSha1(sha1)) {\n    return {\n      kind: 'untrusted',\n      raw: sha1,\n      value: normalizeVerifiableSha1(sha1.slice(untrustedSha1Prefix.length)),\n    }\n  }\n  const normalized = normalizeVerifiableSha1(sha1)\n  if (normalized === null) return { kind: 'untrusted', raw: sha1, value: null }\n  return { kind: 'verified', value: normalized }\n}\n\n/**\n * Reads an explicit SHA-1 state when present, otherwise parses the compatibility field.\n *\n * @param path - Object carrying SHA-1 metadata.\n *\n * @returns The explicit or parsed SHA-1 state.\n */\nexport function syncSha1StateOf(path: {\n  readonly contentSha1?: string | null\n  readonly contentSha1State?: SyncSha1State\n}): SyncSha1State {\n  return path.contentSha1State ?? parseSyncContentSha1(path.contentSha1)\n}\n"],"mappings":";;;AAIA,IAAa,sBAAsB;;;;;;;;;;AAgDnC,SAAgB,cAAc,MAAsB;CAClD,MAAM,aAAa,wBAAwB,IAAI;CAC/C,IAAI,eAAe,MAAM,MAAM,IAAI,MAAM,6CAA6C;CACtF,OAAO,GAAG,sBAAsB;AAClC;;;;;;;;;;;;;AAcA,SAAgB,uBAAuB,SAAqC;CAC1E,MAAM,sBAAsB,QAAQ;CACpC,IAAI,OAAO,wBAAwB,UAAU;EAC3C,IAAI,gBAAgB,mBAAmB,GAAG,OAAO,oBAAoB,YAAY;EAEjF,OADoB,wBAAwB,mBACrC,KAAe,oBAAoB,YAAY;CACxD;CAEA,MAAM,gBAAgB,wBAAwB,QAAQ,SAAS,kBAAkB;CACjF,OAAO,kBAAkB,OAAO,OAAO,cAAc,aAAa;AACpE;;;;;;;;AASA,SAAgB,gBAAgB,MAA0C;CACxE,OAAO,MAAM,YAAY,CAAC,CAAC,WAAA,aAA8B,KAAK;AAChE;;;;;;;;AASA,SAAgB,qBAAqB,MAAgD;CACnF,IAAI,SAAS,KAAA,GAAW,OAAO,EAAE,MAAM,UAAU;CACjD,IAAI,SAAS,MAAM,OAAO,EAAE,MAAM,cAAc;CAChD,IAAI,gBAAgB,IAAI,GACtB,OAAO;EACL,MAAM;EACN,KAAK;EACL,OAAO,wBAAwB,KAAK,MAAM,EAA0B,CAAC;CACvE;CAEF,MAAM,aAAa,wBAAwB,IAAI;CAC/C,IAAI,eAAe,MAAM,OAAO;EAAE,MAAM;EAAa,KAAK;EAAM,OAAO;CAAK;CAC5E,OAAO;EAAE,MAAM;EAAY,OAAO;CAAW;AAC/C;;;;;;;;AASA,SAAgB,gBAAgB,MAGd;CAChB,OAAO,KAAK,oBAAoB,qBAAqB,KAAK,WAAW;AACvE"}

package/dist/sync/sha1-options.cjs

@@ -0,0 +1,23 @@
+//#region src/sync/sha1-options.ts
+/** Default idle/no-progress timeout for SHA-1 reads. */
+var DEFAULT_SHA1_IDLE_TIMEOUT_MILLIS = 3e4;
+/** Default absolute deadline for one untrusted B2 SHA-1 verification read. */
+var DEFAULT_SHA1_VERIFICATION_TIMEOUT_MILLIS = 3e5;
+/**
+* Normalizes a user-provided SHA-1 timeout value.
+*
+* @param value - Optional timeout in milliseconds.
+* @param defaultValue - Default timeout when the value is missing or invalid.
+*
+* @returns A positive integer timeout in milliseconds.
+*/
+function normalizeSha1TimeoutMillis(value, defaultValue = DEFAULT_SHA1_IDLE_TIMEOUT_MILLIS) {
+	if (value === void 0 || !Number.isFinite(value) || value < 1) return defaultValue;
+	return Math.floor(value);
+}
+//#endregion
+exports.DEFAULT_SHA1_IDLE_TIMEOUT_MILLIS = DEFAULT_SHA1_IDLE_TIMEOUT_MILLIS;
+exports.DEFAULT_SHA1_VERIFICATION_TIMEOUT_MILLIS = DEFAULT_SHA1_VERIFICATION_TIMEOUT_MILLIS;
+exports.normalizeSha1TimeoutMillis = normalizeSha1TimeoutMillis;
+
+//# sourceMappingURL=sha1-options.cjs.map

package/dist/sync/sha1-options.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"sha1-options.cjs","names":[],"sources":["../../src/sync/sha1-options.ts"],"sourcesContent":["/** Default idle/no-progress timeout for SHA-1 reads. */\nexport const DEFAULT_SHA1_IDLE_TIMEOUT_MILLIS = 30_000\n\n/** Default absolute deadline for one untrusted B2 SHA-1 verification read. */\nexport const DEFAULT_SHA1_VERIFICATION_TIMEOUT_MILLIS = 300_000\n\n/**\n * Normalizes a user-provided SHA-1 timeout value.\n *\n * @param value - Optional timeout in milliseconds.\n * @param defaultValue - Default timeout when the value is missing or invalid.\n *\n * @returns A positive integer timeout in milliseconds.\n */\nexport function normalizeSha1TimeoutMillis(\n  value: number | undefined,\n  defaultValue = DEFAULT_SHA1_IDLE_TIMEOUT_MILLIS,\n): number {\n  if (value === undefined || !Number.isFinite(value) || value < 1) {\n    return defaultValue\n  }\n  return Math.floor(value)\n}\n"],"mappings":";;AACA,IAAa,mCAAmC;;AAGhD,IAAa,2CAA2C;;;;;;;;;AAUxD,SAAgB,2BACd,OACA,eAAe,kCACP;CACR,IAAI,UAAU,KAAA,KAAa,CAAC,OAAO,SAAS,KAAK,KAAK,QAAQ,GAC5D,OAAO;CAET,OAAO,KAAK,MAAM,KAAK;AACzB"}

package/dist/sync/sha1-options.d.cts

@@ -0,0 +1,14 @@
+/** Default idle/no-progress timeout for SHA-1 reads. */
+export declare const DEFAULT_SHA1_IDLE_TIMEOUT_MILLIS = 30000;
+/** Default absolute deadline for one untrusted B2 SHA-1 verification read. */
+export declare const DEFAULT_SHA1_VERIFICATION_TIMEOUT_MILLIS = 300000;
+/**
+ * Normalizes a user-provided SHA-1 timeout value.
+ *
+ * @param value - Optional timeout in milliseconds.
+ * @param defaultValue - Default timeout when the value is missing or invalid.
+ *
+ * @returns A positive integer timeout in milliseconds.
+ */
+export declare function normalizeSha1TimeoutMillis(value: number | undefined, defaultValue?: number): number;
+//# sourceMappingURL=sha1-options.d.ts.map

package/dist/sync/sha1-options.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sha1-options.d.ts","sourceRoot":"","sources":["../../src/sync/sha1-options.js"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,eAAO,MAAM,gCAAgC,QAAS,CAAA;AAEtD,8EAA8E;AAC9E,eAAO,MAAM,wCAAwC,SAAU,CAAA;AAE/D;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,YAAY,SAAmC,GAC9C,MAAM,CAKR"}

package/dist/sync/sha1-options.d.ts

@@ -0,0 +1,14 @@
+/** Default idle/no-progress timeout for SHA-1 reads. */
+export declare const DEFAULT_SHA1_IDLE_TIMEOUT_MILLIS = 30000;
+/** Default absolute deadline for one untrusted B2 SHA-1 verification read. */
+export declare const DEFAULT_SHA1_VERIFICATION_TIMEOUT_MILLIS = 300000;
+/**
+ * Normalizes a user-provided SHA-1 timeout value.
+ *
+ * @param value - Optional timeout in milliseconds.
+ * @param defaultValue - Default timeout when the value is missing or invalid.
+ *
+ * @returns A positive integer timeout in milliseconds.
+ */
+export declare function normalizeSha1TimeoutMillis(value: number | undefined, defaultValue?: number): number;
+//# sourceMappingURL=sha1-options.d.ts.map

package/dist/sync/sha1-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sha1-options.d.ts","sourceRoot":"","sources":["../../src/sync/sha1-options.js"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,eAAO,MAAM,gCAAgC,QAAS,CAAA;AAEtD,8EAA8E;AAC9E,eAAO,MAAM,wCAAwC,SAAU,CAAA;AAE/D;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,YAAY,SAAmC,GAC9C,MAAM,CAKR"}

package/dist/sync/sha1-options.js

@@ -0,0 +1,21 @@
+//#region src/sync/sha1-options.ts
+/** Default idle/no-progress timeout for SHA-1 reads. */
+var DEFAULT_SHA1_IDLE_TIMEOUT_MILLIS = 3e4;
+/** Default absolute deadline for one untrusted B2 SHA-1 verification read. */
+var DEFAULT_SHA1_VERIFICATION_TIMEOUT_MILLIS = 3e5;
+/**
+* Normalizes a user-provided SHA-1 timeout value.
+*
+* @param value - Optional timeout in milliseconds.
+* @param defaultValue - Default timeout when the value is missing or invalid.
+*
+* @returns A positive integer timeout in milliseconds.
+*/
+function normalizeSha1TimeoutMillis(value, defaultValue = DEFAULT_SHA1_IDLE_TIMEOUT_MILLIS) {
+	if (value === void 0 || !Number.isFinite(value) || value < 1) return defaultValue;
+	return Math.floor(value);
+}
+//#endregion
+export { DEFAULT_SHA1_IDLE_TIMEOUT_MILLIS, DEFAULT_SHA1_VERIFICATION_TIMEOUT_MILLIS, normalizeSha1TimeoutMillis };
+
+//# sourceMappingURL=sha1-options.js.map

package/dist/sync/sha1-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sha1-options.js","names":[],"sources":["../../src/sync/sha1-options.ts"],"sourcesContent":["/** Default idle/no-progress timeout for SHA-1 reads. */\nexport const DEFAULT_SHA1_IDLE_TIMEOUT_MILLIS = 30_000\n\n/** Default absolute deadline for one untrusted B2 SHA-1 verification read. */\nexport const DEFAULT_SHA1_VERIFICATION_TIMEOUT_MILLIS = 300_000\n\n/**\n * Normalizes a user-provided SHA-1 timeout value.\n *\n * @param value - Optional timeout in milliseconds.\n * @param defaultValue - Default timeout when the value is missing or invalid.\n *\n * @returns A positive integer timeout in milliseconds.\n */\nexport function normalizeSha1TimeoutMillis(\n  value: number | undefined,\n  defaultValue = DEFAULT_SHA1_IDLE_TIMEOUT_MILLIS,\n): number {\n  if (value === undefined || !Number.isFinite(value) || value < 1) {\n    return defaultValue\n  }\n  return Math.floor(value)\n}\n"],"mappings":";;AACA,IAAa,mCAAmC;;AAGhD,IAAa,2CAA2C;;;;;;;;;AAUxD,SAAgB,2BACd,OACA,eAAe,kCACP;CACR,IAAI,UAAU,KAAA,KAAa,CAAC,OAAO,SAAS,KAAK,KAAK,QAAQ,GAC5D,OAAO;CAET,OAAO,KAAK,MAAM,KAAK;AACzB"}