alchemy 0.25.0 → 0.26.1

package/lib/cloudflare/email-catch-all.d.ts

@@ -0,0 +1,123 @@
+import type { Context } from "../context.ts";
+import { Resource } from "../resource.ts";
+import { type CloudflareApiOptions } from "./api.ts";
+import type { EmailAction, EmailMatcher } from "./email-rule.ts";
+import type { Zone } from "./zone.ts";
+/**
+ * Properties for configuring the catch-all email rule
+ */
+export interface EmailCatchAllProps extends CloudflareApiOptions {
+    /**
+     * Zone ID or Zone resource where the catch-all rule will be configured
+     */
+    zone: string | Zone;
+    /**
+     * Whether the catch-all rule is enabled
+     *
+     * @default true
+     */
+    enabled?: boolean;
+    /**
+     * Name for the catch-all rule
+     *
+     * @default "Catch All"
+     */
+    name?: string;
+    /**
+     * Matchers for the catch-all rule (typically matches all emails)
+     * If not provided, defaults to matching all emails
+     */
+    matchers?: EmailMatcher[];
+    /**
+     * Actions to take for emails that don't match other rules
+     */
+    actions: EmailAction[];
+}
+/**
+ * A catch-all email routing rule for a Cloudflare zone
+ */
+export interface EmailCatchAll extends Resource<"cloudflare::EmailCatchAll"> {
+    /**
+     * Zone ID where the catch-all rule is configured
+     */
+    zoneId: string;
+    /**
+     * Whether the catch-all rule is enabled
+     */
+    enabled: boolean;
+    /**
+     * Rule name
+     */
+    name: string;
+    /**
+     * Matchers for the catch-all rule
+     */
+    matchers: EmailMatcher[];
+    /**
+     * Actions for the catch-all rule
+     */
+    actions: EmailAction[];
+    /**
+     * Rule tag
+     */
+    tag: string;
+}
+/**
+ * Configures a catch-all email routing rule that handles emails not matched by other rules.
+ * This rule is processed last and typically matches all emails that haven't been handled.
+ *
+ * @example
+ * ## Forward all unmatched emails
+ *
+ * Set up a catch-all rule to forward any unmatched emails to an admin address.
+ *
+ * ```ts
+ * const catchAll = await EmailCatchAll("default-catchall", {
+ *   zone: "example.com",
+ *   enabled: true,
+ *   actions: [
+ *     {
+ *       type: "forward",
+ *       value: ["admin@company.com"]
+ *     }
+ *   ]
+ * });
+ * ```
+ *
+ * @example
+ * ## Drop unmatched emails
+ *
+ * Configure catch-all to drop any emails that don't match specific rules.
+ *
+ * ```ts
+ * const catchAll = await EmailCatchAll("drop-catchall", {
+ *   zone: "example.com",
+ *   enabled: true,
+ *   actions: [
+ *     {
+ *       type: "drop"
+ *     }
+ *   ]
+ * });
+ * ```
+ *
+ * @example
+ * ## Process with Worker
+ *
+ * Use a Worker to handle all unmatched emails for custom processing.
+ *
+ * ```ts
+ * const catchAll = await EmailCatchAll("worker-catchall", {
+ *   zone: "example.com",
+ *   enabled: true,
+ *   actions: [
+ *     {
+ *       type: "worker",
+ *       value: ["email-processor"]
+ *     }
+ *   ]
+ * });
+ * ```
+ */
+export declare const EmailCatchAll: (((this: any, id: string, props?: {}) => never) & (new (_: never) => never)) | ((this: Context<EmailCatchAll>, _id: string, props: EmailCatchAllProps) => Promise<EmailCatchAll>);
+//# sourceMappingURL=email-catch-all.d.ts.map

package/lib/cloudflare/email-catch-all.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-catch-all.d.ts","sourceRoot":"","sources":["../../src/cloudflare/email-catch-all.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,KAAK,oBAAoB,EAAuB,MAAM,UAAU,CAAC;AAE1E,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACjE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAatC;;GAEG;AACH,MAAM,WAAW,kBAAmB,SAAQ,oBAAoB;IAC9D;;OAEG;IACH,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAEpB;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAC;IAE1B;;OAEG;IACH,OAAO,EAAE,WAAW,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,aAAc,SAAQ,QAAQ,CAAC,2BAA2B,CAAC;IAC1E;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,QAAQ,EAAE,YAAY,EAAE,CAAC;IAEzB;;OAEG;IACH,OAAO,EAAE,WAAW,EAAE,CAAC;IAEvB;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwDG;AACH,eAAO,MAAM,aAAa,yFAGhB,OAAO,CAAC,aAAa,CAAC,OACvB,MAAM,SACJ,kBAAkB,KACxB,OAAO,CAAC,aAAa,CAAC,CAgG1B,CAAC"}

