@camstack/system 1.2.456 → 1.2.457

package/dist/log-file-read-worker.js

@@ -0,0 +1,64 @@
+require("./chunk-Cek0wNdY.js");
+const require_log_file_read_protocol = require("./log-file-read-protocol-D0WcLbIV.js");
+let node_worker_threads = require("node:worker_threads");
+//#region src/builtins/winston-logging/log-file-read-worker.ts
+/**
+* The rotated-file reader thread (D898) — a worker of whichever process runs
+* `winston-logging`, so scanning and indexing a day of logs never runs on that
+* process's event loop.
+*
+* A separate bundle (`dist/log-file-read-worker.js`, wired in
+* `vite.config.ts`). It imports nothing from the kernel: the index, the
+* reader and the shared line filter.
+*/
+function isWorkerData(value) {
+	return typeof value === "object" && value !== null && "logsDir" in value && typeof value.logsDir === "string" && "backgroundPassMs" in value && typeof value.backgroundPassMs === "number";
+}
+var port = node_worker_threads.parentPort;
+if (port === null || !isWorkerData(node_worker_threads.workerData)) throw new Error("log-file-read-worker: started without a parent port or worker data");
+var data = node_worker_threads.workerData;
+var store = new require_log_file_read_protocol.LogFileIndexStore(data.logsDir);
+var cancels = new require_log_file_read_protocol.CancelBook();
+var stopping = false;
+var passRunning = false;
+async function backgroundPass() {
+	if (passRunning || stopping) return;
+	passRunning = true;
+	try {
+		await store.backgroundPass(() => stopping);
+	} catch {} finally {
+		passRunning = false;
+	}
+}
+var timer = data.backgroundPassMs > 0 ? setInterval(() => void backgroundPass(), data.backgroundPassMs) : null;
+if (data.backgroundPassMs > 0) backgroundPass();
+port.on("message", (message) => {
+	if (!require_log_file_read_protocol.isToReader(message)) return;
+	if (message.type === "stop") {
+		stopping = true;
+		if (timer !== null) clearInterval(timer);
+		port.close();
+		return;
+	}
+	if (message.type === "cancel") {
+		cancels.cancel(message.requestId);
+		return;
+	}
+	const { id, query } = message;
+	require_log_file_read_protocol.serveRead(data.logsDir, store, cancels, query).then((outcome) => {
+		const reply = {
+			type: "result",
+			id,
+			result: outcome.result
+		};
+		port.postMessage(reply);
+	}, (error) => {
+		const reply = {
+			type: "error",
+			id,
+			message: error instanceof Error ? error.message : String(error)
+		};
+		port.postMessage(reply);
+	});
+});
+//#endregion

package/dist/log-file-read-worker.mjs

@@ -0,0 +1,64 @@
+import { a as LogFileIndexStore, i as serveRead, r as isToReader, t as CancelBook } from "./log-file-read-protocol-B7M3X3bT.mjs";
+import { parentPort, workerData } from "node:worker_threads";
+//#region src/builtins/winston-logging/log-file-read-worker.ts
+/**
+* The rotated-file reader thread (D898) — a worker of whichever process runs
+* `winston-logging`, so scanning and indexing a day of logs never runs on that
+* process's event loop.
+*
+* A separate bundle (`dist/log-file-read-worker.js`, wired in
+* `vite.config.ts`). It imports nothing from the kernel: the index, the
+* reader and the shared line filter.
+*/
+function isWorkerData(value) {
+	return typeof value === "object" && value !== null && "logsDir" in value && typeof value.logsDir === "string" && "backgroundPassMs" in value && typeof value.backgroundPassMs === "number";
+}
+var port = parentPort;
+if (port === null || !isWorkerData(workerData)) throw new Error("log-file-read-worker: started without a parent port or worker data");
+var data = workerData;
+var store = new LogFileIndexStore(data.logsDir);
+var cancels = new CancelBook();
+var stopping = false;
+var passRunning = false;
+async function backgroundPass() {
+	if (passRunning || stopping) return;
+	passRunning = true;
+	try {
+		await store.backgroundPass(() => stopping);
+	} catch {} finally {
+		passRunning = false;
+	}
+}
+var timer = data.backgroundPassMs > 0 ? setInterval(() => void backgroundPass(), data.backgroundPassMs) : null;
+if (data.backgroundPassMs > 0) backgroundPass();
+port.on("message", (message) => {
+	if (!isToReader(message)) return;
+	if (message.type === "stop") {
+		stopping = true;
+		if (timer !== null) clearInterval(timer);
+		port.close();
+		return;
+	}
+	if (message.type === "cancel") {
+		cancels.cancel(message.requestId);
+		return;
+	}
+	const { id, query } = message;
+	serveRead(data.logsDir, store, cancels, query).then((outcome) => {
+		const reply = {
+			type: "result",
+			id,
+			result: outcome.result
+		};
+		port.postMessage(reply);
+	}, (error) => {
+		const reply = {
+			type: "error",
+			id,
+			message: error instanceof Error ? error.message : String(error)
+		};
+		port.postMessage(reply);
+	});
+});
+//#endregion
+export {};

