@beignet/provider-logger-pino 0.0.33 → 0.0.35

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # @beignet/provider-logger-pino
 
+## 0.0.35
+
+### Patch Changes
+
+- 397f106: Standardize framework-owned operational errors, degrade opaque OpenAPI path parameters safely, and add direct Redis, Pino, and Upstash adapters.
+- 7d0c795: Expose stable named provider types while keeping private config schemas out of package declarations and preserving validated config and contributed-port inference. Drizzle's Postgres and MySQL config schema constants are now internal; use the exported config interfaces for validated shapes.
+
+## 0.0.34
+
+### Patch Changes
+
+- 9345cc9: Stabilize the pre-1.0 public surface around factory-only providers, canonical server and testing imports, consistent memory naming, and the removal of deprecated aliases.
+
 ## 0.0.33
 
 ## 0.0.32

package/README.md

@@ -10,6 +10,10 @@ Use this package when you want `ctx.ports.logger` backed by Pino while keeping
 application code dependent on the stable `LoggerPort` interface from
 `@beignet/core/ports`.
 
+`createPinoLoggerProvider(...)` returns the stable `PinoLoggerProvider` type.
+`LoggerPinoConfig` describes its validated config; the Zod schema remains
+internal.
+
 ## Install
 
 ```bash
@@ -26,13 +30,13 @@ bun add -d pino-pretty
 
 ```ts
 import { createNextServer, createNextServerLoader } from "@beignet/next";
