@rockhall/electron-offline-content 0.4.0

package/dist/internal/asset-file-name.cjs

@@ -0,0 +1,13 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_shared_errors = require("../shared/errors.cjs");
+//#region src/internal/asset-file-name.ts
+/** Derives a file name from the asset URL path. */
+function deriveAssetFileName(url) {
+	const candidate = (new URL(url).pathname ?? "").split("/").filter(Boolean).at(-1);
+	if (!candidate) throw new require_shared_errors.StoreValidationError(`Asset URL "${url}" must include a filename in the path, or set an explicit "fileName" on the asset.`);
+	return decodeURIComponent(candidate);
+}
+//#endregion
+exports.deriveAssetFileName = deriveAssetFileName;
+
+//# sourceMappingURL=asset-file-name.cjs.map

package/dist/internal/asset-file-name.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-file-name.cjs","names":["StoreValidationError"],"sources":["../../src/internal/asset-file-name.ts"],"sourcesContent":["import { StoreValidationError } from \"../shared/errors.js\";\n\n/** Derives a file name from the asset URL path. */\nexport function deriveAssetFileName(url: string): string {\n  const parsed = new URL(url);\n  const path = parsed.pathname ?? \"\";\n  const segments = path.split(\"/\").filter(Boolean);\n  const candidate = segments.at(-1);\n  if (!candidate) {\n    throw new StoreValidationError(\n      `Asset URL \"${url}\" must include a filename in the path, or set an explicit \"fileName\" on the asset.`,\n    );\n  }\n\n  return decodeURIComponent(candidate);\n}\n"],"mappings":";;;;AAGA,SAAgB,oBAAoB,KAAqB;CAIvD,MAAM,aAFO,IADM,IAAI,IACJ,CAAC,YAAY,IACV,MAAM,IAAI,CAAC,OAAO,QACd,CAAC,GAAG,GAAG;CACjC,IAAI,CAAC,WACH,MAAM,IAAIA,sBAAAA,qBACR,cAAc,IAAI,oFACnB;CAGH,OAAO,mBAAmB,UAAU"}

package/dist/internal/asset-file-name.d.cts

@@ -0,0 +1,6 @@
+//#region src/internal/asset-file-name.d.ts
+/** Derives a file name from the asset URL path. */
+declare function deriveAssetFileName(url: string): string;
+//#endregion
+export { deriveAssetFileName };
+//# sourceMappingURL=asset-file-name.d.cts.map

package/dist/internal/asset-file-name.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-file-name.d.cts","names":[],"sources":["../../src/internal/asset-file-name.ts"],"mappings":";;iBAGgB,mBAAA,CAAoB,GAAA"}

package/dist/internal/asset-file-name.d.ts

@@ -0,0 +1,6 @@
+//#region src/internal/asset-file-name.d.ts
+/** Derives a file name from the asset URL path. */
+declare function deriveAssetFileName(url: string): string;
+//#endregion
+export { deriveAssetFileName };
+//# sourceMappingURL=asset-file-name.d.ts.map

package/dist/internal/asset-file-name.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-file-name.d.ts","names":[],"sources":["../../src/internal/asset-file-name.ts"],"mappings":";;iBAGgB,mBAAA,CAAoB,GAAA"}

package/dist/internal/asset-file-name.js

@@ -0,0 +1,12 @@
+import { StoreValidationError } from "../shared/errors.js";
+//#region src/internal/asset-file-name.ts
+/** Derives a file name from the asset URL path. */
+function deriveAssetFileName(url) {
+	const candidate = (new URL(url).pathname ?? "").split("/").filter(Boolean).at(-1);
+	if (!candidate) throw new StoreValidationError(`Asset URL "${url}" must include a filename in the path, or set an explicit "fileName" on the asset.`);
+	return decodeURIComponent(candidate);
+}
+//#endregion
+export { deriveAssetFileName };
+
+//# sourceMappingURL=asset-file-name.js.map

package/dist/internal/asset-file-name.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-file-name.js","names":[],"sources":["../../src/internal/asset-file-name.ts"],"sourcesContent":["import { StoreValidationError } from \"../shared/errors.js\";\n\n/** Derives a file name from the asset URL path. */\nexport function deriveAssetFileName(url: string): string {\n  const parsed = new URL(url);\n  const path = parsed.pathname ?? \"\";\n  const segments = path.split(\"/\").filter(Boolean);\n  const candidate = segments.at(-1);\n  if (!candidate) {\n    throw new StoreValidationError(\n      `Asset URL \"${url}\" must include a filename in the path, or set an explicit \"fileName\" on the asset.`,\n    );\n  }\n\n  return decodeURIComponent(candidate);\n}\n"],"mappings":";;;AAGA,SAAgB,oBAAoB,KAAqB;CAIvD,MAAM,aAFO,IADM,IAAI,IACJ,CAAC,YAAY,IACV,MAAM,IAAI,CAAC,OAAO,QACd,CAAC,GAAG,GAAG;CACjC,IAAI,CAAC,WACH,MAAM,IAAI,qBACR,cAAc,IAAI,oFACnB;CAGH,OAAO,mBAAmB,UAAU"}

package/dist/internal/asset-key.cjs

@@ -0,0 +1,30 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+let node_crypto = require("node:crypto");
+//#region src/internal/asset-key.ts
+/**
+* Hash an asset key input to a fixed 16-char hex string for storage identity.
+* String inputs are treated as a single segment. Array inputs are joined with
+* null-byte separators to prevent ambiguity between segment boundaries.
+*/
+function hashKey(input) {
+	const normalized = typeof input === "string" ? input : input.join("\0");
+	return (0, node_crypto.createHash)("sha256").update(normalized).digest("hex").slice(0, 16);
+}
+/** Produce a human-readable display key for debugging and UI. */
+function displayKey(input) {
+	return typeof input === "string" ? input : input.join("/");
+}
+/**
+* Validate that an asset key input is non-empty.
+* Returns `true` if the input is a non-empty string or a non-empty array of non-empty strings.
+*/
+function isValidKeyInput(input) {
+	if (typeof input === "string") return input.length > 0;
+	return input.length > 0 && input.every((s) => s.length > 0);
+}
+//#endregion
+exports.displayKey = displayKey;
+exports.hashKey = hashKey;
+exports.isValidKeyInput = isValidKeyInput;
+
+//# sourceMappingURL=asset-key.cjs.map

