@beignet/provider-mail-resend 0.0.32 → 0.0.34

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # @beignet/provider-mail-resend
 
+## 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
+
+- 92af951: Document and test the provider resilience baseline: mail providers fail fast
+  without provider-owned retries, while S3 delegates bounded retries to the AWS
+  SDK or caller-owned injected clients.
+
 ## 0.0.32
 
 ### Patch Changes

package/README.md

@@ -21,12 +21,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 +57,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
 
@@ -115,9 +115,10 @@ When `ctx.ports.devtools` is installed, this provider records `mail.send`,
 
 ## Failure and retry semantics
 
-The provider fails fast and does not retry. Mail delivery is not idempotent: a
-timed-out send may still have been delivered, so a blind provider retry risks
-duplicate emails.
+The provider fails fast and does not retry. Each `send(...)` call makes one
+Resend SDK call, even for transient network errors or provider-side failures.
+Mail delivery is not idempotent: a timed-out send may still have been
+delivered, so a blind provider retry risks duplicate emails.
 
 Delivery failures throw `MailDeliveryError` from `@beignet/core/mail` with the
 provider name, the recipient count, and the original Resend error preserved as
@@ -125,8 +126,9 @@ provider name, the recipient count, and the original Resend error preserved as
 configuration problems throw during provider setup.
 
 When mail needs retries, dispatch it from a job or an outbox-backed listener
-and own idempotency there, for example by recording one delivery per business
-event before sending.
+and own idempotency there. The job or outbox row should choose attempts and
+delay, and the application should record one delivery per business event before
+sending.
 
 ## Local and tests
 

package/dist/index.d.ts

@@ -25,7 +25,7 @@ export interface ResendMailEscapeHatch {
     client: Resend;
 }
 /**
- * Ports contributed by `resendMailProvider`.
+ * Ports contributed by `createResendMailProvider`.
  */
 export interface ResendMailProviderPorts {
     /**
@@ -57,7 +57,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;
@@ -89,20 +89,5 @@ export declare function createResendMailProvider(options?: CreateResendMailProvi
         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 {};
 //# 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,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"}

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.32",
+  "version": "0.0.34",
   "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

@@ -43,7 +43,7 @@ export interface ResendMailEscapeHatch {
 }
 
 /**
- * Ports contributed by `resendMailProvider`.
+ * Ports contributed by `createResendMailProvider`.
  */
 export interface ResendMailProviderPorts {
   /**
@@ -134,7 +134,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({
@@ -270,7 +270,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 +296,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();