package/lib/cloudflare/email-catch-all.js

@@ -0,0 +1,124 @@
+import { Resource } from "../resource.js";
+import { createCloudflareApi } from "./api.js";
+/**
+ * Configures a catch-all email routing rule that handles emails not matched by other rules.
+ * This rule is processed last and typically matches all emails that haven't been handled.
+ *
+ * @example
+ * ## Forward all unmatched emails
+ *
+ * Set up a catch-all rule to forward any unmatched emails to an admin address.
+ *
+ * ```ts
+ * const catchAll = await EmailCatchAll("default-catchall", {
+ *   zone: "example.com",
+ *   enabled: true,
+ *   actions: [
+ *     {
+ *       type: "forward",
+ *       value: ["admin@company.com"]
+ *     }
+ *   ]
+ * });
+ * ```
+ *
+ * @example
+ * ## Drop unmatched emails
+ *
+ * Configure catch-all to drop any emails that don't match specific rules.
+ *
+ * ```ts
+ * const catchAll = await EmailCatchAll("drop-catchall", {
+ *   zone: "example.com",
+ *   enabled: true,
+ *   actions: [
+ *     {
+ *       type: "drop"
+ *     }
+ *   ]
+ * });
+ * ```
+ *
+ * @example
+ * ## Process with Worker
+ *
+ * Use a Worker to handle all unmatched emails for custom processing.
+ *
+ * ```ts
+ * const catchAll = await EmailCatchAll("worker-catchall", {
+ *   zone: "example.com",
+ *   enabled: true,
+ *   actions: [
+ *     {
+ *       type: "worker",
+ *       value: ["email-processor"]
+ *     }
+ *   ]
+ * });
+ * ```
+ */
+export const EmailCatchAll = Resource("cloudflare::EmailCatchAll", async function (_id, props) {
+    const api = await createCloudflareApi(props);
+    const zoneId = typeof props.zone === "string" ? props.zone : props.zone.id;
+    if (this.phase === "delete") {
+        // Disable the catch-all rule by setting enabled to false
+        const disablePayload = {
+            enabled: false,
+            name: "Catch All",
+            matchers: [{ type: "all" }],
+            actions: [{ type: "drop" }],
+        };
+        const response = await api.put(`/zones/${zoneId}/email/routing/rules/catch_all`, disablePayload);
+        if (!response.ok && response.status !== 404) {
+            throw new Error(`Failed to disable catch-all rule: ${response.statusText}`);
+        }
+        return this.destroy();
+    }
+    // Get current catch-all rule state
+    const _getResponse = await api.get(`/zones/${zoneId}/email/routing/rules/catch_all`);
+    if (this.phase === "update" && this.output) {
+        // Update the catch-all rule
+        const updatePayload = {
+            enabled: props.enabled ?? true,
+            name: props.name || "Catch All",
+            matchers: props.matchers || [{ type: "all" }],
+            actions: props.actions,
+        };
+        const response = await api.put(`/zones/${zoneId}/email/routing/rules/catch_all`, updatePayload);
+        if (!response.ok) {
+            const errorBody = await response.text();
+            throw new Error(`Failed to update catch-all rule: ${response.statusText}\nResponse: ${errorBody}`);
+        }
+        const result = (await response.json());
+        return this({
+            zoneId,
+            enabled: result.result.enabled,
+            name: result.result.name,
+            matchers: result.result.matchers,
+            actions: result.result.actions,
+            tag: result.result.tag,
+        });
+    }
+    // Create or update catch-all rule
+    const catchAllPayload = {
+        enabled: props.enabled ?? true,
+        name: props.name || "Catch All",
+        matchers: props.matchers || [{ type: "all" }],
+        actions: props.actions,
+    };
+    const response = await api.put(`/zones/${zoneId}/email/routing/rules/catch_all`, catchAllPayload);
+    if (!response.ok) {
+        const errorBody = await response.text();
+        throw new Error(`Failed to configure catch-all rule: ${response.statusText}\nResponse: ${errorBody}`);
+    }
+    const result = (await response.json());
+    return this({
+        zoneId,
+        enabled: result.result.enabled,
+        name: result.result.name,
+        matchers: result.result.matchers,
+        actions: result.result.actions,
+        tag: result.result.tag,
+    });
+});
+//# sourceMappingURL=email-catch-all.js.map

