@kb-labs/devkit 1.0.0

package/tsconfig/dist/logging/__tests__/sinks-and-env.spec.js

@@ -0,0 +1,90 @@
+import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
+import { configureLogger, configureFromEnv, addSink, getLogger, createRedactor, jsonSink, stdoutSink } from '..';
+describe.sequential('configureFromEnv', () => {
+    const orig = { ...process.env };
+    afterEach(() => { process.env = { ...orig }; });
+    it('sets log level and category filter (array)', async () => {
+        process.env.LOG_LEVEL = 'debug';
+        process.env.LOG_CATEGORY_FILTER = 'a,b';
+        configureLogger({ sinks: [], clock: () => new Date('2020-01-01T00:00:00.000Z') });
+        configureFromEnv(process.env);
+        const records = [];
+        addSink({ handle: r => { records.push(r); } });
+        getLogger('a').debug('x');
+        getLogger('c').debug('y');
+        await new Promise(r => setTimeout(r, 0));
+        expect(records.length).toBe(1);
+        expect(records[0].level).toBe('debug');
+        expect(records[0].category).toBe('a');
+    });
+    it('supports regex category filter', async () => {
+        process.env.LOG_LEVEL = 'info';
+        process.env.LOG_CATEGORY_FILTER = '/^api:/';
+        configureLogger({ sinks: [], clock: () => new Date('2020-01-01T00:00:00.000Z') });
+        configureFromEnv(process.env);
+        const records = [];
+        addSink({ handle: r => { records.push(r); } });
+        getLogger('api:get').info('pass');
+        getLogger('db').info('skip');
+        await new Promise(r => setTimeout(r, 0));
+        expect(records.map(r => r.category)).toEqual(['api:get']);
+    });
+});
+describe.sequential('redactor', () => {
+    beforeEach(() => {
+        configureLogger({ sinks: [], level: 'debug', categoryFilter: /.*/, clock: () => new Date('2020-01-01T00:00:00.000Z') });
+    });
+    it('applies redaction before fanout', async () => {
+        const redact = createRedactor({
+            keys: ['token'],
+            mask: '***',
+        });
+        const seen = [];
+        configureLogger({ redactor: (r) => redact(r), sinks: [{ handle: r => { seen.push(r); } }] });
+        getLogger('x').info('ok', { token: 'secret', keep: 1 });
+        await Promise.resolve();
+        await new Promise(r => setTimeout(r, 1));
+        expect(seen[0].meta).toEqual({ token: '***', keep: 1 });
+    });
+});
+describe.sequential('sinks', () => {
+    beforeEach(() => {
+        configureLogger({ sinks: [], level: 'debug', categoryFilter: /.*/, clock: () => new Date('2020-01-01T00:00:00.000Z') });
+    });
+    it('jsonSink writes stable JSON to stdout', async () => {
+        const spy = vi.spyOn(process.stdout, 'write').mockImplementation(() => true);
+        addSink(jsonSink);
+        getLogger('cat').info('hello', { a: 1 });
+        await Promise.resolve();
+        await new Promise(r => setTimeout(r, 1));
+        expect(spy).toHaveBeenCalled();
+        const call = spy.mock.calls[0]?.[0];
+        const obj = JSON.parse(call.trim());
+        expect(obj).toEqual({ time: '2020-01-01T00:00:00.000Z', level: 'info', category: 'cat', msg: 'hello', meta: { a: 1 } });
+        spy.mockRestore();
+    });
+    it('stdoutSink routes based on level and formats line', async () => {
+        const logSpy = vi.spyOn(console, 'log').mockImplementation(() => { });
+        const warnSpy = vi.spyOn(console, 'warn').mockImplementation(() => { });
+        const errSpy = vi.spyOn(console, 'error').mockImplementation(() => { });
+        const dbgSpy = vi.spyOn(console, 'debug').mockImplementation(() => { });
+        configureLogger({ level: 'debug' });
+        addSink(stdoutSink);
+        const l = getLogger('svc');
+        l.debug('d');
+        l.info('i', { x: 1 });
+        l.warn('w');
+        l.error('e');
+        await Promise.resolve();
+        await new Promise(r => setTimeout(r, 1));
+        expect(dbgSpy).toHaveBeenCalled();
+        expect(logSpy).toHaveBeenCalledWith('[2020-01-01T00:00:00.000Z] INFO svc: i', { x: 1 });
+        expect(warnSpy).toHaveBeenCalled();
+        expect(errSpy).toHaveBeenCalled();
+        logSpy.mockRestore();
+        warnSpy.mockRestore();
+        errSpy.mockRestore();
+        dbgSpy.mockRestore();
+    });
+});
+//# sourceMappingURL=sinks-and-env.spec.js.map

