@beignet/provider-logger-pino 0.0.31 → 0.0.32

package/CHANGELOG.md

@@ -1,5 +1,42 @@
 # @beignet/provider-logger-pino
 
+## 0.0.32
+
+### Patch Changes
+
+- f759611: Provider factory options now resolve through one framework-owned rule:
+  `ProviderConfigDef` gains an `overrides` map that merges defined values over
+  env-derived input before validation, and every first-party provider factory
+  uses it instead of hand-rolled schema defaults and setup-time fallbacks. The
+  precedence is now uniform — defined factory options win over environment
+  variables in all thirteen providers. This flips the previous env-wins
+  behavior of `provider-cache-redis`, `provider-locks-redis`, and the storage,
+  search, and blob providers; set the env var (or drop the option) if you
+  relied on env winning. `installProviderForTest(...)` gains an `env` option
+  that resolves config through the same loader, and unreachable missing-config
+  guards in the pino and inngest factories are gone.
+- eb680ef: Provider naming now follows one implementation-first order matching the
+  factories. `@beignet/provider-redis` is renamed `@beignet/provider-cache-redis`
+  (the package fills the cache port; the raw client stays as the
+  `ctx.ports.redis` escape hatch) with `redisCacheProvider`,
+  `createRedisCacheProvider`, and provider name `cache-redis` matching
+  `locks-redis`. Default consts flip to implementation-first:
+  `loggerPinoProvider` is now `pinoLoggerProvider`, `mailResendProvider` is now
+  `resendMailProvider`, and `mailSmtpProvider` is now `smtpMailProvider`.
+  CLI starter templates and the `redis-cache` provider preset wire the new
+  names. No aliases are kept.
+- 671b986: Every provider package now exposes a `createXProvider(options)` factory, so
+  env-only configuration is a convenience rather than the only path. New
+  factories: `createPinoLoggerProvider`, `createResendMailProvider`,
+  `createSmtpMailProvider`, `createStripePaymentsProvider`,
+  `createUpstashRateLimitProvider`, and `createInngestJobsProvider`. Options
+  mirror each provider's env config fields and override env-derived values; the
+  default consts keep their behavior and now simply call their factory. (The
+  consts themselves are renamed to implementation-first order —
+  `pinoLoggerProvider`, `resendMailProvider`, `smtpMailProvider` — in this
+  release's provider naming normalization; `stripePaymentsProvider`,
+  `upstashRateLimitProvider`, and `inngestJobsProvider` already followed it.)
+
 ## 0.0.31
 
 ## 0.0.30

package/README.md

@@ -26,13 +26,13 @@ bun add -d pino-pretty
 
 ```ts
 import { createNextServer, createNextServerLoader } from "@beignet/next";
-import { loggerPinoProvider } from "@beignet/provider-logger-pino";
+import { pinoLoggerProvider } from "@beignet/provider-logger-pino";
 import { appPorts } from "@/infra/app-ports";
 
 export const getServer = createNextServerLoader(() =>
   createNextServer({
     ports: appPorts,
-    providers: [loggerPinoProvider],
+    providers: [pinoLoggerProvider],
     context: ({ ports }) => ({
       requestId: crypto.randomUUID(),
       ports,
@@ -60,6 +60,23 @@ The provider reads `LOG_`-prefixed environment variables:
 `LOG_FORMAT=pretty` requires `pino-pretty`. If it is unavailable, the provider
 falls back to JSON logging and emits a warning.
 
+Use `createPinoLoggerProvider(...)` when you want to pass options directly
+instead of relying only on `LOG_*` env vars. Options override env-derived
+values:
+
+```ts
+import { createPinoLoggerProvider } from "@beignet/provider-logger-pino";
+
+export const providers = [
+  createPinoLoggerProvider({
+    level: "debug",
+    format: "pretty",
+    service: "api",
+    timestamp: true,
+  }),
+];
+```
+
 ## Usage
 
 ```ts
@@ -76,7 +93,9 @@ log.error("Failed to publish post", { error });
 
 | Export | Purpose |
 | --- | --- |
-| `loggerPinoProvider` | Ready-to-install Beignet provider |
+| `pinoLoggerProvider` | Default env-backed Beignet provider |
+| `createPinoLoggerProvider` | Provider factory; options override `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` |

package/dist/index.d.ts

