@forumone/throughline-email 0.2.12 → 0.3.0

package/CHANGELOG.md

@@ -1,5 +1,51 @@
 # @forumone/throughline-email
 
+## 0.3.0
+
+### Minor Changes
+
+- 006ae30: A missing environment variable is reported together with every other one, in a
+  single error, instead of one plugin at a time.
+
+  The plugins that read the environment at init now declare what they cannot
+  start without, as data: `approvalsEnv` (`APPROVAL_TOKEN_SECRET`, 32+
+  characters), `emailEnv` (`RESEND_API_KEY`, `EMAIL_FROM_ADDRESS`) and `formsEnv`
+  (`FORMS_IP_HASH_SECRET`, 32+ characters). Each is a list of `EnvRequirement`
+  (`{ name, minLength?, why }`), a new type in `plugin-contract`, and each
+  plugin's own init check now reads the same entries, so the two cannot drift.
+  An empty or whitespace-only value now counts as missing in those checks.
+
+  Core exports `assertEnvironment(...checks)`. Call it first in
+  `payload.config.ts` with the plugins' lists and your own variables; it throws
+  one `EnvironmentError` whose first line reads "Configuration problem: N
+  environment variables are missing or invalid", followed by every missing or
+  too-short variable and why it is needed. Values are never printed. An argument
+  can also be a function, for a rule that is not "this name, this long", such as
+  a database URL accepted under several names. `checkEnvValue` is the one-value
+  check behind it, for a plugin's own backstop.
+
+  New projects call `assertEnvironment` at the top of `payload.config.ts` with
+  `approvalsEnv`, `emailEnv`, `formsEnv`, `PAYLOAD_SECRET` (32+ characters),
+  `NEXT_PUBLIC_SERVER_URL` and the database resolver, and `.env.example` marks
+  which variables are checked. An existing site can do the same and delete any
+  hand-kept copy of the plugins' requirements.
+
+- ab623e1: The `payload` peer range moves from `^3.0.0` to `^3.89.0` for every package that has one. **A site on Payload older than 3.89.0 must upgrade Payload before upgrading these packages.**
+
+  Before 3.89.0, the `payload-mcp-api-keys` collection that `@payloadcms/plugin-mcp` adds registered Payload's API-key strategy on every REST route. Any key could then become `req.user` outside `/api/mcp` and pass access rules written as `Boolean(req.user)`. Every Throughline site runs that plugin, so the floor is the same for every package. No package's code changes with this bump.
+
+### Patch Changes
+
+- Updated dependencies [006ae30]
+- Updated dependencies [549d292]
+- Updated dependencies [70385c4]
+- Updated dependencies [c8a86bf]
+- Updated dependencies [ab623e1]
+- Updated dependencies [ab623e1]
+- Updated dependencies [36728c4]
+  - @forumone/throughline-plugin-contract@0.5.0
+  - @forumone/throughline-core@0.10.0
+
 ## 0.2.12
 
 ### Patch Changes

package/README.md