package/dist/internal/asset-key.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-key.cjs","names":[],"sources":["../../src/internal/asset-key.ts"],"sourcesContent":["import { createHash } from \"node:crypto\";\n\n/** Accepted asset key input: a plain string or an array of string segments. */\nexport type AssetKeyInput = string | readonly string[];\n\n/**\n * Hash an asset key input to a fixed 16-char hex string for storage identity.\n * String inputs are treated as a single segment. Array inputs are joined with\n * null-byte separators to prevent ambiguity between segment boundaries.\n */\nexport function hashKey(input: AssetKeyInput): string {\n  const normalized = typeof input === \"string\" ? input : input.join(\"\\0\");\n  return createHash(\"sha256\").update(normalized).digest(\"hex\").slice(0, 16);\n}\n\n/** Produce a human-readable display key for debugging and UI. */\nexport function displayKey(input: AssetKeyInput): string {\n  return typeof input === \"string\" ? input : input.join(\"/\");\n}\n\n/**\n * Validate that an asset key input is non-empty.\n * Returns `true` if the input is a non-empty string or a non-empty array of non-empty strings.\n */\nexport function isValidKeyInput(input: AssetKeyInput): boolean {\n  if (typeof input === \"string\") return input.length > 0;\n  return input.length > 0 && input.every((s) => s.length > 0);\n}\n"],"mappings":";;;;;;;;AAUA,SAAgB,QAAQ,OAA8B;CACpD,MAAM,aAAa,OAAO,UAAU,WAAW,QAAQ,MAAM,KAAK,KAAK;CACvE,QAAA,GAAA,YAAA,YAAkB,SAAS,CAAC,OAAO,WAAW,CAAC,OAAO,MAAM,CAAC,MAAM,GAAG,GAAG;;;AAI3E,SAAgB,WAAW,OAA8B;CACvD,OAAO,OAAO,UAAU,WAAW,QAAQ,MAAM,KAAK,IAAI;;;;;;AAO5D,SAAgB,gBAAgB,OAA+B;CAC7D,IAAI,OAAO,UAAU,UAAU,OAAO,MAAM,SAAS;CACrD,OAAO,MAAM,SAAS,KAAK,MAAM,OAAO,MAAM,EAAE,SAAS,EAAE"}

package/dist/internal/asset-key.d.cts

@@ -0,0 +1,19 @@
+//#region src/internal/asset-key.d.ts
+/** Accepted asset key input: a plain string or an array of string segments. */
+type AssetKeyInput = string | readonly string[];
+/**
+ * Hash an asset key input to a fixed 16-char hex string for storage identity.
+ * String inputs are treated as a single segment. Array inputs are joined with
+ * null-byte separators to prevent ambiguity between segment boundaries.
+ */
+declare function hashKey(input: AssetKeyInput): string;
+/** Produce a human-readable display key for debugging and UI. */
+declare function displayKey(input: AssetKeyInput): string;
+/**
+ * Validate that an asset key input is non-empty.
+ * Returns `true` if the input is a non-empty string or a non-empty array of non-empty strings.
+ */
+declare function isValidKeyInput(input: AssetKeyInput): boolean;
+//#endregion
+export { AssetKeyInput, displayKey, hashKey, isValidKeyInput };
+//# sourceMappingURL=asset-key.d.cts.map

package/dist/internal/asset-key.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-key.d.cts","names":[],"sources":["../../src/internal/asset-key.ts"],"mappings":";;KAGY,aAAA;;;;;AAOZ;iBAAgB,OAAA,CAAQ,KAAA,EAAO,aAAA;;iBAMf,UAAA,CAAW,KAAA,EAAO,aAAA;;AAAlC;;;iBAQgB,eAAA,CAAgB,KAAA,EAAO,aAAA"}

package/dist/internal/asset-key.d.ts

@@ -0,0 +1,19 @@
+//#region src/internal/asset-key.d.ts
+/** Accepted asset key input: a plain string or an array of string segments. */
+type AssetKeyInput = string | readonly string[];
+/**
+ * Hash an asset key input to a fixed 16-char hex string for storage identity.
+ * String inputs are treated as a single segment. Array inputs are joined with
+ * null-byte separators to prevent ambiguity between segment boundaries.
+ */
+declare function hashKey(input: AssetKeyInput): string;
+/** Produce a human-readable display key for debugging and UI. */
+declare function displayKey(input: AssetKeyInput): string;
+/**
+ * Validate that an asset key input is non-empty.
+ * Returns `true` if the input is a non-empty string or a non-empty array of non-empty strings.
+ */
+declare function isValidKeyInput(input: AssetKeyInput): boolean;
+//#endregion
+export { AssetKeyInput, displayKey, hashKey, isValidKeyInput };
+//# sourceMappingURL=asset-key.d.ts.map

package/dist/internal/asset-key.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-key.d.ts","names":[],"sources":["../../src/internal/asset-key.ts"],"mappings":";;KAGY,aAAA;;;;;AAOZ;iBAAgB,OAAA,CAAQ,KAAA,EAAO,aAAA;;iBAMf,UAAA,CAAW,KAAA,EAAO,aAAA;;AAAlC;;;iBAQgB,eAAA,CAAgB,KAAA,EAAO,aAAA"}

package/dist/internal/asset-key.js

@@ -0,0 +1,27 @@
+import { createHash } from "node:crypto";
+//#region src/internal/asset-key.ts
+/**
+* Hash an asset key input to a fixed 16-char hex string for storage identity.
+* String inputs are treated as a single segment. Array inputs are joined with
+* null-byte separators to prevent ambiguity between segment boundaries.
+*/
+function hashKey(input) {
+	const normalized = typeof input === "string" ? input : input.join("\0");
+	return createHash("sha256").update(normalized).digest("hex").slice(0, 16);
+}
+/** Produce a human-readable display key for debugging and UI. */
+function displayKey(input) {
+	return typeof input === "string" ? input : input.join("/");
+}
+/**
+* Validate that an asset key input is non-empty.
+* Returns `true` if the input is a non-empty string or a non-empty array of non-empty strings.
+*/
+function isValidKeyInput(input) {
+	if (typeof input === "string") return input.length > 0;
+	return input.length > 0 && input.every((s) => s.length > 0);
+}
+//#endregion
+export { displayKey, hashKey, isValidKeyInput };
+
+//# sourceMappingURL=asset-key.js.map

package/dist/internal/asset-key.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-key.js","names":[],"sources":["../../src/internal/asset-key.ts"],"sourcesContent":["import { createHash } from \"node:crypto\";\n\n/** Accepted asset key input: a plain string or an array of string segments. */\nexport type AssetKeyInput = string | readonly string[];\n\n/**\n * Hash an asset key input to a fixed 16-char hex string for storage identity.\n * String inputs are treated as a single segment. Array inputs are joined with\n * null-byte separators to prevent ambiguity between segment boundaries.\n */\nexport function hashKey(input: AssetKeyInput): string {\n  const normalized = typeof input === \"string\" ? input : input.join(\"\\0\");\n  return createHash(\"sha256\").update(normalized).digest(\"hex\").slice(0, 16);\n}\n\n/** Produce a human-readable display key for debugging and UI. */\nexport function displayKey(input: AssetKeyInput): string {\n  return typeof input === \"string\" ? input : input.join(\"/\");\n}\n\n/**\n * Validate that an asset key input is non-empty.\n * Returns `true` if the input is a non-empty string or a non-empty array of non-empty strings.\n */\nexport function isValidKeyInput(input: AssetKeyInput): boolean {\n  if (typeof input === \"string\") return input.length > 0;\n  return input.length > 0 && input.every((s) => s.length > 0);\n}\n"],"mappings":";;;;;;;AAUA,SAAgB,QAAQ,OAA8B;CACpD,MAAM,aAAa,OAAO,UAAU,WAAW,QAAQ,MAAM,KAAK,KAAK;CACvE,OAAO,WAAW,SAAS,CAAC,OAAO,WAAW,CAAC,OAAO,MAAM,CAAC,MAAM,GAAG,GAAG;;;AAI3E,SAAgB,WAAW,OAA8B;CACvD,OAAO,OAAO,UAAU,WAAW,QAAQ,MAAM,KAAK,IAAI;;;;;;AAO5D,SAAgB,gBAAgB,OAA+B;CAC7D,IAAI,OAAO,UAAU,UAAU,OAAO,MAAM,SAAS;CACrD,OAAO,MAAM,SAAS,KAAK,MAAM,OAAO,MAAM,EAAE,SAAS,EAAE"}