package/dist/log-read-filter-Bi066jwU.js

@@ -0,0 +1,134 @@
+//#region src/logging/log-read-filter.ts
+var LEVEL_RANK = {
+	debug: 0,
+	info: 1,
+	warn: 2,
+	error: 3
+};
+function levelRank(level) {
+	return level === "debug" || level === "info" || level === "warn" || level === "error" ? LEVEL_RANK[level] : LEVEL_RANK.info;
+}
+/** `provider@1.2.3` / `audio-codec::native-device-ops` → the manifest id. */
+function bareAddonOf(raw) {
+	if (typeof raw !== "string" || raw.length === 0) return null;
+	let bare = raw.split("@")[0] ?? raw;
+	const colon = bare.indexOf("::");
+	if (colon >= 0) bare = bare.slice(0, colon);
+	return bare;
+}
+/** The node a line is attributed to for the `nodeId` filter and the block index. */
+function originNodeOf(tags) {
+	const agentId = tags?.["agentId"];
+	if (typeof agentId === "string" && agentId.length > 0) return agentId;
+	const nodeId = tags?.["nodeId"];
+	if (typeof nodeId === "string" && nodeId.length > 0) {
+		const slash = nodeId.indexOf("/");
+		return slash === -1 ? nodeId : nodeId.slice(0, slash);
+	}
+	return null;
+}
+function nodeMatches(tags, want) {
+	if (tags === void 0) return false;
+	const agentId = tags["agentId"];
+	const nodeId = tags["nodeId"];
+	if (agentId === want || nodeId === want) return true;
+	return typeof nodeId === "string" && nodeId.startsWith(`${want}/`);
+}
+function stringifyValue(value) {
+	if (typeof value === "string") return value;
+	if (typeof value === "number" || typeof value === "boolean") return String(value);
+	try {
+		return JSON.stringify(value) ?? "";
+	} catch {
+		return String(value);
+	}
+}
+/** Case-insensitive substring over message, scope, every tag value and every meta value. */
+function lineContainsText(line, needleLower) {
+	if (line.message.toLowerCase().includes(needleLower)) return true;
+	if (line.scope !== void 0 && line.scope.toLowerCase().includes(needleLower)) return true;
+	for (const bag of [line.tags, line.meta]) {
+		if (bag === void 0) continue;
+		for (const value of Object.values(bag)) {
+			if (value === void 0 || value === null) continue;
+			if (stringifyValue(value).toLowerCase().includes(needleLower)) return true;
+		}
+	}
+	return false;
+}
+function compileLogFilter(query) {
+	const text = query.text?.trim() ?? "";
+	return {
+		deviceId: query.deviceId ?? null,
+		addonId: query.fromAddonId !== void 0 ? bareAddonOf(query.fromAddonId) : null,
+		nodeId: query.fromNodeId ?? null,
+		tags: query.tags ?? {},
+		levelFloor: query.level !== void 0 ? LEVEL_RANK[query.level] : 0,
+		textLower: text.length > 0 ? text.toLowerCase() : null,
+		since: query.since ?? null,
+		until: query.until ?? null
+	};
+}
+/** Exact match of one line against the whole filter. */
+function lineMatches(line, filter) {
+	if (levelRank(line.level) < filter.levelFloor) return false;
+	if (filter.since !== null && line.timestamp < filter.since) return false;
+	if (filter.until !== null && line.timestamp > filter.until) return false;
+	const tags = line.tags;
+	if (filter.deviceId !== null && tags?.["deviceId"] !== filter.deviceId) return false;
+	if (filter.addonId !== null && bareAddonOf(tags?.["addonId"]) !== filter.addonId) return false;
+	if (filter.nodeId !== null && !nodeMatches(tags, filter.nodeId)) return false;
+	for (const [key, want] of Object.entries(filter.tags)) {
+		const have = tags?.[key];
+		if (have !== want && !(typeof have === "number" && String(have) === String(want))) return false;
+	}
+	if (filter.textLower !== null && !lineContainsText(line, filter.textLower)) return false;
+	return true;
+}
+/** True when the filter constrains nothing — every line matches. */
+function filterIsEmpty(filter) {
+	return filter.deviceId === null && filter.addonId === null && filter.nodeId === null && Object.keys(filter.tags).length === 0 && filter.levelFloor === 0 && filter.textLower === null && filter.since === null && filter.until === null;
+}
+//#endregion
+Object.defineProperty(exports, "bareAddonOf", {
+	enumerable: true,
+	get: function() {
+		return bareAddonOf;
+	}
+});
+Object.defineProperty(exports, "compileLogFilter", {
+	enumerable: true,
+	get: function() {
+		return compileLogFilter;
+	}
+});
+Object.defineProperty(exports, "filterIsEmpty", {
+	enumerable: true,
+	get: function() {
+		return filterIsEmpty;
+	}
+});
+Object.defineProperty(exports, "levelRank", {
+	enumerable: true,
+	get: function() {
+		return levelRank;
+	}
+});
+Object.defineProperty(exports, "lineContainsText", {
+	enumerable: true,
+	get: function() {
+		return lineContainsText;
+	}
+});
+Object.defineProperty(exports, "lineMatches", {
+	enumerable: true,
+	get: function() {
+		return lineMatches;
+	}
+});
+Object.defineProperty(exports, "originNodeOf", {
+	enumerable: true,
+	get: function() {
+		return originNodeOf;
+	}
+});

