@pristine-ts/observability 2.0.16

package/dist/lib/esm/paths/observability-paths.js

@@ -0,0 +1,41 @@
+import * as path from "path";
+/**
+ * Resolves every path inside the observability store from the configured store directory.
+ * Pure and stateless past construction — instantiate once with the configured directory
+ * and reuse.
+ *
+ * Layout:
+ * ```
+ * <root>/
+ *   <instanceId>/logs.jsonl
+ *   <instanceId>/requests.jsonl
+ *   <instanceId>/traces/<traceId>.json
+ * ```
+ *
+ * Each `<instanceId>` is one pristine process lifetime (= the kernel instantiation id).
+ * No metadata sidecars, no `latest.json` pointer — directory `mtime` answers "which is
+ * most recent."
+ */
+export class ObservabilityPaths {
+    constructor(configuredDirectory) {
+        this.root = path.isAbsolute(configuredDirectory)
+            ? configuredDirectory
+            : path.resolve(process.cwd(), configuredDirectory);
+    }
+    instanceDirectory(instanceId) {
+        return path.join(this.root, instanceId);
+    }
+    logsFile(instanceId) {
+        return path.join(this.instanceDirectory(instanceId), "logs.jsonl");
+    }
+    requestsFile(instanceId) {
+        return path.join(this.instanceDirectory(instanceId), "requests.jsonl");
+    }
+    tracesDirectory(instanceId) {
+        return path.join(this.instanceDirectory(instanceId), "traces");
+    }
+    traceFile(instanceId, traceId) {
+        return path.join(this.tracesDirectory(instanceId), `${traceId}.json`);
+    }
+}
+//# sourceMappingURL=observability-paths.js.map

package/dist/lib/esm/paths/observability-paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observability-paths.js","sourceRoot":"","sources":["../../../../src/paths/observability-paths.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,OAAO,kBAAkB;IAO7B,YAAY,mBAA2B;QACrC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,mBAAmB,CAAC;YAC9C,CAAC,CAAC,mBAAmB;YACrB,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,mBAAmB,CAAC,CAAC;IACvD,CAAC;IAED,iBAAiB,CAAC,UAAkB;QAClC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAC1C,CAAC;IAED,QAAQ,CAAC,UAAkB;QACzB,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,UAAU,CAAC,EAAE,YAAY,CAAC,CAAC;IACrE,CAAC;IAED,YAAY,CAAC,UAAkB;QAC7B,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,UAAU,CAAC,EAAE,gBAAgB,CAAC,CAAC;IACzE,CAAC;IAED,eAAe,CAAC,UAAkB;QAChC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC,CAAC;IACjE,CAAC;IAED,SAAS,CAAC,UAAkB,EAAE,OAAe;QAC3C,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,UAAU,CAAC,EAAE,GAAG,OAAO,OAAO,CAAC,CAAC;IACxE,CAAC;CACF"}

package/dist/lib/esm/paths/paths.js

@@ -0,0 +1,2 @@
+export * from "./observability-paths";
+//# sourceMappingURL=paths.js.map

package/dist/lib/esm/paths/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../../../src/paths/paths.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC"}

package/dist/lib/esm/serializers/serialized-span.interface.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=serialized-span.interface.js.map

package/dist/lib/esm/serializers/serialized-span.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialized-span.interface.js","sourceRoot":"","sources":["../../../../src/serializers/serialized-span.interface.ts"],"names":[],"mappings":""}

package/dist/lib/esm/serializers/serialized-trace.interface.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=serialized-trace.interface.js.map

package/dist/lib/esm/serializers/serialized-trace.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialized-trace.interface.js","sourceRoot":"","sources":["../../../../src/serializers/serialized-trace.interface.ts"],"names":[],"mappings":""}

package/dist/lib/esm/serializers/serializers.js

@@ -0,0 +1,3 @@
+export * from "./span-deserializer";
+export * from "./trace-deserializer";
+//# sourceMappingURL=serializers.js.map

