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