@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 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.6",
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.5",
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:67b3989e2cd280ad55dd8d6de81ecf313d5dcfad08c9be4456db4bfa92cddb6f",
106
- "commit": "19905c70cf05be3bc523db030597046067cd322a",
107
- "source": "https://github.com/ever-works/ever-works/tree/19905c70cf05be3bc523db030597046067cd322a/packages/plugins/mailgun"
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
  }