@beignet/provider-mail-resend 0.0.33 → 0.0.35

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @beignet/provider-mail-resend
 
+## 0.0.35
+
+### Patch Changes
+
+- 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
 
 ### Patch Changes

package/README.md

@@ -9,6 +9,10 @@ Resend-backed mail provider for Beignet.
 The provider installs the app-facing `ctx.ports.mailer` port and exposes
 `ctx.ports.resend.client` only as an escape hatch for Resend-specific features.
 
+`createResendMailProvider(...)` returns the stable `ResendMailProvider` type.
+`ResendMailConfig` describes its validated config; the Zod schema remains
+internal.
+
 ## Install
 
 ```bash
@@ -21,12 +25,12 @@ the SDK's Node.js 20+ runtime requirement.
 ## Setup
 
 ```typescript
-import { resendMailProvider } from "@beignet/provider-mail-resend";
+import { createResendMailProvider } from "@beignet/provider-mail-resend";
 import { createServer } from "@beignet/core/server";
 
 const server = await createServer({
   ports: basePorts,
-  providers: [resendMailProvider],
+  providers: [createResendMailProvider()],
   context: ({ ports }) => ({ ports }),
   routes,
 });
@@ -57,8 +61,8 @@ export const providers = [
 ];
 ```
 
-`resendMailProvider` is the default env-backed provider, equivalent to
-`createResendMailProvider()`.
+Calling `createResendMailProvider()` with no options uses the env-backed
+configuration.
 
 ## Use in application code
 

package/dist/index.d.ts

@@ -4,17 +4,15 @@
  * Resend-backed mail provider for Beignet.
  */
 import { type MailAddress, type MailerPort } from "@beignet/core/mail";
-import { type ProviderInstrumentationTarget } from "@beignet/core/providers";
+import { type AnyProviderConfigSchema, type ProviderInstrumentationTarget, type ServiceProvider } from "@beignet/core/providers";
 import { Resend } from "resend";
-import { z } from "zod";
-declare const ResendMailConfigSchema: z.ZodObject<{
-    API_KEY: z.ZodString;
-    FROM: z.ZodString;
-}, z.core.$strip>;
 /**
  * Resend provider config loaded from `RESEND_API_KEY` and `RESEND_FROM`.
  */
-export type ResendMailConfig = z.infer<typeof ResendMailConfigSchema>;
+export interface ResendMailConfig {
+    API_KEY: string;
+    FROM: string;
+}
 /**
  * Escape hatch for apps that need the raw Resend client.
  */
@@ -25,7 +23,7 @@ export interface ResendMailEscapeHatch {
     client: Resend;
 }
 /**
- * Ports contributed by `resendMailProvider`.
+ * Ports contributed by `createResendMailProvider`.
  */
 export interface ResendMailProviderPorts {
     /**
@@ -37,6 +35,10 @@ export interface ResendMailProviderPorts {
      */
     resend: ResendMailEscapeHatch;
 }
+/**
+ * Resend mail lifecycle provider with stable contributed-port typing.
+ */
+export type ResendMailProvider = ServiceProvider<unknown, AnyProviderConfigSchema<ResendMailConfig>, Pick<ResendMailProviderPorts, keyof ResendMailProviderPorts>>;
 /**
  * Options for creating a Resend-backed mailer directly.
  */
@@ -57,7 +59,7 @@ export interface CreateResendMailerOptions {
 /**
  * Create a Beignet mailer port backed by Resend.
  *
- * Use this directly for custom wiring, or install `resendMailProvider` to load
+ * Use this directly for custom wiring, or install `createResendMailProvider` to load
  * config from env and contribute ports during server startup.
  */
 export declare function createResendMailer({ client, from, instrumentation: instrumentationTarget, }: CreateResendMailerOptions): MailerPort;
@@ -80,29 +82,5 @@ export interface CreateResendMailProviderOptions {
  *
  * Options override the corresponding `RESEND_*` env values.
  */
-export declare function createResendMailProvider(options?: CreateResendMailProviderOptions): import("@beignet/core/providers").ServiceProvider<unknown, z.ZodObject<{
-    API_KEY: z.ZodString;
-    FROM: z.ZodString;
-}, z.core.$strip>, {
-    mailer: MailerPort;
-    resend: {
-        client: Resend;
-    };
-}, unknown, void>;
-/**
- * Default env-backed Resend mail provider.
- *
- * Reads `RESEND_API_KEY` and `RESEND_FROM`, contributes `ports.mailer`, and
- * exposes `ports.resend.client` as an escape hatch.
- */
-export declare const resendMailProvider: import("@beignet/core/providers").ServiceProvider<unknown, z.ZodObject<{
-    API_KEY: z.ZodString;
-    FROM: z.ZodString;
-}, z.core.$strip>, {
-    mailer: MailerPort;
-    resend: {
-        client: Resend;
-    };
-}, unknown, void>;
-export {};
+export declare function createResendMailProvider(options?: CreateResendMailProviderOptions): ResendMailProvider;
 //# 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;;;;GAIG;AAEH,OAAO,EAGL,KAAK,WAAW,EAEhB,KAAK,UAAU,EAIhB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAGL,KAAK,6BAA6B,EACnC,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAA2B,MAAM,EAAE,MAAM,QAAQ,CAAC;AACzD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,QAAA,MAAM,sBAAsB;;;iBAG1B,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,MAAM,EAAE,UAAU,CAAC;IACnB;;OAEG;IACH,MAAM,EAAE,qBAAqB,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,IAAI,EAAE,WAAW,CAAC;IAClB;;OAEG;IACH,eAAe,CAAC,EAAE,6BAA6B,CAAC;CACjD;AA2DD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,MAAM,EACN,IAAI,EACJ,eAAe,EAAE,qBAAqB,GACvC,EAAE,yBAAyB,GAAG,UAAU,CAwFxC;AAED;;GAEG;AACH,MAAM,WAAW,+BAA+B;IAC9C;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,GAAE,+BAAoC;;;;;;;;kBA2C9C;AAED;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;iBAA6B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAGL,KAAK,WAAW,EAEhB,KAAK,UAAU,EAIhB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,KAAK,uBAAuB,EAG5B,KAAK,6BAA6B,EAClC,KAAK,eAAe,EACrB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAA2B,MAAM,EAAE,MAAM,QAAQ,CAAC;AAQzD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,MAAM,EAAE,UAAU,CAAC;IACnB;;OAEG;IACH,MAAM,EAAE,qBAAqB,CAAC;CAC/B;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;AAEF;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,IAAI,EAAE,WAAW,CAAC;IAClB;;OAEG;IACH,eAAe,CAAC,EAAE,6BAA6B,CAAC;CACjD;AA2DD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,MAAM,EACN,IAAI,EACJ,eAAe,EAAE,qBAAqB,GACvC,EAAE,yBAAyB,GAAG,UAAU,CAwFxC;AAED;;GAEG;AACH,MAAM,WAAW,+BAA+B;IAC9C;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,GAAE,+BAAoC,GAC5C,kBAAkB,CA0CpB"}

package/dist/index.js

@@ -44,7 +44,7 @@ function createResendPayload(message, defaultFrom) {
 /**
  * Create a Beignet mailer port backed by Resend.
  *
- * Use this directly for custom wiring, or install `resendMailProvider` to load
+ * Use this directly for custom wiring, or install `createResendMailProvider` to load
  * config from env and contribute ports during server startup.
  */
 export function createResendMailer({ client, from, instrumentation: instrumentationTarget, }) {
@@ -145,7 +145,7 @@ export function createResendMailProvider(options = {}) {
         },
         async setup({ config, ports }) {
             if (!config) {
-                throw new Error("[resendMailProvider] Missing Resend config. " +
+                throw new Error("[createResendMailProvider] Missing Resend config. " +
                     "Please set RESEND_API_KEY and RESEND_FROM environment variables.");
             }
             const { API_KEY: apiKey, FROM: from } = config;
@@ -168,10 +168,3 @@ export function createResendMailProvider(options = {}) {
         },
     });
 }
-/**
- * Default env-backed Resend mail provider.
- *
- * Reads `RESEND_API_KEY` and `RESEND_FROM`, contributes `ports.mailer`, and
- * exposes `ports.resend.client` as an escape hatch.
- */
-export const resendMailProvider = createResendMailProvider();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@beignet/provider-mail-resend",
-  "version": "0.0.33",
+  "version": "0.0.35",
   "type": "module",
   "description": "Resend mail provider for Beignet - adds mailer port using Resend",
   "main": "./dist/index.js",
@@ -94,7 +94,7 @@
       "registration": {
         "required": true,
         "tokens": [
-          "resendMailProvider"
+          "createResendMailProvider"
         ]
       }
     }

package/src/index.ts

@@ -15,9 +15,11 @@ import {
   type SendMailResult,
 } from "@beignet/core/mail";
 import {
+  type AnyProviderConfigSchema,
   createProvider,
   createProviderInstrumentation,
   type ProviderInstrumentationTarget,
+  type ServiceProvider,
 } from "@beignet/core/providers";
 import { type CreateEmailOptions, Resend } from "resend";
 import { z } from "zod";
@@ -25,12 +27,15 @@ import { z } from "zod";
 const ResendMailConfigSchema = z.object({
   API_KEY: z.string().min(1),
   FROM: z.string().min(1),
-});
+}) satisfies z.ZodType<ResendMailConfig>;
 
 /**
  * Resend provider config loaded from `RESEND_API_KEY` and `RESEND_FROM`.
  */
-export type ResendMailConfig = z.infer<typeof ResendMailConfigSchema>;
+export interface ResendMailConfig {
+  API_KEY: string;
+  FROM: string;
+}
 
 /**
  * Escape hatch for apps that need the raw Resend client.
@@ -43,7 +48,7 @@ export interface ResendMailEscapeHatch {
 }
 
 /**
- * Ports contributed by `resendMailProvider`.
+ * Ports contributed by `createResendMailProvider`.
  */
 export interface ResendMailProviderPorts {
   /**
@@ -56,6 +61,15 @@ export interface ResendMailProviderPorts {
   resend: ResendMailEscapeHatch;
 }
 
+/**
+ * Resend mail lifecycle provider with stable contributed-port typing.
+ */
+export type ResendMailProvider = ServiceProvider<
+  unknown,
+  AnyProviderConfigSchema<ResendMailConfig>,
+  Pick<ResendMailProviderPorts, keyof ResendMailProviderPorts>
+>;
+
 /**
  * Options for creating a Resend-backed mailer directly.
  */
@@ -134,7 +148,7 @@ function createResendPayload(
 /**
  * Create a Beignet mailer port backed by Resend.
  *
- * Use this directly for custom wiring, or install `resendMailProvider` to load
+ * Use this directly for custom wiring, or install `createResendMailProvider` to load
  * config from env and contribute ports during server startup.
  */
 export function createResendMailer({
@@ -253,7 +267,7 @@ export interface CreateResendMailProviderOptions {
  */
 export function createResendMailProvider(
   options: CreateResendMailProviderOptions = {},
-) {
+): ResendMailProvider {
   return createProvider({
     name: "mail-resend",
 
@@ -270,7 +284,7 @@ export function createResendMailProvider(
     async setup({ config, ports }) {
       if (!config) {
         throw new Error(
-          "[resendMailProvider] Missing Resend config. " +
+          "[createResendMailProvider] Missing Resend config. " +
             "Please set RESEND_API_KEY and RESEND_FROM environment variables.",
         );
       }
@@ -296,11 +310,3 @@ export function createResendMailProvider(
     },
   });
 }
-
-/**
- * Default env-backed Resend mail provider.
- *
- * Reads `RESEND_API_KEY` and `RESEND_FROM`, contributes `ports.mailer`, and
- * exposes `ports.resend.client` as an escape hatch.
- */
-export const resendMailProvider = createResendMailProvider();