@farm.js/email 0.1.0-beta.0

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2024 Farm.js Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

package/README.md

@@ -0,0 +1,11 @@
+# @farm.js/email
+
+Email and Resend integration for Farm.js
+
+Farm.js is currently in beta.
+
+```bash
+npm install @farm.js/email@beta
+```
+
+See the [Farm.js repository](https://github.com/farming-labs/farm.js) for documentation, examples, and support.

package/dist/client.d.ts

@@ -0,0 +1,109 @@
+import type { ComponentProps, ComponentType } from "react";
+import type { Attachment, Tag } from "resend";
+import { api } from "@farm.js/core/client";
+import { type InferPathInferredClientAPI, type PathInferredClientOperation } from "@farm.js/integration-utils/integration";
+import type { FarmWebhookAckResult } from "@farm.js/integration-utils/webhooks";
+import type { EmailScheduleWhen } from "./schedule.js";
+export type { EmailScheduleDelay, EmailScheduleWhen } from "./schedule.js";
+export type EmailTemplateComponent<TData> = ComponentType<TData> & {
+    PreviewProps?: TData;
+};
+export interface EmailTemplate<TData> {
+    component: EmailTemplateComponent<TData>;
+    subject: string | ((data: TData) => string | Promise<string>);
+    previewText?: string | ((data: TData) => string | Promise<string>);
+    from?: string | ((data: TData) => string | Promise<string>);
+    replyTo?: string | string[] | ((data: TData) => string | string[] | Promise<string | string[]>);
+}
+export type EmailTemplates = Record<string, EmailTemplate<any>>;
+export type InferTemplateData<TTemplate> = TTemplate extends EmailTemplate<infer TData> ? TData : never;
+export declare function template<TComponent extends EmailTemplateComponent<any>>(component: TComponent, config: Omit<EmailTemplate<ComponentProps<TComponent>>, "component">): EmailTemplate<ComponentProps<TComponent>>;
+export interface EmailSendBaseInput {
+    to: string | string[];
+    cc?: string | string[];
+    bcc?: string | string[];
+    from?: string;
+    replyTo?: string | string[];
+    headers?: Record<string, string>;
+    tags?: Tag[];
+    attachments?: Attachment[];
+    topicId?: string | null;
+    scheduledAt?: string;
+    idempotencyKey?: string;
+}
+export interface EmailScheduleBaseInput extends Omit<EmailSendBaseInput, "scheduledAt"> {
+    when: EmailScheduleWhen;
+}
+export type ResendEmailSendInput<TTemplates extends EmailTemplates> = {
+    [TTemplateId in keyof TTemplates & string]: EmailSendBaseInput & {
+        templateId: TTemplateId;
+        data: InferTemplateData<TTemplates[TTemplateId]>;
+    };
+}[keyof TTemplates & string];
+export type ResendEmailScheduleInput<TTemplates extends EmailTemplates> = {
+    [TTemplateId in keyof TTemplates & string]: EmailScheduleBaseInput & {
+        templateId: TTemplateId;
+        data: InferTemplateData<TTemplates[TTemplateId]>;
+    };
+}[keyof TTemplates & string];
+export type ResendEmailPreviewInput<TTemplates extends EmailTemplates> = {
+    [TTemplateId in keyof TTemplates & string]: {
+        templateId: TTemplateId;
+        data: InferTemplateData<TTemplates[TTemplateId]>;
+    };
+}[keyof TTemplates & string];
+export type ResendEmailSendResult<TTemplates extends EmailTemplates = EmailTemplates> = {
+    [TTemplateId in keyof TTemplates & string]: {
+        id: string;
+        provider: "resend";
+        templateId: TTemplateId;
+        from: string;
+        to: string[];
+        subject: string;
+        previewText: string | null;
+    };
+}[keyof TTemplates & string];
+export type ResendEmailScheduleResult<TTemplates extends EmailTemplates = EmailTemplates> = {
+    [TTemplateId in keyof TTemplates & string]: ResendEmailSendResult<TTemplates> & {
+        templateId: TTemplateId;
+        when: string;
+    };
+}[keyof TTemplates & string];
+export type ResendEmailPreviewResult<TTemplates extends EmailTemplates = EmailTemplates> = {
+    [TTemplateId in keyof TTemplates & string]: {
+        templateId: TTemplateId;
+        subject: string;
+        previewText: string | null;
+        html: string;
+        text: string;
+    };
+}[keyof TTemplates & string];
+export type ResendEmailTemplateInfo<TTemplates extends EmailTemplates = EmailTemplates> = {
+    [TTemplateId in keyof TTemplates & string]: {
+        id: TTemplateId;
+        hasPreviewText: boolean;
+        hasCustomFrom: boolean;
+        hasCustomReplyTo: boolean;
+        previewProps: InferTemplateData<TTemplates[TTemplateId]> | null;
+    };
+}[keyof TTemplates & string];
+export type ResendWebhookResult = FarmWebhookAckResult;
+export interface ResendClientPathOptions {
+    sendPath?: string;
+    schedulePath?: string;
+    previewPath?: string;
+    templatesPath?: string;
+}
+type ResolvedResendClientPath<TPath extends string | undefined, TDefault extends string> = TPath extends string ? TPath : TDefault;
+type ResendClientEntries<TTemplates extends EmailTemplates, TInput extends ResendClientPathOptions> = [
+    PathInferredClientOperation<ResolvedResendClientPath<TInput["sendPath"], "/api/email/send">, ReturnType<typeof api.post<ResendEmailSendInput<TTemplates>, ResendEmailSendResult<TTemplates>>>>,
+    PathInferredClientOperation<ResolvedResendClientPath<TInput["schedulePath"], "/api/email/schedule">, ReturnType<typeof api.post<ResendEmailScheduleInput<TTemplates>, ResendEmailScheduleResult<TTemplates>>>>,
+    PathInferredClientOperation<ResolvedResendClientPath<TInput["previewPath"], "/api/email/preview">, ReturnType<typeof api.post<ResendEmailPreviewInput<TTemplates>, ResendEmailPreviewResult<TTemplates>>>>,
+    PathInferredClientOperation<ResolvedResendClientPath<TInput["templatesPath"], "/api/email/templates">, ReturnType<typeof api.get<Array<ResendEmailTemplateInfo<TTemplates>>>>>
+];
+export type ResendClientAPI<TTemplates extends EmailTemplates, TInput extends ResendClientPathOptions = {}> = InferPathInferredClientAPI<ResendClientEntries<TTemplates, TInput>>;
+export type ResendDefaultClientAPI<TTemplates extends EmailTemplates = EmailTemplates> = ResendClientAPI<TTemplates>;
+export declare function createResendClientApi<TTemplates extends EmailTemplates>(): ResendDefaultClientAPI<TTemplates>;
+export declare function createResendClientApi<TTemplates extends EmailTemplates, const TInput extends ResendClientPathOptions>(input: TInput): ResendClientAPI<TTemplates, TInput>;
+export declare const resendClient: ResendDefaultClientAPI;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/client.js

@@ -0,0 +1,37 @@
+import { api } from "@farm.js/core/client";
+import { createPathInferredClientApi, } from "@farm.js/integration-utils/integration";
+export function template(component, config) {
+    return {
+        component,
+        ...config,
+    };
+}
+export function createResendClientApi(input) {
+    const sendPath = (input?.sendPath ?? "/api/email/send");
+    const schedulePath = (input?.schedulePath ?? "/api/email/schedule");
+    const previewPath = (input?.previewPath ?? "/api/email/preview");
+    const templatesPath = (input?.templatesPath ??
+        "/api/email/templates");
+    return createPathInferredClientApi({
+        path: sendPath,
+        operation: api.post(sendPath, {
+            responseFormat: "json",
+        }),
+    }, {
+        path: schedulePath,
+        operation: api.post(schedulePath, {
+            responseFormat: "json",
+        }),
+    }, {
+        path: previewPath,
+        operation: api.post(previewPath, {
+            responseFormat: "json",
+        }),
+    }, {
+        path: templatesPath,
+        operation: api.get(templatesPath, {
+            responseFormat: "json",
+        }),
+    });
+}
+export const resendClient = createResendClientApi();

package/dist/index.d.ts

@@ -0,0 +1,130 @@
+import { type FarmIntegrationLogger } from "@farm.js/core";
+import type { FarmWebhookConfig, FarmWebhookEvent } from "@farm.js/integration-utils/webhooks";
+import { type EmailTemplates, type ResendEmailScheduleInput, type ResendEmailScheduleResult, type ResendEmailPreviewInput, type ResendEmailPreviewResult, type ResendEmailSendInput, type ResendEmailSendResult, type ResendEmailTemplateInfo } from "./client.js";
+import { Resend as ResendSdk, type WebhookEventPayload } from "resend";
+export type { EmailScheduleDelay, EmailScheduleWhen, EmailTemplate, EmailTemplates, ResendClientAPI, ResendClientPathOptions, ResendDefaultClientAPI, ResendEmailScheduleInput, ResendEmailScheduleResult, ResendEmailPreviewInput, ResendEmailPreviewResult, ResendEmailSendInput, ResendEmailSendResult, ResendEmailTemplateInfo, ResendWebhookResult, } from "./client.js";
+export type { WebhookEventPayload } from "resend";
+export { createResendClientApi, resendClient, template } from "./client.js";
+export { emailSchedule } from "./schedule.js";
+export interface ResendWebhookEvent extends FarmWebhookEvent<"resend", WebhookEventPayload["type"], WebhookEventPayload["data"], WebhookEventPayload> {
+}
+export type ResendWebhookConfig = FarmWebhookConfig<ResendWebhookEvent>;
+export type ResendIntegrationInstance = ResendSdk;
+export interface ResendIntegrationDefaults {
+    from?: string;
+    replyTo?: string | string[];
+}
+export interface ResendIntegrationInput<TTemplates extends EmailTemplates = EmailTemplates> {
+    apiKey?: string;
+    instance?: ResendSdk;
+    basePath?: string;
+    defaults?: ResendIntegrationDefaults;
+    templates: TTemplates;
+    webhooks?: ResendWebhookConfig;
+    log?: FarmIntegrationLogger;
+}
+interface ResolvedResendConfig {
+    apiKey?: string;
+    from?: string;
+    replyTo?: string | string[];
+    webhookSecret?: string;
+}
+export declare function resend<const TTemplates extends EmailTemplates>(input: ResendIntegrationInput<TTemplates>): import("@farm.js/core").DefinedIntegration<{
+    category: "email";
+    type: string;
+    instance: {
+        basePath: string;
+        defaults: {
+            from: string | null;
+            replyTo: string[];
+        };
+        templateIds: string[];
+        liveMode: boolean;
+    };
+    config: import("@farm.js/core").FarmIntegrationConfigDefinition<ResolvedResendConfig, import("@farm.js/core").FarmIntegrationSchema | undefined>;
+    api: {
+        send: {
+            post: {
+                readonly kind: "farm-integration-api-operation";
+                path: string;
+                method: "POST";
+                bodyFormat?: import("@farm.js/core/client").FarmIntegrationAPIBodyFormat | undefined;
+                responseFormat?: import("@farm.js/core/client").FarmIntegrationAPIResponseFormat | undefined;
+                headers?: {
+                    [x: string]: string;
+                } | undefined;
+                credentials?: RequestCredentials | undefined;
+                isServer?: false | undefined;
+                __pathless?: boolean | undefined;
+                __types?: {
+                    body: ResendEmailSendInput<TTemplates> extends infer T ? T extends ResendEmailSendInput<TTemplates> ? T extends (...args: any[]) => any ? T : T extends object ? { [TKey in keyof T]: T[TKey] extends infer T_1 ? T_1 extends T[TKey] ? T_1 extends (...args: any[]) => any ? T_1 : T_1 extends object ? { [TKey_2 in keyof T_1]: T_1[TKey_2] extends infer T_2 ? T_2 extends T_1[TKey_2] ? T_2 extends (...args: any[]) => any ? T_2 : T_2 extends object ? { [TKey_3 in keyof T_2]: T_2[TKey_3] extends infer T_3 ? T_3 extends T_2[TKey_3] ? T_3 extends (...args: any[]) => any ? T_3 : T_3 extends object ? { [TKey_4 in keyof T_3]: T_3[TKey_4] extends infer T_4 ? T_4 extends T_3[TKey_4] ? T_4 extends (...args: any[]) => any ? T_4 : T_4 extends object ? { [TKey_5 in keyof T_4]: T_4[TKey_5] extends infer T_5 ? T_5 extends T_4[TKey_5] ? T_5 extends (...args: any[]) => any ? T_5 : T_5 extends object ? { [TKey_6 in keyof T_5]: T_5[TKey_6] extends infer T_6 ? T_6 extends T_5[TKey_6] ? T_6 extends (...args: any[]) => any ? T_6 : T_6 extends object ? { [TKey_7 in keyof T_6]: T_6[TKey_7] extends infer T_7 ? T_7 extends T_6[TKey_7] ? T_7 extends (...args: any[]) => any ? T_7 : T_7 extends object ? /*elided*/ any : T_7 : never : never; } : T_6 : never : never; } : T_5 : never : never; } : T_4 : never : never; } : T_3 : never : never; } : T_2 : never : never; } : T_1 : never : never; } : T : never : never;
+                    query: never;
+                    response: ResendEmailSendResult<TTemplates> extends infer T_1 ? T_1 extends ResendEmailSendResult<TTemplates> ? T_1 extends (...args: any[]) => any ? T_1 : T_1 extends object ? { [TKey_1 in keyof T_1]: T_1[TKey_1] extends infer T_2 ? T_2 extends T_1[TKey_1] ? T_2 extends (...args: any[]) => any ? T_2 : T_2 extends object ? { [TKey_3 in keyof T_2]: T_2[TKey_3] extends infer T_3 ? T_3 extends T_2[TKey_3] ? T_3 extends (...args: any[]) => any ? T_3 : T_3 extends object ? { [TKey_4 in keyof T_3]: T_3[TKey_4] extends infer T_4 ? T_4 extends T_3[TKey_4] ? T_4 extends (...args: any[]) => any ? T_4 : T_4 extends object ? { [TKey_5 in keyof T_4]: T_4[TKey_5] extends infer T_5 ? T_5 extends T_4[TKey_5] ? T_5 extends (...args: any[]) => any ? T_5 : T_5 extends object ? { [TKey_6 in keyof T_5]: T_5[TKey_6] extends infer T_6 ? T_6 extends T_5[TKey_6] ? T_6 extends (...args: any[]) => any ? T_6 : T_6 extends object ? { [TKey_7 in keyof T_6]: T_6[TKey_7] extends infer T_7 ? T_7 extends T_6[TKey_7] ? T_7 extends (...args: any[]) => any ? T_7 : T_7 extends object ? { [TKey_8 in keyof T_7]: T_7[TKey_8] extends infer T_8 ? T_8 extends T_7[TKey_8] ? T_8 extends (...args: any[]) => any ? T_8 : T_8 extends object ? /*elided*/ any : T_8 : never : never; } : T_7 : never : never; } : T_6 : never : never; } : T_5 : never : never; } : T_4 : never : never; } : T_3 : never : never; } : T_2 : never : never; } : T_1 : never : never;
+                } | undefined;
+            };
+        };
+        schedule: {
+            post: {
+                readonly kind: "farm-integration-api-operation";
+                path: string;
+                method: "POST";
+                bodyFormat?: import("@farm.js/core/client").FarmIntegrationAPIBodyFormat | undefined;
+                responseFormat?: import("@farm.js/core/client").FarmIntegrationAPIResponseFormat | undefined;
+                headers?: {
+                    [x: string]: string;
+                } | undefined;
+                credentials?: RequestCredentials | undefined;
+                isServer?: false | undefined;
+                __pathless?: boolean | undefined;
+                __types?: {
+                    body: ResendEmailScheduleInput<TTemplates> extends infer T_2 ? T_2 extends ResendEmailScheduleInput<TTemplates> ? T_2 extends (...args: any[]) => any ? T_2 : T_2 extends object ? { [TKey_2 in keyof T_2]: T_2[TKey_2] extends infer T_3 ? T_3 extends T_2[TKey_2] ? T_3 extends (...args: any[]) => any ? T_3 : T_3 extends object ? { [TKey_4 in keyof T_3]: T_3[TKey_4] extends infer T_4 ? T_4 extends T_3[TKey_4] ? T_4 extends (...args: any[]) => any ? T_4 : T_4 extends object ? { [TKey_5 in keyof T_4]: T_4[TKey_5] extends infer T_5 ? T_5 extends T_4[TKey_5] ? T_5 extends (...args: any[]) => any ? T_5 : T_5 extends object ? { [TKey_6 in keyof T_5]: T_5[TKey_6] extends infer T_6 ? T_6 extends T_5[TKey_6] ? T_6 extends (...args: any[]) => any ? T_6 : T_6 extends object ? { [TKey_7 in keyof T_6]: T_6[TKey_7] extends infer T_7 ? T_7 extends T_6[TKey_7] ? T_7 extends (...args: any[]) => any ? T_7 : T_7 extends object ? { [TKey_8 in keyof T_7]: T_7[TKey_8] extends infer T_8 ? T_8 extends T_7[TKey_8] ? T_8 extends (...args: any[]) => any ? T_8 : T_8 extends object ? { [TKey_9 in keyof T_8]: T_8[TKey_9] extends infer T_9 ? T_9 extends T_8[TKey_9] ? T_9 extends (...args: any[]) => any ? T_9 : T_9 extends object ? /*elided*/ any : T_9 : never : never; } : T_8 : never : never; } : T_7 : never : never; } : T_6 : never : never; } : T_5 : never : never; } : T_4 : never : never; } : T_3 : never : never; } : T_2 : never : never;
+                    query: never;
+                    response: ResendEmailScheduleResult<TTemplates> extends infer T_3 ? T_3 extends ResendEmailScheduleResult<TTemplates> ? T_3 extends (...args: any[]) => any ? T_3 : T_3 extends object ? { [TKey_3 in keyof T_3]: T_3[TKey_3] extends infer T_4 ? T_4 extends T_3[TKey_3] ? T_4 extends (...args: any[]) => any ? T_4 : T_4 extends object ? { [TKey_5 in keyof T_4]: T_4[TKey_5] extends infer T_5 ? T_5 extends T_4[TKey_5] ? T_5 extends (...args: any[]) => any ? T_5 : T_5 extends object ? { [TKey_6 in keyof T_5]: T_5[TKey_6] extends infer T_6 ? T_6 extends T_5[TKey_6] ? T_6 extends (...args: any[]) => any ? T_6 : T_6 extends object ? { [TKey_7 in keyof T_6]: T_6[TKey_7] extends infer T_7 ? T_7 extends T_6[TKey_7] ? T_7 extends (...args: any[]) => any ? T_7 : T_7 extends object ? { [TKey_8 in keyof T_7]: T_7[TKey_8] extends infer T_8 ? T_8 extends T_7[TKey_8] ? T_8 extends (...args: any[]) => any ? T_8 : T_8 extends object ? { [TKey_9 in keyof T_8]: T_8[TKey_9] extends infer T_9 ? T_9 extends T_8[TKey_9] ? T_9 extends (...args: any[]) => any ? T_9 : T_9 extends object ? { [TKey_10 in keyof T_9]: T_9[TKey_10] extends infer T_10 ? T_10 extends T_9[TKey_10] ? T_10 extends (...args: any[]) => any ? T_10 : T_10 extends object ? /*elided*/ any : T_10 : never : never; } : T_9 : never : never; } : T_8 : never : never; } : T_7 : never : never; } : T_6 : never : never; } : T_5 : never : never; } : T_4 : never : never; } : T_3 : never : never;
+                } | undefined;
+            };
+        };
+        preview: {
+            post: {
+                readonly kind: "farm-integration-api-operation";
+                path: string;
+                method: "POST";
+                bodyFormat?: import("@farm.js/core/client").FarmIntegrationAPIBodyFormat | undefined;
+                responseFormat?: import("@farm.js/core/client").FarmIntegrationAPIResponseFormat | undefined;
+                headers?: {
+                    [x: string]: string;
+                } | undefined;
+                credentials?: RequestCredentials | undefined;
+                isServer?: false | undefined;
+                __pathless?: boolean | undefined;
+                __types?: {
+                    body: ResendEmailPreviewInput<TTemplates> extends infer T_4 ? T_4 extends ResendEmailPreviewInput<TTemplates> ? T_4 extends (...args: any[]) => any ? T_4 : T_4 extends object ? { [TKey_4 in keyof T_4]: T_4[TKey_4] extends infer T_5 ? T_5 extends T_4[TKey_4] ? T_5 extends (...args: any[]) => any ? T_5 : T_5 extends object ? { [TKey_6 in keyof T_5]: T_5[TKey_6] extends infer T_6 ? T_6 extends T_5[TKey_6] ? T_6 extends (...args: any[]) => any ? T_6 : T_6 extends object ? { [TKey_7 in keyof T_6]: T_6[TKey_7] extends infer T_7 ? T_7 extends T_6[TKey_7] ? T_7 extends (...args: any[]) => any ? T_7 : T_7 extends object ? { [TKey_8 in keyof T_7]: T_7[TKey_8] extends infer T_8 ? T_8 extends T_7[TKey_8] ? T_8 extends (...args: any[]) => any ? T_8 : T_8 extends object ? { [TKey_9 in keyof T_8]: T_8[TKey_9] extends infer T_9 ? T_9 extends T_8[TKey_9] ? T_9 extends (...args: any[]) => any ? T_9 : T_9 extends object ? { [TKey_10 in keyof T_9]: T_9[TKey_10] extends infer T_10 ? T_10 extends T_9[TKey_10] ? T_10 extends (...args: any[]) => any ? T_10 : T_10 extends object ? { [TKey_11 in keyof T_10]: T_10[TKey_11] extends infer T_11 ? T_11 extends T_10[TKey_11] ? T_11 extends (...args: any[]) => any ? T_11 : T_11 extends object ? /*elided*/ any : T_11 : never : never; } : T_10 : never : never; } : T_9 : never : never; } : T_8 : never : never; } : T_7 : never : never; } : T_6 : never : never; } : T_5 : never : never; } : T_4 : never : never;
+                    query: never;
+                    response: ResendEmailPreviewResult<TTemplates> extends infer T_5 ? T_5 extends ResendEmailPreviewResult<TTemplates> ? T_5 extends (...args: any[]) => any ? T_5 : T_5 extends object ? { [TKey_5 in keyof T_5]: T_5[TKey_5] extends infer T_6 ? T_6 extends T_5[TKey_5] ? T_6 extends (...args: any[]) => any ? T_6 : T_6 extends object ? { [TKey_7 in keyof T_6]: T_6[TKey_7] extends infer T_7 ? T_7 extends T_6[TKey_7] ? T_7 extends (...args: any[]) => any ? T_7 : T_7 extends object ? { [TKey_8 in keyof T_7]: T_7[TKey_8] extends infer T_8 ? T_8 extends T_7[TKey_8] ? T_8 extends (...args: any[]) => any ? T_8 : T_8 extends object ? { [TKey_9 in keyof T_8]: T_8[TKey_9] extends infer T_9 ? T_9 extends T_8[TKey_9] ? T_9 extends (...args: any[]) => any ? T_9 : T_9 extends object ? { [TKey_10 in keyof T_9]: T_9[TKey_10] extends infer T_10 ? T_10 extends T_9[TKey_10] ? T_10 extends (...args: any[]) => any ? T_10 : T_10 extends object ? { [TKey_11 in keyof T_10]: T_10[TKey_11] extends infer T_11 ? T_11 extends T_10[TKey_11] ? T_11 extends (...args: any[]) => any ? T_11 : T_11 extends object ? { [TKey_12 in keyof T_11]: T_11[TKey_12] extends infer T_12 ? T_12 extends T_11[TKey_12] ? T_12 extends (...args: any[]) => any ? T_12 : T_12 extends object ? /*elided*/ any : T_12 : never : never; } : T_11 : never : never; } : T_10 : never : never; } : T_9 : never : never; } : T_8 : never : never; } : T_7 : never : never; } : T_6 : never : never; } : T_5 : never : never;
+                } | undefined;
+            };
+        };
+        templates: {
+            get: {
+                readonly kind: "farm-integration-api-operation";
+                path: string;
+                method: "GET";
+                bodyFormat?: import("@farm.js/core/client").FarmIntegrationAPIBodyFormat | undefined;
+                responseFormat?: import("@farm.js/core/client").FarmIntegrationAPIResponseFormat | undefined;
+                headers?: {
+                    [x: string]: string;
+                } | undefined;
+                credentials?: RequestCredentials | undefined;
+                isServer?: false | undefined;
+                __pathless?: boolean | undefined;
+                __types?: {
+                    body: never;
+                    query: (ResendEmailTemplateInfo<TTemplates> extends infer T_6 ? T_6 extends ResendEmailTemplateInfo<TTemplates> ? T_6 extends (...args: any[]) => any ? T_6 : T_6 extends object ? { [TKey_6 in keyof T_6]: T_6[TKey_6] extends infer T_7 ? T_7 extends T_6[TKey_6] ? T_7 extends (...args: any[]) => any ? T_7 : T_7 extends object ? { [TKey_8 in keyof T_7]: T_7[TKey_8] extends infer T_8 ? T_8 extends T_7[TKey_8] ? T_8 extends (...args: any[]) => any ? T_8 : T_8 extends object ? { [TKey_9 in keyof T_8]: T_8[TKey_9] extends infer T_9 ? T_9 extends T_8[TKey_9] ? T_9 extends (...args: any[]) => any ? T_9 : T_9 extends object ? { [TKey_10 in keyof T_9]: T_9[TKey_10] extends infer T_10 ? T_10 extends T_9[TKey_10] ? T_10 extends (...args: any[]) => any ? T_10 : T_10 extends object ? { [TKey_11 in keyof T_10]: T_10[TKey_11] extends infer T_11 ? T_11 extends T_10[TKey_11] ? T_11 extends (...args: any[]) => any ? T_11 : T_11 extends object ? { [TKey_12 in keyof T_11]: T_11[TKey_12] extends infer T_12 ? T_12 extends T_11[TKey_12] ? T_12 extends (...args: any[]) => any ? T_12 : T_12 extends object ? { [TKey_13 in keyof T_12]: T_12[TKey_13] extends infer T_13 ? T_13 extends T_12[TKey_13] ? T_13 extends (...args: any[]) => any ? T_13 : T_13 extends object ? /*elided*/ any : T_13 : never : never; } : T_12 : never : never; } : T_11 : never : never; } : T_10 : never : never; } : T_9 : never : never; } : T_8 : never : never; } : T_7 : never : never; } : T_6 : never : never)[];
+                    response: unknown;
+                } | undefined;
+            };
+        };
+    };
+    log: FarmIntegrationLogger | undefined;
+    routes: (import("@farm.js/core").FarmTypedIntegrationRoute<string, never, never, import("@farm.js/integration-utils").FarmWebhookAckResult, false, "POST", import("@farm.js/core").FarmIntegrationSchema | undefined> | import("@farm.js/core").FarmTypedIntegrationRoute<`${string}/send`, ResendEmailSendInput<TTemplates>, never, ResendEmailSendResult<TTemplates>, false, "POST", import("@farm.js/core").FarmIntegrationSchema | undefined> | import("@farm.js/core").FarmTypedIntegrationRoute<`${string}/schedule`, ResendEmailScheduleInput<TTemplates>, never, ResendEmailScheduleResult<TTemplates>, false, "POST", import("@farm.js/core").FarmIntegrationSchema | undefined> | import("@farm.js/core").FarmTypedIntegrationRoute<`${string}/preview`, ResendEmailPreviewInput<TTemplates>, never, ResendEmailPreviewResult<TTemplates>, false, "POST", import("@farm.js/core").FarmIntegrationSchema | undefined> | import("@farm.js/core").FarmTypedIntegrationRoute<`${string}/templates`, never, never, ResendEmailTemplateInfo<TTemplates>[], false, "GET", import("@farm.js/core").FarmIntegrationSchema | undefined>)[];
+}>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAuC,KAAK,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAEhG,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AAC/F,OAAO,EAGL,KAAK,cAAc,EAInB,KAAK,wBAAwB,EAC7B,KAAK,yBAAyB,EAC9B,KAAK,uBAAuB,EAC5B,KAAK,wBAAwB,EAC7B,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,uBAAuB,EAG7B,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,MAAM,IAAI,SAAS,EAAE,KAAK,mBAAmB,EAAE,MAAM,QAAQ,CAAC;AAEvE,YAAY,EACV,kBAAkB,EAClB,iBAAiB,EACjB,aAAa,EACb,cAAc,EACd,eAAe,EACf,uBAAuB,EACvB,sBAAsB,EACtB,wBAAwB,EACxB,yBAAyB,EACzB,uBAAuB,EACvB,wBAAwB,EACxB,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,mBAAmB,EAAE,MAAM,QAAQ,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5E,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE9C,MAAM,WAAW,kBAAmB,SAAQ,gBAAgB,CAC1D,QAAQ,EACR,mBAAmB,CAAC,MAAM,CAAC,EAC3B,mBAAmB,CAAC,MAAM,CAAC,EAC3B,mBAAmB,CACpB;CAAG;AAEJ,MAAM,MAAM,mBAAmB,GAAG,iBAAiB,CAAC,kBAAkB,CAAC,CAAC;AACxE,MAAM,MAAM,yBAAyB,GAAG,SAAS,CAAC;AAElD,MAAM,WAAW,yBAAyB;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,sBAAsB,CAAC,UAAU,SAAS,cAAc,GAAG,cAAc;IACxF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,yBAAyB,CAAC;IACrC,SAAS,EAAE,UAAU,CAAC;IACtB,QAAQ,CAAC,EAAE,mBAAmB,CAAC;IAC/B,GAAG,CAAC,EAAE,qBAAqB,CAAC;CAC7B;AAED,UAAU,oBAAoB;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAoED,wBAAgB,MAAM,CAAC,KAAK,CAAC,UAAU,SAAS,cAAc,EAC5D,KAAK,EAAE,sBAAsB,CAAC,UAAU,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8b1C"}

package/dist/index.js

@@ -0,0 +1,378 @@
+import { render, toPlainText } from "@react-email/render";
+import { defineIntegration, integrationRoute } from "@farm.js/core";
+import { integrationConfig, normalizeWebhookConfig } from "@farm.js/integration-utils";
+import { createResendClientApi, } from "./client.js";
+import { createElement } from "react";
+import { resolveEmailScheduleWhen } from "./schedule.js";
+import { Resend as ResendSdk } from "resend";
+export { createResendClientApi, resendClient, template } from "./client.js";
+export { emailSchedule } from "./schedule.js";
+function createResendApi(input = {}) {
+    return createResendClientApi(input);
+}
+function normalizeBasePath(path) {
+    if (!path) {
+        return "/api/email";
+    }
+    return path.endsWith("/") ? path.slice(0, -1) : path;
+}
+async function resolveTemplateString(value, data) {
+    if (typeof value === "function") {
+        return await value(data);
+    }
+    return value ?? null;
+}
+async function resolveReplyToValue(value, data) {
+    if (typeof value === "function") {
+        return await value(data);
+    }
+    return value ?? null;
+}
+function normalizeToArray(value) {
+    if (!value) {
+        return [];
+    }
+    return Array.isArray(value) ? value : [value];
+}
+function getWebhookHeader(headers, name) {
+    const value = headers.get(name);
+    if (!value) {
+        throw new Error(`Missing Resend webhook header: ${name}`);
+    }
+    return value;
+}
+function isResendSdk(value) {
+    return !!value && typeof value === "object" && "emails" in value && "webhooks" in value;
+}
+function getTemplatePreviewProps(component) {
+    return component.PreviewProps ?? null;
+}
+export function resend(input) {
+    const apiKey = input.apiKey ?? process.env.RESEND_API_KEY ?? undefined;
+    const basePath = normalizeBasePath(input.basePath);
+    const defaults = {
+        from: input.defaults?.from ?? process.env.RESEND_FROM_EMAIL ?? undefined,
+        replyTo: input.defaults?.replyTo ?? process.env.RESEND_REPLY_TO_EMAIL ?? undefined,
+    };
+    const webhookSecret = process.env.RESEND_WEBHOOK_SECRET ?? undefined;
+    if (!input.instance && !apiKey) {
+        throw new Error("Resend integration requires RESEND_API_KEY or an explicit instance.");
+    }
+    const sendPath = `${basePath}/send`;
+    const schedulePath = `${basePath}/schedule`;
+    const previewPath = `${basePath}/preview`;
+    const templatesPath = `${basePath}/templates`;
+    const webhookDefinitions = normalizeWebhookConfig({
+        webhooks: input.webhooks,
+        defaultName: "default",
+        defaultPath: `${basePath}/webhook`,
+        defaultSecret: webhookSecret,
+    });
+    const sdk = input.instance ?? new ResendSdk(apiKey);
+    if (!isResendSdk(sdk)) {
+        throw new Error("Resend integration instance is invalid.");
+    }
+    const templateEntries = Object.entries(input.templates);
+    async function resolveTemplate(templateId) {
+        const match = templateEntries.find(([candidate]) => candidate === templateId);
+        return match;
+    }
+    const webhookRoutes = webhookDefinitions.map((definition) => integrationRoute.post(definition.path, {
+        rawBody: true,
+        responseFormat: "json",
+        async handler(request, context) {
+            const rawBody = await request.text();
+            const webhookContext = {
+                request,
+                route: context,
+                rawBody,
+                headers: request.headers,
+                webhook: {
+                    name: definition.name,
+                    path: definition.path,
+                },
+            };
+            try {
+                if (!definition.secret) {
+                    throw new Error("Resend webhook secret is required to verify webhook events.");
+                }
+                const payload = sdk.webhooks.verify({
+                    payload: rawBody,
+                    webhookSecret: definition.secret,
+                    headers: {
+                        id: getWebhookHeader(request.headers, "svix-id"),
+                        timestamp: getWebhookHeader(request.headers, "svix-timestamp"),
+                        signature: getWebhookHeader(request.headers, "svix-signature"),
+                    },
+                });
+                const eventId = request.headers.get("svix-id") ?? `${payload.type}:${Date.now()}`;
+                const event = {
+                    provider: "resend",
+                    id: eventId,
+                    type: payload.type,
+                    data: payload.data,
+                    raw: payload,
+                };
+                await definition.onEvent?.(event, webhookContext);
+                return Response.json({
+                    received: true,
+                    provider: "resend",
+                    webhook: definition.name,
+                    eventId: event.id,
+                    type: event.type,
+                });
+            }
+            catch (error) {
+                const override = await definition.onError?.(error, webhookContext);
+                if (override) {
+                    return override;
+                }
+                return Response.json({
+                    error: error instanceof Error ? error.message : "Resend webhook verification failed.",
+                }, {
+                    status: 400,
+                });
+            }
+        },
+    }));
+    return defineIntegration({
+        category: "email",
+        type: "resend",
+        instance: {
+            basePath,
+            defaults: {
+                from: defaults.from ?? null,
+                replyTo: normalizeToArray(defaults.replyTo),
+            },
+            templateIds: templateEntries.map(([id]) => id),
+            liveMode: !!apiKey,
+        },
+        config: integrationConfig({
+            label: "Resend integration",
+            env: {
+                apiKey: "RESEND_API_KEY",
+                from: "RESEND_FROM_EMAIL",
+                replyTo: "RESEND_REPLY_TO_EMAIL",
+                webhookSecret: "RESEND_WEBHOOK_SECRET",
+            },
+            input: {
+                apiKey,
+                from: defaults.from,
+                replyTo: defaults.replyTo,
+                webhookSecret,
+            },
+            required: input.instance ? [] : ["apiKey"],
+        }),
+        api: createResendApi({
+            sendPath,
+            schedulePath,
+            previewPath,
+            templatesPath,
+        }),
+        log: input.log,
+        routes: [
+            integrationRoute.post(sendPath, {
+                responseFormat: "json",
+                async handler(request, context) {
+                    const body = (await request.json());
+                    const resolved = await resolveTemplate(body.templateId);
+                    if (!resolved) {
+                        return Response.json({
+                            error: `Unknown email template "${body.templateId}".`,
+                        }, {
+                            status: 400,
+                        });
+                    }
+                    const [templateId, configuredTemplate] = resolved;
+                    context.req.set("email.templateId", templateId);
+                    context.req.set("email.data", body.data);
+                    const subject = await resolveTemplateString(configuredTemplate.subject, body.data);
+                    const previewText = await resolveTemplateString(configuredTemplate.previewText, body.data);
+                    const from = body.from ??
+                        (await resolveTemplateString(configuredTemplate.from, body.data)) ??
+                        defaults.from;
+                    if (!subject) {
+                        return Response.json({
+                            error: `Email template "${templateId}" produced an empty subject.`,
+                        }, {
+                            status: 400,
+                        });
+                    }
+                    if (!from) {
+                        return Response.json({
+                            error: "Resend email sending requires a from address. Configure defaults.from, RESEND_FROM_EMAIL, or pass body.from.",
+                        }, {
+                            status: 400,
+                        });
+                    }
+                    const replyTo = body.replyTo ??
+                        (await resolveReplyToValue(configuredTemplate.replyTo, body.data)) ??
+                        defaults.replyTo;
+                    const reactNode = createElement(configuredTemplate.component, body.data);
+                    const result = await sdk.emails.send({
+                        from,
+                        to: body.to,
+                        cc: body.cc,
+                        bcc: body.bcc,
+                        replyTo: replyTo ?? undefined,
+                        subject,
+                        react: reactNode,
+                        headers: body.headers,
+                        tags: body.tags,
+                        attachments: body.attachments,
+                        topicId: body.topicId,
+                        scheduledAt: body.scheduledAt,
+                    }, body.idempotencyKey ? { idempotencyKey: body.idempotencyKey } : undefined);
+                    if (result.error || !result.data?.id) {
+                        return Response.json({
+                            error: result.error?.message ?? "Resend email send failed.",
+                        }, {
+                            status: result.error?.statusCode ?? 400,
+                        });
+                    }
+                    return Response.json({
+                        id: result.data.id,
+                        provider: "resend",
+                        templateId,
+                        from,
+                        to: normalizeToArray(body.to),
+                        subject,
+                        previewText,
+                    });
+                },
+            }),
+            integrationRoute.post(schedulePath, {
+                responseFormat: "json",
+                async handler(request, context) {
+                    const body = (await request.json());
+                    let when;
+                    try {
+                        when = resolveEmailScheduleWhen(body.when);
+                    }
+                    catch (error) {
+                        return Response.json({
+                            error: error instanceof Error ? error.message : "Invalid email scheduling input.",
+                        }, {
+                            status: 400,
+                        });
+                    }
+                    const resolved = await resolveTemplate(body.templateId);
+                    if (!resolved) {
+                        return Response.json({
+                            error: `Unknown email template "${body.templateId}".`,
+                        }, {
+                            status: 400,
+                        });
+                    }
+                    const [templateId, configuredTemplate] = resolved;
+                    context.req.set("email.templateId", templateId);
+                    context.req.set("email.data", body.data);
+                    context.req.set("email.when", when);
+                    const subject = await resolveTemplateString(configuredTemplate.subject, body.data);
+                    const previewText = await resolveTemplateString(configuredTemplate.previewText, body.data);
+                    const from = body.from ??
+                        (await resolveTemplateString(configuredTemplate.from, body.data)) ??
+                        defaults.from;
+                    if (!subject) {
+                        return Response.json({
+                            error: `Email template "${templateId}" produced an empty subject.`,
+                        }, {
+                            status: 400,
+                        });
+                    }
+                    if (!from) {
+                        return Response.json({
+                            error: "Resend email scheduling requires a from address. Configure defaults.from, RESEND_FROM_EMAIL, or pass body.from.",
+                        }, {
+                            status: 400,
+                        });
+                    }
+                    const replyTo = body.replyTo ??
+                        (await resolveReplyToValue(configuredTemplate.replyTo, body.data)) ??
+                        defaults.replyTo;
+                    const reactNode = createElement(configuredTemplate.component, body.data);
+                    const result = await sdk.emails.send({
+                        from,
+                        to: body.to,
+                        cc: body.cc,
+                        bcc: body.bcc,
+                        replyTo: replyTo ?? undefined,
+                        subject,
+                        react: reactNode,
+                        headers: body.headers,
+                        tags: body.tags,
+                        attachments: body.attachments,
+                        topicId: body.topicId,
+                        scheduledAt: when,
+                    }, body.idempotencyKey ? { idempotencyKey: body.idempotencyKey } : undefined);
+                    if (result.error || !result.data?.id) {
+                        return Response.json({
+                            error: result.error?.message ?? "Resend email scheduling failed.",
+                        }, {
+                            status: result.error?.statusCode ?? 400,
+                        });
+                    }
+                    return Response.json({
+                        id: result.data.id,
+                        provider: "resend",
+                        templateId,
+                        from,
+                        to: normalizeToArray(body.to),
+                        subject,
+                        previewText,
+                        when,
+                    });
+                },
+            }),
+            integrationRoute.post(previewPath, {
+                responseFormat: "json",
+                async handler(request, context) {
+                    const body = (await request.json());
+                    const resolved = await resolveTemplate(body.templateId);
+                    if (!resolved) {
+                        return Response.json({
+                            error: `Unknown email template "${body.templateId}".`,
+                        }, {
+                            status: 400,
+                        });
+                    }
+                    const [templateId, configuredTemplate] = resolved;
+                    context.req.set("email.templateId", templateId);
+                    context.req.set("email.data", body.data);
+                    const subject = await resolveTemplateString(configuredTemplate.subject, body.data);
+                    const previewText = await resolveTemplateString(configuredTemplate.previewText, body.data);
+                    if (!subject) {
+                        return Response.json({
+                            error: `Email template "${templateId}" produced an empty subject.`,
+                        }, {
+                            status: 400,
+                        });
+                    }
+                    const reactNode = createElement(configuredTemplate.component, body.data);
+                    const html = await render(reactNode);
+                    const text = toPlainText(html);
+                    return Response.json({
+                        templateId,
+                        subject,
+                        previewText,
+                        html,
+                        text,
+                    });
+                },
+            }),
+            integrationRoute.get(templatesPath, {
+                responseFormat: "json",
+                async handler() {
+                    return Response.json(templateEntries.map(([id, configuredTemplate]) => ({
+                        id,
+                        hasPreviewText: Boolean(configuredTemplate.previewText),
+                        hasCustomFrom: Boolean(configuredTemplate.from),
+                        hasCustomReplyTo: Boolean(configuredTemplate.replyTo),
+                        previewProps: getTemplatePreviewProps(configuredTemplate.component),
+                    })));
+                },
+            }),
+            ...webhookRoutes,
+        ],
+    });
+}

package/dist/schedule.d.ts

@@ -0,0 +1,29 @@
+export interface EmailScheduleDelay {
+    kind: "delay";
+    seconds: number;
+}
+export type EmailScheduleWhen = string | number | Date | EmailScheduleDelay;
+export declare const emailSchedule: {
+    readonly after: {
+        readonly seconds: (seconds: number) => EmailScheduleDelay;
+        readonly second: (seconds: number) => EmailScheduleDelay;
+        readonly sec: (seconds: number) => EmailScheduleDelay;
+        readonly minutes: (minutes: number) => EmailScheduleDelay;
+        readonly minute: (minutes: number) => EmailScheduleDelay;
+        readonly min: (minutes: number) => EmailScheduleDelay;
+        readonly hours: (hours: number) => EmailScheduleDelay;
+        readonly hour: (hours: number) => EmailScheduleDelay;
+        readonly hr: (hours: number) => EmailScheduleDelay;
+        readonly days: (days: number) => EmailScheduleDelay;
+        readonly day: (days: number) => EmailScheduleDelay;
+    };
+    readonly presets: {
+        readonly in30Minutes: EmailScheduleDelay;
+        readonly in1Hour: EmailScheduleDelay;
+        readonly in2Hours: EmailScheduleDelay;
+        readonly in1Day: EmailScheduleDelay;
+    };
+};
+export declare function isEmailScheduleDelay(value: unknown): value is EmailScheduleDelay;
+export declare function resolveEmailScheduleWhen(when: EmailScheduleWhen, now?: number): string;
+//# sourceMappingURL=schedule.d.ts.map

package/dist/schedule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule.d.ts","sourceRoot":"","sources":["../src/schedule.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,kBAAkB,CAAC;AAS5E,eAAO,MAAM,aAAa;;oCAEH,MAAM;mCACP,MAAM;gCACT,MAAM;oCACF,MAAM;mCACP,MAAM;gCACT,MAAM;gCACN,MAAM;+BACP,MAAM;6BACR,MAAM;8BACL,MAAM;6BACP,MAAM;;;;;;;;CAQZ,CAAC;AAEX,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,kBAAkB,CAShF;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,iBAAiB,EAAE,GAAG,SAAa,UAgCjF"}

package/dist/schedule.js

@@ -0,0 +1,60 @@
+function createScheduleDelay(seconds) {
+    return {
+        kind: "delay",
+        seconds,
+    };
+}
+export const emailSchedule = {
+    after: {
+        seconds: (seconds) => createScheduleDelay(seconds),
+        second: (seconds) => createScheduleDelay(seconds),
+        sec: (seconds) => createScheduleDelay(seconds),
+        minutes: (minutes) => createScheduleDelay(minutes * 60),
+        minute: (minutes) => createScheduleDelay(minutes * 60),
+        min: (minutes) => createScheduleDelay(minutes * 60),
+        hours: (hours) => createScheduleDelay(hours * 60 * 60),
+        hour: (hours) => createScheduleDelay(hours * 60 * 60),
+        hr: (hours) => createScheduleDelay(hours * 60 * 60),
+        days: (days) => createScheduleDelay(days * 24 * 60 * 60),
+        day: (days) => createScheduleDelay(days * 24 * 60 * 60),
+    },
+    presets: {
+        in30Minutes: createScheduleDelay(30 * 60),
+        in1Hour: createScheduleDelay(60 * 60),
+        in2Hours: createScheduleDelay(2 * 60 * 60),
+        in1Day: createScheduleDelay(24 * 60 * 60),
+    },
+};
+export function isEmailScheduleDelay(value) {
+    return (!!value &&
+        typeof value === "object" &&
+        "kind" in value &&
+        "seconds" in value &&
+        value.kind === "delay" &&
+        typeof value.seconds === "number");
+}
+export function resolveEmailScheduleWhen(when, now = Date.now()) {
+    if (when instanceof Date) {
+        return when.toISOString();
+    }
+    if (typeof when === "number") {
+        if (!Number.isFinite(when) || when <= 0) {
+            throw new Error("Email schedule delay seconds must be a positive finite number.");
+        }
+        return new Date(now + when * 1000).toISOString();
+    }
+    if (isEmailScheduleDelay(when)) {
+        if (!Number.isFinite(when.seconds) || when.seconds <= 0) {
+            throw new Error("Email schedule delay seconds must be a positive finite number.");
+        }
+        return new Date(now + when.seconds * 1000).toISOString();
+    }
+    if (typeof when === "string") {
+        const value = when.trim();
+        if (!value) {
+            throw new Error("Email scheduling requires a non-empty when value.");
+        }
+        return value;
+    }
+    throw new Error("Unsupported email schedule value.");
+}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@farm.js/email",
+  "version": "0.1.0-beta.0",
+  "description": "Email and Resend integration for Farm.js",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/farming-labs/farm.js",
+    "directory": "packages/farm-email"
+  },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./client": {
+      "types": "./dist/client.d.ts",
+      "import": "./dist/client.js"
+    },
+    "./schedule": {
+      "types": "./dist/schedule.d.ts",
+      "import": "./dist/schedule.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@react-email/render": "2.0.6",
+    "resend": "6.10.0",
+    "@farm.js/core": "0.1.0-beta.0",
+    "@farm.js/integration-utils": "0.1.0-beta.0"
+  },
+  "devDependencies": {
+    "@types/react": "19.2.13"
+  },
+  "peerDependencies": {
+    "react": "^18.2.0 || ^19.0.0"
+  },
+  "scripts": {
+    "build": "node -e \"require('node:fs').rmSync('dist', { recursive: true, force: true })\" && tsc",
+    "dev": "tsc --watch",
+    "type-check": "tsc --noEmit",
+    "test": "echo 'No tests in this package'"
+  }
+}