package/dist/lib/esm/serializers/serializers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serializers.js","sourceRoot":"","sources":["../../../../src/serializers/serializers.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC"}

package/dist/lib/esm/serializers/span-deserializer.js

@@ -0,0 +1,22 @@
+import { Span } from "@pristine-ts/common";
+/**
+ * Rebuilds a `Span` (with its full child tree) from the stored plain object. Used by
+ * `TraceDeserializer` for the trace's root span and recursively for every descendant —
+ * so `traceRenderer.renderTree`/`renderFlat`, which call instance methods like
+ * `getDuration()`, work unchanged on stored traces.
+ */
+export class SpanDeserializer {
+    static deserialize(serialized, trace) {
+        var _a, _b;
+        const span = new Span(serialized.keyname, serialized.id, (_a = serialized.context) !== null && _a !== void 0 ? _a : {});
+        span.trace = trace;
+        span.startDate = serialized.startDate;
+        span.endDate = serialized.endDate;
+        span.inProgress = serialized.endDate === undefined;
+        for (const child of (_b = serialized.children) !== null && _b !== void 0 ? _b : []) {
+            span.addChild(SpanDeserializer.deserialize(child, trace));
+        }
+        return span;
+    }
+}
+//# sourceMappingURL=span-deserializer.js.map

package/dist/lib/esm/serializers/span-deserializer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"span-deserializer.js","sourceRoot":"","sources":["../../../../src/serializers/span-deserializer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,IAAI,EAAQ,MAAM,qBAAqB,CAAC;AAGhD;;;;;GAKG;AACH,MAAM,OAAO,gBAAgB;IAC3B,MAAM,CAAC,WAAW,CAAC,UAA0B,EAAE,KAAY;;QACzD,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,UAAU,CAAC,EAAE,EAAE,MAAA,UAAU,CAAC,OAAO,mCAAI,EAAE,CAAC,CAAC;QACnF,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,SAAS,GAAG,UAAU,CAAC,SAAS,CAAC;QACtC,IAAI,CAAC,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC;QAClC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC,OAAO,KAAK,SAAS,CAAC;QAEnD,KAAK,MAAM,KAAK,IAAI,MAAA,UAAU,CAAC,QAAQ,mCAAI,EAAE,EAAE,CAAC;YAC9C,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC,WAAW,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;QAC5D,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/dist/lib/esm/serializers/trace-deserializer.js

@@ -0,0 +1,20 @@
+import { Trace } from "@pristine-ts/common";
+import { SpanDeserializer } from "./span-deserializer";
+/**
+ * Rehydrates a stored trace JSON (the shape written by `ObservabilityTracer`) back into
+ * a `Trace` instance, with its full span tree rebuilt via `SpanDeserializer`.
+ */
+export class TraceDeserializer {
+    static deserialize(serialized) {
+        var _a;
+        const trace = new Trace(serialized.id, (_a = serialized.context) !== null && _a !== void 0 ? _a : {});
+        trace.startDate = serialized.startDate;
+        trace.endDate = serialized.endDate;
+        trace.hasEnded = serialized.endDate !== undefined;
+        if (serialized.rootSpan !== undefined) {
+            trace.rootSpan = SpanDeserializer.deserialize(serialized.rootSpan, trace);
+        }
+        return trace;
+    }
+}
+//# sourceMappingURL=trace-deserializer.js.map

package/dist/lib/esm/serializers/trace-deserializer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-deserializer.js","sourceRoot":"","sources":["../../../../src/serializers/trace-deserializer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,KAAK,EAAC,MAAM,qBAAqB,CAAC;AAE1C,OAAO,EAAC,gBAAgB,EAAC,MAAM,qBAAqB,CAAC;AAErD;;;GAGG;AACH,MAAM,OAAO,iBAAiB;IAC5B,MAAM,CAAC,WAAW,CAAC,UAA2B;;QAC5C,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,UAAU,CAAC,EAAE,EAAE,MAAA,UAAU,CAAC,OAAO,mCAAI,EAAE,CAAC,CAAC;QACjE,KAAK,CAAC,SAAS,GAAG,UAAU,CAAC,SAAS,CAAC;QACvC,KAAK,CAAC,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC;QACnC,KAAK,CAAC,QAAQ,GAAG,UAAU,CAAC,OAAO,KAAK,SAAS,CAAC;QAElD,IAAI,UAAU,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YACtC,KAAK,CAAC,QAAQ,GAAG,gBAAgB,CAAC,WAAW,CAAC,UAAU,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QAC5E,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}

