shield360 1.1.0 → 1.2.0

package/dist/otel/events.js

@@ -9,18 +9,7 @@ class Events {
     static setup(options) {
         try {
             if (!EVENTS_SET) {
-                const existingProvider = api_logs_1.logs.getLoggerProvider();
-                const isSDKProvider = existingProvider &&
-                    typeof existingProvider.forceFlush === 'function' &&
-                    existingProvider.constructor.name !== 'NoopLoggerProvider';
-                if (isSDKProvider) {
-                    this.loggerProvider = existingProvider;
-                }
-                else {
-                    this.loggerProvider = Events.buildLoggerProvider(options);
-                    api_logs_1.logs.setGlobalLoggerProvider(this.loggerProvider);
-                }
-                this.logger = this.loggerProvider.getLogger('shield360');
+                this.logger = this.ensureProvider(options).getLogger('shield360');
                 EVENTS_SET = true;
             }
             return this.logger;
@@ -30,6 +19,24 @@ class Events {
             return null;
         }
     }
+    // SHIELD: the provider on its own, so application logs (app-logs.ts) can
+    // share it — same exporter, same destination — even with GenAI events off.
+    static ensureProvider(options) {
+        if (!this.loggerProvider) {
+            const existingProvider = api_logs_1.logs.getLoggerProvider();
+            const isSDKProvider = existingProvider &&
+                typeof existingProvider.forceFlush === 'function' &&
+                existingProvider.constructor.name !== 'NoopLoggerProvider';
+            if (isSDKProvider) {
+                this.loggerProvider = existingProvider;
+            }
+            else {
+                this.loggerProvider = Events.buildLoggerProvider(options);
+                api_logs_1.logs.setGlobalLoggerProvider(this.loggerProvider);
+            }
+        }
+        return this.loggerProvider;
+    }
     static buildLoggerProvider(options) {
         const exporterList = (0, utils_1.parseExporters)('OTEL_LOGS_EXPORTER');
         const processors = [];
@@ -68,6 +75,8 @@ class Events {
     }
     static resetForTesting() {
         EVENTS_SET = false;
+        this.loggerProvider = undefined;
+        this.logger = undefined;
     }
 }
 exports.default = Events;

package/dist/otel/events.js.map

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

package/dist/otel/log-auto.d.ts

@@ -0,0 +1,44 @@
+/**
+ * winston and pino, bridged without code changes when application logs are on.
+ *
+ * With `captureLogs: true` (or SHIELD360_CAPTURE_LOGS=true), init() hooks the
+ * loggers an app already uses, through OpenTelemetry's module hooks
+ * (@opentelemetry/instrumentation), the way OpenTelemetry's own winston and
+ * pino instrumentations do:
+ *
+ *   winston  every winston.createLogger() also gets the Shield360 transport
+ *            (log-bridges.ts), built on the app's own winston.Transport. A
+ *            winston already loaded before init() is patched in place.
+ *   pino     every pino() logger writes to its destination and to the
+ *            Shield360 stream (pino.multistream), so output is unchanged.
+ *            Loggers created before init() are not changed: create them after
+ *            init(), or add Shield360.pinoStream() yourself.
+ *
+ * The hooks are inert while application logs are off, so turning them off
+ * later stops new loggers being bridged. Nothing here throws into the app: if
+ * a logger cannot be bridged it is created exactly as it would have been.
+ */
+import { InstrumentationBase, InstrumentationNodeModuleDefinition } from '@opentelemetry/instrumentation';
+declare const ORIGINAL: unique symbol;
+type AnyFunction = ((...args: any[]) => any) & {
+    [ORIGINAL]?: AnyFunction;
+    [key: string | symbol]: any;
+};
+/** Makes winston.createLogger() add the Shield360 transport. Returns the module. */
+export declare function patchWinston(winston: any): any;
+export declare function unpatchWinston(winston: any): void;
+/**
+ * pino's arguments with the Shield360 stream added, or null to call pino
+ * unchanged: pino(), pino(opts), pino(stream), pino(opts, stream),
+ * pino(opts, 'path'), and opts.transport.
+ */
+export declare function bridgePinoArgs(pino: AnyFunction, args: unknown[]): unknown[] | null;
+/** A pino function whose loggers also write to Shield360. Returns the module to use. */
+export declare function patchPino(pino: any): any;
+export declare class Shield360LogBridgeInstrumentation extends InstrumentationBase {
+    constructor();
+    protected init(): InstrumentationNodeModuleDefinition[];
+}
+/** Hooks winston and pino (once). Called by init() when application logs are on. */
+export declare function enableLogBridges(): void;
+export {};

package/dist/otel/log-auto.js

@@ -0,0 +1,200 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Shield360LogBridgeInstrumentation = void 0;
+exports.patchWinston = patchWinston;
+exports.unpatchWinston = unpatchWinston;
+exports.bridgePinoArgs = bridgePinoArgs;
+exports.patchPino = patchPino;
+exports.enableLogBridges = enableLogBridges;
+/**
+ * winston and pino, bridged without code changes when application logs are on.
+ *
+ * With `captureLogs: true` (or SHIELD360_CAPTURE_LOGS=true), init() hooks the
+ * loggers an app already uses, through OpenTelemetry's module hooks
+ * (@opentelemetry/instrumentation), the way OpenTelemetry's own winston and
+ * pino instrumentations do:
+ *
+ *   winston  every winston.createLogger() also gets the Shield360 transport
+ *            (log-bridges.ts), built on the app's own winston.Transport. A
+ *            winston already loaded before init() is patched in place.
+ *   pino     every pino() logger writes to its destination and to the
+ *            Shield360 stream (pino.multistream), so output is unchanged.
+ *            Loggers created before init() are not changed: create them after
+ *            init(), or add Shield360.pinoStream() yourself.
+ *
+ * The hooks are inert while application logs are off, so turning them off
+ * later stops new loggers being bridged. Nothing here throws into the app: if
+ * a logger cannot be bridged it is created exactly as it would have been.
+ */
+const instrumentation_1 = require("@opentelemetry/instrumentation");
+const constant_1 = require("../constant");
+const app_logs_1 = require("./app-logs");
+const log_bridges_1 = require("./log-bridges");
+const ORIGINAL = Symbol.for('shield360.logBridge.original');
+const BRIDGED = Symbol.for('shield360.logBridge.transport');
+// ---------------------------------------------------------------- winston
+/** Makes winston.createLogger() add the Shield360 transport. Returns the module. */
+function patchWinston(winston) {
+    try {
+        if (!winston || typeof winston.createLogger !== 'function' || winston.createLogger[ORIGINAL])
+            return winston;
+        if (typeof winston.Transport !== 'function')
+            return winston;
+        const Shield360Transport = (0, log_bridges_1.winstonTransport)(winston.Transport);
+        const original = winston.createLogger;
+        const patched = function (...args) {
+            const logger = original.apply(this, args);
+            if (!(0, app_logs_1.appLogsEnabled)())
+                return logger;
+            try {
+                const transports = Array.isArray(logger?.transports) ? logger.transports : [];
+                if (!transports.some((t) => t?.[BRIDGED])) {
+                    const transport = new Shield360Transport();
+                    transport[BRIDGED] = true;
+                    logger.add(transport);
+                }
+            }
+            catch {
+                // The logger works as created.
+            }
+            return logger;
+        };
+        patched[ORIGINAL] = original;
+        winston.createLogger = patched;
+    }
+    catch {
+        // Left unpatched.
+    }
+    return winston;
+}
+function unpatchWinston(winston) {
+    try {
+        const original = winston?.createLogger?.[ORIGINAL];
+        if (original)
+            winston.createLogger = original;
+    }
+    catch {
+        // Nothing to undo.
+    }
+}
+// ------------------------------------------------------------------- pino
+function isStream(value) {
+    return !!value && typeof value.write === 'function';
+}
+/**
+ * pino's arguments with the Shield360 stream added, or null to call pino
+ * unchanged: pino(), pino(opts), pino(stream), pino(opts, stream),
+ * pino(opts, 'path'), and opts.transport.
+ */
+function bridgePinoArgs(pino, args) {
+    let [opts, stream] = args;
+    if (args.length > 2)
+        return null;
+    if (stream === undefined && (isStream(opts) || typeof opts === 'string')) {
+        stream = opts;
+        opts = {};
+    }
+    if (opts === undefined || opts === null)
+        opts = {};
+    if (typeof opts !== 'object' || Array.isArray(opts))
+        return null;
+    let options = opts;
+    if (typeof pino.multistream !== 'function' || typeof pino.destination !== 'function')
+        return null;
+    if (options.transport) {
+        if (stream !== undefined)
+            return null; // pino refuses both; let it say so
+        if (typeof pino.transport !== 'function')
+            return null;
+        stream = pino.transport(options.transport);
+        options = { ...options };
+        delete options.transport;
+    }
+    if (stream === undefined)
+        stream = pino.destination((process.stdout && process.stdout.fd) || 1);
+    else if (typeof stream === 'string' || typeof stream === 'number')
+        stream = pino.destination(stream);
+    if (!isStream(stream))
+        return null;
+    // levelVal 0: both streams see every record the logger itself lets through.
+    const streams = pino.multistream([
+        { levelVal: 0, stream },
+        { levelVal: 0, stream: (0, log_bridges_1.pinoStream)() },
+    ]);
+    return [options, streams];
+}
+/** A pino function whose loggers also write to Shield360. Returns the module to use. */
+function patchPino(pino) {
+    try {
+        if (typeof pino !== 'function' || pino[ORIGINAL])
+            return pino;
+        const original = pino;
+        const patched = function (...args) {
+            if ((0, app_logs_1.appLogsEnabled)()) {
+                let bridged = null;
+                try {
+                    bridged = bridgePinoArgs(original, args);
+                }
+                catch {
+                    bridged = null;
+                }
+                if (bridged)
+                    return original.apply(this, bridged);
+            }
+            return original.apply(this, args);
+        };
+        Object.assign(patched, original);
+        patched[ORIGINAL] = original;
+        patched.default = patched;
+        patched.pino = patched;
+        return patched;
+    }
+    catch {
+        return pino;
+    }
+}
+// -------------------------------------------------------------- the hooks
+class Shield360LogBridgeInstrumentation extends instrumentation_1.InstrumentationBase {
+    constructor() {
+        super(`${constant_1.INSTRUMENTATION_PREFIX}/instrumentation-log-bridges`, '1.0.0', {});
+    }
+    init() {
+        return [
+            new instrumentation_1.InstrumentationNodeModuleDefinition('winston', ['>=3 <4'], (moduleExports) => patchWinston(moduleExports), (moduleExports) => unpatchWinston(moduleExports)),
+            new instrumentation_1.InstrumentationNodeModuleDefinition('pino', ['>=7 <11'], (moduleExports) => patchPino(moduleExports), 
+            // The patched function is inert while application logs are off.
+            (moduleExports) => moduleExports),
+        ];
+    }
+}
+exports.Shield360LogBridgeInstrumentation = Shield360LogBridgeInstrumentation;
+let instrumentation = null;
+/** winston loaded before init(): patched in place, since its createLogger is read at call time. */
+function patchLoadedWinston() {
+    try {
+        const cache = typeof require !== 'undefined' ? require.cache : undefined;
+        if (!cache)
+            return;
+        for (const [file, mod] of Object.entries(cache)) {
+            if (mod && /[\\/]node_modules[\\/]winston[\\/]lib[\\/]winston\.js$/.test(file))
+                patchWinston(mod.exports);
+        }
+    }
+    catch {
+        // Nothing loaded, or nothing to patch.
+    }
+}
+/** Hooks winston and pino (once). Called by init() when application logs are on. */
+function enableLogBridges() {
+    try {
+        if (!instrumentation)
+            instrumentation = new Shield360LogBridgeInstrumentation();
+        else
+            instrumentation.enable();
+        patchLoadedWinston();
+    }
+    catch {
+        // Application logs still work through Shield360.logger() and the explicit bridges.
+    }
+}
+//# sourceMappingURL=log-auto.js.map

package/dist/otel/log-auto.js.map

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

package/dist/otel/log-bridges.d.ts

@@ -0,0 +1,54 @@
+import { createLimiter, type LogLevel } from './app-logs';
+export { createLimiter };
+export type BridgeOptions = {
+    /** The instrumentation scope; defaults to the bridge's name (pino, winston, console). */
+    name?: string;
+    /** Records per second at most (default 500). */
+    maxPerSecond?: number;
+};
+export declare function pinoLevel(level: unknown): LogLevel;
+/**
+ * A pino destination: `pino({}, pino.multistream([{ stream: process.stdout }, { stream: Shield360.pinoStream() }]))`.
+ * Each line pino writes is one JSON record; `msg` becomes the body, `level`
+ * the severity, `err` the exception attributes, the rest attributes.
+ */
+export declare function pinoStream(options?: BridgeOptions): {
+    write(line: string): boolean;
+};
+type TransportBase = new (options?: Record<string, unknown>) => {
+    emit?(event: string, ...args: unknown[]): boolean;
+};
+export declare function winstonLevel(level: unknown): LogLevel;
+/**
+ * A winston transport class on the app's own `winston-transport`:
+ *
+ *   import Transport from 'winston-transport';
+ *   const Shield360Transport = Shield360.winstonTransport(Transport);
+ *   winston.createLogger({ transports: [new winston.transports.Console(), new Shield360Transport()] });
+ */
+export declare function winstonTransport(Transport: TransportBase, options?: BridgeOptions): {
+    new (options?: Record<string, unknown>): {
+        log(info: Record<string | symbol, unknown>, callback?: () => void): void;
+        emit?(event: string, ...args: unknown[]): boolean;
+    };
+};
+/** Copies console output to Shield360 application logs (still printed as before). Call releaseConsole() to stop. */
+export declare function captureConsole(options?: BridgeOptions): void;
+/** Puts console back as it was. */
+export declare function releaseConsole(): void;
+type WritableLike = {
+    write: (...args: any[]) => boolean;
+};
+export type StdioOptions = BridgeOptions & {
+    /** The streams to copy; process.stdout and process.stderr by default (tests pass their own). */
+    stdout?: WritableLike;
+    stderr?: WritableLike;
+};
+/**
+ * Copies every line written to stdout and stderr to Shield360 application logs; the output itself
+ * is unchanged. JSON lines keep their level, message, fields and error; plain lines are info on
+ * stdout and error on stderr. Lines split across writes are joined. Call releaseStdio() to stop.
+ */
+export declare function captureStdio(options?: StdioOptions): void;
+/** Puts stdout and stderr back as they were. */
+export declare function releaseStdio(): void;