package/dist/internal/log-format.cjs

@@ -0,0 +1,98 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/internal/log-format.ts
+const RESERVED_ENTRY_KEYS = new Set([
+	"timestamp",
+	"level",
+	"event",
+	"service",
+	"component"
+]);
+function str(v) {
+	if (v === void 0 || v === null) return "unknown";
+	if (typeof v === "string") return v;
+	if (typeof v === "number" || typeof v === "boolean") return String(v);
+	return JSON.stringify(v);
+}
+function assetPath(e) {
+	return `${str(e.namespace)}/${str(e.item_id)}/${str(e.asset_id)}`;
+}
+function formatBytes(v) {
+	if (typeof v !== "number") return str(v);
+	if (v < 1024) return `${v} B`;
+	if (v < 1024 * 1024) return `${(v / 1024).toFixed(1)} KB`;
+	if (v < 1024 * 1024 * 1024) return `${(v / (1024 * 1024)).toFixed(1)} MB`;
+	return `${(v / (1024 * 1024 * 1024)).toFixed(1)} GB`;
+}
+const EVENT_MESSAGES = {
+	dev_passthrough_active: (e) => e.source === "option" ? "Dev passthrough enabled via config option" : `Dev passthrough enabled via NODE_ENV=${str(e.node_env)}`,
+	dev_passthrough_ignores_sync_failure_mode: (e) => `Dev passthrough ignores onSyncFailure "${str(e.configured_mode)}" — failures always throw in passthrough mode`,
+	dev_passthrough_clearing_state: (e) => `Clearing local state at ${str(e.storage_root)} (dev passthrough resets on startup)`,
+	cache_storage_location: (e) => `Storage location: ${str(e.storage_root)}`,
+	cache_initialized: (e) => {
+		const parts = [];
+		if (e.active_generation_id != null) parts.push(`generation #${str(e.active_generation_id)}`);
+		if (e.dev_passthrough_enabled === true) parts.push("dev passthrough on");
+		const suffix = parts.length > 0 ? ` (${parts.join(", ")})` : "";
+		return `Cache initialized at ${str(e.storage_root)}${suffix}`;
+	},
+	protocol_registered: () => "media:// protocol handler registered",
+	protocol_registration_skipped: (e) => `Protocol registration skipped: ${str(e.reason)}`,
+	protocol_request_not_found: (e) => `media:// request not found: ${assetPath(e)}`,
+	protocol_request_file_missing: (e) => `media:// asset file missing on disk: ${assetPath(e)}`,
+	protocol_request_local_resolved: (e) => {
+		const range = e.range ? ` range ${str(e.range)}` : "";
+		return `media:// serving ${assetPath(e)}${range}`;
+	},
+	ipc_attached: () => "IPC handlers attached",
+	ipc_attach_skipped: (e) => `IPC attach skipped: ${str(e.reason)}`,
+	resolve_asset_base_url_fallback: (e) => `Could not rewrite asset URL for ${str(e.context_label)}: ${str(e.error)}`,
+	status_snapshot_invalid: (e) => `Stored status snapshot is invalid (${str(e.error_code)}: ${str(e.error_message)}), starting fresh`,
+	sync_reused: (e) => `Sync already in progress (phase: ${str(e.phase)}, generation #${str(e.active_generation_id)})`,
+	sync_started: (e) => `Sync started (run #${str(e.run_id)})`,
+	manifest_resolved: (e) => `Manifest resolved: ${str(e.namespace_count)} namespace(s), ${str(e.item_count)} item(s) → generation #${str(e.staged_generation_id)} (run #${str(e.run_id)})`,
+	manifest_expired: (e) => e.asset_id != null ? `Manifest expired at ${str(e.expires_at)} before downloading ${assetPath(e)} (run #${str(e.run_id)})` : `Manifest expired at ${str(e.expires_at)} before downloads began (run #${str(e.run_id)})`,
+	sync_diffed: (e) => `Diff complete: ${str(e.total_assets)} asset(s) total, ${str(e.download_count)} to download, ${str(e.skipped_assets)} already cached (run #${str(e.run_id)})`,
+	asset_download_started: (e) => `Downloading ${assetPath(e)} ${str(e.resolved_version)}`,
+	asset_download_completed: (e) => `Downloaded ${assetPath(e)} → ${str(e.relative_path)}`,
+	asset_download_range_restart: (e) => `Server does not support range resume for ${assetPath(e)} (HTTP ${str(e.response_status)}), restarting full download`,
+	asset_download_rejected: (e) => `Download rejected for ${assetPath(e)}: HTTP ${str(e.status)} ${str(e.status_text)}`,
+	asset_download_retry_scheduled: (e) => `Retrying ${assetPath(e)} in ${str(e.retry_delay_ms)}ms (attempt ${str(e.attempt)})`,
+	asset_download_retry_exhausted: (e) => `Giving up on ${assetPath(e)} after ${str(e.attempt)} attempt(s)`,
+	asset_download_storage_failed: (e) => `Disk write failed for ${assetPath(e)} from ${str(e.url)}`,
+	generation_committed: (e) => `Generation #${str(e.active_generation_id)} committed, replacing #${str(e.previous_generation_id)} (run #${str(e.run_id)})`,
+	sync_completed: (e) => `Sync complete: ${str(e.downloaded_assets)} downloaded, ${str(e.skipped_assets)} skipped, ${formatBytes(e.bytes_downloaded)} transferred (run #${str(e.run_id)})`,
+	sync_failed: (e) => `Sync failed: ${str(e.error_code)} — ${str(e.error_message)} (run #${str(e.run_id)})`,
+	storage_limit_exceeded: (e) => `Storage limit exceeded: ${formatBytes(e.current_bytes)} on disk + ${formatBytes(e.estimated_download_bytes)} needed exceeds ${formatBytes(e.max_cache_bytes)} limit`,
+	storage_reserve_violation: (e) => `Not enough free disk space: ${formatBytes(e.available_bytes)} available, need ${formatBytes(e.estimated_download_bytes)} with ${formatBytes(e.reserve_free_bytes)} reserved`,
+	assets_marked_for_deletion: (e) => `Marked ${str(e.marked_count)} asset(s) from generation #${str(e.previous_generation_id)} for deletion`,
+	deletion_prune_skipped: () => "No expired assets to prune",
+	assets_pruned: (e) => `Pruned ${str(e.pruned_count)} expired asset(s) from disk`
+};
+function formatEnglishLine(entry) {
+	const messageFn = EVENT_MESSAGES[entry.event];
+	if (messageFn) return `[${entry.component}] ${entry.level.toUpperCase()} ${messageFn(entry)}`;
+	return formatGenericEnglishLine(entry);
+}
+function formatGenericEnglishLine(entry) {
+	const label = entry.event.replace(/[._]+/g, " ").replace(/([a-z0-9])([A-Z])/g, "$1 $2").replace(/^./, (c) => c.toUpperCase());
+	const keys = Object.keys(entry).filter((k) => !RESERVED_ENTRY_KEYS.has(k));
+	keys.sort();
+	const details = keys.map((key) => {
+		const v = entry[key];
+		if (v === void 0) return null;
+		return `${key.replace(/[._]+/g, " ").replace(/([a-z0-9])([A-Z])/g, "$1 $2").toLowerCase()}: ${str(v)}`;
+	}).filter((s) => s != null);
+	const suffix = details.length > 0 ? ` (${details.join(", ")})` : "";
+	return `[${entry.component}] ${entry.level.toUpperCase()} ${label}${suffix}`;
+}
+/**
+* Single line for the default development console sink.
+*/
+function formatMediaCacheConsoleLine(entry, format) {
+	if (format === "json") return `[${entry.component}] ${entry.level} ${entry.event} ${JSON.stringify(entry)}`;
+	return formatEnglishLine(entry);
+}
+//#endregion
+exports.formatMediaCacheConsoleLine = formatMediaCacheConsoleLine;
+
+//# sourceMappingURL=log-format.cjs.map

