@codefast/tracking 0.7.1 → 0.7.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.
Files changed (214) hide show
  1. package/CHANGELOG.md +49 -0
  2. package/LICENSE +1 -1
  3. package/README.md +235 -105
  4. package/dist/adapters/tanstack-start.d.ts +5 -6
  5. package/dist/adapters/tanstack-start.js +5 -6
  6. package/dist/client/ad-framework-consent.d.ts +2 -3
  7. package/dist/client/ad-framework-consent.js +1 -2
  8. package/dist/client/browser-cookie.d.ts +1 -2
  9. package/dist/client/browser-cookie.js +1 -2
  10. package/dist/client/consent-runtime.d.ts +4 -5
  11. package/dist/client/consent-runtime.js +5 -6
  12. package/dist/client/consent-storage.d.ts +2 -3
  13. package/dist/client/consent-storage.js +2 -3
  14. package/dist/client/consent-withdrawal.d.ts +2 -3
  15. package/dist/client/consent-withdrawal.js +1 -2
  16. package/dist/client/cookie-anonymous-id.d.ts +1 -2
  17. package/dist/client/cookie-anonymous-id.js +3 -4
  18. package/dist/client/create-client-tracker.d.ts +4 -5
  19. package/dist/client/create-client-tracker.js +3 -4
  20. package/dist/client/gpc.d.ts +1 -2
  21. package/dist/client/gpc.js +1 -2
  22. package/dist/client/initial-consent-store.d.ts +2 -3
  23. package/dist/client/initial-consent-store.js +2 -3
  24. package/dist/client/is-analytics-allowed.d.ts +3 -4
  25. package/dist/client/is-analytics-allowed.js +2 -3
  26. package/dist/client/server-persisted-anonymous-id.d.ts +2 -3
  27. package/dist/client/server-persisted-anonymous-id.js +3 -4
  28. package/dist/core/consent-config.d.ts +2 -3
  29. package/dist/core/consent-config.js +1 -2
  30. package/dist/core/consent-receipt.d.ts +2 -3
  31. package/dist/core/consent-receipt.js +2 -3
  32. package/dist/core/consent.d.ts +1 -2
  33. package/dist/core/consent.js +1 -2
  34. package/dist/core/cookie.d.ts +1 -2
  35. package/dist/core/cookie.js +1 -2
  36. package/dist/core/destination.d.ts +2 -3
  37. package/dist/core/destination.js +1 -2
  38. package/dist/core/event-catalog.d.ts +1 -2
  39. package/dist/core/event-catalog.js +1 -2
  40. package/dist/core/event-id.d.ts +1 -2
  41. package/dist/core/event-id.js +1 -2
  42. package/dist/core/tracked-event.d.ts +1 -2
  43. package/dist/core/tracked-event.js +1 -2
  44. package/dist/destinations/ad-consent.d.ts +2 -3
  45. package/dist/destinations/ad-consent.js +1 -2
  46. package/dist/destinations/google-analytics.d.ts +6 -7
  47. package/dist/destinations/google-analytics.js +3 -4
  48. package/dist/destinations/google-consent.d.ts +2 -3
  49. package/dist/destinations/google-consent.js +2 -3
  50. package/dist/destinations/meta.d.ts +4 -5
  51. package/dist/destinations/meta.js +3 -4
  52. package/dist/destinations/microsoft-uet.d.ts +4 -5
  53. package/dist/destinations/microsoft-uet.js +3 -4
  54. package/dist/destinations/shared.d.ts +1 -2
  55. package/dist/destinations/shared.js +1 -2
  56. package/dist/destinations/tiktok.d.ts +4 -5
  57. package/dist/destinations/tiktok.js +3 -4
  58. package/dist/destinations/vercel-analytics.d.ts +2 -3
  59. package/dist/destinations/vercel-analytics.js +2 -3
  60. package/dist/index.d.ts +49 -50
  61. package/dist/index.js +26 -27
  62. package/dist/react/consent-banner.d.ts +3 -4
  63. package/dist/react/consent-banner.js +1 -2
  64. package/dist/react/gtag-consent-bootstrap.d.ts +2 -3
  65. package/dist/react/gtag-consent-bootstrap.js +2 -3
  66. package/dist/react/use-consent.d.ts +3 -4
  67. package/dist/react/use-consent.js +2 -3
  68. package/dist/react/use-google-consent-sync.d.ts +2 -3
  69. package/dist/react/use-google-consent-sync.js +2 -3
  70. package/dist/react/use-initial-consent.d.ts +2 -3
  71. package/dist/react/use-initial-consent.js +1 -2
  72. package/dist/server/anonymous-id-cookie.d.ts +1 -2
  73. package/dist/server/anonymous-id-cookie.js +2 -3
  74. package/dist/server/consent-receipt-store.d.ts +2 -3
  75. package/dist/server/consent-receipt-store.js +1 -2
  76. package/dist/server/consent-receipt.d.ts +2 -3
  77. package/dist/server/consent-receipt.js +1 -2
  78. package/dist/server/initial-consent.d.ts +2 -3
  79. package/dist/server/initial-consent.js +3 -4
  80. package/dist/server/measurement-protocol.d.ts +2 -3
  81. package/dist/server/measurement-protocol.js +1 -2
  82. package/dist/server/region.d.ts +2 -3
  83. package/dist/server/region.js +1 -2
  84. package/dist/server/user-deletion.d.ts +1 -2
  85. package/dist/server/user-deletion.js +1 -2
  86. package/dist/tooling/import-protection.d.ts +2 -3
  87. package/dist/tooling/import-protection.js +2 -3
  88. package/package.json +5 -94
  89. package/dist/adapters/tanstack-start.d.ts.map +0 -1
  90. package/dist/adapters/tanstack-start.js.map +0 -1
  91. package/dist/client/ad-framework-consent.d.ts.map +0 -1
  92. package/dist/client/ad-framework-consent.js.map +0 -1
  93. package/dist/client/browser-cookie.d.ts.map +0 -1
  94. package/dist/client/browser-cookie.js.map +0 -1
  95. package/dist/client/consent-runtime.d.ts.map +0 -1
  96. package/dist/client/consent-runtime.js.map +0 -1
  97. package/dist/client/consent-storage.d.ts.map +0 -1
  98. package/dist/client/consent-storage.js.map +0 -1
  99. package/dist/client/consent-withdrawal.d.ts.map +0 -1
  100. package/dist/client/consent-withdrawal.js.map +0 -1
  101. package/dist/client/cookie-anonymous-id.d.ts.map +0 -1
  102. package/dist/client/cookie-anonymous-id.js.map +0 -1
  103. package/dist/client/create-client-tracker.d.ts.map +0 -1
  104. package/dist/client/create-client-tracker.js.map +0 -1
  105. package/dist/client/gpc.d.ts.map +0 -1
  106. package/dist/client/gpc.js.map +0 -1
  107. package/dist/client/initial-consent-store.d.ts.map +0 -1
  108. package/dist/client/initial-consent-store.js.map +0 -1
  109. package/dist/client/is-analytics-allowed.d.ts.map +0 -1
  110. package/dist/client/is-analytics-allowed.js.map +0 -1
  111. package/dist/client/server-persisted-anonymous-id.d.ts.map +0 -1
  112. package/dist/client/server-persisted-anonymous-id.js.map +0 -1
  113. package/dist/core/consent-config.d.ts.map +0 -1
  114. package/dist/core/consent-config.js.map +0 -1
  115. package/dist/core/consent-receipt.d.ts.map +0 -1
  116. package/dist/core/consent-receipt.js.map +0 -1
  117. package/dist/core/consent.d.ts.map +0 -1
  118. package/dist/core/consent.js.map +0 -1
  119. package/dist/core/cookie.d.ts.map +0 -1
  120. package/dist/core/cookie.js.map +0 -1
  121. package/dist/core/destination.d.ts.map +0 -1
  122. package/dist/core/destination.js.map +0 -1
  123. package/dist/core/event-catalog.d.ts.map +0 -1
  124. package/dist/core/event-catalog.js.map +0 -1
  125. package/dist/core/event-id.d.ts.map +0 -1
  126. package/dist/core/event-id.js.map +0 -1
  127. package/dist/core/tracked-event.d.ts.map +0 -1
  128. package/dist/core/tracked-event.js.map +0 -1
  129. package/dist/destinations/ad-consent.d.ts.map +0 -1
  130. package/dist/destinations/ad-consent.js.map +0 -1
  131. package/dist/destinations/google-analytics.d.ts.map +0 -1
  132. package/dist/destinations/google-analytics.js.map +0 -1
  133. package/dist/destinations/google-consent.d.ts.map +0 -1
  134. package/dist/destinations/google-consent.js.map +0 -1
  135. package/dist/destinations/meta.d.ts.map +0 -1
  136. package/dist/destinations/meta.js.map +0 -1
  137. package/dist/destinations/microsoft-uet.d.ts.map +0 -1
  138. package/dist/destinations/microsoft-uet.js.map +0 -1
  139. package/dist/destinations/shared.d.ts.map +0 -1
  140. package/dist/destinations/shared.js.map +0 -1
  141. package/dist/destinations/tiktok.d.ts.map +0 -1
  142. package/dist/destinations/tiktok.js.map +0 -1
  143. package/dist/destinations/vercel-analytics.d.ts.map +0 -1
  144. package/dist/destinations/vercel-analytics.js.map +0 -1
  145. package/dist/index.d.ts.map +0 -1
  146. package/dist/index.js.map +0 -1
  147. package/dist/react/consent-banner.d.ts.map +0 -1
  148. package/dist/react/consent-banner.js.map +0 -1
  149. package/dist/react/gtag-consent-bootstrap.d.ts.map +0 -1
  150. package/dist/react/gtag-consent-bootstrap.js.map +0 -1
  151. package/dist/react/use-consent.d.ts.map +0 -1
  152. package/dist/react/use-consent.js.map +0 -1
  153. package/dist/react/use-google-consent-sync.d.ts.map +0 -1
  154. package/dist/react/use-google-consent-sync.js.map +0 -1
  155. package/dist/react/use-initial-consent.d.ts.map +0 -1
  156. package/dist/react/use-initial-consent.js.map +0 -1
  157. package/dist/server/anonymous-id-cookie.d.ts.map +0 -1
  158. package/dist/server/anonymous-id-cookie.js.map +0 -1
  159. package/dist/server/consent-receipt-store.d.ts.map +0 -1
  160. package/dist/server/consent-receipt-store.js.map +0 -1
  161. package/dist/server/consent-receipt.d.ts.map +0 -1
  162. package/dist/server/consent-receipt.js.map +0 -1
  163. package/dist/server/initial-consent.d.ts.map +0 -1
  164. package/dist/server/initial-consent.js.map +0 -1
  165. package/dist/server/measurement-protocol.d.ts.map +0 -1
  166. package/dist/server/measurement-protocol.js.map +0 -1
  167. package/dist/server/region.d.ts.map +0 -1
  168. package/dist/server/region.js.map +0 -1
  169. package/dist/server/user-deletion.d.ts.map +0 -1
  170. package/dist/server/user-deletion.js.map +0 -1
  171. package/dist/tooling/import-protection.d.ts.map +0 -1
  172. package/dist/tooling/import-protection.js.map +0 -1
  173. package/src/adapters/tanstack-start.ts +0 -139
  174. package/src/client/ad-framework-consent.ts +0 -88
  175. package/src/client/browser-cookie.ts +0 -16
  176. package/src/client/consent-runtime.ts +0 -82
  177. package/src/client/consent-storage.ts +0 -125
  178. package/src/client/consent-withdrawal.ts +0 -34
  179. package/src/client/cookie-anonymous-id.ts +0 -116
  180. package/src/client/create-client-tracker.ts +0 -174
  181. package/src/client/gpc.ts +0 -15
  182. package/src/client/initial-consent-store.ts +0 -220
  183. package/src/client/is-analytics-allowed.ts +0 -45
  184. package/src/client/server-persisted-anonymous-id.ts +0 -104
  185. package/src/core/consent-config.ts +0 -27
  186. package/src/core/consent-receipt.ts +0 -115
  187. package/src/core/consent.ts +0 -298
  188. package/src/core/cookie.ts +0 -29
  189. package/src/core/destination.ts +0 -29
  190. package/src/core/event-catalog.ts +0 -54
  191. package/src/core/event-id.ts +0 -8
  192. package/src/core/tracked-event.ts +0 -14
  193. package/src/destinations/ad-consent.ts +0 -29
  194. package/src/destinations/google-analytics.ts +0 -304
  195. package/src/destinations/google-consent.ts +0 -166
  196. package/src/destinations/meta.ts +0 -98
  197. package/src/destinations/microsoft-uet.ts +0 -88
  198. package/src/destinations/shared.ts +0 -51
  199. package/src/destinations/tiktok.ts +0 -87
  200. package/src/destinations/vercel-analytics.ts +0 -41
  201. package/src/index.ts +0 -171
  202. package/src/react/consent-banner.tsx +0 -386
  203. package/src/react/gtag-consent-bootstrap.tsx +0 -50
  204. package/src/react/use-consent.ts +0 -123
  205. package/src/react/use-google-consent-sync.ts +0 -40
  206. package/src/react/use-initial-consent.ts +0 -22
  207. package/src/server/anonymous-id-cookie.ts +0 -105
  208. package/src/server/consent-receipt-store.ts +0 -79
  209. package/src/server/consent-receipt.ts +0 -89
  210. package/src/server/initial-consent.ts +0 -48
  211. package/src/server/measurement-protocol.ts +0 -116
  212. package/src/server/region.ts +0 -77
  213. package/src/server/user-deletion.ts +0 -97
  214. package/src/tooling/import-protection.ts +0 -22