package/lib/cloudflare/email-catch-all.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-catch-all.js","sourceRoot":"","sources":["../../src/cloudflare/email-catch-all.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAA6B,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAsF1E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwDG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,QAAQ,CACnC,2BAA2B,EAC3B,KAAK,WAEH,GAAW,EACX,KAAyB;IAEzB,MAAM,GAAG,GAAG,MAAM,mBAAmB,CAAC,KAAK,CAAC,CAAC;IAC7C,MAAM,MAAM,GAAG,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;IAE3E,IAAI,IAAI,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC5B,yDAAyD;QACzD,MAAM,cAAc,GAAG;YACrB,OAAO,EAAE,KAAK;YACd,IAAI,EAAE,WAAW;YACjB,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,KAAc,EAAE,CAAC;YACpC,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,CAAC;SACrC,CAAC;QAEF,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,GAAG,CAC5B,UAAU,MAAM,gCAAgC,EAChD,cAAc,CACf,CAAC;QACF,IAAI,CAAC,QAAQ,CAAC,EAAE,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YAC5C,MAAM,IAAI,KAAK,CACb,qCAAqC,QAAQ,CAAC,UAAU,EAAE,CAC3D,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC;IACxB,CAAC;IAED,mCAAmC;IACnC,MAAM,YAAY,GAAG,MAAM,GAAG,CAAC,GAAG,CAChC,UAAU,MAAM,gCAAgC,CACjD,CAAC;IAEF,IAAI,IAAI,CAAC,KAAK,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAC3C,4BAA4B;QAC5B,MAAM,aAAa,GAAG;YACpB,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,IAAI;YAC9B,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,WAAW;YAC/B,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,CAAC,EAAE,IAAI,EAAE,KAAc,EAAE,CAAC;YACtD,OAAO,EAAE,KAAK,CAAC,OAAO;SACvB,CAAC;QAEF,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,GAAG,CAC5B,UAAU,MAAM,gCAAgC,EAChD,aAAa,CACd,CAAC;QAEF,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACxC,MAAM,IAAI,KAAK,CACb,oCAAoC,QAAQ,CAAC,UAAU,eAAe,SAAS,EAAE,CAClF,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GACV,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAgD,CAAC;QAEzE,OAAO,IAAI,CAAC;YACV,MAAM;YACN,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO;YAC9B,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI;YACxB,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,QAAQ;YAChC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO;YAC9B,GAAG,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG;SACvB,CAAC,CAAC;IACL,CAAC;IAED,kCAAkC;IAClC,MAAM,eAAe,GAAG;QACtB,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,IAAI;QAC9B,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,WAAW;QAC/B,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,CAAC,EAAE,IAAI,EAAE,KAAc,EAAE,CAAC;QACtD,OAAO,EAAE,KAAK,CAAC,OAAO;KACvB,CAAC;IAEF,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,GAAG,CAC5B,UAAU,MAAM,gCAAgC,EAChD,eAAe,CAChB,CAAC;IAEF,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CACb,uCAAuC,QAAQ,CAAC,UAAU,eAAe,SAAS,EAAE,CACrF,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GACV,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAgD,CAAC;IAEzE,OAAO,IAAI,CAAC;QACV,MAAM;QACN,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO;QAC9B,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI;QACxB,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,QAAQ;QAChC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO;QAC9B,GAAG,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG;KACvB,CAAC,CAAC;AACL,CAAC,CACF,CAAC"}

package/lib/cloudflare/email-routing.d.ts