package/dist/log-read-filter-D7Ev3zm-.mjs

@@ -0,0 +1,93 @@
+//#region src/logging/log-read-filter.ts
+var LEVEL_RANK = {
+	debug: 0,
+	info: 1,
+	warn: 2,
+	error: 3
+};
+function levelRank(level) {
+	return level === "debug" || level === "info" || level === "warn" || level === "error" ? LEVEL_RANK[level] : LEVEL_RANK.info;
+}
+/** `provider@1.2.3` / `audio-codec::native-device-ops` → the manifest id. */
+function bareAddonOf(raw) {
+	if (typeof raw !== "string" || raw.length === 0) return null;
+	let bare = raw.split("@")[0] ?? raw;
+	const colon = bare.indexOf("::");
+	if (colon >= 0) bare = bare.slice(0, colon);
+	return bare;
+}
+/** The node a line is attributed to for the `nodeId` filter and the block index. */
+function originNodeOf(tags) {
+	const agentId = tags?.["agentId"];
+	if (typeof agentId === "string" && agentId.length > 0) return agentId;
+	const nodeId = tags?.["nodeId"];
+	if (typeof nodeId === "string" && nodeId.length > 0) {
+		const slash = nodeId.indexOf("/");
+		return slash === -1 ? nodeId : nodeId.slice(0, slash);
+	}
+	return null;
+}
+function nodeMatches(tags, want) {
+	if (tags === void 0) return false;
+	const agentId = tags["agentId"];
+	const nodeId = tags["nodeId"];
+	if (agentId === want || nodeId === want) return true;
+	return typeof nodeId === "string" && nodeId.startsWith(`${want}/`);
+}
+function stringifyValue(value) {
+	if (typeof value === "string") return value;
+	if (typeof value === "number" || typeof value === "boolean") return String(value);
+	try {
+		return JSON.stringify(value) ?? "";
+	} catch {
+		return String(value);
+	}
+}
+/** Case-insensitive substring over message, scope, every tag value and every meta value. */
+function lineContainsText(line, needleLower) {
+	if (line.message.toLowerCase().includes(needleLower)) return true;
+	if (line.scope !== void 0 && line.scope.toLowerCase().includes(needleLower)) return true;
+	for (const bag of [line.tags, line.meta]) {
+		if (bag === void 0) continue;
+		for (const value of Object.values(bag)) {
+			if (value === void 0 || value === null) continue;
+			if (stringifyValue(value).toLowerCase().includes(needleLower)) return true;
+		}
+	}
+	return false;
+}
+function compileLogFilter(query) {
+	const text = query.text?.trim() ?? "";
+	return {
+		deviceId: query.deviceId ?? null,
+		addonId: query.fromAddonId !== void 0 ? bareAddonOf(query.fromAddonId) : null,
+		nodeId: query.fromNodeId ?? null,
+		tags: query.tags ?? {},
+		levelFloor: query.level !== void 0 ? LEVEL_RANK[query.level] : 0,
+		textLower: text.length > 0 ? text.toLowerCase() : null,
+		since: query.since ?? null,
+		until: query.until ?? null
+	};
+}
+/** Exact match of one line against the whole filter. */
+function lineMatches(line, filter) {
+	if (levelRank(line.level) < filter.levelFloor) return false;
+	if (filter.since !== null && line.timestamp < filter.since) return false;
+	if (filter.until !== null && line.timestamp > filter.until) return false;
+	const tags = line.tags;
+	if (filter.deviceId !== null && tags?.["deviceId"] !== filter.deviceId) return false;
+	if (filter.addonId !== null && bareAddonOf(tags?.["addonId"]) !== filter.addonId) return false;
+	if (filter.nodeId !== null && !nodeMatches(tags, filter.nodeId)) return false;
+	for (const [key, want] of Object.entries(filter.tags)) {
+		const have = tags?.[key];
+		if (have !== want && !(typeof have === "number" && String(have) === String(want))) return false;
+	}
+	if (filter.textLower !== null && !lineContainsText(line, filter.textLower)) return false;
+	return true;
+}
+/** True when the filter constrains nothing — every line matches. */
+function filterIsEmpty(filter) {
+	return filter.deviceId === null && filter.addonId === null && filter.nodeId === null && Object.keys(filter.tags).length === 0 && filter.levelFloor === 0 && filter.textLower === null && filter.since === null && filter.until === null;
+}
+//#endregion
+export { lineContainsText as a, levelRank as i, compileLogFilter as n, lineMatches as o, filterIsEmpty as r, originNodeOf as s, bareAddonOf as t };