package/tsconfig/dist/logging/__tests__/sinks-and-env.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sinks-and-env.spec.js","sourceRoot":"","sources":["../../../../../kb-labs-core/packages/sys/src/logging/__tests__/sinks-and-env.spec.ts"],"names":[],"mappings":"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"}

package/tsconfig/dist/logging/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./types";
+export { configureLogger, configureFromEnv, addSink, removeSink, setLogLevel, getLogger } from "./logger";
+export { createRedactor } from "./redaction";
+export { stdoutSink } from "./sinks/stdout";
+export { jsonSink } from "./sinks/json";
+//# sourceMappingURL=index.d.ts.map

package/tsconfig/dist/logging/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../kb-labs-core/packages/sys/src/logging/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAC1G,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC"}

package/tsconfig/dist/logging/index.js

@@ -0,0 +1,6 @@
+export * from "./types";
+export { configureLogger, configureFromEnv, addSink, removeSink, setLogLevel, getLogger } from "./logger";
+export { createRedactor } from "./redaction";
+export { stdoutSink } from "./sinks/stdout";
+export { jsonSink } from "./sinks/json";
+//# sourceMappingURL=index.js.map

package/tsconfig/dist/logging/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../kb-labs-core/packages/sys/src/logging/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAC1G,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC"}

package/tsconfig/dist/logging/logger.d.ts

@@ -0,0 +1,9 @@
+import type { ConfigureOpts, LogLevel, LogSink, Logger } from "./types";
+export declare function configureLogger(opts: ConfigureOpts): void;
+export declare function addSink(sink: LogSink): void;
+export declare function removeSink(sink: LogSink): void;
+export declare function setLogLevel(level: LogLevel): void;
+export declare function getLogger(category?: string): Logger;
+/** Generic ENV bootstrap (no product-specific vars). */
+export declare function configureFromEnv(env?: NodeJS.ProcessEnv): void;
+//# sourceMappingURL=logger.d.ts.map

package/tsconfig/dist/logging/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../../kb-labs-core/packages/sys/src/logging/logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAa,OAAO,EAAE,MAAM,EAAY,MAAM,SAAS,CAAC;AAU7F,wBAAgB,eAAe,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI,CAMzD;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAsB;AAClE,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAA2C;AAC1F,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAAyB;AAoD3E,wBAAgB,SAAS,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,wDAAwD;AACxD,wBAAgB,gBAAgB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,IAAI,CAa3E"}

package/tsconfig/dist/logging/logger.js