@@ -12,11 +12,11 @@
  * @example
  * ```ts
  * import { createNextServer } from "@beignet/next";
- * import { loggerPinoProvider } from "@beignet/provider-logger-pino";
+ * import { pinoLoggerProvider } from "@beignet/provider-logger-pino";
  *
  * const server = await createNextServer({
  *   ports: basePorts,
- *   providers: [loggerPinoProvider],
+ *   providers: [pinoLoggerProvider],
  *   // ...
  * });
  *
@@ -62,7 +62,54 @@ declare const LoggerPinoConfigSchema: z.ZodObject<{
  */
 export type LoggerPinoConfig = z.infer<typeof LoggerPinoConfigSchema>;
 /**
- * Pino logger provider that extends ports with structured logging capabilities.
+ * Options for the Pino logger provider factory.
+ */
+export interface CreatePinoLoggerProviderOptions {
+    /**
+     * Minimum log level. Overrides `LOG_LEVEL`.
+     */
+    level?: LoggerPinoConfig["LEVEL"];
+    /**
+     * Log format. Overrides `LOG_FORMAT`.
+     */
+    format?: LoggerPinoConfig["FORMAT"];
+    /**
+     * Service name added to log bindings. Overrides `LOG_SERVICE`.
+     */
+    service?: string;
+    /**
+     * Whether to include timestamps in log entries. Overrides `LOG_TIMESTAMP`.
+     */
+    timestamp?: boolean;
+}
+/**
+ * Create an env-backed Pino logger provider.
+ *
+ * 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)
@@ -74,12 +121,12 @@ export type LoggerPinoConfig = z.infer<typeof LoggerPinoConfigSchema>;
  * ```ts
  * const server = await createNextServer({
  *   ports: basePorts,
- *   providers: [loggerPinoProvider],
+ *   providers: [pinoLoggerProvider],
  *   // ...
  * });
  * ```
  */
-export declare const loggerPinoProvider: import("@beignet/core/providers").ServiceProvider<unknown, z.ZodObject<{
+export declare const pinoLoggerProvider: import("@beignet/core/providers").ServiceProvider<unknown, z.ZodObject<{
     LEVEL: z.ZodDefault<z.ZodEnum<{
         trace: "trace";
         debug: "debug";

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;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;iBA8B7B,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;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"}

package/dist/index.js

@@ -12,11 +12,11 @@
  * @example
  * ```ts
  * import { createNextServer } from "@beignet/next";
- * import { loggerPinoProvider } from "@beignet/provider-logger-pino";
+ * import { pinoLoggerProvider } from "@beignet/provider-logger-pino";
  *
  * const server = await createNextServer({
  *   ports: basePorts,
- *   providers: [loggerPinoProvider],
+ *   providers: [pinoLoggerProvider],
  *   // ...
  * });
  *
