@ontrails/logtape 0.2.0

package/CHANGELOG.md

@@ -0,0 +1,62 @@
+# Changelog
+
+## 0.2.0
+
+### Patch Changes
+
+- [`664e8bb`](https://github.com/outfitter-dev/trails/commit/664e8bb049e61f1d47cec1dd246606707af5d1a8): Point public installation examples at exact approved 0.2.0 versions and distinguish the prepared source release from pending npm publication.
+- [`b3ddf91`](https://github.com/outfitter-dev/trails/commit/b3ddf918ada8211f44983512e2bbdfbc5b66d722): Prepare the first normal Trails release at `0.2.0` on `latest`, replacing the unpublished 1.0.0 source release. The target advances the original `0.1.0` source minor, which was never published under the current package names. Public packages remain in lockstep. Update consumer installation guidance and provide a temporary manifest bridge for old 1.0 beta sources. Published beta versions remain unchanged; minor 0.x releases may carry documented breaking changes.
+
+  The `1.0.0` section retained below records an unpublished preparation, not an npm release. Its accumulated changes are included in `0.2.0`; the section remains as source history alongside the published beta entries.
+
+## 1.0.0
+
+### Minor Changes
+
+- [`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.
+
+  Add governed Regrade transitions for both exact import replacements and expose
+  the observability adapter target through the shared adapter readiness check.
+
+### Patch Changes
+
+- [`b1fbe57`](https://github.com/outfitter-dev/trails/commit/b1fbe574e6f44d1fecb5e3a000270955c0a77b7b): Publish Bun-validated package tarballs through an npm trusted-publishing adapter
+  binding, add exact repository metadata for each public workspace package, and
+  correct the native Bun release descriptor to its pack-only runtime boundary.
+
+## 1.0.0-beta.50
+
+## 1.0.0-beta.49
+
+## 1.0.0-beta.48
+
+## 1.0.0-beta.47
+
+## 1.0.0-beta.46
+
+## 1.0.0-beta.45
+
+## 1.0.0-beta.44
+
+### Patch Changes
+
+- [`b1fbe57`](https://github.com/outfitter-dev/trails/commit/b1fbe574e6f44d1fecb5e3a000270955c0a77b7b): Publish Bun-validated package tarballs through an npm trusted-publishing adapter
+  binding, add exact repository metadata for each public workspace package, and
+  correct the native Bun release descriptor to its pack-only runtime boundary.
+
+## 1.0.0-beta.43
+
+### Minor Changes
+
+- [`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.
+
+  Add governed Regrade transitions for both exact import replacements and expose
+  the observability adapter target through the shared adapter readiness check.
+
+All notable changes to this package are documented through the Trails release process.

package/README.md

@@ -0,0 +1,38 @@
+# @ontrails/logtape
+
+Real LogTape adapter for Trails observability. This extracted package owns the LogTape dependency boundary, keeping `@ontrails/observability` independent of foreign logging libraries.
+
+## Usage
+
+```typescript
+import { configure, getConsoleSink } from '@logtape/logtape';
+import { createLogtapeSink } from '@ontrails/logtape';
+
+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
+
+These commands target stable `0.2.0`. Run them after that version is published to npm.
+
+```bash
+bun add --exact @ontrails/observability@0.2.0 @ontrails/logtape@0.2.0
+```
+
+## Migration
+
+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

@@ -0,0 +1,41 @@
+{
+  "name": "@ontrails/logtape",
+  "version": "0.2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/outfitter-dev/trails.git",
+    "directory": "adapters/logtape"
+  },
+  "files": [
+    "src/**/*.ts",
+    "!src/**/__tests__/**",
+    "!src/**/*.test.ts",
+    "!src/**/*.test-d.ts",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "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"
+  },
+  "dependencies": {
+    "@logtape/logtape": "^2.2.4"
+  },
+  "peerDependencies": {
+    "@ontrails/observability": "^0.2.0",
+    "zod": "^4.3.5"
+  },
+  "trails": {
+    "adapter": {
+      "target": "observability"
+    }
+  }
+}

package/src/index.ts

@@ -0,0 +1,59 @@
+import { getLogger } from '@logtape/logtape';
+import type { Logger } from '@logtape/logtape';
+
+import type { LogLevel, LogRecord, LogSink } from '@ontrails/observability';
+
+export interface LogtapeSinkOptions {
+  /** 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;
+}
+
+type ForwardMethod = 'trace' | 'debug' | 'info' | 'warning' | 'error' | 'fatal';
+
+const LEVEL_MAP: Record<LogLevel, ForwardMethod | undefined> = {
+  debug: 'debug',
+  error: 'error',
+  fatal: 'fatal',
+  info: 'info',
+  silent: undefined,
+  trace: 'trace',
+  warn: 'warning',
+};
+
+const buildProperties = (record: LogRecord): Record<string, unknown> => ({
+  ...record.metadata,
+  category: record.category,
+  timestamp: record.timestamp.toISOString(),
+});
+
+/**
+ * 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 configuredLogger = options.logger;
+
+  return {
+    name: options.name ?? 'logtape',
+    write(record: LogRecord): void {
+      const method = LEVEL_MAP[record.level];
+      if (method === undefined) {
+        return;
+      }
+      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(),
+      });
+    },
+  };
+};