@gadicc/loom 1.16.1 → 1.17.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.
Files changed (91) hide show
  1. package/README.md +14 -0
  2. package/esm/_dnt.polyfills.d.ts +6 -0
  3. package/esm/_dnt.polyfills.d.ts.map +1 -1
  4. package/esm/mod.d.ts +2 -0
  5. package/esm/mod.d.ts.map +1 -1
  6. package/esm/mod.js +2 -0
  7. package/esm/src/cli/mod.d.ts +1 -1
  8. package/esm/src/cli/mod.d.ts.map +1 -1
  9. package/esm/src/cli/mod.js +1034 -2
  10. package/esm/src/mail/errors.d.ts +33 -0
  11. package/esm/src/mail/errors.d.ts.map +1 -0
  12. package/esm/src/mail/errors.js +89 -0
  13. package/esm/src/mail/memory.d.ts +30 -0
  14. package/esm/src/mail/memory.d.ts.map +1 -0
  15. package/esm/src/mail/memory.js +340 -0
  16. package/esm/src/mail/mod.d.ts +7 -0
  17. package/esm/src/mail/mod.d.ts.map +1 -0
  18. package/esm/src/mail/mod.js +6 -0
  19. package/esm/src/mail/postal.d.ts +57 -0
  20. package/esm/src/mail/postal.d.ts.map +1 -0
  21. package/esm/src/mail/postal.js +238 -0
  22. package/esm/src/mail/retry.d.ts +9 -0
  23. package/esm/src/mail/retry.d.ts.map +1 -0
  24. package/esm/src/mail/retry.js +19 -0
  25. package/esm/src/mail/service.d.ts +23 -0
  26. package/esm/src/mail/service.d.ts.map +1 -0
  27. package/esm/src/mail/service.js +185 -0
  28. package/esm/src/mail/types.d.ts +176 -0
  29. package/esm/src/mail/types.d.ts.map +1 -0
  30. package/esm/src/mail/types.js +1 -0
  31. package/esm/src/mui/mail.d.ts +29 -0
  32. package/esm/src/mui/mail.d.ts.map +1 -0
  33. package/esm/src/mui/mail.js +114 -0
  34. package/esm/src/mui/mailView.d.ts +20 -0
  35. package/esm/src/mui/mailView.d.ts.map +1 -0
  36. package/esm/src/mui/mailView.js +26 -0
  37. package/esm/src/mui/mod.d.ts +1 -0
  38. package/esm/src/mui/mod.d.ts.map +1 -1
  39. package/esm/src/mui/mod.js +1 -0
  40. package/esm/src/next/mail/mod.d.ts +3 -0
  41. package/esm/src/next/mail/mod.d.ts.map +1 -0
  42. package/esm/src/next/mail/mod.js +2 -0
  43. package/esm/src/next/mail/route.d.ts +12 -0
  44. package/esm/src/next/mail/route.d.ts.map +1 -0
  45. package/esm/src/next/mail/route.js +43 -0
  46. package/package.json +55 -2
  47. package/script/_dnt.polyfills.d.ts +6 -0
  48. package/script/_dnt.polyfills.d.ts.map +1 -1
  49. package/script/mod.d.ts +2 -0
  50. package/script/mod.d.ts.map +1 -1
  51. package/script/mod.js +2 -0
  52. package/script/src/cli/mod.d.ts +1 -1
  53. package/script/src/cli/mod.d.ts.map +1 -1
  54. package/script/src/cli/mod.js +1034 -2
  55. package/script/src/mail/errors.d.ts +33 -0
  56. package/script/src/mail/errors.d.ts.map +1 -0
  57. package/script/src/mail/errors.js +97 -0
  58. package/script/src/mail/memory.d.ts +30 -0
  59. package/script/src/mail/memory.d.ts.map +1 -0
  60. package/script/src/mail/memory.js +345 -0
  61. package/script/src/mail/mod.d.ts +7 -0
  62. package/script/src/mail/mod.d.ts.map +1 -0
  63. package/script/src/mail/mod.js +22 -0
  64. package/script/src/mail/postal.d.ts +57 -0
  65. package/script/src/mail/postal.d.ts.map +1 -0
  66. package/script/src/mail/postal.js +245 -0
  67. package/script/src/mail/retry.d.ts +9 -0
  68. package/script/src/mail/retry.d.ts.map +1 -0
  69. package/script/src/mail/retry.js +22 -0
  70. package/script/src/mail/service.d.ts +23 -0
  71. package/script/src/mail/service.d.ts.map +1 -0
  72. package/script/src/mail/service.js +189 -0
  73. package/script/src/mail/types.d.ts +176 -0
  74. package/script/src/mail/types.d.ts.map +1 -0
  75. package/script/src/mail/types.js +2 -0
  76. package/script/src/mui/mail.d.ts +29 -0
  77. package/script/src/mui/mail.d.ts.map +1 -0
  78. package/script/src/mui/mail.js +159 -0
  79. package/script/src/mui/mailView.d.ts +20 -0
  80. package/script/src/mui/mailView.d.ts.map +1 -0
  81. package/script/src/mui/mailView.js +32 -0
  82. package/script/src/mui/mod.d.ts +1 -0
  83. package/script/src/mui/mod.d.ts.map +1 -1
  84. package/script/src/mui/mod.js +1 -0
  85. package/script/src/next/mail/mod.d.ts +3 -0
  86. package/script/src/next/mail/mod.d.ts.map +1 -0
  87. package/script/src/next/mail/mod.js +18 -0
  88. package/script/src/next/mail/route.d.ts +12 -0
  89. package/script/src/next/mail/route.d.ts.map +1 -0
  90. package/script/src/next/mail/route.js +46 -0
  91. package/skills/loom-mail/SKILL.md +68 -0