@@ -0,0 +1,101 @@
+const LEVEL_ORDER = { debug: 10, info: 20, warn: 30, error: 40 };
+let globalLevel = "info";
+let sinks = [];
+let redactor = null;
+let categoryFilter;
+let clock = () => new Date();
+export function configureLogger(opts) {
+    if (opts.level) {
+        globalLevel = opts.level;
+    }
+    if (opts.sinks) {
+        sinks = [...opts.sinks];
+    }
+    if (opts.redactor !== undefined) {
+        redactor = opts.redactor;
+    }
+    if (opts.categoryFilter !== undefined) {
+        categoryFilter = opts.categoryFilter;
+    }
+    if (opts.clock) {
+        clock = opts.clock;
+    }
+}
+export function addSink(sink) { sinks.push(sink); }
+export function removeSink(sink) { sinks = sinks.filter(s => s !== sink); }
+export function setLogLevel(level) { globalLevel = level; }
+function allowedCategory(cat) {
+    if (!categoryFilter) {
+        return true;
+    }
+    if (Array.isArray(categoryFilter)) {
+        return !cat ? false : categoryFilter.includes(cat);
+    }
+    return !!cat && categoryFilter.test(cat);
+}
+async function fanout(rec) {
+    const prepared = redactor ? redactor(rec) : rec;
+    for (const s of sinks) {
+        try {
+            await s.handle(prepared);
+        }
+        catch { /* never throw */ }
+    }
+}
+function baseLogger(bindings) {
+    const boundCat = bindings?.category;
+    const boundMeta = bindings?.meta ?? {};
+    function emit(level, msg, meta) {
+        if (LEVEL_ORDER[level] < LEVEL_ORDER[globalLevel]) {
+            return;
+        }
+        if (!allowedCategory(boundCat)) {
+            return;
+        }
+        let err;
+        let attach;
+        if (meta instanceof Error) {
+            err = { name: meta.name, message: meta.message, stack: meta.stack };
+        }
+        else {
+            attach = meta;
+        }
+        const rec = {
+            time: clock().toISOString(),
+            level,
+            category: boundCat,
+            msg,
+            meta: Object.keys(boundMeta).length || attach ? { ...boundMeta, ...attach } : undefined,
+            err,
+        };
+        void fanout(rec);
+    }
+    return {
+        debug: (m, m2) => emit("debug", m, m2),
+        info: (m, m2) => emit("info", m, m2),
+        warn: (m, m2) => emit("warn", m, m2),
+        error: (m, m2) => emit("error", m, m2),
+        child: (b) => baseLogger({ category: b.category ?? boundCat, meta: { ...boundMeta, ...(b.meta ?? {}) } }),
+    };
+}
+export function getLogger(category) {
+    return baseLogger({ category });
+}
+/** Generic ENV bootstrap (no product-specific vars). */
+export function configureFromEnv(env = process.env) {
+    const lvl = (env.LOG_LEVEL ?? "").toLowerCase();
+    if (lvl === "debug" || lvl === "info" || lvl === "warn" || lvl === "error") {
+        setLogLevel(lvl);
+    }
+    const filter = env.LOG_CATEGORY_FILTER;
+    if (filter?.length) {
+        if (filter.startsWith("/") && filter.endsWith("/")) {
+            const re = new RegExp(filter.slice(1, -1));
+            configureLogger({ categoryFilter: re });
+        }
+        else {
+            configureLogger({ categoryFilter: filter.split(",").map(s => s.trim()).filter(Boolean) });
+        }
+    }
+}
+//# sourceMappingURL=logger.js.map

package/tsconfig/dist/logging/logger.js.map

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

package/tsconfig/dist/logging/redaction.d.ts

@@ -0,0 +1,7 @@
+import type { Redactor } from "./types";
+/** Simple key-based redactor; masks values by key in meta recursively. */
+export declare function createRedactor(opts?: {
+    keys?: string[];
+    mask?: string;
+}): Redactor;
+//# sourceMappingURL=redaction.d.ts.map

package/tsconfig/dist/logging/redaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redaction.d.ts","sourceRoot":"","sources":["../../../../kb-labs-core/packages/sys/src/logging/redaction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAa,QAAQ,EAAE,MAAM,SAAS,CAAC;AAEnD,0EAA0E;AAC1E,wBAAgB,cAAc,CAAC,IAAI,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,QAAQ,CAoBlF"}

package/tsconfig/dist/logging/redaction.js

