@c15t/scripts 2.1.0 → 2.2.0-canary-20260804162155

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 (140) hide show
  1. package/AGENTS.md +62 -0
  2. package/README.md +32 -20
  3. package/dist/e2e-test-utils.cjs +51 -10
  4. package/dist/e2e-test-utils.js +37 -3
  5. package/dist/engine/compile.cjs +9 -5
  6. package/dist/engine/runtime.cjs +103 -17
  7. package/dist/engine/runtime.js +94 -12
  8. package/dist/registry.cjs +97 -12
  9. package/dist/registry.js +80 -0
  10. package/dist/resolve.cjs +9 -5
  11. package/dist/types.cjs +17 -13
  12. package/dist/vendors/_shared/attributes.cjs +13 -9
  13. package/dist/vendors/_shared/google-consent.cjs +14 -9
  14. package/dist/vendors/_shared/install-builders.cjs +12 -8
  15. package/dist/vendors/_shared/script-url.cjs +16 -12
  16. package/dist/vendors/ads-and-pixels/linkedin-insights.cjs +9 -5
  17. package/dist/vendors/ads-and-pixels/meta-pixel.cjs +13 -9
  18. package/dist/vendors/ads-and-pixels/microsoft-uet.cjs +11 -7
  19. package/dist/vendors/ads-and-pixels/reddit-pixel.cjs +9 -5
  20. package/dist/vendors/ads-and-pixels/snapchat-pixel.cjs +11 -7
  21. package/dist/vendors/ads-and-pixels/tiktok-pixel.cjs +9 -5
  22. package/dist/vendors/ads-and-pixels/x-pixel.cjs +9 -5
  23. package/dist/vendors/analytics/adobe-analytics.cjs +90 -0
  24. package/dist/vendors/analytics/adobe-analytics.js +49 -0
  25. package/dist/vendors/analytics/ahrefs-analytics.cjs +11 -7
  26. package/dist/vendors/analytics/amplitude.cjs +193 -0
  27. package/dist/vendors/analytics/amplitude.js +134 -0
  28. package/dist/vendors/analytics/clearbit.cjs +69 -0
  29. package/dist/vendors/analytics/clearbit.js +28 -0
  30. package/dist/vendors/analytics/cloudflare-web-analytics.cjs +11 -7
  31. package/dist/vendors/analytics/databuddy.cjs +11 -7
  32. package/dist/vendors/analytics/fathom-analytics.cjs +11 -7
  33. package/dist/vendors/analytics/google-tag.cjs +11 -7
  34. package/dist/vendors/analytics/heap.cjs +181 -0
  35. package/dist/vendors/analytics/heap.js +134 -0
  36. package/dist/vendors/analytics/hightouch.cjs +153 -0
  37. package/dist/vendors/analytics/hightouch.js +109 -0
  38. package/dist/vendors/analytics/hotjar.cjs +11 -7
  39. package/dist/vendors/analytics/logrocket.cjs +99 -0
  40. package/dist/vendors/analytics/logrocket.js +58 -0
  41. package/dist/vendors/analytics/matomo-analytics.cjs +9 -5
  42. package/dist/vendors/analytics/microsoft-clarity.cjs +75 -47
  43. package/dist/vendors/analytics/microsoft-clarity.js +64 -40
  44. package/dist/vendors/analytics/mixpanel-analytics.cjs +31 -16
  45. package/dist/vendors/analytics/mixpanel-analytics.js +22 -11
  46. package/dist/vendors/analytics/pirsch.cjs +108 -0
  47. package/dist/vendors/analytics/pirsch.js +67 -0
  48. package/dist/vendors/analytics/plausible-analytics.cjs +9 -5
  49. package/dist/vendors/analytics/posthog.cjs +63 -27
  50. package/dist/vendors/analytics/posthog.js +52 -20
  51. package/dist/vendors/analytics/promptwatch.cjs +11 -7
  52. package/dist/vendors/analytics/rudderstack.cjs +227 -0
  53. package/dist/vendors/analytics/rudderstack.js +183 -0
  54. package/dist/vendors/analytics/rybbit-analytics.cjs +9 -5
  55. package/dist/vendors/analytics/segment.cjs +9 -5
  56. package/dist/vendors/analytics/umami-analytics.cjs +9 -5
  57. package/dist/vendors/analytics/vercel-analytics.cjs +11 -7
  58. package/dist/vendors/functional/crisp.cjs +9 -5
  59. package/dist/vendors/functional/intercom.cjs +11 -7
  60. package/dist/vendors/tag-managers/google-tag-manager.cjs +11 -7
  61. package/dist-types/registry.d.ts +313 -241
  62. package/dist-types/types.d.ts +46 -4
  63. package/dist-types/vendors/ads-and-pixels/linkedin-insights.d.ts +18 -18
  64. package/dist-types/vendors/ads-and-pixels/meta-pixel.d.ts +21 -21
  65. package/dist-types/vendors/ads-and-pixels/microsoft-uet.d.ts +32 -32
  66. package/dist-types/vendors/ads-and-pixels/reddit-pixel.d.ts +19 -19
  67. package/dist-types/vendors/ads-and-pixels/snapchat-pixel.d.ts +16 -16
  68. package/dist-types/vendors/ads-and-pixels/tiktok-pixel.d.ts +28 -28
  69. package/dist-types/vendors/ads-and-pixels/x-pixel.d.ts +13 -13
  70. package/dist-types/vendors/analytics/adobe-analytics.d.ts +75 -0
  71. package/dist-types/vendors/analytics/ahrefs-analytics.d.ts +7 -7
  72. package/dist-types/vendors/analytics/amplitude.d.ts +234 -0
  73. package/dist-types/vendors/analytics/clearbit.d.ts +60 -0
  74. package/dist-types/vendors/analytics/cloudflare-web-analytics.d.ts +7 -7
  75. package/dist-types/vendors/analytics/databuddy.d.ts +25 -25
  76. package/dist-types/vendors/analytics/fathom-analytics.d.ts +11 -11
  77. package/dist-types/vendors/analytics/google-tag.d.ts +17 -17
  78. package/dist-types/vendors/analytics/heap.d.ts +316 -0
  79. package/dist-types/vendors/analytics/hightouch.d.ts +285 -0
  80. package/dist-types/vendors/analytics/hotjar.d.ts +14 -14
  81. package/dist-types/vendors/analytics/logrocket.d.ts +101 -0
  82. package/dist-types/vendors/analytics/microsoft-clarity.d.ts +42 -30
  83. package/dist-types/vendors/analytics/mixpanel-analytics.d.ts +40 -28
  84. package/dist-types/vendors/analytics/pirsch.d.ts +96 -0
  85. package/dist-types/vendors/analytics/plausible-analytics.d.ts +13 -13
  86. package/dist-types/vendors/analytics/posthog.d.ts +63 -45
  87. package/dist-types/vendors/analytics/promptwatch.d.ts +7 -7
  88. package/dist-types/vendors/analytics/rudderstack.d.ts +330 -0
  89. package/dist-types/vendors/analytics/rybbit-analytics.d.ts +18 -18
  90. package/dist-types/vendors/analytics/segment.d.ts +13 -13
  91. package/dist-types/vendors/analytics/umami-analytics.d.ts +12 -12
  92. package/dist-types/vendors/analytics/vercel-analytics.d.ts +16 -16
  93. package/dist-types/vendors/functional/crisp.d.ts +11 -11
  94. package/dist-types/vendors/functional/intercom.d.ts +16 -16
  95. package/dist-types/vendors/tag-managers/google-tag-manager.d.ts +18 -18
  96. package/docs/README.md +62 -0
  97. package/docs/frameworks/javascript/script-loader.md +356 -0
  98. package/docs/frameworks/next/script-loader.md +501 -0
  99. package/docs/frameworks/react/script-loader.md +555 -0
  100. package/docs/integrations/adobe-analytics.md +160 -0
  101. package/docs/integrations/ahrefs-analytics.md +157 -0
  102. package/docs/integrations/amplitude.md +230 -0
  103. package/docs/integrations/building-integrations.md +239 -0
  104. package/docs/integrations/clearbit.md +130 -0
  105. package/docs/integrations/cloudflare-web-analytics.md +126 -0
  106. package/docs/integrations/crisp.md +140 -0
  107. package/docs/integrations/databuddy.md +205 -0
  108. package/docs/integrations/fathom-analytics.md +150 -0
  109. package/docs/integrations/google-maps.md +263 -0
  110. package/docs/integrations/google-tag-manager.md +154 -0
  111. package/docs/integrations/google-tag.md +134 -0
  112. package/docs/integrations/heap.md +219 -0
  113. package/docs/integrations/hightouch.md +199 -0
  114. package/docs/integrations/hotjar.md +143 -0
  115. package/docs/integrations/intercom.md +144 -0
  116. package/docs/integrations/linkedin-insights.md +161 -0
  117. package/docs/integrations/logrocket.md +175 -0
  118. package/docs/integrations/matomo-analytics.md +171 -0
  119. package/docs/integrations/meta-pixel.md +412 -0
  120. package/docs/integrations/microsoft-clarity.md +173 -0
  121. package/docs/integrations/microsoft-uet.md +156 -0
  122. package/docs/integrations/mixpanel-analytics.md +130 -0
  123. package/docs/integrations/overview.md +149 -0
  124. package/docs/integrations/pirsch.md +142 -0
  125. package/docs/integrations/plausible-analytics.md +154 -0
  126. package/docs/integrations/posthog.md +258 -0
  127. package/docs/integrations/promptwatch.md +121 -0
  128. package/docs/integrations/reddit-pixel.md +241 -0
  129. package/docs/integrations/rudderstack.md +271 -0
  130. package/docs/integrations/rybbit-analytics.md +143 -0
  131. package/docs/integrations/segment.md +146 -0
  132. package/docs/integrations/snapchat-pixel.md +163 -0
  133. package/docs/integrations/tiktok-pixel.md +123 -0
  134. package/docs/integrations/umami-analytics.md +148 -0
  135. package/docs/integrations/vercel-analytics.md +141 -0
  136. package/docs/integrations/x-pixel.md +157 -0
  137. package/docs/integrations/youtube.md +193 -0
  138. package/docs/shared/react/guides/script-loader.md +311 -0
  139. package/package.json +61 -7
  140. package/readme.json +8 -4