package/dist/internal/log-format.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-format.cjs","names":[],"sources":["../../src/internal/log-format.ts"],"sourcesContent":["import type { JsonValue, MediaCacheLogEvent, MediaCacheLogFormat } from \"../shared/types.js\";\n\nconst RESERVED_ENTRY_KEYS = new Set([\"timestamp\", \"level\", \"event\", \"service\", \"component\"]);\n\nfunction str(v: JsonValue | undefined): string {\n  if (v === undefined || v === null) return \"unknown\";\n  if (typeof v === \"string\") return v;\n  if (typeof v === \"number\" || typeof v === \"boolean\") return String(v);\n  return JSON.stringify(v);\n}\n\nfunction assetPath(e: MediaCacheLogEvent): string {\n  return `${str(e.namespace)}/${str(e.item_id)}/${str(e.asset_id)}`;\n}\n\nfunction formatBytes(v: JsonValue | undefined): string {\n  if (typeof v !== \"number\") return str(v);\n  if (v < 1024) return `${v} B`;\n  if (v < 1024 * 1024) return `${(v / 1024).toFixed(1)} KB`;\n  if (v < 1024 * 1024 * 1024) return `${(v / (1024 * 1024)).toFixed(1)} MB`;\n  return `${(v / (1024 * 1024 * 1024)).toFixed(1)} GB`;\n}\n\ntype MessageFn = (e: MediaCacheLogEvent) => string;\n\nconst EVENT_MESSAGES: Record<string, MessageFn> = {\n  dev_passthrough_active: (e) =>\n    e.source === \"option\"\n      ? \"Dev passthrough enabled via config option\"\n      : `Dev passthrough enabled via NODE_ENV=${str(e.node_env)}`,\n\n  dev_passthrough_ignores_sync_failure_mode: (e) =>\n    `Dev passthrough ignores onSyncFailure \"${str(e.configured_mode)}\" — failures always throw in passthrough mode`,\n\n  dev_passthrough_clearing_state: (e) =>\n    `Clearing local state at ${str(e.storage_root)} (dev passthrough resets on startup)`,\n\n  cache_storage_location: (e) => `Storage location: ${str(e.storage_root)}`,\n\n  cache_initialized: (e) => {\n    const parts: string[] = [];\n    if (e.active_generation_id != null) {\n      parts.push(`generation #${str(e.active_generation_id)}`);\n    }\n    if (e.dev_passthrough_enabled === true) {\n      parts.push(\"dev passthrough on\");\n    }\n    const suffix = parts.length > 0 ? ` (${parts.join(\", \")})` : \"\";\n    return `Cache initialized at ${str(e.storage_root)}${suffix}`;\n  },\n\n  protocol_registered: () => \"media:// protocol handler registered\",\n\n  protocol_registration_skipped: (e) => `Protocol registration skipped: ${str(e.reason)}`,\n\n  protocol_request_not_found: (e) => `media:// request not found: ${assetPath(e)}`,\n\n  protocol_request_file_missing: (e) => `media:// asset file missing on disk: ${assetPath(e)}`,\n\n  protocol_request_local_resolved: (e) => {\n    const range = e.range ? ` range ${str(e.range)}` : \"\";\n    return `media:// serving ${assetPath(e)}${range}`;\n  },\n\n  ipc_attached: () => \"IPC handlers attached\",\n  ipc_attach_skipped: (e) => `IPC attach skipped: ${str(e.reason)}`,\n\n  resolve_asset_base_url_fallback: (e) =>\n    `Could not rewrite asset URL for ${str(e.context_label)}: ${str(e.error)}`,\n\n  status_snapshot_invalid: (e) =>\n    `Stored status snapshot is invalid (${str(e.error_code)}: ${str(e.error_message)}), starting fresh`,\n\n  sync_reused: (e) =>\n    `Sync already in progress (phase: ${str(e.phase)}, generation #${str(e.active_generation_id)})`,\n\n  sync_started: (e) => `Sync started (run #${str(e.run_id)})`,\n\n  manifest_resolved: (e) =>\n    `Manifest resolved: ${str(e.namespace_count)} namespace(s), ${str(e.item_count)} item(s) → generation #${str(e.staged_generation_id)} (run #${str(e.run_id)})`,\n\n  manifest_expired: (e) =>\n    e.asset_id != null\n      ? `Manifest expired at ${str(e.expires_at)} before downloading ${assetPath(e)} (run #${str(e.run_id)})`\n      : `Manifest expired at ${str(e.expires_at)} before downloads began (run #${str(e.run_id)})`,\n\n  sync_diffed: (e) =>\n    `Diff complete: ${str(e.total_assets)} asset(s) total, ${str(e.download_count)} to download, ${str(e.skipped_assets)} already cached (run #${str(e.run_id)})`,\n\n  asset_download_started: (e) => `Downloading ${assetPath(e)} ${str(e.resolved_version)}`,\n\n  asset_download_completed: (e) => `Downloaded ${assetPath(e)} → ${str(e.relative_path)}`,\n\n  asset_download_range_restart: (e) =>\n    `Server does not support range resume for ${assetPath(e)} (HTTP ${str(e.response_status)}), restarting full download`,\n\n  asset_download_rejected: (e) =>\n    `Download rejected for ${assetPath(e)}: HTTP ${str(e.status)} ${str(e.status_text)}`,\n\n  asset_download_retry_scheduled: (e) =>\n    `Retrying ${assetPath(e)} in ${str(e.retry_delay_ms)}ms (attempt ${str(e.attempt)})`,\n\n  asset_download_retry_exhausted: (e) =>\n    `Giving up on ${assetPath(e)} after ${str(e.attempt)} attempt(s)`,\n\n  asset_download_storage_failed: (e) => `Disk write failed for ${assetPath(e)} from ${str(e.url)}`,\n\n  generation_committed: (e) =>\n    `Generation #${str(e.active_generation_id)} committed, replacing #${str(e.previous_generation_id)} (run #${str(e.run_id)})`,\n\n  sync_completed: (e) =>\n    `Sync complete: ${str(e.downloaded_assets)} downloaded, ${str(e.skipped_assets)} skipped, ${formatBytes(e.bytes_downloaded)} transferred (run #${str(e.run_id)})`,\n\n  sync_failed: (e) =>\n    `Sync failed: ${str(e.error_code)} — ${str(e.error_message)} (run #${str(e.run_id)})`,\n\n  storage_limit_exceeded: (e) =>\n    `Storage limit exceeded: ${formatBytes(e.current_bytes)} on disk + ${formatBytes(e.estimated_download_bytes)} needed exceeds ${formatBytes(e.max_cache_bytes)} limit`,\n\n  storage_reserve_violation: (e) =>\n    `Not enough free disk space: ${formatBytes(e.available_bytes)} available, need ${formatBytes(e.estimated_download_bytes)} with ${formatBytes(e.reserve_free_bytes)} reserved`,\n\n  assets_marked_for_deletion: (e) =>\n    `Marked ${str(e.marked_count)} asset(s) from generation #${str(e.previous_generation_id)} for deletion`,\n\n  deletion_prune_skipped: () => \"No expired assets to prune\",\n\n  assets_pruned: (e) => `Pruned ${str(e.pruned_count)} expired asset(s) from disk`,\n};\n\nfunction formatEnglishLine(entry: MediaCacheLogEvent): string {\n  const messageFn = EVENT_MESSAGES[entry.event];\n  if (messageFn) {\n    return `[${entry.component}] ${entry.level.toUpperCase()} ${messageFn(entry)}`;\n  }\n  return formatGenericEnglishLine(entry);\n}\n\nfunction formatGenericEnglishLine(entry: MediaCacheLogEvent): string {\n  const label = entry.event\n    .replace(/[._]+/g, \" \")\n    .replace(/([a-z0-9])([A-Z])/g, \"$1 $2\")\n    .replace(/^./, (c) => c.toUpperCase());\n  const keys = Object.keys(entry).filter((k) => !RESERVED_ENTRY_KEYS.has(k));\n  keys.sort();\n  const details = keys\n    .map((key) => {\n      const v = entry[key];\n      if (v === undefined) return null;\n      const humanKey = key\n        .replace(/[._]+/g, \" \")\n        .replace(/([a-z0-9])([A-Z])/g, \"$1 $2\")\n        .toLowerCase();\n      return `${humanKey}: ${str(v)}`;\n    })\n    .filter((s): s is string => s != null);\n  const suffix = details.length > 0 ? ` (${details.join(\", \")})` : \"\";\n  return `[${entry.component}] ${entry.level.toUpperCase()} ${label}${suffix}`;\n}\n\n/**\n * Single line for the default development console sink.\n */\nexport function formatMediaCacheConsoleLine(\n  entry: MediaCacheLogEvent,\n  format: MediaCacheLogFormat,\n): string {\n  if (format === \"json\") {\n    return `[${entry.component}] ${entry.level} ${entry.event} ${JSON.stringify(entry)}`;\n  }\n  return formatEnglishLine(entry);\n}\n"],"mappings":"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"}