package/dist/index.d.ts CHANGED
@@ -13,53 +13,52 @@
13
13
  * `@codefast/tracking/destinations/vercel-analytics` so its `@vercel/analytics` peer is only
14
14
  * pulled in when used.
15
15
  */
16
- export type { ConsentCategory, ConsentDecision, ConsentMode, ConsentRecord, ConsentRegion, ConsentStorage, InitialConsent, ResolveDefaultConsentOptions, ResolveEffectiveConsentOptions, } from "#/core/consent";
17
- export { CONSENT_CATEGORIES, CONSENT_REGIONS, createConsentDecision, isConsentDecision, isConsentRecord, isConsentRegion, isInitialConsent, normalizeConsentDecision, readStoredDecision, resolveConsentMode, resolveDefaultConsent, resolveEffectiveConsent, STRICTEST_INITIAL_CONSENT, } from "#/core/consent";
18
- export type { ConsentConfig } from "#/core/consent-config";
19
- export { defineConsentConfig } from "#/core/consent-config";
20
- export type { ConsentReceipt, ConsentReceiptEventType, ConsentReceiptInput, ConsentReceiptMethod, ConsentReceiptSubjectIdType, } from "#/core/consent-receipt";
21
- export { isConsentReceiptInput } from "#/core/consent-receipt";
22
- export { readCookieValue } from "#/core/cookie";
23
- export type { Destination } from "#/core/destination";
24
- export type { EventCatalog, EventDefinition } from "#/core/event-catalog";
25
- export { assertValidEventProperties, defineEventCatalog } from "#/core/event-catalog";
26
- export { generateEventId } from "#/core/event-id";
27
- export type { TrackedEvent } from "#/core/tracked-event";
28
- export type { CmpConsentSignal, CmpStatus, ReconcileAdFrameworkConsentOptions } from "#/client/ad-framework-consent";
29
- export { hasGppApi, hasTcfApi, reconcileAdFrameworkConsent } from "#/client/ad-framework-consent";
30
- export type { ConsentRuntime, ConsentRuntimeOptions } from "#/client/consent-runtime";
31
- export { createConsentRuntime } from "#/client/consent-runtime";
32
- export { createLocalStorageConsentStorage } from "#/client/consent-storage";
33
- export type { ConsentWithdrawalHandlerOptions } from "#/client/consent-withdrawal";
34
- export { createConsentWithdrawalHandler } from "#/client/consent-withdrawal";
35
- export type { CookieAnonymousId, CookieAnonymousIdOptions } from "#/client/cookie-anonymous-id";
36
- export { createCookieAnonymousId } from "#/client/cookie-anonymous-id";
37
- export type { ClientTracker, ClientTrackerOptions, DeliveryErrorContext } from "#/client/create-client-tracker";
38
- export { createClientTracker } from "#/client/create-client-tracker";
39
- export { hasGlobalPrivacyControlSignal } from "#/client/gpc";
40
- export type { InitialConsentSnapshot, InitialConsentStore, InitialConsentStoreOptions, } from "#/client/initial-consent-store";
41
- export { createInitialConsentStore } from "#/client/initial-consent-store";
42
- export type { IsAnalyticsAllowedOptions } from "#/client/is-analytics-allowed";
43
- export { createIsAnalyticsAllowed } from "#/client/is-analytics-allowed";
44
- export type { ServerPersistedAnonymousIdOptions } from "#/client/server-persisted-anonymous-id";
45
- export { createServerPersistedAnonymousId } from "#/client/server-persisted-anonymous-id";
46
- export type { ConsentBannerAcceptProps, ConsentBannerActionsProps, ConsentBannerCategoryProps, ConsentBannerCustomizeProps, ConsentBannerDescriptionProps, ConsentBannerPreferencesProps, ConsentBannerProps, ConsentBannerRejectProps, ConsentBannerSaveProps, ConsentBannerTitleProps, ConsentToggleProps, } from "#/react/consent-banner";
47
- export { ConsentBanner, ConsentBannerAccept, ConsentBannerActions, ConsentBannerCategory, ConsentBannerCustomize, ConsentBannerDescription, ConsentBannerPreferences, ConsentBannerReject, ConsentBannerSave, ConsentBannerTitle, ConsentToggle, } from "#/react/consent-banner";
48
- export type { GtagConsentBootstrapProps } from "#/react/gtag-consent-bootstrap";
49
- export { GtagConsentBootstrap } from "#/react/gtag-consent-bootstrap";
50
- export type { UseConsentOptions, UseConsentResult } from "#/react/use-consent";
51
- export { useConsent } from "#/react/use-consent";
52
- export type { UseGoogleConsentSyncOptions } from "#/react/use-google-consent-sync";
53
- export { useGoogleConsentSync } from "#/react/use-google-consent-sync";
54
- export { useInitialConsent } from "#/react/use-initial-consent";
55
- export type { AdConsentState } from "#/destinations/ad-consent";
56
- export { toAdConsentState } from "#/destinations/ad-consent";
57
- export type { EnsureGtagOptions, GoogleAnalyticsDestinationOptions, GtagConsentBootstrapOptions, GtagFunction, LoadGtagScriptOptions, } from "#/destinations/google-analytics";
58
- export { buildGtagConsentBootstrapScript, clearGoogleAnalyticsCookies, createGoogleAnalyticsDestination, ensureGtag, loadGtagScript, updateGoogleConsent, } from "#/destinations/google-analytics";
59
- export type { MetaDataProcessingOptions, MetaDestinationOptions, MetaEventPayload } from "#/destinations/meta";
60
- export { createMetaDestination, toMetaDataProcessingOptions } from "#/destinations/meta";
61
- export type { MicrosoftUetConsent, MicrosoftUetDestinationOptions, MicrosoftUetEventPayload, } from "#/destinations/microsoft-uet";
62
- export { createMicrosoftUetDestination, toMicrosoftUetConsent } from "#/destinations/microsoft-uet";
63
- export type { TiktokConsent, TiktokDestinationOptions, TiktokEventPayload } from "#/destinations/tiktok";
64
- export { createTiktokDestination, toTiktokConsent } from "#/destinations/tiktok";
65
- //# sourceMappingURL=index.d.ts.map
16
+ export type { ConsentCategory, ConsentDecision, ConsentMode, ConsentRecord, ConsentRegion, ConsentStorage, InitialConsent, ResolveDefaultConsentOptions, ResolveEffectiveConsentOptions, } from "#core/consent";
17
+ export { CONSENT_CATEGORIES, CONSENT_REGIONS, createConsentDecision, isConsentDecision, isConsentRecord, isConsentRegion, isInitialConsent, normalizeConsentDecision, readStoredDecision, resolveConsentMode, resolveDefaultConsent, resolveEffectiveConsent, STRICTEST_INITIAL_CONSENT, } from "#core/consent";
18
+ export type { ConsentConfig } from "#core/consent-config";
19
+ export { defineConsentConfig } from "#core/consent-config";
20
+ export type { ConsentReceipt, ConsentReceiptEventType, ConsentReceiptInput, ConsentReceiptMethod, ConsentReceiptSubjectIdType, } from "#core/consent-receipt";
21
+ export { isConsentReceiptInput } from "#core/consent-receipt";
22
+ export { readCookieValue } from "#core/cookie";
23
+ export type { Destination } from "#core/destination";
24
+ export type { EventCatalog, EventDefinition } from "#core/event-catalog";
25
+ export { assertValidEventProperties, defineEventCatalog } from "#core/event-catalog";
26
+ export { generateEventId } from "#core/event-id";
27
+ export type { TrackedEvent } from "#core/tracked-event";
28
+ export type { CmpConsentSignal, CmpStatus, ReconcileAdFrameworkConsentOptions } from "#client/ad-framework-consent";
29
+ export { hasGppApi, hasTcfApi, reconcileAdFrameworkConsent } from "#client/ad-framework-consent";
30
+ export type { ConsentRuntime, ConsentRuntimeOptions } from "#client/consent-runtime";
31
+ export { createConsentRuntime } from "#client/consent-runtime";
32
+ export { createLocalStorageConsentStorage } from "#client/consent-storage";
33
+ export type { ConsentWithdrawalHandlerOptions } from "#client/consent-withdrawal";
34
+ export { createConsentWithdrawalHandler } from "#client/consent-withdrawal";
35
+ export type { CookieAnonymousId, CookieAnonymousIdOptions } from "#client/cookie-anonymous-id";
36
+ export { createCookieAnonymousId } from "#client/cookie-anonymous-id";
37
+ export type { ClientTracker, ClientTrackerOptions, DeliveryErrorContext } from "#client/create-client-tracker";
38
+ export { createClientTracker } from "#client/create-client-tracker";
39
+ export { hasGlobalPrivacyControlSignal } from "#client/gpc";
40
+ export type { InitialConsentSnapshot, InitialConsentStore, InitialConsentStoreOptions, } from "#client/initial-consent-store";
41
+ export { createInitialConsentStore } from "#client/initial-consent-store";
42
+ export type { IsAnalyticsAllowedOptions } from "#client/is-analytics-allowed";
43
+ export { createIsAnalyticsAllowed } from "#client/is-analytics-allowed";
44
+ export type { ServerPersistedAnonymousIdOptions } from "#client/server-persisted-anonymous-id";
45
+ export { createServerPersistedAnonymousId } from "#client/server-persisted-anonymous-id";
46
+ export type { ConsentBannerAcceptProps, ConsentBannerActionsProps, ConsentBannerCategoryProps, ConsentBannerCustomizeProps, ConsentBannerDescriptionProps, ConsentBannerPreferencesProps, ConsentBannerProps, ConsentBannerRejectProps, ConsentBannerSaveProps, ConsentBannerTitleProps, ConsentToggleProps, } from "#react/consent-banner";
47
+ export { ConsentBanner, ConsentBannerAccept, ConsentBannerActions, ConsentBannerCategory, ConsentBannerCustomize, ConsentBannerDescription, ConsentBannerPreferences, ConsentBannerReject, ConsentBannerSave, ConsentBannerTitle, ConsentToggle, } from "#react/consent-banner";
48
+ export type { GtagConsentBootstrapProps } from "#react/gtag-consent-bootstrap";
49
+ export { GtagConsentBootstrap } from "#react/gtag-consent-bootstrap";
50
+ export type { UseConsentOptions, UseConsentResult } from "#react/use-consent";
51
+ export { useConsent } from "#react/use-consent";
52
+ export type { UseGoogleConsentSyncOptions } from "#react/use-google-consent-sync";
53
+ export { useGoogleConsentSync } from "#react/use-google-consent-sync";
54
+ export { useInitialConsent } from "#react/use-initial-consent";
55
+ export type { AdConsentState } from "#destinations/ad-consent";
56
+ export { toAdConsentState } from "#destinations/ad-consent";
57
+ export type { EnsureGtagOptions, GoogleAnalyticsDestinationOptions, GtagConsentBootstrapOptions, GtagFunction, LoadGtagScriptOptions, } from "#destinations/google-analytics";
58
+ export { buildGtagConsentBootstrapScript, clearGoogleAnalyticsCookies, createGoogleAnalyticsDestination, ensureGtag, loadGtagScript, updateGoogleConsent, } from "#destinations/google-analytics";
59
+ export type { MetaDataProcessingOptions, MetaDestinationOptions, MetaEventPayload } from "#destinations/meta";
60
+ export { createMetaDestination, toMetaDataProcessingOptions } from "#destinations/meta";
61
+ export type { MicrosoftUetConsent, MicrosoftUetDestinationOptions, MicrosoftUetEventPayload, } from "#destinations/microsoft-uet";
62
+ export { createMicrosoftUetDestination, toMicrosoftUetConsent } from "#destinations/microsoft-uet";
63
+ export type { TiktokConsent, TiktokDestinationOptions, TiktokEventPayload } from "#destinations/tiktok";
64
+ export { createTiktokDestination, toTiktokConsent } from "#destinations/tiktok";
package/dist/index.js CHANGED
@@ -13,30 +13,29 @@
13
13
  * `@codefast/tracking/destinations/vercel-analytics` so its `@vercel/analytics` peer is only