package/dist/logging/log-manager.d.ts

@@ -2,12 +2,8 @@ import { type LogEntry, type LogFilter, type LogLevel } from "./log-ring-buffer.
 import type { LoggingGate } from "./logging-gate.js";
 import { type PartitionedLogBufferOptions } from "./partitioned-log-buffer.js";
 import { type IScopedLogger } from "./scoped-logger.js";
-export interface ILogDestination {
-	initialize(): Promise<void>;
-	shutdown(): Promise<void>;
-	write(entry: LogEntry): void;
-	query?(filter: LogFilter): Promise<readonly LogEntry[]>;
-}
+import type { ILogDestination } from "@camstack/types";
+export type { ILogDestination };
 /**
 * The reserved destination id of the in-memory buffer. Not an addon: the
 * buffer must exist before any addon loads (boot lines) and it backs
@@ -62,6 +58,14 @@ export declare class LogManager {
 	*/
 	private gate;
 	/**
+	* Entry identity (D898): `<bootId>.<seq>`, stamped once, here, on every line
+	* this process accepts — so the in-memory tail, the live subscription and
+	* the rotated file carry the SAME id and a page read from disk dedupes
+	* exactly against the lines pushed live.
+	*/
+	private readonly bootId;
+	private seq;
+	/**
 	* `perAddonCapacity` bounds EACH addon's bucket, not the total — a chatty addon
 	* evicts only its own lines, so quiet addons keep their sparse history.
 	*

package/dist/logging/log-read-filter.d.ts

@@ -0,0 +1,43 @@
+/**
+* The ONE definition of "does this line match a history read" (D898).
+*
+* Used by every reader — the rotated-file reader in its worker, the Loki
+* reader after LogQL has narrowed the stream, and the hub's in-memory tail —
+* so the same query cannot mean three different things on three sources.
+*
+* It is deliberately free of value imports: the file reader runs it inside a
+* bare worker thread.
+*/
+import type { LogReadQuery } from "@camstack/types";
+/** A structurally-typed line: a parsed file row, a ring entry or a Loki line. */
+export interface ReadableLine {
+	readonly timestamp: number;
+	readonly level: string;
+	readonly message: string;
+	readonly scope?: string | undefined;
+	readonly tags?: Readonly<Record<string, unknown>> | undefined;
+	readonly meta?: Readonly<Record<string, unknown>> | undefined;
+}
+export declare function levelRank(level: string): number;
+/** `provider@1.2.3` / `audio-codec::native-device-ops` → the manifest id. */
+export declare function bareAddonOf(raw: unknown): string | null;
+/** The node a line is attributed to for the `nodeId` filter and the block index. */
+export declare function originNodeOf(tags: Readonly<Record<string, unknown>> | undefined): string | null;
+/** Case-insensitive substring over message, scope, every tag value and every meta value. */
+export declare function lineContainsText(line: ReadableLine, needleLower: string): boolean;
+/** The filter half of a {@link LogReadQuery}, normalised once per read. */
+export interface CompiledLogFilter {
+	readonly deviceId: number | null;
+	readonly addonId: string | null;
+	readonly nodeId: string | null;
+	readonly tags: Readonly<Record<string, string | number>>;
+	readonly levelFloor: number;
+	readonly textLower: string | null;
+	readonly since: number | null;
+	readonly until: number | null;
+}
+export declare function compileLogFilter(query: LogReadQuery): CompiledLogFilter;
+/** Exact match of one line against the whole filter. */
+export declare function lineMatches(line: ReadableLine, filter: CompiledLogFilter): boolean;
+/** True when the filter constrains nothing — every line matches. */
+export declare function filterIsEmpty(filter: CompiledLogFilter): boolean;