package/dist/internal/log-format.d.cts

@@ -0,0 +1,10 @@
+import { MediaCacheLogEvent, MediaCacheLogFormat } from "../shared/types.cjs";
+
+//#region src/internal/log-format.d.ts
+/**
+ * Single line for the default development console sink.
+ */
+declare function formatMediaCacheConsoleLine(entry: MediaCacheLogEvent, format: MediaCacheLogFormat): string;
+//#endregion
+export { formatMediaCacheConsoleLine };
+//# sourceMappingURL=log-format.d.cts.map

package/dist/internal/log-format.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-format.d.cts","names":[],"sources":["../../src/internal/log-format.ts"],"mappings":";;;;;AAmKA;iBAAgB,2BAAA,CACd,KAAA,EAAO,kBAAA,EACP,MAAA,EAAQ,mBAAA"}

package/dist/internal/log-format.d.ts

@@ -0,0 +1,10 @@
+import { MediaCacheLogEvent, MediaCacheLogFormat } from "../shared/types.js";
+
+//#region src/internal/log-format.d.ts
+/**
+ * Single line for the default development console sink.
+ */
+declare function formatMediaCacheConsoleLine(entry: MediaCacheLogEvent, format: MediaCacheLogFormat): string;
+//#endregion
+export { formatMediaCacheConsoleLine };
+//# sourceMappingURL=log-format.d.ts.map

package/dist/internal/log-format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-format.d.ts","names":[],"sources":["../../src/internal/log-format.ts"],"mappings":";;;;;AAmKA;iBAAgB,2BAAA,CACd,KAAA,EAAO,kBAAA,EACP,MAAA,EAAQ,mBAAA"}

package/dist/internal/log-format.js