package/dist/lib/esm/store/log-store.js

@@ -0,0 +1,213 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var LogStore_1;
+import * as fs from "fs";
+import { inject, injectable, singleton } from "tsyringe";
+import { injectConfig, InternalContainerParameterEnum, moduleScoped } from "@pristine-ts/common";
+import { ObservabilityModuleKeyname } from "../observability.module.keyname";
+import { ObservabilityConfigurationKeys } from "../observability.configuration-keys";
+import { ObservabilityPaths } from "../paths/observability-paths";
+import { LogTailer } from "../tailers/log-tailer";
+/**
+ * The read/write layer for captured logs. The `ObservabilityLogger` (a `Logger`-tagged
+ * transport) calls `append` on every log it sees. The CLI's `logs` command calls `read`
+ * / `tail` — addressed by event/trace/request id, never by a partition selector.
+ *
+ * Internally, each pristine process writes to its own per-process directory (keyed by
+ * the kernel instantiation id) so concurrent processes never race on the same file.
+ * That partition is invisible to callers: `read` walks every directory newest-first and
+ * concatenates; `tail` follows the most-recently-written directory.
+ *
+ * Singleton so both the writer (logger) and any reader resolved during the same
+ * process see the same in-memory state.
+ */
+let LogStore = LogStore_1 = class LogStore {
+    constructor(enabled, directory, retainedInstances, partitionId) {
+        this.enabled = enabled;
+        this.retainedInstances = retainedInstances;
+        this.partitionId = partitionId;
+        this.directoryEnsured = false;
+        this.pruned = false;
+        this.paths = new ObservabilityPaths(directory);
+    }
+    /**
+     * Whether capture is on. The `LoggerInterface` contract surfaces this through the
+     * adapter so `LogHandler` can skip dispatch entirely for disabled stores.
+     */
+    isCaptureEnabled() {
+        return this.enabled;
+    }
+    /**
+     * Appends one log entry to the current process's `logs.jsonl`. No-op when
+     * observability is disabled.
+     *
+     * The on-disk shape is the JSON-serialized `LogModel` itself — `severity` stays a
+     * numeric `SeverityEnum`, `date` becomes an ISO string — so the `logs` command can
+     * round-trip through `PrettyLogFormatter`. Stringification is cycle-safe because
+     * `log.extra` routinely holds `Span`/`Trace` objects whose `parentSpan` ↔ `children`
+     * back-references would otherwise blow up a naive serializer.
+     */
+    append(log) {
+        if (this.enabled === false) {
+            return;
+        }
+        this.ensurePartitionDirectory();
+        const line = LogStore_1.safeStringify(log) + "\n";
+        fs.appendFileSync(this.paths.logsFile(this.partitionId), line);
+    }
+    /**
+     * Every captured log entry across every partition, in write order within each
+     * partition and partitions concatenated newest-first. When `id` is provided, only
+     * entries whose `traceId` / `eventId` / `requestId` match are returned — useful for
+     * `pristine logs <id>`.
+     */
+    read(id) {
+        const entries = [];
+        for (const partition of this.partitionsNewestFirst()) {
+            for (const entry of this.readJsonl(this.paths.logsFile(partition))) {
+                if (id === undefined || LogStore_1.entryMatchesId(entry, id)) {
+                    entries.push(entry);
+                }
+            }
+        }
+        return entries;
+    }
+    /**
+     * Follows the most-recently-written partition's `logs.jsonl`, emitting each newly-
+     * appended line until the returned handle's `stop()` is called. When `id` is
+     * provided, only matching entries surface. Returns a no-op handle when the store
+     * has no partitions yet.
+     */
+    tail(id, onLine) {
+        const partition = this.latestPartition();
+        if (partition === undefined) {
+            return { stop: () => undefined };
+        }
+        const tailer = new LogTailer(this.paths.logsFile(partition));
+        tailer.follow(line => {
+            if (id === undefined) {
+                onLine(line);
+                return;
+            }
+            try {
+                if (LogStore_1.entryMatchesId(JSON.parse(line), id)) {
+                    onLine(line);
+                }
+            }
+            catch (_a) {
+                // Skip malformed lines rather than aborting the follow.
+            }
+        });
+        return { stop: () => tailer.stop() };
+    }
+    ensurePartitionDirectory() {
+        if (this.directoryEnsured) {
+            return;
+        }
+        fs.mkdirSync(this.paths.instanceDirectory(this.partitionId), { recursive: true });
+        this.directoryEnsured = true;
+        this.pruneOldPartitions();
+    }
+    /**
+     * Drops partition directories beyond the retained limit, ordered by `mtime`. Once
+     * per process — additional appends are zero-cost. Best-effort: a failure to prune
+     * never blocks a write.
+     */
+    pruneOldPartitions() {
+        if (this.pruned) {
+            return;
+        }
+        this.pruned = true;
+        try {
+            const ordered = this.partitionsNewestFirst();
+            for (const stale of ordered.slice(Math.max(this.retainedInstances, 1))) {
+                fs.rmSync(this.paths.instanceDirectory(stale), { recursive: true, force: true });
+            }
+        }
+        catch (_a) {
+            // Best-effort.
+        }
+    }
+    partitionsNewestFirst() {
+        try {
+            return fs.readdirSync(this.paths.root, { withFileTypes: true })
+                .filter(entry => entry.isDirectory())
+                .map(entry => ({ name: entry.name, mtime: this.directoryMtime(entry.name) }))
+                .sort((a, b) => b.mtime - a.mtime)
+                .map(entry => entry.name);
+        }
+        catch (_a) {
+            return [];
+        }
+    }
+    latestPartition() {
+        return this.partitionsNewestFirst()[0];
+    }
+    directoryMtime(name) {
+        try {
+            return fs.statSync(this.paths.instanceDirectory(name)).mtimeMs;
+        }
+        catch (_a) {
+            return 0;
+        }
+    }
+    readJsonl(filePath) {
+        try {
+            return fs.readFileSync(filePath, "utf8")
+                .split("\n")
+                .filter(line => line.trim().length > 0)
+                .map(line => JSON.parse(line));
+        }
+        catch (_a) {
+            return [];
+        }
+    }
+    /**
+     * True when any of the entry's correlation fields match the requested id.
+     * `requestId` is checked too even though `LogModel` doesn't define it as a field
+     * today — JSON deserialization is permissive, so a custom mapper that does set it
+     * will round-trip and match.
+     */
+    static entryMatchesId(entry, id) {
+        return entry.traceId === id || entry.eventId === id || entry.requestId === id;
+    }
+    /**
+     * `JSON.stringify` with a cycle guard — an object seen earlier in the walk is rendered
+     * as `"[Circular]"` rather than recursed into. Faithful at any depth, and immune to the
+     * `Span.parentSpan` ↔ `Span.children` cycles common in `log.extra`.
+     */
+    static safeStringify(value) {
+        const seen = new WeakSet();
+        return JSON.stringify(value, (_key, val) => {
+            if (typeof val === "object" && val !== null) {
+                if (seen.has(val)) {
+                    return "[Circular]";
+                }
+                seen.add(val);
+            }
+            return val;
+        });
+    }
+};
+LogStore = LogStore_1 = __decorate([
+    moduleScoped(ObservabilityModuleKeyname),
+    singleton(),
+    injectable(),
+    __param(0, injectConfig(ObservabilityConfigurationKeys.Enabled)),
+    __param(1, injectConfig(ObservabilityConfigurationKeys.Directory)),
+    __param(2, injectConfig(ObservabilityConfigurationKeys.RetainedInstances)),
+    __param(3, inject(InternalContainerParameterEnum.KernelInstantiationId)),
+    __metadata("design:paramtypes", [Boolean, String, Number, String])
+], LogStore);
+export { LogStore };
+//# sourceMappingURL=log-store.js.map

