@web-ts-toolkit/email-service 0.72.0 → 0.73.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.
- package/README.md +148 -10
- package/index.d.mts +15 -7
- package/index.d.ts +15 -7
- package/index.js +479 -246
- package/index.mjs +479 -246
- package/mongoose.d.mts +7 -4
- package/mongoose.d.ts +7 -4
- package/mongoose.js +546 -280
- package/mongoose.mjs +546 -280
- package/package.json +1 -1
- package/{provider-HisBc6hk.d.mts → provider-DC_av0SQ.d.mts} +17 -1
- package/{provider-HisBc6hk.d.ts → provider-DC_av0SQ.d.ts} +17 -1
- package/sendgrid.d.mts +1 -1
- package/sendgrid.d.ts +1 -1
- package/sendgrid.js +116 -32
- package/sendgrid.mjs +116 -32
- package/smtp.d.mts +3 -1
- package/smtp.d.ts +3 -1
- package/smtp.js +138 -38
- package/smtp.mjs +138 -38
- package/{store-D4YAI6Rk.d.mts → store-Bi5iZ910.d.ts} +18 -4
- package/{store-Vb63Gocz.d.ts → store-DlABKTjt.d.mts} +18 -4
package/sendgrid.mjs
CHANGED
|
@@ -236,6 +236,12 @@ function opaqueToken(value, maxBytes, code) {
|
|
|
236
236
|
function identifier(value, code) {
|
|
237
237
|
return opaqueToken(value, MESSAGE_LIMITS.identifierBytes, code);
|
|
238
238
|
}
|
|
239
|
+
function uuidV4(value, code) {
|
|
240
|
+
if (typeof value !== "string" || value.length !== 36 || !/^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/.test(value)) {
|
|
241
|
+
invalid(code);
|
|
242
|
+
}
|
|
243
|
+
return value;
|
|
244
|
+
}
|
|
239
245
|
function hashToken(value, code) {
|
|
240
246
|
if (typeof value !== "string" || value.length !== 64 || !/^[0-9a-f]{64}$/.test(value)) invalid(code);
|
|
241
247
|
return value;
|
|
@@ -249,9 +255,9 @@ function jsonKey(key, code) {
|
|
|
249
255
|
|
|
250
256
|
// src/internal/canonical-json.ts
|
|
251
257
|
var treeLimits = { depth: MESSAGE_LIMITS.jsonDepth, values: MESSAGE_LIMITS.jsonValues };
|
|
252
|
-
function canonicalJson(input, maxBytes, code = "invalid_snapshot",
|
|
258
|
+
function canonicalJson(input, maxBytes, code = "invalid_snapshot", limits2 = treeLimits) {
|
|
253
259
|
let bytesLeft = maxBytes;
|
|
254
|
-
let valuesLeft =
|
|
260
|
+
let valuesLeft = limits2.values;
|
|
255
261
|
const chunks = [];
|
|
256
262
|
const ancestors = /* @__PURE__ */ new Set();
|
|
257
263
|
function append(text, bytes = text.length) {
|
|
@@ -270,7 +276,7 @@ function canonicalJson(input, maxBytes, code = "invalid_snapshot", limits = tree
|
|
|
270
276
|
append(JSON.stringify(text), bytes);
|
|
271
277
|
}
|
|
272
278
|
function visit(value2, depth) {
|
|
273
|
-
if (depth >
|
|
279
|
+
if (depth > limits2.depth || --valuesLeft < 0 || bytesLeft < 1) invalid(code);
|
|
274
280
|
switch (typeof value2) {
|
|
275
281
|
case "string":
|
|
276
282
|
appendString(value2);
|
|
@@ -294,7 +300,7 @@ function canonicalJson(input, maxBytes, code = "invalid_snapshot", limits = tree
|
|
|
294
300
|
if (ancestors.has(value2)) invalid(code);
|
|
295
301
|
ancestors.add(value2);
|
|
296
302
|
try {
|
|
297
|
-
const maxChildren = depth ===
|
|
303
|
+
const maxChildren = depth === limits2.depth ? 0 : valuesLeft;
|
|
298
304
|
if (isArray(value2, code)) {
|
|
299
305
|
const length = denseArrayLength(value2, maxChildren, code);
|
|
300
306
|
if (length && 2 * length + 1 > bytesLeft) invalid(code);
|
|
@@ -334,6 +340,67 @@ function copyJsonObject(input, maxBytes, code) {
|
|
|
334
340
|
function sha256(input) {
|
|
335
341
|
return createHash("sha256").update(input).digest("hex");
|
|
336
342
|
}
|
|
343
|
+
function encodeEvidence(input, code, capacity) {
|
|
344
|
+
return canonicalJson(input, capacity?.limits.evidenceBytes ?? 8192, code, capacity?.limits.evidenceTree).encoded;
|
|
345
|
+
}
|
|
346
|
+
|
|
347
|
+
// src/internal/smtp-capacity.ts
|
|
348
|
+
var MIN_RECIPIENTS = MESSAGE_LIMITS.recipients + 1;
|
|
349
|
+
var MAX_RECIPIENTS = 1e3;
|
|
350
|
+
var KIB = 1024;
|
|
351
|
+
var limits = Object.freeze({
|
|
352
|
+
snapshotBytes: 2 * KIB * KIB,
|
|
353
|
+
snapshotTree: Object.freeze({ depth: 4, values: 4096 }),
|
|
354
|
+
evidenceBytes: 64 * KIB,
|
|
355
|
+
evidenceTree: Object.freeze({ depth: 5, values: 4096 }),
|
|
356
|
+
jobBsonBytes: 4 * KIB * KIB,
|
|
357
|
+
activityBsonBytes: 128 * KIB,
|
|
358
|
+
registryCache: Object.freeze({ min: 0, default: 8, max: 16 }),
|
|
359
|
+
registryPending: Object.freeze({ min: 1, default: 2, max: 4 }),
|
|
360
|
+
servicePending: 4,
|
|
361
|
+
workerProfiles: 16,
|
|
362
|
+
workerConcurrency: Object.freeze({ min: 1, default: 1, max: 2 }),
|
|
363
|
+
runClaims: Object.freeze({ min: 1, default: 4, max: 16 }),
|
|
364
|
+
runMaintenance: Object.freeze({ min: 0, default: 4, max: 16 }),
|
|
365
|
+
adminMaintenance: Object.freeze({ min: 1, default: 4, max: 16 }),
|
|
366
|
+
page: Object.freeze({ min: 1, default: 8, max: 16 }),
|
|
367
|
+
memoryJobs: Object.freeze({ min: 1, default: 8, max: 16 }),
|
|
368
|
+
mongoInFlight: 4,
|
|
369
|
+
dueCandidates: 4
|
|
370
|
+
});
|
|
371
|
+
function readBinding(input, code) {
|
|
372
|
+
const { format, namespace, maxRecipients } = readRecord(input, ["format", "namespace", "maxRecipients"], [], code);
|
|
373
|
+
if (format !== "smtp-v2") invalid(code);
|
|
374
|
+
return Object.freeze({
|
|
375
|
+
format,
|
|
376
|
+
namespace: uuidV4(namespace, code),
|
|
377
|
+
maxRecipients: integer(maxRecipients, MIN_RECIPIENTS, MAX_RECIPIENTS, code)
|
|
378
|
+
});
|
|
379
|
+
}
|
|
380
|
+
function capacityTag(capacity) {
|
|
381
|
+
return capacity ? { smtpCapacity: capacity.binding } : {};
|
|
382
|
+
}
|
|
383
|
+
function recipientLimit(capacity) {
|
|
384
|
+
return capacity?.binding.maxRecipients ?? MESSAGE_LIMITS.recipients;
|
|
385
|
+
}
|
|
386
|
+
function matchesBinding(input, capacity, code) {
|
|
387
|
+
const binding = readBinding(input, code);
|
|
388
|
+
if (binding.namespace !== capacity.binding.namespace || binding.maxRecipients !== capacity.binding.maxRecipients) {
|
|
389
|
+
invalid(code);
|
|
390
|
+
}
|
|
391
|
+
}
|
|
392
|
+
function assertCapacityTag(raw, capacity, code) {
|
|
393
|
+
const tagged = Object.hasOwn(raw, "smtpCapacity");
|
|
394
|
+
if (capacity) {
|
|
395
|
+
if (!tagged) invalid(code);
|
|
396
|
+
matchesBinding(raw.smtpCapacity, capacity, code);
|
|
397
|
+
} else if (tagged) {
|
|
398
|
+
invalid(code);
|
|
399
|
+
}
|
|
400
|
+
}
|
|
401
|
+
function assertCapacityProvider(provider, capacity, code) {
|
|
402
|
+
if (capacity && provider.kind !== "smtp") invalid(code);
|
|
403
|
+
}
|
|
337
404
|
|
|
338
405
|
// src/internal/attempt-codecs.ts
|
|
339
406
|
var smtpStages = ["connect", "tls", "auth", "envelope", "data"];
|
|
@@ -373,6 +440,7 @@ function readAttemptReason(value, code) {
|
|
|
373
440
|
if (typeof value !== "string" || !Object.hasOwn(evidence, value)) invalid(code);
|
|
374
441
|
return value;
|
|
375
442
|
}
|
|
443
|
+
var recipientGroups = ["to", "cc", "bcc"];
|
|
376
444
|
function recipientCounts(envelope) {
|
|
377
445
|
return Object.freeze({ to: envelope.to.length, cc: envelope.cc.length, bcc: envelope.bcc.length });
|
|
378
446
|
}
|
|
@@ -392,7 +460,7 @@ function readHint(input, reason, code) {
|
|
|
392
460
|
...hasFloor ? { notBefore: unixMs(raw.notBefore, code) } : {}
|
|
393
461
|
});
|
|
394
462
|
}
|
|
395
|
-
function readAttemptResult(input, code = "invalid_command", projected = false) {
|
|
463
|
+
function readAttemptResult(input, code = "invalid_command", projected = false, capacity) {
|
|
396
464
|
const raw = readRecord(
|
|
397
465
|
input,
|
|
398
466
|
["outcome", "retry", "stage", "reason"],
|
|
@@ -403,6 +471,7 @@ function readAttemptResult(input, code = "invalid_command", projected = false) {
|
|
|
403
471
|
const [outcome, retry, stages, origin] = evidence[reason];
|
|
404
472
|
const stage = stages.find((value) => value === raw.stage);
|
|
405
473
|
if (raw.outcome !== outcome || raw.retry !== retry || !stage) invalid(code);
|
|
474
|
+
if (capacity && (origin === "sendgrid" || stage === "http")) invalid(code);
|
|
406
475
|
const hasHint = Object.hasOwn(raw, "retryHint");
|
|
407
476
|
if (projected && hasHint || !projected && reason === "rate_deferred" && !hasHint) invalid(code);
|
|
408
477
|
const smtpSuccess = reason === "smtp_accepted" || reason === "smtp_partial";
|
|
@@ -412,14 +481,22 @@ function readAttemptResult(input, code = "invalid_command", projected = false) {
|
|
|
412
481
|
if (hasRecipients) {
|
|
413
482
|
if (origin !== "smtp" && origin !== "provider" || stage !== "envelope" && stage !== "data") invalid(code);
|
|
414
483
|
const seen = /* @__PURE__ */ new Set();
|
|
415
|
-
|
|
484
|
+
const limit = recipientLimit(capacity);
|
|
485
|
+
let previous = -1;
|
|
486
|
+
recipients = readArray(raw.recipients, limit, code, (value) => {
|
|
416
487
|
const { group, index: rawIndex, status } = readRecord(value, ["group", "index", "status"], [], code);
|
|
417
488
|
if (group !== "to" && group !== "cc" && group !== "bcc") invalid(code);
|
|
418
489
|
if (status !== "rejected" && (status !== "accepted" || !smtpSuccess)) invalid(code);
|
|
419
|
-
const index = integer(rawIndex, 0,
|
|
420
|
-
|
|
421
|
-
|
|
422
|
-
|
|
490
|
+
const index = integer(rawIndex, 0, limit - 1, code);
|
|
491
|
+
if (capacity) {
|
|
492
|
+
const position = recipientGroups.indexOf(group) * limit + index;
|
|
493
|
+
if (position <= previous) invalid(code);
|
|
494
|
+
previous = position;
|
|
495
|
+
} else {
|
|
496
|
+
const key = `${group}:${index}`;
|
|
497
|
+
if (seen.has(key)) invalid(code);
|
|
498
|
+
seen.add(key);
|
|
499
|
+
}
|
|
423
500
|
return Object.freeze({ group, index, status });
|
|
424
501
|
});
|
|
425
502
|
const accepted = recipients.filter(({ status }) => status === "accepted").length;
|
|
@@ -434,7 +511,7 @@ function readAttemptResult(input, code = "invalid_command", projected = false) {
|
|
|
434
511
|
if (hasProviderId && (reason !== "sendgrid_accepted" || typeof providerMessageId !== "string" || providerMessageId.length > 128 || !/^[A-Za-z0-9][A-Za-z0-9._=-]{0,127}$/.test(providerMessageId))) {
|
|
435
512
|
invalid(code);
|
|
436
513
|
}
|
|
437
|
-
|
|
514
|
+
const result = Object.freeze({
|
|
438
515
|
outcome,
|
|
439
516
|
retry,
|
|
440
517
|
stage,
|
|
@@ -444,6 +521,8 @@ function readAttemptResult(input, code = "invalid_command", projected = false) {
|
|
|
444
521
|
...typeof messageId === "string" ? { messageId } : {},
|
|
445
522
|
...typeof providerMessageId === "string" ? { providerMessageId } : {}
|
|
446
523
|
});
|
|
524
|
+
if (capacity && !projected) encodeEvidence(result, code, capacity);
|
|
525
|
+
return result;
|
|
447
526
|
}
|
|
448
527
|
function assertEvidenceContext(result, provider, attemptId, counts, code) {
|
|
449
528
|
const { reason, stage, recipients, messageId } = result;
|
|
@@ -460,9 +539,9 @@ function assertEvidenceContext(result, provider, attemptId, counts, code) {
|
|
|
460
539
|
}
|
|
461
540
|
}
|
|
462
541
|
}
|
|
463
|
-
function readProviderResult(input, provider, attemptId, envelope) {
|
|
542
|
+
function readProviderResult(input, provider, attemptId, envelope, capacity) {
|
|
464
543
|
const code = "invalid_command";
|
|
465
|
-
const result = readAttemptResult(input, code);
|
|
544
|
+
const result = readAttemptResult(input, code, false, capacity);
|
|
466
545
|
const origin = evidence[result.reason][3];
|
|
467
546
|
if (origin !== "smtp" && origin !== "sendgrid" && origin !== "provider") invalid(code);
|
|
468
547
|
assertEvidenceContext(result, provider, attemptId, recipientCounts(envelope), code);
|
|
@@ -612,7 +691,8 @@ function validateMailbox(input, code = SNAPSHOT) {
|
|
|
612
691
|
...Object.hasOwn(mailbox2, "name") ? { name: headerString(mailbox2.name, L.displayNameBytes, code) } : {}
|
|
613
692
|
});
|
|
614
693
|
}
|
|
615
|
-
function validateEnvelope(input, kind, code = SNAPSHOT) {
|
|
694
|
+
function validateEnvelope(input, kind, code = SNAPSHOT, capacity) {
|
|
695
|
+
const limit = recipientLimit(capacity);
|
|
616
696
|
const envelope = readRecord(input, ["from", "to", "cc", "bcc"], ["replyTo"], code);
|
|
617
697
|
const seen = /* @__PURE__ */ new Set();
|
|
618
698
|
const recipient = (raw) => {
|
|
@@ -623,9 +703,9 @@ function validateEnvelope(input, kind, code = SNAPSHOT) {
|
|
|
623
703
|
return mailbox2;
|
|
624
704
|
};
|
|
625
705
|
const from = validateMailbox(envelope.from, code);
|
|
626
|
-
const to = readArray(envelope.to,
|
|
627
|
-
const cc = readArray(envelope.cc,
|
|
628
|
-
const bcc = readArray(envelope.bcc,
|
|
706
|
+
const to = readArray(envelope.to, limit, code, recipient);
|
|
707
|
+
const cc = readArray(envelope.cc, limit - to.length, code, recipient);
|
|
708
|
+
const bcc = readArray(envelope.bcc, limit - to.length - cc.length, code, recipient);
|
|
629
709
|
if (seen.size === 0 || kind === "sendgrid" && to.length === 0) invalid(code);
|
|
630
710
|
return Object.freeze({
|
|
631
711
|
from,
|
|
@@ -713,12 +793,17 @@ function validateExpiry(input, preparedAt, scheduleAt, code = SNAPSHOT) {
|
|
|
713
793
|
}
|
|
714
794
|
return expiresAt;
|
|
715
795
|
}
|
|
716
|
-
function hashSnapshot(snapshot) {
|
|
796
|
+
function hashSnapshot(snapshot, capacity) {
|
|
717
797
|
return sha256(
|
|
718
|
-
canonicalJson(
|
|
798
|
+
canonicalJson(
|
|
799
|
+
snapshot,
|
|
800
|
+
capacity?.limits.snapshotBytes ?? L.snapshotBytes,
|
|
801
|
+
SNAPSHOT,
|
|
802
|
+
capacity?.limits.snapshotTree ?? { depth: L.jsonDepth + 1, values: L.jsonValues + 256 }
|
|
803
|
+
).encoded
|
|
719
804
|
);
|
|
720
805
|
}
|
|
721
|
-
function readSnapshot(input) {
|
|
806
|
+
function readSnapshot(input, capacity) {
|
|
722
807
|
const dto = readRecord(
|
|
723
808
|
input,
|
|
724
809
|
[
|
|
@@ -733,17 +818,19 @@ function readSnapshot(input) {
|
|
|
733
818
|
"attachments",
|
|
734
819
|
"correlation"
|
|
735
820
|
],
|
|
736
|
-
["subject", "html", "text", "templateId", "data"],
|
|
821
|
+
["subject", "html", "text", "templateId", "data", "smtpCapacity"],
|
|
737
822
|
SNAPSHOT
|
|
738
823
|
);
|
|
739
824
|
if (dto.version !== EMAIL_FORMAT_VERSION || dto.kind !== "smtp" && dto.kind !== "sendgrid") invalid(SNAPSHOT);
|
|
825
|
+
assertCapacityTag(dto, capacity, SNAPSHOT);
|
|
740
826
|
const provider = validateProviderRef(dto.provider);
|
|
741
827
|
if (provider.kind !== dto.kind) invalid("provider_mismatch");
|
|
828
|
+
assertCapacityProvider(provider, capacity, "provider_mismatch");
|
|
742
829
|
const preparedAt = unixMs(dto.preparedAt, SNAPSHOT);
|
|
743
830
|
const common = {
|
|
744
831
|
version: EMAIL_FORMAT_VERSION,
|
|
745
832
|
template: validateTemplateIdentity(dto.template),
|
|
746
|
-
envelope: validateEnvelope(dto.envelope, provider.kind),
|
|
833
|
+
envelope: validateEnvelope(dto.envelope, provider.kind, SNAPSHOT, capacity),
|
|
747
834
|
preparedAt,
|
|
748
835
|
expiresAt: validateExpiry(dto.expiresAt, preparedAt, null),
|
|
749
836
|
priority: integer(dto.priority, PRIORITY.min, PRIORITY.max, SNAPSHOT),
|
|
@@ -757,7 +844,7 @@ function readSnapshot(input) {
|
|
|
757
844
|
...Object.hasOwn(dto, "html") ? { html: dto.html } : {},
|
|
758
845
|
...Object.hasOwn(dto, "text") ? { text: dto.text } : {}
|
|
759
846
|
});
|
|
760
|
-
return Object.freeze({ ...common, kind: provider.kind, provider, ...content });
|
|
847
|
+
return Object.freeze({ ...common, kind: provider.kind, provider, ...capacityTag(capacity), ...content });
|
|
761
848
|
}
|
|
762
849
|
if (Object.hasOwn(dto, "subject") || Object.hasOwn(dto, "html") || Object.hasOwn(dto, "text")) invalid(SNAPSHOT);
|
|
763
850
|
return Object.freeze({
|
|
@@ -768,31 +855,28 @@ function readSnapshot(input) {
|
|
|
768
855
|
data: copyJsonObject(dto.data, L.dataBytes, SNAPSHOT)
|
|
769
856
|
});
|
|
770
857
|
}
|
|
771
|
-
function validateSnapshot(input) {
|
|
772
|
-
const snapshot = readSnapshot(input);
|
|
773
|
-
return { snapshot, snapshotHash: hashSnapshot(snapshot) };
|
|
858
|
+
function validateSnapshot(input, capacity) {
|
|
859
|
+
const snapshot = readSnapshot(input, capacity);
|
|
860
|
+
return { snapshot, snapshotHash: hashSnapshot(snapshot, capacity) };
|
|
774
861
|
}
|
|
775
862
|
|
|
776
863
|
// src/internal/store-codecs.ts
|
|
777
864
|
var REQUEST = "invalid_command";
|
|
778
865
|
var LEASE = WORKER_LIMIT_BOUNDS.leaseMs;
|
|
779
866
|
function readStoreId(value, code = REQUEST) {
|
|
780
|
-
|
|
781
|
-
invalid(code);
|
|
782
|
-
}
|
|
783
|
-
return value;
|
|
867
|
+
return uuidV4(value, code);
|
|
784
868
|
}
|
|
785
869
|
|
|
786
870
|
// src/internal/provider-preparation.ts
|
|
787
871
|
function sameRef(a, b) {
|
|
788
872
|
return a.resolverKey === b.resolverKey && a.id === b.id && a.version === b.version && a.filename === b.filename && a.contentType === b.contentType && a.byteLength === b.byteLength && a.sha256 === b.sha256;
|
|
789
873
|
}
|
|
790
|
-
function readProviderSubmission(input, ref) {
|
|
874
|
+
function readProviderSubmission(input, ref, capacity) {
|
|
791
875
|
const code = "invalid_snapshot";
|
|
792
876
|
const raw = readRecord(input, ["jobId", "attemptId", "snapshot", "attachments"], [], code);
|
|
793
877
|
const jobId = readStoreId(raw.jobId, code);
|
|
794
878
|
const attemptId = readStoreId(raw.attemptId, code);
|
|
795
|
-
const { snapshot } = validateSnapshot(raw.snapshot);
|
|
879
|
+
const { snapshot } = validateSnapshot(raw.snapshot, capacity);
|
|
796
880
|
if (ref.kind !== snapshot.kind || ref.key !== snapshot.provider.key || ref.mode !== snapshot.provider.mode) {
|
|
797
881
|
invalid("provider_mismatch");
|
|
798
882
|
}
|
package/smtp.d.mts
CHANGED
|
@@ -1,8 +1,10 @@
|
|
|
1
|
-
import { o as EmailProvider,
|
|
1
|
+
import { S as SmtpCapacity, o as EmailProvider, z as SmtpSnapshot } from './provider-DC_av0SQ.mjs';
|
|
2
2
|
|
|
3
3
|
/** Configuration for a direct, unpooled ESMTP connection with verified TLS 1.2 or newer. */
|
|
4
4
|
type SmtpProviderOptions = {
|
|
5
5
|
key: string;
|
|
6
|
+
/** Must match the prepared snapshot and worker for opted-in messages. Omit for the V1 cap of 50. */
|
|
7
|
+
smtpCapacity?: SmtpCapacity;
|
|
6
8
|
/** ASCII DNS hostname or IP literal, without a URL, port or IPv6 brackets. */
|
|
7
9
|
host: string;
|
|
8
10
|
/** Defaults to 465 for implicit TLS or 587 for required STARTTLS. */
|
package/smtp.d.ts
CHANGED
|
@@ -1,8 +1,10 @@
|
|
|
1
|
-
import { o as EmailProvider,
|
|
1
|
+
import { S as SmtpCapacity, o as EmailProvider, z as SmtpSnapshot } from './provider-DC_av0SQ.js';
|
|
2
2
|
|
|
3
3
|
/** Configuration for a direct, unpooled ESMTP connection with verified TLS 1.2 or newer. */
|
|
4
4
|
type SmtpProviderOptions = {
|
|
5
5
|
key: string;
|
|
6
|
+
/** Must match the prepared snapshot and worker for opted-in messages. Omit for the V1 cap of 50. */
|
|
7
|
+
smtpCapacity?: SmtpCapacity;
|
|
6
8
|
/** ASCII DNS hostname or IP literal, without a URL, port or IPv6 brackets. */
|
|
7
9
|
host: string;
|
|
8
10
|
/** Defaults to 465 for implicit TLS or 587 for required STARTTLS. */
|