@c15t/react 2.0.4 → 2.2.0-canary-20260727202135

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 (332) hide show
  1. package/AGENTS.md +155 -0
  2. package/README.md +29 -14
  3. package/client/components/integrations.js +3 -0
  4. package/dist/components/consent-banner/atoms/overlay.cjs +1 -1
  5. package/dist/components/consent-banner/atoms/root.cjs +1 -1
  6. package/dist/components/consent-banner/components.cjs +1 -1
  7. package/dist/components/consent-banner/consent-banner.cjs +1 -1
  8. package/dist/components/consent-banner/error-boundary.cjs +1 -1
  9. package/dist/components/consent-banner/index.cjs +1 -1
  10. package/dist/components/consent-banner/policy-actions.cjs +1 -1
  11. package/dist/components/consent-dialog/atoms/card.cjs +1 -1
  12. package/dist/components/consent-dialog/atoms/overlay.cjs +1 -1
  13. package/dist/components/consent-dialog/atoms/root.cjs +1 -1
  14. package/dist/components/consent-dialog/consent-dialog.cjs +1 -1
  15. package/dist/components/consent-dialog/index.cjs +1 -1
  16. package/dist/components/consent-dialog-link/index.cjs +1 -1
  17. package/dist/components/consent-dialog-trigger/atoms/button.cjs +1 -1
  18. package/dist/components/consent-dialog-trigger/atoms/button.js +1 -1
  19. package/dist/components/consent-dialog-trigger/atoms/icon.cjs +1 -1
  20. package/dist/components/consent-dialog-trigger/atoms/root.cjs +1 -1
  21. package/dist/components/consent-dialog-trigger/atoms/text.cjs +1 -1
  22. package/dist/components/consent-dialog-trigger/atoms/toolbar.cjs +1 -0
  23. package/dist/components/consent-dialog-trigger/atoms/toolbar.js +1 -0
  24. package/dist/components/consent-dialog-trigger/consent-dialog-trigger-toolbar.cjs +1 -0
  25. package/dist/components/consent-dialog-trigger/consent-dialog-trigger-toolbar.js +1 -0
  26. package/dist/components/consent-dialog-trigger/consent-dialog-trigger.cjs +1 -1
  27. package/dist/components/consent-dialog-trigger/index.cjs +1 -1
  28. package/dist/components/consent-dialog-trigger/index.js +1 -1
  29. package/dist/components/consent-dialog-trigger/use-draggable.cjs +1 -1
  30. package/dist/components/consent-preferences-link/consent-preferences-link.cjs +1 -1
  31. package/dist/components/consent-preferences-link/index.cjs +1 -1
  32. package/dist/components/consent-widget/atoms/accordion.cjs +1 -1
  33. package/dist/components/consent-widget/atoms/button.cjs +1 -1
  34. package/dist/components/consent-widget/atoms/footer.cjs +1 -1
  35. package/dist/components/consent-widget/atoms/root.cjs +1 -1
  36. package/dist/components/consent-widget/consent-widget.cjs +1 -1
  37. package/dist/components/consent-widget/index.cjs +1 -1
  38. package/dist/components/consent-widget/policy-actions.cjs +1 -1
  39. package/dist/components/frame/atoms.cjs +1 -1
  40. package/dist/components/frame/atoms.js +1 -1
  41. package/dist/components/frame/frame.cjs +1 -1
  42. package/dist/components/frame/index.cjs +1 -1
  43. package/dist/components/iab-consent-banner/atoms/button-group.cjs +1 -1
  44. package/dist/components/iab-consent-banner/atoms/card.cjs +1 -1
  45. package/dist/components/iab-consent-banner/atoms/description.cjs +1 -1
  46. package/dist/components/iab-consent-banner/atoms/footer.cjs +1 -1
  47. package/dist/components/iab-consent-banner/atoms/header.cjs +1 -1
  48. package/dist/components/iab-consent-banner/atoms/overlay.cjs +1 -1
  49. package/dist/components/iab-consent-banner/atoms/root.cjs +1 -1
  50. package/dist/components/iab-consent-banner/atoms/title.cjs +1 -1
  51. package/dist/components/iab-consent-banner/iab-consent-banner.cjs +1 -1
  52. package/dist/components/iab-consent-banner/iab-consent-banner.js +1 -1
  53. package/dist/components/iab-consent-banner/index.cjs +1 -1
  54. package/dist/components/iab-consent-dialog/atoms/card.cjs +1 -1
  55. package/dist/components/iab-consent-dialog/atoms/content.cjs +1 -1
  56. package/dist/components/iab-consent-dialog/atoms/footer.cjs +1 -1
  57. package/dist/components/iab-consent-dialog/atoms/header.cjs +1 -1
  58. package/dist/components/iab-consent-dialog/atoms/overlay.cjs +1 -1
  59. package/dist/components/iab-consent-dialog/atoms/purpose-item.cjs +1 -1
  60. package/dist/components/iab-consent-dialog/atoms/root.cjs +1 -1
  61. package/dist/components/iab-consent-dialog/atoms/stack-item.cjs +1 -1
  62. package/dist/components/iab-consent-dialog/atoms/tabs.cjs +1 -1
  63. package/dist/components/iab-consent-dialog/atoms/vendor-list.cjs +1 -1
  64. package/dist/components/iab-consent-dialog/hooks/use-gvl-data.cjs +1 -1
  65. package/dist/components/iab-consent-dialog/iab-consent-dialog.cjs +1 -1
  66. package/dist/components/iab-consent-dialog/index.cjs +1 -1
  67. package/dist/components/iab-consent-dialog/use-iab-translations.cjs +1 -1
  68. package/dist/components/integrations/google-map.cjs +1 -0
  69. package/dist/components/integrations/google-map.js +1 -0
  70. package/dist/components/integrations/index.cjs +1 -0
  71. package/dist/components/integrations/index.js +1 -0
  72. package/dist/components/integrations/shared.cjs +1 -0
  73. package/dist/components/integrations/shared.js +1 -0
  74. package/dist/components/integrations/youtube-embed.cjs +1 -0
  75. package/dist/components/integrations/youtube-embed.js +1 -0
  76. package/dist/components/shared/libs/recursive-clone-children.cjs +1 -1
  77. package/dist/components/shared/libs/slot.cjs +1 -1
  78. package/dist/components/shared/libs/use-controllable-state.cjs +1 -1
  79. package/dist/components/shared/policy-actions.cjs +1 -1
  80. package/dist/components/shared/primitives/box.cjs +1 -1
  81. package/dist/components/shared/primitives/button.cjs +1 -1
  82. package/dist/components/shared/primitives/button.js +1 -1
  83. package/dist/components/shared/primitives/legal-links/index.cjs +1 -1
  84. package/dist/components/shared/primitives/legal-links/index.js +1 -1
  85. package/dist/components/shared/ui/accordion/accordion.cjs +1 -1
  86. package/dist/components/shared/ui/accordion/index.cjs +1 -1
  87. package/dist/components/shared/ui/animated-collapse/animated-collapse.cjs +1 -1
  88. package/dist/components/shared/ui/animated-collapse/index.cjs +1 -1
  89. package/dist/components/shared/ui/branding.cjs +1 -1
  90. package/dist/components/shared/ui/button/button.cjs +1 -1
  91. package/dist/components/shared/ui/button/index.cjs +1 -1
  92. package/dist/components/shared/ui/collapsible/collapsible.cjs +1 -1
  93. package/dist/components/shared/ui/collapsible/index.cjs +1 -1
  94. package/dist/components/shared/ui/dialog/dialog.cjs +1 -1
  95. package/dist/components/shared/ui/dialog/index.cjs +1 -1
  96. package/dist/components/shared/ui/icon.cjs +1 -1
  97. package/dist/components/shared/ui/logo.cjs +1 -1
  98. package/dist/components/shared/ui/preference-item/index.cjs +1 -1
  99. package/dist/components/shared/ui/preference-item/preference-item.cjs +1 -1
  100. package/dist/components/shared/ui/switch/index.cjs +1 -1
  101. package/dist/components/shared/ui/switch/switch.cjs +1 -1
  102. package/dist/components/shared/ui/tabs/index.cjs +1 -1
  103. package/dist/components/shared/ui/tabs/tabs.cjs +1 -1
  104. package/dist/context/consent-manager-context.cjs +1 -1
  105. package/dist/context/consent-tracking-context.cjs +1 -1
  106. package/dist/context/theme-context.cjs +1 -1
  107. package/dist/headless.cjs +1 -1
  108. package/dist/headless.js +1 -1
  109. package/dist/hooks/index.cjs +1 -1
  110. package/dist/hooks/index.js +1 -1
  111. package/dist/hooks/use-color-scheme.cjs +1 -1
  112. package/dist/hooks/use-component-config.cjs +1 -1
  113. package/dist/hooks/use-consent-dialog-trigger.cjs +1 -1
  114. package/dist/hooks/use-consent-manager.cjs +1 -1
  115. package/dist/hooks/use-consent-script.cjs +1 -0
  116. package/dist/hooks/use-consent-script.js +1 -0
  117. package/dist/hooks/use-focus-trap.cjs +1 -1
  118. package/dist/hooks/use-headless-consent-ui.cjs +1 -1
  119. package/dist/hooks/use-headless-iab-consent-ui.cjs +1 -1
  120. package/dist/hooks/use-reduced-motion.cjs +1 -1
  121. package/dist/hooks/use-scroll-lock.cjs +1 -1
  122. package/dist/hooks/use-ssr-status.cjs +1 -1
  123. package/dist/hooks/use-styles.cjs +1 -1
  124. package/dist/hooks/use-text-direction.cjs +1 -1
  125. package/dist/hooks/use-theme.cjs +1 -1
  126. package/dist/hooks/use-translations.cjs +1 -1
  127. package/dist/iab.cjs +1 -1
  128. package/dist/index.cjs +1 -1
  129. package/dist/index.js +1 -1
  130. package/dist/primitives/accordion.cjs +1 -1
  131. package/dist/primitives/button.cjs +1 -1
  132. package/dist/primitives/collapsible.cjs +1 -1
  133. package/dist/primitives/dialog.cjs +1 -1
  134. package/dist/primitives/preference-item.cjs +1 -1
  135. package/dist/primitives/switch.cjs +1 -1
  136. package/dist/primitives/tabs.cjs +1 -1
  137. package/dist/primitives.cjs +1 -1
  138. package/dist/providers/consent-manager-provider.cjs +1 -1
  139. package/dist/server/fetch-ssr-data.cjs +1 -1
  140. package/dist/server/fetch-ssr-data.js +1 -1
  141. package/dist/server/headers.cjs +1 -1
  142. package/dist/server/headers.js +1 -1
  143. package/dist/server/index.cjs +1 -1
  144. package/dist/server/init-cache-key.cjs +1 -1
  145. package/dist/server/normalize-url.cjs +1 -1
  146. package/dist/styles.tw3.css +1 -1
  147. package/dist/types/theme/index.cjs +1 -1
  148. package/dist/types/theme/style-types.cjs +1 -1
  149. package/dist/utils/cn.cjs +1 -1
  150. package/dist/utils/merge-styles.cjs +1 -1
  151. package/dist/utils/test-helpers.cjs +1 -1
  152. package/dist/utils/theme-utils.cjs +1 -1
  153. package/dist/version.cjs +1 -1
  154. package/dist/version.js +1 -1
  155. package/dist-types/components/consent-banner/components.d.ts +2 -2
  156. package/dist-types/components/consent-banner/policy-actions.d.ts +1 -1
  157. package/dist-types/components/consent-dialog/atoms/card.d.ts +5 -5
  158. package/dist-types/components/consent-dialog-trigger/atoms/toolbar.d.ts +22 -0
  159. package/dist-types/components/consent-dialog-trigger/consent-dialog-trigger-toolbar.d.ts +35 -0
  160. package/dist-types/components/consent-dialog-trigger/index.d.ts +2 -1
  161. package/dist-types/components/consent-dialog-trigger/types.d.ts +111 -6
  162. package/dist-types/components/consent-widget/atoms/accordion.d.ts +4 -4
  163. package/dist-types/components/consent-widget/consent-widget.d.ts +1 -1
  164. package/dist-types/components/consent-widget/policy-actions.d.ts +1 -1
  165. package/dist-types/components/integrations/google-map.d.ts +82 -0
  166. package/dist-types/components/integrations/index.d.ts +2 -0
  167. package/dist-types/components/integrations/shared.d.ts +12 -0
  168. package/dist-types/components/integrations/youtube-embed.d.ts +95 -0
  169. package/dist-types/components/shared/policy-actions.d.ts +1 -1
  170. package/dist-types/components/shared/primitives/button.d.ts +36 -2
  171. package/dist-types/components/shared/primitives/legal-links/index.d.ts +1 -1
  172. package/dist-types/components/shared/ui/accordion/accordion.d.ts +2 -2
  173. package/dist-types/components/shared/ui/branding.d.ts +3 -3
  174. package/dist-types/components/shared/ui/button/button.d.ts +1 -1
  175. package/dist-types/components/shared/ui/dialog/dialog.d.ts +1 -1
  176. package/dist-types/components/shared/ui/logo.d.ts +8 -8
  177. package/dist-types/headless.d.ts +1 -0
  178. package/dist-types/hooks/index.d.ts +1 -0
  179. package/dist-types/hooks/use-consent-script.d.ts +80 -0
  180. package/dist-types/index.d.ts +3 -1
  181. package/dist-types/providers/consent-manager-provider.d.ts +1 -1
  182. package/dist-types/server/headers.d.ts +1 -1
  183. package/dist-types/utils/theme-utils.d.ts +1 -1
  184. package/dist-types/version.d.ts +1 -1
  185. package/docs/README.md +155 -76
  186. package/docs/{building-headless-components.md → frameworks/react/building-headless-components.md} +3 -1
  187. package/docs/{callbacks.md → frameworks/react/callbacks.md} +3 -1
  188. package/docs/{components → frameworks/react/components}/consent-banner.md +10 -21
  189. package/docs/{components → frameworks/react/components}/consent-dialog-link.md +8 -5
  190. package/docs/frameworks/react/components/consent-dialog-trigger.md +202 -0
  191. package/docs/{components → frameworks/react/components}/consent-dialog.md +7 -15
  192. package/docs/frameworks/react/components/consent-manager-provider.md +228 -0
  193. package/docs/{components → frameworks/react/components}/consent-widget.md +8 -6
  194. package/docs/{components → frameworks/react/components}/dev-tools.md +9 -6
  195. package/docs/{components → frameworks/react/components}/frame.md +8 -9
  196. package/docs/{concepts → frameworks/react/concepts}/client-modes.md +4 -2
  197. package/docs/{concepts → frameworks/react/concepts}/consent-categories.md +1 -0
  198. package/docs/{concepts → frameworks/react/concepts}/consent-models.md +1 -0
  199. package/docs/{concepts → frameworks/react/concepts}/cookie-management.md +3 -3
  200. package/docs/{concepts → frameworks/react/concepts}/glossary.md +1 -0
  201. package/docs/{concepts → frameworks/react/concepts}/initialization-flow.md +1 -0
  202. package/docs/{concepts → frameworks/react/concepts}/policy-packs.md +1 -0
  203. package/docs/{headless.md → frameworks/react/headless.md} +3 -1
  204. package/docs/{hooks → frameworks/react/hooks}/use-color-scheme.md +1 -0
  205. package/docs/{hooks → frameworks/react/hooks}/use-consent-manager/checking-consent.md +3 -1
  206. package/docs/{hooks → frameworks/react/hooks}/use-consent-manager/location-info.md +3 -1
  207. package/docs/frameworks/react/hooks/use-consent-manager/overview.md +172 -0
  208. package/docs/{hooks → frameworks/react/hooks}/use-consent-manager/setting-consent.md +3 -1
  209. package/docs/{hooks → frameworks/react/hooks}/use-draggable.md +3 -1
  210. package/docs/{hooks → frameworks/react/hooks}/use-focus-trap.md +1 -0
  211. package/docs/{hooks → frameworks/react/hooks}/use-reduced-motion.md +3 -1
  212. package/docs/{hooks → frameworks/react/hooks}/use-ssr-status.md +6 -5
  213. package/docs/{hooks → frameworks/react/hooks}/use-text-direction.md +1 -0
  214. package/docs/frameworks/react/hooks/use-translations.md +55 -0
  215. package/docs/{iab → frameworks/react/iab}/consent-banner.md +9 -12
  216. package/docs/{iab → frameworks/react/iab}/consent-dialog.md +9 -14
  217. package/docs/{iab → frameworks/react/iab}/overview.md +4 -2
  218. package/docs/{iab → frameworks/react/iab}/use-gvl-data.md +3 -2
  219. package/docs/{iframe-blocking.md → frameworks/react/iframe-blocking.md} +8 -9
  220. package/docs/{internationalization.md → frameworks/react/internationalization.md} +13 -3
  221. package/docs/{network-blocker.md → frameworks/react/network-blocker.md} +13 -51
  222. package/docs/{optimization.md → frameworks/react/optimization.md} +3 -2
  223. package/docs/{policy-packs.md → frameworks/react/policy-packs.md} +3 -1
  224. package/docs/{quickstart.md → frameworks/react/quickstart.md} +26 -42
  225. package/docs/frameworks/react/script-loader.md +553 -0
  226. package/docs/{server-side.md → frameworks/react/server-side.md} +9 -4
  227. package/docs/{styling → frameworks/react/styling}/classnames.md +3 -1
  228. package/docs/{styling → frameworks/react/styling}/color-scheme.md +3 -1
  229. package/docs/frameworks/react/styling/css-variables.md +53 -0
  230. package/docs/frameworks/react/styling/overview.md +302 -0
  231. package/docs/frameworks/react/styling/slots.md +94 -0
  232. package/docs/{styling → frameworks/react/styling}/tailwind.md +3 -1
  233. package/docs/frameworks/react/styling/tokens.md +156 -0
  234. package/docs/{troubleshooting.md → frameworks/react/troubleshooting.md} +3 -1
  235. package/docs/integrations/adobe-analytics.md +160 -0
  236. package/docs/integrations/ahrefs-analytics.md +157 -0
  237. package/docs/integrations/amplitude.md +230 -0
  238. package/docs/integrations/building-integrations.md +15 -181
  239. package/docs/integrations/clearbit.md +130 -0
  240. package/docs/integrations/cloudflare-web-analytics.md +126 -0
  241. package/docs/integrations/crisp.md +140 -0
  242. package/docs/integrations/databuddy.md +152 -150
  243. package/docs/integrations/fathom-analytics.md +150 -0
  244. package/docs/integrations/google-maps.md +263 -0
  245. package/docs/integrations/google-tag-manager.md +102 -101
  246. package/docs/integrations/google-tag.md +104 -92
  247. package/docs/integrations/heap.md +219 -0
  248. package/docs/integrations/hightouch.md +199 -0
  249. package/docs/integrations/hotjar.md +143 -0
  250. package/docs/integrations/intercom.md +144 -0
  251. package/docs/integrations/linkedin-insights.md +142 -90
  252. package/docs/integrations/logrocket.md +175 -0
  253. package/docs/integrations/matomo-analytics.md +171 -0
  254. package/docs/integrations/meta-pixel.md +379 -309
  255. package/docs/integrations/microsoft-clarity.md +173 -0
  256. package/docs/integrations/microsoft-uet.md +135 -91
  257. package/docs/integrations/mixpanel-analytics.md +130 -0
  258. package/docs/integrations/overview.md +119 -75
  259. package/docs/integrations/pirsch.md +142 -0
  260. package/docs/integrations/plausible-analytics.md +154 -0
  261. package/docs/integrations/posthog.md +186 -127
  262. package/docs/integrations/promptwatch.md +121 -0
  263. package/docs/integrations/reddit-pixel.md +241 -0
  264. package/docs/integrations/rudderstack.md +271 -0
  265. package/docs/integrations/rybbit-analytics.md +143 -0
  266. package/docs/integrations/segment.md +146 -0
  267. package/docs/integrations/snapchat-pixel.md +163 -0
  268. package/docs/integrations/tiktok-pixel.md +101 -91
  269. package/docs/integrations/umami-analytics.md +148 -0
  270. package/docs/integrations/vercel-analytics.md +141 -0
  271. package/docs/integrations/x-pixel.md +123 -109
  272. package/docs/integrations/youtube.md +193 -0
  273. package/docs/shared/concepts/client-modes.md +103 -0
  274. package/docs/shared/concepts/consent-categories.md +41 -0
  275. package/docs/shared/concepts/consent-models.md +72 -0
  276. package/docs/shared/concepts/cookie-management.md +88 -0
  277. package/docs/shared/concepts/glossary.md +24 -0
  278. package/docs/shared/concepts/initialization-flow.md +105 -0
  279. package/docs/shared/concepts/policy-packs.md +225 -0
  280. package/docs/shared/react/components/consent-banner.md +242 -0
  281. package/docs/shared/react/components/consent-dialog-link.md +45 -0
  282. package/docs/shared/react/components/consent-dialog-trigger.md +185 -0
  283. package/docs/shared/react/components/consent-dialog.md +119 -0
  284. package/docs/shared/react/components/consent-manager-provider.md +183 -0
  285. package/docs/shared/react/components/consent-widget.md +121 -0
  286. package/docs/shared/react/components/dev-tools.md +81 -0
  287. package/docs/shared/react/components/frame.md +52 -0
  288. package/docs/shared/react/guides/building-headless-components.md +110 -0
  289. package/docs/shared/react/guides/callbacks.md +89 -0
  290. package/docs/shared/react/guides/headless.md +31 -0
  291. package/docs/shared/react/guides/iframe-blocking.md +65 -0
  292. package/docs/shared/react/guides/internationalization.md +123 -0
  293. package/docs/shared/react/guides/network-blocker.md +72 -0
  294. package/docs/shared/react/guides/optimization.md +44 -0
  295. package/docs/shared/react/guides/policy-packs.md +173 -0
  296. package/docs/shared/react/guides/script-loader.md +309 -0
  297. package/docs/shared/react/hooks/use-color-scheme.md +31 -0
  298. package/docs/shared/react/hooks/use-consent-manager/checking-consent.md +95 -0
  299. package/docs/shared/react/hooks/use-consent-manager/location-info.md +96 -0
  300. package/docs/shared/react/hooks/use-consent-manager/overview.md +74 -0
  301. package/docs/shared/react/hooks/use-consent-manager/setting-consent.md +93 -0
  302. package/docs/shared/react/hooks/use-draggable.md +30 -0
  303. package/docs/shared/react/hooks/use-focus-trap.md +20 -0
  304. package/docs/shared/react/hooks/use-reduced-motion.md +33 -0
  305. package/docs/shared/react/hooks/use-ssr-status.md +16 -0
  306. package/docs/shared/react/hooks/use-text-direction.md +38 -0
  307. package/docs/shared/react/hooks/use-translations.md +15 -0
  308. package/docs/shared/react/iab/consent-banner.md +60 -0
  309. package/docs/shared/react/iab/consent-dialog.md +76 -0
  310. package/docs/shared/react/iab/overview.md +80 -0
  311. package/docs/shared/react/iab/use-gvl-data.md +21 -0
  312. package/docs/shared/react/styling/classnames.md +93 -0
  313. package/docs/shared/react/styling/color-scheme.md +35 -0
  314. package/docs/shared/react/styling/css-variables.md +53 -0
  315. package/docs/shared/react/styling/overview.md +261 -0
  316. package/docs/shared/react/styling/slots.md +93 -0
  317. package/docs/shared/react/styling/stylesheet-entrypoint.md +8 -0
  318. package/docs/shared/react/styling/tailwind.md +88 -0
  319. package/docs/shared/react/styling/tokens.md +155 -0
  320. package/docs/shared/troubleshooting.md +82 -0
  321. package/package.json +23 -12
  322. package/readme.json +12 -7
  323. package/docs/ai-agents.md +0 -111
  324. package/docs/components/consent-dialog-trigger.md +0 -103
  325. package/docs/components/consent-manager-provider.md +0 -425
  326. package/docs/hooks/use-consent-manager/overview.md +0 -420
  327. package/docs/hooks/use-translations.md +0 -118
  328. package/docs/script-loader.md +0 -321
  329. package/docs/styling/css-variables.md +0 -92
  330. package/docs/styling/overview.md +0 -460
  331. package/docs/styling/slots.md +0 -128
  332. package/docs/styling/tokens.md +0 -216
