@ontrails/logtape 1.0.0-beta.15 → 1.0.0-beta.16

package/CHANGELOG.md

@@ -1,7 +1,29 @@
 # @ontrails/logtape
 
+## 1.0.0-beta.16
+
+### Major Changes
+
+- 68f70fb: Retarget the LogTape adapter to `@ontrails/observe` log sink types and use `createLogtapeSink` as the canonical factory name.
+  Refresh the LogTape forwarding migration note for consumers moving off the retired logging package.
+
+### Patch Changes
+
+- 6300f70: Refresh source comments and test labels for retired connector terminology as adapter guardrails become strict.
+- a8997ed: Add migration guidance for the retired `@ontrails/logging` package and align observability README examples around `@ontrails/observe`, `@ontrails/tracing`, and `@ontrails/logtape`.
+- d40430d: Remove the retired `@ontrails/logging` workspace from the prerelease package set. Use `@ontrails/observe` for log and trace sink contracts and `@ontrails/logtape` for LogTape forwarding.
+- Updated dependencies [6300f70]
+- Updated dependencies [e898cc4]
+- Updated dependencies [a8997ed]
+- Updated dependencies [fe03945]
+- Updated dependencies [d40430d]
+- Updated dependencies [49c2e7d]
+- Updated dependencies [9cdb0f2]
+- Updated dependencies [22c6c06]
+  - @ontrails/observe@1.0.0-beta.16
+
 ## 1.0.0-beta.15
 
 ### Patch Changes
 
-- @ontrails/logging@1.0.0-beta.15
+- @ontrails/observe@1.0.0-beta.15

package/README.md

@@ -1,3 +1,20 @@
 # @ontrails/logtape
 
-The logtape sink for `@ontrails/logging`. See `@ontrails/logging` for the logger API; this package only provides the optional logtape forwarding sink.
+LogTape adapter for `@ontrails/observe`.
+
+Use `createLogtapeSink(...)` when you already have a LogTape-shaped logger and
+want Trails log records to flow into it:
+
+```typescript
+import { getLogger } from '@logtape/logtape';
+import { createLogtapeSink } from '@ontrails/logtape';
+
+const sink = createLogtapeSink({ logger: getLogger('app') });
+```
+
+The package does not depend on `@logtape/logtape`; it accepts any object shaped
+like a LogTape logger through `LogtapeLoggerLike`.
+
+If you previously depended on `@ontrails/logging` for LogTape forwarding, move
+that forwarding code to `@ontrails/logtape` and pair it with the sink contracts
+from `@ontrails/observe`.

package/package.json

@@ -1,6 +1,14 @@
 {
   "name": "@ontrails/logtape",
-  "version": "1.0.0-beta.15",
+  "version": "1.0.0-beta.16",
+  "files": [
+    "src/**/*.ts",
+    "!src/**/__tests__/**",
+    "!src/**/*.test.ts",
+    "!src/**/*.test-d.ts",
+    "README.md",
+    "CHANGELOG.md"
+  ],
   "type": "module",
   "exports": {
     ".": "./src/index.ts",
@@ -14,6 +22,6 @@
     "clean": "rm -rf dist *.tsbuildinfo"
   },
   "peerDependencies": {
-    "@ontrails/logging": "^1.0.0-beta.14"
+    "@ontrails/observe": "^1.0.0-beta.15"
   }
 }

package/src/index.ts

@@ -1,4 +1,4 @@
-import type { LogRecord, LogSink } from '@ontrails/logging';
+import type { LogRecord, LogSink } from '@ontrails/observe';
 
 // ---------------------------------------------------------------------------
 // Minimal logtape logger interface (avoids importing @logtape/logtape)
@@ -27,7 +27,7 @@ export interface LogtapeSinkOptions {
 }
 
 // ---------------------------------------------------------------------------
-// logtapeSink
+// createLogtapeSink
 // ---------------------------------------------------------------------------
 
 type ForwardMethod = 'trace' | 'debug' | 'info' | 'warn' | 'error' | 'fatal';
@@ -42,11 +42,11 @@ const LEVEL_MAP: Record<string, ForwardMethod> = {
 };
 
 /**
- * Sink connector that forwards `LogRecord` instances to an existing logtape
+ * Sink adapter 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 => {
+export const createLogtapeSink = (options: LogtapeSinkOptions): LogSink => {
   const { logger } = options;
 
   return {

package/.turbo/turbo-build.log

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

package/.turbo/turbo-lint.log

@@ -1,3 +0,0 @@
-$ 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

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

package/dist/index.d.ts

@@ -1,24 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

@@ -1,31 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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/src/__tests__/logtape.test.ts

@@ -1,74 +0,0 @@
-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/tsconfig.json

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

package/tsconfig.tests.json

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

package/tsconfig.tsbuildinfo

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