package/dist/lib/esm/store/log-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-store.js","sourceRoot":"","sources":["../../../../src/store/log-store.ts"],"names":[],"mappings":"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"}

package/dist/lib/esm/store/log-tailer.js

@@ -0,0 +1,73 @@
+import * as fs from "fs";
+import * as path from "path";
+/**
+ * Follows a growing `.jsonl` file and emits each newly-appended complete line. The
+ * `logs --follow` command and the REPL use this for a `tail -f`-style live view.
+ *
+ * Watches the file's parent directory (watching a not-yet-created file directly is
+ * unreliable across platforms) and reads the byte delta on each change. Partial trailing
+ * lines are buffered until their terminating newline arrives.
+ *
+ * Not a DI service — a plain utility. Instantiate, `follow()`, and `stop()` when done.
+ */
+export class LogTailer {
+    constructor(filePath) {
+        this.filePath = filePath;
+        this.offset = 0;
+        this.buffer = "";
+    }
+    /**
+     * Starts following. Existing content is skipped — only lines appended after this call
+     * are emitted. Call `stop()` to release the watch.
+     */
+    follow(onLine) {
+        this.offset = fs.existsSync(this.filePath) ? fs.statSync(this.filePath).size : 0;
+        const directory = path.dirname(this.filePath);
+        const filename = path.basename(this.filePath);
+        this.watcher = fs.watch(directory, (_eventType, changed) => {
+            if (changed !== null && changed !== filename) {
+                return;
+            }
+            this.drain(onLine);
+        });
+    }
+    /**
+     * Stops following and releases the filesystem watch.
+     */
+    stop() {
+        var _a;
+        (_a = this.watcher) === null || _a === void 0 ? void 0 : _a.close();
+        this.watcher = undefined;
+    }
+    drain(onLine) {
+        var _a;
+        if (fs.existsSync(this.filePath) === false) {
+            return;
+        }
+        const size = fs.statSync(this.filePath).size;
+        if (size <= this.offset) {
+            // Truncated or unchanged — reset to the new end so we don't replay stale bytes.
+            this.offset = size;
+            return;
+        }
+        const fd = fs.openSync(this.filePath, "r");
+        try {
+            const length = size - this.offset;
+            const chunk = Buffer.alloc(length);
+            fs.readSync(fd, chunk, 0, length, this.offset);
+            this.offset = size;
+            this.buffer += chunk.toString("utf8");
+        }
+        finally {
+            fs.closeSync(fd);
+        }
+        const lines = this.buffer.split("\n");
+        this.buffer = (_a = lines.pop()) !== null && _a !== void 0 ? _a : "";
+        for (const line of lines) {
+            if (line.length > 0) {
+                onLine(line);
+            }
+        }
+    }
+}
+//# sourceMappingURL=log-tailer.js.map