@@ -0,0 +1,97 @@
+//#region src/internal/log-format.ts
+const RESERVED_ENTRY_KEYS = new Set([
+	"timestamp",
+	"level",
+	"event",
+	"service",
+	"component"
+]);
+function str(v) {
+	if (v === void 0 || v === null) return "unknown";
+	if (typeof v === "string") return v;
+	if (typeof v === "number" || typeof v === "boolean") return String(v);
+	return JSON.stringify(v);
+}
+function assetPath(e) {
+	return `${str(e.namespace)}/${str(e.item_id)}/${str(e.asset_id)}`;
+}
+function formatBytes(v) {
+	if (typeof v !== "number") return str(v);
+	if (v < 1024) return `${v} B`;
+	if (v < 1024 * 1024) return `${(v / 1024).toFixed(1)} KB`;
+	if (v < 1024 * 1024 * 1024) return `${(v / (1024 * 1024)).toFixed(1)} MB`;
+	return `${(v / (1024 * 1024 * 1024)).toFixed(1)} GB`;
+}
+const EVENT_MESSAGES = {
+	dev_passthrough_active: (e) => e.source === "option" ? "Dev passthrough enabled via config option" : `Dev passthrough enabled via NODE_ENV=${str(e.node_env)}`,
+	dev_passthrough_ignores_sync_failure_mode: (e) => `Dev passthrough ignores onSyncFailure "${str(e.configured_mode)}" — failures always throw in passthrough mode`,
+	dev_passthrough_clearing_state: (e) => `Clearing local state at ${str(e.storage_root)} (dev passthrough resets on startup)`,
+	cache_storage_location: (e) => `Storage location: ${str(e.storage_root)}`,
+	cache_initialized: (e) => {
+		const parts = [];
+		if (e.active_generation_id != null) parts.push(`generation #${str(e.active_generation_id)}`);
+		if (e.dev_passthrough_enabled === true) parts.push("dev passthrough on");
+		const suffix = parts.length > 0 ? ` (${parts.join(", ")})` : "";
+		return `Cache initialized at ${str(e.storage_root)}${suffix}`;
+	},
+	protocol_registered: () => "media:// protocol handler registered",
+	protocol_registration_skipped: (e) => `Protocol registration skipped: ${str(e.reason)}`,
+	protocol_request_not_found: (e) => `media:// request not found: ${assetPath(e)}`,
+	protocol_request_file_missing: (e) => `media:// asset file missing on disk: ${assetPath(e)}`,
+	protocol_request_local_resolved: (e) => {
+		const range = e.range ? ` range ${str(e.range)}` : "";
+		return `media:// serving ${assetPath(e)}${range}`;
+	},
+	ipc_attached: () => "IPC handlers attached",
+	ipc_attach_skipped: (e) => `IPC attach skipped: ${str(e.reason)}`,
+	resolve_asset_base_url_fallback: (e) => `Could not rewrite asset URL for ${str(e.context_label)}: ${str(e.error)}`,
+	status_snapshot_invalid: (e) => `Stored status snapshot is invalid (${str(e.error_code)}: ${str(e.error_message)}), starting fresh`,
+	sync_reused: (e) => `Sync already in progress (phase: ${str(e.phase)}, generation #${str(e.active_generation_id)})`,
+	sync_started: (e) => `Sync started (run #${str(e.run_id)})`,
+	manifest_resolved: (e) => `Manifest resolved: ${str(e.namespace_count)} namespace(s), ${str(e.item_count)} item(s) → generation #${str(e.staged_generation_id)} (run #${str(e.run_id)})`,
+	manifest_expired: (e) => e.asset_id != null ? `Manifest expired at ${str(e.expires_at)} before downloading ${assetPath(e)} (run #${str(e.run_id)})` : `Manifest expired at ${str(e.expires_at)} before downloads began (run #${str(e.run_id)})`,
+	sync_diffed: (e) => `Diff complete: ${str(e.total_assets)} asset(s) total, ${str(e.download_count)} to download, ${str(e.skipped_assets)} already cached (run #${str(e.run_id)})`,
+	asset_download_started: (e) => `Downloading ${assetPath(e)} ${str(e.resolved_version)}`,
+	asset_download_completed: (e) => `Downloaded ${assetPath(e)} → ${str(e.relative_path)}`,
+	asset_download_range_restart: (e) => `Server does not support range resume for ${assetPath(e)} (HTTP ${str(e.response_status)}), restarting full download`,
+	asset_download_rejected: (e) => `Download rejected for ${assetPath(e)}: HTTP ${str(e.status)} ${str(e.status_text)}`,
+	asset_download_retry_scheduled: (e) => `Retrying ${assetPath(e)} in ${str(e.retry_delay_ms)}ms (attempt ${str(e.attempt)})`,
+	asset_download_retry_exhausted: (e) => `Giving up on ${assetPath(e)} after ${str(e.attempt)} attempt(s)`,
+	asset_download_storage_failed: (e) => `Disk write failed for ${assetPath(e)} from ${str(e.url)}`,
+	generation_committed: (e) => `Generation #${str(e.active_generation_id)} committed, replacing #${str(e.previous_generation_id)} (run #${str(e.run_id)})`,
+	sync_completed: (e) => `Sync complete: ${str(e.downloaded_assets)} downloaded, ${str(e.skipped_assets)} skipped, ${formatBytes(e.bytes_downloaded)} transferred (run #${str(e.run_id)})`,
+	sync_failed: (e) => `Sync failed: ${str(e.error_code)} — ${str(e.error_message)} (run #${str(e.run_id)})`,
+	storage_limit_exceeded: (e) => `Storage limit exceeded: ${formatBytes(e.current_bytes)} on disk + ${formatBytes(e.estimated_download_bytes)} needed exceeds ${formatBytes(e.max_cache_bytes)} limit`,
+	storage_reserve_violation: (e) => `Not enough free disk space: ${formatBytes(e.available_bytes)} available, need ${formatBytes(e.estimated_download_bytes)} with ${formatBytes(e.reserve_free_bytes)} reserved`,
+	assets_marked_for_deletion: (e) => `Marked ${str(e.marked_count)} asset(s) from generation #${str(e.previous_generation_id)} for deletion`,
+	deletion_prune_skipped: () => "No expired assets to prune",
+	assets_pruned: (e) => `Pruned ${str(e.pruned_count)} expired asset(s) from disk`
+};
+function formatEnglishLine(entry) {
+	const messageFn = EVENT_MESSAGES[entry.event];
+	if (messageFn) return `[${entry.component}] ${entry.level.toUpperCase()} ${messageFn(entry)}`;
+	return formatGenericEnglishLine(entry);
+}
+function formatGenericEnglishLine(entry) {
+	const label = entry.event.replace(/[._]+/g, " ").replace(/([a-z0-9])([A-Z])/g, "$1 $2").replace(/^./, (c) => c.toUpperCase());
+	const keys = Object.keys(entry).filter((k) => !RESERVED_ENTRY_KEYS.has(k));
+	keys.sort();
+	const details = keys.map((key) => {
+		const v = entry[key];
+		if (v === void 0) return null;
+		return `${key.replace(/[._]+/g, " ").replace(/([a-z0-9])([A-Z])/g, "$1 $2").toLowerCase()}: ${str(v)}`;
+	}).filter((s) => s != null);
+	const suffix = details.length > 0 ? ` (${details.join(", ")})` : "";
+	return `[${entry.component}] ${entry.level.toUpperCase()} ${label}${suffix}`;
+}
+/**
+* Single line for the default development console sink.
+*/
+function formatMediaCacheConsoleLine(entry, format) {
+	if (format === "json") return `[${entry.component}] ${entry.level} ${entry.event} ${JSON.stringify(entry)}`;
+	return formatEnglishLine(entry);
+}
+//#endregion
+export { formatMediaCacheConsoleLine };
+
+//# sourceMappingURL=log-format.js.map

