@ontrails/logtape 1.0.0-beta.15

package/.turbo/turbo-build.log

@@ -0,0 +1 @@
+$ tsc -b

package/.turbo/turbo-lint.log

@@ -0,0 +1,3 @@
+$ oxlint ./src
+Found 0 warnings and 0 errors.
+Finished in 60ms on 2 files with 93 rules using 24 threads.

package/.turbo/turbo-typecheck.log

@@ -0,0 +1 @@
+$ tsc --noEmit

package/CHANGELOG.md

@@ -0,0 +1,7 @@
+# @ontrails/logtape
+
+## 1.0.0-beta.15
+
+### Patch Changes
+
+- @ontrails/logging@1.0.0-beta.15

package/README.md

@@ -0,0 +1,3 @@
+# @ontrails/logtape
+
+The logtape sink for `@ontrails/logging`. See `@ontrails/logging` for the logger API; this package only provides the optional logtape forwarding sink.

package/dist/index.d.ts

@@ -0,0 +1,24 @@
+import type { LogSink } from '@ontrails/logging';
+/**
+ * Subset of the logtape Logger interface that we forward records to.
+ * Accepts any object that provides the standard log-level methods.
+ */
+export interface LogtapeLoggerLike {
+    trace(message: string, props?: Record<string, unknown>): void;
+    debug(message: string, props?: Record<string, unknown>): void;
+    info(message: string, props?: Record<string, unknown>): void;
+    warn(message: string, props?: Record<string, unknown>): void;
+    error(message: string, props?: Record<string, unknown>): void;
+    fatal(message: string, props?: Record<string, unknown>): void;
+}
+export interface LogtapeSinkOptions {
+    /** An existing logtape logger (or compatible object) to forward records to. */
+    readonly logger: LogtapeLoggerLike;
+}
+/**
+ * Sink connector that forwards `LogRecord` instances to an existing logtape
+ * logger. Redaction runs _before_ the sink receives records, so sensitive
+ * data is scrubbed regardless of the backend.
+ */
+export declare const logtapeSink: (options: LogtapeSinkOptions) => LogSink;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAa,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAM5D;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC9D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC9D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC7D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC7D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC9D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAC/D;AAMD,MAAM,WAAW,kBAAkB;IACjC,+EAA+E;IAC/E,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;CACpC;AAiBD;;;;GAIG;AACH,eAAO,MAAM,WAAW,GAAI,SAAS,kBAAkB,KAAG,OAmBzD,CAAC"}

package/dist/index.js

@@ -0,0 +1,31 @@
+const LEVEL_MAP = {
+    debug: 'debug',
+    error: 'error',
+    fatal: 'fatal',
+    info: 'info',
+    trace: 'trace',
+    warn: 'warn',
+};
+/**
+ * Sink connector that forwards `LogRecord` instances to an existing logtape
+ * logger. Redaction runs _before_ the sink receives records, so sensitive
+ * data is scrubbed regardless of the backend.
+ */
+export const logtapeSink = (options) => {
+    const { logger } = options;
+    return {
+        name: 'logtape',
+        write(record) {
+            const method = LEVEL_MAP[record.level];
+            if (method === undefined) {
+                return;
+            }
+            const props = {
+                category: record.category,
+                ...record.metadata,
+            };
+            logger[method](record.message, props);
+        },
+    };
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAkCA,MAAM,SAAS,GAAkC;IAC/C,KAAK,EAAE,OAAO;IACd,KAAK,EAAE,OAAO;IACd,KAAK,EAAE,OAAO;IACd,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,OAAO;IACd,IAAI,EAAE,MAAM;CACb,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,OAA2B,EAAW,EAAE;IAClE,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IAE3B,OAAO;QACL,IAAI,EAAE,SAAS;QACf,KAAK,CAAC,MAAiB;YACrB,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBACzB,OAAO;YACT,CAAC;YAED,MAAM,KAAK,GAA4B;gBACrC,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,GAAG,MAAM,CAAC,QAAQ;aACnB,CAAC;YAEF,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QACxC,CAAC;KACF,CAAC;AACJ,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "@ontrails/logtape",
+  "version": "1.0.0-beta.15",
+  "type": "module",
+  "exports": {
+    ".": "./src/index.ts",
+    "./package.json": "./package.json"
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "test": "bun test",
+    "typecheck": "tsc --noEmit",
+    "lint": "oxlint ./src",
+    "clean": "rm -rf dist *.tsbuildinfo"
+  },
+  "peerDependencies": {
+    "@ontrails/logging": "^1.0.0-beta.14"
+  }
+}

package/src/__tests__/logtape.test.ts