-import { pinoLoggerProvider } from "@beignet/provider-logger-pino";
+import { createPinoLoggerProvider } from "@beignet/provider-logger-pino";
 import { appPorts } from "@/infra/app-ports";
 
 export const getServer = createNextServerLoader(() =>
   createNextServer({
     ports: appPorts,
-    providers: [pinoLoggerProvider],
+    providers: [createPinoLoggerProvider()],
     context: ({ ports }) => ({
       requestId: crypto.randomUUID(),
       ports,
@@ -77,6 +81,23 @@ export const providers = [
 ];
 ```
 
+### Direct adapter
+
+Use `createPinoLogger(...)` when the app owns Pino configuration, transports,
+or destinations:
+
+```ts
+import { createPinoLogger } from "@beignet/provider-logger-pino";
+import pino from "pino";
+
+const destination = pino.destination("./app.log");
+const pinoLogger = pino({ level: "info" }, destination);
+const logger = createPinoLogger({ logger: pinoLogger });
+```
+
+The direct factory only adapts the supplied Pino logger to `LoggerPort`; the
+caller owns flushing and destination shutdown.
+
 ## Usage
 
 ```ts
@@ -93,9 +114,10 @@ log.error("Failed to publish post", { error });
 
 | Export | Purpose |
 | --- | --- |
-| `pinoLoggerProvider` | Default env-backed Beignet provider |
-| `createPinoLoggerProvider` | Provider factory; options override `LOG_*` env values |
-| `CreatePinoLoggerProviderOptions` | Options for `createPinoLoggerProvider` |
+| `createPinoLogger(options)` | Adapt an app-owned Pino logger to `LoggerPort` |
+| `CreatePinoLoggerOptions` | Options for `createPinoLogger()` |
+| `createPinoLoggerProvider(options?)` | Provider factory; omitted options use `LOG_*` env values |
+| `CreatePinoLoggerProviderOptions` | Options for `createPinoLoggerProvider()` |
 | `LoggerPinoConfig` | Validated provider config type |
 | `LoggerPort` | Re-export from `@beignet/core/ports` |
 | `LogLevel` | Re-export from `@beignet/core/ports` |
@@ -103,8 +125,9 @@ log.error("Failed to publish post", { error });
 ## Installed ports
 
 The provider contributes `ctx.ports.logger`, the standard Beignet
-`LoggerPort`. It does not expose a provider-specific escape hatch because child
-loggers and bindings are available through the stable port.
+`LoggerPort`. Use `createPinoLogger(...)` when app infrastructure needs to own
+the underlying Pino logger; application workflows should continue to depend on
+the stable port.
 
 ## Instrumentation
 

package/dist/index.d.ts

@@ -12,11 +12,11 @@
  * @example
  * ```ts
  * import { createNextServer } from "@beignet/next";
- * import { pinoLoggerProvider } from "@beignet/provider-logger-pino";
+ * import { createPinoLoggerProvider } from "@beignet/provider-logger-pino";
  *
  * const server = await createNextServer({
  *   ports: basePorts,
- *   providers: [pinoLoggerProvider],
+ *   providers: [createPinoLoggerProvider()],
  *   // ...
  * });
  *
@@ -29,38 +29,41 @@
  * ```
  */
 import type { LoggerPort } from "@beignet/core/ports";
-import { z } from "zod";
+import { type AnyProviderConfigSchema, type ServiceProvider } from "@beignet/core/providers";
+import { type Logger as PinoLogger } from "pino";
 /**
  * Logger port types re-exported for provider consumers.
  */
 export type { LoggerPort, LogLevel } from "@beignet/core/ports";
 /**
- * Configuration schema for the Pino logger provider.
- * Validates environment variables with LOG_ prefix.
+ * Validated configuration for the Pino logger provider.
  */
-declare const LoggerPinoConfigSchema: z.ZodObject<{
-    LEVEL: z.ZodDefault<z.ZodEnum<{
-        trace: "trace";
-        debug: "debug";
-        info: "info";
-        warn: "warn";
-        error: "error";
-        fatal: "fatal";
-    }>>;
-    FORMAT: z.ZodDefault<z.ZodEnum<{
-        json: "json";
-        pretty: "pretty";
-    }>>;
-    SERVICE: z.ZodOptional<z.ZodString>;
-    TIMESTAMP: z.ZodDefault<z.ZodPipe<z.ZodEnum<{
-        true: "true";
-        false: "false";
-    }>, z.ZodTransform<boolean, "true" | "false">>>;
-}, z.core.$strip>;
+export interface LoggerPinoConfig {
+    LEVEL: "trace" | "debug" | "info" | "warn" | "error" | "fatal";
+    FORMAT: "json" | "pretty";
+    SERVICE?: string;
+    TIMESTAMP: boolean;
+}
+export interface PinoLoggerProviderPorts {
+    logger: LoggerPort;
+}
+/**
+ * Pino logger lifecycle provider with stable contributed-port typing.
+ */
+export type PinoLoggerProvider = ServiceProvider<unknown, AnyProviderConfigSchema<LoggerPinoConfig>, Pick<PinoLoggerProviderPorts, keyof PinoLoggerProviderPorts>>;
+/**
+ * Options for adapting an app-owned Pino logger directly.
+ */
+export interface CreatePinoLoggerOptions {
+    /**
+     * Configured Pino logger. The caller owns its destination and lifecycle.
+     */
+    logger: PinoLogger;
+}
 /**
- * Inferred configuration type for Pino logger provider.
+ * Adapt an app-owned Pino logger to Beignet's stable LoggerPort.
  */
-export type LoggerPinoConfig = z.infer<typeof LoggerPinoConfigSchema>;
+export declare function createPinoLogger(options: CreatePinoLoggerOptions): LoggerPort;
 /**
  * Options for the Pino logger provider factory.
  */
@@ -87,64 +90,5 @@ export interface CreatePinoLoggerProviderOptions {
  *
  * Options override the corresponding `LOG_*` env values.
  */
-export declare function createPinoLoggerProvider(options?: CreatePinoLoggerProviderOptions): import("@beignet/core/providers").ServiceProvider<unknown, z.ZodObject<{
-    LEVEL: z.ZodDefault<z.ZodEnum<{
-        trace: "trace";
-        debug: "debug";
-        info: "info";
-        warn: "warn";
-        error: "error";
-        fatal: "fatal";
-    }>>;
-    FORMAT: z.ZodDefault<z.ZodEnum<{
-        json: "json";
-        pretty: "pretty";
-    }>>;
-    SERVICE: z.ZodOptional<z.ZodString>;
-    TIMESTAMP: z.ZodDefault<z.ZodPipe<z.ZodEnum<{
-        true: "true";
-        false: "false";
-    }>, z.ZodTransform<boolean, "true" | "false">>>;
-}, z.core.$strip>, {
-    logger: LoggerPort;
-}, unknown, void>;
-/**
- * Default env-backed Pino logger provider.
- *
- * Configuration via environment variables:
- * - LOG_LEVEL: Minimum log level (trace/debug/info/warn/error/fatal, default: info)
- * - LOG_FORMAT: Log format (json/pretty, default: json)
- * - LOG_SERVICE: Optional service name for log enrichment
- * - LOG_TIMESTAMP: Whether to include timestamps (true/false, default: true)
- *
- * @example
- * ```ts
- * const server = await createNextServer({
- *   ports: basePorts,
- *   providers: [pinoLoggerProvider],
- *   // ...
- * });
- * ```
- */
-export declare const pinoLoggerProvider: import("@beignet/core/providers").ServiceProvider<unknown, z.ZodObject<{
-    LEVEL: z.ZodDefault<z.ZodEnum<{
-        trace: "trace";
-        debug: "debug";
-        info: "info";
-        warn: "warn";
-        error: "error";
-        fatal: "fatal";
-    }>>;
-    FORMAT: z.ZodDefault<z.ZodEnum<{
-        json: "json";
-        pretty: "pretty";
-    }>>;
-    SERVICE: z.ZodOptional<z.ZodString>;
-    TIMESTAMP: z.ZodDefault<z.ZodPipe<z.ZodEnum<{
-        true: "true";
-        false: "false";
-    }>, z.ZodTransform<boolean, "true" | "false">>>;
-}, z.core.$strip>, {
-    logger: LoggerPort;
-}, unknown, void>;
+export declare function createPinoLoggerProvider(options?: CreatePinoLoggerProviderOptions): PinoLoggerProvider;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAGtD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAYhE;;;GAGG;AACH,QAAA,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;iBA8B1B,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AA8EtE;;GAEG;AACH,MAAM,WAAW,+BAA+B;IAC9C;;OAEG;IACH,KAAK,CAAC,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAClC;;OAEG;IACH,MAAM,CAAC,EAAE,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IACpC;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,GAAE,+BAAoC;;;;;;;;;;;;;;;;;;;;kBA8C9C;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;iBAA6B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EACL,KAAK,uBAAuB,EAE5B,KAAK,eAAe,EACrB,MAAM,yBAAyB,CAAC;AACjC,OAAa,EAAE,KAAK,MAAM,IAAI,UAAU,EAAE,MAAM,MAAM,CAAC;AAGvD;;GAEG;AACH,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAgDhE;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;IAC/D,MAAM,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,UAAU,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,eAAe,CAC9C,OAAO,EACP,uBAAuB,CAAC,gBAAgB,CAAC,EACzC,IAAI,CAAC,uBAAuB,EAAE,MAAM,uBAAuB,CAAC,CAC7D,CAAC;AA8EF;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,MAAM,EAAE,UAAU,CAAC;CACpB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,UAAU,CAE7E;AAED;;GAEG;AACH,MAAM,WAAW,+BAA+B;IAC9C;;OAEG;IACH,KAAK,CAAC,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAClC;;OAEG;IACH,MAAM,CAAC,EAAE,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IACpC;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,GAAE,+BAAoC,GAC5C,kBAAkB,CA+CpB"}

package/dist/index.js

@@ -12,11 +12,11 @@
  * @example
  * ```ts
  * import { createNextServer } from "@beignet/next";
- * import { pinoLoggerProvider } from "@beignet/provider-logger-pino";
+ * import { createPinoLoggerProvider } from "@beignet/provider-logger-pino";
  *
  * const server = await createNextServer({
  *   ports: basePorts,
- *   providers: [pinoLoggerProvider],
+ *   providers: [createPinoLoggerProvider()],
  *   // ...
  * });
  *
@@ -28,7 +28,7 @@
  * log.info("Processing request");
  * ```
  */
-import { createProvider } from "@beignet/core/providers";
+import { createProvider, } from "@beignet/core/providers";
 import pino from "pino";
 import { z } from "zod";
 /**
@@ -79,7 +79,7 @@ const LoggerPinoConfigSchema = z.object({
  * @param bindings - Optional base bindings to add to all log entries
  * @returns Configured Pino logger instance
  */
-function createPinoLogger(config, bindings = {}) {
+function createPinoInstance(config, bindings = {}) {
     const pinoOptions = {
         level: config.LEVEL,
         timestamp: config.TIMESTAMP ? pino.stdTimeFunctions.isoTime : false,
@@ -123,7 +123,7 @@ function createPinoLogger(config, bindings = {}) {
  * @param logger - Pino logger instance to wrap
  * @returns LoggerPort implementation
  */
-function wrapPino(logger) {
+function adaptPinoLogger(logger) {
     return {
         trace: (message, meta) => meta ? logger.trace(meta, message) : logger.trace(message),
         debug: (message, meta) => meta ? logger.debug(meta, message) : logger.debug(message),
@@ -131,9 +131,15 @@ function wrapPino(logger) {
         warn: (message, meta) => meta ? logger.warn(meta, message) : logger.warn(message),
         error: (message, meta) => meta ? logger.error(meta, message) : logger.error(message),
         fatal: (message, meta) => meta ? logger.fatal(meta, message) : logger.fatal(message),
-        child: (bindings) => wrapPino(logger.child(bindings)),
+        child: (bindings) => adaptPinoLogger(logger.child(bindings)),
     };
 }
+/**
+ * Adapt an app-owned Pino logger to Beignet's stable LoggerPort.
+ */
+export function createPinoLogger(options) {
+    return adaptPinoLogger(options.logger);
+}
 /**
  * Create an env-backed Pino logger provider.
  *
@@ -157,7 +163,7 @@ export function createPinoLoggerProvider(options = {}) {
             if (!config) {
                 // Every schema field has a default, so a declared config always
                 // parses; this only guards the typing.
-                throw new Error("[pinoLoggerProvider] Provider config was not loaded.");
+                throw new Error("[createPinoLoggerProvider] Provider config was not loaded.");
             }
             const resolvedConfig = {
                 LEVEL: config.LEVEL,
@@ -171,30 +177,11 @@ export function createPinoLoggerProvider(options = {}) {
                 baseBindings.service = service;
             }
             // Create and configure Pino logger
-            const logger = createPinoLogger(resolvedConfig, baseBindings);
+            const logger = createPinoInstance(resolvedConfig, baseBindings);
             // Wrap logger to match LoggerPort interface
-            const port = wrapPino(logger);
+            const port = createPinoLogger({ logger });
             return { ports: { logger: port } };
         },
     });
 }
-/**
- * Default env-backed Pino logger provider.
- *
- * Configuration via environment variables:
- * - LOG_LEVEL: Minimum log level (trace/debug/info/warn/error/fatal, default: info)
- * - LOG_FORMAT: Log format (json/pretty, default: json)
- * - LOG_SERVICE: Optional service name for log enrichment
- * - LOG_TIMESTAMP: Whether to include timestamps (true/false, default: true)
- *
- * @example
- * ```ts
- * const server = await createNextServer({
- *   ports: basePorts,
- *   providers: [pinoLoggerProvider],
- *   // ...
- * });
- * ```
- */
-export const pinoLoggerProvider = createPinoLoggerProvider();
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,IAAmC,MAAM,MAAM,CAAC;AACvD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB;;;;;GAKG;AACH,MAAM,aAAa,GAAG,CAAC;KACpB,IAAI,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACvB,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC;AAE1C;;;GAGG;AACH,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC;;;;OAIG;IACH,KAAK,EAAE,CAAC;SACL,IAAI,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC1D,OAAO,CAAC,MAAM,CAAC;IAElB;;;;;OAKG;IACH,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;IAElD;;;OAGG;IACH,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAE9B;;;;OAIG;IACH,SAAS,EAAE,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC;CACvC,CAAC,CAAC;AAOH;;;;;;GAMG;AACH,SAAS,gBAAgB,CACvB,MAAwB,EACxB,WAAoC,EAAE;IAEtC,MAAM,WAAW,GAAuB;QACtC,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,SAAS,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK;QACnE,IAAI,EAAE,QAAQ;KACf,CAAC;IAEF,uBAAuB;IACvB,IAAI,MAAM,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/B,IAAI,CAAC;YACH,oEAAoE;YACpE,qEAAqE;YACrE,yDAAyD;YACzD,OAAO,IAAI,CAAC;gBACV,GAAG,WAAW;gBACd,SAAS,EAAE;oBACT,MAAM,EAAE,aAAa;oBACrB,OAAO,EAAE;wBACP,QAAQ,EAAE,IAAI;wBACd,aAAa,EAAE,YAAY;wBAC3B,MAAM,EAAE,cAAc;qBACvB;iBACF;aACF,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,MAAM,EAAE,CAAC;YAChB,4DAA4D;YAC5D,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC;YACrC,UAAU,CAAC,IAAI,CACb,gEAAgE;gBAC9D,6EAA6E,CAChF,CAAC;YACF,OAAO,UAAU,CAAC;QACpB,CAAC;IACH,CAAC;IAED,yBAAyB;IACzB,OAAO,IAAI,CAAC,WAAW,CAAC,CAAC;AAC3B,CAAC;AAED;;;;;;;;GAQG;AACH,SAAS,QAAQ,CAAC,MAAkB;IAClC,OAAO;QACL,KAAK,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,CACvB,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC;QAC5D,KAAK,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,CACvB,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC;QAC5D,IAAI,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,CACtB,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC;QAC1D,IAAI,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,CACtB,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC;QAC1D,KAAK,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,CACvB,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC;QAC5D,KAAK,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,CACvB,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC;QAC5D,KAAK,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;KACtD,CAAC;AACJ,CAAC;AAwBD;;;;GAIG;AACH,MAAM,UAAU,wBAAwB,CACtC,UAA2C,EAAE;IAE7C,OAAO,cAAc,CAAC;QACpB,IAAI,EAAE,aAAa;QAEnB,MAAM,EAAE;YACN,MAAM,EAAE,sBAAsB;YAC9B,SAAS,EAAE,MAAM;YACjB,mEAAmE;YACnE,SAAS,EAAE;gBACT,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,SAAS,EAAE,OAAO,CAAC,SAAS;gBAC5B,OAAO,EAAE,OAAO,CAAC,OAAO;aACzB;SACF;QAED,KAAK,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE;YACpB,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,gEAAgE;gBAChE,uCAAuC;gBACvC,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;YAC1E,CAAC;YAED,MAAM,cAAc,GAAqB;gBACvC,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,SAAS,EAAE,MAAM,CAAC,SAAS;aAC5B,CAAC;YAEF,wBAAwB;YACxB,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;YAC/B,MAAM,YAAY,GAA4B,EAAE,CAAC;YACjD,IAAI,OAAO,EAAE,CAAC;gBACZ,YAAY,CAAC,OAAO,GAAG,OAAO,CAAC;YACjC,CAAC;YAED,mCAAmC;YACnC,MAAM,MAAM,GAAG,gBAAgB,CAAC,cAAc,EAAE,YAAY,CAAC,CAAC;YAE9D,4CAA4C;YAC5C,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;YAE9B,OAAO,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC;QACrC,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,wBAAwB,EAAE,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@beignet/provider-logger-pino",
-  "version": "0.0.33",
+  "version": "0.0.35",
   "type": "module",
   "description": "Pino logger provider for Beignet - adds logger port using pino",
   "main": "./dist/index.js",
@@ -88,7 +88,7 @@
       "registration": {
         "required": true,
         "tokens": [
-          "pinoLoggerProvider"
+          "createPinoLoggerProvider"
         ]
       }
     }

package/src/index.ts

@@ -12,11 +12,11 @@
  * @example
  * ```ts
  * import { createNextServer } from "@beignet/next";
- * import { pinoLoggerProvider } from "@beignet/provider-logger-pino";
+ * import { createPinoLoggerProvider } from "@beignet/provider-logger-pino";
  *
  * const server = await createNextServer({
  *   ports: basePorts,
- *   providers: [pinoLoggerProvider],
+ *   providers: [createPinoLoggerProvider()],
  *   // ...
  * });
  *
@@ -30,7 +30,11 @@
  */
 
 import type { LoggerPort } from "@beignet/core/ports";
-import { createProvider } from "@beignet/core/providers";
+import {
+  type AnyProviderConfigSchema,
+  createProvider,
+  type ServiceProvider,
+} from "@beignet/core/providers";
 import pino, { type Logger as PinoLogger } from "pino";
 import { z } from "zod";
 
@@ -83,12 +87,30 @@ const LoggerPinoConfigSchema = z.object({
    * Default: true
    */
   TIMESTAMP: BooleanString.default(true),
-});
+}) satisfies z.ZodType<LoggerPinoConfig>;
 
 /**
- * Inferred configuration type for Pino logger provider.
+ * Validated configuration for the Pino logger provider.
  */
-export type LoggerPinoConfig = z.infer<typeof LoggerPinoConfigSchema>;
+export interface LoggerPinoConfig {
+  LEVEL: "trace" | "debug" | "info" | "warn" | "error" | "fatal";
+  FORMAT: "json" | "pretty";
+  SERVICE?: string;
+  TIMESTAMP: boolean;
+}
+
+export interface PinoLoggerProviderPorts {
+  logger: LoggerPort;
+}
+
+/**
+ * Pino logger lifecycle provider with stable contributed-port typing.
+ */
+export type PinoLoggerProvider = ServiceProvider<
+  unknown,
+  AnyProviderConfigSchema<LoggerPinoConfig>,
+  Pick<PinoLoggerProviderPorts, keyof PinoLoggerProviderPorts>
+>;
 
 /**
  * Create a Pino logger instance with the given configuration.
@@ -97,7 +119,7 @@ export type LoggerPinoConfig = z.infer<typeof LoggerPinoConfigSchema>;
  * @param bindings - Optional base bindings to add to all log entries
  * @returns Configured Pino logger instance
  */
-function createPinoLogger(
+function createPinoInstance(
   config: LoggerPinoConfig,
   bindings: Record<string, unknown> = {},
 ): PinoLogger {
@@ -148,7 +170,7 @@ function createPinoLogger(
  * @param logger - Pino logger instance to wrap
  * @returns LoggerPort implementation
  */
-function wrapPino(logger: PinoLogger): LoggerPort {
+function adaptPinoLogger(logger: PinoLogger): LoggerPort {
   return {
     trace: (message, meta) =>
       meta ? logger.trace(meta, message) : logger.trace(message),
@@ -162,10 +184,27 @@ function wrapPino(logger: PinoLogger): LoggerPort {
       meta ? logger.error(meta, message) : logger.error(message),
     fatal: (message, meta) =>
       meta ? logger.fatal(meta, message) : logger.fatal(message),
-    child: (bindings) => wrapPino(logger.child(bindings)),
+    child: (bindings) => adaptPinoLogger(logger.child(bindings)),
   };
 }
 
+/**
+ * Options for adapting an app-owned Pino logger directly.
+ */
+export interface CreatePinoLoggerOptions {
+  /**
+   * Configured Pino logger. The caller owns its destination and lifecycle.
+   */
+  logger: PinoLogger;
+}
+
+/**
+ * Adapt an app-owned Pino logger to Beignet's stable LoggerPort.
+ */
+export function createPinoLogger(options: CreatePinoLoggerOptions): LoggerPort {
+  return adaptPinoLogger(options.logger);
+}
+
 /**
  * Options for the Pino logger provider factory.
  */
@@ -195,7 +234,7 @@ export interface CreatePinoLoggerProviderOptions {
  */
 export function createPinoLoggerProvider(
   options: CreatePinoLoggerProviderOptions = {},
-) {
+): PinoLoggerProvider {
   return createProvider({
     name: "logger-pino",
 
@@ -215,7 +254,9 @@ export function createPinoLoggerProvider(
       if (!config) {
         // Every schema field has a default, so a declared config always
         // parses; this only guards the typing.
-        throw new Error("[pinoLoggerProvider] Provider config was not loaded.");
+        throw new Error(
+          "[createPinoLoggerProvider] Provider config was not loaded.",
+        );
       }
 
       const resolvedConfig: LoggerPinoConfig = {
@@ -232,32 +273,12 @@ export function createPinoLoggerProvider(
       }
 
       // Create and configure Pino logger
-      const logger = createPinoLogger(resolvedConfig, baseBindings);
+      const logger = createPinoInstance(resolvedConfig, baseBindings);
 
       // Wrap logger to match LoggerPort interface
-      const port = wrapPino(logger);
+      const port = createPinoLogger({ logger });
 
-      return { ports: { logger: port } };
+      return { ports: { logger: port } satisfies PinoLoggerProviderPorts };
     },
   });
 }
-
-/**
- * Default env-backed Pino logger provider.
- *
- * Configuration via environment variables:
- * - LOG_LEVEL: Minimum log level (trace/debug/info/warn/error/fatal, default: info)
- * - LOG_FORMAT: Log format (json/pretty, default: json)
- * - LOG_SERVICE: Optional service name for log enrichment
- * - LOG_TIMESTAMP: Whether to include timestamps (true/false, default: true)
- *
- * @example
- * ```ts
- * const server = await createNextServer({
- *   ports: basePorts,
- *   providers: [pinoLoggerProvider],
- *   // ...
- * });
- * ```
- */
-export const pinoLoggerProvider = createPinoLoggerProvider();