package/dist/lib/esm/store/log-tailer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-tailer.js","sourceRoot":"","sources":["../../../../src/store/log-tailer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B;;;;;;;;;GASG;AACH,MAAM,OAAO,SAAS;IAKpB,YAA6B,QAAgB;QAAhB,aAAQ,GAAR,QAAQ,CAAQ;QAHrC,WAAM,GAAG,CAAC,CAAC;QACX,WAAM,GAAG,EAAE,CAAC;IAGpB,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,MAA8B;QACnC,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QAEjF,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC9C,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAE9C,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC,UAAU,EAAE,OAAO,EAAE,EAAE;YACzD,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;gBAC7C,OAAO;YACT,CAAC;YACD,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACrB,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,IAAI;;QACF,MAAA,IAAI,CAAC,OAAO,0CAAE,KAAK,EAAE,CAAC;QACtB,IAAI,CAAC,OAAO,GAAG,SAAS,CAAC;IAC3B,CAAC;IAEO,KAAK,CAAC,MAA8B;;QAC1C,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,KAAK,EAAE,CAAC;YAC3C,OAAO;QACT,CAAC;QAED,MAAM,IAAI,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC;QAC7C,IAAI,IAAI,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YACxB,gFAAgF;YAChF,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;YACnB,OAAO;QACT,CAAC;QAED,MAAM,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QAC3C,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC;YAClC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YACnC,EAAE,CAAC,QAAQ,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;YAC/C,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;YACnB,IAAI,CAAC,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QACxC,CAAC;gBAAS,CAAC;YACT,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QACnB,CAAC;QAED,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,CAAC,MAAM,GAAG,MAAA,KAAK,CAAC,GAAG,EAAE,mCAAI,EAAE,CAAC;QAChC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACpB,MAAM,CAAC,IAAI,CAAC,CAAC;YACf,CAAC;QACH,CAAC;IACH,CAAC;CACF"}