@@ -0,0 +1,33 @@
1
+ import type { LoomMailFailure } from "./types.js";
2
+ export declare class LoomMailError extends Error {
3
+ readonly code: string;
4
+ constructor(message: string, options: {
5
+ cause?: unknown;
6
+ code: string;
7
+ });
8
+ }
9
+ export declare class LoomMailValidationError extends LoomMailError {
10
+ constructor(message: string);
11
+ }
12
+ export declare class LoomMailTransportError extends LoomMailError {
13
+ readonly payload?: Record<string, unknown>;
14
+ readonly retryable: boolean;
15
+ constructor(message: string, options: {
16
+ cause?: unknown;
17
+ code: string;
18
+ payload?: Record<string, unknown>;
19
+ retryable: boolean;
20
+ });
21
+ toFailure(): LoomMailFailure;
22
+ }
23
+ export declare class LoomMailDeliveryError extends LoomMailError {
24
+ readonly failure: LoomMailFailure;
25
+ readonly messageId: string;
26
+ readonly retryAt: Date | null;
27
+ constructor(messageId: string, failure: LoomMailFailure, retryAt: Date | null);
28
+ }
29
+ export declare class LoomMailLeaseLostError extends LoomMailError {
30
+ readonly messageId: string;
31
+ constructor(messageId: string);
32
+ }
33
+ //# sourceMappingURL=errors.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/src/mail/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,qBAAa,aAAc,SAAQ,KAAK;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE;CAKxE;AAED,qBAAa,uBAAwB,SAAQ,aAAa;gBAC5C,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,sBAAuB,SAAQ,aAAa;IACvD,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3C,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;gBAG1B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE;QACP,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAClC,SAAS,EAAE,OAAO,CAAC;KACpB;IAQH,SAAS,IAAI,eAAe;CAQ7B;AAED,qBAAa,qBAAsB,SAAQ,aAAa;IACtD,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,IAAI,GAAG,IAAI,CAAC;gBAG5B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,IAAI,GAAG,IAAI;CAQvB;AAED,qBAAa,sBAAuB,SAAQ,aAAa;IACvD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;gBAEf,SAAS,EAAE,MAAM;CAO9B"}
@@ -0,0 +1,89 @@
1
+ export class LoomMailError extends Error {
2
+ constructor(message, options) {
3
+ super(message, { cause: options.cause });
4
+ Object.defineProperty(this, "code", {
5
+ enumerable: true,
6
+ configurable: true,
7
+ writable: true,
8
+ value: void 0
9
+ });
10
+ this.name = "LoomMailError";
11
+ this.code = options.code;
12
+ }
13
+ }
14
+ export class LoomMailValidationError extends LoomMailError {
15
+ constructor(message) {
16
+ super(message, { code: "validation_error" });
17
+ this.name = "LoomMailValidationError";
18
+ }
19
+ }
20
+ export class LoomMailTransportError extends LoomMailError {
21
+ constructor(message, options) {
22
+ super(message, { cause: options.cause, code: options.code });
23
+ Object.defineProperty(this, "payload", {
24
+ enumerable: true,
25
+ configurable: true,
26
+ writable: true,
27
+ value: void 0
28
+ });
29
+ Object.defineProperty(this, "retryable", {
30
+ enumerable: true,
31
+ configurable: true,
32
+ writable: true,
33
+ value: void 0
34
+ });
35
+ this.name = "LoomMailTransportError";
36
+ this.payload = options.payload;
37
+ this.retryable = options.retryable;
38
+ }
39
+ toFailure() {
40
+ return {
41
+ code: this.code,
42
+ message: this.message,
43
+ payload: this.payload,
44
+ retryable: this.retryable,
45
+ };
46
+ }
47
+ }
48
+ export class LoomMailDeliveryError extends LoomMailError {
49
+ constructor(messageId, failure, retryAt) {
50
+ super(failure.message, { code: failure.code });
51
+ Object.defineProperty(this, "failure", {
52
+ enumerable: true,
53
+ configurable: true,
54
+ writable: true,
55
+ value: void 0
56
+ });
57
+ Object.defineProperty(this, "messageId", {
58
+ enumerable: true,
59
+ configurable: true,
60
+ writable: true,
61
+ value: void 0
62
+ });
63
+ Object.defineProperty(this, "retryAt", {
64
+ enumerable: true,
65
+ configurable: true,
66
+ writable: true,
67
+ value: void 0
68
+ });
69
+ this.name = "LoomMailDeliveryError";
70
+ this.failure = failure;
71
+ this.messageId = messageId;
72
+ this.retryAt = retryAt;
73
+ }
74
+ }
75
+ export class LoomMailLeaseLostError extends LoomMailError {
76
+ constructor(messageId) {
77
+ super(`Mail message ${messageId} no longer holds its delivery lease.`, {
78
+ code: "lease_lost",
79
+ });
80
+ Object.defineProperty(this, "messageId", {
81
+ enumerable: true,
82
+ configurable: true,
83
+ writable: true,
84
+ value: void 0
85
+ });
86
+ this.name = "LoomMailLeaseLostError";
87
+ this.messageId = messageId;
88
+ }
89
+ }
@@ -0,0 +1,30 @@
1
+ import { LoomMailTransportError } from "./errors.js";
2
+ import type { LoomMailDeliveryRecord, LoomMailMessageRecord, LoomMailRepository, LoomMailTransport, LoomMailTransportResult } from "./types.js";
3
+ export interface MemoryMailEventRecord {
4
+ eventType: string;
5
+ id: string;
6
+ messageId: string;
7
+ occurredAt: Date;
8
+ payload: Record<string, unknown>;
9
+ providerEventId: string | null;
10
+ }
11
+ export interface MemoryMailRepository extends LoomMailRepository {
12
+ readonly deliveries: ReadonlyMap<string, LoomMailDeliveryRecord>;
13
+ readonly events: readonly MemoryMailEventRecord[];
14
+ readonly messages: ReadonlyMap<string, LoomMailMessageRecord>;
15
+ }
16
+ export interface CreateMemoryMailRepositoryOptions {
17
+ createId?: () => string;
18
+ }
19
+ /** Deterministic reference adapter used by core and consumer tests. */
20
+ export declare function createMemoryMailRepository(options?: CreateMemoryMailRepositoryOptions): MemoryMailRepository;
21
+ export interface MemoryMailTransport extends LoomMailTransport {
22
+ readonly sent: readonly LoomMailMessageRecord[];
23
+ failNext(error: LoomMailTransportError): void;
24
+ }
25
+ export declare function createMemoryMailTransport(options?: {
26
+ provider?: string;
27
+ result?: (message: LoomMailMessageRecord) => LoomMailTransportResult;
28
+ }): MemoryMailTransport;
29
+ export declare function getMemoryMailDeliveries(repository: MemoryMailRepository, messageId: string): any[];
30
+ //# sourceMappingURL=memory.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../../src/src/mail/memory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,KAAK,EAKV,sBAAsB,EAGtB,qBAAqB,EAErB,kBAAkB,EAClB,iBAAiB,EACjB,uBAAuB,EACxB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,IAAI,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED,MAAM,WAAW,oBAAqB,SAAQ,kBAAkB;IAC9D,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;IACjE,QAAQ,CAAC,MAAM,EAAE,SAAS,qBAAqB,EAAE,CAAC;IAClD,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;CAC/D;AAED,MAAM,WAAW,iCAAiC;IAChD,QAAQ,CAAC,EAAE,MAAM,MAAM,CAAC;CACzB;AA4DD,uEAAuE;AACvE,wBAAgB,0BAA0B,CACxC,OAAO,GAAE,iCAAsC,GAC9C,oBAAoB,CA0StB;AAED,MAAM,WAAW,mBAAoB,SAAQ,iBAAiB;IAC5D,QAAQ,CAAC,IAAI,EAAE,SAAS,qBAAqB,EAAE,CAAC;IAChD,QAAQ,CAAC,KAAK,EAAE,sBAAsB,GAAG,IAAI,CAAC;CAC/C;AAED,wBAAgB,yBAAyB,CAAC,OAAO,GAAE;IACjD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,qBAAqB,KAAK,uBAAuB,CAAC;CACjE,GAAG,mBAAmB,CA8B3B;AAED,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,oBAAoB,EAChC,SAAS,EAAE,MAAM,SAKlB"}
@@ -0,0 +1,340 @@
1
+ let fallbackId = 0;
2
+ function defaultCreateId() {
3
+ return crypto.randomUUID?.() ?? `mail_${++fallbackId}`;
4
+ }
5
+ function cloneMessage(record) {
6
+ return structuredClone(record);
7
+ }
8
+ function cloneDelivery(record) {
9
+ return structuredClone(record);
10
+ }
11
+ function recipientEntries(input) {
12
+ return [
13
+ ...input.to.map((email) => ({ email, kind: "to" })),
14
+ ...input.cc.map((email) => ({ email, kind: "cc" })),
15
+ ...input.bcc.map((email) => ({ email, kind: "bcc" })),
16
+ ];
17
+ }
18
+ function providerStatus(eventType) {
19
+ switch (eventType) {
20
+ case "bounced":
21
+ case "delayed":
22
+ case "delivered":
23
+ case "failed":
24
+ case "held":
25
+ return eventType;
26
+ case "unknown":
27
+ return null;
28
+ }
29
+ }
30
+ function aggregateMessageStatus(deliveries) {
31
+ if (deliveries.length === 0)
32
+ return "sent";
33
+ if (deliveries.every((delivery) => delivery.status === "delivered")) {
34
+ return "delivered";
35
+ }
36
+ const terminal = new Set([
37
+ "bounced",
38
+ "cancelled",
39
+ "delivered",
40
+ "failed",
41
+ ]);
42
+ if (deliveries.every((delivery) => terminal.has(delivery.status))) {
43
+ if (deliveries.some((delivery) => delivery.status === "delivered")) {
44
+ return "partially_delivered";
45
+ }
46
+ return "failed";
47
+ }
48
+ return "sent";
49
+ }
50
+ /** Deterministic reference adapter used by core and consumer tests. */
51
+ export function createMemoryMailRepository(options = {}) {
52
+ const messages = new Map();
53
+ const deliveries = new Map();
54
+ const events = [];
55
+ const providerEventIds = new Set();
56
+ const createId = options.createId ?? defaultCreateId;
57
+ function appendEvent(messageId, eventType, occurredAt, payload, providerEventId = null) {
58
+ events.push({
59
+ eventType,
60
+ id: createId(),
61
+ messageId,
62
+ occurredAt,
63
+ payload: structuredClone(payload),
64
+ providerEventId,
65
+ });
66
+ }
67
+ function deliveriesForMessage(messageId) {
68
+ return [...deliveries.values()].filter((item) => item.messageId === messageId);
69
+ }
70
+ return {
71
+ deliveries,
72
+ events,
73
+ messages,
74
+ cancel(messageId, occurredAt) {
75
+ const current = messages.get(messageId);
76
+ if (!current ||
77
+ !["failed", "queued"].includes(current.status)) {
78
+ return Promise.resolve(false);
79
+ }
80
+ messages.set(messageId, {
81
+ ...current,
82
+ cancelledAt: occurredAt,
83
+ leaseExpiresAt: null,
84
+ leaseToken: null,
85
+ status: "cancelled",
86
+ updatedAt: occurredAt,
87
+ });
88
+ for (const delivery of deliveriesForMessage(messageId)) {
89
+ if (delivery.status === "queued") {
90
+ deliveries.set(delivery.id, {
91
+ ...delivery,
92
+ status: "cancelled",
93
+ updatedAt: occurredAt,
94
+ });
95
+ }
96
+ }
97
+ appendEvent(messageId, "cancelled", occurredAt, {});
98
+ return Promise.resolve(true);
99
+ },
100
+ claim(request) {
101
+ const candidates = [...messages.values()]
102
+ .filter((message) => {
103
+ if (request.messageId && message.id !== request.messageId) {
104
+ return false;
105
+ }
106
+ if (message.availableAt > request.now)
107
+ return false;
108
+ return message.status === "queued" ||
109
+ (message.status === "sending" &&
110
+ !!message.leaseExpiresAt &&
111
+ message.leaseExpiresAt <= request.now);
112
+ })
113
+ .sort((left, right) => left.availableAt.valueOf() - right.availableAt.valueOf() ||
114
+ left.createdAt.valueOf() - right.createdAt.valueOf());
115
+ const current = candidates[0];
116
+ if (!current)
117
+ return Promise.resolve(null);
118
+ const claimed = {
119
+ ...current,
120
+ attemptCount: current.attemptCount + 1,
121
+ leaseExpiresAt: request.leaseExpiresAt,
122
+ leaseToken: request.leaseToken,
123
+ status: "sending",
124
+ updatedAt: request.now,
125
+ };
126
+ messages.set(claimed.id, claimed);
127
+ appendEvent(claimed.id, "attempted", request.now, {
128
+ attemptCount: claimed.attemptCount,
129
+ leaseExpiresAt: request.leaseExpiresAt.toISOString(),
130
+ });
131
+ return Promise.resolve(cloneMessage(claimed));
132
+ },
133
+ completeFailure(input) {
134
+ const current = messages.get(input.messageId);
135
+ if (!current || current.status !== "sending" ||
136
+ current.leaseToken !== input.leaseToken) {
137
+ return Promise.resolve(false);
138
+ }
139
+ messages.set(current.id, {
140
+ ...current,
141
+ availableAt: input.retryAt ?? current.availableAt,
142
+ failedAt: input.retryAt ? null : input.occurredAt,
143
+ lastErrorCode: input.failure.code,
144
+ lastErrorMessage: input.failure.message,
145
+ leaseExpiresAt: null,
146
+ leaseToken: null,
147
+ status: input.retryAt ? "queued" : "failed",
148
+ updatedAt: input.occurredAt,
149
+ });
150
+ appendEvent(current.id, input.retryAt ? "retry_scheduled" : "failed", input.occurredAt, {
151
+ code: input.failure.code,
152
+ message: input.failure.message,
153
+ retryAt: input.retryAt?.toISOString() ?? null,
154
+ retryable: input.failure.retryable,
155
+ ...input.failure.payload,
156
+ });
157
+ return Promise.resolve(true);
158
+ },
159
+ completeSuccess(input) {
160
+ const current = messages.get(input.messageId);
161
+ if (!current || current.status !== "sending" ||
162
+ current.leaseToken !== input.leaseToken) {
163
+ return Promise.resolve(false);
164
+ }
165
+ messages.set(current.id, {
166
+ ...current,
167
+ lastErrorCode: null,
168
+ lastErrorMessage: null,
169
+ leaseExpiresAt: null,
170
+ leaseToken: null,
171
+ providerMessageId: input.result.providerMessageId,
172
+ sentAt: input.occurredAt,
173
+ status: "sent",
174
+ updatedAt: input.occurredAt,
175
+ });
176
+ for (const result of input.result.deliveries) {
177
+ const matching = deliveriesForMessage(current.id).find((delivery) => delivery.email.toLowerCase() === result.email.toLowerCase() &&
178
+ delivery.status === "queued");
179
+ if (!matching)
180
+ continue;
181
+ deliveries.set(matching.id, {
182
+ ...matching,
183
+ providerDeliveryId: result.providerDeliveryId,
184
+ providerToken: result.providerToken,
185
+ status: "accepted",
186
+ updatedAt: input.occurredAt,
187
+ });
188
+ }
189
+ appendEvent(current.id, "sent", input.occurredAt, {
190
+ providerMessageId: input.result.providerMessageId,
191
+ providerResponse: input.result.providerResponse ?? {},
192
+ });
193
+ return Promise.resolve(true);
194
+ },
195
+ enqueue(input, occurredAt) {
196
+ const id = createId();
197
+ const message = {
198
+ ...structuredClone(input),
199
+ attemptCount: 0,
200
+ availableAt: occurredAt,
201
+ cancelledAt: null,
202
+ createdAt: occurredAt,
203
+ deliveredAt: null,
204
+ failedAt: null,
205
+ id,
206
+ lastErrorCode: null,
207
+ lastErrorMessage: null,
208
+ leaseExpiresAt: null,
209
+ leaseToken: null,
210
+ providerMessageId: null,
211
+ sentAt: null,
212
+ status: "queued",
213
+ updatedAt: occurredAt,
214
+ };
215
+ messages.set(id, message);
216
+ for (const recipient of recipientEntries(input)) {
217
+ const deliveryId = createId();
218
+ deliveries.set(deliveryId, {
219
+ createdAt: occurredAt,
220
+ deliveredAt: null,
221
+ email: recipient.email,
222
+ id: deliveryId,
223
+ kind: recipient.kind,
224
+ lastErrorCode: null,
225
+ lastErrorMessage: null,
226
+ messageId: id,
227
+ providerDeliveryId: null,
228
+ providerToken: null,
229
+ status: "queued",
230
+ updatedAt: occurredAt,
231
+ });
232
+ }
233
+ appendEvent(id, "queued", occurredAt, {
234
+ bcc: input.bcc,
235
+ cc: input.cc,
236
+ provider: input.provider,
237
+ to: input.to,
238
+ });
239
+ return Promise.resolve(cloneMessage(message));
240
+ },
241
+ findById(messageId) {
242
+ const message = messages.get(messageId);
243
+ return Promise.resolve(message ? cloneMessage(message) : null);
244
+ },
245
+ recordProviderEvent(event) {
246
+ const dedupeKey = `${event.provider}:${event.providerEventId}`;
247
+ if (providerEventIds.has(dedupeKey)) {
248
+ const existingMessage = [...messages.values()].find((message) => message.provider === event.provider &&
249
+ message.providerMessageId === event.providerMessageId);
250
+ return Promise.resolve({
251
+ inserted: false,
252
+ messageId: existingMessage?.id ?? null,
253
+ });
254
+ }
255
+ const delivery = [...deliveries.values()].find((candidate) => ((event.providerDeliveryId &&
256
+ candidate.providerDeliveryId === event.providerDeliveryId) ||
257
+ (!!event.recipient &&
258
+ candidate.email.toLowerCase() === event.recipient.toLowerCase() &&
259
+ messages.get(candidate.messageId)?.provider === event.provider &&
260
+ messages.get(candidate.messageId)?.providerMessageId ===
261
+ event.providerMessageId)) &&
262
+ messages.get(candidate.messageId)?.provider === event.provider);
263
+ const message = delivery
264
+ ? messages.get(delivery.messageId)
265
+ : [...messages.values()].find((candidate) => candidate.provider === event.provider &&
266
+ candidate.providerMessageId === event.providerMessageId);
267
+ if (!message) {
268
+ return Promise.resolve({ inserted: false, messageId: null });
269
+ }
270
+ providerEventIds.add(dedupeKey);
271
+ const nextDeliveryStatus = providerStatus(event.eventType);
272
+ if (delivery && nextDeliveryStatus) {
273
+ deliveries.set(delivery.id, {
274
+ ...delivery,
275
+ deliveredAt: nextDeliveryStatus === "delivered"
276
+ ? event.occurredAt
277
+ : delivery.deliveredAt,
278
+ lastErrorCode: ["bounced", "failed", "held"].includes(nextDeliveryStatus)
279
+ ? event.sourceEvent
280
+ : delivery.lastErrorCode,
281
+ lastErrorMessage: ["bounced", "failed", "held"].includes(nextDeliveryStatus)
282
+ ? String(event.payload.message ?? event.sourceEvent)
283
+ : delivery.lastErrorMessage,
284
+ status: nextDeliveryStatus,
285
+ updatedAt: event.occurredAt,
286
+ });
287
+ }
288
+ const current = messages.get(message.id);
289
+ const aggregateStatus = aggregateMessageStatus(deliveriesForMessage(message.id));
290
+ messages.set(message.id, {
291
+ ...current,
292
+ deliveredAt: aggregateStatus === "delivered"
293
+ ? event.occurredAt
294
+ : current.deliveredAt,
295
+ failedAt: aggregateStatus === "failed"
296
+ ? event.occurredAt
297
+ : current.failedAt,
298
+ status: aggregateStatus,
299
+ updatedAt: event.occurredAt,
300
+ });
301
+ appendEvent(message.id, event.eventType, event.occurredAt, event.payload, event.providerEventId);
302
+ return Promise.resolve({ inserted: true, messageId: message.id });
303
+ },
304
+ };
305
+ }
306
+ export function createMemoryMailTransport(options = {}) {
307
+ const sent = [];
308
+ const failures = [];
309
+ const provider = options.provider ?? "memory";
310
+ return {
311
+ provider,
312
+ sent,
313
+ failNext(error) {
314
+ failures.push(error);
315
+ },
316
+ send(message) {
317
+ const failure = failures.shift();
318
+ if (failure)
319
+ return Promise.reject(failure);
320
+ sent.push(cloneMessage(message));
321
+ return Promise.resolve(options.result?.(message) ?? {
322
+ deliveries: [
323
+ ...message.to,
324
+ ...message.cc,
325
+ ...message.bcc,
326
+ ].map((email, index) => ({
327
+ email,
328
+ providerDeliveryId: `${message.id}:${index}`,
329
+ providerToken: null,
330
+ })),
331
+ providerMessageId: `provider:${message.id}`,
332
+ });
333
+ },
334
+ };
335
+ }
336
+ export function getMemoryMailDeliveries(repository, messageId) {
337
+ return [...repository.deliveries.values()]
338
+ .filter((delivery) => delivery.messageId === messageId)
339
+ .map(cloneDelivery);
340
+ }
@@ -0,0 +1,7 @@
1
+ import "../../_dnt.polyfills.js";
2
+ export * from "./errors.js";
3
+ export * from "./memory.js";
4
+ export * from "./retry.js";
5
+ export * from "./service.js";
6
+ export * from "./types.js";
7
+ //# sourceMappingURL=mod.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../../src/src/mail/mod.ts"],"names":[],"mappings":"AAAA,OAAO,yBAAyB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC"}
@@ -0,0 +1,6 @@
1
+ import "../../_dnt.polyfills.js";
2
+ export * from "./errors.js";
3
+ export * from "./memory.js";
4
+ export * from "./retry.js";
5
+ export * from "./service.js";
6
+ export * from "./types.js";
@@ -0,0 +1,57 @@
1
+ import "../../_dnt.polyfills.js";
2
+ import { LoomMailError } from "./errors.js";
3
+ import type { LoomMailProviderEvent, LoomMailTransport } from "./types.js";
4
+ export interface PostalMailTransportOptions {
5
+ apiKey: string;
6
+ fetch?: typeof globalThis.fetch;
7
+ host: string;
8
+ }
9
+ export interface PostalSendMessageResponse {
10
+ data?: {
11
+ message_id?: string;
12
+ messages?: Record<string, {
13
+ id?: number | string;
14
+ token?: string;
15
+ [key: string]: unknown;
16
+ }>;
17
+ [key: string]: unknown;
18
+ };
19
+ error?: {
20
+ code?: string;
21
+ message?: string;
22
+ [key: string]: unknown;
23
+ };
24
+ flags?: Record<string, unknown>;
25
+ message?: string;
26
+ status: "error" | "success";
27
+ time?: number;
28
+ }
29
+ export interface PostalWebhookEnvelope {
30
+ event: string;
31
+ payload: Record<string, unknown>;
32
+ timestamp: number | string;
33
+ uuid: string;
34
+ }
35
+ export interface PostalWebhookPublicKey extends JsonWebKey {
36
+ kid: string;
37
+ }
38
+ export declare class LoomPostalWebhookError extends LoomMailError {
39
+ readonly status: number;
40
+ constructor(message: string, options: {
41
+ code: string;
42
+ status?: number;
43
+ });
44
+ }
45
+ /** Postal outgoing transport without persistence or environment ownership. */
46
+ export declare function createPostalMailTransport(options: PostalMailTransportOptions): LoomMailTransport;
47
+ /** Verifies Postal's RSA-SHA256 signature over the exact request body. */
48
+ export declare function verifyPostalWebhookSignature(options: {
49
+ body: string | Uint8Array;
50
+ headers: Headers;
51
+ publicKeys: readonly PostalWebhookPublicKey[];
52
+ }): Promise<{
53
+ keyId: any;
54
+ }>;
55
+ /** Parses an already-verified Postal webhook into the provider-neutral event. */
56
+ export declare function parsePostalWebhook(body: string): LoomMailProviderEvent;
57
+ //# sourceMappingURL=postal.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"postal.d.ts","sourceRoot":"","sources":["../../../src/src/mail/postal.ts"],"names":[],"mappings":"AAAA,OAAO,yBAAyB,CAAC;AACjC,OAAO,EAAE,aAAa,EAA0B,MAAM,aAAa,CAAC;AACpE,OAAO,KAAK,EAEV,qBAAqB,EACrB,iBAAiB,EAElB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,0BAA0B;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IAChC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,yBAAyB;IACxC,IAAI,CAAC,EAAE;QACL,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,MAAM,CACf,MAAM,EACN;YAAE,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;YAAC,KAAK,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;SAAE,CACjE,CAAC;QACF,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;IACF,KAAK,CAAC,EAAE;QACN,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;IACF,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,sBAAuB,SAAQ,UAAU;IACxD,GAAG,EAAE,MAAM,CAAC;CACb;AAED,qBAAa,sBAAuB,SAAQ,aAAa;IACvD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAEZ,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE;CAKxE;AAuDD,8EAA8E;AAC9E,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,0BAA0B,GAClC,iBAAiB,CA+EnB;AAoBD,0EAA0E;AAC1E,wBAAsB,4BAA4B,CAAC,OAAO,EAAE;IAC1D,IAAI,EAAE,MAAM,GAAG,UAAU,CAAC;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,SAAS,sBAAsB,EAAE,CAAC;CAC/C;;GAsDA;AA2DD,iFAAiF;AACjF,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,qBAAqB,CA0BtE"}