@@ -0,0 +1,89 @@
+import type { Context } from "../context.ts";
+import { Resource } from "../resource.ts";
+import { type CloudflareApiOptions } from "./api.ts";
+import type { Zone } from "./zone.ts";
+/**
+ * Properties for configuring email routing on a zone
+ */
+export interface EmailRoutingProps extends CloudflareApiOptions {
+    /**
+     * Zone ID or Zone resource where email routing will be configured
+     */
+    zone: string | Zone;
+    /**
+     * Whether email routing should be enabled
+     *
+     * @default true
+     */
+    enabled?: boolean;
+    /**
+     * Skip the DNS setup wizard when enabling email routing
+     *
+     * @default false
+     */
+    skipWizard?: boolean;
+}
+/**
+ * Email routing configuration for a Cloudflare zone
+ */
+export interface EmailRouting extends Resource<"cloudflare::EmailRouting"> {
+    /**
+     * Zone ID where email routing is configured
+     */
+    zoneId: string;
+    /**
+     * Whether email routing is enabled
+     */
+    enabled: boolean;
+    /**
+     * Zone name
+     */
+    name: string;
+    /**
+     * When email routing was created
+     */
+    created: string;
+    /**
+     * When email routing was last modified
+     */
+    modified: string;
+    /**
+     * Zone tag
+     */
+    tag: string;
+}
+/**
+ * Configures email routing for a Cloudflare zone, allowing emails sent to the zone's domain
+ * to be routed according to defined rules.
+ *
+ * @example
+ * ## Enable email routing for a zone
+ *
+ * Enable email routing for your domain to start receiving and routing emails.
+ *
+ * ```ts
+ * const emailRouting = await EmailRouting("example.com-routing", {
+ *   zone: "example.com",
+ *   enabled: true
+ * });
+ * ```
+ *
+ * @example
+ * ## Use with existing Zone resource
+ *
+ * Configure email routing using an existing Zone resource reference.
+ *
+ * ```ts
+ * const zone = await Zone("my-zone", {
+ *   name: "example.com"
+ * });
+ *
+ * const emailRouting = await EmailRouting("example.com-routing", {
+ *   zone: zone,
+ *   enabled: true,
+ *   skipWizard: true
+ * });
+ * ```
+ */
+export declare const EmailRouting: (((this: any, id: string, props?: {}) => never) & (new (_: never) => never)) | ((this: Context<EmailRouting>, _id: string, props: EmailRoutingProps) => Promise<EmailRouting>);
+//# sourceMappingURL=email-routing.d.ts.map

package/lib/cloudflare/email-routing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-routing.d.ts","sourceRoot":"","sources":["../../src/cloudflare/email-routing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,OAAO,EAAE,KAAK,oBAAoB,EAAuB,MAAM,UAAU,CAAC;AAE1E,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAatC;;GAEG;AACH,MAAM,WAAW,iBAAkB,SAAQ,oBAAoB;IAC7D;;OAEG;IACH,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAEpB;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,YAAa,SAAQ,QAAQ,CAAC,0BAA0B,CAAC;IACxE;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,eAAO,MAAM,YAAY,yFAGf,OAAO,CAAC,YAAY,CAAC,OACtB,MAAM,SACJ,iBAAiB,KACvB,OAAO,CAAC,YAAY,CAAC,CAiHzB,CAAC"}

package/lib/cloudflare/email-routing.js