14
14
  * pulled in when used.
15
15
  */
16
- export { CONSENT_CATEGORIES, CONSENT_REGIONS, createConsentDecision, isConsentDecision, isConsentRecord, isConsentRegion, isInitialConsent, normalizeConsentDecision, readStoredDecision, resolveConsentMode, resolveDefaultConsent, resolveEffectiveConsent, STRICTEST_INITIAL_CONSENT, } from "#/core/consent";
17
- export { defineConsentConfig } from "#/core/consent-config";
18
- export { isConsentReceiptInput } from "#/core/consent-receipt";
19
- export { readCookieValue } from "#/core/cookie";
20
- export { assertValidEventProperties, defineEventCatalog } from "#/core/event-catalog";
21
- export { generateEventId } from "#/core/event-id";
22
- export { hasGppApi, hasTcfApi, reconcileAdFrameworkConsent } from "#/client/ad-framework-consent";
23
- export { createConsentRuntime } from "#/client/consent-runtime";
24
- export { createLocalStorageConsentStorage } from "#/client/consent-storage";
25
- export { createConsentWithdrawalHandler } from "#/client/consent-withdrawal";
26
- export { createCookieAnonymousId } from "#/client/cookie-anonymous-id";
27
- export { createClientTracker } from "#/client/create-client-tracker";
28
- export { hasGlobalPrivacyControlSignal } from "#/client/gpc";
29
- export { createInitialConsentStore } from "#/client/initial-consent-store";
30
- export { createIsAnalyticsAllowed } from "#/client/is-analytics-allowed";
31
- export { createServerPersistedAnonymousId } from "#/client/server-persisted-anonymous-id";
32
- export { ConsentBanner, ConsentBannerAccept, ConsentBannerActions, ConsentBannerCategory, ConsentBannerCustomize, ConsentBannerDescription, ConsentBannerPreferences, ConsentBannerReject, ConsentBannerSave, ConsentBannerTitle, ConsentToggle, } from "#/react/consent-banner";
33
- export { GtagConsentBootstrap } from "#/react/gtag-consent-bootstrap";
34
- export { useConsent } from "#/react/use-consent";
35
- export { useGoogleConsentSync } from "#/react/use-google-consent-sync";
36
- export { useInitialConsent } from "#/react/use-initial-consent";
37
- export { toAdConsentState } from "#/destinations/ad-consent";
38
- export { buildGtagConsentBootstrapScript, clearGoogleAnalyticsCookies, createGoogleAnalyticsDestination, ensureGtag, loadGtagScript, updateGoogleConsent, } from "#/destinations/google-analytics";
39
- export { createMetaDestination, toMetaDataProcessingOptions } from "#/destinations/meta";
40
- export { createMicrosoftUetDestination, toMicrosoftUetConsent } from "#/destinations/microsoft-uet";
41
- export { createTiktokDestination, toTiktokConsent } from "#/destinations/tiktok";
42
- //# sourceMappingURL=index.js.map
16
+ export { CONSENT_CATEGORIES, CONSENT_REGIONS, createConsentDecision, isConsentDecision, isConsentRecord, isConsentRegion, isInitialConsent, normalizeConsentDecision, readStoredDecision, resolveConsentMode, resolveDefaultConsent, resolveEffectiveConsent, STRICTEST_INITIAL_CONSENT, } from "#core/consent";
17
+ export { defineConsentConfig } from "#core/consent-config";
18
+ export { isConsentReceiptInput } from "#core/consent-receipt";
19
+ export { readCookieValue } from "#core/cookie";
20
+ export { assertValidEventProperties, defineEventCatalog } from "#core/event-catalog";
21
+ export { generateEventId } from "#core/event-id";
22
+ export { hasGppApi, hasTcfApi, reconcileAdFrameworkConsent } from "#client/ad-framework-consent";
23
+ export { createConsentRuntime } from "#client/consent-runtime";
24
+ export { createLocalStorageConsentStorage } from "#client/consent-storage";
25
+ export { createConsentWithdrawalHandler } from "#client/consent-withdrawal";
26
+ export { createCookieAnonymousId } from "#client/cookie-anonymous-id";
27
+ export { createClientTracker } from "#client/create-client-tracker";
28
+ export { hasGlobalPrivacyControlSignal } from "#client/gpc";
29
+ export { createInitialConsentStore } from "#client/initial-consent-store";
30
+ export { createIsAnalyticsAllowed } from "#client/is-analytics-allowed";
31
+ export { createServerPersistedAnonymousId } from "#client/server-persisted-anonymous-id";
32
+ export { ConsentBanner, ConsentBannerAccept, ConsentBannerActions, ConsentBannerCategory, ConsentBannerCustomize, ConsentBannerDescription, ConsentBannerPreferences, ConsentBannerReject, ConsentBannerSave, ConsentBannerTitle, ConsentToggle, } from "#react/consent-banner";
33
+ export { GtagConsentBootstrap } from "#react/gtag-consent-bootstrap";
34
+ export { useConsent } from "#react/use-consent";
35
+ export { useGoogleConsentSync } from "#react/use-google-consent-sync";
36
+ export { useInitialConsent } from "#react/use-initial-consent";
37
+ export { toAdConsentState } from "#destinations/ad-consent";
38
+ export { buildGtagConsentBootstrapScript, clearGoogleAnalyticsCookies, createGoogleAnalyticsDestination, ensureGtag, loadGtagScript, updateGoogleConsent, } from "#destinations/google-analytics";
39
+ export { createMetaDestination, toMetaDataProcessingOptions } from "#destinations/meta";
40
+ export { createMicrosoftUetDestination, toMicrosoftUetConsent } from "#destinations/microsoft-uet";
41
+ export { createTiktokDestination, toTiktokConsent } from "#destinations/tiktok";
@@ -1,6 +1,6 @@
1
1
  import type { ComponentProps, ReactNode } from "react";