@@ -0,0 +1,23 @@
+/** Simple key-based redactor; masks values by key in meta recursively. */
+export function createRedactor(opts) {
+    const keys = new Set((opts?.keys ?? ["token", "apiKey", "authorization"]).map(k => k.toLowerCase()));
+    const mask = opts?.mask ?? "****";
+    function redactValue(v, path = []) {
+        if (v && typeof v === "object" && !Array.isArray(v)) {
+            const out = {};
+            for (const [k, val] of Object.entries(v)) {
+                out[k] = keys.has(k.toLowerCase()) ? mask : redactValue(val, path.concat(k));
+            }
+            return out;
+        }
+        if (Array.isArray(v)) {
+            return v.map((x) => redactValue(x, path));
+        }
+        return v;
+    }
+    return (rec) => {
+        const meta = rec.meta ? redactValue(rec.meta) : undefined;
+        return meta ? { ...rec, meta } : rec;
+    };
+}
+//# sourceMappingURL=redaction.js.map

package/tsconfig/dist/logging/redaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redaction.js","sourceRoot":"","sources":["../../../../kb-labs-core/packages/sys/src/logging/redaction.ts"],"names":[],"mappings":"AAEA,0EAA0E;AAC1E,MAAM,UAAU,cAAc,CAAC,IAAyC;IACpE,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,EAAE,IAAI,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;IACrG,MAAM,IAAI,GAAG,IAAI,EAAE,IAAI,IAAI,MAAM,CAAC;IAElC,SAAS,WAAW,CAAC,CAAU,EAAE,OAAiB,EAAE;QAChD,IAAI,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;YAClD,MAAM,GAAG,GAA4B,EAAE,CAAC;YACxC,KAAK,MAAM,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,CAAQ,CAAC,EAAE,CAAC;gBAC9C,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;YACjF,CAAC;YACD,OAAO,GAAG,CAAC;QACf,CAAC;QACD,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;YAAA,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;QAAA,CAAC;QAClE,OAAO,CAAC,CAAC;IACb,CAAC;IAED,OAAO,CAAC,GAAc,EAAE,EAAE;QACtB,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC,CAAE,WAAW,CAAC,GAAG,CAAC,IAAI,CAA6B,CAAC,CAAC,CAAC,SAAS,CAAC;QACvF,OAAO,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;IACzC,CAAC,CAAC;AACN,CAAC"}

package/tsconfig/dist/logging/sinks/json.d.ts

@@ -0,0 +1,4 @@
+import type { LogSink } from "../types";
+/** Deterministic JSON sink for CI/log collectors. */
+export declare const jsonSink: LogSink;
+//# sourceMappingURL=json.d.ts.map

package/tsconfig/dist/logging/sinks/json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../../../../../kb-labs-core/packages/sys/src/logging/sinks/json.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAa,OAAO,EAAE,MAAM,UAAU,CAAC;AAEnD,qDAAqD;AACrD,eAAO,MAAM,QAAQ,EAAE,OAYtB,CAAC"}

package/tsconfig/dist/logging/sinks/json.js

@@ -0,0 +1,23 @@
+/** Deterministic JSON sink for CI/log collectors. */
+export const jsonSink = {
+    handle(rec) {
+        // Ensure stable order: time, level, category, msg, err, meta
+        const payload = {};
+        payload.time = rec.time;
+        payload.level = rec.level;
+        if (rec.category) {
+            payload.category = rec.category;
+        }
+        if (rec.msg) {
+            payload.msg = rec.msg;
+        }
+        if (rec.err) {
+            payload.err = rec.err;
+        }
+        if (rec.meta) {
+            payload.meta = rec.meta;
+        }
+        process.stdout.write(JSON.stringify(payload) + "\n");
+    }
+};
+//# sourceMappingURL=json.js.map

package/tsconfig/dist/logging/sinks/json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../../../../../kb-labs-core/packages/sys/src/logging/sinks/json.ts"],"names":[],"mappings":"AAEA,qDAAqD;AACrD,MAAM,CAAC,MAAM,QAAQ,GAAY;IAC7B,MAAM,CAAC,GAAc;QACjB,6DAA6D;QAC7D,MAAM,OAAO,GAA4B,EAAE,CAAC;QAC5C,OAAO,CAAC,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC;QACxB,OAAO,CAAC,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC;QAC1B,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC;YAAA,OAAO,CAAC,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAC;QAAA,CAAC;QACpD,IAAI,GAAG,CAAC,GAAG,EAAE,CAAC;YAAA,OAAO,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC;QAAA,CAAC;QACrC,IAAI,GAAG,CAAC,GAAG,EAAE,CAAC;YAAA,OAAO,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC;QAAA,CAAC;QACrC,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC;YAAA,OAAO,CAAC,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC;QAAA,CAAC;QACxC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;IACzD,CAAC;CACJ,CAAC"}

