@aranova/tracking-react 1.2.2 → 1.2.3

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.
@@ -77,7 +77,8 @@ type SdkHeartbeatConfig = z.infer<typeof sdkHeartbeatConfigSchema>;
77
77
  /**
78
78
  * Metadata for the automatic `form_start` event.
79
79
  *
80
- * The SDK emits this once per form when the visitor first focuses a field.
80
+ * The SDK emits this once per form when the visitor first focuses or taps
81
+ * anything inside it.
81
82
  */
82
83
  declare const formStartMetadataSchema: z.ZodMiniObject<{
83
84
  form: z.ZodMiniObject<{
@@ -100,6 +101,40 @@ declare const formStartConfigSchema: z.ZodMiniObject<{
100
101
  }, z.core.$strict>;
101
102
  type FormStartConfig = z.infer<typeof formStartConfigSchema>;
102
103
 
104
+ /**
105
+ * Metadata for a manually fired `form_step` event.
106
+ *
107
+ * `form.id` must equal `form_start`/`form_submit`'s id. See
108
+ * docs/tracking-package/installing.md#multi-step-forms-form_step for the emit rule and an example.
109
+ */
110
+ declare const formStepMetadataSchema: z.ZodMiniObject<{
111
+ form: z.ZodMiniObject<{
112
+ id: z.ZodMiniString<string>;
113
+ action: z.ZodMiniNullable<z.ZodMiniString<string>>;
114
+ }, z.core.$strict>;
115
+ step: z.ZodMiniObject<{
116
+ id: z.ZodMiniString<string>;
117
+ index: z.ZodMiniInt;
118
+ total: z.ZodMiniNullable<z.ZodMiniInt>;
119
+ }, z.core.$strict>;
120
+ direction: z.ZodMiniEnum<{
121
+ forward: "forward";
122
+ back: "back";
123
+ }>;
124
+ page: z.ZodMiniObject<{
125
+ path: z.ZodMiniString<string>;
126
+ }, z.core.$strict>;
127
+ }, z.core.$strict>;
128
+ type FormStepMetadata = z.infer<typeof formStepMetadataSchema>;
129
+ /**
130
+ * Registration config for `form_step`.
131
+ *
132
+ * Manual-only with no options; the empty object enables typed
133
+ * `trackEvent('form_step', ...)` calls.
134
+ */
135
+ declare const formStepConfigSchema: z.ZodMiniObject<{}, z.core.$strict>;
136
+ type FormStepConfig = z.infer<typeof formStepConfigSchema>;
137
+
103
138
  /**
104
139
  * Metadata for the automatic `multi_page_session` event.
105
140
  *
@@ -388,6 +423,12 @@ declare const EVENT_SEMANTICS: {
388
423
  readonly outcomeRole: "diagnostic";
389
424
  readonly clientVisibility: "detailed";
390
425
  };
426
+ readonly form_step: {
427
+ readonly label: "Form step";
428
+ readonly category: "engagement";
429
+ readonly outcomeRole: "engagement";
430
+ readonly clientVisibility: "detailed";
431
+ };
391
432
  readonly form_submit: {
392
433
  readonly label: "Form submitted";
393
434
  readonly category: "lead";
@@ -653,6 +694,34 @@ declare const EVENT_REGISTRY: {
653
694
  }, zod_v4_core.$strict>;
654
695
  readonly configSchema: z.ZodMiniObject<{}, zod_v4_core.$strict>;
655
696
  };
697
+ readonly form_step: {
698
+ readonly kind: "manual";
699
+ readonly semantics: {
700
+ readonly label: "Form step";
701
+ readonly category: "engagement";
702
+ readonly outcomeRole: "engagement";
703
+ readonly clientVisibility: "detailed";
704
+ };
705
+ readonly metadataSchema: z.ZodMiniObject<{
706
+ form: z.ZodMiniObject<{
707
+ id: z.ZodMiniString<string>;
708
+ action: z.ZodMiniNullable<z.ZodMiniString<string>>;
709
+ }, zod_v4_core.$strict>;
710
+ step: z.ZodMiniObject<{
711
+ id: z.ZodMiniString<string>;
712
+ index: z.ZodMiniInt;
713
+ total: z.ZodMiniNullable<z.ZodMiniInt>;
714
+ }, zod_v4_core.$strict>;
715
+ direction: z.ZodMiniEnum<{
716
+ forward: "forward";
717
+ back: "back";
718
+ }>;
719
+ page: z.ZodMiniObject<{
720
+ path: z.ZodMiniString<string>;
721
+ }, zod_v4_core.$strict>;
722
+ }, zod_v4_core.$strict>;
723
+ readonly configSchema: z.ZodMiniObject<{}, zod_v4_core.$strict>;
724
+ };
656
725
  readonly phone_click: {
657
726
  readonly kind: "manual";
658
727
  readonly semantics: {
@@ -725,6 +794,7 @@ type MetadataByName = {
725
794
  site_link_click: SiteLinkClickMetadata;
726
795
  site_link_arrival: SiteLinkArrivalMetadata;
727
796
  form_submit: FormSubmitMetadata;
797
+ form_step: FormStepMetadata;
728
798
  phone_click: PhoneClickMetadata;
729
799
  cta_click: CtaClickMetadata;
730
800
  };
@@ -740,6 +810,7 @@ type ConfigByName = {
740
810
  site_link_click: SiteLinkClickConfig;
741
811
  site_link_arrival: SiteLinkArrivalConfig;
742
812
  form_submit: FormSubmitConfig;
813
+ form_step: FormStepConfig;
743
814
  phone_click: PhoneClickConfig;
744
815
  cta_click: CtaClickConfig;
745
816
  };
@@ -805,6 +876,7 @@ type TriggerRegistryConfig = {
805
876
  }>;
806
877
  manual?: Partial<{
807
878
  form_submit: EventConfig<"form_submit">;
879
+ form_step: EventConfig<"form_step">;
808
880
  phone_click: EventConfig<"phone_click">;
809
881
  cta_click: EventConfig<"cta_click">;
810
882
  }>;
@@ -880,4 +952,4 @@ interface TypedTrackingClient<TRegistry extends TriggerRegistryConfig> {
880
952
  getVisitorId(): string;
881
953
  }
882
954
 
883
- export { formStartMetadataSchema as $, ALL_AUTOMATIC_EVENT_NAMES as A, type ScrollDepthMetadata as B, type CtaClickConfig as C, type SdkHeartbeatConfig as D, EVENT_REGISTRY as E, type FormStartConfig as F, type SdkHeartbeatMetadata as G, type SiteLinkArrivalConfig as H, type SiteLinkArrivalMetadata as I, type SiteLinkClickConfig as J, type SiteLinkClickMetadata as K, type SpecificPageName as L, type ManualEventName as M, type SpecificPageVisitConfig as N, type SpecificPageVisitMetadata as O, PAGE_IDENTITY_MAX_LENGTH as P, type TimeOnSiteMetadata as Q, type RegisteredAutomaticEvents as R, SPECIFIC_PAGE_NAMES as S, type TimeOnSiteConfig as T, type TrackableEvent as U, type TriggerRegistryConfig as V, type TypedTrackEventOptions as W, type TypedTrackingClient as X, ctaClickConfigSchema as Y, ctaClickMetadataSchema as Z, formStartConfigSchema as _, ALL_LEAD_EVENT_NAMES as a, getEventDefinition as a0, getEventSemantics as a1, multiPageSessionConfigSchema as a2, multiPageSessionMetadataSchema as a3, pageExitConfigSchema as a4, pageExitMetadataSchema as a5, pageIdentitySchema as a6, pageViewConfigSchema as a7, pageViewMetadataSchema as a8, phoneClickConfigSchema as a9, phoneClickMetadataSchema as aa, scrollDepthConfigSchema as ab, scrollDepthMetadataSchema as ac, sdkHeartbeatConfigSchema as ad, sdkHeartbeatMetadataSchema as ae, sdkHeartbeatTriggersSchema as af, siteLinkArrivalConfigSchema as ag, siteLinkArrivalMetadataSchema as ah, siteLinkClickConfigSchema as ai, siteLinkClickMetadataSchema as aj, specificPageNameSchema as ak, specificPageVisitConfigSchema as al, specificPageVisitMetadataSchema as am, timeOnSiteConfigSchema as an, timeOnSiteMetadataSchema as ao, ALL_MANUAL_EVENT_NAMES as b, type AutomaticEventName as c, type CtaClickMetadata as d, EVENT_SEMANTICS as e, type EventCategory as f, type EventClientVisibility as g, type EventConfig as h, type EventKind as i, type EventMetadata as j, type EventName as k, type EventOutcomeRole as l, type EventSemantics as m, type FormStartMetadata as n, type MultiPageSessionConfig as o, type MultiPageSessionMetadata as p, PAGE_IDENTITY_PATTERN as q, type PageExitConfig as r, type PageExitMetadata as s, type PageIdentity as t, type PageViewConfig as u, type PageViewMetadata as v, type PhoneClickConfig as w, type PhoneClickMetadata as x, type RegisteredManualEvents as y, type ScrollDepthConfig as z };
955
+ export { ctaClickMetadataSchema as $, ALL_AUTOMATIC_EVENT_NAMES as A, type RegisteredManualEvents as B, type CtaClickConfig as C, type ScrollDepthConfig as D, EVENT_REGISTRY as E, type FormStartConfig as F, type ScrollDepthMetadata as G, type SdkHeartbeatConfig as H, type SdkHeartbeatMetadata as I, type SiteLinkArrivalConfig as J, type SiteLinkArrivalMetadata as K, type SiteLinkClickConfig as L, type ManualEventName as M, type SiteLinkClickMetadata as N, type SpecificPageName as O, PAGE_IDENTITY_MAX_LENGTH as P, type SpecificPageVisitConfig as Q, type RegisteredAutomaticEvents as R, SPECIFIC_PAGE_NAMES as S, type SpecificPageVisitMetadata as T, type TimeOnSiteConfig as U, type TimeOnSiteMetadata as V, type TrackableEvent as W, type TriggerRegistryConfig as X, type TypedTrackEventOptions as Y, type TypedTrackingClient as Z, ctaClickConfigSchema as _, ALL_LEAD_EVENT_NAMES as a, formStartConfigSchema as a0, formStartMetadataSchema as a1, formStepConfigSchema as a2, formStepMetadataSchema as a3, getEventDefinition as a4, getEventSemantics as a5, multiPageSessionConfigSchema as a6, multiPageSessionMetadataSchema as a7, pageExitConfigSchema as a8, pageExitMetadataSchema as a9, pageIdentitySchema as aa, pageViewConfigSchema as ab, pageViewMetadataSchema as ac, phoneClickConfigSchema as ad, phoneClickMetadataSchema as ae, scrollDepthConfigSchema as af, scrollDepthMetadataSchema as ag, sdkHeartbeatConfigSchema as ah, sdkHeartbeatMetadataSchema as ai, sdkHeartbeatTriggersSchema as aj, siteLinkArrivalConfigSchema as ak, siteLinkArrivalMetadataSchema as al, siteLinkClickConfigSchema as am, siteLinkClickMetadataSchema as an, specificPageNameSchema as ao, specificPageVisitConfigSchema as ap, specificPageVisitMetadataSchema as aq, timeOnSiteConfigSchema as ar, timeOnSiteMetadataSchema as as, ALL_MANUAL_EVENT_NAMES as b, type AutomaticEventName as c, type CtaClickMetadata as d, EVENT_SEMANTICS as e, type EventCategory as f, type EventClientVisibility as g, type EventConfig as h, type EventKind as i, type EventMetadata as j, type EventName as k, type EventOutcomeRole as l, type EventSemantics as m, type FormStartMetadata as n, type FormStepConfig as o, type FormStepMetadata as p, type MultiPageSessionConfig as q, type MultiPageSessionMetadata as r, PAGE_IDENTITY_PATTERN as s, type PageExitConfig as t, type PageExitMetadata as u, type PageIdentity as v, type PageViewConfig as w, type PageViewMetadata as x, type PhoneClickConfig as y, type PhoneClickMetadata as z };
@@ -77,7 +77,8 @@ type SdkHeartbeatConfig = z.infer<typeof sdkHeartbeatConfigSchema>;
77
77
  /**
78
78
  * Metadata for the automatic `form_start` event.
79
79
  *
80
- * The SDK emits this once per form when the visitor first focuses a field.
80
+ * The SDK emits this once per form when the visitor first focuses or taps
81
+ * anything inside it.
81
82
  */
82
83
  declare const formStartMetadataSchema: z.ZodMiniObject<{
83
84
  form: z.ZodMiniObject<{
@@ -100,6 +101,40 @@ declare const formStartConfigSchema: z.ZodMiniObject<{
100
101
  }, z.core.$strict>;
101
102
  type FormStartConfig = z.infer<typeof formStartConfigSchema>;
102
103
 
104
+ /**
105
+ * Metadata for a manually fired `form_step` event.
106
+ *
107
+ * `form.id` must equal `form_start`/`form_submit`'s id. See
108
+ * docs/tracking-package/installing.md#multi-step-forms-form_step for the emit rule and an example.
109
+ */
110
+ declare const formStepMetadataSchema: z.ZodMiniObject<{
111
+ form: z.ZodMiniObject<{
112
+ id: z.ZodMiniString<string>;
113
+ action: z.ZodMiniNullable<z.ZodMiniString<string>>;
114
+ }, z.core.$strict>;
115
+ step: z.ZodMiniObject<{
116
+ id: z.ZodMiniString<string>;
117
+ index: z.ZodMiniInt;
118
+ total: z.ZodMiniNullable<z.ZodMiniInt>;
119
+ }, z.core.$strict>;
120
+ direction: z.ZodMiniEnum<{
121
+ forward: "forward";
122
+ back: "back";
123
+ }>;
124
+ page: z.ZodMiniObject<{
125
+ path: z.ZodMiniString<string>;
126
+ }, z.core.$strict>;
127
+ }, z.core.$strict>;
128
+ type FormStepMetadata = z.infer<typeof formStepMetadataSchema>;
129
+ /**
130
+ * Registration config for `form_step`.
131
+ *
132
+ * Manual-only with no options; the empty object enables typed
133
+ * `trackEvent('form_step', ...)` calls.
134
+ */
135
+ declare const formStepConfigSchema: z.ZodMiniObject<{}, z.core.$strict>;
136
+ type FormStepConfig = z.infer<typeof formStepConfigSchema>;
137
+
103
138
  /**
104
139
  * Metadata for the automatic `multi_page_session` event.
105
140
  *
@@ -388,6 +423,12 @@ declare const EVENT_SEMANTICS: {
388
423
  readonly outcomeRole: "diagnostic";
389
424
  readonly clientVisibility: "detailed";
390
425
  };
426
+ readonly form_step: {
427
+ readonly label: "Form step";
428
+ readonly category: "engagement";
429
+ readonly outcomeRole: "engagement";
430
+ readonly clientVisibility: "detailed";
431
+ };
391
432
  readonly form_submit: {
392
433
  readonly label: "Form submitted";
393
434
  readonly category: "lead";
@@ -653,6 +694,34 @@ declare const EVENT_REGISTRY: {
653
694
  }, zod_v4_core.$strict>;
654
695
  readonly configSchema: z.ZodMiniObject<{}, zod_v4_core.$strict>;
655
696
  };
697
+ readonly form_step: {
698
+ readonly kind: "manual";
699
+ readonly semantics: {
700
+ readonly label: "Form step";
701
+ readonly category: "engagement";
702
+ readonly outcomeRole: "engagement";
703
+ readonly clientVisibility: "detailed";
704
+ };
705
+ readonly metadataSchema: z.ZodMiniObject<{
706
+ form: z.ZodMiniObject<{
707
+ id: z.ZodMiniString<string>;
708
+ action: z.ZodMiniNullable<z.ZodMiniString<string>>;
709
+ }, zod_v4_core.$strict>;
710
+ step: z.ZodMiniObject<{
711
+ id: z.ZodMiniString<string>;
712
+ index: z.ZodMiniInt;
713
+ total: z.ZodMiniNullable<z.ZodMiniInt>;
714
+ }, zod_v4_core.$strict>;
715
+ direction: z.ZodMiniEnum<{
716
+ forward: "forward";
717
+ back: "back";
718
+ }>;
719
+ page: z.ZodMiniObject<{
720
+ path: z.ZodMiniString<string>;
721
+ }, zod_v4_core.$strict>;
722
+ }, zod_v4_core.$strict>;
723
+ readonly configSchema: z.ZodMiniObject<{}, zod_v4_core.$strict>;
724
+ };
656
725
  readonly phone_click: {
657
726
  readonly kind: "manual";
658
727
  readonly semantics: {
@@ -725,6 +794,7 @@ type MetadataByName = {
725
794
  site_link_click: SiteLinkClickMetadata;
726
795
  site_link_arrival: SiteLinkArrivalMetadata;
727
796
  form_submit: FormSubmitMetadata;
797
+ form_step: FormStepMetadata;
728
798
  phone_click: PhoneClickMetadata;
729
799
  cta_click: CtaClickMetadata;
730
800
  };
@@ -740,6 +810,7 @@ type ConfigByName = {
740
810
  site_link_click: SiteLinkClickConfig;
741
811
  site_link_arrival: SiteLinkArrivalConfig;
742
812
  form_submit: FormSubmitConfig;
813
+ form_step: FormStepConfig;
743
814
  phone_click: PhoneClickConfig;
744
815
  cta_click: CtaClickConfig;
745
816
  };
@@ -805,6 +876,7 @@ type TriggerRegistryConfig = {
805
876
  }>;
806
877
  manual?: Partial<{
807
878
  form_submit: EventConfig<"form_submit">;
879
+ form_step: EventConfig<"form_step">;
808
880
  phone_click: EventConfig<"phone_click">;
809
881
  cta_click: EventConfig<"cta_click">;
810
882
  }>;
@@ -880,4 +952,4 @@ interface TypedTrackingClient<TRegistry extends TriggerRegistryConfig> {
880
952
  getVisitorId(): string;
881
953
  }
882
954
 
883
- export { formStartMetadataSchema as $, ALL_AUTOMATIC_EVENT_NAMES as A, type ScrollDepthMetadata as B, type CtaClickConfig as C, type SdkHeartbeatConfig as D, EVENT_REGISTRY as E, type FormStartConfig as F, type SdkHeartbeatMetadata as G, type SiteLinkArrivalConfig as H, type SiteLinkArrivalMetadata as I, type SiteLinkClickConfig as J, type SiteLinkClickMetadata as K, type SpecificPageName as L, type ManualEventName as M, type SpecificPageVisitConfig as N, type SpecificPageVisitMetadata as O, PAGE_IDENTITY_MAX_LENGTH as P, type TimeOnSiteMetadata as Q, type RegisteredAutomaticEvents as R, SPECIFIC_PAGE_NAMES as S, type TimeOnSiteConfig as T, type TrackableEvent as U, type TriggerRegistryConfig as V, type TypedTrackEventOptions as W, type TypedTrackingClient as X, ctaClickConfigSchema as Y, ctaClickMetadataSchema as Z, formStartConfigSchema as _, ALL_LEAD_EVENT_NAMES as a, getEventDefinition as a0, getEventSemantics as a1, multiPageSessionConfigSchema as a2, multiPageSessionMetadataSchema as a3, pageExitConfigSchema as a4, pageExitMetadataSchema as a5, pageIdentitySchema as a6, pageViewConfigSchema as a7, pageViewMetadataSchema as a8, phoneClickConfigSchema as a9, phoneClickMetadataSchema as aa, scrollDepthConfigSchema as ab, scrollDepthMetadataSchema as ac, sdkHeartbeatConfigSchema as ad, sdkHeartbeatMetadataSchema as ae, sdkHeartbeatTriggersSchema as af, siteLinkArrivalConfigSchema as ag, siteLinkArrivalMetadataSchema as ah, siteLinkClickConfigSchema as ai, siteLinkClickMetadataSchema as aj, specificPageNameSchema as ak, specificPageVisitConfigSchema as al, specificPageVisitMetadataSchema as am, timeOnSiteConfigSchema as an, timeOnSiteMetadataSchema as ao, ALL_MANUAL_EVENT_NAMES as b, type AutomaticEventName as c, type CtaClickMetadata as d, EVENT_SEMANTICS as e, type EventCategory as f, type EventClientVisibility as g, type EventConfig as h, type EventKind as i, type EventMetadata as j, type EventName as k, type EventOutcomeRole as l, type EventSemantics as m, type FormStartMetadata as n, type MultiPageSessionConfig as o, type MultiPageSessionMetadata as p, PAGE_IDENTITY_PATTERN as q, type PageExitConfig as r, type PageExitMetadata as s, type PageIdentity as t, type PageViewConfig as u, type PageViewMetadata as v, type PhoneClickConfig as w, type PhoneClickMetadata as x, type RegisteredManualEvents as y, type ScrollDepthConfig as z };
955
+ export { ctaClickMetadataSchema as $, ALL_AUTOMATIC_EVENT_NAMES as A, type RegisteredManualEvents as B, type CtaClickConfig as C, type ScrollDepthConfig as D, EVENT_REGISTRY as E, type FormStartConfig as F, type ScrollDepthMetadata as G, type SdkHeartbeatConfig as H, type SdkHeartbeatMetadata as I, type SiteLinkArrivalConfig as J, type SiteLinkArrivalMetadata as K, type SiteLinkClickConfig as L, type ManualEventName as M, type SiteLinkClickMetadata as N, type SpecificPageName as O, PAGE_IDENTITY_MAX_LENGTH as P, type SpecificPageVisitConfig as Q, type RegisteredAutomaticEvents as R, SPECIFIC_PAGE_NAMES as S, type SpecificPageVisitMetadata as T, type TimeOnSiteConfig as U, type TimeOnSiteMetadata as V, type TrackableEvent as W, type TriggerRegistryConfig as X, type TypedTrackEventOptions as Y, type TypedTrackingClient as Z, ctaClickConfigSchema as _, ALL_LEAD_EVENT_NAMES as a, formStartConfigSchema as a0, formStartMetadataSchema as a1, formStepConfigSchema as a2, formStepMetadataSchema as a3, getEventDefinition as a4, getEventSemantics as a5, multiPageSessionConfigSchema as a6, multiPageSessionMetadataSchema as a7, pageExitConfigSchema as a8, pageExitMetadataSchema as a9, pageIdentitySchema as aa, pageViewConfigSchema as ab, pageViewMetadataSchema as ac, phoneClickConfigSchema as ad, phoneClickMetadataSchema as ae, scrollDepthConfigSchema as af, scrollDepthMetadataSchema as ag, sdkHeartbeatConfigSchema as ah, sdkHeartbeatMetadataSchema as ai, sdkHeartbeatTriggersSchema as aj, siteLinkArrivalConfigSchema as ak, siteLinkArrivalMetadataSchema as al, siteLinkClickConfigSchema as am, siteLinkClickMetadataSchema as an, specificPageNameSchema as ao, specificPageVisitConfigSchema as ap, specificPageVisitMetadataSchema as aq, timeOnSiteConfigSchema as ar, timeOnSiteMetadataSchema as as, ALL_MANUAL_EVENT_NAMES as b, type AutomaticEventName as c, type CtaClickMetadata as d, EVENT_SEMANTICS as e, type EventCategory as f, type EventClientVisibility as g, type EventConfig as h, type EventKind as i, type EventMetadata as j, type EventName as k, type EventOutcomeRole as l, type EventSemantics as m, type FormStartMetadata as n, type FormStepConfig as o, type FormStepMetadata as p, type MultiPageSessionConfig as q, type MultiPageSessionMetadata as r, PAGE_IDENTITY_PATTERN as s, type PageExitConfig as t, type PageExitMetadata as u, type PageIdentity as v, type PageViewConfig as w, type PageViewMetadata as x, type PhoneClickConfig as y, type PhoneClickMetadata as z };
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@aranova/tracking-react",
3
- "version": "1.2.2",
3
+ "version": "1.2.3",
4
4
  "private": false,
5
5
  "type": "commonjs",
6
6
  "description": "React tracking and consent utilities for Aranova client sites",