package/dist/internal/log-format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-format.js","names":[],"sources":["../../src/internal/log-format.ts"],"sourcesContent":["import type { JsonValue, MediaCacheLogEvent, MediaCacheLogFormat } from \"../shared/types.js\";\n\nconst RESERVED_ENTRY_KEYS = new Set([\"timestamp\", \"level\", \"event\", \"service\", \"component\"]);\n\nfunction str(v: JsonValue | undefined): string {\n  if (v === undefined || v === null) return \"unknown\";\n  if (typeof v === \"string\") return v;\n  if (typeof v === \"number\" || typeof v === \"boolean\") return String(v);\n  return JSON.stringify(v);\n}\n\nfunction assetPath(e: MediaCacheLogEvent): string {\n  return `${str(e.namespace)}/${str(e.item_id)}/${str(e.asset_id)}`;\n}\n\nfunction formatBytes(v: JsonValue | undefined): string {\n  if (typeof v !== \"number\") return str(v);\n  if (v < 1024) return `${v} B`;\n  if (v < 1024 * 1024) return `${(v / 1024).toFixed(1)} KB`;\n  if (v < 1024 * 1024 * 1024) return `${(v / (1024 * 1024)).toFixed(1)} MB`;\n  return `${(v / (1024 * 1024 * 1024)).toFixed(1)} GB`;\n}\n\ntype MessageFn = (e: MediaCacheLogEvent) => string;\n\nconst EVENT_MESSAGES: Record<string, MessageFn> = {\n  dev_passthrough_active: (e) =>\n    e.source === \"option\"\n      ? \"Dev passthrough enabled via config option\"\n      : `Dev passthrough enabled via NODE_ENV=${str(e.node_env)}`,\n\n  dev_passthrough_ignores_sync_failure_mode: (e) =>\n    `Dev passthrough ignores onSyncFailure \"${str(e.configured_mode)}\" — failures always throw in passthrough mode`,\n\n  dev_passthrough_clearing_state: (e) =>\n    `Clearing local state at ${str(e.storage_root)} (dev passthrough resets on startup)`,\n\n  cache_storage_location: (e) => `Storage location: ${str(e.storage_root)}`,\n\n  cache_initialized: (e) => {\n    const parts: string[] = [];\n    if (e.active_generation_id != null) {\n      parts.push(`generation #${str(e.active_generation_id)}`);\n    }\n    if (e.dev_passthrough_enabled === true) {\n      parts.push(\"dev passthrough on\");\n    }\n    const suffix = parts.length > 0 ? ` (${parts.join(\", \")})` : \"\";\n    return `Cache initialized at ${str(e.storage_root)}${suffix}`;\n  },\n\n  protocol_registered: () => \"media:// protocol handler registered\",\n\n  protocol_registration_skipped: (e) => `Protocol registration skipped: ${str(e.reason)}`,\n\n  protocol_request_not_found: (e) => `media:// request not found: ${assetPath(e)}`,\n\n  protocol_request_file_missing: (e) => `media:// asset file missing on disk: ${assetPath(e)}`,\n\n  protocol_request_local_resolved: (e) => {\n    const range = e.range ? ` range ${str(e.range)}` : \"\";\n    return `media:// serving ${assetPath(e)}${range}`;\n  },\n\n  ipc_attached: () => \"IPC handlers attached\",\n  ipc_attach_skipped: (e) => `IPC attach skipped: ${str(e.reason)}`,\n\n  resolve_asset_base_url_fallback: (e) =>\n    `Could not rewrite asset URL for ${str(e.context_label)}: ${str(e.error)}`,\n\n  status_snapshot_invalid: (e) =>\n    `Stored status snapshot is invalid (${str(e.error_code)}: ${str(e.error_message)}), starting fresh`,\n\n  sync_reused: (e) =>\n    `Sync already in progress (phase: ${str(e.phase)}, generation #${str(e.active_generation_id)})`,\n\n  sync_started: (e) => `Sync started (run #${str(e.run_id)})`,\n\n  manifest_resolved: (e) =>\n    `Manifest resolved: ${str(e.namespace_count)} namespace(s), ${str(e.item_count)} item(s) → generation #${str(e.staged_generation_id)} (run #${str(e.run_id)})`,\n\n  manifest_expired: (e) =>\n    e.asset_id != null\n      ? `Manifest expired at ${str(e.expires_at)} before downloading ${assetPath(e)} (run #${str(e.run_id)})`\n      : `Manifest expired at ${str(e.expires_at)} before downloads began (run #${str(e.run_id)})`,\n\n  sync_diffed: (e) =>\n    `Diff complete: ${str(e.total_assets)} asset(s) total, ${str(e.download_count)} to download, ${str(e.skipped_assets)} already cached (run #${str(e.run_id)})`,\n\n  asset_download_started: (e) => `Downloading ${assetPath(e)} ${str(e.resolved_version)}`,\n\n  asset_download_completed: (e) => `Downloaded ${assetPath(e)} → ${str(e.relative_path)}`,\n\n  asset_download_range_restart: (e) =>\n    `Server does not support range resume for ${assetPath(e)} (HTTP ${str(e.response_status)}), restarting full download`,\n\n  asset_download_rejected: (e) =>\n    `Download rejected for ${assetPath(e)}: HTTP ${str(e.status)} ${str(e.status_text)}`,\n\n  asset_download_retry_scheduled: (e) =>\n    `Retrying ${assetPath(e)} in ${str(e.retry_delay_ms)}ms (attempt ${str(e.attempt)})`,\n\n  asset_download_retry_exhausted: (e) =>\n    `Giving up on ${assetPath(e)} after ${str(e.attempt)} attempt(s)`,\n\n  asset_download_storage_failed: (e) => `Disk write failed for ${assetPath(e)} from ${str(e.url)}`,\n\n  generation_committed: (e) =>\n    `Generation #${str(e.active_generation_id)} committed, replacing #${str(e.previous_generation_id)} (run #${str(e.run_id)})`,\n\n  sync_completed: (e) =>\n    `Sync complete: ${str(e.downloaded_assets)} downloaded, ${str(e.skipped_assets)} skipped, ${formatBytes(e.bytes_downloaded)} transferred (run #${str(e.run_id)})`,\n\n  sync_failed: (e) =>\n    `Sync failed: ${str(e.error_code)} — ${str(e.error_message)} (run #${str(e.run_id)})`,\n\n  storage_limit_exceeded: (e) =>\n    `Storage limit exceeded: ${formatBytes(e.current_bytes)} on disk + ${formatBytes(e.estimated_download_bytes)} needed exceeds ${formatBytes(e.max_cache_bytes)} limit`,\n\n  storage_reserve_violation: (e) =>\n    `Not enough free disk space: ${formatBytes(e.available_bytes)} available, need ${formatBytes(e.estimated_download_bytes)} with ${formatBytes(e.reserve_free_bytes)} reserved`,\n\n  assets_marked_for_deletion: (e) =>\n    `Marked ${str(e.marked_count)} asset(s) from generation #${str(e.previous_generation_id)} for deletion`,\n\n  deletion_prune_skipped: () => \"No expired assets to prune\",\n\n  assets_pruned: (e) => `Pruned ${str(e.pruned_count)} expired asset(s) from disk`,\n};\n\nfunction formatEnglishLine(entry: MediaCacheLogEvent): string {\n  const messageFn = EVENT_MESSAGES[entry.event];\n  if (messageFn) {\n    return `[${entry.component}] ${entry.level.toUpperCase()} ${messageFn(entry)}`;\n  }\n  return formatGenericEnglishLine(entry);\n}\n\nfunction formatGenericEnglishLine(entry: MediaCacheLogEvent): string {\n  const label = entry.event\n    .replace(/[._]+/g, \" \")\n    .replace(/([a-z0-9])([A-Z])/g, \"$1 $2\")\n    .replace(/^./, (c) => c.toUpperCase());\n  const keys = Object.keys(entry).filter((k) => !RESERVED_ENTRY_KEYS.has(k));\n  keys.sort();\n  const details = keys\n    .map((key) => {\n      const v = entry[key];\n      if (v === undefined) return null;\n      const humanKey = key\n        .replace(/[._]+/g, \" \")\n        .replace(/([a-z0-9])([A-Z])/g, \"$1 $2\")\n        .toLowerCase();\n      return `${humanKey}: ${str(v)}`;\n    })\n    .filter((s): s is string => s != null);\n  const suffix = details.length > 0 ? ` (${details.join(\", \")})` : \"\";\n  return `[${entry.component}] ${entry.level.toUpperCase()} ${label}${suffix}`;\n}\n\n/**\n * Single line for the default development console sink.\n */\nexport function formatMediaCacheConsoleLine(\n  entry: MediaCacheLogEvent,\n  format: MediaCacheLogFormat,\n): string {\n  if (format === \"json\") {\n    return `[${entry.component}] ${entry.level} ${entry.event} ${JSON.stringify(entry)}`;\n  }\n  return formatEnglishLine(entry);\n}\n"],"mappings":"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"}

package/dist/internal/media-kind.cjs

@@ -0,0 +1,46 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/internal/media-kind.ts
+const documentMimeTypes = new Set([
+	"application/pdf",
+	"application/msword",
+	"application/vnd.openxmlformats-officedocument.wordprocessingml.document",
+	"application/vnd.ms-excel",
+	"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+	"application/vnd.ms-powerpoint",
+	"application/vnd.openxmlformats-officedocument.presentationml.presentation",
+	"application/rtf",
+	"application/epub+zip"
+]);
+/**
+* Derives a coarse {@link MediaKind} from a MIME type string.
+*
+* Mapping rules (first match wins):
+* - `video/*` → `"video"`
+* - `image/*` → `"image"`
+* - `audio/*` → `"audio"`
+* - `text/html` → `"html"`
+* - `text/*` → `"text"`
+* - Known document MIME types (PDF, Office, EPUB) → `"document"`
+* - `application/json` → `"text"`
+* - Everything else → `"binary"`
+*/
+function mediaKindFromMime(mime) {
+	const normalized = mime.trim().toLowerCase().split(";")[0].trim();
+	const slash = normalized.indexOf("/");
+	if (slash === -1) return "binary";
+	switch (normalized.slice(0, slash)) {
+		case "video": return "video";
+		case "image": return "image";
+		case "audio": return "audio";
+		case "text": return normalized === "text/html" ? "html" : "text";
+		case "application":
+			if (documentMimeTypes.has(normalized)) return "document";
+			if (normalized === "application/json") return "text";
+			return "binary";
+		default: return "binary";
+	}
+}
+//#endregion
+exports.mediaKindFromMime = mediaKindFromMime;
+
+//# sourceMappingURL=media-kind.cjs.map