@@ -0,0 +1,74 @@
+import { describe, expect, test } from 'bun:test';
+
+import { logtapeSink } from '../index.js';
+import type { LogtapeLoggerLike } from '../index.js';
+
+const createRecordingLogger = () => {
+  const calls: {
+    level: string;
+    message: string;
+    props?: Record<string, unknown>;
+  }[] = [];
+
+  const logger: LogtapeLoggerLike = {
+    debug(message, props) {
+      calls.push({ level: 'debug', message, props });
+    },
+    error(message, props) {
+      calls.push({ level: 'error', message, props });
+    },
+    fatal(message, props) {
+      calls.push({ level: 'fatal', message, props });
+    },
+    info(message, props) {
+      calls.push({ level: 'info', message, props });
+    },
+    trace(message, props) {
+      calls.push({ level: 'trace', message, props });
+    },
+    warn(message, props) {
+      calls.push({ level: 'warn', message, props });
+    },
+  };
+
+  return { calls, logger };
+};
+
+describe('logtapeSink', () => {
+  test('forwards records to the underlying logtape logger by level', () => {
+    const { calls, logger } = createRecordingLogger();
+    const sink = logtapeSink({ logger });
+
+    sink.write({
+      category: 'app.http',
+      level: 'info',
+      message: 'request received',
+      metadata: { path: '/greet' },
+      timestamp: new Date(),
+    });
+
+    expect(calls).toEqual([
+      {
+        level: 'info',
+        message: 'request received',
+        props: { category: 'app.http', path: '/greet' },
+      },
+    ]);
+  });
+
+  test('ignores records whose level does not map to a logtape method', () => {
+    const { calls, logger } = createRecordingLogger();
+    const sink = logtapeSink({ logger });
+
+    sink.write({
+      category: 'app',
+      // @ts-expect-error -- exercising unexpected level handling
+      level: 'unknown',
+      message: 'should not forward',
+      metadata: {},
+      timestamp: new Date(),
+    });
+
+    expect(calls).toEqual([]);
+  });
+});

package/src/index.ts

@@ -0,0 +1,68 @@
+import type { LogRecord, LogSink } from '@ontrails/logging';
+
+// ---------------------------------------------------------------------------
+// Minimal logtape logger interface (avoids importing @logtape/logtape)
+// ---------------------------------------------------------------------------
+
+/**
+ * Subset of the logtape Logger interface that we forward records to.
+ * Accepts any object that provides the standard log-level methods.
+ */
+export interface LogtapeLoggerLike {
+  trace(message: string, props?: Record<string, unknown>): void;
+  debug(message: string, props?: Record<string, unknown>): void;
+  info(message: string, props?: Record<string, unknown>): void;
+  warn(message: string, props?: Record<string, unknown>): void;
+  error(message: string, props?: Record<string, unknown>): void;
+  fatal(message: string, props?: Record<string, unknown>): void;
+}
+
+// ---------------------------------------------------------------------------
+// Options
+// ---------------------------------------------------------------------------
+
+export interface LogtapeSinkOptions {
+  /** An existing logtape logger (or compatible object) to forward records to. */
+  readonly logger: LogtapeLoggerLike;
+}
+
+// ---------------------------------------------------------------------------
+// logtapeSink
+// ---------------------------------------------------------------------------
+
+type ForwardMethod = 'trace' | 'debug' | 'info' | 'warn' | 'error' | 'fatal';
+
+const LEVEL_MAP: Record<string, ForwardMethod> = {
+  debug: 'debug',
+  error: 'error',
+  fatal: 'fatal',
+  info: 'info',
+  trace: 'trace',
+  warn: 'warn',
+};
+
+/**
+ * Sink connector that forwards `LogRecord` instances to an existing logtape
+ * logger. Redaction runs _before_ the sink receives records, so sensitive
+ * data is scrubbed regardless of the backend.
+ */
+export const logtapeSink = (options: LogtapeSinkOptions): LogSink => {
+  const { logger } = options;
+
+  return {
+    name: 'logtape',
+    write(record: LogRecord): void {
+      const method = LEVEL_MAP[record.level];
+      if (method === undefined) {
+        return;
+      }
+
+      const props: Record<string, unknown> = {
+        category: record.category,
+        ...record.metadata,
+      };
+
+      logger[method](record.message, props);
+    },
+  };
+};

package/tsconfig.json

@@ -0,0 +1,9 @@
+{
+  "extends": "../../tsconfig.json",
+  "compilerOptions": {
+    "outDir": "dist",
+    "rootDir": "src"
+  },
+  "include": ["src"],
+  "exclude": ["**/__tests__/**", "**/*.test.ts", "dist"]
+}

package/tsconfig.tests.json

@@ -0,0 +1,10 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "noEmit": true,
+    "rootDir": "./src",
+    "types": ["bun"]
+  },
+  "include": ["src/**/*.test.ts", "src/__tests__/**/*.ts"],
+  "exclude": []
+}

package/tsconfig.tsbuildinfo

@@ -0,0 +1 @@
+{"root":["./src/index.ts"],"version":"5.9.3"}