@@ -0,0 +1,120 @@
+import { Resource } from "../resource.js";
+import { handleApiError } from "./api-error.js";
+import { createCloudflareApi } from "./api.js";
+/**
+ * Configures email routing for a Cloudflare zone, allowing emails sent to the zone's domain
+ * to be routed according to defined rules.
+ *
+ * @example
+ * ## Enable email routing for a zone
+ *
+ * Enable email routing for your domain to start receiving and routing emails.
+ *
+ * ```ts
+ * const emailRouting = await EmailRouting("example.com-routing", {
+ *   zone: "example.com",
+ *   enabled: true
+ * });
+ * ```
+ *
+ * @example
+ * ## Use with existing Zone resource
+ *
+ * Configure email routing using an existing Zone resource reference.
+ *
+ * ```ts
+ * const zone = await Zone("my-zone", {
+ *   name: "example.com"
+ * });
+ *
+ * const emailRouting = await EmailRouting("example.com-routing", {
+ *   zone: zone,
+ *   enabled: true,
+ *   skipWizard: true
+ * });
+ * ```
+ */
+export const EmailRouting = Resource("cloudflare::EmailRouting", async function (_id, props) {
+    const api = await createCloudflareApi(props);
+    const zoneId = typeof props.zone === "string" ? props.zone : props.zone.id;
+    if (this.phase === "delete") {
+        // Disable email routing DNS
+        const response = await api.delete(`/zones/${zoneId}/email/routing/dns`);
+        if (!response.ok && response.status !== 404) {
+            await handleApiError(response, "disabling", "email routing DNS");
+        }
+        return this.destroy();
+    }
+    if (this.phase === "update" && this.output) {
+        // Check if we need to update the enabled state
+        const currentEnabled = this.output.enabled;
+        const desiredEnabled = props.enabled ?? true;
+        if (currentEnabled !== desiredEnabled) {
+            if (desiredEnabled) {
+                // Enable email routing DNS
+                const enablePayload = {
+                    enabled: true,
+                    ...(props.skipWizard && { skip_wizard: props.skipWizard }),
+                };
+                const response = await api.post(`/zones/${zoneId}/email/routing/dns`, enablePayload);
+                if (!response.ok) {
+                    await handleApiError(response, "enabling", "email routing DNS");
+                }
+            }
+            else {
+                // Disable email routing DNS
+                const response = await api.delete(`/zones/${zoneId}/email/routing/dns`);
+                if (!response.ok) {
+                    await handleApiError(response, "disabling", "email routing DNS");
+                }
+            }
+        }
+        // Get current state
+        const getResponse = await api.get(`/zones/${zoneId}/email/routing/dns`);
+        if (!getResponse.ok) {
+            if (getResponse.status === 404) {
+                throw new Error("Email routing DNS is not configured for this zone");
+            }
+            await handleApiError(getResponse, "getting", "email routing DNS settings");
+        }
+        const result = (await getResponse.json());
+        return this({
+            zoneId,
+            enabled: result.result.enabled,
+            name: result.result.name,
+            created: result.result.created,
+            modified: result.result.modified,
+            tag: result.result.tag,
+        });
+    }
+    // Create/Enable email routing
+    const enabled = props.enabled ?? true;
+    if (enabled) {
+        const enablePayload = {
+            enabled: true,
+            ...(props.skipWizard && { skip_wizard: props.skipWizard }),
+        };
+        const response = await api.post(`/zones/${zoneId}/email/routing/dns`, enablePayload);
+        if (!response.ok) {
+            await handleApiError(response, "enabling", "email routing DNS");
+        }
+    }
+    // Get the current state
+    const getResponse = await api.get(`/zones/${zoneId}/email/routing/dns`);
+    if (!getResponse.ok) {
+        if (getResponse.status === 404) {
+            throw new Error("Email routing DNS is not configured. Set enabled: true to configure it.");
+        }
+        await handleApiError(getResponse, "getting", "email routing DNS settings");
+    }
+    const result = (await getResponse.json());
+    return this({
+        zoneId,
+        enabled: result.result.enabled,
+        name: result.result.name,
+        created: result.result.created,
+        modified: result.result.modified,
+        tag: result.result.tag,
+    });
+});
+//# sourceMappingURL=email-routing.js.map

package/lib/cloudflare/email-routing.js.map

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

package/lib/cloudflare/email-rule.d.ts