package/tsconfig/dist/logging/sinks/stdout.d.ts

@@ -0,0 +1,3 @@
+import type { LogSink } from "../types";
+export declare const stdoutSink: LogSink;
+//# sourceMappingURL=stdout.d.ts.map

package/tsconfig/dist/logging/sinks/stdout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdout.d.ts","sourceRoot":"","sources":["../../../../../kb-labs-core/packages/sys/src/logging/sinks/stdout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAa,OAAO,EAAE,MAAM,UAAU,CAAC;AAEnD,eAAO,MAAM,UAAU,EAAE,OAkBxB,CAAC"}

package/tsconfig/dist/logging/sinks/stdout.js

@@ -0,0 +1,24 @@
+export const stdoutSink = {
+    handle(rec) {
+        const line = `[${rec.time}] ${rec.level.toUpperCase()}${rec.category ? ` ${rec.category}` : ""}: ${rec.msg ?? ""}`;
+        if (rec.level === "error") {
+            if (rec.err) {
+                console.error(line, rec.meta ?? {}, rec.err);
+            }
+            else {
+                console.error(line, rec.meta ?? {});
+            }
+        }
+        else if (rec.level === "warn") {
+            console.warn(line, rec.meta ?? {});
+        }
+        else if (rec.level === "info") {
+            console.log(line, rec.meta ?? {});
+        }
+        else {
+            // debug
+            console.debug(line, rec.meta ?? {});
+        }
+    }
+};
+//# sourceMappingURL=stdout.js.map

package/tsconfig/dist/logging/sinks/stdout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdout.js","sourceRoot":"","sources":["../../../../../kb-labs-core/packages/sys/src/logging/sinks/stdout.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,UAAU,GAAY;IAC/B,MAAM,CAAC,GAAc;QACjB,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,IAAI,KAAK,GAAG,CAAC,KAAK,CAAC,WAAW,EAAE,GAAG,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,GAAG,IAAI,EAAE,EAAE,CAAC;QACnH,IAAI,GAAG,CAAC,KAAK,KAAK,OAAO,EAAE,CAAC;YACxB,IAAI,GAAG,CAAC,GAAG,EAAE,CAAC;gBACV,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,IAAI,EAAE,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;YACjD,CAAC;iBAAM,CAAC;gBACJ,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;YACxC,CAAC;QACL,CAAC;aAAM,IAAI,GAAG,CAAC,KAAK,KAAK,MAAM,EAAE,CAAC;YAC9B,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;QACvC,CAAC;aAAM,IAAI,GAAG,CAAC,KAAK,KAAK,MAAM,EAAE,CAAC;YAC9B,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;QACtC,CAAC;aAAM,CAAC;YACJ,QAAQ;YACR,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;QACxC,CAAC;IACL,CAAC;CACJ,CAAC"}

package/tsconfig/dist/logging/types/index.d.ts

@@ -0,0 +1,2 @@
+export * from './types';
+//# sourceMappingURL=index.d.ts.map

package/tsconfig/dist/logging/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../kb-labs-core/packages/sys/src/logging/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAA"}

package/tsconfig/dist/logging/types/index.js

@@ -0,0 +1,2 @@
+export * from './types';
+//# sourceMappingURL=index.js.map

package/tsconfig/dist/logging/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../kb-labs-core/packages/sys/src/logging/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAA"}

package/tsconfig/dist/logging/types/types.d.ts