2
- import type { ConsentCategory } from "#/core/consent";
3
- import type { UseConsentResult } from "#/react/use-consent";
2
+ import type { ConsentCategory } from "#core/consent";
3
+ import type { UseConsentResult } from "#react/use-consent";
4
4
  /**
5
5
  * Props for {@link ConsentBanner}.
6
6
  *
@@ -179,5 +179,4 @@ export interface ConsentToggleProps extends Omit<ComponentProps<"button">, "chil
179
179
  *
180
180
  * @since 0.5.0-canary.4
181
181
  */
182
- export declare function ConsentToggle({ allowLabel, consent, denyLabel, toggledCategories, ...props }: ConsentToggleProps): ReactNode;
183
- //# sourceMappingURL=consent-banner.d.ts.map
182
+ export declare function ConsentToggle({ allowLabel, consent, denyLabel, toggledCategories, ...props }: ConsentToggleProps): ReactNode;
@@ -171,5 +171,4 @@ export function ConsentToggle({ allowLabel = "Allow tracking", consent, denyLabe
171
171
  }
172
172
  consent.saveDecision(next);
173
173
  }, type: "button", children: isAnyCategoryGranted ? denyLabel : allowLabel }));
174
- }
175
- //# sourceMappingURL=consent-banner.js.map
174
+ }
@@ -1,5 +1,5 @@
1
1
  import type { ComponentProps, ReactNode } from "react";