package/AGENTS.md ADDED
@@ -0,0 +1,62 @@
1
+ # @c15t/scripts
2
+
3
+ > Consent-aware script integration docs for analytics, advertising pixels, tag managers, widgets, and custom loaders.
4
+
5
+ These docs ship inside the package so coding agents can read them offline. Open the topic file you need from the list below — paths are relative to this file.
6
+
7
+ ## Frameworks
8
+
9
+ Install and configure c15t in JavaScript, React, and Next.js applications.
10
+
11
+ - [Script Loader](./docs/frameworks/javascript/script-loader.md): Gate third-party scripts behind consent — load Google Analytics, Meta Pixel, and other tracking scripts only when users grant permission.
12
+ - [Script Loader](./docs/frameworks/next/script-loader.md): Gate third-party scripts behind consent in Next.js — load Google Analytics, Meta Pixel, and other tracking scripts only when users grant permission.
13
+ - [Script Loader](./docs/frameworks/react/script-loader.md): Gate third-party scripts behind consent in React — load Google Analytics, Meta Pixel, and other tracking scripts only when users grant permission.
14
+
15
+ ## Integrations
16
+
17
+ Connect analytics, advertising, maps, media, and other third-party tools behind consent.
18
+
19
+ - [Adobe Analytics](./docs/integrations/adobe-analytics.md): Adobe Analytics loaded through an Adobe Experience Platform Data Collection Tags embed URL.
20
+ - [Ahrefs Analytics](./docs/integrations/ahrefs-analytics.md): Cookieless web analytics from Ahrefs with a prebuilt helper that wires the project key into a c15t-managed script.
21
+ - [Amplitude](./docs/integrations/amplitude.md): Load Amplitude Browser SDK 2 with c15t and gate product analytics behind measurement consent.
22
+ - [Build a Custom Script Integration](./docs/integrations/building-integrations.md): Learn when to use a raw Script, when to build a reusable manifest-backed integration, and how to debug and test custom consent-aware scripts in c15t.
23
+ - [Clearbit](./docs/integrations/clearbit.md): Visitor and company enrichment loaded with Clearbit's account-keyed tags.js snippet.
24
+ - [Cloudflare Web Analytics](./docs/integrations/cloudflare-web-analytics.md): Cookieless analytics from Cloudflare with a prebuilt helper that serializes the beacon config into the `data-cf-beacon` attribute.
25
+ - [Crisp](./docs/integrations/crisp.md): Load Crisp live chat with website ID, runtime, cookie, and session options.
26
+ - [Databuddy](./docs/integrations/databuddy.md): Databuddy is a privacy-focused analytics platform that helps you understand user behavior and track events. It supports cookieless tracking and manages consent automatically through c15t's consent state synchronization.
27
+ - [Fathom Analytics](./docs/integrations/fathom-analytics.md): Privacy-friendly cookieless analytics with a prebuilt helper that maps Fathom's data attributes into a c15t-managed script.
28
+ - [Google Maps](./docs/integrations/google-maps.md): Render Google Maps only after consent with one shared Maps JavaScript API loader and independently managed map instances.
29
+ - [GA4 + Google Ads (gtag.js)](./docs/integrations/google-tag.md): Send data to Google Analytics 4 and Google Ads with automatic Consent Mode v2 support.
30
+ - [Google Tag Manager](./docs/integrations/google-tag-manager.md): Deploy and manage marketing tags centrally with automatic consent state synchronization.
31
+ - [Heap](./docs/integrations/heap.md): Load Heap with c15t and gate autocapture product analytics behind measurement consent.
32
+ - [Hightouch](./docs/integrations/hightouch.md): Load Hightouch Events with c15t and gate the browser SDK behind measurement consent.
33
+ - [Hotjar](./docs/integrations/hotjar.md): Product analytics and behavior insights with a prebuilt helper that seeds Hotjar globals before loading the vendor bundle.
34
+ - [Intercom](./docs/integrations/intercom.md): Bootstrap Intercom settings and load the messenger widget bundle.
35
+ - [LinkedIn Insights](./docs/integrations/linkedin-insights.md): Track conversions and build matched audiences for LinkedIn advertising campaigns.
36
+ - [LogRocket](./docs/integrations/logrocket.md): Session replay and monitoring loaded after measurement consent with LogRocket's browser SDK.
37
+ - [Matomo Analytics](./docs/integrations/matomo-analytics.md): Load Matomo with c15t and keep Matomo's queue aligned with measurement consent.
38
+ - [Meta Pixel](./docs/integrations/meta-pixel.md): Track conversions and build audiences for Facebook and Instagram advertising campaigns.
39
+ - [Microsoft Clarity](./docs/integrations/microsoft-clarity.md): Session replay and behavior analytics with a prebuilt helper that keeps Clarity consent synchronized with c15t measurement state.
40
+ - [Microsoft UET](./docs/integrations/microsoft-uet.md): Track conversions and measure performance for Microsoft Advertising and Bing Ads.
41
+ - [Mixpanel Analytics](./docs/integrations/mixpanel-analytics.md): Load Mixpanel with c15t and let Mixpanel's own opt-in and opt-out APIs follow measurement consent.
42
+ - [Integrations](./docs/integrations/overview.md): Load analytics, pixels, tag managers, and widgets through c15t so consent state controls when they run, update, and appear in your consent UI.
43
+ - [Pirsch](./docs/integrations/pirsch.md): Privacy-friendly, cookieless analytics loaded with Pirsch's fixed script id and identification-code attributes.
44
+ - [Plausible Analytics](./docs/integrations/plausible-analytics.md): Privacy-friendly cookieless analytics with a prebuilt helper that preserves Plausible's queue bootstrap and loader attributes.
45
+ - [PostHog](./docs/integrations/posthog.md): PostHog is an open-source product analytics platform for tracking user behavior, session replays, feature flags, and A/B testing. It supports cookieless tracking, allowing analytics to continue even without cookie consent.
46
+ - [Promptwatch](./docs/integrations/promptwatch.md): Promptwatch analyzes traffic on your site for Artificial Intelligence (AI) traffic and usage insights. Data is stored in the EU without user-identifiable information.
47
+ - [Reddit Pixel](./docs/integrations/reddit-pixel.md): Track conversions and build retargeting audiences for Reddit advertising campaigns.
48
+ - [RudderStack](./docs/integrations/rudderstack.md): Load RudderStack's JavaScript SDK with c15t and gate the browser SDK behind measurement consent.
49
+ - [Rybbit Analytics](./docs/integrations/rybbit-analytics.md): Privacy-friendly analytics with script-tag configuration via Rybbit's data attributes.
50
+ - [Segment](./docs/integrations/segment.md): Load Segment Analytics.js with c15t and gate it behind measurement consent.
51
+ - [Snapchat Pixel](./docs/integrations/snapchat-pixel.md): Measure Snapchat ad performance and build remarketing audiences with a prebuilt pixel helper.
52
+ - [TikTok Pixel](./docs/integrations/tiktok-pixel.md): Measure ad performance and build audiences for TikTok advertising campaigns.
53
+ - [Umami Analytics](./docs/integrations/umami-analytics.md): Open-source, cookieless analytics with a prebuilt helper that maps Umami's data attributes into a c15t-managed script.
54
+ - [Vercel Analytics](./docs/integrations/vercel-analytics.md): Bootstrap Vercel Analytics with a declarative queue and script attributes.
55
+ - [X Pixel (Twitter Pixel)](./docs/integrations/x-pixel.md): Track conversions and build audiences for advertising campaigns on X (formerly Twitter).
56
+ - [YouTube](./docs/integrations/youtube.md): Keep YouTube iframes unmounted until consent with a privacy-enhanced, lazy-loaded React or Next.js embed.
57
+
58
+ ## Reference
59
+
60
+ Concepts, legal templates, open-source policies, and contributor documentation.
61
+
62
+ - [Script Loader](./docs/shared/react/guides/script-loader.md): Reference page for script loader.
package/README.md CHANGED
@@ -9,38 +9,50 @@
9
9
 
