@codefast/tracking 0.5.0-canary.5 → 1.0.0-canary.7

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 (276) hide show
  1. package/CHANGELOG.md +220 -0
  2. package/README.md +176 -126
  3. package/dist/adapters/tanstack-start.d.ts +80 -0
  4. package/dist/adapters/tanstack-start.d.ts.map +1 -0
  5. package/dist/adapters/tanstack-start.js +74 -0
  6. package/dist/adapters/tanstack-start.js.map +1 -0
  7. package/dist/client/ad-framework-consent.d.ts +62 -0
  8. package/dist/client/ad-framework-consent.d.ts.map +1 -0
  9. package/dist/client/ad-framework-consent.js +40 -0
  10. package/dist/client/ad-framework-consent.js.map +1 -0
  11. package/dist/client/browser-cookie.d.ts +9 -0
  12. package/dist/client/browser-cookie.d.ts.map +1 -0
  13. package/dist/client/browser-cookie.js +15 -0
  14. package/dist/client/browser-cookie.js.map +1 -0
  15. package/dist/client/consent-runtime.d.ts +53 -0
  16. package/dist/client/consent-runtime.d.ts.map +1 -0
  17. package/dist/client/consent-runtime.js +33 -0
  18. package/dist/client/consent-runtime.js.map +1 -0
  19. package/dist/client/{consent-storage.d.mts → consent-storage.d.ts} +8 -6
  20. package/dist/client/consent-storage.d.ts.map +1 -0
  21. package/dist/client/consent-storage.js +109 -0
  22. package/dist/client/consent-storage.js.map +1 -0
  23. package/dist/client/consent-withdrawal.d.ts +18 -0
  24. package/dist/client/consent-withdrawal.d.ts.map +1 -0
  25. package/dist/client/consent-withdrawal.js +17 -0
  26. package/dist/client/consent-withdrawal.js.map +1 -0
  27. package/dist/client/cookie-anonymous-id.d.ts +41 -0
  28. package/dist/client/cookie-anonymous-id.d.ts.map +1 -0
  29. package/dist/client/cookie-anonymous-id.js +65 -0
  30. package/dist/client/cookie-anonymous-id.js.map +1 -0
  31. package/dist/client/create-client-tracker.d.ts +60 -0
  32. package/dist/client/create-client-tracker.d.ts.map +1 -0
  33. package/dist/client/create-client-tracker.js +91 -0
  34. package/dist/client/create-client-tracker.js.map +1 -0
  35. package/dist/client/gpc.d.ts +10 -0
  36. package/dist/client/gpc.d.ts.map +1 -0
  37. package/dist/client/gpc.js +12 -0
  38. package/dist/client/gpc.js.map +1 -0
  39. package/dist/client/initial-consent-store.d.ts +63 -0
  40. package/dist/client/initial-consent-store.d.ts.map +1 -0
  41. package/dist/client/initial-consent-store.js +138 -0
  42. package/dist/client/initial-consent-store.js.map +1 -0
  43. package/dist/client/is-analytics-allowed.d.ts +26 -0
  44. package/dist/client/is-analytics-allowed.d.ts.map +1 -0
  45. package/dist/client/is-analytics-allowed.js +22 -0
  46. package/dist/client/is-analytics-allowed.js.map +1 -0
  47. package/dist/client/server-persisted-anonymous-id.d.ts +30 -0
  48. package/dist/client/server-persisted-anonymous-id.d.ts.map +1 -0
  49. package/dist/client/server-persisted-anonymous-id.js +72 -0
  50. package/dist/client/server-persisted-anonymous-id.js.map +1 -0
  51. package/dist/core/consent-config.d.ts +24 -0
  52. package/dist/core/consent-config.d.ts.map +1 -0
  53. package/dist/core/consent-config.js +9 -0
  54. package/dist/core/consent-config.js.map +1 -0
  55. package/dist/core/consent-receipt.d.ts +71 -0
  56. package/dist/core/consent-receipt.d.ts.map +1 -0
  57. package/dist/core/consent-receipt.js +39 -0
  58. package/dist/core/consent-receipt.js.map +1 -0
  59. package/dist/core/consent.d.ts +182 -0
  60. package/dist/core/consent.d.ts.map +1 -0
  61. package/dist/core/consent.js +159 -0
  62. package/dist/core/consent.js.map +1 -0
  63. package/dist/core/cookie.d.ts +15 -0
  64. package/dist/core/cookie.d.ts.map +1 -0
  65. package/dist/core/cookie.js +26 -0
  66. package/dist/core/cookie.js.map +1 -0
  67. package/dist/core/destination.d.ts +29 -0
  68. package/dist/core/destination.d.ts.map +1 -0
  69. package/dist/core/destination.js +2 -0
  70. package/dist/core/destination.js.map +1 -0
  71. package/dist/core/event-catalog.d.ts +35 -0
  72. package/dist/core/event-catalog.d.ts.map +1 -0
  73. package/dist/core/event-catalog.js +30 -0
  74. package/dist/core/event-catalog.js.map +1 -0
  75. package/dist/core/event-id.d.ts +7 -0
  76. package/dist/core/event-id.d.ts.map +1 -0
  77. package/dist/core/event-id.js +9 -0
  78. package/dist/core/event-id.js.map +1 -0
  79. package/dist/core/tracked-event.d.ts +15 -0
  80. package/dist/core/tracked-event.d.ts.map +1 -0
  81. package/dist/core/tracked-event.js +2 -0
  82. package/dist/core/tracked-event.js.map +1 -0
  83. package/dist/destinations/ad-consent.d.ts +23 -0
  84. package/dist/destinations/ad-consent.d.ts.map +1 -0
  85. package/dist/destinations/ad-consent.js +12 -0
  86. package/dist/destinations/ad-consent.js.map +1 -0
  87. package/dist/destinations/google-analytics.d.ts +148 -0
  88. package/dist/destinations/google-analytics.d.ts.map +1 -0
  89. package/dist/destinations/google-analytics.js +156 -0
  90. package/dist/destinations/google-analytics.js.map +1 -0
  91. package/dist/destinations/google-consent.d.ts +62 -0
  92. package/dist/destinations/google-consent.d.ts.map +1 -0
  93. package/dist/destinations/google-consent.js +109 -0
  94. package/dist/destinations/google-consent.js.map +1 -0
  95. package/dist/destinations/meta.d.ts +63 -0
  96. package/dist/destinations/meta.d.ts.map +1 -0
  97. package/dist/destinations/meta.js +44 -0
  98. package/dist/destinations/meta.js.map +1 -0
  99. package/dist/destinations/microsoft-uet.d.ts +56 -0
  100. package/dist/destinations/microsoft-uet.d.ts.map +1 -0
  101. package/dist/destinations/microsoft-uet.js +41 -0
  102. package/dist/destinations/microsoft-uet.js.map +1 -0
  103. package/dist/destinations/shared.d.ts +18 -0
  104. package/dist/destinations/shared.d.ts.map +1 -0
  105. package/dist/destinations/shared.js +19 -0
  106. package/dist/destinations/shared.js.map +1 -0
  107. package/dist/destinations/tiktok.d.ts +55 -0
  108. package/dist/destinations/tiktok.d.ts.map +1 -0
  109. package/dist/destinations/tiktok.js +40 -0
  110. package/dist/destinations/tiktok.js.map +1 -0
  111. package/dist/destinations/vercel-analytics.d.ts +25 -0
  112. package/dist/destinations/vercel-analytics.d.ts.map +1 -0
  113. package/dist/destinations/vercel-analytics.js +23 -0
  114. package/dist/destinations/vercel-analytics.js.map +1 -0
  115. package/dist/index.d.ts +64 -0
  116. package/dist/index.d.ts.map +1 -0
  117. package/dist/index.js +41 -0
  118. package/dist/index.js.map +1 -0
  119. package/dist/react/consent-banner.d.ts +155 -0
  120. package/dist/react/consent-banner.d.ts.map +1 -0
  121. package/dist/react/consent-banner.js +171 -0
  122. package/dist/react/consent-banner.js.map +1 -0
  123. package/dist/react/gtag-consent-bootstrap.d.ts +17 -0
  124. package/dist/react/gtag-consent-bootstrap.d.ts.map +1 -0
  125. package/dist/react/gtag-consent-bootstrap.js +22 -0
  126. package/dist/react/gtag-consent-bootstrap.js.map +1 -0
  127. package/dist/react/use-consent.d.ts +42 -0
  128. package/dist/react/use-consent.d.ts.map +1 -0
  129. package/dist/react/use-consent.js +60 -0
  130. package/dist/react/use-consent.js.map +1 -0
  131. package/dist/react/use-google-consent-sync.d.ts +20 -0
  132. package/dist/react/use-google-consent-sync.d.ts.map +1 -0
  133. package/dist/react/use-google-consent-sync.js +22 -0
  134. package/dist/react/use-google-consent-sync.js.map +1 -0
  135. package/dist/react/use-initial-consent.d.ts +11 -0
  136. package/dist/react/use-initial-consent.d.ts.map +1 -0
  137. package/dist/react/use-initial-consent.js +18 -0
  138. package/dist/react/use-initial-consent.js.map +1 -0
  139. package/dist/server/anonymous-id-cookie.d.ts +67 -0
  140. package/dist/server/anonymous-id-cookie.d.ts.map +1 -0
  141. package/dist/server/anonymous-id-cookie.js +71 -0
  142. package/dist/server/anonymous-id-cookie.js.map +1 -0
  143. package/dist/server/consent-receipt-store.d.ts +56 -0
  144. package/dist/server/consent-receipt-store.d.ts.map +1 -0
  145. package/dist/server/consent-receipt-store.js +44 -0
  146. package/dist/server/consent-receipt-store.js.map +1 -0
  147. package/dist/server/consent-receipt.d.ts +41 -0
  148. package/dist/server/consent-receipt.d.ts.map +1 -0
  149. package/dist/server/consent-receipt.js +60 -0
  150. package/dist/server/consent-receipt.js.map +1 -0
  151. package/dist/server/initial-consent.d.ts +26 -0
  152. package/dist/server/initial-consent.d.ts.map +1 -0
  153. package/dist/server/initial-consent.js +31 -0
  154. package/dist/server/initial-consent.js.map +1 -0
  155. package/dist/server/measurement-protocol.d.ts +69 -0
  156. package/dist/server/measurement-protocol.d.ts.map +1 -0
  157. package/dist/server/measurement-protocol.js +61 -0
  158. package/dist/server/measurement-protocol.js.map +1 -0
  159. package/dist/server/region.d.ts +27 -0
  160. package/dist/server/region.d.ts.map +1 -0
  161. package/dist/server/region.js +69 -0
  162. package/dist/server/region.js.map +1 -0
  163. package/dist/server/user-deletion.d.ts +64 -0
  164. package/dist/server/user-deletion.d.ts.map +1 -0
  165. package/dist/server/user-deletion.js +54 -0
  166. package/dist/server/user-deletion.js.map +1 -0
  167. package/dist/tooling/import-protection.d.ts +19 -0
  168. package/dist/tooling/import-protection.d.ts.map +1 -0
  169. package/dist/tooling/import-protection.js +23 -0
  170. package/dist/tooling/import-protection.js.map +1 -0
  171. package/package.json +203 -108
  172. package/src/adapters/tanstack-start.ts +135 -0
  173. package/src/client/ad-framework-consent.ts +86 -0
  174. package/src/client/browser-cookie.ts +16 -0
  175. package/src/client/consent-runtime.ts +80 -0
  176. package/src/client/consent-storage.ts +31 -1
  177. package/src/client/consent-withdrawal.ts +32 -0
  178. package/src/client/cookie-anonymous-id.ts +112 -0
  179. package/src/client/create-client-tracker.ts +128 -86
  180. package/src/client/gpc.ts +4 -2
  181. package/src/client/initial-consent-store.ts +218 -0
  182. package/src/client/is-analytics-allowed.ts +43 -0
  183. package/src/client/server-persisted-anonymous-id.ts +102 -0
  184. package/src/core/consent-config.ts +27 -0
  185. package/src/core/consent-receipt.ts +115 -0
  186. package/src/core/consent.ts +164 -10
  187. package/src/core/cookie.ts +29 -0
  188. package/src/core/destination.ts +17 -8
  189. package/src/core/event-catalog.ts +29 -15
  190. package/src/core/event-id.ts +1 -2
  191. package/src/core/tracked-event.ts +4 -4
  192. package/src/destinations/ad-consent.ts +29 -0
  193. package/src/destinations/google-analytics.ts +196 -133
  194. package/src/destinations/google-consent.ts +164 -0
  195. package/src/destinations/meta.ts +96 -0
  196. package/src/destinations/microsoft-uet.ts +86 -0
  197. package/src/destinations/shared.ts +45 -0
  198. package/src/destinations/tiktok.ts +85 -0
  199. package/src/destinations/vercel-analytics.ts +23 -24
  200. package/src/index.ts +165 -8
  201. package/src/react/consent-banner.tsx +40 -14
  202. package/src/react/gtag-consent-bootstrap.tsx +48 -0
  203. package/src/react/use-consent.ts +53 -45
  204. package/src/react/use-google-consent-sync.ts +38 -0
  205. package/src/react/use-initial-consent.ts +22 -0
  206. package/src/server/anonymous-id-cookie.ts +103 -0
  207. package/src/server/consent-receipt-store.ts +79 -0
  208. package/src/server/consent-receipt.ts +89 -0
  209. package/src/server/initial-consent.ts +46 -0
  210. package/src/server/measurement-protocol.ts +114 -0
  211. package/src/server/region.ts +22 -15
  212. package/src/server/user-deletion.ts +93 -0
  213. package/src/tooling/import-protection.ts +22 -0
  214. package/dist/client/consent-storage.mjs +0 -63
  215. package/dist/client/create-client-tracker.d.mts +0 -37
  216. package/dist/client/create-client-tracker.mjs +0 -66
  217. package/dist/client/gpc.d.mts +0 -10
  218. package/dist/client/gpc.mjs +0 -12
  219. package/dist/client/index.d.mts +0 -8
  220. package/dist/client/index.mjs +0 -8
  221. package/dist/client/lifecycle.d.mts +0 -23
  222. package/dist/client/lifecycle.mjs +0 -30
  223. package/dist/client/local-storage.d.mts +0 -13
  224. package/dist/client/local-storage.mjs +0 -31
  225. package/dist/client/queue.d.mts +0 -49
  226. package/dist/client/queue.mjs +0 -71
  227. package/dist/client/router.d.mts +0 -30
  228. package/dist/client/router.mjs +0 -17
  229. package/dist/core/consent.d.mts +0 -89
  230. package/dist/core/consent.mjs +0 -57
  231. package/dist/core/destination.d.mts +0 -23
  232. package/dist/core/destination.mjs +0 -1
  233. package/dist/core/event-catalog.d.mts +0 -36
  234. package/dist/core/event-catalog.mjs +0 -12
  235. package/dist/core/event-id.d.mts +0 -10
  236. package/dist/core/event-id.mjs +0 -12
  237. package/dist/core/index.d.mts +0 -6
  238. package/dist/core/index.mjs +0 -4
  239. package/dist/core/tracked-event.d.mts +0 -17
  240. package/dist/core/tracked-event.mjs +0 -1
  241. package/dist/destinations/ga4-measurement-protocol.d.mts +0 -54
  242. package/dist/destinations/ga4-measurement-protocol.mjs +0 -89
  243. package/dist/destinations/google-analytics.d.mts +0 -98
  244. package/dist/destinations/google-analytics.mjs +0 -126
  245. package/dist/destinations/http-destination.d.mts +0 -20
  246. package/dist/destinations/http-destination.mjs +0 -25
  247. package/dist/destinations/index.d.mts +0 -5
  248. package/dist/destinations/index.mjs +0 -5
  249. package/dist/destinations/vercel-analytics.d.mts +0 -13
  250. package/dist/destinations/vercel-analytics.mjs +0 -30
  251. package/dist/index.d.mts +0 -6
  252. package/dist/index.mjs +0 -4
  253. package/dist/react/consent-banner.d.mts +0 -163
  254. package/dist/react/consent-banner.mjs +0 -209
  255. package/dist/react/index.d.mts +0 -3
  256. package/dist/react/index.mjs +0 -3
  257. package/dist/react/use-consent.d.mts +0 -49
  258. package/dist/react/use-consent.mjs +0 -54
  259. package/dist/server/create-server-tracker.d.mts +0 -42
  260. package/dist/server/create-server-tracker.mjs +0 -67
  261. package/dist/server/index.d.mts +0 -3
  262. package/dist/server/index.mjs +0 -3
  263. package/dist/server/region.d.mts +0 -20
  264. package/dist/server/region.mjs +0 -56
  265. package/src/client/index.ts +0 -17
  266. package/src/client/lifecycle.ts +0 -50
  267. package/src/client/local-storage.ts +0 -44
  268. package/src/client/queue.ts +0 -117
  269. package/src/client/router.ts +0 -37
  270. package/src/core/index.ts +0 -24
  271. package/src/destinations/ga4-measurement-protocol.ts +0 -166
  272. package/src/destinations/http-destination.ts +0 -33
  273. package/src/destinations/index.ts +0 -20
  274. package/src/react/index.ts +0 -29
  275. package/src/server/create-server-tracker.ts +0 -128
  276. package/src/server/index.ts +0 -4