2
- import type { GtagConsentBootstrapOptions } from "#/destinations/google-analytics";
2
+ import type { GtagConsentBootstrapOptions } from "#destinations/google-analytics";
3
3
  /**
4
4
  * Props for {@link GtagConsentBootstrap}.
5
5
  *
@@ -15,5 +15,4 @@ export interface GtagConsentBootstrapProps extends Omit<ComponentProps<"script">
15
15
  *
16
16
  * @since 0.5.0-canary.6
17
17
  */
18
- export declare function GtagConsentBootstrap({ config, dataLayerName, defaultConsent, debugMode, gaMeasurementId, nonce, ...props }: GtagConsentBootstrapProps): ReactNode;
19
- //# sourceMappingURL=gtag-consent-bootstrap.d.ts.map
18
+ export declare function GtagConsentBootstrap({ config, dataLayerName, defaultConsent, debugMode, gaMeasurementId, nonce, ...props }: GtagConsentBootstrapProps): ReactNode;
@@ -1,5 +1,5 @@
1
1
  import { jsx as _jsx } from "react/jsx-runtime";
2
- import { buildGtagConsentBootstrapScript } from "#/destinations/google-analytics";
2
+ import { buildGtagConsentBootstrapScript } from "#destinations/google-analytics";
3
3
  /**
4
4
  * Framework-agnostic inline `<script>` that runs `buildGtagConsentBootstrapScript` before
5
5
  * hydration. Pass the same `nonce` here and in `loadGtagScript` for CSP; this component
@@ -18,5 +18,4 @@ export function GtagConsentBootstrap({ config, dataLayerName, defaultConsent, de
18
18
  ...(nonce === undefined ? {} : { nonce }),
19
19
  };
20
20
  return (_jsx("script", { ...props, dangerouslySetInnerHTML: { __html: buildGtagConsentBootstrapScript(bootstrapOptions) }, ...(nonce === undefined ? {} : { nonce }), suppressHydrationWarning: true }));
21
- }
22
- //# sourceMappingURL=gtag-consent-bootstrap.js.map
21
+ }
@@ -1,5 +1,5 @@
1
- import type { ConsentDecision, ConsentMode, ConsentStorage } from "#/core/consent";
2
- import type { ConsentConfig } from "#/core/consent-config";
1
+ import type { ConsentDecision, ConsentMode, ConsentStorage } from "#core/consent";
2
+ import type { ConsentConfig } from "#core/consent-config";
3
3
  /**
4
4
  * Options for `useConsent`.
5
5
  *
@@ -42,5 +42,4 @@ export interface UseConsentResult {
42
42
  *
43
43
  * @since 0.5.0-canary.4
44
44
  */