10
10
  # @c15t/scripts: Prebuilt Consent Scripts
11
11
 
12
- [![GitHub stars](https://img.shields.io/github/stars/c15t/c15t?style=flat-square)](https://github.com/c15t/c15t)
13
- [![CI](https://img.shields.io/github/actions/workflow/status/c15t/c15t/ci.yml?style=flat-square)](https://github.com/c15t/c15t/actions/workflows/ci.yml)
14
- [![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg?style=flat-square)](https://github.com/c15t/c15t/blob/main/LICENSE.md)
15
- [![Discord](https://img.shields.io/discord/1312171102268690493?style=flat-square)](https://c15t.link/discord)
16
- [![npm version](https://img.shields.io/npm/v/%40c15t%2Fscripts?style=flat-square)](https://www.npmjs.com/package/@c15t/scripts)
17
- [![Top Language](https://img.shields.io/github/languages/top/c15t/c15t?style=flat-square)](https://github.com/c15t/c15t)
18
- [![Last Commit](https://img.shields.io/github/last-commit/c15t/c15t?style=flat-square)](https://github.com/c15t/c15t/commits/main)
19
- [![Open Issues](https://img.shields.io/github/issues/c15t/c15t?style=flat-square)](https://github.com/c15t/c15t/issues)
12
+ <p>
13
+ <a href="https://www.npmjs.com/package/@c15t/scripts"><picture><source media="(prefers-color-scheme: dark)" srcset="https://shieldcn.dev/npm/%40c15t%2Fscripts.svg?variant=outline&mode=dark"><img src="https://shieldcn.dev/npm/%40c15t%2Fscripts.svg?variant=outline&mode=light" alt="Latest NPM Version"></picture></a>
14
+ <a href="https://github.com/c15t/c15t"><picture><source media="(prefers-color-scheme: dark)" srcset="https://shieldcn.dev/github/c15t/c15t/stars.svg?variant=outline&mode=dark"><img src="https://shieldcn.dev/github/c15t/c15t/stars.svg?variant=outline&mode=light" alt="Stars"></picture></a>
15
+ <a href="https://github.com/c15t/c15t/blob/main/LICENSE.md"><picture><source media="(prefers-color-scheme: dark)" srcset="https://shieldcn.dev/github/c15t/c15t/license.svg?variant=outline&mode=dark"><img src="https://shieldcn.dev/github/c15t/c15t/license.svg?variant=outline&mode=light" alt="License"></picture></a>
16
+ <a href="https://c15t.link/discord"><picture><source media="(prefers-color-scheme: dark)" srcset="https://shieldcn.dev/discord/1312171102268690493.svg?variant=outline&mode=dark"><img src="https://shieldcn.dev/discord/1312171102268690493.svg?variant=outline&mode=light" alt="Discord"></picture></a>
17
+ <a href="https://skills.sh/c15t/skills/c15t"><picture><source media="(prefers-color-scheme: dark)" srcset="https://shieldcn.dev/skills/c15t/skills/c15t.svg?variant=outline&mode=dark"><img src="https://shieldcn.dev/skills/c15t/skills/c15t.svg?variant=outline&mode=light" alt="Skills"></picture></a>
18
+ <a href="https://inth.com?utm_source=npm&utm_medium=readme&utm_campaign=oss_readme&utm_content=%40c15t%2Fscripts"><picture><source media="(prefers-color-scheme: dark)" srcset="https://shieldcn.dev/badge/Made%20By-Inth-ffc803.svg?logo=data%3Aimage%2Fsvg%2Bxml%3Bbase64%2CPHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIGZpbGw9Im5vbmUiIHZpZXdCb3g9IjAgMCAzOTMgNDAwIj48cGF0aCBmaWxsPSIjMDAwIiBkPSJNMTgyLjY2MiAwdjM2Ljg5NWgtNTkuMDMxdjgyLjczM2g1OS4wMzF2MzYuODkzSDI3LjQ4MnYtMzYuODkzaDU5LjAzVjM2Ljg5NWgtNTkuMDNWMHpNMzIxLjk0MSA4OS44NVYwaDM1LjM1NXYxNTYuNTIxaC0yNS43MTNsLTg2LjEzNy05MC4zNjR2OTAuMzY0aC0zNS4zNTVWMGgyNi4zNTV6Ii8%2BPHBhdGggZmlsbD0iIzAwMCIgZmlsbC1ydWxlPSJldmVub2RkIiBkPSJNMzE4LjU3MSAxODUuNzE0aDc0LjI4NlY0MDBIMFYxODUuNzE0aDI3Mi44NTd2LTQ3LjE0M3ptLTI5MS4wOSAyOC45Njl2MzcuMTE4aDU4LjEzN3YxMTkuNjI4aDM2Ljg5NVYyNTEuODAxaDU4LjU4NHYtMzcuMTE4em0xODIuNjEuMjI0djE1Ni41MjJoMzYuODk0VjMxMy41OWg3My4zNDF2NTcuODM5aDM3LjExOFYyMTQuOTA3aC0zNy4xMTh2NjEuNzg4aC03My4zNDF2LTYxLjc4OHoiIGNsaXAtcnVsZT0iZXZlbm9kZCIvPjwvc3ZnPg%3D%3D&color=ffc803&labelTextColor=000000&valueColor=000000&mode=dark"><img src="https://shieldcn.dev/badge/Made%20By-Inth-ffc803.svg?logo=data%3Aimage%2Fsvg%2Bxml%3Bbase64%2CPHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIGZpbGw9Im5vbmUiIHZpZXdCb3g9IjAgMCAzOTMgNDAwIj48cGF0aCBmaWxsPSIjMDAwIiBkPSJNMTgyLjY2MiAwdjM2Ljg5NWgtNTkuMDMxdjgyLjczM2g1OS4wMzF2MzYuODkzSDI3LjQ4MnYtMzYuODkzaDU5LjAzVjM2Ljg5NWgtNTkuMDNWMHpNMzIxLjk0MSA4OS44NVYwaDM1LjM1NXYxNTYuNTIxaC0yNS43MTNsLTg2LjEzNy05MC4zNjR2OTAuMzY0aC0zNS4zNTVWMGgyNi4zNTV6Ii8%2BPHBhdGggZmlsbD0iIzAwMCIgZmlsbC1ydWxlPSJldmVub2RkIiBkPSJNMzE4LjU3MSAxODUuNzE0aDc0LjI4NlY0MDBIMFYxODUuNzE0aDI3Mi44NTd2LTQ3LjE0M3ptLTI5MS4wOSAyOC45Njl2MzcuMTE4aDU4LjEzN3YxMTkuNjI4aDM2Ljg5NVYyNTEuODAxaDU4LjU4NHYtMzcuMTE4em0xODIuNjEuMjI0djE1Ni41MjJoMzYuODk0VjMxMy41OWg3My4zNDF2NTcuODM5aDM3LjExOFYyMTQuOTA3aC0zNy4xMTh2NjEuNzg4aC03My4zNDF2LTYxLjc4OHoiIGNsaXAtcnVsZT0iZXZlbm9kZCIvPjwvc3ZnPg%3D%3D&color=ffc803&labelTextColor=000000&valueColor=000000&mode=light" alt="Made by Inth"></picture></a>
19
+ </p>
20
20
 
21
- Prebuilt script integrations for c15t, providing ready-to-use consent-aware analytics and marketing scripts.
21
+ Consent-aware script integrations for Google Tag Manager, Google Consent Mode v2, GA4, Google Ads, Meta Pixel, analytics tools, pixels, tag managers, and widgets.
22
22
 
23
23
  ## Key Features
24
24
 
25
- - Prebuilt script snippets for popular analytics and marketing tools
25
+ - Prebuilt script loaders for popular analytics, advertising, marketing, and functional tools
26
+ - Google Tag Manager support with Google Consent Mode v2 defaults and consent updates
27
+ - Google Analytics 4 and Google Ads support through gtag.js
28
+ - Consent-gated Meta Pixel and conversion pixel loading
26
29
  - Easy integration with c15t's script loader
27
30
  - Configuration options for each supported vendor
28
- - Supported vendors include Google Tag Manager, Meta Pixel, PostHog, TikTok Pixel, LinkedIn Insights, Microsoft UET, and X Pixel
31
+ - Supported vendors include Google Tag Manager, Meta Pixel, Amplitude, Heap, PostHog, TikTok Pixel, LinkedIn Insights, Microsoft UET, X Pixel, Reddit Pixel, Snapchat Pixel, Intercom, Crisp, and more
29
32
 
30
33
  ## Documentation
31
34
 
32
35
  For further information, guides, and examples visit the [reference documentation](https://c15t.com/docs/integrations).
33
36
 
34
- ## Scripts
37
+ ## Integrations
38
+
39
+ - **Google Tag Manager**: Loads with Google Consent Mode v2 defaults set to denied; GTM-managed tags fire only once matching consent is granted ([guide](https://c15t.com/docs/integrations/google-tag-manager))
40
+ - **Google Analytics 4 + Google Ads (gtag.js)**: Consent Mode v2 defaults and consent updates when users make a choice ([guide](https://c15t.com/docs/integrations/google-tag))
41
+ - **Conversion pixels**: Meta Pixel, TikTok Pixel, LinkedIn Insights, Microsoft UET (Microsoft Ads), X Pixel, Reddit Pixel, Snapchat Pixel
42
+ - **Analytics**: PostHog, Amplitude, Heap, Segment, RudderStack, Hightouch, Mixpanel, Microsoft Clarity, Hotjar, Plausible, Fathom, Matomo, Umami, Vercel Analytics
43
+ - **Chat widgets**: Intercom, Crisp
44
+
45
+ ## Example
46
+
47
+ ```ts
48
+ import { googleTagManager } from '@c15t/scripts/google-tag-manager'
49
+ import { metaPixel } from '@c15t/scripts/meta-pixel'
35
50
 
36
- - [Google Tag Manager](https://c15t.link/google-tag-manager)
37
- - [Google Tag](https://c15t.link/google-tag)
38
- - [PostHog](https://c15t.link/posthog)
39
- - [Meta Pixel](https://c15t.link/meta-pixel)
40
- - [TikTok Pixel](https://c15t.link/tiktok-pixel)
41
- - [LinkedIn Insights](https://c15t.link/linkedin-insights)
42
- - [Microsoft UET](https://c15t.link/microsoft-uet)
43
- - [X Pixel](https://c15t.link/x-pixel)
51
+ const scripts = [
52
+ googleTagManager({ id: 'GTM-XXXXXX' }),
53
+ metaPixel({ pixelId: '000000000000000' }),
54
+ ]
55
+ ```
44
56
 
45
57
  ## Support
46
58
 
@@ -1,11 +1,15 @@
1
1
  "use strict";
2
2
  var __webpack_require__ = {};
3
3
  (()=>{
4
- __webpack_require__.d = (exports1, definition)=>{
5
- for(var key in definition)if (__webpack_require__.o(definition, key) && !__webpack_require__.o(exports1, key)) Object.defineProperty(exports1, key, {
6
- enumerable: true,
7
- get: definition[key]
8
- });
4
+ __webpack_require__.d = (exports1, getters, values)=>{
5
+ var define = (defs, kind)=>{
6
+ for(var key in defs)if (__webpack_require__.o(defs, key) && !__webpack_require__.o(exports1, key)) Object.defineProperty(exports1, key, {
7
+ enumerable: true,
8
+ [kind]: defs[key]
9
+ });
10
+ };
11
+ define(getters, "get");
12
+ define(values, "value");
9
13
  };
10
14
  })();
11
15
  (()=>{
@@ -25,14 +29,15 @@ var __webpack_exports__ = {};
25
29
  __webpack_require__.r(__webpack_exports__);
26
30
  __webpack_require__.d(__webpack_exports__, {
27
31
  deniedConsents: ()=>deniedConsents,
32
+ grantedMarketingConsents: ()=>grantedMarketingConsents,
28
33
  grantedMeasurementConsents: ()=>grantedMeasurementConsents,
29
34
  installBodyProbe: ()=>installBodyProbe,
30
- loadScripts: ()=>script_loader_namespaceObject.loadScripts,
31
- registerVendorContractCleanup: ()=>registerVendorContractCleanup,
32
35
  installHeadProbe: ()=>installHeadProbe,
33
36
  isArgumentsPayload: ()=>isArgumentsPayload,
37
+ loadScripts: ()=>script_loader_namespaceObject.loadScripts,
38
+ registerVendorContractCleanup: ()=>registerVendorContractCleanup,
34
39
  toArgs: ()=>toArgs,
35
- grantedMarketingConsents: ()=>grantedMarketingConsents
40
+ updateScripts: ()=>script_loader_namespaceObject.updateScripts
36
41
  });
37
42
  const external_vitest_namespaceObject = require("vitest");
38
43
  const script_loader_namespaceObject = require("../../core/src/libs/script-loader");
@@ -76,19 +81,53 @@ function resetVendorGlobals() {
76
81
  for (const key of [
77
82
  'TiktokAnalyticsObject',
78
83
  'UET',
84
+ '$crisp',
85
+ 'CRISP_COOKIE_DOMAIN',
86
+ 'CRISP_COOKIE_EXPIRE',
87
+ 'CRISP_RUNTIME_CONFIG',
88
+ 'CRISP_TOKEN_ID',
89
+ 'CRISP_WEBSITE_ID',
90
+ 'Intercom',
79
91
  '_linkedin_data_partner_ids',
80
92
  '_linkedin_partner_id',
81
93
  '_fbq',
94
+ '_hjSettings',
95
+ '_paq',
96
+ '_satellite',
97
+ '_snaptr',
98
+ 'adobeDataLayer',
99
+ 'amplitude',
100
+ 'analytics',
101
+ 'clarity',
82
102
  'dataLayer',
83
103
  'databuddy',
84
104
  'databuddyConfig',
85
105
  'fbq',
86
106
  'google_tag_data',
107
+ 'heap',
108
+ 'heapReadyCb',
109
+ 'htevents',
110
+ 'hj',
111
+ 'intercomSettings',
87
112
  'lintrk',
113
+ 'LogRocket',
114
+ 'mixpanel',
115
+ 'pirsch',
116
+ 'pirschClearSession',
117
+ 'pirschInit',
118
+ 'pirschNotFound',
119
+ 'plausible',
88
120
  'posthog',
121
+ 'rdt',
122
+ 'rudderanalytics',
123
+ 'rudderAnalyticsBuildType',
124
+ 'RudderSnippetVersion',
125
+ 'snaptr',
89
126
  'ttq',
90
127
  'twq',
91
- 'uetq'
128
+ 'uetq',
129
+ 'va',
130
+ 'vaq'
92
131
  ])delete win[key];
93
132
  }
94
133
  function registerVendorContractCleanup() {
@@ -109,6 +148,7 @@ exports.isArgumentsPayload = __webpack_exports__.isArgumentsPayload;
109
148
  exports.loadScripts = __webpack_exports__.loadScripts;
110
149
  exports.registerVendorContractCleanup = __webpack_exports__.registerVendorContractCleanup;
111
150
  exports.toArgs = __webpack_exports__.toArgs;
151
+ exports.updateScripts = __webpack_exports__.updateScripts;
112
152
  for(var __rspack_i in __webpack_exports__)if (-1 === [
113
153
  "deniedConsents",
114
154
  "grantedMarketingConsents",
@@ -118,7 +158,8 @@ for(var __rspack_i in __webpack_exports__)if (-1 === [
118
158
  "isArgumentsPayload",
119
159
  "loadScripts",
120
160
  "registerVendorContractCleanup",
121
- "toArgs"
161
+ "toArgs",
162
+ "updateScripts"
122
163
  ].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
123
164
  Object.defineProperty(exports, '__esModule', {
124
165
  value: true
@@ -1,5 +1,5 @@
1
1
  import { afterEach, vi } from "vitest";
2
- import { clearAllScripts, loadScripts } from "../../core/src/libs/script-loader";
2
+ import { clearAllScripts, loadScripts, updateScripts } from "../../core/src/libs/script-loader";
3
3
  const deniedConsents = {
4
4
  necessary: true,
5
5
  functionality: false,
@@ -40,19 +40,53 @@ function resetVendorGlobals() {
40
40
  for (const key of [
41
41
  'TiktokAnalyticsObject',
42
42
  'UET',
43
+ '$crisp',
44
+ 'CRISP_COOKIE_DOMAIN',
45
+ 'CRISP_COOKIE_EXPIRE',
46
+ 'CRISP_RUNTIME_CONFIG',
47
+ 'CRISP_TOKEN_ID',
48
+ 'CRISP_WEBSITE_ID',
49
+ 'Intercom',
43
50
  '_linkedin_data_partner_ids',
44
51
  '_linkedin_partner_id',
45
52
  '_fbq',
53
+ '_hjSettings',
54
+ '_paq',
55
+ '_satellite',
56
+ '_snaptr',
57
+ 'adobeDataLayer',
58
+ 'amplitude',
59
+ 'analytics',
60
+ 'clarity',
46
61
  'dataLayer',
47
62
  'databuddy',
48
63
  'databuddyConfig',
49
64
  'fbq',
50
65
  'google_tag_data',
66
+ 'heap',
67
+ 'heapReadyCb',
68
+ 'htevents',
69
+ 'hj',
70
+ 'intercomSettings',
51
71
  'lintrk',
72
+ 'LogRocket',
73
+ 'mixpanel',
74
+ 'pirsch',
75
+ 'pirschClearSession',
76
+ 'pirschInit',
77
+ 'pirschNotFound',
78
+ 'plausible',
52
79
  'posthog',
80
+ 'rdt',
81
+ 'rudderanalytics',
82
+ 'rudderAnalyticsBuildType',
83
+ 'RudderSnippetVersion',
84
+ 'snaptr',
53
85
  'ttq',
54
86
  'twq',
55
- 'uetq'
87
+ 'uetq',
88
+ 'va',
89
+ 'vaq'
56
90
  ])delete win[key];
57
91
  }
58
92
  function registerVendorContractCleanup() {
@@ -64,4 +98,4 @@ function registerVendorContractCleanup() {
64
98
  resetVendorGlobals();
65
99
  });
66
100
  }
67
- export { deniedConsents, grantedMarketingConsents, grantedMeasurementConsents, installBodyProbe, installHeadProbe, isArgumentsPayload, loadScripts, registerVendorContractCleanup, toArgs };
101
+ export { deniedConsents, grantedMarketingConsents, grantedMeasurementConsents, installBodyProbe, installHeadProbe, isArgumentsPayload, loadScripts, registerVendorContractCleanup, toArgs, updateScripts };
@@ -1,11 +1,15 @@
1
1
  "use strict";
2
2
  var __webpack_require__ = {};
3
3
  (()=>{
4
- __webpack_require__.d = (exports1, definition)=>{
5
- for(var key in definition)if (__webpack_require__.o(definition, key) && !__webpack_require__.o(exports1, key)) Object.defineProperty(exports1, key, {
6
- enumerable: true,
7
- get: definition[key]
8
- });
4
+ __webpack_require__.d = (exports1, getters, values)=>{
5
+ var define = (defs, kind)=>{
6
+ for(var key in defs)if (__webpack_require__.o(defs, key) && !__webpack_require__.o(exports1, key)) Object.defineProperty(exports1, key, {
7
+ enumerable: true,
8
+ [kind]: defs[key]
9
+ });
10
+ };
11
+ define(getters, "get");
12
+ define(values, "value");
9
13
  };
10
14
  })();
11
15
  (()=>{
@@ -1,11 +1,15 @@
1
1
  "use strict";
2
2
  var __webpack_require__ = {};
3
3
  (()=>{
4
- __webpack_require__.d = (exports1, definition)=>{
5
- for(var key in definition)if (__webpack_require__.o(definition, key) && !__webpack_require__.o(exports1, key)) Object.defineProperty(exports1, key, {
6
- enumerable: true,
7
- get: definition[key]
8
- });
4
+ __webpack_require__.d = (exports1, getters, values)=>{
5
+ var define = (defs, kind)=>{
6
+ for(var key in defs)if (__webpack_require__.o(defs, key) && !__webpack_require__.o(exports1, key)) Object.defineProperty(exports1, key, {
7
+ enumerable: true,
8
+ [kind]: defs[key]
9
+ });
10
+ };
11
+ define(getters, "get");
12
+ define(values, "value");
9
13
  };
10
14
  })();
11
15
  (()=>{
@@ -140,6 +144,8 @@ function executeStep(step) {
140
144
  }
141
145
  case 'setGlobalPath':
142
146
  {
147
+ const rootGlobal = step.path[0];
148
+ if (step.ifGlobalIsQueue && (!rootGlobal || !Array.isArray(win[rootGlobal]))) break;
143
149
  const pathTarget = getPathTarget(win, step.path);
144
150
  if (!pathTarget) break;
145
151
  pathTarget.target[pathTarget.key] = cloneStepValue(step.value);
@@ -149,12 +155,36 @@ function executeStep(step) {
149
155
  {
150
156
  const target = win[step.target];
151
157
  if (null === target || 'object' != typeof target && 'function' != typeof target) break;
158
+ if (!step.queue && !Array.isArray(target)) break;
152
159
  const targetRecord = target;
153
160
  for (const methodName of step.methods)targetRecord[methodName] = (...args)=>{
154
161
  const queueTarget = resolveQueueTarget(win, step.queue ?? {
155
162
  global: step.target
156
163
  }, targetRecord);
157
164
  if (!queueTarget) return;
165
+ if ('methodCall' === step.queueFormat || 'wrappedMethodCall' === step.queueFormat || 'voidMethodCall' === step.queueFormat) {
166
+ const promise = new Promise((resolve)=>{
167
+ queueTarget.push({
168
+ name: methodName,
169
+ args,
170
+ resolve
171
+ });
172
+ });
173
+ if ('wrappedMethodCall' === step.queueFormat) return {
174
+ promise
175
+ };
176
+ if ('voidMethodCall' === step.queueFormat) return;
177
+ return promise;
178
+ }
179
+ if ('callback' === step.queueFormat) return void queueTarget.push({
180
+ name: methodName,
181
+ fn: ()=>{
182
+ const latestTarget = win[step.target];
183
+ if (null === latestTarget || 'object' != typeof latestTarget && 'function' != typeof latestTarget) return;
184
+ const method = latestTarget[methodName];
185
+ if ('function' == typeof method) method.apply(latestTarget, args);
186
+ }
187
+ });
158
188
  queueTarget.push([
159
189
  methodName,
160
190
  ...args
@@ -162,10 +192,31 @@ function executeStep(step) {
162
192
  };
163
193
  break;
164
194
  }
195
+ case 'defineQueueClass':
196
+ {
197
+ const target = win[step.target];
198
+ if (null === target || 'object' != typeof target && 'function' != typeof target) break;
199
+ const queueProperty = step.queueProperty ?? '_q';
200
+ const QueueClass = function() {
201
+ this[queueProperty] = [];
202
+ };
203
+ const prototype = QueueClass.prototype;
204
+ for (const methodName of step.methods)prototype[methodName] = function(...args) {
205
+ const queueTarget = this[queueProperty];
206
+ if (Array.isArray(queueTarget)) queueTarget.push({
207
+ name: methodName,
208
+ args
209
+ });
210
+ return this;
211
+ };
212
+ target[step.name] = QueueClass;
213
+ break;
214
+ }
165
215
  case 'defineGlobalMethods':
166
216
  {
167
217
  const target = win[step.target];
168
218
  if (null === target || 'object' != typeof target && 'function' != typeof target) break;
219
+ if (step.ifGlobalIsQueue && !Array.isArray(target)) break;
169
220
  const targetRecord = target;
170
221
  for (const method of step.methods)targetRecord[method.name] = 'return' === method.behavior ? ()=>cloneStepValue(method.value) : ()=>{};
171
222
  break;
@@ -261,22 +312,57 @@ function mapConsentState(mapping, consents) {
261
312
  }
262
313
  return result;
263
314
  }
315
+ function partitionConsentIds(mapping, consents) {
316
+ const allowedConsentIds = [];
317
+ const deniedConsentIds = [];
318
+ for (const [c15tCategory, consentIds] of Object.entries(mapping)){
319
+ const isGranted = consents[c15tCategory];
320
+ for (const consentId of consentIds)(isGranted ? allowedConsentIds : deniedConsentIds).push(consentId);
321
+ }
322
+ return {
323
+ allowedConsentIds,
324
+ deniedConsentIds
325
+ };
326
+ }
264
327
  function getConsentSignalSteps(resolvedManifest, mode, consents) {
265
328
  if (!resolvedManifest.consentMapping || !resolvedManifest.consentSignal) return [];
266
- const mapped = mapConsentState(resolvedManifest.consentMapping, consents);
267
329
  switch(resolvedManifest.consentSignal){
268
330
  case 'gtag':
269
- return [
270
- {
271
- type: 'callGlobal',
272
- global: resolvedManifest.consentSignalTarget ?? 'gtag',
273
- args: [
274
- 'consent',
275
- mode,
276
- mapped
277
- ]
278
- }
279
- ];
331
+ {
332
+ const mapped = mapConsentState(resolvedManifest.consentMapping, consents);
333
+ return [
334
+ {
335
+ type: 'callGlobal',
336
+ global: resolvedManifest.consentSignalTarget ?? 'gtag',
337
+ args: [
338
+ 'consent',
339
+ mode,
340
+ mapped
341
+ ]
342
+ }
343
+ ];
344
+ }
345
+ case 'rudderstack':
346
+ {
347
+ const partition = partitionConsentIds(resolvedManifest.consentMapping, consents);
348
+ return [
349
+ {
350
+ type: 'callGlobal',
351
+ global: resolvedManifest.consentSignalTarget ?? 'rudderanalytics',
352
+ method: 'consent',
353
+ args: [
354
+ {
355
+ consentManagement: {
356
+ enabled: true,
357
+ provider: 'custom',
358
+ allowedConsentIds: partition.allowedConsentIds,
359
+ deniedConsentIds: partition.deniedConsentIds
360
+ }
361
+ }
362
+ ]
363
+ }
364
+ ];
365
+ }
280
366
  }
281
367
  }
282
368
  function resolvedManifestToScript(resolvedManifest) {