@ever-works/mailgun-plugin 1.0.6 → 1.0.8
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.
- package/dist/index.cjs +75 -0
- package/dist/index.d.cts +2 -0
- package/dist/index.d.ts +2 -0
- package/dist/index.js +75 -0
- package/package.json +5 -5
package/dist/index.cjs
CHANGED
|
@@ -63,6 +63,7 @@ var PROBLEM_CODES = [
|
|
|
63
63
|
"already_connected",
|
|
64
64
|
"already_linked",
|
|
65
65
|
"already_claimed",
|
|
66
|
+
"claim_locked",
|
|
66
67
|
"invalid_client",
|
|
67
68
|
"public_jwk_invalid",
|
|
68
69
|
"identifier_claimed",
|
|
@@ -88,6 +89,11 @@ var PROBLEM_CODES = [
|
|
|
88
89
|
"database_absent",
|
|
89
90
|
"database_unreachable",
|
|
90
91
|
"topic_private",
|
|
92
|
+
"realtime_disabled",
|
|
93
|
+
"topic_forbidden",
|
|
94
|
+
"topic_invalid",
|
|
95
|
+
"realtime_busy",
|
|
96
|
+
"too_many_streams",
|
|
91
97
|
"keys_unavailable",
|
|
92
98
|
"internal_error"
|
|
93
99
|
];
|
|
@@ -674,6 +680,49 @@ var FLEET_AGENT_CREDENTIAL_FAMILIES = [
|
|
|
674
680
|
FLEET_AGENT_CREDENTIAL_FAMILIES.flatMap(
|
|
675
681
|
(family) => family.envNames
|
|
676
682
|
);
|
|
683
|
+
var FLEET_LINK_FRAME_KINDS = {
|
|
684
|
+
/** Raw bytes: terminal output/input, log lines, file chunks. */
|
|
685
|
+
DATA: 1,
|
|
686
|
+
/** `[cols u16][rows u16]`. */
|
|
687
|
+
RESIZE: 2,
|
|
688
|
+
/** `[code i32]`. */
|
|
689
|
+
EXIT: 3,
|
|
690
|
+
/** UTF-8 JSON control message. */
|
|
691
|
+
JSON: 10,
|
|
692
|
+
/** UTF-8 reason code. */
|
|
693
|
+
CLOSE: 11,
|
|
694
|
+
/** A full picture (the existing computer-frame encoding). */
|
|
695
|
+
FRAME: 20,
|
|
696
|
+
/** A pointer / key / text event (the existing computer input encoding). */
|
|
697
|
+
INPUT: 21,
|
|
698
|
+
/** Changed tiles `[w][h][count]{x,y,w,h,len,jpeg}`. */
|
|
699
|
+
TILES: 23,
|
|
700
|
+
/** `[bytes u32]` credit. */
|
|
701
|
+
ACK: 30,
|
|
702
|
+
/** End of a stream. */
|
|
703
|
+
END: 31,
|
|
704
|
+
/** UTF-8 text ≤ 256 KiB, pasted into a desktop. */
|
|
705
|
+
CLIP: 40
|
|
706
|
+
};
|
|
707
|
+
new Set(Object.values(FLEET_LINK_FRAME_KINDS));
|
|
708
|
+
var FLEET_LINK_CONTROL_TYPES = [
|
|
709
|
+
"link.hello",
|
|
710
|
+
"link.ready",
|
|
711
|
+
"link.ping",
|
|
712
|
+
"link.pong",
|
|
713
|
+
"link.pause",
|
|
714
|
+
"link.resume",
|
|
715
|
+
"link.drain",
|
|
716
|
+
"channel.open",
|
|
717
|
+
"channel.ready",
|
|
718
|
+
"channel.refused",
|
|
719
|
+
"channel.close",
|
|
720
|
+
"operation.progress",
|
|
721
|
+
"operation.done",
|
|
722
|
+
"operation.cancel"
|
|
723
|
+
];
|
|
724
|
+
new Set(FLEET_LINK_CONTROL_TYPES);
|
|
725
|
+
new TextEncoder();
|
|
677
726
|
var EMAIL_INBOX_CAP_FIELDS = [
|
|
678
727
|
"inboxDailySends",
|
|
679
728
|
"inboxBurstSends",
|
|
@@ -998,6 +1047,9 @@ function resolveSigningKey(options) {
|
|
|
998
1047
|
return fromEnv && fromEnv.length > 0 ? fromEnv : void 0;
|
|
999
1048
|
}
|
|
1000
1049
|
var EMAIL_INBOUND_ALLOW_UNSIGNED_ENV = "EMAIL_INBOUND_ALLOW_UNSIGNED";
|
|
1050
|
+
var MAILGUN_SIGNATURE_MAX_AGE_SECONDS = 15 * 60;
|
|
1051
|
+
var MAILGUN_SIGNATURE_MAX_SKEW_SECONDS = 5 * 60;
|
|
1052
|
+
var MAILGUN_USED_TOKENS_MAX = 1e4;
|
|
1001
1053
|
function unsignedInboundAllowed() {
|
|
1002
1054
|
return process.env[EMAIL_INBOUND_ALLOW_UNSIGNED_ENV] === "true";
|
|
1003
1055
|
}
|
|
@@ -1088,6 +1140,8 @@ var MailgunPlugin = class {
|
|
|
1088
1140
|
required: ["apiKey", "domain"]
|
|
1089
1141
|
};
|
|
1090
1142
|
this.idempotencyCache = /* @__PURE__ */ new Map();
|
|
1143
|
+
/** F56: inbound signature tokens already accepted → when they may be forgotten (ms). */
|
|
1144
|
+
this.usedInboundTokens = /* @__PURE__ */ new Map();
|
|
1091
1145
|
}
|
|
1092
1146
|
async onLoad() {
|
|
1093
1147
|
}
|
|
@@ -1169,6 +1223,27 @@ var MailgunPlugin = class {
|
|
|
1169
1223
|
if (a.length !== b.length || !crypto.timingSafeEqual(a, b)) {
|
|
1170
1224
|
throw new Error("Mailgun inbound: signature mismatch.");
|
|
1171
1225
|
}
|
|
1226
|
+
const nowMs = Date.now();
|
|
1227
|
+
const signedAt = Number(sig.timestamp);
|
|
1228
|
+
if (!Number.isFinite(signedAt) || signedAt < nowMs / 1e3 - MAILGUN_SIGNATURE_MAX_AGE_SECONDS || signedAt > nowMs / 1e3 + MAILGUN_SIGNATURE_MAX_SKEW_SECONDS) {
|
|
1229
|
+
throw new Error("Mailgun inbound: signature timestamp is outside the accepted window.");
|
|
1230
|
+
}
|
|
1231
|
+
for (const [token, forgetAt] of this.usedInboundTokens) {
|
|
1232
|
+
if (forgetAt > nowMs) break;
|
|
1233
|
+
this.usedInboundTokens.delete(token);
|
|
1234
|
+
}
|
|
1235
|
+
if (this.usedInboundTokens.has(sig.token)) {
|
|
1236
|
+
throw new Error("Mailgun inbound: signature token already used.");
|
|
1237
|
+
}
|
|
1238
|
+
this.usedInboundTokens.set(
|
|
1239
|
+
sig.token,
|
|
1240
|
+
nowMs + (MAILGUN_SIGNATURE_MAX_AGE_SECONDS + MAILGUN_SIGNATURE_MAX_SKEW_SECONDS) * 1e3
|
|
1241
|
+
);
|
|
1242
|
+
while (this.usedInboundTokens.size > MAILGUN_USED_TOKENS_MAX) {
|
|
1243
|
+
const oldest = this.usedInboundTokens.keys().next().value;
|
|
1244
|
+
if (oldest === void 0) break;
|
|
1245
|
+
this.usedInboundTokens.delete(oldest);
|
|
1246
|
+
}
|
|
1172
1247
|
}
|
|
1173
1248
|
extractInboundRecipients(rawBody, _headers) {
|
|
1174
1249
|
try {
|
package/dist/index.d.cts
CHANGED
|
@@ -19,6 +19,8 @@ declare class MailgunPlugin implements IEmailOutboundPlugin, IEmailInboundPlugin
|
|
|
19
19
|
onLoad(): Promise<void>;
|
|
20
20
|
onUnload(): Promise<void>;
|
|
21
21
|
private readonly idempotencyCache;
|
|
22
|
+
/** F56: inbound signature tokens already accepted → when they may be forgotten (ms). */
|
|
23
|
+
private readonly usedInboundTokens;
|
|
22
24
|
sendEmail(input: EmailSendInput, options: EmailOptions): Promise<EmailSendResult>;
|
|
23
25
|
verifyAddress(address: string, _options: EmailOptions): Promise<EmailVerification>;
|
|
24
26
|
verifyWebhookSignature(rawBody: Buffer, _headers: Readonly<Record<string, string>>, options: EmailOptions): void;
|
package/dist/index.d.ts
CHANGED
|
@@ -19,6 +19,8 @@ declare class MailgunPlugin implements IEmailOutboundPlugin, IEmailInboundPlugin
|
|
|
19
19
|
onLoad(): Promise<void>;
|
|
20
20
|
onUnload(): Promise<void>;
|
|
21
21
|
private readonly idempotencyCache;
|
|
22
|
+
/** F56: inbound signature tokens already accepted → when they may be forgotten (ms). */
|
|
23
|
+
private readonly usedInboundTokens;
|
|
22
24
|
sendEmail(input: EmailSendInput, options: EmailOptions): Promise<EmailSendResult>;
|
|
23
25
|
verifyAddress(address: string, _options: EmailOptions): Promise<EmailVerification>;
|
|
24
26
|
verifyWebhookSignature(rawBody: Buffer, _headers: Readonly<Record<string, string>>, options: EmailOptions): void;
|
package/dist/index.js
CHANGED
|
@@ -56,6 +56,7 @@ var PROBLEM_CODES = [
|
|
|
56
56
|
"already_connected",
|
|
57
57
|
"already_linked",
|
|
58
58
|
"already_claimed",
|
|
59
|
+
"claim_locked",
|
|
59
60
|
"invalid_client",
|
|
60
61
|
"public_jwk_invalid",
|
|
61
62
|
"identifier_claimed",
|
|
@@ -81,6 +82,11 @@ var PROBLEM_CODES = [
|
|
|
81
82
|
"database_absent",
|
|
82
83
|
"database_unreachable",
|
|
83
84
|
"topic_private",
|
|
85
|
+
"realtime_disabled",
|
|
86
|
+
"topic_forbidden",
|
|
87
|
+
"topic_invalid",
|
|
88
|
+
"realtime_busy",
|
|
89
|
+
"too_many_streams",
|
|
84
90
|
"keys_unavailable",
|
|
85
91
|
"internal_error"
|
|
86
92
|
];
|
|
@@ -667,6 +673,49 @@ var FLEET_AGENT_CREDENTIAL_FAMILIES = [
|
|
|
667
673
|
FLEET_AGENT_CREDENTIAL_FAMILIES.flatMap(
|
|
668
674
|
(family) => family.envNames
|
|
669
675
|
);
|
|
676
|
+
var FLEET_LINK_FRAME_KINDS = {
|
|
677
|
+
/** Raw bytes: terminal output/input, log lines, file chunks. */
|
|
678
|
+
DATA: 1,
|
|
679
|
+
/** `[cols u16][rows u16]`. */
|
|
680
|
+
RESIZE: 2,
|
|
681
|
+
/** `[code i32]`. */
|
|
682
|
+
EXIT: 3,
|
|
683
|
+
/** UTF-8 JSON control message. */
|
|
684
|
+
JSON: 10,
|
|
685
|
+
/** UTF-8 reason code. */
|
|
686
|
+
CLOSE: 11,
|
|
687
|
+
/** A full picture (the existing computer-frame encoding). */
|
|
688
|
+
FRAME: 20,
|
|
689
|
+
/** A pointer / key / text event (the existing computer input encoding). */
|
|
690
|
+
INPUT: 21,
|
|
691
|
+
/** Changed tiles `[w][h][count]{x,y,w,h,len,jpeg}`. */
|
|
692
|
+
TILES: 23,
|
|
693
|
+
/** `[bytes u32]` credit. */
|
|
694
|
+
ACK: 30,
|
|
695
|
+
/** End of a stream. */
|
|
696
|
+
END: 31,
|
|
697
|
+
/** UTF-8 text ≤ 256 KiB, pasted into a desktop. */
|
|
698
|
+
CLIP: 40
|
|
699
|
+
};
|
|
700
|
+
new Set(Object.values(FLEET_LINK_FRAME_KINDS));
|
|
701
|
+
var FLEET_LINK_CONTROL_TYPES = [
|
|
702
|
+
"link.hello",
|
|
703
|
+
"link.ready",
|
|
704
|
+
"link.ping",
|
|
705
|
+
"link.pong",
|
|
706
|
+
"link.pause",
|
|
707
|
+
"link.resume",
|
|
708
|
+
"link.drain",
|
|
709
|
+
"channel.open",
|
|
710
|
+
"channel.ready",
|
|
711
|
+
"channel.refused",
|
|
712
|
+
"channel.close",
|
|
713
|
+
"operation.progress",
|
|
714
|
+
"operation.done",
|
|
715
|
+
"operation.cancel"
|
|
716
|
+
];
|
|
717
|
+
new Set(FLEET_LINK_CONTROL_TYPES);
|
|
718
|
+
new TextEncoder();
|
|
670
719
|
var EMAIL_INBOX_CAP_FIELDS = [
|
|
671
720
|
"inboxDailySends",
|
|
672
721
|
"inboxBurstSends",
|
|
@@ -991,6 +1040,9 @@ function resolveSigningKey(options) {
|
|
|
991
1040
|
return fromEnv && fromEnv.length > 0 ? fromEnv : void 0;
|
|
992
1041
|
}
|
|
993
1042
|
var EMAIL_INBOUND_ALLOW_UNSIGNED_ENV = "EMAIL_INBOUND_ALLOW_UNSIGNED";
|
|
1043
|
+
var MAILGUN_SIGNATURE_MAX_AGE_SECONDS = 15 * 60;
|
|
1044
|
+
var MAILGUN_SIGNATURE_MAX_SKEW_SECONDS = 5 * 60;
|
|
1045
|
+
var MAILGUN_USED_TOKENS_MAX = 1e4;
|
|
994
1046
|
function unsignedInboundAllowed() {
|
|
995
1047
|
return process.env[EMAIL_INBOUND_ALLOW_UNSIGNED_ENV] === "true";
|
|
996
1048
|
}
|
|
@@ -1081,6 +1133,8 @@ var MailgunPlugin = class {
|
|
|
1081
1133
|
required: ["apiKey", "domain"]
|
|
1082
1134
|
};
|
|
1083
1135
|
this.idempotencyCache = /* @__PURE__ */ new Map();
|
|
1136
|
+
/** F56: inbound signature tokens already accepted → when they may be forgotten (ms). */
|
|
1137
|
+
this.usedInboundTokens = /* @__PURE__ */ new Map();
|
|
1084
1138
|
}
|
|
1085
1139
|
async onLoad() {
|
|
1086
1140
|
}
|
|
@@ -1162,6 +1216,27 @@ var MailgunPlugin = class {
|
|
|
1162
1216
|
if (a.length !== b.length || !timingSafeEqual(a, b)) {
|
|
1163
1217
|
throw new Error("Mailgun inbound: signature mismatch.");
|
|
1164
1218
|
}
|
|
1219
|
+
const nowMs = Date.now();
|
|
1220
|
+
const signedAt = Number(sig.timestamp);
|
|
1221
|
+
if (!Number.isFinite(signedAt) || signedAt < nowMs / 1e3 - MAILGUN_SIGNATURE_MAX_AGE_SECONDS || signedAt > nowMs / 1e3 + MAILGUN_SIGNATURE_MAX_SKEW_SECONDS) {
|
|
1222
|
+
throw new Error("Mailgun inbound: signature timestamp is outside the accepted window.");
|
|
1223
|
+
}
|
|
1224
|
+
for (const [token, forgetAt] of this.usedInboundTokens) {
|
|
1225
|
+
if (forgetAt > nowMs) break;
|
|
1226
|
+
this.usedInboundTokens.delete(token);
|
|
1227
|
+
}
|
|
1228
|
+
if (this.usedInboundTokens.has(sig.token)) {
|
|
1229
|
+
throw new Error("Mailgun inbound: signature token already used.");
|
|
1230
|
+
}
|
|
1231
|
+
this.usedInboundTokens.set(
|
|
1232
|
+
sig.token,
|
|
1233
|
+
nowMs + (MAILGUN_SIGNATURE_MAX_AGE_SECONDS + MAILGUN_SIGNATURE_MAX_SKEW_SECONDS) * 1e3
|
|
1234
|
+
);
|
|
1235
|
+
while (this.usedInboundTokens.size > MAILGUN_USED_TOKENS_MAX) {
|
|
1236
|
+
const oldest = this.usedInboundTokens.keys().next().value;
|
|
1237
|
+
if (oldest === void 0) break;
|
|
1238
|
+
this.usedInboundTokens.delete(oldest);
|
|
1239
|
+
}
|
|
1165
1240
|
}
|
|
1166
1241
|
extractInboundRecipients(rawBody, _headers) {
|
|
1167
1242
|
try {
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@ever-works/mailgun-plugin",
|
|
3
|
-
"version": "1.0.
|
|
3
|
+
"version": "1.0.8",
|
|
4
4
|
"description": "Mailgun email provider plugin (outbound + inbound) for Ever Works platform",
|
|
5
5
|
"author": {
|
|
6
6
|
"name": "Ever Co. LTD",
|
|
@@ -32,7 +32,7 @@
|
|
|
32
32
|
"test:watch": "vitest"
|
|
33
33
|
},
|
|
34
34
|
"dependencies": {
|
|
35
|
-
"@ever-works/plugin": "^1.2.
|
|
35
|
+
"@ever-works/plugin": "^1.2.6",
|
|
36
36
|
"form-data": "^4.0.1",
|
|
37
37
|
"mailgun.js": "^10.2.3"
|
|
38
38
|
},
|
|
@@ -102,8 +102,8 @@
|
|
|
102
102
|
"url": "https://github.com/ever-works/ever-works/issues"
|
|
103
103
|
},
|
|
104
104
|
"everworksRelease": {
|
|
105
|
-
"contentHash": "sha256:
|
|
106
|
-
"commit": "
|
|
107
|
-
"source": "https://github.com/ever-works/ever-works/tree/
|
|
105
|
+
"contentHash": "sha256:b79265a2c363efec27556b88b54d5eac537b52e7ae490fb7ee5d59f10bf08414",
|
|
106
|
+
"commit": "eff002871bfd7f9f8e0f984907f45265ae8b01e0",
|
|
107
|
+
"source": "https://github.com/ever-works/ever-works/tree/eff002871bfd7f9f8e0f984907f45265ae8b01e0/packages/plugins/mailgun"
|
|
108
108
|
}
|
|
109
109
|
}
|