@@ -1,7 +1,9 @@
1
1
  ---
2
2
  title: Build a Custom Script Integration
3
- description: 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.
4
- lastModified: 2026-04-10
3
+ description: Learn when to use a raw Script, when to build a reusable
4
+ manifest-backed integration, and how to debug and test custom consent-aware
5
+ scripts in c15t.
6
+ group: integrations
5
7
  ---
6
8
  If you cannot find a prebuilt integration in [`@c15t/scripts`](/docs/integrations), you have two good options:
7
9
 
@@ -220,186 +222,18 @@ If the vendor snippet is tiny, unique to one app, or mostly static, a plain `Scr
220
222
 
221
223
  ### Script
222
224
 
223
- |Property|Type|Description|Default|Required|
224
- |:--|:--|:--|:--|:--:|
225
- |id|string|Unique identifier for the script|-|✅ Required|
226
- |src|string \|undefined|URL of the script to load|-|Optional|
227
- |textContent|string \|undefined|Inline JavaScript code to execute|-|Optional|
228
- |category|HasCondition\<AllConsentNames>|Consent category or condition required to load this script|-|✅ Required|
229
- |callbackOnly|boolean \|undefined|Whether this is a callback-only script that doesn't need to load an external resource. When true, no script tag will be added to the DOM, only callbacks will be executed.|false|Optional|
230
- |persistAfterConsentRevoked|boolean \|undefined|Whether the script should persist after consent is revoked.|false|Optional|
231
- |alwaysLoad|boolean \|undefined|Whether the script should always load regardless of consent state. This is useful for scripts like Google Tag Manager or PostHog that manage their own consent state internally. The script will load immediately and never be unloaded based on consent changes. Note: When using this option, you are responsible for ensuring the script itself respects user consent preferences through its own consent management.|false|Optional|
232
- |fetchPriority|"high" \|"low" \|"auto" \|undefined|Priority hint for browser resource loading|-|Optional|
233
- |attributes|Record\<string, string> \|undefined|Additional attributes to add to the script element|-|Optional|
234
- |async|boolean \|undefined|Whether to use async loading|-|Optional|
235
- |defer|boolean \|undefined|Whether to defer script loading|-|Optional|
236
- |nonce|string \|undefined|Content Security Policy nonce|-|Optional|
237
- |anonymizeId|boolean \|undefined|Whether to use an anonymized ID for the script element, this helps ensure the script is not blocked by ad blockers|true|Optional|
238
- |target|"head" \|"body" \|undefined|Where to inject the script element in the DOM. Options: \`'head'\`: Scripts are appended to \`\<head>\` (default); \`'body'\`: Scripts are appended to \`\<body>\`|'head'|Optional|
239
- |onBeforeLoad|Object \|undefined|Callback executed before the script is loaded|-|Optional|
240
- |onLoad|Object \|undefined|Callback executed when the script loads successfully|-|Optional|
241
- |onError|Object \|undefined|Callback executed if the script fails to load|-|Optional|
242
- |onConsentChange|Object \|undefined|Callback executed whenever the consent store is changed. This callback only applies to scripts already loaded.|-|Optional|
243
- |vendorId|string \|number \|undefined|IAB TCF vendor ID - links script to a registered vendor. When in IAB mode, the script will only load if this vendor has consent. Takes precedence over \`category\` when in IAB mode. Use custom vendor IDs (string or number) to gate non-IAB vendors too.|-|Optional|
244
- |iabPurposes|number\[] \|undefined|IAB TCF purpose IDs this script requires consent for. When in IAB mode and no vendorId is set, the script will only load if ALL specified purposes have consent.|-|Optional|
245
- |iabLegIntPurposes|number\[] \|undefined|IAB TCF legitimate interest purpose IDs. These purposes can operate under legitimate interest instead of consent. The script loads if all iabPurposes have consent OR all iabLegIntPurposes have legitimate interest established.|-|Optional|
246
- |iabSpecialFeatures|number\[] \|undefined|IAB TCF special feature IDs this script requires. Options: 1: Use precise geolocation data; 2: Actively scan device characteristics for identification|-|Optional|
247
-
248
- #### `onBeforeLoad`
249
-
250
- Callback executed before the script is loaded
251
-
252
- |Property|Type|Description|Default|Required|
253
- |:--|:--|:--|:--|:--:|
254
- |id|string|The original script ID|-|✅ Required|
255
- |elementId|string|The actual DOM element ID used (anonymized if enabled)|-|✅ Required|
256
- |hasConsent|boolean|Has consent|-|✅ Required|
257
- |consents|ConsentState|The current consent state|-|✅ Required|
258
- |element|HTMLScriptElement \|undefined|The script element (for load/error callbacks) Will be undefined for callback-only scripts|-|Optional|
259
- |error|Error \|undefined|Error information (for error callbacks)|-|Optional|
260
-
261
- #### `onLoad`
262
-
263
- Callback executed when the script loads successfully
264
-
265
- |Property|Type|Description|Default|Required|
266
- |:--|:--|:--|:--|:--:|
267
- |id|string|The original script ID|-|✅ Required|
268
- |elementId|string|The actual DOM element ID used (anonymized if enabled)|-|✅ Required|
269
- |hasConsent|boolean|Has consent|-|✅ Required|
270
- |consents|ConsentState|The current consent state|-|✅ Required|
271
- |element|HTMLScriptElement \|undefined|The script element (for load/error callbacks) Will be undefined for callback-only scripts|-|Optional|
272
- |error|Error \|undefined|Error information (for error callbacks)|-|Optional|
273
-
274
- #### `onError`
275
-
276
- Callback executed if the script fails to load
277
-
278
- |Property|Type|Description|Default|Required|
279
- |:--|:--|:--|:--|:--:|
280
- |id|string|The original script ID|-|✅ Required|
281
- |elementId|string|The actual DOM element ID used (anonymized if enabled)|-|✅ Required|
282
- |hasConsent|boolean|Has consent|-|✅ Required|
283
- |consents|ConsentState|The current consent state|-|✅ Required|
284
- |element|HTMLScriptElement \|undefined|The script element (for load/error callbacks) Will be undefined for callback-only scripts|-|Optional|
285
- |error|Error \|undefined|Error information (for error callbacks)|-|Optional|
286
-
287
- #### `onConsentChange`
288
-
289
- Callback executed whenever the consent store is changed. This callback only applies to scripts already loaded.
290
-
291
- |Property|Type|Description|Default|Required|
292
- |:--|:--|:--|:--|:--:|
293
- |id|string|The original script ID|-|✅ Required|
294
- |elementId|string|The actual DOM element ID used (anonymized if enabled)|-|✅ Required|
295
- |hasConsent|boolean|Has consent|-|✅ Required|
296
- |consents|ConsentState|The current consent state|-|✅ Required|
297
- |element|HTMLScriptElement \|undefined|The script element (for load/error callbacks) Will be undefined for callback-only scripts|-|Optional|
298
- |error|Error \|undefined|Error information (for error callbacks)|-|Optional|
225
+ |Property|Value|
226
+ |:--|:--|
227
+ |Type Name|\`Script\`|
228
+ |Source Path|\`./packages/core/src/libs/script-loader/types.ts\`|
299
229
 
300
- ### VendorManifest
301
-
302
- |Property|Type|Description|Default|Required|
303
- |:--|:--|:--|:--|:--:|
304
- |kind|"c15t.vendor-manifest"|Manifest contract identifier.|-|✅ Required|
305
- |schemaVersion|1|Manifest schema version.|-|✅ Required|
306
- |vendor|string|Unique vendor identifier (used as Script.id)|-|✅ Required|
307
- |category|ManifestCategoryCondition|Consent category or condition required to load this vendor|-|✅ Required|
308
- |alwaysLoad|string \|boolean \|undefined|Load regardless of consent state (vendor manages its own consent internally)|-|Optional|
309
- |persistAfterConsentRevoked|string \|boolean \|undefined|Keep script in DOM after consent revocation (vendor has a consent API)|-|Optional|
310
- |bootstrap|ManifestStep \|undefined|Steps that must execute before default consent signaling. This is primarily used for integrations such as Google tags where a stub global must exist before calling the vendor's consent API.|-|Optional|
311
- |install|ManifestStep|Steps to execute when installing the vendor.|-|✅ Required|
312
- |afterLoad|ManifestStep \|undefined|Steps to execute after the main script loads|-|Optional|
313
- |onBeforeLoadGranted|ManifestStep \|undefined|Steps to execute before load when the vendor has consent|-|Optional|
314
- |onBeforeLoadDenied|ManifestStep \|undefined|Steps to execute before load when the vendor does not have consent|-|Optional|
315
- |onLoadGranted|ManifestStep \|undefined|Steps to execute after load when the vendor has consent|-|Optional|
316
- |onLoadDenied|ManifestStep \|undefined|Steps to execute after load when the vendor does not have consent|-|Optional|
317
- |onConsentChange|ManifestStep \|undefined|Steps to run on any consent state change|-|Optional|
318
- |onConsentGranted|ManifestStep \|undefined|Steps to run when this vendor's category consent is granted|-|Optional|
319
- |onConsentDenied|ManifestStep \|undefined|Steps to run when this vendor's category consent is denied|-|Optional|
320
- |consentMapping|Record\<string, string\[]> \|undefined|Maps c15t consent categories to vendor-specific consent type names. Used with \`consentSignal\` to translate c15t consent state into the vendor's consent API format.|-|Optional|
321
- |consentSignal|"gtag" \|undefined|How to signal consent state to the vendor|-|Optional|
322
- |consentSignalTarget|string \|undefined|Target global for consent signaling (defaults based on signal type)|-|Optional|
323
-
324
- #### `bootstrap` ManifestStep
325
-
326
- Steps that must execute before default consent signaling. This is primarily used for integrations such as Google tags where a stub global must exist before calling the vendor's consent API.
327
-
328
- |Property|Type|Description|Default|Required|
329
- |:--|:--|:--|:--|:--:|
330
- |type|Object|-|-|✅ Required|
331
-
332
- #### `install` ManifestStep
333
-
334
- Steps to execute when installing the vendor.
335
-
336
- * If a \`loadScript\` step exists, its \`src\` becomes \`Script.src\`
337
- * All non-\`loadScript\` steps run as part of \`onBeforeLoad\`
338
-
339
- |Property|Type|Description|Default|Required|
340
- |:--|:--|:--|:--|:--:|
341
- |type|Object|-|-|✅ Required|
342
-
343
- #### `afterLoad` ManifestStep
344
-
345
- Steps to execute after the main script loads
346
-
347
- |Property|Type|Description|Default|Required|
348
- |:--|:--|:--|:--|:--:|
349
- |type|Object|-|-|✅ Required|
350
-
351
- #### `onBeforeLoadGranted` ManifestStep
352
-
353
- Steps to execute before load when the vendor has consent
354
-
355
- |Property|Type|Description|Default|Required|
356
- |:--|:--|:--|:--|:--:|
357
- |type|Object|-|-|✅ Required|
358
-
359
- #### `onBeforeLoadDenied` ManifestStep
230
+ \*ExtractedTypeTable: Could not extract "Script" from "./packages/core/src/libs/script-loader/types.ts" using base path "/home/runner/work/c15t/c15t". Verify the path/name and that the file is included by your tsconfig.\*
360
231
 
361
- Steps to execute before load when the vendor does not have consent
362
-
363
- |Property|Type|Description|Default|Required|
364
- |:--|:--|:--|:--|:--:|
365
- |type|Object|-|-|✅ Required|
366
-
367
- #### `onLoadGranted` ManifestStep
368
-
369
- Steps to execute after load when the vendor has consent
370
-
371
- |Property|Type|Description|Default|Required|
372
- |:--|:--|:--|:--|:--:|
373
- |type|Object|-|-|✅ Required|
374
-
375
- #### `onLoadDenied` ManifestStep
376
-
377
- Steps to execute after load when the vendor does not have consent
378
-
379
- |Property|Type|Description|Default|Required|
380
- |:--|:--|:--|:--|:--:|
381
- |type|Object|-|-|✅ Required|
382
-
383
- #### `onConsentChange` ManifestStep
384
-
385
- Steps to run on any consent state change
386
-
387
- |Property|Type|Description|Default|Required|
388
- |:--|:--|:--|:--|:--:|
389
- |type|Object|-|-|✅ Required|
390
-
391
- #### `onConsentGranted` ManifestStep
392
-
393
- Steps to run when this vendor's category consent is granted
394
-
395
- |Property|Type|Description|Default|Required|
396
- |:--|:--|:--|:--|:--:|
397
- |type|Object|-|-|✅ Required|
398
-
399
- #### `onConsentDenied` ManifestStep
232
+ ### VendorManifest
400
233
 
401
- Steps to run when this vendor's category consent is denied
234
+ |Property|Value|
235
+ |:--|:--|
236
+ |Type Name|\`VendorManifest\`|
237
+ |Source Path|\`./packages/scripts/src/types.ts\`|
402
238
 
403
- |Property|Type|Description|Default|Required|
404
- |:--|:--|:--|:--|:--:|
405
- |type|Object|-|-|✅ Required|
239
+ \*ExtractedTypeTable: Could not extract "VendorManifest" from "./packages/scripts/src/types.ts" using base path "/home/runner/work/c15t/c15t". Verify the path/name and that the file is included by your tsconfig.\*
@@ -0,0 +1,130 @@
1
+ ---
2
+ title: Clearbit
3
+ description: Visitor and company enrichment loaded with Clearbit's account-keyed
4
+ tags.js snippet.
5
+ group: integrations
6
+ icon: clearbit
7
+ ---
8
+ [Clearbit](https://clearbit.com) provides visitor and company enrichment for go-to-market workflows. The official embed loads `https://tag.clearbitscripts.com/v1/{publishableKey}/tags.js` with a `referrerpolicy` of `strict-origin-when-cross-origin`.
9
+
10
+ ## Integrate with c15t
11
+
12
+ **React**
13
+
14
+ ```tsx
15
+ import { type ReactNode } from 'react';
16
+ import { ConsentManagerProvider } from '@c15t/react';
17
+ import { clearbit } from '@c15t/scripts/clearbit';
18
+
19
+ const scripts = [
20
+ clearbit({
21
+ publishableKey: 'YOUR_PUBLISHABLE_KEY',
22
+ }),
23
+ ];
24
+
25
+ export function ConsentProvider({ children }: { children: ReactNode }) {
26
+ return (
27
+ <ConsentManagerProvider
28
+ options={{
29
+ mode: 'hosted',
30
+ backendURL: 'https://your-instance.c15t.dev',
31
+ scripts,
32
+ }}
33
+ >
34
+ {children}
35
+ </ConsentManagerProvider>
36
+ );
37
+ }
38
+ ```
39
+
40
+ **Next.js**
41
+
42
+ ```tsx
43
+ 'use client';
44
+
45
+ import { type ReactNode } from 'react';
46
+ import { ConsentManagerProvider } from '@c15t/nextjs';
47
+ import { clearbit } from '@c15t/scripts/clearbit';
48
+
49
+ const scripts = [
50
+ clearbit({
51
+ publishableKey: 'YOUR_PUBLISHABLE_KEY',
52
+ }),
53
+ ];
54
+
55
+ export function ConsentProvider({ children }: { children: ReactNode }) {
56
+ return (
57
+ <ConsentManagerProvider
58
+ options={{
59
+ mode: 'hosted',
60
+ backendURL: '/api/c15t',
61
+ scripts,
62
+ }}
63
+ >
64
+ {children}
65
+ </ConsentManagerProvider>
66
+ );
67
+ }
68
+ ```
69
+
70
+ **JavaScript**
71
+
72
+ ```ts
73
+ import { getOrCreateConsentRuntime } from 'c15t';
74
+ import { clearbit } from '@c15t/scripts/clearbit';
75
+
76
+ getOrCreateConsentRuntime({
77
+ mode: 'hosted',
78
+ backendURL: 'https://your-instance.c15t.dev',
79
+ scripts: [
80
+ clearbit({
81
+ publishableKey: 'YOUR_PUBLISHABLE_KEY',
82
+ }),
83
+ ],
84
+ });
85
+ ```
86
+
87
+ ## How c15t loads it
88
+
89
+ * **Category:** `marketing` (Analytics discovery, marketing-sensitive consent)
90
+ * **Loads when:** marketing consent is granted
91
+ * **On revocation:** unloaded — c15t removes the script element from the DOM.
92
+
93
+ Clearbit enrichment tools are privacy-sensitive because they can identify visitors and companies for profiling, enrichment, and intent use cases. The GitHub issue left the category open between measurement and marketing; c15t defaults this integration to `marketing` because enrichment is not just aggregate measurement. The script stays blocked until marketing consent is granted. On revocation c15t removes the script element it created; tags that Clearbit's loader has already appended can keep running until the next page load (c15t reloads the page on revocation by default), so treat the load gate as the consent boundary.
94
+
95
+ The helper maps Clearbit's official snippet:
96
+
97
+ ```ts
98
+ clearbit({
99
+ publishableKey: 'YOUR_PUBLISHABLE_KEY',
100
+ })
101
+ ```
102
+
103
+ To proxy or self-host the loader, pass a custom URL:
104
+
105
+ ```ts
106
+ clearbit({
107
+ publishableKey: 'YOUR_PUBLISHABLE_KEY',
108
+ scriptUrl: 'https://analytics.example.com/clearbit-tags.js',
109
+ })
110
+ ```
111
+
112
+ ## Types
113
+
114
+ ### ClearbitOptions
115
+
116
+ |Property|Value|
117
+ |:--|:--|
118
+ |Type Name|\`ClearbitOptions\`|
119
+ |Source Path|\`./packages/scripts/src/vendors/analytics/clearbit.ts\`|
120
+
121
+ \*ExtractedTypeTable: Could not extract "ClearbitOptions" from "./packages/scripts/src/vendors/analytics/clearbit.ts" using base path "/home/runner/work/c15t/c15t". Verify the path/name and that the file is included by your tsconfig.\*
122
+
123
+ ### Script
124
+
125
+ |Property|Value|
126
+ |:--|:--|
127
+ |Type Name|\`Script\`|
128
+ |Source Path|\`./packages/core/src/libs/script-loader/types.ts\`|
129
+
130
+ \*ExtractedTypeTable: Could not extract "Script" from "./packages/core/src/libs/script-loader/types.ts" using base path "/home/runner/work/c15t/c15t". Verify the path/name and that the file is included by your tsconfig.\*
@@ -0,0 +1,126 @@
1
+ ---
2
+ title: Cloudflare Web Analytics
3
+ description: Cookieless analytics from Cloudflare with a prebuilt helper that
4
+ serializes the beacon config into the `data-cf-beacon` attribute.
5
+ group: integrations
6
+ icon: cloudflare-web-analytics
7
+ ---
8
+ Cloudflare Web Analytics is a cookieless analytics product configured through a single `data-cf-beacon` attribute on its loader. The `cloudflareWebAnalytics()` helper serializes your token and single-page application (SPA) preference into that attribute and hands the result to c15t's script loader.
9
+
10
+ ## Integrate with c15t
11
+
12
+ **React**
13
+
14
+ ```tsx
15
+ import { type ReactNode } from 'react';
16
+ import { ConsentManagerProvider } from '@c15t/react';
17
+ import { cloudflareWebAnalytics } from '@c15t/scripts/cloudflare-web-analytics';
18
+
19
+ const scripts = [
20
+ cloudflareWebAnalytics({
21
+ token: 'your-cloudflare-token',
22
+ }),
23
+ ];
24
+
25
+ export function ConsentProvider({ children }: { children: ReactNode }) {
26
+ return (
27
+ <ConsentManagerProvider
28
+ options={{
29
+ mode: 'hosted',
30
+ backendURL: 'https://your-instance.c15t.dev',
31
+ scripts,
32
+ }}
33
+ >
34
+ {children}
35
+ </ConsentManagerProvider>
36
+ );
37
+ }
38
+ ```
39
+
40
+ **Next.js**
41
+
42
+ ```tsx
43
+ 'use client';
44
+
45
+ import { type ReactNode } from 'react';
46
+ import { ConsentManagerProvider } from '@c15t/nextjs';
47
+ import { cloudflareWebAnalytics } from '@c15t/scripts/cloudflare-web-analytics';
48
+
49
+ const scripts = [
50
+ cloudflareWebAnalytics({
51
+ token: 'your-cloudflare-token',
52
+ }),
53
+ ];
54
+
55
+ export function ConsentProvider({ children }: { children: ReactNode }) {
56
+ return (
57
+ <ConsentManagerProvider
58
+ options={{
59
+ mode: 'hosted',
60
+ backendURL: '/api/c15t',
61
+ scripts,
62
+ }}
63
+ >
64
+ {children}
65
+ </ConsentManagerProvider>
66
+ );
67
+ }
68
+ ```
69
+
70
+ **JavaScript**
71
+
72
+ ```ts
73
+ import { getOrCreateConsentRuntime } from 'c15t';
74
+ import { cloudflareWebAnalytics } from '@c15t/scripts/cloudflare-web-analytics';
75
+
76
+ getOrCreateConsentRuntime({
77
+ mode: 'hosted',
78
+ backendURL: 'https://your-instance.c15t.dev',
79
+ scripts: [
80
+ cloudflareWebAnalytics({
81
+ token: 'your-cloudflare-token',
82
+ }),
83
+ ],
84
+ });
85
+ ```
86
+
87
+ ## How c15t loads it
88
+
89
+ * **Category:** `measurement` (Analytics)
90
+ * **Loads when:** measurement consent is granted
91
+ * **On revocation:** unloaded — c15t removes the script element from the DOM. Cloudflare Web Analytics is cookieless, so no client-side state needs clearing.
92
+
93
+ SPA route tracking is enabled by default. Disable it for traditional multi-page apps:
94
+
95
+ ```ts
96
+ cloudflareWebAnalytics({
97
+ token: 'your-cloudflare-token',
98
+ spa: false,
99
+ })
100
+ ```
101
+
102
+ The helper JSON-encodes `{ token, spa }` into the `data-cf-beacon` attribute that Cloudflare's loader reads at startup, matching Cloudflare's recommended embed.
103
+
104
+ ## Tracking events in your app
105
+
106
+ Cloudflare Web Analytics has no app-facing event API — the beacon tracks pageviews automatically once the script is loaded. There are no event calls in your application code to guard, so c15t's consent gating fully controls when and whether tracking happens.
107
+
108
+ ## Types
109
+
110
+ ### CloudflareWebAnalyticsOptions
111
+
112
+ |Property|Value|
113
+ |:--|:--|
114
+ |Type Name|\`CloudflareWebAnalyticsOptions\`|
115
+ |Source Path|\`./packages/scripts/src/vendors/analytics/cloudflare-web-analytics.ts\`|
116
+
117
+ \*ExtractedTypeTable: Could not extract "CloudflareWebAnalyticsOptions" from "./packages/scripts/src/vendors/analytics/cloudflare-web-analytics.ts" using base path "/home/runner/work/c15t/c15t". Verify the path/name and that the file is included by your tsconfig.\*
118
+
119
+ ### Script
120
+
121
+ |Property|Value|
122
+ |:--|:--|
123
+ |Type Name|\`Script\`|
124
+ |Source Path|\`./packages/core/src/libs/script-loader/types.ts\`|
125
+
126
+ \*ExtractedTypeTable: Could not extract "Script" from "./packages/core/src/libs/script-loader/types.ts" using base path "/home/runner/work/c15t/c15t". Verify the path/name and that the file is included by your tsconfig.\*
@@ -0,0 +1,140 @@
1
+ ---
2
+ title: Crisp
3
+ description: Load Crisp live chat with website ID, runtime, cookie, and session options.
4
+ group: integrations
5
+ icon: crisp
6
+ ---
7
+ Crisp adds the Crisp live chat widget and exposes the `$crisp` queue for
8
+ chatbox actions such as opening the chat, setting user details, and resetting
9
+ sessions.
10
+
11
+ ## Official Crisp documentation
12
+
13
+ * [Web Chat SDK](https://docs.crisp.chat/guides/chatbox-sdks/web-sdk/)
14
+ * [$crisp methods](https://docs.crisp.chat/guides/chatbox-sdks/web-sdk/dollar-crisp/)
15
+ * [Identity verification](https://docs.crisp.chat/guides/chatbox-sdks/web-sdk/identity-verification/)
16
+ * [Cookie policies](https://docs.crisp.chat/guides/chatbox-sdks/web-sdk/cookie-policies/)
17
+ * [Session continuity](https://docs.crisp.chat/guides/chatbox-sdks/web-sdk/session-continuity/)
18
+ * [Language customization](https://docs.crisp.chat/guides/chatbox-sdks/web-sdk/language-customization/)
19
+
20
+ ## Integrate with c15t
21
+
22
+ **React**
23
+
24
+ ```tsx
25
+ import { type ReactNode } from 'react';
26
+ import { ConsentManagerProvider } from '@c15t/react';
27
+ import { crisp } from '@c15t/scripts/crisp';
28
+
29
+ const scripts = [crisp({ websiteId: 'crisp-123' })];
30
+
31
+ export function ConsentProvider({ children }: { children: ReactNode }) {
32
+ return (
33
+ <ConsentManagerProvider
34
+ options={{
35
+ mode: 'hosted',
36
+ backendURL: 'https://your-instance.c15t.dev',
37
+ scripts,
38
+ }}
39
+ >
40
+ {children}
41
+ </ConsentManagerProvider>
42
+ );
43
+ }
44
+ ```
45
+
46
+ **Next.js**
47
+
48
+ ```tsx
49
+ 'use client';
50
+
51
+ import { type ReactNode } from 'react';
52
+ import { ConsentManagerProvider } from '@c15t/nextjs';
53
+ import { crisp } from '@c15t/scripts/crisp';
54
+
55
+ const scripts = [crisp({ websiteId: 'crisp-123' })];
56
+
57
+ export function ConsentProvider({ children }: { children: ReactNode }) {
58
+ return (
59
+ <ConsentManagerProvider
60
+ options={{
61
+ mode: 'hosted',
62
+ backendURL: '/api/c15t',
63
+ scripts,
64
+ }}
65
+ >
66
+ {children}
67
+ </ConsentManagerProvider>
68
+ );
69
+ }
70
+ ```
71
+
72
+ **JavaScript**
73
+
74
+ ```ts
75
+ import { getOrCreateConsentRuntime } from 'c15t';
76
+ import { crisp } from '@c15t/scripts/crisp';
77
+
78
+ getOrCreateConsentRuntime({
79
+ mode: 'hosted',
80
+ backendURL: 'https://your-instance.c15t.dev',
81
+ scripts: [crisp({ websiteId: 'crisp-123' })],
82
+ });
83
+ ```
84
+
85
+ ## How c15t loads it
86
+
87
+ * **Category:** `functionality` (Functional)
88
+ * **Loads when:** functionality consent is granted
89
+ * **Before load:** c15t seeds `window.$crisp`, `CRISP_WEBSITE_ID`, and any
90
+ optional Crisp runtime globals
91
+ * **On revocation:** c15t follows the default script loader behavior for
92
+ non-persistent scripts
93
+
94
+ ## Configure the integration
95
+
96
+ The helper seeds Crisp's documented globals before loading
97
+ `https://client.crisp.chat/l.js`.
98
+
99
+ ```ts
100
+ crisp({
101
+ websiteId: 'crisp-123',
102
+ locale: 'fr',
103
+ cookieDomain: 'app.example.com',
104
+ cookieExpiry: 3600,
105
+ tokenId: 'secure-user-token',
106
+ sessionMerge: true,
107
+ safeMode: true,
108
+ })
109
+ ```
110
+
111
+ `locale` and `sessionMerge` are written to `CRISP_RUNTIME_CONFIG`.
112
+ `cookieDomain` maps to `CRISP_COOKIE_DOMAIN`, `cookieExpiry` maps to
113
+ `CRISP_COOKIE_EXPIRE`, and `tokenId` maps to `CRISP_TOKEN_ID`. `safeMode`
114
+ queues `['safe', true]` on `window.$crisp` before the loader runs so Crisp
115
+ starts in safe mode.
116
+
117
+ For session continuity, generate `tokenId` on your backend with a secure random
118
+ value. Do not use emails, hashes of emails, timestamps, or incrementing IDs as
119
+ Crisp session tokens. If you verify user emails, generate the HMAC signature on
120
+ your backend and set it with Crisp's `$crisp` API after the helper loads.
121
+
122
+ ## Types
123
+
124
+ ### CrispOptions
125
+
126
+ |Property|Value|
127
+ |:--|:--|
128
+ |Type Name|\`CrispOptions\`|
129
+ |Source Path|\`./packages/scripts/src/vendors/functional/crisp.ts\`|
130
+
131
+ \*ExtractedTypeTable: Could not extract "CrispOptions" from "./packages/scripts/src/vendors/functional/crisp.ts" using base path "/home/runner/work/c15t/c15t". Verify the path/name and that the file is included by your tsconfig.\*
132
+
133
+ ### Script
134
+
135
+ |Property|Value|
136
+ |:--|:--|
137
+ |Type Name|\`Script\`|
138
+ |Source Path|\`./packages/core/src/libs/script-loader/types.ts\`|
139
+
140
+ \*ExtractedTypeTable: Could not extract "Script" from "./packages/core/src/libs/script-loader/types.ts" using base path "/home/runner/work/c15t/c15t". Verify the path/name and that the file is included by your tsconfig.\*