@aranova/tracking-next 0.27.0 → 1.1.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 (73) hide show
  1. package/dist/blog-server.d.mts +2 -1
  2. package/dist/blog-server.d.ts +2 -1
  3. package/dist/blog-server.js +121 -98
  4. package/dist/blog-server.js.map +1 -1
  5. package/dist/blog-server.mjs +86 -63
  6. package/dist/blog-server.mjs.map +1 -1
  7. package/dist/blog.d.mts +651 -1755
  8. package/dist/blog.d.ts +651 -1755
  9. package/dist/blog.js +121 -98
  10. package/dist/blog.js.map +1 -1
  11. package/dist/blog.mjs +86 -63
  12. package/dist/blog.mjs.map +1 -1
  13. package/dist/calendar-server.d.mts +2 -2
  14. package/dist/calendar-server.d.ts +2 -2
  15. package/dist/calendar-server.js +0 -26
  16. package/dist/calendar-server.js.map +1 -1
  17. package/dist/calendar-server.mjs +0 -26
  18. package/dist/calendar-server.mjs.map +1 -1
  19. package/dist/calendar.d.mts +3 -3
  20. package/dist/calendar.d.ts +3 -3
  21. package/dist/calendar.js +227 -126
  22. package/dist/calendar.js.map +1 -1
  23. package/dist/calendar.mjs +216 -125
  24. package/dist/calendar.mjs.map +1 -1
  25. package/dist/client.d.mts +11 -4
  26. package/dist/client.d.ts +11 -4
  27. package/dist/client.js +611 -347
  28. package/dist/client.js.map +1 -1
  29. package/dist/client.mjs +611 -347
  30. package/dist/client.mjs.map +1 -1
  31. package/dist/index.d.mts +9 -8
  32. package/dist/index.d.ts +9 -8
  33. package/dist/index.js +550 -487
  34. package/dist/index.js.map +1 -1
  35. package/dist/index.mjs +539 -487
  36. package/dist/index.mjs.map +1 -1
  37. package/dist/ingest-typed-MBuMe9Pn.d.ts +883 -0
  38. package/dist/ingest-typed-UA13xTfI.d.mts +883 -0
  39. package/dist/middleware.js +0 -467
  40. package/dist/middleware.js.map +1 -1
  41. package/dist/middleware.mjs +0 -467
  42. package/dist/middleware.mjs.map +1 -1
  43. package/dist/{phone-utils-BVzSNBf1.d.mts → phone-utils-C0ds6cqZ.d.mts} +24 -78
  44. package/dist/{phone-utils-BVzSNBf1.d.ts → phone-utils-C0ds6cqZ.d.ts} +24 -78
  45. package/dist/phone.d.mts +2 -2
  46. package/dist/phone.d.ts +2 -2
  47. package/dist/phone.js +0 -464
  48. package/dist/phone.js.map +1 -1
  49. package/dist/phone.mjs +0 -464
  50. package/dist/phone.mjs.map +1 -1
  51. package/dist/{sales-IGC2tq4J.d.ts → sales-DQC815f3.d.ts} +90 -329
  52. package/dist/{sales-DQGzXSgL.d.mts → sales-w1reW_Y3.d.mts} +90 -329
  53. package/dist/sales.d.mts +3 -3
  54. package/dist/sales.d.ts +3 -3
  55. package/dist/sales.js +270 -127
  56. package/dist/sales.js.map +1 -1
  57. package/dist/sales.mjs +259 -127
  58. package/dist/sales.mjs.map +1 -1
  59. package/dist/server.d.mts +2 -2
  60. package/dist/server.d.ts +2 -2
  61. package/dist/server.js +0 -467
  62. package/dist/server.js.map +1 -1
  63. package/dist/server.mjs +0 -467
  64. package/dist/server.mjs.map +1 -1
  65. package/dist/{tracking-config-runtime-D7prdTE1.d.mts → tracking-config-runtime-C6H7ofmo.d.mts} +6 -0
  66. package/dist/{tracking-config-runtime-D7prdTE1.d.ts → tracking-config-runtime-C6H7ofmo.d.ts} +6 -0
  67. package/dist/transport-CDmGOiCq.d.ts +253 -0
  68. package/dist/transport-I_cMSFQ6.d.mts +253 -0
  69. package/package.json +2 -2
  70. package/dist/ingest-typed-BxLFlZ7N.d.mts +0 -1371
  71. package/dist/ingest-typed-ByQVRMvP.d.ts +0 -1371
  72. package/dist/transport-C-_rFSR4.d.ts +0 -721
  73. package/dist/transport-yUF5Wize.d.mts +0 -721