45
- export declare function useConsent(options: UseConsentOptions): UseConsentResult;
46
- //# sourceMappingURL=use-consent.d.ts.map
45
+ export declare function useConsent(options: UseConsentOptions): UseConsentResult;
@@ -1,6 +1,6 @@
1
1
  "use client";
2
2
  import { useCallback, useMemo, useRef, useSyncExternalStore } from "react";
3
- import { CONSENT_CATEGORIES, createConsentDecision, readStoredDecision, resolveDefaultConsent } from "#/core/consent";
3
+ import { CONSENT_CATEGORIES, createConsentDecision, readStoredDecision, resolveDefaultConsent } from "#core/consent";
4
4
  /**
5
5
  * Bridges `resolveConsentMode`/`resolveDefaultConsent` (core, region-aware) to React via
6
6
  * `useSyncExternalStore`: the stored record is the single source of truth, hydration is
@@ -56,5 +56,4 @@ export function useConsent(options) {
56
56
  isPromptNeeded: mode === "opt-in" && decision === undefined,
57
57
  saveDecision,
58
58
  }), [decision, denyAll, effectiveConsent, grantAll, mode, saveDecision]);
59
- }
60
- //# sourceMappingURL=use-consent.js.map
59
+ }
@@ -1,4 +1,4 @@
1
- import type { UseConsentResult } from "#/react/use-consent";
1
+ import type { UseConsentResult } from "#react/use-consent";
2
2
  /**
3
3
  * Options for `useGoogleConsentSync`.
4
4
  *
@@ -18,5 +18,4 @@ export interface UseGoogleConsentSyncOptions {
18
18
  *
19
19
  * @since 0.5.0-canary.6
20
20
  */