@@ -0,0 +1,37 @@
+export type LogLevel = "debug" | "info" | "warn" | "error";
+export interface LogRecord {
+    time: string;
+    level: LogLevel;
+    category?: string;
+    msg?: string;
+    err?: {
+        name: string;
+        message: string;
+        stack?: string;
+    };
+    meta?: Record<string, unknown>;
+}
+export interface LogSink {
+    handle(rec: LogRecord): void | Promise<void>;
+}
+export interface Redactor {
+    (rec: LogRecord): LogRecord;
+}
+export interface ConfigureOpts {
+    level?: LogLevel;
+    sinks?: LogSink[];
+    redactor?: Redactor | null;
+    categoryFilter?: string[] | RegExp;
+    clock?: () => Date;
+}
+export interface Logger {
+    debug(msg: string, meta?: Record<string, unknown>): void;
+    info(msg: string, meta?: Record<string, unknown>): void;
+    warn(msg: string, meta?: Record<string, unknown>): void;
+    error(msg: string, meta?: Record<string, unknown> | Error): void;
+    child(bindings: {
+        category?: string;
+        meta?: Record<string, unknown>;
+    }): Logger;
+}
+//# sourceMappingURL=types.d.ts.map

package/tsconfig/dist/logging/types/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../kb-labs-core/packages/sys/src/logging/types/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE3D,MAAM,WAAW,SAAS;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,QAAQ,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACxD,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,OAAO;IACpB,MAAM,CAAC,GAAG,EAAE,SAAS,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChD;AAED,MAAM,WAAW,QAAQ;IACrB,CAAC,GAAG,EAAE,SAAS,GAAG,SAAS,CAAC;CAC/B;AAED,MAAM,WAAW,aAAa;IAC1B,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC;IAClB,QAAQ,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;IACnC,KAAK,CAAC,EAAE,MAAM,IAAI,CAAC;CACtB;AAED,MAAM,WAAW,MAAM;IACnB,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACzD,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACxD,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACxD,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,KAAK,GAAG,IAAI,CAAC;IACjE,KAAK,CAAC,QAAQ,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,GAAG,MAAM,CAAC;CAClF"}

package/tsconfig/dist/logging/types/types.js

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

package/tsconfig/dist/logging/types/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../kb-labs-core/packages/sys/src/logging/types/types.ts"],"names":[],"mappings":""}

package/tsconfig/dist/merge/layered-merge.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @module @kb-labs/core/config/merge/layered-merge
+ * Layered merge with trace for configuration layers
+ */
+import type { ConfigLayer, MergeTrace } from '../types';
+export interface LayeredMergeResult {
+    merged: any;
+    trace: MergeTrace[];
+}
+/**
+ * Merge configuration layers with detailed trace
+ * Arrays are overwritten (not merged)
+ * Objects are deeply merged
+ */
+export declare function layeredMergeWithTrace(layers: ConfigLayer[]): LayeredMergeResult;
+//# sourceMappingURL=layered-merge.d.ts.map

package/tsconfig/dist/merge/layered-merge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layered-merge.d.ts","sourceRoot":"","sources":["../../../../kb-labs-core/packages/config/src/merge/layered-merge.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAExD,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,GAAG,CAAC;IACZ,KAAK,EAAE,UAAU,EAAE,CAAC;CACrB;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,kBAAkB,CAmE/E"}

package/tsconfig/dist/merge/layered-merge.js