@@ -2,9 +2,6 @@
2
2
  import "server-only";
3
3
  import { NextResponse } from "next/server";
4
4
 
5
- // ../tracking-core/src/phone.ts
6
- import { AsYouType, parsePhoneNumberFromString } from "libphonenumber-js";
7
-
8
5
  // ../tracking-core/src/tracking.ts
9
6
  var TRACKING_PARAM_KEYS = [
10
7
  "gclid",
@@ -32,470 +29,6 @@ function getTrackingQueryValues(searchParams) {
32
29
  }, {});
33
30
  }
34
31
 
35
- // ../tracking-core/src/resources/tracking-config-runtime.ts
36
- var RETRY_MAX_MS = 5 * 6e4;
37
-
38
- // ../tracking-core/src/session.ts
39
- var SESSION_IDLE_MS = 30 * 60 * 1e3;
40
-
41
- // ../tracking-core/src/events/page-view.ts
42
- import { z } from "zod";
43
- var pageViewMetadataSchema = z.object({
44
- page: z.object({
45
- title: z.string().nullable(),
46
- path: z.string(),
47
- search: z.string(),
48
- hash: z.string()
49
- }).strict(),
50
- referrer: z.string().nullable(),
51
- // `.nullable().optional()` — absent (undefined) OR explicit null OR a
52
- // real viewport object. Mirrors Pydantic's `_Viewport | None = None`
53
- // on the backend side so the drift test stays clean.
54
- viewport: z.object({
55
- w: z.number(),
56
- h: z.number()
57
- }).strict().nullable().optional()
58
- }).strict();
59
- var pageViewConfigSchema = z.object({}).strict();
60
-
61
- // ../tracking-core/src/events/cta-click.ts
62
- import { z as z2 } from "zod";
63
- var ctaClickMetadataSchema = z2.object({
64
- cta_name: z2.string(),
65
- page: z2.object({
66
- path: z2.string()
67
- }).strict(),
68
- section: z2.string().nullable().optional(),
69
- destination_url: z2.string().nullable().optional(),
70
- // Set by auto-capture (and available to manual callers): the link target
71
- // and a short element descriptor (tag#id) for tying clicks to specific UI.
72
- href: z2.string().nullable().optional(),
73
- element: z2.string().nullable().optional()
74
- }).strict();
75
- var ctaClickConfigSchema = z2.object({
76
- autoCapture: z2.object({
77
- selector: z2.string().optional()
78
- }).strict().optional()
79
- }).strict();
80
-
81
- // ../tracking-core/src/events/sdk-heartbeat.ts
82
- import { z as z3 } from "zod";
83
- var sdkHeartbeatTriggersSchema = z3.object({
84
- automatic: z3.array(z3.string()),
85
- manual: z3.array(z3.string())
86
- }).strict();
87
- var sdkHeartbeatMetadataSchema = z3.object({
88
- sdk_version: z3.string(),
89
- package_name: z3.string().nullable(),
90
- surface: z3.enum(["next", "react", "script"]),
91
- triggers: sdkHeartbeatTriggersSchema,
92
- trigger_config: z3.record(z3.string(), z3.record(z3.string(), z3.unknown())).nullable().optional(),
93
- configured_gtag_ids: z3.record(z3.string(), z3.string()).nullable().optional(),
94
- // Site whose config object the SDK resolves; null on a legacy business ref.
95
- config_site_id: z3.string().uuid().nullable().optional()
96
- }).strict();
97
- var sdkHeartbeatConfigSchema = z3.object({}).strict();
98
-
99
- // ../tracking-core/src/events/form-start.ts
100
- import { z as z4 } from "zod";
101
- var formStartMetadataSchema = z4.object({
102
- form: z4.object({
103
- id: z4.string(),
104
- action: z4.string().nullable()
105
- }).strict(),
106
- page: z4.object({
107
- path: z4.string()
108
- }).strict()
109
- }).strict();
110
- var formStartConfigSchema = z4.object({
111
- selector: z4.string().optional()
112
- }).strict();
113
-
114
- // ../tracking-core/src/events/form-submit.ts
115
- import { z as z5 } from "zod";
116
- var jsonValueSchema = z5.lazy(
117
- () => z5.union([
118
- z5.string(),
119
- z5.number().finite(),
120
- z5.boolean(),
121
- z5.null(),
122
- z5.array(jsonValueSchema),
123
- z5.record(jsonValueSchema)
124
- ])
125
- );
126
- var formSubmitMetadataSchema = z5.object({
127
- form: z5.object({
128
- id: z5.string(),
129
- action: z5.string().nullable(),
130
- fields: z5.array(
131
- z5.object({
132
- name: z5.string(),
133
- type: z5.string(),
134
- label: z5.string().nullable(),
135
- value: jsonValueSchema
136
- }).strict()
137
- ).optional()
138
- }).strict(),
139
- page: z5.object({
140
- path: z5.string()
141
- }).strict()
142
- }).strict();
143
- var formSubmitConfigSchema = z5.object({}).strict();
144
-
145
- // ../tracking-core/src/events/multi-page-session.ts
146
- import { z as z6 } from "zod";
147
- var multiPageSessionMetadataSchema = z6.object({
148
- page_count: z6.number().int().min(2),
149
- page: z6.object({
150
- path: z6.string()
151
- }).strict()
152
- }).strict();
153
- var multiPageSessionConfigSchema = z6.object({
154
- pageThreshold: z6.number().int().min(2)
155
- }).strict();
156
-
157
- // ../tracking-core/src/events/page-exit.ts
158
- import { z as z7 } from "zod";
159
- var pageExitMetadataSchema = z7.object({
160
- dwell_ms: z7.number().int().min(0),
161
- // null = left without any scroll signal; floor is 0 so a valid 0% is never
162
- // rejected (a single bad field 422s the whole keepalive beacon batch).
163
- max_scroll_percent: z7.number().int().min(0).max(100).nullable(),
164
- // The gating baseline: the fraction of the page visible at load with
165
- // zero scrolling — or, for pages that grew after the post-paint snapshot
166
- // (skeleton/streaming renders), the first-scroll position that
167
- // established it. null = page had no scrollable range, or the segment
168
- // ended before the snapshot. `.optional()` is load-bearing: SDK builds
169
- // predating this field keep POSTing page_exit without the key —
170
- // requiring it would 422 whole keepalive beacon batches.
171
- scroll_baseline_percent: z7.number().int().min(0).max(100).nullable().optional(),
172
- page: z7.object({
173
- path: z7.string()
174
- }).strict()
175
- }).strict();
176
- var pageExitConfigSchema = z7.object({}).strict();
177
-
178
- // ../tracking-core/src/events/phone-click.ts
179
- import { z as z8 } from "zod";
180
- var phoneClickMetadataSchema = z8.object({
181
- phone_number: z8.string(),
182
- page: z8.object({
183
- path: z8.string()
184
- }).strict(),
185
- section: z8.string().nullable().optional()
186
- }).strict();
187
- var phoneClickConfigSchema = z8.object({
188
- autoCapture: z8.object({
189
- selector: z8.string().optional()
190
- }).strict().optional()
191
- }).strict();
192
-
193
- // ../tracking-core/src/events/scroll-depth.ts
194
- import { z as z9 } from "zod";
195
- var scrollDepthMetadataSchema = z9.object({
196
- depth_percent: z9.number().int().min(1).max(100),
197
- page: z9.object({
198
- path: z9.string()
199
- }).strict()
200
- }).strict();
201
- var scrollDepthConfigSchema = z9.object({
202
- thresholds: z9.array(z9.number().int().min(1).max(100)).min(1)
203
- }).strict();
204
-
205
- // ../tracking-core/src/events/specific-page-visit.ts
206
- import { z as z10 } from "zod";
207
- var PAGE_IDENTITY_MAX_LENGTH = 64;
208
- var PAGE_IDENTITY_PATTERN = /^[a-z][a-z0-9]*(?:_[a-z0-9]+)*$/;
209
- var pageIdentitySchema = z10.string().max(PAGE_IDENTITY_MAX_LENGTH).regex(PAGE_IDENTITY_PATTERN, {
210
- message: "page identity must be lowercase snake_case, start with a letter, and contain at most 64 characters"
211
- });
212
- var specificPageNameSchema = pageIdentitySchema;
213
- var specificPageVisitMetadataSchema = z10.object({
214
- page_name: specificPageNameSchema,
215
- page: z10.object({
216
- path: z10.string()
217
- }).strict()
218
- }).strict();
219
- var specificPageVisitConfigSchema = z10.object({
220
- pages: z10.array(
221
- z10.object({
222
- name: specificPageNameSchema,
223
- pathPattern: z10.custom((value) => value instanceof RegExp, {
224
- message: "pathPattern must be a RegExp"
225
- })
226
- }).strict()
227
- ).min(1)
228
- }).strict();
229
-
230
- // ../tracking-core/src/events/time-on-site.ts
231
- import { z as z11 } from "zod";
232
- var timeOnSiteMetadataSchema = z11.object({
233
- duration_ms: z11.number().int().nonnegative(),
234
- page: z11.object({
235
- path: z11.string()
236
- }).strict()
237
- }).strict();
238
- var timeOnSiteConfigSchema = z11.object({
239
- thresholdSeconds: z11.number().int().positive()
240
- }).strict();
241
-
242
- // ../tracking-core/src/events/semantics.ts
243
- var EVENT_SEMANTICS = {
244
- page_view: {
245
- label: "Page view",
246
- category: "page",
247
- outcomeRole: "navigation",
248
- clientVisibility: "simple"
249
- },
250
- time_on_site: {
251
- label: "Time on site",
252
- category: "engagement",
253
- outcomeRole: "engagement",
254
- clientVisibility: "detailed"
255
- },
256
- specific_page_visit: {
257
- label: "Key page visit",
258
- category: "engagement",
259
- outcomeRole: "engagement",
260
- clientVisibility: "detailed"
261
- },
262
- scroll_depth: {
263
- label: "Scroll depth",
264
- category: "engagement",
265
- outcomeRole: "engagement",
266
- clientVisibility: "detailed"
267
- },
268
- multi_page_session: {
269
- label: "Multi-page session",
270
- category: "engagement",
271
- outcomeRole: "engagement",
272
- clientVisibility: "detailed"
273
- },
274
- form_start: {
275
- label: "Form started",
276
- category: "engagement",
277
- outcomeRole: "engagement",
278
- clientVisibility: "simple"
279
- },
280
- sdk_heartbeat: {
281
- label: "SDK heartbeat",
282
- category: "system",
283
- outcomeRole: "diagnostic",
284
- clientVisibility: "hidden"
285
- },
286
- page_exit: {
287
- label: "Page exit",
288
- category: "engagement",
289
- outcomeRole: "diagnostic",
290
- clientVisibility: "detailed"
291
- },
292
- form_submit: {
293
- label: "Form submitted",
294
- category: "lead",
295
- outcomeRole: "lead",
296
- clientVisibility: "simple"
297
- },
298
- phone_click: {
299
- label: "Phone click",
300
- category: "lead",
301
- outcomeRole: "lead",
302
- clientVisibility: "simple"
303
- },
304
- cta_click: {
305
- label: "CTA click",
306
- category: "engagement",
307
- outcomeRole: "engagement",
308
- clientVisibility: "simple"
309
- }
310
- };
311
-
312
- // ../tracking-core/src/events/registry.ts
313
- var EVENT_REGISTRY = {
314
- // --- automatic triggers ---
315
- page_view: {
316
- kind: "automatic",
317
- semantics: EVENT_SEMANTICS.page_view,
318
- metadataSchema: pageViewMetadataSchema,
319
- configSchema: pageViewConfigSchema
320
- },
321
- time_on_site: {
322
- kind: "automatic",
323
- semantics: EVENT_SEMANTICS.time_on_site,
324
- metadataSchema: timeOnSiteMetadataSchema,
325
- configSchema: timeOnSiteConfigSchema
326
- },
327
- specific_page_visit: {
328
- kind: "automatic",
329
- semantics: EVENT_SEMANTICS.specific_page_visit,
330
- metadataSchema: specificPageVisitMetadataSchema,
331
- configSchema: specificPageVisitConfigSchema
332
- },
333
- scroll_depth: {
334
- kind: "automatic",
335
- semantics: EVENT_SEMANTICS.scroll_depth,
336
- metadataSchema: scrollDepthMetadataSchema,
337
- configSchema: scrollDepthConfigSchema
338
- },
339
- multi_page_session: {
340
- kind: "automatic",
341
- semantics: EVENT_SEMANTICS.multi_page_session,
342
- metadataSchema: multiPageSessionMetadataSchema,
343
- configSchema: multiPageSessionConfigSchema
344
- },
345
- form_start: {
346
- kind: "automatic",
347
- semantics: EVENT_SEMANTICS.form_start,
348
- metadataSchema: formStartMetadataSchema,
349
- configSchema: formStartConfigSchema
350
- },
351
- // --- SDK-internal automatic (not consumer-configurable) ---
352
- sdk_heartbeat: {
353
- kind: "automatic",
354
- semantics: EVENT_SEMANTICS.sdk_heartbeat,
355
- metadataSchema: sdkHeartbeatMetadataSchema,
356
- configSchema: sdkHeartbeatConfigSchema
357
- },
358
- page_exit: {
359
- kind: "automatic",
360
- semantics: EVENT_SEMANTICS.page_exit,
361
- metadataSchema: pageExitMetadataSchema,
362
- configSchema: pageExitConfigSchema
363
- },
364
- // --- manual triggers ---
365
- form_submit: {
366
- kind: "manual",
367
- semantics: EVENT_SEMANTICS.form_submit,
368
- metadataSchema: formSubmitMetadataSchema,
369
- configSchema: formSubmitConfigSchema
370
- },
371
- phone_click: {
372
- kind: "manual",
373
- semantics: EVENT_SEMANTICS.phone_click,
374
- metadataSchema: phoneClickMetadataSchema,
375
- configSchema: phoneClickConfigSchema
376
- },
377
- cta_click: {
378
- kind: "manual",
379
- semantics: EVENT_SEMANTICS.cta_click,
380
- metadataSchema: ctaClickMetadataSchema,
381
- configSchema: ctaClickConfigSchema
382
- }
383
- };
384
- var ALL_AUTOMATIC_EVENT_NAMES = Object.entries(EVENT_REGISTRY).filter(([, def]) => def.kind === "automatic").map(([name]) => name);
385
- var ALL_MANUAL_EVENT_NAMES = Object.entries(EVENT_REGISTRY).filter(([, def]) => def.kind === "manual").map(([name]) => name);
386
- var ALL_LEAD_EVENT_NAMES = Object.entries(EVENT_REGISTRY).filter(([, def]) => def.semantics.outcomeRole === "lead").map(([name]) => name);
387
-
388
- // ../tracking-core/src/resources/sales/schema.ts
389
- import { z as z12 } from "zod";
390
- var SUPPORTED_CURRENCIES = ["USD", "CAD"];
391
- var TRACKING_ENVIRONMENTS = ["production", "development"];
392
- var currencySchema = z12.enum(SUPPORTED_CURRENCIES);
393
- var centsSchema = z12.number().int().nonnegative();
394
- var quantitySchema = z12.string().regex(/^\d+(\.\d{1,3})?$/);
395
- var metadataSchema = z12.record(z12.unknown());
396
- var saleItemSchema = z12.object({
397
- external_item_id: z12.string().nullable().optional(),
398
- name: z12.string().nullable().optional(),
399
- category: z12.string().nullable().optional(),
400
- quantity: quantitySchema,
401
- unit_price_cents: centsSchema,
402
- // Non-negativity validated on the wire — same contract as the other cents
403
- // fields — and backstopped by the DB CHECK.
404
- unit_cost_cents: centsSchema.nullable().optional()
405
- }).strict();
406
- var saleServiceSchema = z12.object({
407
- service: z12.string(),
408
- amount_cents: centsSchema
409
- }).strict();
410
- var customerNameSchema = z12.string().max(200);
411
- var customerPhoneSchema = z12.string().max(64);
412
- var customerEmailSchema = z12.string().max(320).email();
413
- function refineServiceXor(val, ctx, { requireAmount }) {
414
- if (val.services != null) {
415
- if (val.service != null) {
416
- ctx.addIssue({
417
- code: z12.ZodIssueCode.custom,
418
- message: "pass either `service` or `services`, not both",
419
- path: ["services"]
420
- });
421
- }
422
- if (val.services.length === 0) {
423
- ctx.addIssue({
424
- code: z12.ZodIssueCode.custom,
425
- message: "`services` must not be empty",
426
- path: ["services"]
427
- });
428
- }
429
- const keys = val.services.map((s) => s.service);
430
- if (new Set(keys).size !== keys.length) {
431
- ctx.addIssue({
432
- code: z12.ZodIssueCode.custom,
433
- message: "`services` must not list the same service more than once",
434
- path: ["services"]
435
- });
436
- }
437
- if (val.amount_total_cents != null) {
438
- const sum = val.services.reduce((acc, s) => acc + s.amount_cents, 0);
439
- if (val.amount_total_cents !== sum) {
440
- ctx.addIssue({
441
- code: z12.ZodIssueCode.custom,
442
- message: "amount_total_cents must equal the sum of the services amounts (omit it to derive it automatically)",
443
- path: ["amount_total_cents"]
444
- });
445
- }
446
- }
447
- } else if (requireAmount && val.amount_total_cents == null) {
448
- ctx.addIssue({
449
- code: z12.ZodIssueCode.custom,
450
- message: "amount_total_cents is required unless `services` is provided",
451
- path: ["amount_total_cents"]
452
- });
453
- }
454
- }
455
- var saleCreateSchema = z12.object({
456
- external_id: z12.string().nullable().optional(),
457
- description: z12.string().nullable().optional(),
458
- service: z12.string().nullable().optional(),
459
- services: z12.array(saleServiceSchema).nullable().optional(),
460
- currency: currencySchema,
461
- // Optional only because the plural `services` form derives it from the sum
462
- // (see refineServiceXor); the singular/serviceless path still requires it.
463
- amount_total_cents: centsSchema.nullable().optional(),
464
- occurred_at: z12.string().datetime(),
465
- environment: z12.enum(TRACKING_ENVIRONMENTS).default("production"),
466
- items: z12.array(saleItemSchema).default([]),
467
- metadata: metadataSchema.nullable().optional(),
468
- customer_name: customerNameSchema.nullable().optional(),
469
- customer_phone: customerPhoneSchema.nullable().optional(),
470
- customer_email: customerEmailSchema.nullable().optional(),
471
- // CASL consent attestation: the customer agreed to receive SMS. Recorded
472
- // with a timestamp server-side; every SMS send path gates on it.
473
- //
474
- // Tri-state: omit it (or send null) to let the server apply the business's
475
- // configured default-opt-in policy, honouring a returning customer's
476
- // remembered preference. Send an explicit boolean to assert consent state
477
- // yourself — `false` records a deliberate opt-out.
478
- sms_consent: z12.boolean().nullable().optional()
479
- }).strict().superRefine((val, ctx) => refineServiceXor(val, ctx, { requireAmount: true }));
480
- var saleUpdateSchema = z12.object({
481
- description: z12.string().nullable().optional(),
482
- service: z12.string().nullable().optional(),
483
- services: z12.array(saleServiceSchema).nullable().optional(),
484
- currency: currencySchema.optional(),
485
- amount_total_cents: centsSchema.optional(),
486
- occurred_at: z12.string().datetime().optional(),
487
- items: z12.array(saleItemSchema).optional(),
488
- metadata: metadataSchema.nullable().optional(),
489
- customer_name: customerNameSchema.nullable().optional(),
490
- // Re-attest when changing a filler-looking name; the server clears the
491
- // prior attestation whenever `customer_name` changes.
492
- customer_name_placeholder_confirmed: z12.boolean().optional(),
493
- customer_phone: customerPhoneSchema.nullable().optional(),
494
- customer_email: customerEmailSchema.nullable().optional(),
495
- // NOT NULL server-side: omit to leave unchanged (explicit null is rejected).
496
- sms_consent: z12.boolean().optional()
497
- }).strict().superRefine((val, ctx) => refineServiceXor(val, ctx, { requireAmount: false }));
498
-
499
32
  // src/middleware.ts
500
33
  function createTrackingMiddleware() {
501
34
  return (request) => {