21
- export declare function useGoogleConsentSync(consent: UseConsentResult, options?: UseGoogleConsentSyncOptions): void;
22
- //# sourceMappingURL=use-google-consent-sync.d.ts.map
21
+ export declare function useGoogleConsentSync(consent: UseConsentResult, options?: UseGoogleConsentSyncOptions): void;
@@ -1,6 +1,6 @@
1
1
  "use client";
2
2
  import { useEffect } from "react";
3
- import { updateGoogleConsent } from "#/destinations/google-analytics";
3
+ import { updateGoogleConsent } from "#destinations/google-analytics";
4
4
  /**
5
5
  * Keeps Google Consent Mode v2 in sync with `useConsent`: emits `update` when a stored
6
6
  * decision exists (including cross-tab / privacy-page saves), and optionally loads gtag
@@ -18,5 +18,4 @@ export function useGoogleConsentSync(consent, options = {}) {
18
18
  loadGtagScript?.();
19
19
  }
20
20
  }, [consent.decision, consent.effectiveConsent.analytics, loadGtagScript]);
21
- }
22
- //# sourceMappingURL=use-google-consent-sync.js.map
21
+ }
@@ -1,4 +1,4 @@
1
- import type { InitialConsentSnapshot, InitialConsentStore } from "#/client/initial-consent-store";
1
+ import type { InitialConsentSnapshot, InitialConsentStore } from "#client/initial-consent-store";
2
2
  /**
3
3
  * Reactive view of a `createInitialConsentStore` — kicks off resolution on mount (a no-op
4
4
  * when the app already did so at router creation) and re-renders once the server lane
@@ -7,5 +7,4 @@ import type { InitialConsentSnapshot, InitialConsentStore } from "#/client/initi
7
7
  *
8
8
  * @since 0.5.0-canary.6
9
9
  */
10
- export declare function useInitialConsent(store: InitialConsentStore): InitialConsentSnapshot;
11
- //# sourceMappingURL=use-initial-consent.d.ts.map
10
+ export declare function useInitialConsent(store: InitialConsentStore): InitialConsentSnapshot;
@@ -14,5 +14,4 @@ export function useInitialConsent(store) {
14
14
  store.ensureResolved();
15
15
  }, [store]);
16
16
  return useSyncExternalStore(store.subscribe, store.getSnapshot, store.getServerSnapshot);
17
- }
18
- //# sourceMappingURL=use-initial-consent.js.map
17
+ }
@@ -65,5 +65,4 @@ export declare function resolveClearAnonymousIdCookie(cookieName: string): {
65
65
  path: string;
66
66
  sameSite: "lax";
67
67
  secure: true;
68
- };
69
- //# sourceMappingURL=anonymous-id-cookie.d.ts.map
68
+ };
@@ -1,4 +1,4 @@
1
- import { ONE_YEAR_IN_SECONDS } from "#/core/cookie";
1
+ import { ONE_YEAR_IN_SECONDS } from "#core/cookie";
2
2
  // The only shape the client ever mints (crypto.randomUUID) — anything else is rejected.
3
3
  const UUID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
4
4
  // Conservative subset of the RFC 6265 cookie-name token.
@@ -67,5 +67,4 @@ export function resolveAnonymousIdCookie(options) {
67
67
  export function resolveClearAnonymousIdCookie(cookieName) {
68
68
  assertValidAnonymousIdCookieName(cookieName);
69
69
  return { name: cookieName, path: "/", sameSite: "lax", secure: true };
70
- }
71
- //# sourceMappingURL=anonymous-id-cookie.js.map
70
+ }
@@ -1,4 +1,4 @@
1
- import type { ConsentReceipt } from "#/core/consent-receipt";
1
+ import type { ConsentReceipt } from "#core/consent-receipt";
2
2
  /**
3
3
  * Persistence backend for consent receipts — the durable store is the consumer's to supply
4
4
  * (a database, an append-only log). The store is **append-only**: `append` never overwrites,
@@ -52,5 +52,4 @@ export interface ReceiptStoreBackend {
52
52
  */
53
53
  export declare function createDurableReceiptStore(options: {
54
54
  backend: ReceiptStoreBackend;
55
- }): ReceiptStore;
56
- //# sourceMappingURL=consent-receipt-store.d.ts.map
55
+ }): ReceiptStore;
@@ -40,5 +40,4 @@ export function createDurableReceiptStore(options) {
40
40
  return options.backend.get(receiptId);
41
41
  },
42
42
  };
43
- }
44
- //# sourceMappingURL=consent-receipt-store.js.map
43
+ }
@@ -1,4 +1,4 @@
1
- import type { ConsentReceipt, ConsentReceiptInput } from "#/core/consent-receipt";
1
+ import type { ConsentReceipt, ConsentReceiptInput } from "#core/consent-receipt";
2
2
  /**
3
3
  * The receipt information-structure version this builder emits (ISO/IEC TS 27560-shaped).
4
4
  * Bump when the receipt field set changes; stored receipts carry it so a reader can migrate.
@@ -37,5 +37,4 @@ export interface BuildConsentReceiptOptions {
37
37
  *
38
38
  * @since 0.5.0-canary.6
39
39
  */
40
- export declare function buildConsentReceipt(options: BuildConsentReceiptOptions): ConsentReceipt;
41
- //# sourceMappingURL=consent-receipt.d.ts.map
40
+ export declare function buildConsentReceipt(options: BuildConsentReceiptOptions): ConsentReceipt;
@@ -56,5 +56,4 @@ export function buildConsentReceipt(options) {
56
56
  };
57
57
  const integrityKey = options.sign?.(base);
58
58
  return integrityKey === undefined ? base : { ...base, integrityKey };
