@x12i/email-service 0.0.0-stage → 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,99 @@
1
+ import type { CloudflareConfig } from "./config.js";
2
+ import type { ProviderEvidence } from "./ports.js";
3
+ export { readCloudflareConfig, type CloudflareConfig } from "./config.js";
4
+ export { cloudflareApi } from "./api.js";
5
+ export { UnsupportedCloudflareOperation } from "./routing.js";
6
+ export { domainName, MAX_MESSAGE_BYTES, smtpAddress } from "./address.js";
7
+ export { createInboxRelayClient, type RelayDelivery } from "./inbox-client.js";
8
+ export type { DnsRecord, DomainVerification, MailClass, ObservedRule, ProviderEvidence, ProviderSendRequest, ProviderSendResult, RoutingStep, RuleAction, StepResult, } from "./ports.js";
9
+ export declare function createCloudflareProvider(cfg: CloudflareConfig, options?: {
10
+ fetch?: typeof fetch;
11
+ recordEvidence?: (events: ProviderEvidence[]) => Promise<void>;
12
+ }): {
13
+ id: string;
14
+ routing: {
15
+ checkConnection(input: {
16
+ secretRef: string;
17
+ providerAccountId: string;
18
+ }): Promise<{
19
+ ok: boolean;
20
+ scopes: string[];
21
+ zones: {
22
+ zoneId: string;
23
+ name: string;
24
+ }[];
25
+ }>;
26
+ observe(input: {
27
+ secretRef: string;
28
+ zoneId: string;
29
+ domain: string;
30
+ }): Promise<{
31
+ rules: import("./ports.js").ObservedRule[];
32
+ mx: string[];
33
+ ownership: "verified" | "unverified";
34
+ routingEnabled: boolean;
35
+ }>;
36
+ applyStep(input: {
37
+ secretRef: string;
38
+ zoneId: string;
39
+ domain: string;
40
+ } & {
41
+ step: import("./ports.js").RoutingStep;
42
+ }): Promise<import("./ports.js").StepResult>;
43
+ createDestination(input: {
44
+ secretRef: string;
45
+ address: string;
46
+ }): Promise<{
47
+ providerRef: string;
48
+ }>;
49
+ destinationStatus(input: {
50
+ secretRef: string;
51
+ providerRef: string;
52
+ }): Promise<"pending" | "verified" | "failed">;
53
+ removeDestination(_input: {
54
+ secretRef: string;
55
+ providerRef: string;
56
+ }): Promise<void>;
57
+ };
58
+ preflight: () => Promise<{
59
+ sending: {
60
+ domain: string;
61
+ state: "verified" | "pending" | "failed";
62
+ tokenActive: boolean;
63
+ requiredRecords: number;
64
+ matchingRecords: number;
65
+ } | null;
66
+ routing: {
67
+ domain: string;
68
+ state: string;
69
+ mx: string[];
70
+ incumbentMx: string[];
71
+ managedRules: number;
72
+ foreignRules: number;
73
+ } | null;
74
+ zone: string;
75
+ zoneVerified: boolean;
76
+ }>;
77
+ capabilities: () => {
78
+ id: string;
79
+ transactional: boolean;
80
+ marketing: boolean;
81
+ maxMessageBytes: number;
82
+ maxRecipients: number;
83
+ supportsIdempotency: boolean;
84
+ supportsStatusLookup: boolean;
85
+ classes: never[] | readonly ["system", "notification", "transactional", "conversational"];
86
+ };
87
+ send: (req: import("./ports.js").ProviderSendRequest) => Promise<import("./ports.js").ProviderSendResult>;
88
+ status(_input: {
89
+ correlationId: string;
90
+ secretRef: string | null;
91
+ }): Promise<{
92
+ found: boolean;
93
+ providerRef?: string;
94
+ }>;
95
+ verifySenderDomain(input: {
96
+ domain: string;
97
+ secretRef: string | null;
98
+ }): Promise<import("./ports.js").DomainVerification>;
99
+ };
package/dist/index.js ADDED
@@ -0,0 +1,97 @@
1
+ import { cloudflareApi } from "./api.js";
2
+ import { domainsApi, incumbentMx, routingMxReady } from "./domains.js";
3
+ import { routingPort, UnsupportedCloudflareOperation } from "./routing.js";
4
+ import { classes, MAX_RECIPIENTS, outbound } from "./send.js";
5
+ export { readCloudflareConfig } from "./config.js";
6
+ export { cloudflareApi } from "./api.js";
7
+ export { UnsupportedCloudflareOperation } from "./routing.js";
8
+ export { domainName, MAX_MESSAGE_BYTES, smtpAddress } from "./address.js";
9
+ export { createInboxRelayClient } from "./inbox-client.js";
10
+ export function createCloudflareProvider(cfg, options = {}) {
11
+ const request = options.fetch ?? fetch;
12
+ const control = cloudflareApi(cfg.controlToken, request);
13
+ const sending = cfg.sending ? cloudflareApi(cfg.sending.token, request, 20_000) : null;
14
+ const domains = domainsApi(cfg, control);
15
+ const routing = routingPort(cfg, control, domains);
16
+ const id = "cloudflare";
17
+ async function sendTokenActive() {
18
+ if (!sending)
19
+ return false;
20
+ const accountPath = `/accounts/${cfg.accountId}/tokens/verify`;
21
+ for (const path of [accountPath, "/user/tokens/verify"]) {
22
+ try {
23
+ const token = await sending.result(path);
24
+ return token?.status === "active";
25
+ }
26
+ catch { /* Account and user tokens have different verification endpoints. */ }
27
+ }
28
+ return false;
29
+ }
30
+ async function preflight() {
31
+ const zoneVerified = await domains.hasZone();
32
+ const base = { zone: cfg.zone, zoneVerified };
33
+ if (!zoneVerified)
34
+ return { ...base, sending: null, routing: null };
35
+ const [senderResult, receiverResult, tokenResult] = await Promise.allSettled([
36
+ cfg.sending ? senderReadiness(cfg.sending.domain) : null,
37
+ cfg.routing ? routing.observe({ secretRef: cfg.secretRef, zoneId: cfg.zoneId, domain: cfg.routing.domain }) : null,
38
+ cfg.sending ? sendTokenActive() : false,
39
+ ]);
40
+ const sender = senderResult.status === "fulfilled" ? senderResult.value : null;
41
+ const receiver = receiverResult.status === "fulfilled" ? receiverResult.value : null;
42
+ const tokenActive = tokenResult.status === "fulfilled" && tokenResult.value;
43
+ const routeEnabled = receiver?.routingEnabled === true;
44
+ return {
45
+ ...base,
46
+ sending: cfg.sending ? {
47
+ domain: cfg.sending.domain, state: tokenActive ? sender?.state ?? "failed" : "failed", tokenActive,
48
+ requiredRecords: sender?.required.length ?? 0, matchingRecords: sender?.observed.length ?? 0,
49
+ } : null,
50
+ routing: cfg.routing ? {
51
+ domain: cfg.routing.domain,
52
+ state: !receiver || receiver.ownership !== "verified" ? "failed" : routeEnabled && routingMxReady(receiver.mx) ? "verified" : "pending",
53
+ mx: receiver?.mx ?? [], incumbentMx: incumbentMx(receiver?.mx ?? []),
54
+ managedRules: receiver?.rules.filter((r) => r.managed).length ?? 0,
55
+ foreignRules: receiver?.rules.filter((r) => !r.managed).length ?? 0,
56
+ } : null,
57
+ };
58
+ }
59
+ async function senderReadiness(domain) {
60
+ const result = await domains.verifySenderDomain(domain);
61
+ if (result.state === "verified" && cfg.sending?.mode === "verified-destinations" &&
62
+ !(await domains.verifiedDestinations()).size)
63
+ return { ...result, state: "pending" };
64
+ return result;
65
+ }
66
+ return {
67
+ id,
68
+ routing,
69
+ preflight,
70
+ capabilities: () => ({
71
+ id, transactional: !!cfg.sending, marketing: false, maxMessageBytes: cfg.maxMessageBytes, maxRecipients: MAX_RECIPIENTS,
72
+ supportsIdempotency: false, supportsStatusLookup: false, classes: cfg.sending ? classes : [],
73
+ }),
74
+ send: outbound(cfg, sending, options.recordEvidence, async (recipients) => {
75
+ if (!cfg.sending || (await domains.verifySenderDomain(cfg.sending.domain)).state !== "verified") {
76
+ return "CF_SENDER_NOT_VERIFIED";
77
+ }
78
+ if (cfg.sending.mode === "verified-destinations") {
79
+ const verified = await domains.verifiedDestinations();
80
+ if (recipients.some((address) => !verified.has(address.toLowerCase())))
81
+ return "CF_RECIPIENT_NOT_VERIFIED";
82
+ }
83
+ return null;
84
+ }),
85
+ // The suite's legacy resend path calls status() even when lookup is not
86
+ // supported. Returning found:false would authorize a duplicate send.
87
+ async status(_input) {
88
+ throw new UnsupportedCloudflareOperation("Cloudflare cannot prove that the previous send was not accepted.");
89
+ },
90
+ async verifySenderDomain(input) {
91
+ if (input.secretRef !== cfg.secretRef)
92
+ return { state: "failed", required: [], observed: [] };
93
+ return senderReadiness(input.domain);
94
+ },
95
+ };
96
+ }
97
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,96 @@
1
+ export type MailClass = "system" | "notification" | "transactional" | "conversational" | "marketing";
2
+ export interface ProviderSendRequest {
3
+ correlationId: string;
4
+ idempotencyKey: string;
5
+ secretRef: string | null;
6
+ class: MailClass;
7
+ from: string;
8
+ fromName: string;
9
+ replyTo: string | null;
10
+ to: string[];
11
+ cc: string[];
12
+ bcc: string[];
13
+ subject: string;
14
+ text: string;
15
+ html: string | null;
16
+ headers: Record<string, string>;
17
+ attachments: Array<{
18
+ name: string;
19
+ mime: string;
20
+ bytes: Uint8Array;
21
+ }>;
22
+ calendar?: {
23
+ method: "REQUEST" | "REPLY" | "CANCEL" | "PUBLISH";
24
+ content: Uint8Array;
25
+ };
26
+ recipientRefs: Record<string, string>;
27
+ recipientNames?: Record<string, string>;
28
+ }
29
+ export type ProviderSendResult = {
30
+ outcome: "accepted";
31
+ providerRef: string;
32
+ evidence?: ProviderEvidence[];
33
+ } | {
34
+ outcome: "rejected";
35
+ permanent: boolean;
36
+ code: string;
37
+ retryAfterSeconds?: number;
38
+ } | {
39
+ outcome: "unknown";
40
+ reason?: string;
41
+ };
42
+ export interface ProviderEvidence {
43
+ eventId: string;
44
+ correlationId: string;
45
+ type: "delivered" | "bounced" | "rejected";
46
+ at: string;
47
+ bounceType?: "hard";
48
+ }
49
+ export interface DnsRecord {
50
+ type: "TXT" | "CNAME" | "MX";
51
+ name: string;
52
+ value: string;
53
+ purpose: "spf" | "dkim" | "dmarc" | "return-path" | "ownership" | "mx";
54
+ }
55
+ export interface DomainVerification {
56
+ state: "pending" | "verified" | "failed";
57
+ required: DnsRecord[];
58
+ observed: DnsRecord[];
59
+ }
60
+ export type RuleAction = {
61
+ type: "mailbox" | "app";
62
+ mailboxId: string;
63
+ } | {
64
+ type: "forward";
65
+ destinationId: string;
66
+ } | {
67
+ type: "drop";
68
+ };
69
+ export interface ObservedRule {
70
+ providerRef: string;
71
+ match: "exact" | "catchall";
72
+ address: string | null;
73
+ action: RuleAction;
74
+ enabled: boolean;
75
+ managed: boolean;
76
+ }
77
+ export interface RoutingStep {
78
+ id: string;
79
+ kind: "create_rule" | "update_rule" | "delete_rule" | "set_mx" | "enable_routing";
80
+ match?: "exact" | "catchall";
81
+ address?: string | null;
82
+ action?: RuleAction;
83
+ forwardTarget?: string;
84
+ enabled?: boolean;
85
+ providerRef?: string;
86
+ mx?: string[];
87
+ }
88
+ export type StepResult = {
89
+ result: "done";
90
+ providerRef?: string;
91
+ } | {
92
+ result: "ambiguous";
93
+ } | {
94
+ result: "failed";
95
+ error: string;
96
+ };
package/dist/ports.js ADDED
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=ports.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ports.js","sourceRoot":"","sources":["../src/ports.ts"],"names":[],"mappings":""}
@@ -0,0 +1,9 @@
1
+ export declare const RELAY_PATH = "/v1/deliveries";
2
+ export declare const RELAY_TOKEN_PATTERN: RegExp;
3
+ export declare const DELIVERY_ID_PATTERN: RegExp;
4
+ export declare const MAX_RELAY_PAGE_SIZE = 50;
5
+ export interface RelayPage {
6
+ ids: string[];
7
+ cursor?: string;
8
+ }
9
+ export declare function relayCursor(value: string): number | null;
package/dist/relay.js ADDED
@@ -0,0 +1,9 @@
1
+ export const RELAY_PATH = "/v1/deliveries";
2
+ export const RELAY_TOKEN_PATTERN = /^[A-Za-z0-9_-]{43}$/;
3
+ export const DELIVERY_ID_PATTERN = /^cf_[a-f0-9]{64}$/;
4
+ export const MAX_RELAY_PAGE_SIZE = 50;
5
+ export function relayCursor(value) {
6
+ const sequence = Number(value);
7
+ return /^[1-9][0-9]*$/.test(value) && Number.isSafeInteger(sequence) ? sequence : null;
8
+ }
9
+ //# sourceMappingURL=relay.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"relay.js","sourceRoot":"","sources":["../src/relay.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,UAAU,GAAG,gBAAgB,CAAC;AAC3C,MAAM,CAAC,MAAM,mBAAmB,GAAG,qBAAqB,CAAC;AACzD,MAAM,CAAC,MAAM,mBAAmB,GAAG,mBAAmB,CAAC;AACvD,MAAM,CAAC,MAAM,mBAAmB,GAAG,EAAE,CAAC;AAOtC,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC/B,OAAO,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC;AACzF,CAAC"}
@@ -0,0 +1,49 @@
1
+ import { type CloudflareApi } from "./api.js";
2
+ import { type CloudflareConfig } from "./config.js";
3
+ import { type DomainsApi } from "./domains.js";
4
+ import type { ObservedRule, RoutingStep, StepResult } from "./ports.js";
5
+ type Scope = {
6
+ secretRef: string;
7
+ zoneId: string;
8
+ domain: string;
9
+ };
10
+ export declare class UnsupportedCloudflareOperation extends Error {
11
+ constructor(message: string);
12
+ }
13
+ export declare function routingPort(cfg: CloudflareConfig, api: CloudflareApi, domains: DomainsApi): {
14
+ checkConnection(input: {
15
+ secretRef: string;
16
+ providerAccountId: string;
17
+ }): Promise<{
18
+ ok: boolean;
19
+ scopes: string[];
20
+ zones: {
21
+ zoneId: string;
22
+ name: string;
23
+ }[];
24
+ }>;
25
+ observe(input: Scope): Promise<{
26
+ rules: ObservedRule[];
27
+ mx: string[];
28
+ ownership: "verified" | "unverified";
29
+ routingEnabled: boolean;
30
+ }>;
31
+ applyStep(input: Scope & {
32
+ step: RoutingStep;
33
+ }): Promise<StepResult>;
34
+ createDestination(input: {
35
+ secretRef: string;
36
+ address: string;
37
+ }): Promise<{
38
+ providerRef: string;
39
+ }>;
40
+ destinationStatus(input: {
41
+ secretRef: string;
42
+ providerRef: string;
43
+ }): Promise<"pending" | "verified" | "failed">;
44
+ removeDestination(_input: {
45
+ secretRef: string;
46
+ providerRef: string;
47
+ }): Promise<void>;
48
+ };
49
+ export {};
@@ -0,0 +1,201 @@
1
+ import { createHash } from "node:crypto";
2
+ import { smtpAddress } from "./address.js";
3
+ import { CloudflareError } from "./api.js";
4
+ import { cfId } from "./config.js";
5
+ import { routingMxReady } from "./domains.js";
6
+ const failed = (error) => ({ result: "failed", error });
7
+ const safeMailboxId = /^[A-Za-z0-9_-]{1,128}$/;
8
+ const addressTag = (address) => createHash("sha256").update(address).digest("hex").slice(0, 24);
9
+ export class UnsupportedCloudflareOperation extends Error {
10
+ constructor(message) {
11
+ super(message);
12
+ this.name = "UnsupportedCloudflareOperation";
13
+ }
14
+ }
15
+ export function routingPort(cfg, api, domains) {
16
+ const rulesPath = `/zones/${cfg.zoneId}/email/routing/rules`;
17
+ const destinationsPath = `/accounts/${cfg.accountId}/email/routing/addresses`;
18
+ const catchAllPath = `${rulesPath}/catch_all`;
19
+ // Existing installations used this tag before namespaces became configurable.
20
+ const prefix = `${cfg.routing?.ruleNamespace ?? "email-service"}/${cfg.routing?.worker ?? ""}/`;
21
+ const inScope = (s) => s.secretRef === cfg.secretRef && s.zoneId === cfg.zoneId && s.domain === cfg.routing?.domain;
22
+ function fromCloudflare(row, address) {
23
+ const match = address === null ? "catchall" : "exact";
24
+ const providerRef = row.id ?? row.tag ?? (match === "catchall" ? "catch_all" : "");
25
+ if (!cfId(providerRef) && providerRef !== "catch_all")
26
+ throw new CloudflareError(200);
27
+ if (typeof row.enabled !== "boolean")
28
+ throw new CloudflareError(200);
29
+ const action = row.actions?.length === 1 ? row.actions[0] : undefined;
30
+ const name = row.name ?? "";
31
+ const mark = name.startsWith(prefix) && row.source !== "wrangler" ? name.slice(prefix.length) : "";
32
+ const [kind, mailboxId, extra] = mark.split("/");
33
+ const forward = action?.type === "forward" && action.value?.length === 1 ? smtpAddress(action.value[0])?.address.toLowerCase() : undefined;
34
+ const mapped = mark === "drop" && action?.type === "drop" ? { type: "drop" }
35
+ : kind === "forward" && mailboxId && safeMailboxId.test(mailboxId) && forward && mark === `forward/${mailboxId}/${addressTag(forward)}`
36
+ ? { type: "forward", destinationId: mailboxId }
37
+ : (kind === "mailbox" || kind === "app") && mailboxId && safeMailboxId.test(mailboxId) && extra === undefined &&
38
+ action?.type === "worker" && action.value?.length === 1 && action.value[0] === cfg.routing?.worker
39
+ ? { type: kind, mailboxId } : null;
40
+ const external = action?.type === "forward" ? { type: "forward", destinationId: "external" }
41
+ : action?.type === "worker" ? { type: "app", mailboxId: "external" } : { type: "drop" };
42
+ const defaultCatchAll = match === "catchall" && !row.enabled && action?.type === "drop" &&
43
+ (!name || /^catch[ -]?all$/i.test(name)) && row.source !== "wrangler";
44
+ return { defaultCatchAll, rule: { providerRef, match, address, action: mapped ?? external, enabled: row.enabled, managed: mapped !== null } };
45
+ }
46
+ async function readRules(domain) {
47
+ const exactRows = await api.list(rulesPath);
48
+ const out = [];
49
+ for (const row of exactRows) {
50
+ if (row.matchers?.length === 1 && row.matchers[0]?.type === "all")
51
+ continue; // read via the singleton endpoint
52
+ const matcher = row.matchers?.length === 1 ? row.matchers[0] : undefined;
53
+ const address = matcher?.type === "literal" && matcher.field === "to" && typeof matcher.value === "string"
54
+ ? smtpAddress(matcher.value) : null;
55
+ if (!address)
56
+ throw new CloudflareError(200); // do not write against an incomplete rules snapshot
57
+ if (address.domain === domain)
58
+ out.push(fromCloudflare(row, address.address.toLowerCase()));
59
+ }
60
+ if (domain === cfg.zone)
61
+ out.push(fromCloudflare(await api.result(catchAllPath), null));
62
+ return out;
63
+ }
64
+ async function isEnabled() {
65
+ try {
66
+ return await domains.routingEnabled();
67
+ }
68
+ catch (error) {
69
+ if (error instanceof CloudflareError && error.status === 404)
70
+ return false;
71
+ throw error;
72
+ }
73
+ }
74
+ return {
75
+ async checkConnection(input) {
76
+ let ok = false;
77
+ if (input.secretRef === cfg.secretRef && input.providerAccountId === cfg.accountId) {
78
+ try {
79
+ ok = await domains.hasZone();
80
+ }
81
+ catch { /* report degraded */ }
82
+ }
83
+ return { ok, scopes: ok ? ["zone:read"] : [], zones: ok ? [{ zoneId: cfg.zoneId, name: cfg.zone }] : [] };
84
+ },
85
+ async observe(input) {
86
+ if (!inScope(input) || !await domains.hasZone())
87
+ return { rules: [], mx: [], ownership: "unverified", routingEnabled: false };
88
+ const [mx, enabled] = await Promise.all([domains.readMx(input.domain), isEnabled()]);
89
+ const rules = enabled ? (await readRules(input.domain)).filter((r) => !r.defaultCatchAll).map((r) => r.rule) : [];
90
+ return { rules, mx, ownership: "verified", routingEnabled: enabled };
91
+ },
92
+ async applyStep(input) {
93
+ const { step, domain } = input;
94
+ if (!inScope(input))
95
+ return failed("CF_ROUTING_SCOPE_MISMATCH");
96
+ if (step.kind === "set_mx")
97
+ return failed("CF_MX_CHANGE_REQUIRES_OPERATOR");
98
+ let attempted = false;
99
+ try {
100
+ if (!await domains.hasZone())
101
+ return failed("CF_ZONE_UNVERIFIED");
102
+ const [mx, enabled] = await Promise.all([domains.readMx(domain), isEnabled()]);
103
+ if (!enabled || !routingMxReady(mx))
104
+ return failed("CF_ROUTING_NOT_READY");
105
+ if (step.kind === "enable_routing")
106
+ return { result: "done" };
107
+ const rules = await readRules(domain);
108
+ const target = rules.find(({ rule }) => rule.providerRef === step.providerRef);
109
+ if (step.kind === "delete_rule") {
110
+ if (!target)
111
+ return { result: "done" };
112
+ if (!target.rule.managed)
113
+ return failed("CF_FOREIGN_RULE");
114
+ attempted = true;
115
+ if (target.rule.match === "catchall") {
116
+ await api.result(catchAllPath, "PUT", {
117
+ name: "Catch-all", enabled: false, matchers: [{ type: "all" }], actions: [{ type: "drop" }],
118
+ });
119
+ }
120
+ else {
121
+ await api.result(`${rulesPath}/${target.rule.providerRef}`, "DELETE");
122
+ }
123
+ return { result: "done" };
124
+ }
125
+ if (!step.match || !step.action || typeof step.enabled !== "boolean")
126
+ return failed("CF_RULE_INVALID");
127
+ const catchAll = step.match === "catchall";
128
+ const address = catchAll ? null : smtpAddress(step.address ?? "")?.address.toLowerCase();
129
+ if (catchAll ? domain !== cfg.zone : !address || address.length > 90 || smtpAddress(address)?.domain !== domain) {
130
+ return failed("CF_RULE_MATCH_UNSUPPORTED");
131
+ }
132
+ const prior = rules.filter(({ rule }) => rule.address === address);
133
+ const forward = step.action.type === "forward" ? smtpAddress(step.forwardTarget ?? "")?.address.toLowerCase() : undefined;
134
+ if (step.action.type === "forward" && (!forward || catchAll || forward === address || !(await domains.verifiedDestinations()).has(forward))) {
135
+ return failed("CF_FORWARD_TARGET_UNVERIFIED");
136
+ }
137
+ const writeName = step.action.type === "drop" ? "drop"
138
+ : step.action.type === "forward" ? safeMailboxId.test(step.action.destinationId) && forward ? `forward/${step.action.destinationId}/${addressTag(forward)}` : null
139
+ : safeMailboxId.test(step.action.mailboxId) ? `${step.action.type}/${step.action.mailboxId}` : null;
140
+ if (!writeName)
141
+ return failed("CF_RULE_INVALID");
142
+ const create = step.kind === "create_rule";
143
+ if (create) {
144
+ if (prior.some((r) => !r.defaultCatchAll))
145
+ return failed("CF_RULE_CONFLICT");
146
+ }
147
+ else if (!target?.rule.managed || target.rule.address !== address || prior.length !== 1) {
148
+ return failed("CF_RULE_DRIFTED");
149
+ }
150
+ const body = {
151
+ name: `${prefix}${writeName}`,
152
+ matchers: catchAll ? [{ type: "all" }] : [{ type: "literal", field: "to", value: address }],
153
+ actions: step.action.type === "drop" ? [{ type: "drop" }] : forward ? [{ type: "forward", value: [forward] }] : [{ type: "worker", value: [cfg.routing.worker] }],
154
+ enabled: step.enabled,
155
+ };
156
+ attempted = true;
157
+ const row = await api.result(catchAll ? catchAllPath : create ? rulesPath : `${rulesPath}/${target.rule.providerRef}`, catchAll || !create ? "PUT" : "POST", body);
158
+ const id = row?.id ?? row?.tag ?? (catchAll ? "catch_all" : undefined);
159
+ return cfId(id) || id === "catch_all" ? { result: "done", providerRef: id } : { result: "ambiguous" };
160
+ }
161
+ catch (error) {
162
+ if (!attempted)
163
+ return failed("CF_ROUTE_PREFLIGHT_FAILED");
164
+ if (error instanceof CloudflareError && error.explicitFailure && [400, 401, 403, 404, 409, 422, 429].includes(error.status)) {
165
+ return failed(`CF_ROUTE_${error.status}`);
166
+ }
167
+ return { result: "ambiguous" };
168
+ }
169
+ },
170
+ async createDestination(input) {
171
+ const email = smtpAddress(input.address)?.address.toLowerCase();
172
+ if (input.secretRef !== cfg.secretRef || !email || email.length > 90 || !await domains.hasZone()) {
173
+ throw new UnsupportedCloudflareOperation("Verify the Cloudflare connection and enter a valid destination of up to 90 characters.");
174
+ }
175
+ try {
176
+ const existing = (await api.list(destinationsPath)).find((row) => row.email?.toLowerCase() === email);
177
+ const row = existing ?? await api.result(destinationsPath, "POST", { email });
178
+ const providerRef = row.id ?? row.tag;
179
+ if (!cfId(providerRef) || row.email?.toLowerCase() !== email)
180
+ throw new CloudflareError(200);
181
+ return { providerRef };
182
+ }
183
+ catch (error) {
184
+ if (error instanceof CloudflareError && (error.status === 401 || error.status === 403)) {
185
+ throw new UnsupportedCloudflareOperation("Add the destination in Cloudflare Email Routing or grant Email Routing Addresses Write to the control token, then try again.");
186
+ }
187
+ throw error;
188
+ }
189
+ },
190
+ async destinationStatus(input) {
191
+ if (input.secretRef !== cfg.secretRef || !cfId(input.providerRef) || !await domains.hasZone())
192
+ return "failed";
193
+ const row = (await api.list(destinationsPath)).find((item) => (item.id ?? item.tag) === input.providerRef);
194
+ return row ? typeof row.verified === "string" && Number.isFinite(Date.parse(row.verified)) ? "verified" : "pending" : "failed";
195
+ },
196
+ async removeDestination(_input) {
197
+ // Verification belongs to the Cloudflare account and may be in use by other zones or sending.
198
+ },
199
+ };
200
+ }
201
+ //# sourceMappingURL=routing.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"routing.js","sourceRoot":"","sources":["../src/routing.ts"],"names":[],"mappings":"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"}
package/dist/send.d.ts ADDED
@@ -0,0 +1,8 @@
1
+ import { type CloudflareApi } from "./api.js";
2
+ import type { CloudflareConfig } from "./config.js";
3
+ import type { ProviderEvidence, ProviderSendRequest, ProviderSendResult } from "./ports.js";
4
+ export declare const classes: readonly ["system", "notification", "transactional", "conversational"];
5
+ export declare const MAX_RECIPIENTS = 50;
6
+ type RecordEvidence = (events: ProviderEvidence[]) => Promise<void>;
7
+ export declare function outbound(cfg: CloudflareConfig, api: CloudflareApi | null, recordEvidence: RecordEvidence | undefined, checkSend: (recipients: string[]) => Promise<string | null>): (req: ProviderSendRequest) => Promise<ProviderSendResult>;
8
+ export {};