@@ -0,0 +1,69 @@
1
+ /**
2
+ * EU member states — GDPR opt-in via `resolveConsentMode("eu")`.
3
+ *
4
+ * @since 1.0.0-canary.6
5
+ */
6
+ export const EU_COUNTRY_CODES = new Set([
7
+ "AT",
8
+ "BE",
9
+ "BG",
10
+ "HR",
11
+ "CY",
12
+ "CZ",
13
+ "DK",
14
+ "EE",
15
+ "FI",
16
+ "FR",
17
+ "DE",
18
+ "GR",
19
+ "HU",
20
+ "IE",
21
+ "IT",
22
+ "LV",
23
+ "LT",
24
+ "LU",
25
+ "MT",
26
+ "NL",
27
+ "PL",
28
+ "PT",
29
+ "RO",
30
+ "SK",
31
+ "SI",
32
+ "ES",
33
+ "SE",
34
+ ]);
35
+ /**
36
+ * UK GDPR (post-Brexit) and EEA/EFTA states that apply GDPR-equivalent rules — mapped to
37
+ * the same `"eu"` consent region so they get opt-in, not the `"other"` opt-out default.
38
+ *
39
+ * Restricted edge runtimes that cannot import this package should duplicate these codes
40
+ * and keep a sync test against this export.
41
+ *
42
+ * @since 1.0.0-canary.6
43
+ */
44
+ export const OPT_IN_EQUIVALENT_COUNTRY_CODES = new Set(["GB", "IS", "LI", "NO"]);
45
+ /**
46
+ * Unrecognized codes fall back to "other", which `resolveConsentMode` treats as
47
+ * opt-out — safe only because opt-in regions (EU/VN plus UK/EEA/EFTA above) are matched
48
+ * explicitly. A *missing* code also maps to "other" here, but `resolveInitialConsent`
49
+ * intercepts that case first and fails closed — unknown is not known-elsewhere.
50
+ *
51
+ * @since 0.5.0-canary.4
52
+ */
53
+ export function resolveRegionFromCountryCode(countryCode) {
54
+ if (!countryCode) {
55
+ return "other";
56
+ }
57
+ const normalized = countryCode.toUpperCase();
58
+ if (EU_COUNTRY_CODES.has(normalized) || OPT_IN_EQUIVALENT_COUNTRY_CODES.has(normalized)) {
59
+ return "eu";
60
+ }
61
+ if (normalized === "VN") {
62
+ return "vn";
63
+ }
64
+ if (normalized === "US") {
65
+ return "us";
66
+ }
67
+ return "other";
68
+ }
69
+ //# sourceMappingURL=region.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"region.js","sourceRoot":"","sources":["../../src/server/region.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAwB,IAAI,GAAG,CAAC;IAC3D,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;CACL,CAAC,CAAC;AAEH;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAwB,IAAI,GAAG,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;AAEtG;;;;;;;GAOG;AACH,MAAM,UAAU,4BAA4B,CAAC,WAA+B;IAC1E,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,MAAM,UAAU,GAAG,WAAW,CAAC,WAAW,EAAE,CAAC;IAE7C,IAAI,gBAAgB,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,+BAA+B,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;QACxF,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}
@@ -0,0 +1,64 @@
1
+ /**
2
+ * DSR delegation for GA4 (spec-data-subject-rights §3): the platform ships its own
3
+ * per-visitor deletion, so the system **delegates** rather than reimplementing a deletion
4
+ * store. Targets the current **Analytics Admin API** `properties.submitUserDeletion` — the
5
+ * legacy v3 `userDeletionRequests:upsert` was sunset with Universal Analytics, so the spec's
6
+ * DSR-V3 `{ id: { type: "CLIENT_ID", userId } }` shape is stale; the current request keys the
7
+ * subject with a flat `clientId` (a oneof with `userId`/`appInstanceId`/`userProvidedData`).
8
+ *
9
+ * @see https://developers.google.com/analytics/devguides/config/userdeletion/migration
10
+ */
11
+ /**
12
+ * @since 1.0.0-canary.7
13
+ */
14
+ export interface Ga4UserDeletionRequest {
15
+ body: {
16
+ clientId: string;
17
+ };
18
+ url: string;
19
+ }
20
+ /**
21
+ * Builds the Admin API `submitUserDeletion` request that erases one GA4 subject by
22
+ * `clientId` (the `_ga`-cookie id — see `extractGaClientId`). Pure and network-free so the
23
+ * request shape can be snapshotted/verified; pair it with {@link submitGa4UserDeletion} or
24
+ * any authenticated transport.
25
+ *
26
+ * @param options - `propertyId` is the numeric GA4 property (no `properties/` prefix).
27
+ *
28
+ * @since 1.0.0-canary.7
29
+ */
30
+ export declare function buildGa4UserDeletionRequest(options: {
31
+ clientId: string;
32
+ propertyId: string;
33
+ }): Ga4UserDeletionRequest;
34
+ /**
35
+ * The one network primitive the sender needs — injected so the package ships no HTTP client.
36
+ *
37
+ * @since 1.0.0-canary.7
38
+ */
39
+ export type Ga4UserDeletionTransport = (request: {
40
+ body: string;
41
+ headers: Record<string, string>;
42
+ url: string;
43
+ }) => Promise<void>;
44
+ /**
45
+ * @since 1.0.0-canary.7
46
+ */
47
+ export interface SubmitGa4UserDeletionOptions {
48
+ /** A bearer token for the `https://www.googleapis.com/auth/analytics.edit` scope — the caller owns OAuth. */
49
+ accessToken: string;
50
+ clientId: string;
51
+ propertyId: string;
52
+ transport?: Ga4UserDeletionTransport | undefined;
53
+ }
54
+ /**
55
+ * Submits a GA4 user-deletion request for one `clientId`. Authorization is the caller's:
56
+ * pass a bearer token minted from a service account (never baked into the package). The
57
+ * deletion removes the subject from the Individual User report within ~72h and purges at the
58
+ * next run; it does **not** reach previously-aggregated reports or BigQuery exports
59
+ * (spec-data-subject-rights §3).
60
+ *
61
+ * @since 1.0.0-canary.7
62
+ */
63
+ export declare function submitGa4UserDeletion(options: SubmitGa4UserDeletionOptions): Promise<void>;
64
+ //# sourceMappingURL=user-deletion.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"user-deletion.d.ts","sourceRoot":"","sources":["../../src/server/user-deletion.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3B,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;;;;;;GASG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAAG,sBAAsB,CAKrH;AAED;;;;GAIG;AACH,MAAM,MAAM,wBAAwB,GAAG,CAAC,OAAO,EAAE;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,GAAG,EAAE,MAAM,CAAC;CACb,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAcpB;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C,6GAA6G;IAC7G,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,wBAAwB,GAAG,SAAS,CAAC;CAClD;AAED;;;;;;;;GAQG;AACH,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,4BAA4B,GAAG,OAAO,CAAC,IAAI,CAAC,CAWhG"}
@@ -0,0 +1,54 @@
1
+ /**
2
+ * DSR delegation for GA4 (spec-data-subject-rights §3): the platform ships its own
3
+ * per-visitor deletion, so the system **delegates** rather than reimplementing a deletion
4
+ * store. Targets the current **Analytics Admin API** `properties.submitUserDeletion` — the
5
+ * legacy v3 `userDeletionRequests:upsert` was sunset with Universal Analytics, so the spec's
6
+ * DSR-V3 `{ id: { type: "CLIENT_ID", userId } }` shape is stale; the current request keys the
7
+ * subject with a flat `clientId` (a oneof with `userId`/`appInstanceId`/`userProvidedData`).
8
+ *
9
+ * @see https://developers.google.com/analytics/devguides/config/userdeletion/migration
10
+ */
11
+ const ADMIN_API_ORIGIN = "https://analyticsadmin.googleapis.com";
12
+ /**
13
+ * Builds the Admin API `submitUserDeletion` request that erases one GA4 subject by
14
+ * `clientId` (the `_ga`-cookie id — see `extractGaClientId`). Pure and network-free so the
15
+ * request shape can be snapshotted/verified; pair it with {@link submitGa4UserDeletion} or
16
+ * any authenticated transport.
17
+ *
18
+ * @param options - `propertyId` is the numeric GA4 property (no `properties/` prefix).
19
+ *
20
+ * @since 1.0.0-canary.7
21
+ */
22
+ export function buildGa4UserDeletionRequest(options) {
23
+ return {
24
+ body: { clientId: options.clientId },
25
+ url: `${ADMIN_API_ORIGIN}/v1alpha/properties/${options.propertyId}:submitUserDeletion`,
26
+ };
27
+ }
28
+ async function defaultTransport(request) {
29
+ const response = await fetch(request.url, { body: request.body, headers: request.headers, method: "POST" });
30
+ if (!response.ok) {
31
+ throw new Error(`GA4 user deletion responded ${String(response.status)}`);
32
+ }
33
+ }
34
+ /**
35
+ * Submits a GA4 user-deletion request for one `clientId`. Authorization is the caller's:
36
+ * pass a bearer token minted from a service account (never baked into the package). The
37
+ * deletion removes the subject from the Individual User report within ~72h and purges at the
38
+ * next run; it does **not** reach previously-aggregated reports or BigQuery exports
39
+ * (spec-data-subject-rights §3).
40
+ *
41
+ * @since 1.0.0-canary.7
42
+ */
43
+ export async function submitGa4UserDeletion(options) {
44
+ const request = buildGa4UserDeletionRequest({ clientId: options.clientId, propertyId: options.propertyId });
45
+ await (options.transport ?? defaultTransport)({
46
+ body: JSON.stringify(request.body),
47
+ headers: {
48
+ authorization: `Bearer ${options.accessToken}`,
49
+ "content-type": "application/json",
50
+ },
51
+ url: request.url,
52
+ });
53
+ }
54
+ //# sourceMappingURL=user-deletion.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"user-deletion.js","sourceRoot":"","sources":["../../src/server/user-deletion.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,gBAAgB,GAAG,uCAAuC,CAAC;AAUjE;;;;;;;;;GASG;AACH,MAAM,UAAU,2BAA2B,CAAC,OAAiD;IAC3F,OAAO;QACL,IAAI,EAAE,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE;QACpC,GAAG,EAAE,GAAG,gBAAgB,uBAAuB,OAAO,CAAC,UAAU,qBAAqB;KACvF,CAAC;AACJ,CAAC;AAaD,KAAK,UAAU,gBAAgB,CAAC,OAI/B;IACC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAE5G,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,+BAA+B,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC5E,CAAC;AACH,CAAC;AAaD;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,OAAqC;IAC/E,MAAM,OAAO,GAAG,2BAA2B,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IAE5G,MAAM,CAAC,OAAO,CAAC,SAAS,IAAI,gBAAgB,CAAC,CAAC;QAC5C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC;QAClC,OAAO,EAAE;YACP,aAAa,EAAE,UAAU,OAAO,CAAC,WAAW,EAAE;YAC9C,cAAc,EAAE,kBAAkB;SACnC;QACD,GAAG,EAAE,OAAO,CAAC,GAAG;KACjB,CAAC,CAAC;AACL,CAAC"}
@@ -0,0 +1,19 @@
1
+ /**
2
+ * The `@codefast/tracking` subpaths every client bundle must deny (picomatch patterns) —
3
+ * framework-neutral data each build tool maps to its own guard: TanStack Start's
4
+ * `importProtection.client.specifiers`, Next's `server-only`, Remix's `.server` convention.
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
7
+ * vite.config.ts).
8
+ *
9
+ * @example
10
+ * ```ts
11
+ * tanstackStart({
12
+ * importProtection: { client: { specifiers: [...SERVER_ONLY_SUBPATHS] } },
13
+ * });
14
+ * ```
15
+ *
16
+ * @since 1.0.0-canary.6
17
+ */
18
+ export declare const SERVER_ONLY_SUBPATHS: ReadonlyArray<string>;
19
+ //# sourceMappingURL=import-protection.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"import-protection.d.ts","sourceRoot":"","sources":["../../src/tooling/import-protection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,oBAAoB,EAAE,aAAa,CAAC,MAAM,CAItD,CAAC"}
@@ -0,0 +1,23 @@
1
+ /**
2
+ * The `@codefast/tracking` subpaths every client bundle must deny (picomatch patterns) —
3
+ * framework-neutral data each build tool maps to its own guard: TanStack Start's
4
+ * `importProtection.client.specifiers`, Next's `server-only`, Remix's `.server` convention.
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
7
+ * vite.config.ts).
8
+ *
9
+ * @example
10
+ * ```ts
11
+ * tanstackStart({
12
+ * importProtection: { client: { specifiers: [...SERVER_ONLY_SUBPATHS] } },
13
+ * });
14
+ * ```
15
+ *
16
+ * @since 1.0.0-canary.6
17
+ */
18
+ export const SERVER_ONLY_SUBPATHS = [
19
+ "@codefast/tracking/server",
20
+ "@codefast/tracking/server/**",
21
+ "@codefast/tracking/adapters/**",
22
+ ];
23
+ //# sourceMappingURL=import-protection.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"import-protection.js","sourceRoot":"","sources":["../../src/tooling/import-protection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAA0B;IACzD,2BAA2B;IAC3B,8BAA8B;IAC9B,gCAAgC;CACjC,CAAC"}