@@ -18,7 +18,7 @@ After this package, the approval workflow is end-to-end: a marketer requests app
 pnpm add @forumone/throughline-email
 ```
 
-Peers: `payload@^3.0.0`, `inngest@^4.0.0`, `react@^18 || ^19`. The plugin lazy-loads `resend` and `@react-email/render` on first send, so a misconfigured deploy fails on first email rather than at boot.
+Peers: `payload@^3.89.0`, `inngest@^4.0.0`, `react@^18 || ^19`. The plugin lazy-loads `resend` and `@react-email/render` on first send, so a misconfigured deploy fails on first email rather than at boot.
 
 ## Usage
 
@@ -114,6 +114,10 @@ The approval-request notifier sends to every approver in `notifiedApprovers`. Ea
 
 Every email renders to both HTML and plaintext from the same React tree (React Email's `render(..., { plainText: true })`). Plaintext is required for accessibility (screen readers), deliverability (spam scores improve dramatically), and for clients that refuse HTML.
 
+## Environment
+
+`emailEnv` declares what the plugin reads from the environment and refuses to start without — `RESEND_API_KEY` and `EMAIL_FROM_ADDRESS`, used when `apiKey` / `fromAddress` are omitted. Pass it to `assertEnvironment` from `@forumone/throughline-core` at the top of `payload.config.ts` so both are reported together with every other missing variable. The plugin's own init check reads the same declaration.
+
 ## Options reference
 
 | Option | Default | Notes |

package/dist/index.d.ts

@@ -3,7 +3,7 @@ export { createEmailClient } from './client.js';
 export type { EmailClient, EmailClientOptions, SendEmailParams, SendEmailResult, TemplateRenderer, } from './client.js';
 export { defaultTokens, mergeTokens } from './tokens.js';
 export type { EmailBrandTokens } from './tokens.js';
-export { DEFAULT_APPROVALS_COLLECTION_SLUG, validateOptions } from './options.js';
+export { DEFAULT_APPROVALS_COLLECTION_SLUG, emailEnv, validateOptions } from './options.js';
 export type { ApprovalActionKind, BuildActionUrlArgs, EmailPluginOptions, ResolvedEmailEnv, ResolvedRecipient, } from './options.js';
 export { createNotifyApprovalRequestFunction, createNotifyApprovalDecisionFunction, createNotifyApprovalExpiredFunction, } from './functions/index.js';
 export { EmailLayout, ApprovalRequestEmail, ApprovalDecisionEmail, ApprovalExpiredEmail, } from './templates/index.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAE5E,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAC/C,YAAY,EACV,WAAW,EACX,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,gBAAgB,GACjB,MAAM,aAAa,CAAA;AAEpB,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AACxD,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAEnD,OAAO,EAAE,iCAAiC,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AACjF,YAAY,EACV,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,cAAc,CAAA;AAErB,OAAO,EACL,mCAAmC,EACnC,oCAAoC,EACpC,mCAAmC,GACpC,MAAM,sBAAsB,CAAA;AAE7B,OAAO,EACL,WAAW,EACX,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,sBAAsB,CAAA;AAC7B,YAAY,EACV,yBAAyB,EACzB,0BAA0B,EAC1B,oBAAoB,EACpB,yBAAyB,EACzB,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,sBAAsB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAE5E,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAC/C,YAAY,EACV,WAAW,EACX,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,gBAAgB,GACjB,MAAM,aAAa,CAAA;AAEpB,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AACxD,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAEnD,OAAO,EAAE,iCAAiC,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAC3F,YAAY,EACV,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,cAAc,CAAA;AAErB,OAAO,EACL,mCAAmC,EACnC,oCAAoC,EACpC,mCAAmC,GACpC,MAAM,sBAAsB,CAAA;AAE7B,OAAO,EACL,WAAW,EACX,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,sBAAsB,CAAA;AAC7B,YAAY,EACV,yBAAyB,EACzB,0BAA0B,EAC1B,oBAAoB,EACpB,yBAAyB,EACzB,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,sBAAsB,CAAA"}

package/dist/index.js

@@ -1,7 +1,7 @@
 export { emailPlugin, getEmailClient, getEmailFunctions } from './plugin.js';
 export { createEmailClient } from './client.js';
 export { defaultTokens, mergeTokens } from './tokens.js';
-export { DEFAULT_APPROVALS_COLLECTION_SLUG, validateOptions } from './options.js';
+export { DEFAULT_APPROVALS_COLLECTION_SLUG, emailEnv, validateOptions } from './options.js';
 export { createNotifyApprovalRequestFunction, createNotifyApprovalDecisionFunction, createNotifyApprovalExpiredFunction, } from './functions/index.js';
 export { EmailLayout, ApprovalRequestEmail, ApprovalDecisionEmail, ApprovalExpiredEmail, } from './templates/index.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAE5E,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAS/C,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAGxD,OAAO,EAAE,iCAAiC,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AASjF,OAAO,EACL,mCAAmC,EACnC,oCAAoC,EACpC,mCAAmC,GACpC,MAAM,sBAAsB,CAAA;AAE7B,OAAO,EACL,WAAW,EACX,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,sBAAsB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAE5E,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAS/C,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAGxD,OAAO,EAAE,iCAAiC,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAS3F,OAAO,EACL,mCAAmC,EACnC,oCAAoC,EACpC,mCAAmC,GACpC,MAAM,sBAAsB,CAAA;AAE7B,OAAO,EACL,WAAW,EACX,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,sBAAsB,CAAA"}

package/dist/options.d.ts

@@ -1,5 +1,5 @@
 import type { Inngest } from 'inngest';
-import type { BaseCorePluginOptions } from '@forumone/throughline-plugin-contract';
+import type { BaseCorePluginOptions, EnvRequirement } from '@forumone/throughline-plugin-contract';
 import type { EmailBrandTokens } from './tokens.js';
 export type ApprovalActionKind = 'approve' | 'decline' | 'changes' | 'discuss';
 export interface ResolvedRecipient {
@@ -60,6 +60,15 @@ export interface EmailPluginOptions extends BaseCorePluginOptions {
     }) => Promise<string>;
 }
 export declare const DEFAULT_APPROVALS_COLLECTION_SLUG = "approvals";
+/**
+ * What `emailPlugin` reads from the environment when the matching option is
+ * omitted, and refuses to start without. Hand it to `assertEnvironment` from
+ * `@forumone/throughline-core` so a site reports it with everything else.
+ *
+ * Leave it out if you pass `apiKey` and `fromAddress` yourself. The optional
+ * `EMAIL_FROM_NAME` and `EMAIL_REPLY_TO` are not requirements.
+ */
+export declare const emailEnv: readonly EnvRequirement[];
 export interface ResolvedEmailEnv {
     apiKey: string;
     fromAddress: string;

package/dist/options.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../src/options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAA;AAClF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAEnD,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAA;AAE9E,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,kBAAkB,CAAA;IAC1B,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,kBAAmB,SAAQ,qBAAqB;IAC/D,wEAAwE;IACxE,OAAO,EAAE,OAAO,CAAA;IAChB,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,2FAA2F;IAC3F,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,gDAAgD;IAChD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAA;IAClC,uDAAuD;IACvD,uBAAuB,CAAC,EAAE,MAAM,CAAA;IAChC;;;;OAIG;IACH,eAAe,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAA;IACtE,kEAAkE;IAClE,gBAAgB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAA;IACvE;;;;OAIG;IACH,cAAc,EAAE,CAAC,IAAI,EAAE,kBAAkB,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;IAC7D;;;;OAIG;IACH,eAAe,CAAC,EAAE,CAAC,IAAI,EAAE;QACvB,gBAAgB,EAAE,MAAM,CAAA;QACxB,QAAQ,EAAE,MAAM,CAAA;QAChB,UAAU,EAAE,MAAM,CAAA;KACnB,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;CACtB;AAED,eAAO,MAAM,iCAAiC,cAAc,CAAA;AAE5D,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAA;IACd,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,kBAAkB,GAAG;IAC5D,OAAO,EAAE,kBAAkB,CAAA;IAC3B,GAAG,EAAE,gBAAgB,CAAA;IACrB,SAAS,EAAE,MAAM,CAAA;CAClB,CAwCA"}
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../src/options.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,KAAK,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAA;AAClG,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAEnD,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAA;AAE9E,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,kBAAkB,CAAA;IAC1B,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,kBAAmB,SAAQ,qBAAqB;IAC/D,wEAAwE;IACxE,OAAO,EAAE,OAAO,CAAA;IAChB,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,2FAA2F;IAC3F,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,gDAAgD;IAChD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAA;IAClC,uDAAuD;IACvD,uBAAuB,CAAC,EAAE,MAAM,CAAA;IAChC;;;;OAIG;IACH,eAAe,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAA;IACtE,kEAAkE;IAClE,gBAAgB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAA;IACvE;;;;OAIG;IACH,cAAc,EAAE,CAAC,IAAI,EAAE,kBAAkB,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;IAC7D;;;;OAIG;IACH,eAAe,CAAC,EAAE,CAAC,IAAI,EAAE;QACvB,gBAAgB,EAAE,MAAM,CAAA;QACxB,QAAQ,EAAE,MAAM,CAAA;QAChB,UAAU,EAAE,MAAM,CAAA;KACnB,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;CACtB;AAED,eAAO,MAAM,iCAAiC,cAAc,CAAA;AAY5D;;;;;;;GAOG;AACH,eAAO,MAAM,QAAQ,EAAE,SAAS,cAAc,EAAoC,CAAA;AAElF,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAA;IACd,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,kBAAkB,GAAG;IAC5D,OAAO,EAAE,kBAAkB,CAAA;IAC3B,GAAG,EAAE,gBAAgB,CAAA;IACrB,SAAS,EAAE,MAAM,CAAA;CAClB,CA0CA"}

package/dist/options.js

@@ -1,4 +1,22 @@
+import { checkEnvValue } from '@forumone/throughline-core';
 export const DEFAULT_APPROVALS_COLLECTION_SLUG = 'approvals';
+const API_KEY_ENV = {
+    name: 'RESEND_API_KEY',
+    why: 'Sends approval and form notification email through Resend; emailPlugin will not start without it.',
+};
+const FROM_ADDRESS_ENV = {
+    name: 'EMAIL_FROM_ADDRESS',
+    why: 'The From address on every email. It must be a verified sender on your Resend domain.',
+};
+/**
+ * What `emailPlugin` reads from the environment when the matching option is
+ * omitted, and refuses to start without. Hand it to `assertEnvironment` from
+ * `@forumone/throughline-core` so a site reports it with everything else.
+ *
+ * Leave it out if you pass `apiKey` and `fromAddress` yourself. The optional
+ * `EMAIL_FROM_NAME` and `EMAIL_REPLY_TO` are not requirements.
+ */
+export const emailEnv = [API_KEY_ENV, FROM_ADDRESS_ENV];
 /**
  * Validates options at plugin init. Resolves the Resend secrets via env
  * fallback so missing configuration surfaces immediately rather than on the
@@ -8,13 +26,15 @@ export function validateOptions(options) {
     if (!options.inngest) {
         throw new Error('emailPlugin requires an Inngest client (`options.inngest`).');
     }
-    const apiKey = options.apiKey ?? process.env['RESEND_API_KEY'];
-    if (!apiKey) {
-        throw new Error('emailPlugin requires `options.apiKey` or the RESEND_API_KEY env var.');
+    // The backstop for a site that does not call `assertEnvironment`, driven by
+    // the same declarations it would have passed.
+    const apiKey = options.apiKey ?? process.env[API_KEY_ENV.name];
+    if (apiKey === undefined || checkEnvValue(API_KEY_ENV, apiKey)) {
+        throw new Error(`emailPlugin requires \`options.apiKey\` or the ${API_KEY_ENV.name} env var.`);
     }
