snugkv-nest 0.6.0 → 0.8.0

package/README.md

@@ -184,6 +184,20 @@ What is traced without any code:
 Options: `tracing: { http, ignorePaths, httpClient, stream, maxLen, batchSize, flushMs, maxBuffer, redact, maxAttrLength }`.
 Without Nest: `const tracer = new Tracer(client, { service: 'api' }); setTracer(tracer);`
 
+## Log shipping
+
+```ts
+SnugKvModule.forRoot({ url: 'snugkv://localhost:6383', service: 'ledger', logs: true });
+```
+
+Everything the app writes to stdout and stderr (Nest's logger, winston, pino, `console.log`, stack traces) is also written to the `snug:logs` stream. The terminal output does not change. The Logs page of the SnugKV console then shows the logs of every service in one place, with live tail, level and service filters and search.
+
+- Levels and contexts are read from Nest's console format, winston's `timestamp [Context] level: message`, JSON lines (`level`, `message`/`msg`, `context`) and `console.warn`/`console.error`. Anything else on stdout is `info`, on stderr `error`.
+- A line written inside a trace carries the trace id, so the console links it to the flow on the Traces page.
+- Lines are written in batches and kept in memory while the server is unreachable (newest 5,000). Shipping never throws into your code.
+
+Options (`logs: { … }`): `level` (lowest level shipped, default `debug`), `stream` (default `snug:logs`), `maxLen` (stream cap, default 100,000), `maxMessageLength` (default 8,000), `batchSize`, `flushMs`, `maxBuffer`, `instance` (default: host name). Without Nest: `captureLogs(new LogShipper(client, { service: 'worker' }))`.
+
 ## Service map
 
 Every app using `SnugKvModule` describes itself in SnugKV so tools can draw the whole system: the SnugKV console's **Map** page shows each service with its HTTP routes, the queues it adds jobs to and works on, and the topics it publishes and reads, connected into one picture. Nothing to write by hand.
@@ -200,6 +214,18 @@ The card is a JSON string at `snug:svc:<service>:<instance>`, refreshed every 15
 }
 ```
 
+The card also lists **dependencies**: things outside the app it uses or is called by. SnugKV is added by itself; declare the rest once at startup so the map shows the whole picture:
+
+```ts
+import { declareDependency } from 'snugkv-nest';
+
+declareDependency({ kind: 'mongodb', name: 'MongoDB', address: 'mongo:27017' });
+declareDependency({ kind: 'http', name: 'Alchemy', direction: 'in', routes: ['/api/evm/alchemy-webhook'] }); // calls us
+declareDependency({ kind: 'http', name: 'Alchemy', hosts: ['eth-sepolia.g.alchemy.com'] });             // we call it
+```
+
+or pass them as `serviceMap: { dependencies: [...] }`. Credentials in addresses are removed.
+
 Routes come from the app's controllers (with the global prefix). Queues and topics are recorded as they are used: registered with `SnugKvQueueModule`, added to, processed by a worker, published to or subscribed to. Turn it off with `serviceMap: false`. With `tracing: true` the Map page also draws what actually happens (traffic, errors, external hosts, databases) from the traces.
 
 ## Messaging (streams)

package/dist/core/index.d.ts

@@ -14,4 +14,5 @@ export * from './ratelimit';
 export * from './queue';
 export * from './trace';
 export * from './trace-http';
+export * from './logs';
 export * from './service-map';

package/dist/core/index.js

@@ -34,5 +34,6 @@ __exportStar(require("./ratelimit"), exports);
 __exportStar(require("./queue"), exports);
 __exportStar(require("./trace"), exports);
 __exportStar(require("./trace-http"), exports);
+__exportStar(require("./logs"), exports);
 __exportStar(require("./service-map"), exports);
 //# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,yCAAuB;AACvB,2CAA8E;AAArE,wGAAA,UAAU,OAAA;AAAE,6GAAA,eAAe,OAAA;AACpC,2CAAyB;AACzB,6CAA2B;AAC3B,8CAA4B;AAC5B,6CAA2B;AAC3B,wCAAsB;AACtB,+BAA6C;AAAzB,gGAAA,QAAQ,OAAA;AAC5B,2CAAyB;AACzB,uCAAqB;AACrB,0CAAwB;AACxB,yCAAuB;AACvB,8CAA4B;AAC5B,0CAAwB;AACxB,0CAAwB;AACxB,+CAA6B;AAC7B,gDAA8B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,yCAAuB;AACvB,2CAA8E;AAArE,wGAAA,UAAU,OAAA;AAAE,6GAAA,eAAe,OAAA;AACpC,2CAAyB;AACzB,6CAA2B;AAC3B,8CAA4B;AAC5B,6CAA2B;AAC3B,wCAAsB;AACtB,+BAA6C;AAAzB,gGAAA,QAAQ,OAAA;AAC5B,2CAAyB;AACzB,uCAAqB;AACrB,0CAAwB;AACxB,yCAAuB;AACvB,8CAA4B;AAC5B,0CAAwB;AACxB,0CAAwB;AACxB,+CAA6B;AAC7B,yCAAuB;AACvB,gDAA8B"}

package/dist/core/logs.d.ts

@@ -0,0 +1,97 @@
+import type { SnugKvClient } from './client';
+/**
+ * Log shipping: every line an app writes to stdout or stderr (Nest's logger,
+ * winston, pino, plain console.log) is also written to a SnugKV stream
+ * (`snug:logs`), so one console can show the logs of all services together.
+ *
+ * Lines keep going to the terminal unchanged. Levels and contexts are read
+ * from the common formats (Nest, winston, JSON lines); a line written inside
+ * a trace carries its trace id, so the console links the two.
+ */
+export type LogLevel = 'error' | 'warn' | 'info' | 'debug';
+/** One log line (or one multi-line entry, such as an error with its stack). */
+export interface LogRecord {
+    /** Time, ms since epoch. */
+    ts: number;
+    service: string;
+    instance: string;
+    level: LogLevel;
+    /** Nest/winston context (the class name in `[TokenService]`), if any. */
+    context?: string;
+    message: string;
+    traceId?: string;
+    spanId?: string;
+}
+export interface LogShipperOptions {
+    /** Name of this app, shown on every line. */
+    service: string;
+    /** This process (default: host name, the container id in Docker). */
+    instance?: string;
+    /** Stream the lines go to (default `snug:logs`). */
+    stream?: string;
+    /** Approximate cap on the stream length (default 100,000). */
+    maxLen?: number;
+    /** Lowest level shipped (default `debug`, i.e. everything). */
+    level?: LogLevel;
+    /** Write after this many lines are buffered (default 200). */
+    batchSize?: number;
+    /** Write buffered lines at least this often, ms (default 500). */
+    flushMs?: number;
+    /** Lines kept while the server is unreachable; older ones are dropped (default 5,000). */
+    maxBuffer?: number;
+    /** Longest message kept (default 8,000 characters). */
+    maxMessageLength?: number;
+    /** Called when lines cannot be written. Shipping never throws into your code. */
+    onError?: (err: unknown) => void;
+}
+export declare class LogShipper {
+    private readonly client;
+    readonly service: string;
+    readonly instance: string;
+    readonly stream: string;
+    private readonly maxLen;
+    private readonly minRank;
+    private readonly batchSize;
+    private readonly maxBuffer;
+    private readonly maxMessageLength;
+    private readonly onError;
+    private buffer;
+    private timer;
+    private flushing;
+    constructor(client: Pick<SnugKvClient, 'pipeline'>, options: LogShipperOptions);
+    /** Queues one line. Lines below the configured level are dropped. */
+    ship(line: Omit<LogRecord, 'service' | 'instance' | 'ts'> & {
+        ts?: number;
+    }): void;
+    /** Writes buffered lines now. Resolves when they are written (or kept for later on error). */
+    flush(): Promise<void>;
+    /** Flushes and stops the timer. */
+    close(): Promise<void>;
+}
+export declare function toLevel(word: string | number | undefined, fallback?: LogLevel): LogLevel;
+export interface ParsedLine {
+    level: LogLevel;
+    context?: string;
+    message: string;
+    /** Time written in the line itself, if it had one. */
+    ts?: number;
+}
+/**
+ * Level, context and message of one formatted entry. `fallback` is the level
+ * when the line does not say (from the console method or the output stream).
+ */
+export declare function parseLogLine(raw: string, fallback?: LogLevel): ParsedLine;
+/**
+ * Splits one write into entries. A write is usually one entry (several lines
+ * only for a stack or a printed object); it is split only where a line starts
+ * a new entry of a known format.
+ */
+export declare function splitEntries(chunk: string): string[];
+/** The shipper installed by {@link captureLogs}, if any. */
+export declare function getLogShipper(): LogShipper | undefined;
+/**
+ * Copies everything the process writes to stdout and stderr to `shipper`
+ * (the terminal output is unchanged). Returns a function that undoes it.
+ * Installing again replaces the previous capture.
+ */
+export declare function captureLogs(shipper: LogShipper): () => void;

package/dist/core/logs.js

@@ -0,0 +1,310 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LogShipper = void 0;
+exports.toLevel = toLevel;
+exports.parseLogLine = parseLogLine;
+exports.splitEntries = splitEntries;
+exports.getLogShipper = getLogShipper;
+exports.captureLogs = captureLogs;
+const node_os_1 = require("node:os");
+const trace_1 = require("./trace");
+const LEVEL_RANK = { error: 0, warn: 1, info: 2, debug: 3 };
+class LogShipper {
+    client;
+    service;
+    instance;
+    stream;
+    maxLen;
+    minRank;
+    batchSize;
+    maxBuffer;
+    maxMessageLength;
+    onError;
+    buffer = [];
+    timer;
+    flushing;
+    constructor(client, options) {
+        this.client = client;
+        this.service = options.service;
+        this.instance = options.instance ?? (0, node_os_1.hostname)();
+        this.stream = options.stream ?? 'snug:logs';
+        this.maxLen = options.maxLen ?? 100_000;
+        this.minRank = LEVEL_RANK[options.level ?? 'debug'];
+        this.batchSize = options.batchSize ?? 200;
+        this.maxBuffer = options.maxBuffer ?? 5_000;
+        this.maxMessageLength = options.maxMessageLength ?? 8_000;
+        this.onError = options.onError ?? (() => undefined);
+        this.timer = setInterval(() => void this.flush(), options.flushMs ?? 500);
+        this.timer.unref?.();
+    }
+    /** Queues one line. Lines below the configured level are dropped. */
+    ship(line) {
+        if (LEVEL_RANK[line.level] > this.minRank)
+            return;
+        const message = line.message.length > this.maxMessageLength ? `${line.message.slice(0, this.maxMessageLength)}…` : line.message;
+        this.buffer.push({ ...line, message, ts: line.ts ?? Date.now(), service: this.service, instance: this.instance });
+        if (this.buffer.length > this.maxBuffer)
+            this.buffer.splice(0, this.buffer.length - this.maxBuffer);
+        if (this.buffer.length >= this.batchSize)
+            void this.flush();
+    }
+    /** Writes buffered lines now. Resolves when they are written (or kept for later on error). */
+    async flush() {
+        if (this.flushing)
+            return this.flushing;
+        if (!this.buffer.length)
+            return;
+        const batch = this.buffer;
+        this.buffer = [];
+        const commands = batch.map((l) => [
+            'XADD', this.stream, 'MAXLEN', '~', this.maxLen, '*',
+            'ts', String(l.ts),
+            'service', l.service,
+            'instance', l.instance,
+            'level', l.level,
+            'message', l.message,
+            ...(l.context ? ['context', l.context] : []),
+            ...(l.traceId ? ['traceId', l.traceId] : []),
+            ...(l.spanId ? ['spanId', l.spanId] : []),
+        ]);
+        this.flushing = this.client
+            .pipeline(commands)
+            .then(() => undefined)
+            .catch((err) => {
+            // Put the batch back (newest kept) so a short outage loses nothing.
+            this.buffer = [...batch, ...this.buffer].slice(-this.maxBuffer);
+            this.onError(err);
+        })
+            .finally(() => {
+            this.flushing = undefined;
+        });
+        return this.flushing;
+    }
+    /** Flushes and stops the timer. */
+    async close() {
+        if (this.timer)
+            clearInterval(this.timer);
+        this.timer = undefined;
+        await this.flush();
+        if (this.buffer.length)
+            await this.flush();
+    }
+}
+exports.LogShipper = LogShipper;
+// ----- reading levels and contexts out of formatted lines
+const ANSI = /\x1b\[[0-9;]*[A-Za-z]/g;
+// [Nest] 12  - 10/16/2026, 6:19:00 AM     LOG [RouterExplorer] Mapped {/api, GET} route +2ms
+const NEST = /^\[Nest\]\s+\d+\s+-\s+.*?\s{2,}(LOG|ERROR|WARN|DEBUG|VERBOSE|FATAL)\s+(?:\[([^\]]+)\]\s+)?([\s\S]*)$/;
+// 2026-10-15T15:24:40.947Z [TokenService] info: Using network: testnet +8ms
+const WINSTON = /^(\d{4}-\d\d-\d\d[T ][\d:.]+Z?)\s+(?:\[([^\]]+)\]\s+)?(error|warn|warning|info|http|verbose|debug|silly):\s?([\s\S]*)$/i;
+// [warn] something / warn: something / WARN something (not "Error handling…")
+const LEADING_TAG = /^(?:\[(error|err|fatal|warn|warning|info|debug|trace|verbose)\]:?|(error|err|fatal|warn|warning|info|debug|trace|verbose):)\s+([\s\S]*)$/i;
+const LEADING_UPPER = /^(ERROR|ERR|FATAL|WARN|WARNING|INFO|DEBUG|TRACE|VERBOSE)\s+([\s\S]*)$/;
+const NEST_MS = /\s\+\d+ms$/;
+function toLevel(word, fallback = 'info') {
+    if (typeof word === 'number') {
+        // pino / bunyan numeric levels
+        if (word >= 50)
+            return 'error';
+        if (word >= 40)
+            return 'warn';
+        if (word >= 30)
+            return 'info';
+        return 'debug';
+    }
+    switch ((word ?? '').toLowerCase()) {
+        case 'error':
+        case 'err':
+        case 'fatal':
+        case 'crit':
+        case 'critical':
+        case 'emerg':
+        case 'alert':
+            return 'error';
+        case 'warn':
+        case 'warning':
+            return 'warn';
+        case 'info':
+        case 'log':
+        case 'http':
+        case 'notice':
+            return 'info';
+        case 'debug':
+        case 'verbose':
+        case 'silly':
+        case 'trace':
+            return 'debug';
+        default:
+            return fallback;
+    }
+}
+/**
+ * Level, context and message of one formatted entry. `fallback` is the level
+ * when the line does not say (from the console method or the output stream).
+ */
+function parseLogLine(raw, fallback = 'info') {
+    const text = raw.replace(ANSI, '').replace(/\s+$/, '');
+    const first = text.trimStart();
+    if (first.startsWith('{') && first.endsWith('}')) {
+        try {
+            const j = JSON.parse(first);
+            const msg = j.message ?? j.msg;
+            if (typeof msg === 'string') {
+                const ctx = j.context ?? j.ctx ?? j.name;
+                const time = typeof j.time === 'number' ? j.time : typeof j.timestamp === 'string' ? Date.parse(j.timestamp) : NaN;
+                const out = { level: toLevel(j.level, fallback), message: msg };
+                if (typeof ctx === 'string' && ctx)
+                    out.context = ctx;
+                if (Number.isFinite(time))
+                    out.ts = time;
+                if (typeof j.stack === 'string' && !msg.includes(j.stack))
+                    out.message = `${msg}\n${j.stack}`;
+                return out;
+            }
+        }
+        catch {
+            /* not JSON after all */
+        }
+    }
+    let m = NEST.exec(text);
+    if (m) {
+        const out = { level: toLevel(m[1], fallback), message: m[3].replace(NEST_MS, '') };
+        if (m[2])
+            out.context = m[2];
+        return out;
+    }
+    m = WINSTON.exec(text);
+    if (m) {
+        const out = { level: toLevel(m[3], fallback), message: m[4].replace(NEST_MS, '') };
+        if (m[2])
+            out.context = m[2];
+        const ts = Date.parse(m[1]);
+        if (Number.isFinite(ts))
+            out.ts = ts;
+        return out;
+    }
+    m = LEADING_TAG.exec(text);
+    if (m)
+        return { level: toLevel(m[1] ?? m[2], fallback), message: m[3] };
+    m = LEADING_UPPER.exec(text);
+    if (m)
+        return { level: toLevel(m[1], fallback), message: m[2] };
+    return { level: fallback, message: text };
+}
+/** True when a line starts a new entry in one of the known formats. */
+function startsEntry(line) {
+    const t = line.replace(ANSI, '');
+    return NEST.test(t) || WINSTON.test(t) || (t.startsWith('{') && t.trimEnd().endsWith('}'));
+}
+/**
+ * Splits one write into entries. A write is usually one entry (several lines
+ * only for a stack or a printed object); it is split only where a line starts
+ * a new entry of a known format.
+ */
+function splitEntries(chunk) {
+    const lines = chunk.replace(/\r\n/g, '\n').split('\n');
+    const out = [];
+    for (const line of lines) {
+        if (out.length > 0 && startsEntry(line))
+            out.push(line);
+        else if (out.length === 0)
+            out.push(line);
+        else
+            out[out.length - 1] += `\n${line}`;
+    }
+    return out.map((e) => e.replace(/\s+$/, '')).filter((e) => e.replace(ANSI, '').trim() !== '');
+}
+let installed;
+/** The shipper installed by {@link captureLogs}, if any. */
+function getLogShipper() {
+    return installed?.shipper;
+}
+/**
+ * Copies everything the process writes to stdout and stderr to `shipper`
+ * (the terminal output is unchanged). Returns a function that undoes it.
+ * Installing again replaces the previous capture.
+ */
+function captureLogs(shipper) {
+    installed?.restore();
+    // The console method being run, so console.warn lines are warnings even
+    // when the format does not say so.
+    let methodLevel;
+    let inside = false;
+    const handle = (chunk, encoding, fallback) => {
+        if (inside)
+            return;
+        inside = true;
+        try {
+            const text = typeof chunk === 'string' ? chunk : Buffer.isBuffer(chunk) || chunk instanceof Uint8Array ? Buffer.from(chunk).toString(typeof encoding === 'string' ? encoding : 'utf8') : '';
+            if (!text)
+                return;
+            const trace = (0, trace_1.currentTrace)();
+            for (const entry of splitEntries(text)) {
+                const p = parseLogLine(entry, methodLevel ?? fallback);
+                shipper.ship({
+                    level: p.level,
+                    message: p.message,
+                    ...(p.context ? { context: p.context } : {}),
+                    ...(p.ts ? { ts: p.ts } : {}),
+                    ...(trace ? { traceId: trace.traceId, spanId: trace.spanId } : {}),
+                });
+            }
+        }
+        catch {
+            /* never break the app's output */
+        }
+        finally {
+            inside = false;
+        }
+    };
+    const wrap = (stream, fallback) => {
+        const original = stream.write;
+        const patched = function (chunk, encoding, cb) {
+            handle(chunk, encoding, fallback);
+            return original.call(this, chunk, encoding, cb);
+        };
+        stream.write = patched;
+        return () => {
+            if (stream.write === patched)
+                stream.write = original;
+        };
+    };
+    const consoleLevels = [
+        ['log', 'info'],
+        ['info', 'info'],
+        ['debug', 'debug'],
+        ['warn', 'warn'],
+        ['error', 'error'],
+        ['trace', 'debug'],
+    ];
+    const restoreConsole = consoleLevels.map(([method, level]) => {
+        const original = console[method];
+        const patched = function (...args) {
+            const prev = methodLevel;
+            methodLevel = level;
+            try {
+                return original.apply(this, args);
+            }
+            finally {
+                methodLevel = prev;
+            }
+        };
+        console[method] = patched;
+        return () => {
+            if (console[method] === patched)
+                console[method] = original;
+        };
+    });
+    const restoreOut = wrap(process.stdout, 'info');
+    const restoreErr = wrap(process.stderr, 'error');
+    const restore = () => {
+        restoreOut();
+        restoreErr();
+        restoreConsole.forEach((r) => r());
+        if (installed?.restore === restore)
+            installed = undefined;
+    };
+    installed = { shipper, restore };
+    return restore;
+}
+//# sourceMappingURL=logs.js.map

package/dist/core/logs.js.map

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

package/dist/core/service-map.d.ts

@@ -15,6 +15,23 @@ export interface ServiceRoute {
     /** `Controller.method` */
     handler?: string;
 }
+/**
+ * Something outside the app that it depends on or that calls it: a database,
+ * SnugKV itself, a third-party API, a webhook provider.
+ */
+export interface ServiceDependency {
+    /** `snugkv`, `mongodb`, `postgres`, `redis`, `http`, … */
+    kind: string;
+    /** Shown on the map, e.g. `MongoDB`, `Alchemy`. */
+    name: string;
+    /** `host:port` or a host name; never credentials. */
+    address?: string;
+    /** `out` (default): the app calls it. `in`: it calls the app (webhooks). */
+    direction?: 'in' | 'out';
+    /** For `in`: the routes it calls. For `out` HTTP APIs: host names it is reached at. */
+    routes?: string[];
+    hosts?: string[];
+}
 export interface ServiceCard {
     service: string;
     instance: string;
@@ -40,7 +57,15 @@ export interface ServiceCard {
             group?: string;
         }>;
     };
+    dependencies: ServiceDependency[];
 }
+/**
+ * Adds something this app uses or is called by to its service card, for the
+ * console's map: `declareDependency({ kind: 'mongodb', name: 'MongoDB', address: 'mongo:27017' })`,
+ * `declareDependency({ kind: 'http', name: 'Alchemy', direction: 'in', routes: ['/api/webhooks/alchemy'] })`.
+ * Declaring the same kind and name again replaces it.
+ */
+export declare function declareDependency(dep: ServiceDependency): void;
 /** @internal Called by Queue.add, registered queues and FlowProducer. */
 export declare function noteQueueProducer(queue: string): void;
 /** @internal Called when a Worker starts. */

package/dist/core/service-map.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ServiceCardReporter = exports.SERVICE_CARD_PREFIX = void 0;
+exports.declareDependency = declareDependency;
 exports.noteQueueProducer = noteQueueProducer;
 exports.noteQueueWorker = noteQueueWorker;
 exports.notePublish = notePublish;
@@ -23,7 +24,18 @@ const seen = {
     processes: new Map(),
     publishes: new Set(),
     subscribes: new Map(),
+    dependencies: new Map(),
 };
+/**
+ * Adds something this app uses or is called by to its service card, for the
+ * console's map: `declareDependency({ kind: 'mongodb', name: 'MongoDB', address: 'mongo:27017' })`,
+ * `declareDependency({ kind: 'http', name: 'Alchemy', direction: 'in', routes: ['/api/webhooks/alchemy'] })`.
+ * Declaring the same kind and name again replaces it.
+ */
+function declareDependency(dep) {
+    const address = dep.address?.replace(/\/\/[^@/]*@/, '//').replace(/^[^@/]*@/, '');
+    seen.dependencies.set(`${dep.kind}\u0000${dep.name}\u0000${dep.direction ?? 'out'}`, { ...dep, address });
+}
 /** @internal Called by Queue.add, registered queues and FlowProducer. */
 function noteQueueProducer(queue) {
     seen.produces.add(queue);
@@ -46,6 +58,7 @@ function resetServiceMap() {
     seen.processes.clear();
     seen.publishes.clear();
     seen.subscribes.clear();
+    seen.dependencies.clear();
 }
 /** Writes this process's card until stopped. Never throws into the app. */
 class ServiceCardReporter {
@@ -80,6 +93,7 @@ class ServiceCardReporter {
                 publishes: [...seen.publishes].sort(),
                 subscribes: [...seen.subscribes].map(([topic, group]) => ({ topic, group })).sort((a, b) => a.topic.localeCompare(b.topic)),
             },
+            dependencies: [...seen.dependencies.values()],
         };
     }
     /** Writes the card now. */

package/dist/core/service-map.js.map

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

package/dist/nest/module.d.ts

@@ -2,6 +2,8 @@ import { DynamicModule, InjectionToken, ModuleMetadata, OptionalFactoryDependenc
 import { SnugKvBusOptions } from '../core/bus';
 import { CacheOptions } from '../core/cache';
 import { TracerOptions } from '../core/trace';
+import { LogShipperOptions } from '../core/logs';
+import type { ServiceDependency } from '../core/service-map';
 export interface SnugKvModuleOptions extends Omit<SnugKvBusOptions, 'service'> {
     /** Name of this app. Needed for messaging (default consumer group); defaults to `app`. */
     service?: string;
@@ -29,8 +31,18 @@ export interface SnugKvModuleOptions extends Omit<SnugKvBusOptions, 'service'> {
      * Describe this app in SnugKV (`snug:svc:<service>:<instance>`): its HTTP
      * routes, queues and topics, for the console's Map page. Default true.
      */
-    serviceMap?: boolean;
+    serviceMap?: boolean | {
+        dependencies?: ServiceDependency[];
+    };
+    /**
+     * Log shipping: everything the app writes to stdout and stderr (Nest's
+     * logger, winston, console.log) also goes to the `snug:logs` stream, where
+     * the console shows the logs of all services together. Terminal output is
+     * unchanged. Off by default.
+     */
+    logs?: boolean | SnugLogsOptions;
 }
+export type SnugLogsOptions = Omit<LogShipperOptions, 'service'>;
 export interface SnugTracingOptions extends Omit<TracerOptions, 'service'> {
     /** Make every incoming HTTP request a trace (default true). */
     http?: boolean;

package/dist/nest/module.js

@@ -18,6 +18,7 @@ const flow_1 = require("../core/queue/flow");
 const pubsub_1 = require("../core/pubsub");
 const ratelimit_1 = require("../core/ratelimit");
 const trace_1 = require("../core/trace");
+const logs_1 = require("../core/logs");
 const trace_http_1 = require("../core/trace-http");
 const trace_interceptor_1 = require("./trace-interceptor");
 const runtime_1 = require("./runtime");
@@ -35,7 +36,7 @@ const sharedProviders = [
     {
         provide: bus_1.SnugKvBus,
         useFactory: (options) => {
-            const { isGlobal, autoSubscribe, autoProcess, queuePrefix, cache, lockPrefix, rateLimitPrefix, service, tracing, serviceMap, ...bus } = options;
+            const { isGlobal, autoSubscribe, autoProcess, queuePrefix, cache, lockPrefix, rateLimitPrefix, service, tracing, serviceMap, logs, ...bus } = options;
             return new bus_1.SnugKvBus({ logger: nestLogger(), service: service ?? 'app', ...bus });
         },
         inject: [tokens_1.SNUG_OPTIONS],
@@ -87,11 +88,35 @@ const sharedProviders = [
         },
         inject: [client_1.SnugKvClient, tokens_1.SNUG_OPTIONS],
     },
+    {
+        // Null when log shipping is off; inject it with @Optional().
+        provide: logs_1.LogShipper,
+        useFactory: (client, o) => {
+            if (!o.logs)
+                return null;
+            const out = process.stderr.write.bind(process.stderr);
+            let warned = 0;
+            const shipper = new logs_1.LogShipper(client, {
+                // Written past the capture, so a failing write cannot loop.
+                onError: (e) => {
+                    if (Date.now() - warned > 60_000) {
+                        warned = Date.now();
+                        out(`[SnugKV] log lines not written: ${e instanceof Error ? e.message : String(e)}\n`);
+                    }
+                },
+                ...(o.logs === true ? {} : o.logs),
+                service: o.service ?? 'app',
+            });
+            (0, logs_1.captureLogs)(shipper);
+            return shipper;
+        },
+        inject: [client_1.SnugKvClient, tokens_1.SNUG_OPTIONS],
+    },
     // Passes requests straight through unless tracing (and its `http` option) is on.
     { provide: core_1.APP_INTERCEPTOR, useClass: trace_interceptor_1.TraceInterceptor },
     runtime_1.SnugKvRuntime,
 ];
-const exported = [bus_1.SnugKvBus, client_1.SnugKvClient, pubsub_1.SnugKvSubscriber, cache_1.SnugKvCache, lock_1.SnugKvLocks, ratelimit_1.SnugKvRateLimiter, flow_1.FlowProducer, trace_1.Tracer];
+const exported = [bus_1.SnugKvBus, client_1.SnugKvClient, pubsub_1.SnugKvSubscriber, cache_1.SnugKvCache, lock_1.SnugKvLocks, ratelimit_1.SnugKvRateLimiter, flow_1.FlowProducer, trace_1.Tracer, logs_1.LogShipper];
 let SnugKvModule = SnugKvModule_1 = class SnugKvModule {
     static forRoot(options) {
         return {

package/dist/nest/module.js.map

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

package/dist/nest/runtime.js

@@ -17,9 +17,11 @@ const common_1 = require("@nestjs/common");
 const constants_1 = require("@nestjs/common/constants");
 const core_1 = require("@nestjs/core");
 const service_map_1 = require("../core/service-map");
+const util_1 = require("../core/util");
 const bus_1 = require("../core/bus");
 const worker_1 = require("../core/queue/worker");
 const trace_1 = require("../core/trace");
+const logs_1 = require("../core/logs");
 const explorer_1 = require("./explorer");
 const tokens_1 = require("./tokens");
 /**
@@ -75,6 +77,22 @@ let SnugKvRuntime = class SnugKvRuntime {
             }
         }
         if (this.options.serviceMap !== false) {
+            // SnugKV itself is always a dependency.
+            let address;
+            try {
+                if (this.options.url) {
+                    const u = (0, util_1.parseUrl)(this.options.url);
+                    address = `${u.host}:${u.port}`;
+                }
+                else if (this.options.host)
+                    address = `${this.options.host}:${this.options.port ?? 6379}`;
+            }
+            catch {
+                /* unusual URL: leave the address out */
+            }
+            (0, service_map_1.declareDependency)({ kind: 'snugkv', name: 'SnugKV', address });
+            for (const d of (typeof this.options.serviceMap === 'object' ? this.options.serviceMap.dependencies : undefined) ?? [])
+                (0, service_map_1.declareDependency)(d);
             this.card = new service_map_1.ServiceCardReporter(this.bus.client, { service: this.bus.service, instance: this.bus.instance, http: this.routes() });
             this.card.start();
         }
@@ -122,6 +140,9 @@ let SnugKvRuntime = class SnugKvRuntime {
             await tracer.close().catch(() => undefined);
             (0, trace_1.setTracer)(undefined);
         }
+        // Last, so the shutdown lines above are shipped too. Capture stays on
+        // until the process exits; lines after this are dropped quietly.
+        await (0, logs_1.getLogShipper)()?.close().catch(() => undefined);
         await this.bus.close();
         this.subscriptions = [];
     }

package/dist/nest/runtime.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "snugkv-nest",
-  "version": "0.6.0",
+  "version": "0.8.0",
   "description": "NestJS module and TypeScript client for SnugKV: data types, cache, locks, rate limits, pub/sub, transactions, job queues, flow tracing and a durable stream message bus.",
   "keywords": [
     "nestjs",