outbound-sdk 0.2.1 → 0.5.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 +2 -2
- package/dist/alerts/check-evaluate.d.ts +53 -0
- package/dist/alerts/check-measure.d.ts +100 -0
- package/dist/alerts/check-schema.d.ts +184 -0
- package/dist/alerts/check-validate.d.ts +18 -0
- package/dist/alerts/index.d.ts +7 -0
- package/dist/alerts/index.js +684 -20
- package/dist/alerts/plugin.d.ts +20 -3
- package/dist/audit/index.js +2 -2
- package/dist/benchmarks/index.js +5 -5
- package/dist/budget/index.d.ts +5 -2
- package/dist/budget/index.js +12 -10
- package/dist/cards/content.d.ts +6 -1
- package/dist/cards/format.d.ts +17 -2
- package/dist/cards/index.d.ts +1 -1
- package/dist/cards/index.js +298 -132
- package/dist/cards/parts.d.ts +9 -2
- package/dist/cards/render.d.ts +20 -3
- package/dist/chunks/{chunk-U2D34ARZ.js → chunk-2D42TQFU.js} +3 -3
- package/dist/chunks/{chunk-6CVZOUHB.js → chunk-3S32R2MH.js} +53 -63
- package/dist/chunks/chunk-4PA526S7.js +17 -0
- package/dist/chunks/{chunk-RCZ7ZZFU.js → chunk-5J7GGV62.js} +12 -5
- package/dist/chunks/chunk-6TKFISG4.js +676 -0
- package/dist/chunks/{chunk-AFU5E5QB.js → chunk-BK5SLY32.js} +104 -84
- package/dist/chunks/{chunk-VQSCHOBV.js → chunk-BLCJHP5H.js} +11 -4
- package/dist/chunks/{chunk-SBIZDCRY.js → chunk-BN6WCAWX.js} +7 -7
- package/dist/chunks/{chunk-4PSO6JEK.js → chunk-BOWXGMN3.js} +6 -21
- package/dist/chunks/{chunk-PURHK3JU.js → chunk-EHSJGQ5K.js} +8 -8
- package/dist/chunks/{chunk-IPUYZD4O.js → chunk-GFDNRWR3.js} +1 -1
- package/dist/chunks/chunk-HPNGSG5E.js +51 -0
- package/dist/chunks/chunk-HWHI4LFY.js +102 -0
- package/dist/chunks/{chunk-E7JHLNLG.js → chunk-J7DDZ4C2.js} +15 -2
- package/dist/chunks/{chunk-DJ2IUQEU.js → chunk-JWGSB7PT.js} +6 -6
- package/dist/chunks/{chunk-R3Y56YVF.js → chunk-OLPMBRXM.js} +4 -3
- package/dist/chunks/{chunk-YOTW5ESM.js → chunk-PQSTQKRD.js} +2 -2
- package/dist/chunks/chunk-PTZO4QXR.js +15 -0
- package/dist/chunks/{chunk-LVYG7XZJ.js → chunk-QAKJ76HB.js} +1 -1
- package/dist/chunks/chunk-QGRZDTX4.js +26 -0
- package/dist/chunks/chunk-WGW3ROLY.js +18 -0
- package/dist/chunks/{chunk-XC6CZP73.js → chunk-WH6V3YNN.js} +32 -1
- package/dist/chunks/{chunk-P3IJBJUI.js → chunk-X4RDBD4J.js} +296 -62
- package/dist/chunks/chunk-XL6LJVHJ.js +71 -0
- package/dist/chunks/{chunk-XNFESPZH.js → chunk-YYCT3NGV.js} +200 -39
- package/dist/chunks/{chunk-UAT3JSJZ.js → chunk-ZOAG2C6V.js} +2 -2
- package/dist/cli/bin.js +19 -30
- package/dist/cli/commands.d.ts +11 -0
- package/dist/cli/index.d.ts +3 -0
- package/dist/cli/index.js +18 -13
- package/dist/cli/mcp.d.ts +5 -0
- package/dist/cli/update.d.ts +15 -0
- package/dist/clients/index.d.ts +1 -1
- package/dist/clients/index.js +35 -10
- package/dist/clients/plugin.d.ts +9 -2
- package/dist/combine/index.js +7 -6
- package/dist/emailbison/account.d.ts +7 -0
- package/dist/emailbison/adapter.d.ts +5 -0
- package/dist/emailbison/capabilities.d.ts +78 -0
- package/dist/emailbison/client.d.ts +29 -0
- package/dist/emailbison/index.d.ts +30 -0
- package/dist/emailbison/index.js +1017 -0
- package/dist/emailbison/mail.d.ts +5 -0
- package/dist/emailbison/map-mail.d.ts +13 -0
- package/dist/emailbison/map-sequence.d.ts +12 -0
- package/dist/emailbison/map-stats.d.ts +47 -0
- package/dist/emailbison/map.d.ts +24 -0
- package/dist/emailbison/native-params.d.ts +5 -0
- package/dist/emailbison/native-workspace.d.ts +167 -0
- package/dist/emailbison/native.d.ts +327 -0
- package/dist/emailbison/stats.d.ts +4 -0
- package/dist/emailbison/webhooks.d.ts +2 -0
- package/dist/exporter/index.d.ts +5 -2
- package/dist/exporter/index.js +2 -2
- package/dist/failover/index.js +3 -3
- package/dist/fixtures/index.js +10 -9
- package/dist/heyreach/capabilities.d.ts +3 -0
- package/dist/heyreach/client.d.ts +2 -0
- package/dist/heyreach/index.js +83 -51
- package/dist/heyreach/map.d.ts +5 -2
- package/dist/identity/index.js +33 -17
- package/dist/identity/plugin.d.ts +2 -0
- package/dist/index.d.ts +2 -2
- package/dist/index.js +29 -25
- package/dist/insights/campaign.d.ts +3 -0
- package/dist/insights/capped.d.ts +29 -0
- package/dist/insights/copy/copy-audit.d.ts +2 -0
- package/dist/insights/copy/copy-reuse.d.ts +27 -3
- package/dist/insights/copy/index.d.ts +8 -8
- package/dist/insights/copy/reply-timing.d.ts +8 -0
- package/dist/insights/copy/reuse-base.d.ts +32 -0
- package/dist/insights/copy/shared.d.ts +39 -15
- package/dist/insights/copy/step-funnel.d.ts +16 -5
- package/dist/insights/copy/variant-test.d.ts +19 -8
- package/dist/insights/cost.d.ts +91 -0
- package/dist/insights/define.d.ts +78 -3
- package/dist/insights/fields.d.ts +16 -0
- package/dist/insights/index.d.ts +6 -4
- package/dist/insights/index.js +1816 -748
- package/dist/insights/inputs.generated.d.ts +951 -0
- package/dist/insights/ops/campaign-diagnosis.d.ts +3 -1
- package/dist/insights/ops/campaign-ranking.d.ts +15 -7
- package/dist/insights/ops/channel-mix.d.ts +2 -1
- package/dist/insights/ops/client-report.d.ts +18 -5
- package/dist/insights/ops/index.d.ts +8 -4
- package/dist/insights/ops/period-comparison.d.ts +14 -3
- package/dist/insights/ops/pipeline-forecast.d.ts +14 -4
- package/dist/insights/ops/shared.d.ts +39 -24
- package/dist/insights/ops/tag-rollup.d.ts +2 -1
- package/dist/insights/people/account-summary.d.ts +13 -0
- package/dist/insights/people/dropped-replies.d.ts +8 -0
- package/dist/insights/people/find.d.ts +7 -1
- package/dist/insights/people/hot-leads.d.ts +16 -1
- package/dist/insights/people/person-summary.d.ts +6 -0
- package/dist/insights/people/read.d.ts +26 -10
- package/dist/insights/people/suppression-check.d.ts +11 -2
- package/dist/insights/plugin.d.ts +26 -5
- package/dist/insights/ref.d.ts +6 -0
- package/dist/insights/registry.d.ts +30 -18
- package/dist/insights/run-cap.d.ts +35 -0
- package/dist/insights/senders/bounce-watch.d.ts +25 -8
- package/dist/insights/senders/capacity-sends.d.ts +22 -0
- package/dist/insights/senders/domain-health.d.ts +10 -4
- package/dist/insights/senders/index.d.ts +14 -6
- package/dist/insights/senders/read.d.ts +15 -14
- package/dist/insights/senders/sender-capacity.d.ts +5 -13
- package/dist/insights/senders/sender-load.d.ts +2 -0
- package/dist/insights/stats.d.ts +8 -0
- package/dist/insights/tools.d.ts +13 -2
- package/dist/instantly/capabilities.d.ts +13 -0
- package/dist/instantly/client.d.ts +2 -0
- package/dist/instantly/index.js +77 -49
- package/dist/instantly/map.d.ts +6 -2
- package/dist/internal/adapter.d.ts +12 -0
- package/dist/internal/engine/request.d.ts +5 -0
- package/dist/internal/entities.d.ts +3 -20
- package/dist/internal/errors.d.ts +44 -0
- package/dist/internal/fields.d.ts +1 -1
- package/dist/internal/json.d.ts +9 -2
- package/dist/internal/lists.d.ts +24 -0
- package/dist/internal/numbers.d.ts +8 -0
- package/dist/internal/outbound/collections.d.ts +4 -0
- package/dist/internal/outbound/create.d.ts +24 -3
- package/dist/internal/outbound/outbound.d.ts +18 -2
- package/dist/internal/outbound/validate.d.ts +4 -0
- package/dist/internal/outbound/walker.d.ts +3 -2
- package/dist/internal/plural.d.ts +12 -0
- package/dist/internal/renamed.d.ts +28 -0
- package/dist/internal/request-cap.d.ts +35 -0
- package/dist/internal/vocabulary.d.ts +20 -0
- package/dist/loader/index.js +5 -5
- package/dist/memory/adapter.d.ts +7 -0
- package/dist/memory/demo-stats.d.ts +3 -0
- package/dist/memory/demo.d.ts +14 -3
- package/dist/memory/index.d.ts +1 -0
- package/dist/memory/index.js +209 -104
- package/dist/providers/index.d.ts +92 -0
- package/dist/providers/index.js +3 -1
- package/dist/reconcile/index.js +5 -4
- package/dist/redact/index.js +13 -7
- package/dist/redact/plugin.d.ts +7 -0
- package/dist/smartlead/capabilities.d.ts +5 -0
- package/dist/smartlead/index.js +119 -66
- package/dist/smartlead/shared.d.ts +13 -0
- package/dist/sync/index.js +2 -2
- package/dist/tools/ai-sdk.js +10 -6
- package/dist/tools/campaign-tools.d.ts +1 -1
- package/dist/tools/claude-agent.js +10 -6
- package/dist/tools/index.d.ts +2 -2
- package/dist/tools/index.js +16 -9
- package/dist/tools/input-problem.d.ts +8 -0
- package/dist/tools/registry.d.ts +26 -2
- package/dist/tools/shared.d.ts +27 -1
- package/dist/tracing/index.js +2 -2
- package/dist/webhooks/index.js +22 -12
- package/package.json +8 -2
- package/dist/chunks/chunk-FKH5N47I.js +0 -40
package/dist/alerts/index.js
CHANGED
|
@@ -1,10 +1,21 @@
|
|
|
1
|
+
import {
|
|
2
|
+
percentOf
|
|
3
|
+
} from "../chunks/chunk-4PA526S7.js";
|
|
4
|
+
import "../chunks/chunk-PTZO4QXR.js";
|
|
5
|
+
import {
|
|
6
|
+
metricRowSchema,
|
|
7
|
+
senderSchema,
|
|
8
|
+
senderStatusSchema
|
|
9
|
+
} from "../chunks/chunk-BOWXGMN3.js";
|
|
1
10
|
import {
|
|
2
11
|
computeRates
|
|
3
|
-
} from "../chunks/chunk-
|
|
4
|
-
import "../chunks/chunk-
|
|
5
|
-
import "../chunks/chunk-
|
|
6
|
-
import
|
|
7
|
-
|
|
12
|
+
} from "../chunks/chunk-PQSTQKRD.js";
|
|
13
|
+
import "../chunks/chunk-QGRZDTX4.js";
|
|
14
|
+
import "../chunks/chunk-QAKJ76HB.js";
|
|
15
|
+
import {
|
|
16
|
+
OutboundError
|
|
17
|
+
} from "../chunks/chunk-J7DDZ4C2.js";
|
|
18
|
+
import "../chunks/chunk-BLCJHP5H.js";
|
|
8
19
|
|
|
9
20
|
// src/alerts/plugin.ts
|
|
10
21
|
var memoryAlertDedupe = () => {
|
|
@@ -18,7 +29,7 @@ var memoryAlertDedupe = () => {
|
|
|
18
29
|
};
|
|
19
30
|
var isMetricRow = (record) => "scope" in record;
|
|
20
31
|
var isSender = (record) => "kind" in record && "dailyLimit" in record;
|
|
21
|
-
var
|
|
32
|
+
var isCampaign = (record) => "channel" in record && "tags" in record && "status" in record;
|
|
22
33
|
var bounceRateAbove = (threshold, options = {}) => ({
|
|
23
34
|
check: (record) => {
|
|
24
35
|
if (!isMetricRow(record) || (record.sent ?? 0) < (options.minSent ?? 50)) {
|
|
@@ -26,7 +37,8 @@ var bounceRateAbove = (threshold, options = {}) => ({
|
|
|
26
37
|
}
|
|
27
38
|
const { value } = computeRates(record).bounceRate;
|
|
28
39
|
return value !== null && value > threshold ? {
|
|
29
|
-
message: `Bounce rate is ${
|
|
40
|
+
message: `Bounce rate is ${percentOf(value)}, above ${percentOf(threshold)}`,
|
|
41
|
+
day: record.date,
|
|
30
42
|
rule: "bounce-rate-above",
|
|
31
43
|
subject: record.scopeRef,
|
|
32
44
|
threshold,
|
|
@@ -42,7 +54,8 @@ var replyRateBelow = (threshold, options = {}) => ({
|
|
|
42
54
|
}
|
|
43
55
|
const { value } = computeRates(record).replyRate;
|
|
44
56
|
return value !== null && value < threshold ? {
|
|
45
|
-
message: `Reply rate is ${
|
|
57
|
+
message: `Reply rate is ${percentOf(value)}, below ${percentOf(threshold)}`,
|
|
58
|
+
day: record.date,
|
|
46
59
|
rule: "reply-rate-below",
|
|
47
60
|
subject: record.scopeRef,
|
|
48
61
|
threshold,
|
|
@@ -56,13 +69,16 @@ var senderNotActive = () => ({
|
|
|
56
69
|
message: `Sender is ${record.status}`,
|
|
57
70
|
rule: "sender-not-active",
|
|
58
71
|
subject: record.ref,
|
|
72
|
+
subjectName: record.address ?? record.name,
|
|
59
73
|
threshold: "active",
|
|
60
74
|
value: record.status
|
|
61
75
|
} : null,
|
|
62
|
-
name: "sender-not-active"
|
|
76
|
+
name: "sender-not-active",
|
|
77
|
+
state: true
|
|
63
78
|
});
|
|
64
79
|
var noSends = () => ({
|
|
65
80
|
check: (record) => isMetricRow(record) && record.date !== null && record.sent === 0 ? {
|
|
81
|
+
day: record.date,
|
|
66
82
|
message: `Nothing was sent on ${record.date}`,
|
|
67
83
|
rule: "no-sends",
|
|
68
84
|
subject: record.scopeRef,
|
|
@@ -73,10 +89,15 @@ var noSends = () => ({
|
|
|
73
89
|
});
|
|
74
90
|
var ignore = () => {
|
|
75
91
|
};
|
|
92
|
+
var keyOf = (alert, rule) => [
|
|
93
|
+
alert.rule,
|
|
94
|
+
alert.subject,
|
|
95
|
+
...alert.day ? [alert.day] : [],
|
|
96
|
+
...rule.state === true ? [String(alert.value)] : []
|
|
97
|
+
].join("|");
|
|
76
98
|
var fresh = async (fired, seen) => {
|
|
77
99
|
const unseen = [];
|
|
78
|
-
for (const alert of fired) {
|
|
79
|
-
const key = `${alert.rule}|${alert.subject}`;
|
|
100
|
+
for (const { alert, key } of fired) {
|
|
80
101
|
if (!await seen.has(key)) {
|
|
81
102
|
await seen.add(key);
|
|
82
103
|
unseen.push(alert);
|
|
@@ -85,12 +106,29 @@ var fresh = async (fired, seen) => {
|
|
|
85
106
|
return unseen;
|
|
86
107
|
};
|
|
87
108
|
var alerts = (options) => {
|
|
88
|
-
const
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
109
|
+
const names = /* @__PURE__ */ new Map();
|
|
110
|
+
const fire = (records) => {
|
|
111
|
+
for (const record of records) {
|
|
112
|
+
if (isCampaign(record)) {
|
|
113
|
+
names.set(record.ref, record.name);
|
|
114
|
+
}
|
|
115
|
+
}
|
|
116
|
+
return records.flatMap(
|
|
117
|
+
(record) => options.rules.flatMap((rule) => {
|
|
118
|
+
const alert = rule.check(record);
|
|
119
|
+
return alert === null ? [] : [
|
|
120
|
+
{
|
|
121
|
+
alert: {
|
|
122
|
+
...alert,
|
|
123
|
+
subjectName: alert.subjectName ?? names.get(alert.subject) ?? null
|
|
124
|
+
},
|
|
125
|
+
key: keyOf(alert, rule)
|
|
126
|
+
}
|
|
127
|
+
];
|
|
128
|
+
})
|
|
129
|
+
);
|
|
130
|
+
};
|
|
131
|
+
const evaluate = (records) => fire(records).map((each) => each.alert);
|
|
94
132
|
const { dedupe } = options;
|
|
95
133
|
let last = Promise.resolve();
|
|
96
134
|
const notifyFresh = (fired, seen) => {
|
|
@@ -118,10 +156,10 @@ var alerts = (options) => {
|
|
|
118
156
|
name: "alerts",
|
|
119
157
|
wrap: async (operation, next) => {
|
|
120
158
|
const output = await next(operation);
|
|
121
|
-
const fired =
|
|
159
|
+
const fired = fire(output.items);
|
|
122
160
|
if (fired.length > 0) {
|
|
123
161
|
if (dedupe === void 0) {
|
|
124
|
-
notifyAll(fired);
|
|
162
|
+
notifyAll(fired.map((each) => each.alert));
|
|
125
163
|
} else {
|
|
126
164
|
notifyFresh(fired, dedupe);
|
|
127
165
|
}
|
|
@@ -130,11 +168,637 @@ var alerts = (options) => {
|
|
|
130
168
|
}
|
|
131
169
|
};
|
|
132
170
|
};
|
|
171
|
+
|
|
172
|
+
// src/alerts/check-schema.ts
|
|
173
|
+
import { z } from "zod";
|
|
174
|
+
var STATS_SCOPE = ["client", "campaign", "sender"];
|
|
175
|
+
var CHECK_METRICS = {
|
|
176
|
+
blocked_leads: {
|
|
177
|
+
description: "Leads in a campaign that are on a block list, per campaign. Read with `suppressionCheck`.",
|
|
178
|
+
reads: "suppressionCheck",
|
|
179
|
+
scope: ["client", "campaign"],
|
|
180
|
+
unit: "count"
|
|
181
|
+
},
|
|
182
|
+
bounce_rate: {
|
|
183
|
+
description: "Bounced divided by sent, per stats row. Rows with fewer than `min_sent` sends are skipped.",
|
|
184
|
+
reads: "stats",
|
|
185
|
+
scope: STATS_SCOPE,
|
|
186
|
+
unit: "rate"
|
|
187
|
+
},
|
|
188
|
+
broken_variable_leads: {
|
|
189
|
+
description: "Leads who get broken copy from one merge variable with no value and no fallback, per variable. Read with `personalizationGaps`.",
|
|
190
|
+
reads: "personalizationGaps",
|
|
191
|
+
scope: ["client", "campaign"],
|
|
192
|
+
unit: "count"
|
|
193
|
+
},
|
|
194
|
+
lead_runway_days: {
|
|
195
|
+
description: "Days until a campaign runs out of leads at its recent contact rate. Read with `pipelineForecast`.",
|
|
196
|
+
reads: "pipelineForecast",
|
|
197
|
+
scope: ["client", "campaign"],
|
|
198
|
+
unit: "days"
|
|
199
|
+
},
|
|
200
|
+
positive_reply_waiting_hours: {
|
|
201
|
+
description: "Hours a positive reply has waited with no answer, per reply. Read with `droppedReplies`.",
|
|
202
|
+
reads: "droppedReplies",
|
|
203
|
+
scope: ["client", "campaign", "person"],
|
|
204
|
+
unit: "hours"
|
|
205
|
+
},
|
|
206
|
+
reply_rate: {
|
|
207
|
+
description: "Replies divided by leads contacted (or sent), per stats row. Rows with fewer than `min_sent` sends are skipped.",
|
|
208
|
+
reads: "stats",
|
|
209
|
+
scope: STATS_SCOPE,
|
|
210
|
+
unit: "rate"
|
|
211
|
+
},
|
|
212
|
+
sender_status: {
|
|
213
|
+
description: "A sender's status: active, paused, disconnected or error. A sender whose status is unknown is skipped.",
|
|
214
|
+
reads: "senders",
|
|
215
|
+
scope: ["client", "sender"],
|
|
216
|
+
unit: "status"
|
|
217
|
+
},
|
|
218
|
+
sent: {
|
|
219
|
+
description: "Messages sent, per stats row. With `window`, daily rows older than the window are skipped.",
|
|
220
|
+
reads: "stats",
|
|
221
|
+
scope: STATS_SCOPE,
|
|
222
|
+
unit: "count"
|
|
223
|
+
}
|
|
224
|
+
};
|
|
225
|
+
var METRIC_NAMES = Object.keys(CHECK_METRICS);
|
|
226
|
+
var NUMBER_OPS = [">", ">=", "<", "<=", "==", "!="];
|
|
227
|
+
var OP_ALIASES = /* @__PURE__ */ new Map([
|
|
228
|
+
["!==", "!="],
|
|
229
|
+
["<>", "!="],
|
|
230
|
+
["=", "=="],
|
|
231
|
+
["===", "=="],
|
|
232
|
+
["eq", "=="],
|
|
233
|
+
["gt", ">"],
|
|
234
|
+
["gte", ">="],
|
|
235
|
+
["lt", "<"],
|
|
236
|
+
["lte", "<="],
|
|
237
|
+
["ne", "!="],
|
|
238
|
+
["neq", "!="]
|
|
239
|
+
]);
|
|
240
|
+
var STATUSES = new Set(senderStatusSchema.options);
|
|
241
|
+
var REF = /^[^:\s]+:[^:\s]+:\S+$/u;
|
|
242
|
+
var ref = (what) => z.string({ error: `must be the ${what}'s ref, a string` }).regex(REF, {
|
|
243
|
+
error: `must be the ${what}'s ref, like "instantly:ws_1:abc123" (provider:workspaceId:id), not its name or address`
|
|
244
|
+
});
|
|
245
|
+
var scopeSchema = z.strictObject({
|
|
246
|
+
campaign: ref("campaign").optional(),
|
|
247
|
+
client: z.string({
|
|
248
|
+
error: "must be the client's name as your clients rules give it"
|
|
249
|
+
}).min(1, { error: "must not be empty" }).optional(),
|
|
250
|
+
person: ref("lead").optional(),
|
|
251
|
+
sender: ref("sender").optional()
|
|
252
|
+
});
|
|
253
|
+
var windowSchema = z.strictObject({
|
|
254
|
+
days: z.number({ error: "must be a whole number of days" }).int({ error: "must be a whole number of days" }).min(1, { error: "must be at least 1" }).max(366, { error: "must be at most 366" })
|
|
255
|
+
});
|
|
256
|
+
var needs = (missing, wrong) => (issue) => issue.input === void 0 ? `is required: ${missing}` : wrong;
|
|
257
|
+
var baseSchema = z.strictObject({
|
|
258
|
+
metric: z.enum(METRIC_NAMES, {
|
|
259
|
+
error: needs(
|
|
260
|
+
`the number to check, one of ${METRIC_NAMES.join(", ")}`,
|
|
261
|
+
`must be one of ${METRIC_NAMES.join(", ")}`
|
|
262
|
+
)
|
|
263
|
+
}),
|
|
264
|
+
min_sent: z.number({ error: "must be a whole number of sends" }).int({ error: "must be a whole number of sends" }).min(0, { error: "must be 0 or more" }).optional(),
|
|
265
|
+
name: z.string({ error: "must be a string" }).min(1, { error: "must not be empty" }).optional(),
|
|
266
|
+
op: z.enum(NUMBER_OPS, {
|
|
267
|
+
error: needs(
|
|
268
|
+
`how to compare, one of ${NUMBER_OPS.join(" ")}`,
|
|
269
|
+
`must be one of ${NUMBER_OPS.join(" ")}`
|
|
270
|
+
)
|
|
271
|
+
}),
|
|
272
|
+
scope: scopeSchema.optional(),
|
|
273
|
+
value: z.union([z.number(), z.string()], {
|
|
274
|
+
error: needs(
|
|
275
|
+
"what to compare with, such as 0.03 for a 3% rate",
|
|
276
|
+
"must be a number, or a sender status for sender_status"
|
|
277
|
+
)
|
|
278
|
+
}),
|
|
279
|
+
window: windowSchema.optional()
|
|
280
|
+
});
|
|
281
|
+
var looseCheck = z.object({
|
|
282
|
+
metric: z.enum(METRIC_NAMES),
|
|
283
|
+
min_sent: z.unknown().optional().transform((value) => value !== void 0),
|
|
284
|
+
op: z.string().optional().catch(void 0),
|
|
285
|
+
scope: z.record(z.string(), z.unknown()).optional().catch(void 0),
|
|
286
|
+
value: z.union([
|
|
287
|
+
z.number().transform((value) => ({ kind: "number", value })),
|
|
288
|
+
z.string().transform((value) => ({ kind: "string", value }))
|
|
289
|
+
]).catch({ kind: "none" }),
|
|
290
|
+
window: z.unknown().optional().transform((value) => value !== void 0)
|
|
291
|
+
});
|
|
292
|
+
var statusFits = (given) => given.kind === "none" || given.kind === "string" && STATUSES.has(given.value) ? null : `sender_status compares a status: one of ${senderStatusSchema.options.join(", ")}`;
|
|
293
|
+
var numberFits = (metric, unit, given) => {
|
|
294
|
+
if (given.kind === "string") {
|
|
295
|
+
return `${metric} compares a number, not ${JSON.stringify(given.value)}`;
|
|
296
|
+
}
|
|
297
|
+
if (given.kind === "none") {
|
|
298
|
+
return null;
|
|
299
|
+
}
|
|
300
|
+
const { value } = given;
|
|
301
|
+
if (unit === "rate" && (value < 0 || value > 1)) {
|
|
302
|
+
return value > 1 && value <= 100 ? `${metric} is a fraction from 0 to 1: write ${value / 100} for ${value}%` : `${metric} is a fraction from 0 to 1`;
|
|
303
|
+
}
|
|
304
|
+
return value < 0 ? `${metric} is never below 0` : null;
|
|
305
|
+
};
|
|
306
|
+
var optionIssues = (check, metric) => [
|
|
307
|
+
...check.window && metric.reads !== "stats" ? [
|
|
308
|
+
{
|
|
309
|
+
message: `${check.metric} takes no window: the ${metric.reads} read you pass sets its period`,
|
|
310
|
+
path: ["window"]
|
|
311
|
+
}
|
|
312
|
+
] : [],
|
|
313
|
+
...check.min_sent && metric.unit !== "rate" ? [
|
|
314
|
+
{
|
|
315
|
+
message: "min_sent applies only to bounce_rate and reply_rate",
|
|
316
|
+
path: ["min_sent"]
|
|
317
|
+
}
|
|
318
|
+
] : []
|
|
319
|
+
];
|
|
320
|
+
var fitIssues = (check) => {
|
|
321
|
+
const metric = CHECK_METRICS[check.metric];
|
|
322
|
+
const issues = [];
|
|
323
|
+
const valueIssue = metric.unit === "status" ? statusFits(check.value) : numberFits(check.metric, metric.unit, check.value);
|
|
324
|
+
if (valueIssue !== null) {
|
|
325
|
+
issues.push({ message: valueIssue, path: ["value"] });
|
|
326
|
+
}
|
|
327
|
+
if (metric.unit === "status" && check.op !== void 0 && check.op !== "==" && check.op !== "!=") {
|
|
328
|
+
issues.push({
|
|
329
|
+
message: `sender_status takes == or !=, not ${check.op}`,
|
|
330
|
+
path: ["op"]
|
|
331
|
+
});
|
|
332
|
+
}
|
|
333
|
+
for (const key of Object.keys(check.scope ?? {})) {
|
|
334
|
+
if (key in scopeSchema.shape && !metric.scope.some((each) => each === key)) {
|
|
335
|
+
issues.push({
|
|
336
|
+
message: `${check.metric} cannot be narrowed by ${key}. It takes ${metric.scope.join(", ")}`,
|
|
337
|
+
path: ["scope", key]
|
|
338
|
+
});
|
|
339
|
+
}
|
|
340
|
+
}
|
|
341
|
+
return [...issues, ...optionIssues(check, metric)];
|
|
342
|
+
};
|
|
343
|
+
var checkSchema = baseSchema.superRefine((check, ctx) => {
|
|
344
|
+
for (const issue of fitIssues(looseCheck.parse(check))) {
|
|
345
|
+
ctx.addIssue({
|
|
346
|
+
code: "custom",
|
|
347
|
+
message: issue.message,
|
|
348
|
+
path: [...issue.path]
|
|
349
|
+
});
|
|
350
|
+
}
|
|
351
|
+
});
|
|
352
|
+
|
|
353
|
+
// src/alerts/check-validate.ts
|
|
354
|
+
import { z as z2 } from "zod";
|
|
355
|
+
var KEY_HINTS = /* @__PURE__ */ new Map([
|
|
356
|
+
[
|
|
357
|
+
"",
|
|
358
|
+
/* @__PURE__ */ new Map([
|
|
359
|
+
["days", "window: { days }"],
|
|
360
|
+
["minSent", "min_sent"],
|
|
361
|
+
["operator", "op"],
|
|
362
|
+
["threshold", "value"]
|
|
363
|
+
])
|
|
364
|
+
],
|
|
365
|
+
[
|
|
366
|
+
"scope",
|
|
367
|
+
/* @__PURE__ */ new Map([
|
|
368
|
+
["campaignId", "campaign"],
|
|
369
|
+
["lead", "person"],
|
|
370
|
+
["senderId", "sender"]
|
|
371
|
+
])
|
|
372
|
+
]
|
|
373
|
+
]);
|
|
374
|
+
var unknownKey = (key, where) => {
|
|
375
|
+
const hint = KEY_HINTS.get(where)?.get(key);
|
|
376
|
+
return hint === void 0 ? `${key} is not a check field` : `${key} is not a check field: write ${hint}`;
|
|
377
|
+
};
|
|
378
|
+
var snake = (text) => text.replaceAll(/(?<lower>[a-z])(?<upper>[A-Z])/gu, "$<lower>_$<upper>").replaceAll(/[\s-]+/gu, "_").toLowerCase();
|
|
379
|
+
var written = z2.object({
|
|
380
|
+
metric: z2.string().optional().catch(void 0),
|
|
381
|
+
op: z2.string().optional().catch(void 0)
|
|
382
|
+
}).catch({ metric: void 0, op: void 0 });
|
|
383
|
+
var hintFor = (path, given, message) => {
|
|
384
|
+
const close = given.metric === void 0 ? void 0 : snake(given.metric);
|
|
385
|
+
if (path === "metric" && close !== void 0 && close in CHECK_METRICS) {
|
|
386
|
+
return `${message}. Did you mean ${close}?`;
|
|
387
|
+
}
|
|
388
|
+
const alias = given.op === void 0 ? void 0 : OP_ALIASES.get(given.op);
|
|
389
|
+
return path === "op" && alias !== void 0 ? `${message}. Write ${alias} for ${given.op}` : message;
|
|
390
|
+
};
|
|
391
|
+
var toIssues = (error, given) => error.issues.flatMap((issue) => {
|
|
392
|
+
const where = issue.path.join(".");
|
|
393
|
+
if (issue.code === "unrecognized_keys") {
|
|
394
|
+
return issue.keys.map((key) => ({
|
|
395
|
+
message: unknownKey(key, where),
|
|
396
|
+
path: where === "" ? key : `${where}.${key}`
|
|
397
|
+
}));
|
|
398
|
+
}
|
|
399
|
+
if (where === "" && issue.code === "invalid_type") {
|
|
400
|
+
return [{ message: "a check is a JSON object", path: "" }];
|
|
401
|
+
}
|
|
402
|
+
return [{ message: hintFor(where, given, issue.message), path: where }];
|
|
403
|
+
});
|
|
404
|
+
var validateCheck = (input) => {
|
|
405
|
+
const parsed = baseSchema.safeParse(input);
|
|
406
|
+
const loose = looseCheck.safeParse(input);
|
|
407
|
+
const issues = [
|
|
408
|
+
...parsed.success ? [] : toIssues(parsed.error, written.parse(input)),
|
|
409
|
+
...(loose.success ? fitIssues(loose.data) : []).map((issue) => ({
|
|
410
|
+
message: issue.message,
|
|
411
|
+
path: issue.path.join(".")
|
|
412
|
+
}))
|
|
413
|
+
];
|
|
414
|
+
return parsed.success && issues.length === 0 ? { check: parsed.data, ok: true } : { issues, ok: false };
|
|
415
|
+
};
|
|
416
|
+
var describeIssues = (issues) => issues.map(
|
|
417
|
+
(issue) => issue.path === "" ? issue.message : `${issue.path}: ${issue.message}`
|
|
418
|
+
).join("\n");
|
|
419
|
+
|
|
420
|
+
// src/alerts/check-measure.ts
|
|
421
|
+
import { z as z3 } from "zod";
|
|
422
|
+
var blank = {
|
|
423
|
+
campaign: null,
|
|
424
|
+
day: null,
|
|
425
|
+
person: null,
|
|
426
|
+
sender: null,
|
|
427
|
+
subjectName: null
|
|
428
|
+
};
|
|
429
|
+
var rowReading = (metric, row) => {
|
|
430
|
+
if (metric === "bounce_rate") {
|
|
431
|
+
return {
|
|
432
|
+
numbers: { bounced: row.bounced, sent: row.sent },
|
|
433
|
+
value: computeRates(row).bounceRate.value
|
|
434
|
+
};
|
|
435
|
+
}
|
|
436
|
+
if (metric === "reply_rate") {
|
|
437
|
+
return {
|
|
438
|
+
numbers: {
|
|
439
|
+
contacted: row.contacted,
|
|
440
|
+
replied: row.replied,
|
|
441
|
+
sent: row.sent
|
|
442
|
+
},
|
|
443
|
+
value: computeRates(row).replyRate.value
|
|
444
|
+
};
|
|
445
|
+
}
|
|
446
|
+
return { numbers: { sent: row.sent }, value: row.sent };
|
|
447
|
+
};
|
|
448
|
+
var fromRows = (metric, rows, options) => {
|
|
449
|
+
const inWindow = rows.filter(
|
|
450
|
+
(row) => options.fromDay === null || row.date === null || row.date >= options.fromDay
|
|
451
|
+
);
|
|
452
|
+
const rate = metric !== "sent";
|
|
453
|
+
const measured = inWindow.flatMap((row) => {
|
|
454
|
+
const { numbers, value } = rowReading(metric, row);
|
|
455
|
+
if (value === null || rate && (row.sent ?? 0) < options.minSent) {
|
|
456
|
+
return [];
|
|
457
|
+
}
|
|
458
|
+
return [
|
|
459
|
+
{
|
|
460
|
+
...blank,
|
|
461
|
+
campaign: row.scope === "campaign" ? row.scopeRef : null,
|
|
462
|
+
day: row.date,
|
|
463
|
+
numbers,
|
|
464
|
+
sender: row.scope === "sender" ? row.scopeRef : null,
|
|
465
|
+
subject: row.scopeRef,
|
|
466
|
+
value
|
|
467
|
+
}
|
|
468
|
+
];
|
|
469
|
+
});
|
|
470
|
+
return { measured, skipped: rows.length - measured.length };
|
|
471
|
+
};
|
|
472
|
+
var fromSenders = (senders) => {
|
|
473
|
+
const known = senders.filter((sender) => sender.status !== "unknown");
|
|
474
|
+
return {
|
|
475
|
+
measured: known.map((sender) => ({
|
|
476
|
+
...blank,
|
|
477
|
+
numbers: { status: sender.status },
|
|
478
|
+
sender: sender.ref,
|
|
479
|
+
subject: sender.ref,
|
|
480
|
+
subjectName: sender.address ?? sender.name,
|
|
481
|
+
value: sender.status
|
|
482
|
+
})),
|
|
483
|
+
skipped: senders.length - known.length
|
|
484
|
+
};
|
|
485
|
+
};
|
|
486
|
+
var ref2 = z3.string();
|
|
487
|
+
var maybe = z3.string().nullable();
|
|
488
|
+
var droppedAnswer = z3.object({
|
|
489
|
+
dropped: z3.array(
|
|
490
|
+
z3.object({
|
|
491
|
+
campaign: maybe,
|
|
492
|
+
category: z3.string(),
|
|
493
|
+
email: maybe,
|
|
494
|
+
hoursWaiting: z3.number(),
|
|
495
|
+
lead: maybe,
|
|
496
|
+
linkedinUrl: maybe,
|
|
497
|
+
name: maybe,
|
|
498
|
+
receivedAt: z3.string(),
|
|
499
|
+
reply: ref2,
|
|
500
|
+
unansweredReplies: z3.number()
|
|
501
|
+
})
|
|
502
|
+
),
|
|
503
|
+
olderThanHours: z3.number()
|
|
504
|
+
});
|
|
505
|
+
var forecastAnswer = z3.object({
|
|
506
|
+
campaign: ref2,
|
|
507
|
+
campaignName: z3.string(),
|
|
508
|
+
dailyContactRate: z3.number().nullable(),
|
|
509
|
+
daysLeft: z3.number().nullable(),
|
|
510
|
+
estimate: z3.literal(true),
|
|
511
|
+
remaining: z3.number()
|
|
512
|
+
});
|
|
513
|
+
var suppressionAnswer = z3.object({
|
|
514
|
+
byCampaign: z3.array(
|
|
515
|
+
z3.object({
|
|
516
|
+
campaign: ref2,
|
|
517
|
+
campaignName: z3.string(),
|
|
518
|
+
leadsRead: z3.number(),
|
|
519
|
+
violations: z3.number()
|
|
520
|
+
})
|
|
521
|
+
),
|
|
522
|
+
violations: z3.array(z3.unknown())
|
|
523
|
+
});
|
|
524
|
+
var gapsAnswer = z3.object({
|
|
525
|
+
campaign: ref2,
|
|
526
|
+
totals: z3.object({ leadsRead: z3.number() }),
|
|
527
|
+
unknownVariables: z3.array(z3.string()),
|
|
528
|
+
variables: z3.array(
|
|
529
|
+
z3.object({
|
|
530
|
+
gap: z3.boolean(),
|
|
531
|
+
leadsAffected: z3.number().nullable(),
|
|
532
|
+
leadsWithoutValue: z3.number().nullable(),
|
|
533
|
+
name: z3.string()
|
|
534
|
+
})
|
|
535
|
+
)
|
|
536
|
+
});
|
|
537
|
+
var fromDropped = (data) => ({
|
|
538
|
+
measured: data.dropped.filter((reply) => reply.category === "positive").map((reply) => ({
|
|
539
|
+
...blank,
|
|
540
|
+
campaign: reply.campaign,
|
|
541
|
+
numbers: {
|
|
542
|
+
hoursWaiting: reply.hoursWaiting,
|
|
543
|
+
receivedAt: reply.receivedAt,
|
|
544
|
+
unansweredReplies: reply.unansweredReplies
|
|
545
|
+
},
|
|
546
|
+
person: reply.lead,
|
|
547
|
+
subject: reply.reply,
|
|
548
|
+
subjectName: reply.name ?? reply.email ?? reply.linkedinUrl,
|
|
549
|
+
value: reply.hoursWaiting
|
|
550
|
+
})),
|
|
551
|
+
skipped: 0
|
|
552
|
+
});
|
|
553
|
+
var fromForecast = (data) => data.daysLeft === null ? { measured: [], skipped: 1 } : {
|
|
554
|
+
measured: [
|
|
555
|
+
{
|
|
556
|
+
...blank,
|
|
557
|
+
campaign: data.campaign,
|
|
558
|
+
numbers: {
|
|
559
|
+
dailyContactRate: data.dailyContactRate,
|
|
560
|
+
daysLeft: data.daysLeft,
|
|
561
|
+
remaining: data.remaining
|
|
562
|
+
},
|
|
563
|
+
subject: data.campaign,
|
|
564
|
+
subjectName: data.campaignName,
|
|
565
|
+
value: data.daysLeft
|
|
566
|
+
}
|
|
567
|
+
],
|
|
568
|
+
skipped: 0
|
|
569
|
+
};
|
|
570
|
+
var fromSuppression = (data) => ({
|
|
571
|
+
measured: data.byCampaign.map((each) => ({
|
|
572
|
+
...blank,
|
|
573
|
+
campaign: each.campaign,
|
|
574
|
+
numbers: { leadsRead: each.leadsRead, violations: each.violations },
|
|
575
|
+
subject: each.campaign,
|
|
576
|
+
subjectName: each.campaignName,
|
|
577
|
+
value: each.violations
|
|
578
|
+
})),
|
|
579
|
+
skipped: 0
|
|
580
|
+
});
|
|
581
|
+
var fromGaps = (data) => {
|
|
582
|
+
const broken = data.variables.filter((each) => each.gap);
|
|
583
|
+
const measured = broken.flatMap(
|
|
584
|
+
(each) => each.leadsAffected === null ? [] : [
|
|
585
|
+
{
|
|
586
|
+
...blank,
|
|
587
|
+
campaign: data.campaign,
|
|
588
|
+
numbers: {
|
|
589
|
+
leadsAffected: each.leadsAffected,
|
|
590
|
+
leadsRead: data.totals.leadsRead,
|
|
591
|
+
leadsWithoutValue: each.leadsWithoutValue
|
|
592
|
+
},
|
|
593
|
+
subject: data.campaign,
|
|
594
|
+
subjectName: each.name,
|
|
595
|
+
value: each.leadsAffected
|
|
596
|
+
}
|
|
597
|
+
]
|
|
598
|
+
);
|
|
599
|
+
return { measured, skipped: broken.length - measured.length };
|
|
600
|
+
};
|
|
601
|
+
var insightResult = z3.object({ data: z3.unknown(), insight: z3.string() });
|
|
602
|
+
var measureAnswer = (schema, read, input) => {
|
|
603
|
+
const result = insightResult.safeParse(input);
|
|
604
|
+
const parsed = schema.safeParse(result.success ? result.data.data : input);
|
|
605
|
+
return parsed.success ? read(parsed.data) : null;
|
|
606
|
+
};
|
|
607
|
+
var ANSWERS = {
|
|
608
|
+
droppedReplies: (input) => measureAnswer(droppedAnswer, fromDropped, input),
|
|
609
|
+
personalizationGaps: (input) => measureAnswer(gapsAnswer, fromGaps, input),
|
|
610
|
+
pipelineForecast: (input) => measureAnswer(forecastAnswer, fromForecast, input),
|
|
611
|
+
suppressionCheck: (input) => measureAnswer(suppressionAnswer, fromSuppression, input)
|
|
612
|
+
};
|
|
613
|
+
var listed = z3.union([
|
|
614
|
+
z3.array(z3.unknown()),
|
|
615
|
+
z3.object({ rows: z3.array(z3.unknown()) }).transform((result) => result.rows),
|
|
616
|
+
z3.object({ items: z3.array(z3.unknown()) }).transform((page) => page.items)
|
|
617
|
+
]);
|
|
618
|
+
var parsedAll = (schema, records) => records.flatMap((record) => {
|
|
619
|
+
const parsed = schema.safeParse(record);
|
|
620
|
+
return parsed.success ? [parsed.data] : [];
|
|
621
|
+
});
|
|
622
|
+
var fromRecords = (metric, source, input, options) => {
|
|
623
|
+
const list = listed.safeParse(input);
|
|
624
|
+
const records = list.success ? list.data : [input];
|
|
625
|
+
const rows = source === "stats" ? parsedAll(metricRowSchema, records) : [];
|
|
626
|
+
const senders = source === "senders" ? parsedAll(senderSchema, records) : [];
|
|
627
|
+
if (records.length > 0 && rows.length + senders.length === 0) {
|
|
628
|
+
return {
|
|
629
|
+
ok: false,
|
|
630
|
+
reason: source === "stats" ? `${metric} reads stats rows. Pass the rows a stats() read returned` : `${metric} reads senders. Pass what outbound.senders.list() returned`
|
|
631
|
+
};
|
|
632
|
+
}
|
|
633
|
+
return {
|
|
634
|
+
ok: true,
|
|
635
|
+
readings: source === "stats" ? fromRows(metric, rows, options) : fromSenders(senders)
|
|
636
|
+
};
|
|
637
|
+
};
|
|
638
|
+
var measure = (metric, source, input, options) => {
|
|
639
|
+
if (source === "stats" || source === "senders") {
|
|
640
|
+
return fromRecords(metric, source, input, options);
|
|
641
|
+
}
|
|
642
|
+
const readings = ANSWERS[source](input);
|
|
643
|
+
return readings === null ? {
|
|
644
|
+
ok: false,
|
|
645
|
+
reason: `${metric} reads a ${source} answer. Pass what outbound.insights.${source}() returned`
|
|
646
|
+
} : { ok: true, readings };
|
|
647
|
+
};
|
|
648
|
+
|
|
649
|
+
// src/alerts/check-evaluate.ts
|
|
650
|
+
var DAY_MS = 864e5;
|
|
651
|
+
var DEFAULT_MIN_SENT = 50;
|
|
652
|
+
var OP_WORDS = {
|
|
653
|
+
"!=": "not",
|
|
654
|
+
"<": "below",
|
|
655
|
+
"<=": "at or below",
|
|
656
|
+
"==": "equal to",
|
|
657
|
+
">": "above",
|
|
658
|
+
">=": "at or above"
|
|
659
|
+
};
|
|
660
|
+
var parseCheck = (input) => {
|
|
661
|
+
const validation = validateCheck(input);
|
|
662
|
+
if (!validation.ok) {
|
|
663
|
+
throw new OutboundError(
|
|
664
|
+
"Invalid",
|
|
665
|
+
`The check is not valid:
|
|
666
|
+
${describeIssues(validation.issues)}`
|
|
667
|
+
);
|
|
668
|
+
}
|
|
669
|
+
return validation.check;
|
|
670
|
+
};
|
|
671
|
+
var breaks = (op, value, limit) => {
|
|
672
|
+
switch (op) {
|
|
673
|
+
case "==": {
|
|
674
|
+
return value === limit;
|
|
675
|
+
}
|
|
676
|
+
case "!=": {
|
|
677
|
+
return value !== limit;
|
|
678
|
+
}
|
|
679
|
+
case ">": {
|
|
680
|
+
return value > limit;
|
|
681
|
+
}
|
|
682
|
+
case ">=": {
|
|
683
|
+
return value >= limit;
|
|
684
|
+
}
|
|
685
|
+
case "<": {
|
|
686
|
+
return value < limit;
|
|
687
|
+
}
|
|
688
|
+
default: {
|
|
689
|
+
return value <= limit;
|
|
690
|
+
}
|
|
691
|
+
}
|
|
692
|
+
};
|
|
693
|
+
var shown = (metric, value) => {
|
|
694
|
+
if (metric.unit === "status") {
|
|
695
|
+
return String(value);
|
|
696
|
+
}
|
|
697
|
+
const amount = Number(value);
|
|
698
|
+
if (metric.unit === "rate") {
|
|
699
|
+
return percentOf(amount);
|
|
700
|
+
}
|
|
701
|
+
const rounded = String(Math.round(amount * 10) / 10);
|
|
702
|
+
return metric.unit === "count" ? rounded : `${rounded} ${metric.unit}`;
|
|
703
|
+
};
|
|
704
|
+
var inScope = (check, reading) => {
|
|
705
|
+
const { campaign, person, sender } = check.scope ?? {};
|
|
706
|
+
return (campaign === void 0 || reading.campaign === campaign) && (sender === void 0 || reading.sender === sender) && (person === void 0 || reading.person === person);
|
|
707
|
+
};
|
|
708
|
+
var fromDayOf = (check, now) => {
|
|
709
|
+
if (check.window === void 0) {
|
|
710
|
+
return null;
|
|
711
|
+
}
|
|
712
|
+
const end = new Date(now ?? Date.now()).getTime();
|
|
713
|
+
if (Number.isNaN(end)) {
|
|
714
|
+
throw new OutboundError(
|
|
715
|
+
"Invalid",
|
|
716
|
+
`now is not a date: ${String(now)}. Pass a Date, milliseconds or an ISO 8601 string`
|
|
717
|
+
);
|
|
718
|
+
}
|
|
719
|
+
return new Date(end - (check.window.days - 1) * DAY_MS).toISOString().slice(0, 10);
|
|
720
|
+
};
|
|
721
|
+
var notChecked = (name, reason) => ({
|
|
722
|
+
breaches: [],
|
|
723
|
+
check: name,
|
|
724
|
+
checked: 0,
|
|
725
|
+
reason,
|
|
726
|
+
skipped: 0,
|
|
727
|
+
status: "not_checked"
|
|
728
|
+
});
|
|
729
|
+
var clientMismatch = (check, client) => {
|
|
730
|
+
const wanted = check.scope?.client;
|
|
731
|
+
if (wanted === void 0 || wanted === client) {
|
|
732
|
+
return null;
|
|
733
|
+
}
|
|
734
|
+
return client === void 0 ? `The check is scoped to client "${wanted}". Pass { client: "${wanted}" } with that client's read` : `The check is scoped to client "${wanted}", and this read is "${client}"'s`;
|
|
735
|
+
};
|
|
736
|
+
var evaluateCheck = (input, read, options = {}) => {
|
|
737
|
+
const check = parseCheck(input);
|
|
738
|
+
const name = check.name ?? check.metric;
|
|
739
|
+
const metric = CHECK_METRICS[check.metric];
|
|
740
|
+
const mismatch = clientMismatch(check, options.client);
|
|
741
|
+
if (mismatch !== null) {
|
|
742
|
+
return notChecked(name, mismatch);
|
|
743
|
+
}
|
|
744
|
+
const readings = measure(check.metric, metric.reads, read, {
|
|
745
|
+
fromDay: fromDayOf(check, options.now),
|
|
746
|
+
minSent: check.min_sent ?? DEFAULT_MIN_SENT
|
|
747
|
+
});
|
|
748
|
+
if (!readings.ok) {
|
|
749
|
+
return notChecked(name, readings.reason);
|
|
750
|
+
}
|
|
751
|
+
const measured = readings.readings.measured.filter(
|
|
752
|
+
(reading) => inScope(check, reading)
|
|
753
|
+
);
|
|
754
|
+
const breaches = measured.filter((reading) => breaks(check.op, reading.value, check.value)).map((reading) => ({
|
|
755
|
+
day: reading.day,
|
|
756
|
+
message: `${check.metric} is ${shown(metric, reading.value)}, ${OP_WORDS[check.op]} ${shown(metric, check.value)}`,
|
|
757
|
+
metric: check.metric,
|
|
758
|
+
numbers: reading.numbers,
|
|
759
|
+
op: check.op,
|
|
760
|
+
rule: name,
|
|
761
|
+
subject: reading.subject,
|
|
762
|
+
subjectName: reading.subjectName,
|
|
763
|
+
threshold: check.value,
|
|
764
|
+
value: reading.value
|
|
765
|
+
}));
|
|
766
|
+
return {
|
|
767
|
+
breaches,
|
|
768
|
+
check: name,
|
|
769
|
+
checked: measured.length,
|
|
770
|
+
reason: null,
|
|
771
|
+
skipped: readings.readings.skipped,
|
|
772
|
+
status: breaches.length > 0 ? "fail" : "pass"
|
|
773
|
+
};
|
|
774
|
+
};
|
|
775
|
+
var checkRule = (input, options = {}) => {
|
|
776
|
+
const check = parseCheck(input);
|
|
777
|
+
const { reads } = CHECK_METRICS[check.metric];
|
|
778
|
+
if (reads !== "stats" && reads !== "senders") {
|
|
779
|
+
throw new OutboundError(
|
|
780
|
+
"Invalid",
|
|
781
|
+
`${check.metric} reads a ${reads} answer, not records, so it cannot be an alert rule. Call evaluateCheck(check, await outbound.insights.${reads}(...)) instead`
|
|
782
|
+
);
|
|
783
|
+
}
|
|
784
|
+
return {
|
|
785
|
+
check: (record) => evaluateCheck(check, record, options).breaches[0] ?? null,
|
|
786
|
+
name: check.name ?? check.metric,
|
|
787
|
+
state: reads === "senders"
|
|
788
|
+
};
|
|
789
|
+
};
|
|
133
790
|
export {
|
|
791
|
+
CHECK_METRICS,
|
|
134
792
|
alerts,
|
|
135
793
|
bounceRateAbove,
|
|
794
|
+
checkRule,
|
|
795
|
+
checkSchema,
|
|
796
|
+
describeIssues,
|
|
797
|
+
evaluateCheck,
|
|
136
798
|
memoryAlertDedupe,
|
|
137
799
|
noSends,
|
|
800
|
+
parseCheck,
|
|
138
801
|
replyRateBelow,
|
|
139
|
-
senderNotActive
|
|
802
|
+
senderNotActive,
|
|
803
|
+
validateCheck
|
|
140
804
|
};
|