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