hazo_logs 1.0.14 → 1.1.0

package/README.md

@@ -562,6 +562,31 @@ const authHandler = withLogAuth(handler, async (request) => {
 });
 ```
 
+## Live tail (v1.1+)
+
+`tailLogs` watches the active rotating log file and emits new entries as they are written. Filters mirror `readLogs`. Use it directly for in-process consumers:
+
+```ts
+import { tailLogs } from "hazo_logs/server";
+
+const ctrl = new AbortController();
+for await (const entry of tailLogs({ reference: ["job-123"], signal: ctrl.signal })) {
+  console.log(entry.message);
+}
+// later: ctrl.abort();
+```
+
+For SSE-over-HTTP (admin UIs, dashboards), use `createLogStreamApiHandler`:
+
+```ts
+import { createLogStreamApiHandler } from "hazo_logs/ui/server";
+
+// Next.js app router
+export const GET = createLogStreamApiHandler({ reference: ["job-123"] });
+```
+
+Clients consume via the standard `EventSource` API. The stream closes when the client disconnects.
+
 ## Log File Format
 
 Logs are stored as newline-delimited JSON:

package/dist/lib/log-tail.d.ts

@@ -0,0 +1,11 @@
+import type { LogEntry, LogLevel } from "./types.js";
+export interface TailOptions {
+    reference?: string[];
+    sessionId?: string[];
+    level?: LogLevel[];
+    package?: string[];
+    signal?: AbortSignal;
+    logDirectory?: string;
+}
+export declare function tailLogs(opts?: TailOptions): AsyncIterable<LogEntry>;
+//# sourceMappingURL=log-tail.d.ts.map

package/dist/lib/log-tail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-tail.d.ts","sourceRoot":"","sources":["../../src/lib/log-tail.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAGrD,MAAM,WAAW,WAAW;IAC1B,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,KAAK,CAAC,EAAE,QAAQ,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAWD,wBAAgB,QAAQ,CAAC,IAAI,GAAE,WAAgB,GAAG,aAAa,CAAC,QAAQ,CAAC,CAoIxE"}

package/dist/lib/log-tail.js

@@ -0,0 +1,161 @@
+import { promises as fsp, watch, statSync } from "fs";
+import { join } from "path";
+import { loadConfig } from "./config_loader.js";
+function todayDateString() {
+    const d = new Date();
+    return `${d.getFullYear()}-${String(d.getMonth() + 1).padStart(2, "0")}-${String(d.getDate()).padStart(2, "0")}`;
+}
+function activeLogFile(logDir) {
+    return join(logDir, `hazo-${todayDateString()}.log`);
+}
+export function tailLogs(opts = {}) {
+    const logDir = opts.logDirectory ?? loadConfig().log_directory;
+    return {
+        [Symbol.asyncIterator]() {
+            const buffer = [];
+            const wakers = [];
+            let done = false;
+            let position = 0;
+            let watcher;
+            let pollInterval;
+            let rolloverInterval;
+            let leftover = "";
+            let readChain = Promise.resolve();
+            let filePath = activeLogFile(logDir);
+            // Start at end-of-file: tail only NEW lines, not history.
+            try {
+                position = statSync(filePath).size;
+            }
+            catch {
+                position = 0;
+            }
+            function matches(e) {
+                if (opts.reference?.length && !opts.reference.includes(e.reference))
+                    return false;
+                if (opts.sessionId?.length && !opts.sessionId.includes(e.sessionId))
+                    return false;
+                if (opts.level?.length && !opts.level.includes(e.level))
+                    return false;
+                if (opts.package?.length && !opts.package.includes(e.package))
+                    return false;
+                return true;
+            }
+            function deliver(entry) {
+                const w = wakers.shift();
+                if (w)
+                    w({ value: entry, done: false });
+                else
+                    buffer.push(entry);
+            }
+            function finish() {
+                if (done)
+                    return;
+                done = true;
+                if (rolloverInterval) {
+                    clearInterval(rolloverInterval);
+                    rolloverInterval = undefined;
+                }
+                if (pollInterval) {
+                    clearInterval(pollInterval);
+                    pollInterval = undefined;
+                }
+                watcher?.close();
+                while (wakers.length)
+                    wakers.shift()({ value: undefined, done: true });
+            }
+            function scheduleRead() {
+                readChain = readChain.then(readDelta).catch(() => { });
+            }
+            async function readDelta() {
+                try {
+                    const st = await fsp.stat(filePath);
+                    if (st.size < position) {
+                        // truncation / rotation — restart from current end
+                        position = st.size;
+                        leftover = "";
+                        return;
+                    }
+                    if (st.size === position)
+                        return;
+                    const fh = await fsp.open(filePath, "r");
+                    const len = st.size - position;
+                    const buf = Buffer.alloc(len);
+                    await fh.read(buf, 0, len, position);
+                    await fh.close();
+                    position = st.size;
+                    const text = leftover + buf.toString("utf8");
+                    const lines = text.split("\n");
+                    leftover = lines.pop() ?? "";
+                    for (const line of lines) {
+                        const trimmed = line.trim();
+                        if (!trimmed)
+                            continue;
+                        try {
+                            const parsed = JSON.parse(trimmed);
+                            if (matches(parsed))
+                                deliver(parsed);
+                        }
+                        catch {
+                            // skip malformed lines
+                        }
+                    }
+                }
+                catch {
+                    // file may not exist yet; ignore
+                }
+            }
+            function startWatcher() {
+                try {
+                    watcher = watch(filePath, scheduleRead);
+                }
+                catch {
+                    // file doesn't exist yet — poll until it appears
+                    pollInterval = setInterval(async () => {
+                        try {
+                            await fsp.stat(filePath);
+                            if (pollInterval)
+                                clearInterval(pollInterval);
+                            pollInterval = undefined;
+                            startWatcher();
+                            await readDelta();
+                        }
+                        catch { /* keep polling */ }
+                    }, 200);
+                    pollInterval?.unref?.();
+                }
+            }
+            startWatcher();
+            let currentPath = filePath;
+            rolloverInterval = setInterval(() => {
+                const newPath = activeLogFile(logDir);
+                if (newPath !== currentPath) {
+                    watcher?.close();
+                    currentPath = newPath;
+                    filePath = newPath;
+                    position = 0;
+                    leftover = "";
+                    startWatcher();
+                    void scheduleRead();
+                }
+            }, 60_000);
+            rolloverInterval?.unref?.();
+            opts.signal?.addEventListener("abort", finish);
+            if (opts.signal?.aborted)
+                finish();
+            return {
+                async next() {
+                    if (buffer.length)
+                        return { value: buffer.shift(), done: false };
+                    if (done)
+                        return { value: undefined, done: true };
+                    return new Promise((resolve) => { wakers.push(resolve); });
+                },
+                async return() {
+                    finish();
+                    return { value: undefined, done: true };
+                },
+            };
+        },
+    };
+}
+//# sourceMappingURL=log-tail.js.map

package/dist/lib/log-tail.js.map

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

package/dist/server.d.ts

@@ -21,4 +21,6 @@ export { generateSessionId, startSession, startSessionAsync, runWithLogContext,
 export { readLogs, getAvailableLogDates, getUniquePackages, getUniqueExecutionIds, getUniqueSessionIds, getUniqueReferences, } from './lib/log-reader.js';
 export type { Logger, LogLevel, LogData, LogEntry, LogContext, HazoLogConfig, PackageLoggerOptions, LogOrigin, } from './lib/types.js';
 export type { ReadLogsOptions, LogQueryResult } from './lib/log-reader.js';
+export { tailLogs } from "./lib/log-tail.js";
+export type { TailOptions } from "./lib/log-tail.js";
 //# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,aAAa,CAAC;AAGrB,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACtE,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAGpD,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,iBAAiB,EACjB,iBAAiB,EACjB,sBAAsB,EACtB,aAAa,EACb,WAAW,EACX,WAAW,GACZ,MAAM,8BAA8B,CAAC;AAGtC,OAAO,EACL,QAAQ,EACR,oBAAoB,EACpB,iBAAiB,EACjB,qBAAqB,EACrB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,qBAAqB,CAAC;AAG7B,YAAY,EACV,MAAM,EACN,QAAQ,EACR,OAAO,EACP,QAAQ,EACR,UAAU,EACV,aAAa,EACb,oBAAoB,EACpB,SAAS,GACV,MAAM,gBAAgB,CAAC;AAExB,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,aAAa,CAAC;AAGrB,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACtE,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAGpD,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,iBAAiB,EACjB,iBAAiB,EACjB,sBAAsB,EACtB,aAAa,EACb,WAAW,EACX,WAAW,GACZ,MAAM,8BAA8B,CAAC;AAGtC,OAAO,EACL,QAAQ,EACR,oBAAoB,EACpB,iBAAiB,EACjB,qBAAqB,EACrB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,qBAAqB,CAAC;AAG7B,YAAY,EACV,MAAM,EACN,QAAQ,EACR,OAAO,EACP,QAAQ,EACR,UAAU,EACV,aAAa,EACb,oBAAoB,EACpB,SAAS,GACV,MAAM,gBAAgB,CAAC;AAExB,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE3E,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/server.js

@@ -22,4 +22,5 @@ export { loadConfig } from './lib/config_loader.js';
 export { generateSessionId, startSession, startSessionAsync, runWithLogContext, runWithLogContextAsync, getLogContext, withSession, withContext, } from './lib/context/log-context.js';
 // Log reader (uses fs, readline)
 export { readLogs, getAvailableLogDates, getUniquePackages, getUniqueExecutionIds, getUniqueSessionIds, getUniqueReferences, } from './lib/log-reader.js';
+export { tailLogs } from "./lib/log-tail.js";
 //# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,aAAa,CAAC;AAErB,eAAe;AACf,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACtE,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEpD,uCAAuC;AACvC,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,iBAAiB,EACjB,iBAAiB,EACjB,sBAAsB,EACtB,aAAa,EACb,WAAW,EACX,WAAW,GACZ,MAAM,8BAA8B,CAAC;AAEtC,iCAAiC;AACjC,OAAO,EACL,QAAQ,EACR,oBAAoB,EACpB,iBAAiB,EACjB,qBAAqB,EACrB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,aAAa,CAAC;AAErB,eAAe;AACf,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACtE,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEpD,uCAAuC;AACvC,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,iBAAiB,EACjB,iBAAiB,EACjB,sBAAsB,EACtB,aAAa,EACb,WAAW,EACX,WAAW,GACZ,MAAM,8BAA8B,CAAC;AAEtC,iCAAiC;AACjC,OAAO,EACL,QAAQ,EACR,oBAAoB,EACpB,iBAAiB,EACjB,qBAAqB,EACrB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,qBAAqB,CAAC;AAgB7B,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/ui/api/log-stream-api-handler.d.ts

@@ -0,0 +1,14 @@
+import type { LogLevel } from "../../lib/types.js";
+export interface LogStreamApiOptions {
+    reference?: string[];
+    sessionId?: string[];
+    level?: LogLevel[];
+    package?: string[];
+    logDirectory?: string;
+}
+/**
+ * Returns a Web-API handler that streams tailLogs() output as Server-Sent Events.
+ * Honours the request's AbortSignal (closes the underlying watcher when the client disconnects).
+ */
+export declare function createLogStreamApiHandler(opts?: LogStreamApiOptions): (req: Request) => Promise<Response>;
+//# sourceMappingURL=log-stream-api-handler.d.ts.map

package/dist/ui/api/log-stream-api-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-stream-api-handler.d.ts","sourceRoot":"","sources":["../../../src/ui/api/log-stream-api-handler.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,MAAM,WAAW,mBAAmB;IAClC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,KAAK,CAAC,EAAE,QAAQ,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,GAAE,mBAAwB,IACxC,KAAK,OAAO,KAAG,OAAO,CAAC,QAAQ,CAAC,CA4C/D"}

package/dist/ui/api/log-stream-api-handler.js

@@ -0,0 +1,53 @@
+// NOTE: Intentionally NOT importing 'server-only' here, matching sibling
+// handlers (log-api-handler.ts, client-log-handler.ts). The server-only
+// guard lives at the aggregator (src/ui/server.ts) so this file can be
+// unit-tested directly under vitest.
+import { tailLogs } from "../../lib/log-tail.js";
+/**
+ * Returns a Web-API handler that streams tailLogs() output as Server-Sent Events.
+ * Honours the request's AbortSignal (closes the underlying watcher when the client disconnects).
+ */
+export function createLogStreamApiHandler(opts = {}) {
+    return async function handler(req) {
+        const ctrl = new AbortController();
+        req.signal.addEventListener("abort", () => ctrl.abort());
+        // Allow per-request overrides via query string.
+        const url = new URL(req.url);
+        const ref = url.searchParams.getAll("reference");
+        const sess = url.searchParams.getAll("sessionId");
+        const lvl = url.searchParams.getAll("level");
+        const pkg = url.searchParams.getAll("package");
+        const tailOpts = {
+            reference: ref.length ? ref : opts.reference,
+            sessionId: sess.length ? sess : opts.sessionId,
+            level: lvl.length ? lvl : opts.level,
+            package: pkg.length ? pkg : opts.package,
+            logDirectory: opts.logDirectory,
+            signal: ctrl.signal,
+        };
+        const encoder = new TextEncoder();
+        const stream = new ReadableStream({
+            async start(controller) {
+                try {
+                    for await (const entry of tailLogs(tailOpts)) {
+                        controller.enqueue(encoder.encode(`data: ${JSON.stringify(entry)}\n\n`));
+                    }
+                }
+                catch (err) {
+                    controller.enqueue(encoder.encode(`event: error\ndata: ${JSON.stringify({ error: String(err) })}\n\n`));
+                }
+                controller.close();
+            },
+            cancel() { ctrl.abort(); },
+        });
+        return new Response(stream, {
+            status: 200,
+            headers: {
+                "content-type": "text/event-stream",
+                "cache-control": "no-cache",
+                "connection": "keep-alive",
+            },
+        });
+    };
+}
+//# sourceMappingURL=log-stream-api-handler.js.map

package/dist/ui/api/log-stream-api-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-stream-api-handler.js","sourceRoot":"","sources":["../../../src/ui/api/log-stream-api-handler.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,wEAAwE;AACxE,uEAAuE;AACvE,qCAAqC;AACrC,OAAO,EAAE,QAAQ,EAAoB,MAAM,uBAAuB,CAAC;AAWnE;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CAAC,OAA4B,EAAE;IACtE,OAAO,KAAK,UAAU,OAAO,CAAC,GAAY;QACxC,MAAM,IAAI,GAAG,IAAI,eAAe,EAAE,CAAC;QACnC,GAAG,CAAC,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;QAEzD,gDAAgD;QAChD,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC7B,MAAM,GAAG,GAAG,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QACjD,MAAM,IAAI,GAAG,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QAClD,MAAM,GAAG,GAAG,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,OAAO,CAAe,CAAC;QAC3D,MAAM,GAAG,GAAG,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAE/C,MAAM,QAAQ,GAAgB;YAC5B,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS;YAC5C,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS;YAC9C,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK;YACpC,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO;YACxC,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,MAAM,EAAE,IAAI,CAAC,MAAM;SACpB,CAAC;QAEF,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;QAClC,MAAM,MAAM,GAAG,IAAI,cAAc,CAAa;YAC5C,KAAK,CAAC,KAAK,CAAC,UAAU;gBACpB,IAAI,CAAC;oBACH,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;wBAC7C,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;oBAC3E,CAAC;gBACH,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,uBAAuB,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;gBAC1G,CAAC;gBACD,UAAU,CAAC,KAAK,EAAE,CAAC;YACrB,CAAC;YACD,MAAM,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;SAC3B,CAAC,CAAC;QAEH,OAAO,IAAI,QAAQ,CAAC,MAAM,EAAE;YAC1B,MAAM,EAAE,GAAG;YACX,OAAO,EAAE;gBACP,cAAc,EAAE,mBAAmB;gBACnC,eAAe,EAAE,UAAU;gBAC3B,YAAY,EAAE,YAAY;aAC3B;SACF,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC"}

package/dist/ui/server.d.ts

@@ -9,6 +9,8 @@
 import 'server-only';
 export { createLogApiHandler } from './api/log-api-handler.js';
 export { createClientLogHandler } from './api/client-log-handler.js';
+export { createLogStreamApiHandler } from './api/log-stream-api-handler.js';
+export type { LogStreamApiOptions } from './api/log-stream-api-handler.js';
 export { withLogAuth } from './middleware/with-log-auth.js';
 export type { LogApiConfig, LogApiHandler, AuthCheckFn, } from './types.js';
 //# sourceMappingURL=server.d.ts.map

package/dist/ui/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/ui/server.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,aAAa,CAAC;AAGrB,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAGrE,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAG5D,YAAY,EACV,YAAY,EACZ,aAAa,EACb,WAAW,GACZ,MAAM,YAAY,CAAC"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/ui/server.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,aAAa,CAAC;AAGrB,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,yBAAyB,EAAE,MAAM,iCAAiC,CAAC;AAC5E,YAAY,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAG3E,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAG5D,YAAY,EACV,YAAY,EACZ,aAAa,EACb,WAAW,GACZ,MAAM,YAAY,CAAC"}

package/dist/ui/server.js

@@ -10,6 +10,7 @@ import 'server-only';
 // API Handlers
 export { createLogApiHandler } from './api/log-api-handler.js';
 export { createClientLogHandler } from './api/client-log-handler.js';
+export { createLogStreamApiHandler } from './api/log-stream-api-handler.js';
 // Middleware
 export { withLogAuth } from './middleware/with-log-auth.js';
 //# sourceMappingURL=server.js.map

package/dist/ui/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/ui/server.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,aAAa,CAAC;AAErB,eAAe;AACf,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAErE,aAAa;AACb,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC"}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/ui/server.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,aAAa,CAAC;AAErB,eAAe;AACf,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,yBAAyB,EAAE,MAAM,iCAAiC,CAAC;AAG5E,aAAa;AACb,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hazo_logs",
-  "version": "1.0.14",
+  "version": "1.1.0",
   "description": "Logger for hazo packages - Winston wrapper with singleton pattern",
   "type": "module",
   "main": "dist/index.js",