package/dist/{phase6-declare-gate-n-IZRklX.js → phase6-declare-gate-BO-_jLh_.js}

@@ -1,4 +1,4 @@
-const require_dist = require("./dist-BpqA2CT0.js");
+const require_dist = require("./dist-C89nqNnn.js");
 //#region src/builtins/records/legacy-table-row-count.ts
 /** Row count for a physical settings-db table (matches the records engine `legacyRowCount`). */
 function legacyTableRowCountFromList(tables, collection) {

package/dist/{phase6-declare-gate-B4yfsf2n.mjs → phase6-declare-gate-x9ZCbQJP.mjs}

@@ -1,4 +1,4 @@
-import { Vi as declarationsOf } from "./dist-BSF_C8W2.mjs";
+import { Wi as declarationsOf } from "./dist-Dhux90yB.mjs";
 //#region src/builtins/records/legacy-table-row-count.ts
 /** Row count for a physical settings-db table (matches the records engine `legacyRowCount`). */
 function legacyTableRowCountFromList(tables, collection) {

package/dist/{restore-archive-B4QG7XmX.js → restore-archive-4DOUR5Gu.js}

@@ -1,5 +1,5 @@
 const require_chunk = require("./chunk-Cek0wNdY.js");
-const require_dist = require("./dist-BpqA2CT0.js");
+const require_dist = require("./dist-C89nqNnn.js");
 const require_read_all_rows$1 = require("./read-all-rows-CVoO1ONM.js");
 let zod = require("zod");
 let node_crypto = require("node:crypto");

package/dist/{restore-archive-BGUM4FKf.mjs → restore-archive-DyOaPeAr.mjs}

@@ -1,4 +1,4 @@
-import { M as DataStoreDatabaseSchema, S as DATABASE_SNAPSHOT_SUFFIX, Ui as defineRecordKinds } from "./dist-BSF_C8W2.mjs";
+import { Ki as defineRecordKinds, N as DataStoreDatabaseSchema, S as DATABASE_SNAPSHOT_SUFFIX } from "./dist-Dhux90yB.mjs";
 import { t as require_read_all_rows } from "./read-all-rows-TaPqdWNF.mjs";
 import { z } from "zod";
 import { createCipheriv, createDecipheriv, createHash, createPrivateKey, createPublicKey, diffieHellman, generateKeyPairSync, hkdfSync, randomBytes } from "node:crypto";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/system",
-  "version": "1.2.456",
+  "version": "1.2.457",
   "description": "Core addon for CamStack — builtins, pipeline, process management, auth, logging, events",
   "keywords": [
     "camstack",