59
- }
60
- //# sourceMappingURL=consent-receipt.js.map
59
+ }
@@ -1,4 +1,4 @@
1
- import type { ConsentCategory, InitialConsent } from "#/core/consent";
1
+ import type { ConsentCategory, InitialConsent } from "#core/consent";
2
2
  /**
3
3
  * Options for `resolveInitialConsent`.
4
4
  *
@@ -24,5 +24,4 @@ export interface InitialConsentOptions {
24
24
  *
25
25
  * @since 0.5.0-canary.6
26
26
  */
27
- export declare function resolveInitialConsent(options: InitialConsentOptions): InitialConsent;
28
- //# sourceMappingURL=initial-consent.d.ts.map
27
+ export declare function resolveInitialConsent(options: InitialConsentOptions): InitialConsent;
@@ -1,5 +1,5 @@
1
- import { resolveConsentMode, resolveDefaultConsent, STRICTEST_INITIAL_CONSENT } from "#/core/consent";
2
- import { resolveRegionFromCountryCode } from "#/server/region";
1
+ import { resolveConsentMode, resolveDefaultConsent, STRICTEST_INITIAL_CONSENT } from "#core/consent";
2
+ import { resolveRegionFromCountryCode } from "#server/region";
3
3
  /**
4
4
  * Pure region → mode → default-consent resolution for server functions (or a fail-closed
5
5
  * bake when country is unknown). Named with the `resolve*` family it composes.
@@ -27,5 +27,4 @@ export function resolveInitialConsent(options) {
27
27
  mode,
28
28
  region,
29
29
  };
30
- }
31
- //# sourceMappingURL=initial-consent.js.map
30
+ }
@@ -1,4 +1,4 @@
1
- import type { ConsentDecision } from "#/core/consent";
1
+ import type { ConsentDecision } from "#core/consent";
2
2
  /**
3
3
  * A GA4 event for the Measurement Protocol. `params` are flat scalars — GA4 rejects nested values and booleans.
4
4
  *
@@ -67,5 +67,4 @@ export interface SendMeasurementProtocolEventsOptions {
67
67
  *
68
68
  * @since 0.5.0-canary.6
69
69
  */
70
- export declare function sendMeasurementProtocolEvents(options: SendMeasurementProtocolEventsOptions): Promise<void>;
71
- //# sourceMappingURL=measurement-protocol.d.ts.map
70
+ export declare function sendMeasurementProtocolEvents(options: SendMeasurementProtocolEventsOptions): Promise<void>;
@@ -57,5 +57,4 @@ export async function sendMeasurementProtocolEvents(options) {
57
57
  ...(options.consent ? { consent: options.consent } : {}),
58
58
  });
59
59
  await (options.transport ?? defaultTransport)({ body, url });
60
- }
61
- //# sourceMappingURL=measurement-protocol.js.map
60
+ }
@@ -1,4 +1,4 @@
1
- import type { ConsentRegion } from "#/core/consent";
1
+ import type { ConsentRegion } from "#core/consent";
2
2
  /**
3
3
  * EU member states — GDPR opt-in via `resolveConsentMode("eu")`.
4
4
  *
@@ -23,5 +23,4 @@ export declare const OPT_IN_EQUIVALENT_COUNTRY_CODES: ReadonlySet<string>;
23
23
  *
24
24
  * @since 0.5.0-canary.4
25
25
  */
26
- export declare function resolveRegionFromCountryCode(countryCode: string | undefined): ConsentRegion;
27
- //# sourceMappingURL=region.d.ts.map
26
+ export declare function resolveRegionFromCountryCode(countryCode: string | undefined): ConsentRegion;
@@ -65,5 +65,4 @@ export function resolveRegionFromCountryCode(countryCode) {
65
65
  return "us";
66
66
  }
67
67
  return "other";
68
- }
69
- //# sourceMappingURL=region.js.map
68
+ }
@@ -64,5 +64,4 @@ export interface SubmitGa4UserDeletionOptions {
64
64
  *
65
65
  * @since 0.5.0-canary.6
66
66
  */
67
- export declare function submitGa4UserDeletion(options: SubmitGa4UserDeletionOptions): Promise<void>;
68
- //# sourceMappingURL=user-deletion.d.ts.map
67
+ export declare function submitGa4UserDeletion(options: SubmitGa4UserDeletionOptions): Promise<void>;
@@ -50,5 +50,4 @@ export async function submitGa4UserDeletion(options) {
50
50
  },
51
51
  url: request.url,
52
52
  });
53
- }
54
- //# sourceMappingURL=user-deletion.js.map
53
+ }
@@ -3,7 +3,7 @@
3
3
  * framework-neutral data each build tool maps to its own guard: TanStack Start's
4
4
  * `importProtection.client.specifiers`, Next's `server-only`, Remix's `.server` convention.
5
5
  * Ships and versions with the package instead of going stale in each consumer's config.
6
- * Nothing in this package imports it — its consumers are app build configs (see apps/ui
6
+ * Nothing in this package imports it — its consumers are app build configs (see apps/web
7
7
  * vite.config.ts).
8
8
  *
9
9
  * @example
@@ -15,5 +15,4 @@
15
15
  *
16
16
  * @since 0.5.0-canary.6
17
17
  */
18
- export declare const SERVER_ONLY_SUBPATHS: ReadonlyArray<string>;
19
- //# sourceMappingURL=import-protection.d.ts.map
18
+ export declare const SERVER_ONLY_SUBPATHS: ReadonlyArray<string>;
@@ -3,7 +3,7 @@
3
3
  * framework-neutral data each build tool maps to its own guard: TanStack Start's
4
4
  * `importProtection.client.specifiers`, Next's `server-only`, Remix's `.server` convention.
5
5
  * Ships and versions with the package instead of going stale in each consumer's config.
6
- * Nothing in this package imports it — its consumers are app build configs (see apps/ui
6
+ * Nothing in this package imports it — its consumers are app build configs (see apps/web
7
7
  * vite.config.ts).
8
8
  *
9
9
  * @example
@@ -19,5 +19,4 @@ export const SERVER_ONLY_SUBPATHS = [
19
19
  "@codefast/tracking/server",
20
20
  "@codefast/tracking/server/**",
21
21
  "@codefast/tracking/adapters/**",
22
- ];
23
- //# sourceMappingURL=import-protection.js.map
22
+ ];