@@ -135,7 +135,51 @@ function wrapPino(logger) {
     };
 }
 /**
- * Pino logger provider that extends ports with structured logging capabilities.
+ * Create an env-backed Pino logger provider.
+ *
+ * Options override the corresponding `LOG_*` env values.
+ */
+export function createPinoLoggerProvider(options = {}) {
+    return createProvider({
+        name: "logger-pino",
+        config: {
+            schema: LoggerPinoConfigSchema,
+            envPrefix: "LOG_",
+            // Defined options win over env-derived values at config load time.
+            overrides: {
+                LEVEL: options.level,
+                FORMAT: options.format,
+                TIMESTAMP: options.timestamp,
+                SERVICE: options.service,
+            },
+        },
+        async setup({ config }) {
+            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.");
+            }
+            const resolvedConfig = {
+                LEVEL: config.LEVEL,
+                FORMAT: config.FORMAT,
+                TIMESTAMP: config.TIMESTAMP,
+            };
+            // Prepare base bindings
+            const service = config.SERVICE;
+            const baseBindings = {};
+            if (service) {
+                baseBindings.service = service;
+            }
+            // Create and configure Pino logger
+            const logger = createPinoLogger(resolvedConfig, baseBindings);
+            // Wrap logger to match LoggerPort interface
+            const port = wrapPino(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)
@@ -147,32 +191,10 @@ function wrapPino(logger) {
  * ```ts
  * const server = await createNextServer({
  *   ports: basePorts,
- *   providers: [loggerPinoProvider],
+ *   providers: [pinoLoggerProvider],
  *   // ...
  * });
  * ```
  */
-export const loggerPinoProvider = createProvider({
-    name: "logger-pino",
-    config: {
-        schema: LoggerPinoConfigSchema,
-        envPrefix: "LOG_",
-    },
-    async setup({ config }) {
-        if (!config) {
-            throw new Error("[loggerPinoProvider] Missing logger config. " +
-                "Please set LOG_LEVEL, LOG_FORMAT, etc. environment variables.");
-        }
-        // Prepare base bindings
-        const baseBindings = {};
-        if (config.SERVICE) {
-            baseBindings.service = config.SERVICE;
-        }
-        // Create and configure Pino logger
-        const logger = createPinoLogger(config, baseBindings);
-        // Wrap logger to match LoggerPort interface
-        const port = wrapPino(logger);
-        return { ports: { logger: port } };
-    },
-});
+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":"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"}
+{"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.31",
+  "version": "0.0.32",
   "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": [
-          "loggerPinoProvider"
+          "pinoLoggerProvider"
         ]
       }
     }

package/src/index.ts

@@ -12,11 +12,11 @@
  * @example
  * ```ts
  * import { createNextServer } from "@beignet/next";
- * import { loggerPinoProvider } from "@beignet/provider-logger-pino";
+ * import { pinoLoggerProvider } from "@beignet/provider-logger-pino";
  *
  * const server = await createNextServer({
  *   ports: basePorts,
- *   providers: [loggerPinoProvider],
+ *   providers: [pinoLoggerProvider],
  *   // ...
  * });
  *
@@ -167,7 +167,83 @@ function wrapPino(logger: PinoLogger): LoggerPort {
 }
 
 /**
- * Pino logger provider that extends ports with structured logging capabilities.
+ * Options for the Pino logger provider factory.
+ */
+export interface CreatePinoLoggerProviderOptions {
+  /**
+   * Minimum log level. Overrides `LOG_LEVEL`.
+   */
+  level?: LoggerPinoConfig["LEVEL"];
+  /**
+   * Log format. Overrides `LOG_FORMAT`.
+   */
+  format?: LoggerPinoConfig["FORMAT"];
+  /**
+   * Service name added to log bindings. Overrides `LOG_SERVICE`.
+   */
+  service?: string;
+  /**
+   * Whether to include timestamps in log entries. Overrides `LOG_TIMESTAMP`.
+   */
+  timestamp?: boolean;
+}
+
+/**
+ * Create an env-backed Pino logger provider.
+ *
+ * Options override the corresponding `LOG_*` env values.
+ */
+export function createPinoLoggerProvider(
+  options: CreatePinoLoggerProviderOptions = {},
+) {
+  return createProvider({
+    name: "logger-pino",
+
+    config: {
+      schema: LoggerPinoConfigSchema,
+      envPrefix: "LOG_",
+      // Defined options win over env-derived values at config load time.
+      overrides: {
+        LEVEL: options.level,
+        FORMAT: options.format,
+        TIMESTAMP: options.timestamp,
+        SERVICE: options.service,
+      },
+    },
+
+    async setup({ config }) {
+      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.");
+      }
+
+      const resolvedConfig: LoggerPinoConfig = {
+        LEVEL: config.LEVEL,
+        FORMAT: config.FORMAT,
+        TIMESTAMP: config.TIMESTAMP,
+      };
+
+      // Prepare base bindings
+      const service = config.SERVICE;
+      const baseBindings: Record<string, unknown> = {};
+      if (service) {
+        baseBindings.service = service;
+      }
+
+      // Create and configure Pino logger
+      const logger = createPinoLogger(resolvedConfig, baseBindings);
+
+      // Wrap logger to match LoggerPort interface
+      const port = wrapPino(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)
@@ -179,39 +255,9 @@ function wrapPino(logger: PinoLogger): LoggerPort {
  * ```ts
  * const server = await createNextServer({
  *   ports: basePorts,
- *   providers: [loggerPinoProvider],
+ *   providers: [pinoLoggerProvider],
  *   // ...
  * });
  * ```
  */
-export const loggerPinoProvider = createProvider({
-  name: "logger-pino",
-
-  config: {
-    schema: LoggerPinoConfigSchema,
-    envPrefix: "LOG_",
-  },
-
-  async setup({ config }) {
-    if (!config) {
-      throw new Error(
-        "[loggerPinoProvider] Missing logger config. " +
-          "Please set LOG_LEVEL, LOG_FORMAT, etc. environment variables.",
-      );
-    }
-
-    // Prepare base bindings
-    const baseBindings: Record<string, unknown> = {};
-    if (config.SERVICE) {
-      baseBindings.service = config.SERVICE;
-    }
-
-    // Create and configure Pino logger
-    const logger = createPinoLogger(config, baseBindings);
-
-    // Wrap logger to match LoggerPort interface
-    const port = wrapPino(logger);
-
-    return { ports: { logger: port } };
-  },
-});
+export const pinoLoggerProvider = createPinoLoggerProvider();