@@ -0,0 +1,196 @@
+import type { Context } from "../context.ts";
+import { Resource } from "../resource.ts";
+import { type CloudflareApiOptions } from "./api.ts";
+import type { Zone } from "./zone.ts";
+/**
+ * Email routing matcher - defines what emails to match
+ */
+export interface EmailMatcher {
+    /**
+     * Type of matcher
+     * - "literal": Exact string match
+     * - "all": Matches all emails
+     */
+    type: "literal" | "all";
+    /**
+     * Field to match against (required for literal matchers)
+     */
+    field?: "to" | "from" | "subject";
+    /**
+     * Value to match (required for literal matchers)
+     */
+    value?: string;
+}
+/**
+ * Email routing action - defines what to do with matched emails
+ */
+export interface EmailAction {
+    /**
+     * Type of action to take
+     * - "forward": Forward email to destination addresses
+     * - "worker": Process email with a Cloudflare Worker
+     * - "drop": Drop/reject the email
+     */
+    type: "forward" | "worker" | "drop";
+    /**
+     * Action configuration
+     * - For "forward": Array of destination email addresses
+     * - For "worker": Worker script name
+     * - For "drop": Not used
+     */
+    value?: string[];
+}
+/**
+ * Properties for creating an email routing rule
+ */
+export interface EmailRuleProps extends CloudflareApiOptions {
+    /**
+     * Zone ID or Zone resource where the rule will be created
+     */
+    zone: string | Zone;
+    /**
+     * Name for the email routing rule
+     */
+    name?: string;
+    /**
+     * Whether the rule is enabled
+     *
+     * @default true
+     */
+    enabled?: boolean;
+    /**
+     * Rule priority - lower numbers have higher priority
+     * Rules are evaluated in priority order
+     *
+     * @default 0
+     */
+    priority?: number;
+    /**
+     * Array of matchers that define which emails this rule applies to
+     */
+    matchers: EmailMatcher[];
+    /**
+     * Array of actions to take when emails match this rule
+     */
+    actions: EmailAction[];
+}
+/**
+ * An email routing rule for a Cloudflare zone
+ */
+export interface EmailRule extends Resource<"cloudflare::EmailRule"> {
+    /**
+     * Zone ID where the rule is created
+     */
+    zoneId: string;
+    /**
+     * Rule ID
+     */
+    ruleId: string;
+    /**
+     * Rule name
+     */
+    name: string;
+    /**
+     * Whether the rule is enabled
+     */
+    enabled: boolean;
+    /**
+     * Rule priority
+     */
+    priority: number;
+    /**
+     * Matchers for this rule
+     */
+    matchers: EmailMatcher[];
+    /**
+     * Actions for this rule
+     */
+    actions: EmailAction[];
+    /**
+     * Rule tag
+     */
+    tag: string;
+}
+/**
+ * Creates email routing rules that define how emails sent to your domain are processed.
+ * Rules are evaluated in priority order (lower number = higher priority).
+ *
+ * @example
+ * ## Forward emails to a specific address
+ *
+ * Forward all emails sent to info@example.com to a destination address.
+ *
+ * ```ts
+ * const infoRule = await EmailRule("info-forwarding", {
+ *   zone: "example.com",
+ *   name: "Forward info emails",
+ *   matchers: [
+ *     {
+ *       type: "literal",
+ *       field: "to",
+ *       value: "info@example.com"
+ *     }
+ *   ],
+ *   actions: [
+ *     {
+ *       type: "forward",
+ *       value: ["admin@company.com"]
+ *     }
+ *   ]
+ * });
+ * ```
+ *
+ * @example
+ * ## Process emails with a Worker
+ *
+ * Route emails to a Cloudflare Worker for custom processing.
+ *
+ * ```ts
+ * const workerRule = await EmailRule("worker-processing", {
+ *   zone: "example.com",
+ *   name: "Process with Worker",
+ *   priority: 1,
+ *   matchers: [
+ *     {
+ *       type: "literal",
+ *       field: "to",
+ *       value: "webhook@example.com"
+ *     }
+ *   ],
+ *   actions: [
+ *     {
+ *       type: "worker",
+ *       value: ["email-processor"]
+ *     }
+ *   ]
+ * });
+ * ```
+ *
+ * @example
+ * ## Multiple matchers and actions
+ *
+ * Create a rule with multiple conditions and actions.
+ *
+ * ```ts
+ * const complexRule = await EmailRule("support-routing", {
+ *   zone: "example.com",
+ *   name: "Support email routing",
+ *   priority: 2,
+ *   matchers: [
+ *     {
+ *       type: "literal",
+ *       field: "to",
+ *       value: "support@example.com"
+ *     }
+ *   ],
+ *   actions: [
+ *     {
+ *       type: "forward",
+ *       value: ["support@company.com", "backup@company.com"]
+ *     }
+ *   ]
+ * });
+ * ```
+ */
+export declare const EmailRule: (((this: any, id: string, props?: {}) => never) & (new (_: never) => never)) | ((this: Context<EmailRule>, _id: string, props: EmailRuleProps) => Promise<EmailRule>);
+//# sourceMappingURL=email-rule.d.ts.map

package/lib/cloudflare/email-rule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-rule.d.ts","sourceRoot":"","sources":["../../src/cloudflare/email-rule.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,OAAO,EAAE,KAAK,oBAAoB,EAAuB,MAAM,UAAU,CAAC;AAE1E,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEtC;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;OAIG;IACH,IAAI,EAAE,SAAS,GAAG,KAAK,CAAC;IAExB;;OAEG;IACH,KAAK,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,SAAS,CAAC;IAElC;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;;OAKG;IACH,IAAI,EAAE,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC;IAEpC;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAeD;;GAEG;AACH,MAAM,WAAW,cAAe,SAAQ,oBAAoB;IAC1D;;OAEG;IACH,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAEpB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,QAAQ,EAAE,YAAY,EAAE,CAAC;IAEzB;;OAEG;IACH,OAAO,EAAE,WAAW,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,SAAU,SAAQ,QAAQ,CAAC,uBAAuB,CAAC;IAClE;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,QAAQ,EAAE,YAAY,EAAE,CAAC;IAEzB;;OAEG;IACH,OAAO,EAAE,WAAW,EAAE,CAAC;IAEvB;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgFG;AACH,eAAO,MAAM,SAAS,yFAGZ,OAAO,CAAC,SAAS,CAAC,OACnB,MAAM,SACJ,cAAc,KACpB,OAAO,CAAC,SAAS,CAAC,CAsFtB,CAAC"}