@ketvietlab/ketjs 0.1.2 → 0.1.3

package/dist/server/jobs.js

@@ -1,6 +1,6 @@
 // Job declarations are data in the manifest and executable handlers in this
 // process. Keeping the two joined by one qualified key mirrors server functions
-// while allowing `ket worker` to load the same AppSpec without booting HTTP.
+// while allowing `ket worker` to load the same DeploymentSpec without booting HTTP.
 import { KetError } from '../kernel/errors.js';
 const registry = new Map();
 export function defineJob(spec) {

package/dist/server/jobs.js.map

@@ -1 +1 @@
-{"version":3,"file":"jobs.js","sourceRoot":"","sources":["../../../../../../packages/ketjs/src/server/jobs.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,gFAAgF;AAChF,6EAA6E;AAE7E,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AAG9C,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAmB,CAAA;AAE3C,MAAM,UAAU,SAAS,CAAC,IAAa;IACrC,IAAI,IAAI,CAAC,UAAU,KAAK,IAAI;QAC1B,MAAM,IAAI,QAAQ,CAAC;YACjB,IAAI,EAAE,sBAAsB;YAC5B,OAAO,EAAE,yEAAyE;SACnF,CAAC,CAAA;IACJ,IAAI,OAAO,IAAI,CAAC,OAAO,KAAK,UAAU;QACpC,MAAM,IAAI,QAAQ,CAAC,EAAE,IAAI,EAAE,kBAAkB,EAAE,OAAO,EAAE,gCAAgC,EAAE,CAAC,CAAA;IAC7F,OAAO,IAAI,CAAA;AACb,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,OAAoB;IAC/C,QAAQ,CAAC,KAAK,EAAE,CAAA;IAChB,KAAK,MAAM,MAAM,IAAI,OAAO;QAC1B,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC;YAAE,QAAQ,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,IAAI,IAAI,IAAI,EAAE,EAAE,IAAI,CAAC,CAAA;IACtG,OAAO,QAAQ,CAAA;AACjB,CAAC;AAED,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,GAAW,EAAkB,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,CAAA"}
+{"version":3,"file":"jobs.js","sourceRoot":"","sources":["../../../../../../packages/ketjs/src/server/jobs.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,gFAAgF;AAChF,oFAAoF;AAEpF,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AAG9C,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAmB,CAAA;AAE3C,MAAM,UAAU,SAAS,CAAC,IAAa;IACrC,IAAI,IAAI,CAAC,UAAU,KAAK,IAAI;QAC1B,MAAM,IAAI,QAAQ,CAAC;YACjB,IAAI,EAAE,sBAAsB;YAC5B,OAAO,EAAE,yEAAyE;SACnF,CAAC,CAAA;IACJ,IAAI,OAAO,IAAI,CAAC,OAAO,KAAK,UAAU;QACpC,MAAM,IAAI,QAAQ,CAAC,EAAE,IAAI,EAAE,kBAAkB,EAAE,OAAO,EAAE,gCAAgC,EAAE,CAAC,CAAA;IAC7F,OAAO,IAAI,CAAA;AACb,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,OAAoB;IAC/C,QAAQ,CAAC,KAAK,EAAE,CAAA;IAChB,KAAK,MAAM,MAAM,IAAI,OAAO;QAC1B,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC;YAAE,QAAQ,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,IAAI,IAAI,IAAI,EAAE,EAAE,IAAI,CAAC,CAAA;IACtG,OAAO,QAAQ,CAAA;AACjB,CAAC;AAED,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,GAAW,EAAkB,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,CAAA"}

package/dist/server/log/combinators.d.ts

@@ -0,0 +1,42 @@
+import type { LogDriver, LogLevel } from './types.ts';
+/**
+ * Fan out to several sinks.
+ *
+ * A driver that throws must not stop the drivers after it, so this catches as a
+ * last resort. It reports nothing: wrap the risky driver in `isolatedLog` when a
+ * failure should be visible rather than merely survivable.
+ */
+export declare function multiLog(drivers: readonly LogDriver[]): LogDriver;
+/** Drop anything below `min`. Cheapest when it is the outermost wrapper. */
+export declare function leveledLog(driver: LogDriver, min: LogLevel): LogDriver;
+/**
+ * Batch, with a bound on memory and a visible gap when that bound is reached.
+ *
+ * Newest is dropped rather than oldest: in a cascade the first failure is the
+ * cause and the tail is repetition. A slice of the bound is reserved for
+ * error-level records, so a flood of `info` can never bury the errors explaining
+ * it. Whatever is dropped is announced — a silent gap in a log is worse than a
+ * gap, because it cannot be distinguished from nothing having happened.
+ */
+export declare function bufferedLog(driver: LogDriver, options?: {
+    max?: number;
+    everyMs?: number;
+    errorReserve?: number;
+    batch?: number;
+}): LogDriver;
+/**
+ * Swallow a driver's failures, and say so exactly once.
+ *
+ * Once, because a sink that fails usually fails for every record, and a fallback
+ * flooded with reports of the first sink's failure is a second outage.
+ */
+export declare function isolatedLog(driver: LogDriver, fallback?: LogDriver): LogDriver;
+/**
+ * The mandatory outermost wrapper, applied by the runtime and not optional.
+ *
+ * The type system already refuses a non-scalar field, which stops the common way a
+ * customer payload reaches an aggregator. This handles what the type system cannot
+ * see: values arriving from JavaScript callers, and from `catch (e)`.
+ */
+export declare function redactLog(driver: LogDriver): LogDriver;
+//# sourceMappingURL=combinators.d.ts.map

package/dist/server/log/combinators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"combinators.d.ts","sourceRoot":"","sources":["../../../../../../packages/ketjs/src/server/log/combinators.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAa,QAAQ,EAAa,MAAM,YAAY,CAAA;AA0B3E;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,SAAS,SAAS,EAAE,GAAG,SAAS,CA2BjE;AAED,4EAA4E;AAC5E,wBAAgB,UAAU,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,QAAQ,GAAG,SAAS,CAUtE;AAaD;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,SAAS,EACjB,OAAO,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GACtF,SAAS,CAgEX;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,CAAC,EAAE,SAAS,GAAG,SAAS,CAgD9E;AA0BD;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,CAqBtD"}

package/dist/server/log/combinators.js

@@ -0,0 +1,270 @@
+// Drivers stay primitive; behaviour is composed. This is where "several drivers"
+// actually lives, so that a fan-out, a level filter, a bound on memory and an
+// isolation boundary are four small things that can be reasoned about separately
+// rather than four flags on every driver.
+import { atLeast } from './types.js';
+/** Keys whose value is never worth the risk, matched as a lower-case substring. */
+const DENY = [
+    'password',
+    'passwd',
+    'secret',
+    'token',
+    'authorization',
+    'cookie',
+    'apikey',
+    'api_key',
+    'privatekey',
+    'private_key',
+    'credential',
+    'card',
+    'cvv',
+    'ssn',
+    'otp',
+    'pin',
+];
+const VALUE_MAX = 512;
+const MESSAGE_MAX = 1_000;
+/**
+ * Fan out to several sinks.
+ *
+ * A driver that throws must not stop the drivers after it, so this catches as a
+ * last resort. It reports nothing: wrap the risky driver in `isolatedLog` when a
+ * failure should be visible rather than merely survivable.
+ */
+export function multiLog(drivers) {
+    return {
+        name: `multi(${drivers.map((d) => d.name).join(',')})`,
+        write(records) {
+            for (const driver of drivers) {
+                try {
+                    driver.write(records);
+                }
+                catch {
+                    /* a sink is never allowed to break the work it is describing */
+                }
+            }
+        },
+        async flush() {
+            for (const driver of drivers) {
+                try {
+                    await driver.flush?.();
+                }
+                catch { }
+            }
+        },
+        async close() {
+            for (const driver of drivers) {
+                try {
+                    await driver.close?.();
+                }
+                catch { }
+            }
+        },
+    };
+}
+/** Drop anything below `min`. Cheapest when it is the outermost wrapper. */
+export function leveledLog(driver, min) {
+    return {
+        name: `leveled(${driver.name},${min})`,
+        write(records) {
+            const kept = records.filter((r) => atLeast(r.level, min));
+            if (kept.length)
+                driver.write(kept);
+        },
+        flush: driver.flush ? () => driver.flush() : undefined,
+        close: driver.close ? () => driver.close() : undefined,
+    };
+}
+const dropNotice = (like, count, sinceMs, reason) => ({
+    at: new Date().toISOString(),
+    level: 'warn',
+    event: 'log_dropped',
+    deployment: like.deployment,
+    process: like.process,
+    tenant: null,
+    trace: null,
+    fields: { count, sinceMs, reason },
+});
+/**
+ * Batch, with a bound on memory and a visible gap when that bound is reached.
+ *
+ * Newest is dropped rather than oldest: in a cascade the first failure is the
+ * cause and the tail is repetition. A slice of the bound is reserved for
+ * error-level records, so a flood of `info` can never bury the errors explaining
+ * it. Whatever is dropped is announced — a silent gap in a log is worse than a
+ * gap, because it cannot be distinguished from nothing having happened.
+ */
+export function bufferedLog(driver, options = {}) {
+    const max = Math.max(1, options.max ?? 10_000);
+    const everyMs = Math.max(1, options.everyMs ?? 1_000);
+    const reserve = Math.min(0.9, Math.max(0, options.errorReserve ?? 0.25));
+    const softMax = Math.max(1, Math.floor(max * (1 - reserve)));
+    // Batching exists to amortise I/O, not to hold records back, and a few hundred
+    // already amortises it. Waiting for the bound instead would mean a burst inside
+    // one interval gets dropped by a buffer the sink could have drained twice over.
+    const batch = Math.max(1, Math.min(options.batch ?? 512, max));
+    let queue = [];
+    let dropped = 0;
+    let droppedSince = Date.now();
+    let last = null;
+    const drain = () => {
+        if (!queue.length && !dropped)
+            return;
+        const pending = queue;
+        queue = [];
+        if (dropped && last) {
+            pending.unshift(dropNotice(last, dropped, Date.now() - droppedSince, 'buffer_full'));
+            dropped = 0;
+            droppedSince = Date.now();
+        }
+        if (!pending.length)
+            return;
+        try {
+            driver.write(pending);
+        }
+        catch {
+            // drain() runs from a timer, where a throw is an uncaught exception and the
+            // end of the process. Note that a sink wrapped from the outside cannot help
+            // here: this call is beneath that wrapper, not through it.
+        }
+    };
+    // Unreferenced: a log timer must never be the reason a process stays alive.
+    const timer = setInterval(drain, everyMs);
+    timer.unref?.();
+    return {
+        name: `buffered(${driver.name})`,
+        write(records) {
+            for (const record of records) {
+                last = record;
+                const limit = record.level === 'error' ? max : softMax;
+                if (queue.length >= limit) {
+                    if (!dropped)
+                        droppedSince = Date.now();
+                    dropped++;
+                    continue;
+                }
+                queue.push(record);
+            }
+            if (queue.length >= batch)
+                drain();
+        },
+        async flush() {
+            drain();
+            await driver.flush?.();
+        },
+        async close() {
+            clearInterval(timer);
+            drain();
+            await driver.flush?.();
+            await driver.close?.();
+        },
+    };
+}
+/**
+ * Swallow a driver's failures, and say so exactly once.
+ *
+ * Once, because a sink that fails usually fails for every record, and a fallback
+ * flooded with reports of the first sink's failure is a second outage.
+ */
+export function isolatedLog(driver, fallback) {
+    let reported = false;
+    const report = (like, cause) => {
+        if (reported || !fallback || !like)
+            return;
+        reported = true;
+        try {
+            fallback.write([
+                {
+                    at: new Date().toISOString(),
+                    level: 'error',
+                    event: 'log_driver_failed',
+                    deployment: like.deployment,
+                    process: like.process,
+                    tenant: null,
+                    trace: null,
+                    error: {
+                        code: 'E_LOG_DRIVER',
+                        message: cause instanceof Error ? cause.message : String(cause),
+                        module: null,
+                    },
+                    fields: { driver: driver.name },
+                },
+            ]);
+        }
+        catch { }
+    };
+    return {
+        name: `isolated(${driver.name})`,
+        write(records) {
+            try {
+                driver.write(records);
+            }
+            catch (cause) {
+                report(records[0], cause);
+            }
+        },
+        async flush() {
+            try {
+                await driver.flush?.();
+            }
+            catch (cause) {
+                report(undefined, cause);
+            }
+        },
+        async close() {
+            try {
+                await driver.close?.();
+            }
+            catch { }
+        },
+    };
+}
+const scalar = (value) => value === null || typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean';
+const clip = (value, max) => (value.length <= max ? value : `${value.slice(0, max)}…`);
+function redactFields(fields) {
+    if (!fields)
+        return undefined;
+    const out = {};
+    for (const [key, value] of Object.entries(fields)) {
+        const lower = key.toLowerCase();
+        if (DENY.some((needle) => lower.includes(needle))) {
+            out[key] = '[redacted]';
+            continue;
+        }
+        if (!scalar(value)) {
+            // The type forbids this; JavaScript callers do not have the type.
+            out[key] = '[dropped: non-scalar]';
+            continue;
+        }
+        out[key] = typeof value === 'string' ? clip(value, VALUE_MAX) : value;
+    }
+    return out;
+}
+/**
+ * The mandatory outermost wrapper, applied by the runtime and not optional.
+ *
+ * The type system already refuses a non-scalar field, which stops the common way a
+ * customer payload reaches an aggregator. This handles what the type system cannot
+ * see: values arriving from JavaScript callers, and from `catch (e)`.
+ */
+export function redactLog(driver) {
+    return {
+        name: `redacted(${driver.name})`,
+        write(records) {
+            driver.write(records.map((record) => {
+                const fields = redactFields(record.fields);
+                return {
+                    ...record,
+                    ...(record.message === undefined ? {} : { message: clip(record.message, MESSAGE_MAX) }),
+                    ...(record.error === undefined
+                        ? {}
+                        : { error: { ...record.error, message: clip(record.error.message, MESSAGE_MAX) } }),
+                    ...(fields === undefined ? {} : { fields }),
+                };
+            }));
+        },
+        flush: driver.flush ? () => driver.flush() : undefined,
+        close: driver.close ? () => driver.close() : undefined,
+    };
+}
+//# sourceMappingURL=combinators.js.map

package/dist/server/log/combinators.js.map

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

package/dist/server/log/console.d.ts

@@ -0,0 +1,12 @@
+import type { LogDriver } from './types.ts';
+export type ConsoleLogOptions = {
+    stream?: 'stdout' | 'stderr';
+    /** Human-readable columns instead of NDJSON. For `ket dev`, never for production. */
+    pretty?: boolean;
+    color?: boolean;
+    bufferMax?: number;
+};
+export declare function consoleLog(options?: ConsoleLogOptions): LogDriver;
+/** `consoleLog` with columns a person can read. The development default. */
+export declare const prettyLog: (options?: Omit<ConsoleLogOptions, 'pretty'>) => LogDriver;
+//# sourceMappingURL=console.d.ts.map

package/dist/server/log/console.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"console.d.ts","sourceRoot":"","sources":["../../../../../../packages/ketjs/src/server/log/console.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,SAAS,EAAa,MAAM,YAAY,CAAA;AAmBtD,MAAM,MAAM,iBAAiB,GAAG;IAC9B,MAAM,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAA;IAC5B,qFAAqF;IACrF,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAyBD,wBAAgB,UAAU,CAAC,OAAO,GAAE,iBAAsB,GAAG,SAAS,CA6CrE;AAED,4EAA4E;AAC5E,eAAO,MAAM,SAAS,aAAa,IAAI,CAAC,iBAAiB,EAAE,QAAQ,CAAC,KAAQ,SAClC,CAAA"}

package/dist/server/log/console.js

@@ -0,0 +1,96 @@
+// The default sink: NDJSON, one record per line, on stderr.
+//
+// stderr rather than stdout, and that is not a stylistic choice. `ket manifest`,
+// `ket agent`, `ket permissions --json` and a dozen other commands write their
+// answer to stdout, and a log line interleaved into that answer breaks
+// `ket manifest | jq` for everyone downstream. stdout belongs to the program's
+// output; a log is a side channel. Both are collected in a container runtime, so
+// nothing is lost by being correct here.
+/**
+ * How much may sit unwritten in the stream before records are dropped.
+ *
+ * Node's stdout and stderr are asynchronous when they point at a pipe, and their
+ * internal buffer has no bound: a log collector that stops reading turns into
+ * unbounded memory growth in the application. This is the bound.
+ */
+const BUFFER_MAX = 4 * 1024 * 1024;
+const LEVEL_COLOR = {
+    debug: '\u001b[90m',
+    info: '\u001b[36m',
+    warn: '\u001b[33m',
+    error: '\u001b[31m',
+};
+const COLOR_OFF = '\u001b[0m';
+function target(name) {
+    return name === 'stdout' ? process.stdout : process.stderr;
+}
+const pad = (value, width) => value.padEnd(width);
+function prettyLine(record, color) {
+    const time = record.at.slice(11, 23);
+    const tint = color ? (LEVEL_COLOR[record.level] ?? '') : '';
+    const off = tint ? COLOR_OFF : '';
+    const parts = [];
+    if (record.fn)
+        parts.push(`fn=${record.fn}`);
+    if (record.tenant)
+        parts.push(`tenant=${record.tenant}`);
+    if (record.durationMs !== undefined)
+        parts.push(`${record.durationMs}ms`);
+    if (record.dryRun)
+        parts.push('dry-run');
+    if (record.replayed)
+        parts.push('replayed');
+    for (const [key, value] of Object.entries(record.fields ?? {}))
+        parts.push(`${key}=${value}`);
+    if (record.error)
+        parts.push(`${record.error.code}: ${record.error.message}`);
+    const message = record.message ? ` ${record.message}` : '';
+    const tail = parts.length ? ` ${parts.join(' ')}` : '';
+    return `${time} ${tint}${pad(record.level, 5)}${off} ${pad(record.event, 18)}${message}${tail}\n`;
+}
+export function consoleLog(options = {}) {
+    const out = target(options.stream ?? 'stderr');
+    const pretty = options.pretty ?? false;
+    const color = options.color ?? Boolean(out.isTTY);
+    const bufferMax = options.bufferMax ?? BUFFER_MAX;
+    let dropped = 0;
+    let droppedSince = Date.now();
+    const line = (record) => pretty ? prettyLine(record, color) : `${JSON.stringify(record)}\n`;
+    return {
+        name: pretty ? 'pretty' : 'console',
+        write(records) {
+            for (const record of records) {
+                if (out.writableLength > bufferMax) {
+                    if (!dropped)
+                        droppedSince = Date.now();
+                    dropped++;
+                    continue;
+                }
+                try {
+                    if (dropped) {
+                        const count = dropped;
+                        const sinceMs = Date.now() - droppedSince;
+                        dropped = 0;
+                        out.write(line({
+                            at: new Date().toISOString(),
+                            level: 'warn',
+                            event: 'log_dropped',
+                            deployment: record.deployment,
+                            process: record.process,
+                            tenant: null,
+                            trace: null,
+                            fields: { count, sinceMs, reason: 'stream_backpressure' },
+                        }));
+                    }
+                    out.write(line(record));
+                }
+                catch {
+                    /* a closed stdio stream must not take the application with it */
+                }
+            }
+        },
+    };
+}
+/** `consoleLog` with columns a person can read. The development default. */
+export const prettyLog = (options = {}) => consoleLog({ ...options, pretty: true });
+//# sourceMappingURL=console.js.map

package/dist/server/log/console.js.map

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

package/dist/server/log/file.d.ts

@@ -0,0 +1,11 @@
+import type { LogDriver } from './types.ts';
+export type FileLogOptions = {
+    dir: string;
+    file?: string;
+    /** Rotate once the active file passes this size. */
+    maxBytes?: number;
+    /** How many rotated generations to keep beside the active file. */
+    keep?: number;
+};
+export declare function fileLog(options: FileLogOptions): LogDriver;
+//# sourceMappingURL=file.d.ts.map

package/dist/server/log/file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.d.ts","sourceRoot":"","sources":["../../../../../../packages/ketjs/src/server/log/file.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,SAAS,EAAa,MAAM,YAAY,CAAA;AAEtD,MAAM,MAAM,cAAc,GAAG;IAC3B,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,oDAAoD;IACpD,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,mEAAmE;IACnE,IAAI,CAAC,EAAE,MAAM,CAAA;CACd,CAAA;AAUD,wBAAgB,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,SAAS,CAoC1D"}

package/dist/server/log/file.js

@@ -0,0 +1,61 @@
+// A rotating file, for a deployment with nowhere to send stderr.
+//
+// In a container runtime this driver is the wrong answer: the runtime already
+// captures stderr, and a file inside a pod is deleted with the pod. It is here for
+// the deployment that runs under a service manager on a host it owns.
+//
+// One `appendFileSync` per batch rather than a managed stream. A synchronous
+// append is durable the moment it returns, which removes rotation races, partial
+// lines on crash, and the question of what `flush` means — and `bufferedLog` in
+// front of it amortises the open/close across a whole second of records.
+import { appendFileSync, mkdirSync, renameSync, statSync } from 'node:fs';
+import { join } from 'node:path';
+const sizeOf = (path) => {
+    try {
+        return statSync(path).size;
+    }
+    catch {
+        return 0;
+    }
+};
+export function fileLog(options) {
+    const maxBytes = Math.max(1, options.maxBytes ?? 32 * 1024 * 1024);
+    const keep = Math.max(1, options.keep ?? 5);
+    const path = join(options.dir, options.file ?? 'ket.log');
+    mkdirSync(options.dir, { recursive: true });
+    const rotate = () => {
+        // Downwards, so a generation is never overwritten before it has moved. rename
+        // replaces its destination, which is what retires the oldest generation.
+        for (let index = keep - 1; index >= 1; index--) {
+            try {
+                renameSync(`${path}.${index}`, `${path}.${index + 1}`);
+            }
+            catch {
+                /* that generation does not exist yet */
+            }
+        }
+        try {
+            renameSync(path, `${path}.1`);
+        }
+        catch {
+            /* nothing written yet */
+        }
+    };
+    return {
+        name: 'file',
+        write(records) {
+            if (!records.length)
+                return;
+            const payload = `${records.map((record) => JSON.stringify(record)).join('\n')}\n`;
+            try {
+                appendFileSync(path, payload);
+                if (sizeOf(path) >= maxBytes)
+                    rotate();
+            }
+            catch {
+                /* a full or read-only disk must not take the application with it */
+            }
+        },
+    };
+}
+//# sourceMappingURL=file.js.map

package/dist/server/log/file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.js","sourceRoot":"","sources":["../../../../../../../packages/ketjs/src/server/log/file.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,EAAE;AACF,8EAA8E;AAC9E,mFAAmF;AACnF,sEAAsE;AACtE,EAAE;AACF,6EAA6E;AAC7E,iFAAiF;AACjF,gFAAgF;AAChF,yEAAyE;AAEzE,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AACzE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAYhC,MAAM,MAAM,GAAG,CAAC,IAAY,EAAU,EAAE;IACtC,IAAI,CAAC;QACH,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAA;IAC5B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,CAAA;IACV,CAAC;AACH,CAAC,CAAA;AAED,MAAM,UAAU,OAAO,CAAC,OAAuB;IAC7C,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,QAAQ,IAAI,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC,CAAA;IAClE,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC,CAAA;IAC3C,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,IAAI,IAAI,SAAS,CAAC,CAAA;IACzD,SAAS,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IAE3C,MAAM,MAAM,GAAG,GAAS,EAAE;QACxB,8EAA8E;QAC9E,yEAAyE;QACzE,KAAK,IAAI,KAAK,GAAG,IAAI,GAAG,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC;YAC/C,IAAI,CAAC;gBACH,UAAU,CAAC,GAAG,IAAI,IAAI,KAAK,EAAE,EAAE,GAAG,IAAI,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC,CAAA;YACxD,CAAC;YAAC,MAAM,CAAC;gBACP,wCAAwC;YAC1C,CAAC;QACH,CAAC;QACD,IAAI,CAAC;YACH,UAAU,CAAC,IAAI,EAAE,GAAG,IAAI,IAAI,CAAC,CAAA;QAC/B,CAAC;QAAC,MAAM,CAAC;YACP,yBAAyB;QAC3B,CAAC;IACH,CAAC,CAAA;IAED,OAAO;QACL,IAAI,EAAE,MAAM;QACZ,KAAK,CAAC,OAA6B;YACjC,IAAI,CAAC,OAAO,CAAC,MAAM;gBAAE,OAAM;YAC3B,MAAM,OAAO,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAA;YACjF,IAAI,CAAC;gBACH,cAAc,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;gBAC7B,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,QAAQ;oBAAE,MAAM,EAAE,CAAA;YACxC,CAAC;YAAC,MAAM,CAAC;gBACP,oEAAoE;YACtE,CAAC;QACH,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/server/log/index.d.ts

@@ -0,0 +1,23 @@
+import type { RuntimeConfig } from '../config.ts';
+import type { LogDriver } from './types.ts';
+export { atLeast, isLogDriverName, isLogLevel, nullLog, CORE_EVENTS, MODULE_EVENT } from './types.ts';
+export type { CoreEvent, LogDriver, LogDriverName, LogError, LogFields, LogLevel, LogProcess, LogRecord, OpenLog, } from './types.ts';
+export { bufferedLog, isolatedLog, leveledLog, multiLog, redactLog } from './combinators.ts';
+export { consoleLog, prettyLog } from './console.ts';
+export type { ConsoleLogOptions } from './console.ts';
+export { fileLog } from './file.ts';
+export type { FileLogOptions } from './file.ts';
+export { memoryLog } from './memory.ts';
+export type { MemoryLog } from './memory.ts';
+export { createLogger, describeError, traceOf } from './logger.ts';
+export type { LogContext, LogEntry, Logger } from './logger.ts';
+/**
+ * The sink the framework opens when the deployment does not hand one in.
+ *
+ * Which driver, not which behaviour: level filtering and redaction are applied by
+ * the runtime around whatever comes back from here, so a deployment's own
+ * `serve.openLog` gets the same treatment as the built-ins rather than having to
+ * remember to ask for it.
+ */
+export declare function logFromConfig(config: RuntimeConfig): LogDriver;
+//# sourceMappingURL=index.d.ts.map

package/dist/server/log/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../packages/ketjs/src/server/log/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAIjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAG3C,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AACrG,YAAY,EACV,SAAS,EACT,SAAS,EACT,aAAa,EACb,QAAQ,EACR,SAAS,EACT,QAAQ,EACR,UAAU,EACV,SAAS,EACT,OAAO,GACR,MAAM,YAAY,CAAA;AACnB,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAC5F,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AACpD,YAAY,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AACrD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,YAAY,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACvC,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAC5C,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAClE,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAE/D;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,aAAa,GAAG,SAAS,CAwB9D"}

package/dist/server/log/index.js

@@ -0,0 +1,45 @@
+import { KetError } from '../../kernel/errors.js';
+import { bufferedLog } from './combinators.js';
+import { consoleLog, prettyLog } from './console.js';
+import { fileLog } from './file.js';
+import { nullLog } from './types.js';
+export { atLeast, isLogDriverName, isLogLevel, nullLog, CORE_EVENTS, MODULE_EVENT } from './types.js';
+export { bufferedLog, isolatedLog, leveledLog, multiLog, redactLog } from './combinators.js';
+export { consoleLog, prettyLog } from './console.js';
+export { fileLog } from './file.js';
+export { memoryLog } from './memory.js';
+export { createLogger, describeError, traceOf } from './logger.js';
+/**
+ * The sink the framework opens when the deployment does not hand one in.
+ *
+ * Which driver, not which behaviour: level filtering and redaction are applied by
+ * the runtime around whatever comes back from here, so a deployment's own
+ * `serve.openLog` gets the same treatment as the built-ins rather than having to
+ * remember to ask for it.
+ */
+export function logFromConfig(config) {
+    switch (config.logDriver) {
+        case 'null':
+            return nullLog();
+        case 'console':
+            return consoleLog({ stream: config.logStream });
+        case 'pretty':
+            return prettyLog({ stream: config.logStream });
+        case 'file': {
+            if (!config.logDir)
+                throw new KetError({
+                    code: 'E_LOG_CONFIG',
+                    message: 'file logging is missing KET_LOG_DIR',
+                    hint: 'set KET_LOG_DIR, or choose another KET_LOG driver',
+                });
+            // Batched, because an append per record would be an open per record.
+            return bufferedLog(fileLog({ dir: config.logDir }), { max: config.logBuffer });
+        }
+        default:
+            // A terminal gets columns; a pipe gets NDJSON. Nobody configures the obvious.
+            return process.stderr.isTTY
+                ? prettyLog({ stream: config.logStream })
+                : consoleLog({ stream: config.logStream });
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/server/log/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../packages/ketjs/src/server/log/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAA;AAEjD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAC9C,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAEnC,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AAEpC,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAYrG,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAC5F,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAEpD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAEnC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAEvC,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAGlE;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAAC,MAAqB;IACjD,QAAQ,MAAM,CAAC,SAAS,EAAE,CAAC;QACzB,KAAK,MAAM;YACT,OAAO,OAAO,EAAE,CAAA;QAClB,KAAK,SAAS;YACZ,OAAO,UAAU,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC,CAAA;QACjD,KAAK,QAAQ;YACX,OAAO,SAAS,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC,CAAA;QAChD,KAAK,MAAM,EAAE,CAAC;YACZ,IAAI,CAAC,MAAM,CAAC,MAAM;gBAChB,MAAM,IAAI,QAAQ,CAAC;oBACjB,IAAI,EAAE,cAAc;oBACpB,OAAO,EAAE,qCAAqC;oBAC9C,IAAI,EAAE,mDAAmD;iBAC1D,CAAC,CAAA;YACJ,qEAAqE;YACrE,OAAO,WAAW,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC,CAAA;QAChF,CAAC;QACD;YACE,8EAA8E;YAC9E,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK;gBACzB,CAAC,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC;gBACzC,CAAC,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC,CAAA;IAChD,CAAC;AACH,CAAC"}