@ontrails/logtape 1.0.0-beta.39 → 1.0.0-beta.43

package/CHANGELOG.md

@@ -1,142 +1,15 @@
-# @ontrails/logtape
+# Changelog
 
-## 1.0.0-beta.39
+## 1.0.0-beta.43
 
-## 1.0.0-beta.38
+### Minor Changes
 
-## 1.0.0-beta.37
+- [`50e2779`](https://github.com/outfitter-dev/trails/commit/50e27796d074851bccd57d7df009db749757b457): Extract the real `@ontrails/logtape` and `@ontrails/pino` adapters from the
+  temporary observability subpaths. The new packages own their namesake foreign
+  dependencies and preserve Trails record metadata, levels, redaction boundaries,
+  and lifecycle behavior; the old subpaths are removed in the pre-v1 hard cut.
 
-## 1.0.0-beta.36
+  Add governed Regrade transitions for both exact import replacements and expose
+  the observability adapter target through the shared adapter readiness check.
 
-## 1.0.0-beta.35
-
-## 1.0.0-beta.34
-
-## 1.0.0-beta.33
-
-## 1.0.0-beta.32
-
-### Patch Changes
-
-- @ontrails/observe@1.0.0-beta.32
-
-## 1.0.0-beta.31
-
-### Patch Changes
-
-- @ontrails/observe@1.0.0-beta.31
-
-## 1.0.0-beta.30
-
-### Patch Changes
-
-- @ontrails/observe@1.0.0-beta.30
-
-## 1.0.0-beta.29
-
-### Patch Changes
-
-- @ontrails/observe@1.0.0-beta.29
-
-## 1.0.0-beta.28
-
-### Patch Changes
-
-- @ontrails/observe@1.0.0-beta.28
-
-## 1.0.0-beta.27
-
-### Patch Changes
-
-- @ontrails/observe@1.0.0-beta.27
-
-## 1.0.0-beta.26
-
-### Patch Changes
-
-- @ontrails/observe@1.0.0-beta.26
-
-## 1.0.0-beta.25
-
-### Patch Changes
-
-- @ontrails/observe@1.0.0-beta.25
-
-## 1.0.0-beta.24
-
-### Patch Changes
-
-- @ontrails/observe@1.0.0-beta.24
-
-## 1.0.0-beta.23
-
-### Patch Changes
-
-- @ontrails/observe@1.0.0-beta.23
-
-## 1.0.0-beta.22
-
-### Patch Changes
-
-- @ontrails/observe@1.0.0-beta.22
-
-## 1.0.0-beta.21
-
-### Patch Changes
-
-- @ontrails/observe@1.0.0-beta.21
-
-## 1.0.0-beta.20
-
-### Patch Changes
-
-- @ontrails/observe@1.0.0-beta.20
-
-## 1.0.0-beta.19
-
-### Patch Changes
-
-- Updated dependencies [1eb5bdc]
-  - @ontrails/observe@1.0.0-beta.19
-
-## 1.0.0-beta.18
-
-### Patch Changes
-
-- Updated dependencies [bf44972]
-- Updated dependencies [e0ae995]
-  - @ontrails/observe@1.0.0-beta.18
-
-## 1.0.0-beta.17
-
-### Patch Changes
-
-- @ontrails/observe@1.0.0-beta.17
-
-## 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/observe@1.0.0-beta.15
+All notable changes to this package are documented through the Trails release process.

package/README.md

@@ -1,16 +1,36 @@
 # @ontrails/logtape
 
-LogTape adapter for `@ontrails/observe`.
+Real LogTape adapter for Trails observability. This extracted package owns the LogTape dependency boundary, keeping `@ontrails/observability` independent of foreign logging libraries.
 
-Use `createLogtapeSink(...)` when you already have a LogTape-shaped logger and want Trails log records to flow into it:
+## Usage
 
 ```typescript
-import { getLogger } from '@logtape/logtape';
+import { configure, getConsoleSink } from '@logtape/logtape';
 import { createLogtapeSink } from '@ontrails/logtape';
 
-const sink = createLogtapeSink({ logger: getLogger('app') });
+await configure({
+  loggers: [{ category: 'app', lowestLevel: 'info', sinks: ['console'] }],
+  sinks: { console: getConsoleSink() },
+});
+
+const sink = createLogtapeSink();
+sink.write({
+  category: 'app.http',
+  level: 'info',
+  message: 'request received',
+  metadata: { requestId: 'req_123' },
+  timestamp: new Date(),
+});
+```
+
+The application owns `configure()`; this library only resolves or accepts a configured LogTape logger. It forwards Trails records through LogTape's native `emit()` integration path, preserving the record timestamp, category, structured metadata, and the `warn` to `warning` level translation. Trails redaction occurs before the record reaches this adapter, and `silent` records do not reach LogTape.
+
+## Installation
+
+```bash
+bun add @ontrails/observability@beta @ontrails/logtape@beta
 ```
 
-The package does not depend on `@logtape/logtape`; it accepts any object shaped like a LogTape logger through `LogtapeLoggerLike`.
+## Migration
 
-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`.
+This package is the final LogTape adapter in the pre-v1 hard cut. No compatibility subpath remains; see the logging migration guide for the explicit historical import map.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ontrails/logtape",
-  "version": "1.0.0-beta.39",
+  "version": "1.0.0-beta.43",
   "files": [
     "src/**/*.ts",
     "!src/**/__tests__/**",
@@ -21,7 +21,16 @@
     "lint": "oxlint ./src",
     "clean": "rm -rf dist *.tsbuildinfo"
   },
+  "dependencies": {
+    "@logtape/logtape": "^2.2.4"
+  },
   "peerDependencies": {
-    "@ontrails/observe": "^1.0.0-beta.39"
+    "@ontrails/observability": "^1.0.0-beta.43",
+    "zod": "^4.3.5"
+  },
+  "trails": {
+    "adapter": {
+      "target": "observability"
+    }
   }
 }

package/src/index.ts

@@ -1,68 +1,59 @@
-import type { LogRecord, LogSink } from '@ontrails/observe';
+import { getLogger } from '@logtape/logtape';
+import type { Logger } from '@logtape/logtape';
 
-// ---------------------------------------------------------------------------
-// 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
-// ---------------------------------------------------------------------------
+import type { LogLevel, LogRecord, LogSink } from '@ontrails/observability';
 
 export interface LogtapeSinkOptions {
-  /** An existing logtape logger (or compatible object) to forward records to. */
-  readonly logger: LogtapeLoggerLike;
+  /** Existing configured LogTape logger. The application owns LogTape setup. */
+  readonly logger?: Logger | undefined;
+  /** Sink name exposed to Trails observe configuration. Defaults to `logtape`. */
+  readonly name?: string | undefined;
 }
 
-// ---------------------------------------------------------------------------
-// createLogtapeSink
-// ---------------------------------------------------------------------------
+type ForwardMethod = 'trace' | 'debug' | 'info' | 'warning' | 'error' | 'fatal';
 
-type ForwardMethod = 'trace' | 'debug' | 'info' | 'warn' | 'error' | 'fatal';
-
-const LEVEL_MAP: Record<string, ForwardMethod> = {
+const LEVEL_MAP: Record<LogLevel, ForwardMethod | undefined> = {
   debug: 'debug',
   error: 'error',
   fatal: 'fatal',
   info: 'info',
+  silent: undefined,
   trace: 'trace',
-  warn: 'warn',
+  warn: 'warning',
 };
 
+const buildProperties = (record: LogRecord): Record<string, unknown> => ({
+  ...record.metadata,
+  category: record.category,
+  timestamp: record.timestamp.toISOString(),
+});
+
 /**
- * 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.
+ * Create a Trails sink backed by LogTape. The adapter deliberately never calls
+ * `configure()`: libraries read the application-owned logger configuration.
  */
-export const createLogtapeSink = (options: LogtapeSinkOptions): LogSink => {
-  const { logger } = options;
+export const createLogtapeSink = (
+  options: LogtapeSinkOptions = {}
+): LogSink => {
+  const configuredLogger = options.logger;
 
   return {
-    name: 'logtape',
+    name: options.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);
+      const logger =
+        configuredLogger ??
+        getLogger(record.category.split('.').filter(Boolean));
+      logger.emit({
+        level: method,
+        message: [record.message],
+        properties: buildProperties(record),
+        rawMessage: record.message,
+        timestamp: record.timestamp.getTime(),
+      });
     },
   };
 };