@@ -0,0 +1,97 @@
+/**
+ * @module @kb-labs/core/config/merge/layered-merge
+ * Layered merge with trace for configuration layers
+ */
+/**
+ * Merge configuration layers with detailed trace
+ * Arrays are overwritten (not merged)
+ * Objects are deeply merged
+ */
+export function layeredMergeWithTrace(layers) {
+    const trace = [];
+    const isPlainObject = (v) => v && typeof v === 'object' && !Array.isArray(v) && Object.getPrototypeOf(v) === Object.prototype;
+    const merge = (base, overlay, layer, path = []) => {
+        // Handle array overwrite
+        if (Array.isArray(base) && Array.isArray(overlay)) {
+            trace.push({
+                path: path.join('.'),
+                source: layer.source,
+                type: 'overwriteArray',
+                layer: layer.label,
+                profileKey: layer.source.includes('profile') ? extractProfileKey(layer.source) : undefined,
+                profileRef: layer.source.includes('profile') ? extractProfileRef(layer.source) : undefined,
+                presetRef: layer.source.includes('preset') ? extractPresetRef(layer.source) : undefined,
+                version: extractVersion(layer.source),
+            });
+            return overlay;
+        }
+        // Handle object merge
+        if (isPlainObject(base) && isPlainObject(overlay)) {
+            const result = { ...base };
+            for (const [key, value] of Object.entries(overlay)) {
+                if (key in base) {
+                    result[key] = merge(base[key], value, layer, [...path, key]);
+                }
+                else {
+                    trace.push({
+                        path: [...path, key].join('.'),
+                        source: layer.source,
+                        type: 'set',
+                        layer: layer.label,
+                        profileKey: layer.source.includes('profile') ? extractProfileKey(layer.source) : undefined,
+                        profileRef: layer.source.includes('profile') ? extractProfileRef(layer.source) : undefined,
+                        presetRef: layer.source.includes('preset') ? extractPresetRef(layer.source) : undefined,
+                        version: extractVersion(layer.source),
+                    });
+                    result[key] = value;
+                }
+            }
+            return result;
+        }
+        // Different types or primitive values - overlay wins
+        trace.push({
+            path: path.join('.'),
+            source: layer.source,
+            type: 'set',
+            layer: layer.label,
+            profileKey: layer.source.includes('profile') ? extractProfileKey(layer.source) : undefined,
+            profileRef: layer.source.includes('profile') ? extractProfileRef(layer.source) : undefined,
+            presetRef: layer.source.includes('preset') ? extractPresetRef(layer.source) : undefined,
+            version: extractVersion(layer.source),
+        });
+        return overlay ?? base;
+    };
+    const merged = layers.reduce((acc, layer) => {
+        return merge(acc, layer.value, layer);
+    }, {});
+    return { merged, trace };
+}
+/**
+ * Extract profile key from source string
+ */
+function extractProfileKey(source) {
+    const match = source.match(/profile[^:]*:([^@]+)/);
+    return match?.[1];
+}
+/**
+ * Extract profile ref from source string
+ */
+function extractProfileRef(source) {
+    const match = source.match(/profile[^:]*:[^@]+@(.+)/);
+    return match?.[1];
+}
+/**
+ * Extract preset ref from source string
+ */
+function extractPresetRef(source) {
+    const match = source.match(/preset[^:]*:@(.+)/);
+    return match?.[1];
+}
+/**
+ * Extract version from source string
+ */
+function extractVersion(source) {
+    const match = source.match(/@([^:]+)/);
+    return match?.[1];
+}
+//# sourceMappingURL=layered-merge.js.map

package/tsconfig/dist/merge/layered-merge.js.map

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

package/tsconfig/dist/preset/resolve-preset.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @module @kb-labs/core/config/preset/resolve-preset
+ * Org preset resolution with offline-first npm package loading
+ */
+import type { ProductId } from '../types';
+export interface PresetInfo {
+    name: string;
+    version: string;
+    path: string;
+    config: any;
+}
+/**
+ * Resolve org preset package (offline-first)
+ */
+export declare function resolvePreset(presetRef: string, cwd: string): Promise<PresetInfo>;
+/**
+ * Get preset config for a specific product
+ */
+export declare function getPresetConfigForProduct(preset: PresetInfo, product: ProductId): any;
+/**
+ * Get preset metadata
+ */
+export declare function getPresetMetadata(preset: PresetInfo): {
+    name: string;
+    version: string;
+    path: string;
+    products: string[];
+};
+//# sourceMappingURL=resolve-preset.d.ts.map

package/tsconfig/dist/preset/resolve-preset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-preset.d.ts","sourceRoot":"","sources":["../../../../kb-labs-core/packages/config/src/preset/resolve-preset.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE1C,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,GAAG,CAAC;CACb;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,UAAU,CAAC,CAuBrB;AAkFD;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,UAAU,EAClB,OAAO,EAAE,SAAS,GACjB,GAAG,CAGL;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,UAAU,GAAG;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CAOA"}