package/dist/lib/esm/store/observability-paths.js

@@ -0,0 +1,41 @@
+import * as path from "path";
+/**
+ * Resolves every path inside the observability store from the configured store directory.
+ * Pure and stateless past construction — instantiate once with the configured directory
+ * and reuse.
+ *
+ * Layout:
+ * ```
+ * <root>/
+ *   <instanceId>/logs.jsonl
+ *   <instanceId>/requests.jsonl
+ *   <instanceId>/traces/<traceId>.json
+ * ```
+ *
+ * Each `<instanceId>` is one pristine process lifetime (= the kernel instantiation id).
+ * No metadata sidecars, no `latest.json` pointer — directory `mtime` answers "which is
+ * most recent."
+ */
+export class ObservabilityPaths {
+    constructor(configuredDirectory) {
+        this.root = path.isAbsolute(configuredDirectory)
+            ? configuredDirectory
+            : path.resolve(process.cwd(), configuredDirectory);
+    }
+    instanceDirectory(instanceId) {
+        return path.join(this.root, instanceId);
+    }
+    logsFile(instanceId) {
+        return path.join(this.instanceDirectory(instanceId), "logs.jsonl");
+    }
+    requestsFile(instanceId) {
+        return path.join(this.instanceDirectory(instanceId), "requests.jsonl");
+    }
+    tracesDirectory(instanceId) {
+        return path.join(this.instanceDirectory(instanceId), "traces");
+    }
+    traceFile(instanceId, traceId) {
+        return path.join(this.tracesDirectory(instanceId), `${traceId}.json`);
+    }
+}
+//# sourceMappingURL=observability-paths.js.map

package/dist/lib/esm/store/observability-paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observability-paths.js","sourceRoot":"","sources":["../../../../src/store/observability-paths.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,OAAO,kBAAkB;IAO7B,YAAY,mBAA2B;QACrC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,mBAAmB,CAAC;YAC9C,CAAC,CAAC,mBAAmB;YACrB,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,mBAAmB,CAAC,CAAC;IACvD,CAAC;IAED,iBAAiB,CAAC,UAAkB;QAClC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAC1C,CAAC;IAED,QAAQ,CAAC,UAAkB;QACzB,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,UAAU,CAAC,EAAE,YAAY,CAAC,CAAC;IACrE,CAAC;IAED,YAAY,CAAC,UAAkB;QAC7B,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,UAAU,CAAC,EAAE,gBAAgB,CAAC,CAAC;IACzE,CAAC;IAED,eAAe,CAAC,UAAkB;QAChC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC,CAAC;IACjE,CAAC;IAED,SAAS,CAAC,UAAkB,EAAE,OAAe;QAC3C,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,UAAU,CAAC,EAAE,GAAG,OAAO,OAAO,CAAC,CAAC;IACxE,CAAC;CACF"}