-    const fromAddress = options.fromAddress ?? process.env['EMAIL_FROM_ADDRESS'];
-    if (!fromAddress) {
-        throw new Error('emailPlugin requires `options.fromAddress` or the EMAIL_FROM_ADDRESS env var.');
+    const fromAddress = options.fromAddress ?? process.env[FROM_ADDRESS_ENV.name];
+    if (fromAddress === undefined || checkEnvValue(FROM_ADDRESS_ENV, fromAddress)) {
+        throw new Error(`emailPlugin requires \`options.fromAddress\` or the ${FROM_ADDRESS_ENV.name} env var.`);
     }
     if (typeof options.resolveApprover !== 'function' || typeof options.resolveRequester !== 'function') {
         throw new Error('emailPlugin requires `options.resolveApprover` and `options.resolveRequester` so the plugin can map user IDs to email addresses without coupling to a specific user-model schema.');

package/dist/options.js.map

@@ -1 +1 @@
-{"version":3,"file":"options.js","sourceRoot":"","sources":["../src/options.ts"],"names":[],"mappings":"AAkEA,MAAM,CAAC,MAAM,iCAAiC,GAAG,WAAW,CAAA;AAS5D;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,OAA2B;IAKzD,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CAAC,6DAA6D,CAAC,CAAA;IAChF,CAAC;IACD,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAA;IAC9D,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,sEAAsE,CAAC,CAAA;IACzF,CAAC;IACD,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAA;IAC5E,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CACb,+EAA+E,CAChF,CAAA;IACH,CAAC;IACD,IAAI,OAAO,OAAO,CAAC,eAAe,KAAK,UAAU,IAAI,OAAO,OAAO,CAAC,gBAAgB,KAAK,UAAU,EAAE,CAAC;QACpG,MAAM,IAAI,KAAK,CACb,mLAAmL,CACpL,CAAA;IACH,CAAC;IACD,IAAI,OAAO,OAAO,CAAC,cAAc,KAAK,UAAU,EAAE,CAAC;QACjD,MAAM,IAAI,KAAK,CACb,2HAA2H,CAC5H,CAAA;IACH,CAAC;IAED,MAAM,SAAS,GACb,OAAO,CAAC,QAAQ;QAChB,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;QAC9B,OAAO,CAAC,MAAM,EAAE,SAAS;QACzB,WAAW,CAAA;IAEb,MAAM,GAAG,GAAqB;QAC5B,MAAM;QACN,WAAW;QACX,QAAQ,EAAE,SAAS;KACpB,CAAA;IACD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAA;IAChE,IAAI,OAAO;QAAE,GAAG,CAAC,OAAO,GAAG,OAAO,CAAA;IAElC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,CAAA;AACpC,CAAC"}
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../src/options.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAA;AAmE1D,MAAM,CAAC,MAAM,iCAAiC,GAAG,WAAW,CAAA;AAE5D,MAAM,WAAW,GAAG;IAClB,IAAI,EAAE,gBAAgB;IACtB,GAAG,EAAE,mGAAmG;CACvE,CAAA;AAEnC,MAAM,gBAAgB,GAAG;IACvB,IAAI,EAAE,oBAAoB;IAC1B,GAAG,EAAE,sFAAsF;CAC1D,CAAA;AAEnC;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,QAAQ,GAA8B,CAAC,WAAW,EAAE,gBAAgB,CAAC,CAAA;AASlF;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,OAA2B;IAKzD,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CAAC,6DAA6D,CAAC,CAAA;IAChF,CAAC;IACD,4EAA4E;IAC5E,8CAA8C;IAC9C,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,CAAA;IAC9D,IAAI,MAAM,KAAK,SAAS,IAAI,aAAa,CAAC,WAAW,EAAE,MAAM,CAAC,EAAE,CAAC;QAC/D,MAAM,IAAI,KAAK,CAAC,kDAAkD,WAAW,CAAC,IAAI,WAAW,CAAC,CAAA;IAChG,CAAC;IACD,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAA;IAC7E,IAAI,WAAW,KAAK,SAAS,IAAI,aAAa,CAAC,gBAAgB,EAAE,WAAW,CAAC,EAAE,CAAC;QAC9E,MAAM,IAAI,KAAK,CACb,uDAAuD,gBAAgB,CAAC,IAAI,WAAW,CACxF,CAAA;IACH,CAAC;IACD,IAAI,OAAO,OAAO,CAAC,eAAe,KAAK,UAAU,IAAI,OAAO,OAAO,CAAC,gBAAgB,KAAK,UAAU,EAAE,CAAC;QACpG,MAAM,IAAI,KAAK,CACb,mLAAmL,CACpL,CAAA;IACH,CAAC;IACD,IAAI,OAAO,OAAO,CAAC,cAAc,KAAK,UAAU,EAAE,CAAC;QACjD,MAAM,IAAI,KAAK,CACb,2HAA2H,CAC5H,CAAA;IACH,CAAC;IAED,MAAM,SAAS,GACb,OAAO,CAAC,QAAQ;QAChB,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;QAC9B,OAAO,CAAC,MAAM,EAAE,SAAS;QACzB,WAAW,CAAA;IAEb,MAAM,GAAG,GAAqB;QAC5B,MAAM;QACN,WAAW;QACX,QAAQ,EAAE,SAAS;KACpB,CAAA;IACD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAA;IAChE,IAAI,OAAO;QAAE,GAAG,CAAC,OAAO,GAAG,OAAO,CAAA;IAElC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,CAAA;AACpC,CAAC"}

package/dist/templates/ApprovalDecision.d.ts

@@ -11,5 +11,5 @@ export interface ApprovalDecisionEmailProps {
     previewUrl: string;
     tokens: EmailBrandTokens;
 }
-export declare function ApprovalDecisionEmail(props: ApprovalDecisionEmailProps): import("react/jsx-runtime").JSX.Element;
+export declare function ApprovalDecisionEmail(props: ApprovalDecisionEmailProps): import("react").JSX.Element;
 //# sourceMappingURL=ApprovalDecision.d.ts.map

package/dist/templates/ApprovalDecision.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ApprovalDecision.d.ts","sourceRoot":"","sources":["../../src/templates/ApprovalDecision.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAEpD,MAAM,MAAM,oBAAoB,GAAG,SAAS,GAAG,UAAU,GAAG,mBAAmB,CAAA;AAE/E,MAAM,WAAW,0BAA0B;IACzC,aAAa,EAAE,MAAM,CAAA;IACrB,8CAA8C;IAC9C,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,oBAAoB,CAAA;IAC9B,kDAAkD;IAClD,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,gBAAgB,CAAA;CACzB;AAwBD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,0BAA0B,2CAwEtE"}
+{"version":3,"file":"ApprovalDecision.d.ts","sourceRoot":"","sources":["../../src/templates/ApprovalDecision.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAEpD,MAAM,MAAM,oBAAoB,GAAG,SAAS,GAAG,UAAU,GAAG,mBAAmB,CAAA;AAE/E,MAAM,WAAW,0BAA0B;IACzC,aAAa,EAAE,MAAM,CAAA;IACrB,8CAA8C;IAC9C,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,oBAAoB,CAAA;IAC9B,kDAAkD;IAClD,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,gBAAgB,CAAA;CACzB;AAwBD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,0BAA0B,+BAwEtE"}

package/dist/templates/ApprovalExpired.d.ts

@@ -6,5 +6,5 @@ export interface ApprovalExpiredEmailProps {
     requestedAt: string;
     tokens: EmailBrandTokens;
 }
-export declare function ApprovalExpiredEmail(props: ApprovalExpiredEmailProps): import("react/jsx-runtime").JSX.Element;
+export declare function ApprovalExpiredEmail(props: ApprovalExpiredEmailProps): import("react").JSX.Element;
 //# sourceMappingURL=ApprovalExpired.d.ts.map

package/dist/templates/ApprovalExpired.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ApprovalExpired.d.ts","sourceRoot":"","sources":["../../src/templates/ApprovalExpired.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAEpD,MAAM,WAAW,yBAAyB;IACxC,aAAa,EAAE,MAAM,CAAA;IACrB,WAAW,EAAE,MAAM,CAAA;IACnB,+DAA+D;IAC/D,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,gBAAgB,CAAA;CACzB;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,yBAAyB,2CAuBpE"}
+{"version":3,"file":"ApprovalExpired.d.ts","sourceRoot":"","sources":["../../src/templates/ApprovalExpired.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAEpD,MAAM,WAAW,yBAAyB;IACxC,aAAa,EAAE,MAAM,CAAA;IACrB,WAAW,EAAE,MAAM,CAAA;IACnB,+DAA+D;IAC/D,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,gBAAgB,CAAA;CACzB;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,yBAAyB,+BAuBpE"}

package/dist/templates/ApprovalRequest.d.ts

@@ -20,5 +20,5 @@ export interface ApprovalRequestEmailProps {
     expiresAt: string;
     tokens: EmailBrandTokens;
 }
-export declare function ApprovalRequestEmail(props: ApprovalRequestEmailProps): import("react/jsx-runtime").JSX.Element;
+export declare function ApprovalRequestEmail(props: ApprovalRequestEmailProps): import("react").JSX.Element;
 //# sourceMappingURL=ApprovalRequest.d.ts.map

package/dist/templates/ApprovalRequest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ApprovalRequest.d.ts","sourceRoot":"","sources":["../../src/templates/ApprovalRequest.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAEpD,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAA;AAEzD,MAAM,WAAW,yBAAyB;IACxC,YAAY,EAAE,MAAM,CAAA;IACpB,aAAa,EAAE,MAAM,CAAA;IACrB,WAAW,EAAE,MAAM,CAAA;IACnB;;;OAGG;IACH,UAAU,EAAE,kBAAkB,CAAA;IAC9B,cAAc,EAAE,MAAM,CAAA;IACtB,qDAAqD;IACrD,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,4DAA4D;IAC5D,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,gBAAgB,CAAA;CACzB;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,yBAAyB,2CA6HpE"}
+{"version":3,"file":"ApprovalRequest.d.ts","sourceRoot":"","sources":["../../src/templates/ApprovalRequest.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAEpD,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAA;AAEzD,MAAM,WAAW,yBAAyB;IACxC,YAAY,EAAE,MAAM,CAAA;IACpB,aAAa,EAAE,MAAM,CAAA;IACrB,WAAW,EAAE,MAAM,CAAA;IACnB;;;OAGG;IACH,UAAU,EAAE,kBAAkB,CAAA;IAC9B,cAAc,EAAE,MAAM,CAAA;IACtB,qDAAqD;IACrD,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,4DAA4D;IAC5D,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,gBAAgB,CAAA;CACzB;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,yBAAyB,+BA6HpE"}

package/dist/templates/_layout.d.ts

@@ -13,5 +13,5 @@ export interface EmailLayoutProps {
  * `Section`) keeps Outlook / Gmail / Apple Mail rendering consistent;
  * raw `<div>` + CSS is where compatibility nightmares live.
  */
-export declare function EmailLayout({ preview, tokens, children }: EmailLayoutProps): import("react/jsx-runtime").JSX.Element;
+export declare function EmailLayout({ preview, tokens, children }: EmailLayoutProps): import("react").JSX.Element;
 //# sourceMappingURL=_layout.d.ts.map

package/dist/templates/_layout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"_layout.d.ts","sourceRoot":"","sources":["../../src/templates/_layout.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAiB,SAAS,EAAE,MAAM,OAAO,CAAA;AACrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAEpD,MAAM,WAAW,gBAAgB;IAC/B,6EAA6E;IAC7E,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,gBAAgB,CAAA;IACxB,QAAQ,EAAE,SAAS,CAAA;CACpB;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,gBAAgB,2CAgD1E"}
+{"version":3,"file":"_layout.d.ts","sourceRoot":"","sources":["../../src/templates/_layout.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAiB,SAAS,EAAE,MAAM,OAAO,CAAA;AACrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAEpD,MAAM,WAAW,gBAAgB;IAC/B,6EAA6E;IAC7E,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,gBAAgB,CAAA;IACxB,QAAQ,EAAE,SAAS,CAAA;CACpB;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,gBAAgB,+BAgD1E"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forumone/throughline-email",
-  "version": "0.2.12",
+  "version": "0.3.0",
   "description": "Transactional email system for the Throughline framework. Resend wrapper, themeable React Email templates, and Inngest functions that subscribe to the approval-workflow notification events.",
   "type": "module",
   "main": "./dist/index.js",
@@ -42,7 +42,7 @@
   },
   "peerDependencies": {
     "inngest": "^4.0.0",
-    "payload": "^3.0.0",
+    "payload": "^3.89.0",
     "react": "^18.0.0 || ^19.0.0"
   },
   "dependencies": {
@@ -50,13 +50,13 @@
     "@react-email/render": "^1.3.2",
     "resend": "^6.1.4",
     "zod": "^3.23.0",
-    "@forumone/throughline-core": "0.9.1",
-    "@forumone/throughline-plugin-contract": "0.4.1"
+    "@forumone/throughline-core": "0.10.0",
+    "@forumone/throughline-plugin-contract": "0.5.0"
   },
   "devDependencies": {
     "@types/node": "^24.13.2",
     "@types/react": "^19.2.0",
-    "eslint": "^9.15.0",
+    "eslint": "^10.11.0",
     "inngest": "^4.2.0",
     "payload": "^3.83.0",
     "react": "^19.2.0",