package/dist/internal/media-kind.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-kind.cjs","names":[],"sources":["../../src/internal/media-kind.ts"],"sourcesContent":["import type { MediaKind } from \"../shared/types.js\";\n\nconst documentMimeTypes = new Set([\n  \"application/pdf\",\n  \"application/msword\",\n  \"application/vnd.openxmlformats-officedocument.wordprocessingml.document\",\n  \"application/vnd.ms-excel\",\n  \"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet\",\n  \"application/vnd.ms-powerpoint\",\n  \"application/vnd.openxmlformats-officedocument.presentationml.presentation\",\n  \"application/rtf\",\n  \"application/epub+zip\",\n]);\n\n/**\n * Derives a coarse {@link MediaKind} from a MIME type string.\n *\n * Mapping rules (first match wins):\n * - `video/*` → `\"video\"`\n * - `image/*` → `\"image\"`\n * - `audio/*` → `\"audio\"`\n * - `text/html` → `\"html\"`\n * - `text/*` → `\"text\"`\n * - Known document MIME types (PDF, Office, EPUB) → `\"document\"`\n * - `application/json` → `\"text\"`\n * - Everything else → `\"binary\"`\n */\nexport function mediaKindFromMime(mime: string): MediaKind {\n  const normalized = mime.trim().toLowerCase().split(\";\")[0]!.trim();\n  const slash = normalized.indexOf(\"/\");\n  if (slash === -1) {\n    return \"binary\";\n  }\n\n  const type = normalized.slice(0, slash);\n\n  switch (type) {\n    case \"video\":\n      return \"video\";\n    case \"image\":\n      return \"image\";\n    case \"audio\":\n      return \"audio\";\n    case \"text\":\n      return normalized === \"text/html\" ? \"html\" : \"text\";\n    case \"application\":\n      if (documentMimeTypes.has(normalized)) {\n        return \"document\";\n      }\n      if (normalized === \"application/json\") {\n        return \"text\";\n      }\n      return \"binary\";\n    default:\n      return \"binary\";\n  }\n}\n"],"mappings":";;AAEA,MAAM,oBAAoB,IAAI,IAAI;CAChC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD,CAAC;;;;;;;;;;;;;;AAeF,SAAgB,kBAAkB,MAAyB;CACzD,MAAM,aAAa,KAAK,MAAM,CAAC,aAAa,CAAC,MAAM,IAAI,CAAC,GAAI,MAAM;CAClE,MAAM,QAAQ,WAAW,QAAQ,IAAI;CACrC,IAAI,UAAU,IACZ,OAAO;CAKT,QAFa,WAAW,MAAM,GAAG,MAErB,EAAZ;EACE,KAAK,SACH,OAAO;EACT,KAAK,SACH,OAAO;EACT,KAAK,SACH,OAAO;EACT,KAAK,QACH,OAAO,eAAe,cAAc,SAAS;EAC/C,KAAK;GACH,IAAI,kBAAkB,IAAI,WAAW,EACnC,OAAO;GAET,IAAI,eAAe,oBACjB,OAAO;GAET,OAAO;EACT,SACE,OAAO"}

package/dist/internal/media-kind.d.cts

@@ -0,0 +1,20 @@
+import { MediaKind } from "../shared/types.cjs";
+
+//#region src/internal/media-kind.d.ts
+/**
+ * Derives a coarse {@link MediaKind} from a MIME type string.
+ *
+ * Mapping rules (first match wins):
+ * - `video/*` → `"video"`
+ * - `image/*` → `"image"`
+ * - `audio/*` → `"audio"`
+ * - `text/html` → `"html"`
+ * - `text/*` → `"text"`
+ * - Known document MIME types (PDF, Office, EPUB) → `"document"`
+ * - `application/json` → `"text"`
+ * - Everything else → `"binary"`
+ */
+declare function mediaKindFromMime(mime: string): MediaKind;
+//#endregion
+export { mediaKindFromMime };
+//# sourceMappingURL=media-kind.d.cts.map

package/dist/internal/media-kind.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-kind.d.cts","names":[],"sources":["../../src/internal/media-kind.ts"],"mappings":";;;;;AA2BA;;;;;;;;;;;iBAAgB,iBAAA,CAAkB,IAAA,WAAe,SAAA"}

package/dist/internal/media-kind.d.ts

@@ -0,0 +1,20 @@
+import { MediaKind } from "../shared/types.js";
+
+//#region src/internal/media-kind.d.ts
+/**
+ * Derives a coarse {@link MediaKind} from a MIME type string.
+ *
+ * Mapping rules (first match wins):
+ * - `video/*` → `"video"`
+ * - `image/*` → `"image"`
+ * - `audio/*` → `"audio"`
+ * - `text/html` → `"html"`
+ * - `text/*` → `"text"`
+ * - Known document MIME types (PDF, Office, EPUB) → `"document"`
+ * - `application/json` → `"text"`
+ * - Everything else → `"binary"`
+ */
+declare function mediaKindFromMime(mime: string): MediaKind;
+//#endregion
+export { mediaKindFromMime };
+//# sourceMappingURL=media-kind.d.ts.map

package/dist/internal/media-kind.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-kind.d.ts","names":[],"sources":["../../src/internal/media-kind.ts"],"mappings":";;;;;AA2BA;;;;;;;;;;;iBAAgB,iBAAA,CAAkB,IAAA,WAAe,SAAA"}

package/dist/internal/media-kind.js

@@ -0,0 +1,45 @@
+//#region src/internal/media-kind.ts
+const documentMimeTypes = new Set([
+	"application/pdf",
+	"application/msword",
+	"application/vnd.openxmlformats-officedocument.wordprocessingml.document",
+	"application/vnd.ms-excel",
+	"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+	"application/vnd.ms-powerpoint",
+	"application/vnd.openxmlformats-officedocument.presentationml.presentation",
+	"application/rtf",
+	"application/epub+zip"
+]);
+/**
+* Derives a coarse {@link MediaKind} from a MIME type string.
+*
+* Mapping rules (first match wins):
+* - `video/*` → `"video"`
+* - `image/*` → `"image"`
+* - `audio/*` → `"audio"`
+* - `text/html` → `"html"`
+* - `text/*` → `"text"`
+* - Known document MIME types (PDF, Office, EPUB) → `"document"`
+* - `application/json` → `"text"`
+* - Everything else → `"binary"`
+*/
+function mediaKindFromMime(mime) {
+	const normalized = mime.trim().toLowerCase().split(";")[0].trim();
+	const slash = normalized.indexOf("/");
+	if (slash === -1) return "binary";
+	switch (normalized.slice(0, slash)) {
+		case "video": return "video";
+		case "image": return "image";
+		case "audio": return "audio";
+		case "text": return normalized === "text/html" ? "html" : "text";
+		case "application":
+			if (documentMimeTypes.has(normalized)) return "document";
+			if (normalized === "application/json") return "text";
+			return "binary";
+		default: return "binary";
+	}
+}
+//#endregion
+export { mediaKindFromMime };
+
+//# sourceMappingURL=media-kind.js.map