@10x-media/analytics 0.1.0-beta.5 → 1.0.0-beta.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 (231) hide show
  1. package/CHANGELOG.md +40 -0
  2. package/LICENSE +21 -21
  3. package/README.md +5 -1
  4. package/dist/adapters/ga4/ga4.js +13 -0
  5. package/dist/adapters/ga4/ga4.js.map +1 -1
  6. package/dist/adapters/http/fetchJson.js +1 -1
  7. package/dist/adapters/plausible/plausible.d.ts +10 -0
  8. package/dist/adapters/plausible/plausible.js +51 -0
  9. package/dist/adapters/plausible/plausible.js.map +1 -1
  10. package/dist/adapters/posthog/posthog.d.ts +10 -1
  11. package/dist/adapters/posthog/posthog.js +84 -3
  12. package/dist/adapters/posthog/posthog.js.map +1 -1
  13. package/dist/adapters/series.js +11 -1
  14. package/dist/adapters/series.js.map +1 -1
  15. package/dist/adapters/umami/umami.d.ts +5 -1
  16. package/dist/adapters/umami/umami.js +28 -0
  17. package/dist/adapters/umami/umami.js.map +1 -1
  18. package/dist/capture/getTrackerConfig.d.ts +20 -0
  19. package/dist/capture/getTrackerConfig.js +31 -0
  20. package/dist/capture/getTrackerConfig.js.map +1 -0
  21. package/dist/capture/mountPath.js +14 -0
  22. package/dist/capture/mountPath.js.map +1 -0
  23. package/dist/capture/proxyEndpoint.js +123 -0
  24. package/dist/capture/proxyEndpoint.js.map +1 -0
  25. package/dist/capture/proxyRoutes.js +108 -0
  26. package/dist/capture/proxyRoutes.js.map +1 -0
  27. package/dist/capture/requestBody.js +68 -0
  28. package/dist/capture/requestBody.js.map +1 -0
  29. package/dist/capture/slots.d.ts +8 -0
  30. package/dist/capture/slots.js +43 -0
  31. package/dist/capture/slots.js.map +1 -0
  32. package/dist/capture/trackerConfig.d.ts +32 -0
  33. package/dist/capture/trackerConfig.js +70 -0
  34. package/dist/capture/trackerConfig.js.map +1 -0
  35. package/dist/capture/trackerEndpoint.js +35 -0
  36. package/dist/capture/trackerEndpoint.js.map +1 -0
  37. package/dist/core/capabilities.d.ts +5 -1
  38. package/dist/core/capabilities.js +4 -0
  39. package/dist/core/capabilities.js.map +1 -1
  40. package/dist/core/capture.d.ts +49 -0
  41. package/dist/core/contract.d.ts +33 -4
  42. package/dist/core/contract.js.map +1 -1
  43. package/dist/core/options.d.ts +97 -2
  44. package/dist/core/options.js +63 -2
  45. package/dist/core/options.js.map +1 -1
  46. package/dist/core/registry.d.ts +1 -0
  47. package/dist/core/scopeList.js +32 -0
  48. package/dist/core/scopeList.js.map +1 -0
  49. package/dist/core/scopedRead.js +13 -6
  50. package/dist/core/scopedRead.js.map +1 -1
  51. package/dist/exports/next.d.ts +2 -1
  52. package/dist/exports/next.js +2 -1
  53. package/dist/exports/react.d.ts +4 -0
  54. package/dist/exports/react.js +5 -0
  55. package/dist/exports/rsc.d.ts +5 -2
  56. package/dist/exports/rsc.js +3 -1
  57. package/dist/exports/tracker.d.ts +18 -0
  58. package/dist/exports/tracker.js +12 -0
  59. package/dist/exports/types.d.ts +6 -3
  60. package/dist/fields/AnalyticsPanelClient.js +1 -1
  61. package/dist/fields/config/narrow.js +2 -0
  62. package/dist/fields/config/narrow.js.map +1 -1
  63. package/dist/fields/readForDocument.js +1 -1
  64. package/dist/goals/match.js +64 -0
  65. package/dist/goals/match.js.map +1 -0
  66. package/dist/goals/types.d.ts +33 -0
  67. package/dist/goals/types.js +7 -0
  68. package/dist/goals/types.js.map +1 -0
  69. package/dist/index.d.ts +4 -3
  70. package/dist/index.js +39 -10
  71. package/dist/index.js.map +1 -1
  72. package/dist/native/collections/events.js +21 -1
  73. package/dist/native/collections/events.js.map +1 -1
  74. package/dist/native/collections/rollups.js +39 -3
  75. package/dist/native/collections/rollups.js.map +1 -1
  76. package/dist/native/geo/maxmindResolver.js +2 -4
  77. package/dist/native/geo/maxmindResolver.js.map +1 -1
  78. package/dist/native/ingest/clientIp.js +15 -0
  79. package/dist/native/ingest/clientIp.js.map +1 -0
  80. package/dist/native/ingest/endpoint.js +40 -4
  81. package/dist/native/ingest/endpoint.js.map +1 -1
  82. package/dist/native/ingest/flushBatch.js +4 -13
  83. package/dist/native/ingest/flushBatch.js.map +1 -1
  84. package/dist/native/ingest/normalizeEvent.js +76 -9
  85. package/dist/native/ingest/normalizeEvent.js.map +1 -1
  86. package/dist/native/nativeAdapter.js +100 -5
  87. package/dist/native/nativeAdapter.js.map +1 -1
  88. package/dist/native/query/eventAgg.js +161 -0
  89. package/dist/native/query/eventAgg.js.map +1 -0
  90. package/dist/native/rollupAcc.js +12 -1
  91. package/dist/native/rollupAcc.js.map +1 -1
  92. package/dist/native/rollups/applyDistinctDeltas.js +1 -1
  93. package/dist/native/rollups/applyDistinctDeltas.js.map +1 -1
  94. package/dist/native/rollups/bumpRollup.js +7 -2
  95. package/dist/native/rollups/bumpRollup.js.map +1 -1
  96. package/dist/native/rollups/deltas.js +70 -11
  97. package/dist/native/rollups/deltas.js.map +1 -1
  98. package/dist/next/captureRewrites.d.ts +41 -0
  99. package/dist/next/captureRewrites.js +56 -0
  100. package/dist/next/captureRewrites.js.map +1 -0
  101. package/dist/next/posthogProxyRewrites.d.ts +5 -0
  102. package/dist/next/posthogProxyRewrites.js +16 -21
  103. package/dist/next/posthogProxyRewrites.js.map +1 -1
  104. package/dist/plugin/documentEndpoint.js +1 -1
  105. package/dist/plugin/paths.js +11 -1
  106. package/dist/plugin/paths.js.map +1 -1
  107. package/dist/plugin/runtime.d.ts +1 -0
  108. package/dist/plugin/runtime.js.map +1 -1
  109. package/dist/plugin/sourcesEndpoint.js +16 -4
  110. package/dist/plugin/sourcesEndpoint.js.map +1 -1
  111. package/dist/plugin/warmTask.js +0 -0
  112. package/dist/plugin/warmTask.js.map +1 -1
  113. package/dist/providers/collection.js +56 -16
  114. package/dist/providers/collection.js.map +1 -1
  115. package/dist/providers/factory.js +8 -2
  116. package/dist/providers/factory.js.map +1 -1
  117. package/dist/react/AnalyticsProvider.d.ts +43 -0
  118. package/dist/react/AnalyticsProvider.js +66 -0
  119. package/dist/react/AnalyticsProvider.js.map +1 -0
  120. package/dist/react/TrackerBoot.d.ts +22 -0
  121. package/dist/react/TrackerBoot.js +30 -0
  122. package/dist/react/TrackerBoot.js.map +1 -0
  123. package/dist/react/useAnalytics.d.ts +17 -0
  124. package/dist/react/useAnalytics.js +36 -0
  125. package/dist/react/useAnalytics.js.map +1 -0
  126. package/dist/rsc/AnalyticsScripts.d.ts +30 -0
  127. package/dist/rsc/AnalyticsScripts.js +41 -0
  128. package/dist/rsc/AnalyticsScripts.js.map +1 -0
  129. package/dist/surfacing/cacheStore.d.ts +1 -0
  130. package/dist/surfacing/cacheStore.js +18 -2
  131. package/dist/surfacing/cacheStore.js.map +1 -1
  132. package/dist/surfacing/engine.d.ts +1 -0
  133. package/dist/surfacing/engine.js +44 -4
  134. package/dist/surfacing/engine.js.map +1 -1
  135. package/dist/surfacing/queue.js +22 -6
  136. package/dist/surfacing/queue.js.map +1 -1
  137. package/dist/surfacing/rateLimiter.js +130 -0
  138. package/dist/surfacing/rateLimiter.js.map +1 -0
  139. package/dist/surfacing/retryPolicy.js +15 -0
  140. package/dist/surfacing/retryPolicy.js.map +1 -0
  141. package/dist/sync/collection.js +23 -7
  142. package/dist/sync/collection.js.map +1 -1
  143. package/dist/sync/syncTask.js +68 -33
  144. package/dist/sync/syncTask.js.map +1 -1
  145. package/dist/testing/memoryAdapter.d.ts +2 -0
  146. package/dist/testing/memoryAdapter.js +17 -0
  147. package/dist/testing/memoryAdapter.js.map +1 -1
  148. package/dist/tracker/autoCapture.d.ts +48 -0
  149. package/dist/tracker/autoCapture.js +129 -0
  150. package/dist/tracker/autoCapture.js.map +1 -0
  151. package/dist/tracker/consent.d.ts +24 -0
  152. package/dist/tracker/consent.js +48 -0
  153. package/dist/tracker/consent.js.map +1 -0
  154. package/dist/tracker/createTracker.d.ts +18 -0
  155. package/dist/tracker/createTracker.js +163 -0
  156. package/dist/tracker/createTracker.js.map +1 -0
  157. package/dist/tracker/initTracker.d.ts +22 -0
  158. package/dist/tracker/initTracker.js +33 -0
  159. package/dist/tracker/initTracker.js.map +1 -0
  160. package/dist/tracker/loadScript.d.ts +14 -0
  161. package/dist/tracker/loadScript.js +41 -0
  162. package/dist/tracker/loadScript.js.map +1 -0
  163. package/dist/tracker/pageTracking.d.ts +17 -0
  164. package/dist/tracker/pageTracking.js +38 -0
  165. package/dist/tracker/pageTracking.js.map +1 -0
  166. package/dist/tracker/registry.d.ts +27 -0
  167. package/dist/tracker/registry.js +73 -0
  168. package/dist/tracker/registry.js.map +1 -0
  169. package/dist/tracker/sinks/native.d.ts +22 -0
  170. package/dist/tracker/sinks/native.js +56 -0
  171. package/dist/tracker/sinks/native.js.map +1 -0
  172. package/dist/tracker/sinks/plausible.d.ts +14 -0
  173. package/dist/tracker/sinks/plausible.js +25 -0
  174. package/dist/tracker/sinks/plausible.js.map +1 -0
  175. package/dist/tracker/sinks/posthog.d.ts +14 -0
  176. package/dist/tracker/sinks/posthog.js +18 -0
  177. package/dist/tracker/sinks/posthog.js.map +1 -0
  178. package/dist/tracker/sinks/umami.d.ts +13 -0
  179. package/dist/tracker/sinks/umami.js +17 -0
  180. package/dist/tracker/sinks/umami.js.map +1 -0
  181. package/dist/tracker/sinks/vendor.d.ts +14 -0
  182. package/dist/tracker/sinks/vendor.js +66 -0
  183. package/dist/tracker/sinks/vendor.js.map +1 -0
  184. package/dist/tracker/transport.js +28 -0
  185. package/dist/tracker/transport.js.map +1 -0
  186. package/dist/tracker/types.d.ts +66 -0
  187. package/dist/translations/ar.js +83 -0
  188. package/dist/translations/ar.js.map +1 -0
  189. package/dist/translations/de.js +6 -0
  190. package/dist/translations/de.js.map +1 -1
  191. package/dist/translations/en.js +6 -0
  192. package/dist/translations/en.js.map +1 -1
  193. package/dist/translations/es.js +83 -0
  194. package/dist/translations/es.js.map +1 -0
  195. package/dist/translations/fr.js +83 -0
  196. package/dist/translations/fr.js.map +1 -0
  197. package/dist/translations/id.js +83 -0
  198. package/dist/translations/id.js.map +1 -0
  199. package/dist/translations/index.d.ts +10 -1
  200. package/dist/translations/index.js +19 -1
  201. package/dist/translations/index.js.map +1 -1
  202. package/dist/translations/keys.d.ts +6 -0
  203. package/dist/translations/keys.js +6 -0
  204. package/dist/translations/keys.js.map +1 -1
  205. package/dist/translations/ko.js +83 -0
  206. package/dist/translations/ko.js.map +1 -0
  207. package/dist/translations/pt.js +83 -0
  208. package/dist/translations/pt.js.map +1 -0
  209. package/dist/translations/ru.js +83 -0
  210. package/dist/translations/ru.js.map +1 -0
  211. package/dist/translations/uk.js +83 -0
  212. package/dist/translations/uk.js.map +1 -0
  213. package/dist/translations/zh.js +83 -0
  214. package/dist/translations/zh.js.map +1 -0
  215. package/dist/widgets/breakdownTypes.js +5 -0
  216. package/dist/widgets/breakdownTypes.js.map +1 -1
  217. package/dist/widgets/readForWidget.d.ts +2 -1
  218. package/dist/widgets/readForWidget.js +32 -14
  219. package/dist/widgets/readForWidget.js.map +1 -1
  220. package/dist/widgets/readForWidgetBreakdown.d.ts +2 -1
  221. package/dist/widgets/readForWidgetBreakdown.js +29 -15
  222. package/dist/widgets/readForWidgetBreakdown.js.map +1 -1
  223. package/dist/widgets/readForWidgetRealtime.js +1 -1
  224. package/dist/widgets/readForWidgetSeries.d.ts +2 -1
  225. package/dist/widgets/readForWidgetSeries.js +34 -16
  226. package/dist/widgets/readForWidgetSeries.js.map +1 -1
  227. package/dist/widgets/registerWidgets.js +10 -4
  228. package/dist/widgets/registerWidgets.js.map +1 -1
  229. package/dist/widgets/types.js +4 -1
  230. package/dist/widgets/types.js.map +1 -1
  231. package/package.json +20 -5
@@ -1,3 +1,4 @@
1
+ import { ProviderHttpError } from "../adapters/http/fetchJson.js";
1
2
  //#region src/testing/memoryAdapter.ts
2
3
  const capabilities = {
3
4
  perPageQuery: true,
@@ -20,6 +21,8 @@ const capabilities = {
20
21
  "country",
21
22
  "device"
22
23
  ]),
24
+ filters: new Set(["page"]),
25
+ filterOperators: new Set(["eq"]),
23
26
  batchPageReport: true,
24
27
  rateLimit: null,
25
28
  recommendedTtl: {
@@ -29,8 +32,14 @@ const capabilities = {
29
32
  };
30
33
  function memoryAdapter() {
31
34
  const events = [];
35
+ let pendingFailure;
36
+ const matchesFilters = (e, q) => (q.filters ?? []).every((filter) => {
37
+ if (filter.dimension !== "page" || filter.operator !== "eq") return true;
38
+ return e.path === filter.value;
39
+ });
32
40
  const inRange = (e, q) => {
33
41
  if (q.path && e.path !== q.path) return false;
42
+ if (!matchesFilters(e, q)) return false;
34
43
  return e.timestamp >= q.dateRange.start && e.timestamp <= q.dateRange.end;
35
44
  };
36
45
  return {
@@ -44,7 +53,15 @@ function memoryAdapter() {
44
53
  reset: () => {
45
54
  events.length = 0;
46
55
  },
56
+ failNext: (err) => {
57
+ pendingFailure = err ?? new ProviderHttpError(500, "memory", "memory: injected failure");
58
+ },
47
59
  async query(q, _ctx) {
60
+ if (pendingFailure) {
61
+ const err = pendingFailure;
62
+ pendingFailure = void 0;
63
+ throw err;
64
+ }
48
65
  const matched = events.filter((e) => inRange(e, q));
49
66
  const countVisitors = (list) => new Set(list.map((e) => e.visitor ?? e.path + e.timestamp.toDateString())).size;
50
67
  if (q.granularity === "day") {
@@ -1 +1 @@
1
- {"version":3,"file":"memoryAdapter.js","names":[],"sources":["../../src/testing/memoryAdapter.ts"],"sourcesContent":["import type {\n\tAdapterContext,\n\tAnalyticsAdapter,\n\tAnalyticsCapabilities,\n\tAnalyticsQuery,\n\tAnalyticsResult,\n\tDimensionKey,\n\tMetricKey,\n} from '../core/contract'\n\ninterface MemoryEvent {\n\tpath: string\n\ttimestamp: Date\n\tvisitor?: string\n}\n\nconst metrics: ReadonlySet<MetricKey> = new Set([\n\t'pageviews',\n\t'visitors',\n\t'visits',\n\t'sessions',\n\t'bounceRate',\n\t'avgDuration',\n])\nconst dimensions: ReadonlySet<DimensionKey> = new Set(['page', 'referrer', 'country', 'device'])\n\nconst capabilities: AnalyticsCapabilities = {\n\tperPageQuery: true,\n\trealtime: true,\n\trealtimeWindowMinutes: 5,\n\tcomparison: true,\n\tminGranularity: 'minute',\n\tmaxLookbackDays: null,\n\tmetrics,\n\tdimensions,\n\tbatchPageReport: true,\n\trateLimit: null,\n\trecommendedTtl: { realtime: 300, aggregate: 3600 },\n}\n\nexport interface MemoryAnalyticsAdapter extends AnalyticsAdapter {\n\trecord(event: MemoryEvent): void\n\treset(): void\n}\n\nexport function memoryAdapter(): MemoryAnalyticsAdapter {\n\tconst events: MemoryEvent[] = []\n\n\tconst inRange = (e: MemoryEvent, q: AnalyticsQuery): boolean => {\n\t\tif (q.path && e.path !== q.path) return false\n\t\treturn e.timestamp >= q.dateRange.start && e.timestamp <= q.dateRange.end\n\t}\n\n\treturn {\n\t\tid: 'memory',\n\t\tlabel: 'In-memory (testing)',\n\t\tcapabilities,\n\t\tisConfigured: () => true,\n\t\trecord: (event) => {\n\t\t\tevents.push(event)\n\t\t},\n\t\treset: () => {\n\t\t\tevents.length = 0\n\t\t},\n\t\tasync query(q: AnalyticsQuery, _ctx: AdapterContext): Promise<AnalyticsResult> {\n\t\t\tconst matched = events.filter((e) => inRange(e, q))\n\t\t\tconst countVisitors = (list: MemoryEvent[]): number =>\n\t\t\t\tnew Set(list.map((e) => e.visitor ?? e.path + e.timestamp.toDateString())).size\n\t\t\tif (q.granularity === 'day') {\n\t\t\t\tconst byDay = new Map<string, MemoryEvent[]>()\n\t\t\t\tfor (const e of matched) {\n\t\t\t\t\tconst day = new Date(\n\t\t\t\t\t\tDate.UTC(\n\t\t\t\t\t\t\te.timestamp.getUTCFullYear(),\n\t\t\t\t\t\t\te.timestamp.getUTCMonth(),\n\t\t\t\t\t\t\te.timestamp.getUTCDate()\n\t\t\t\t\t\t)\n\t\t\t\t\t).toISOString()\n\t\t\t\t\tconst list = byDay.get(day) ?? []\n\t\t\t\t\tlist.push(e)\n\t\t\t\t\tbyDay.set(day, list)\n\t\t\t\t}\n\t\t\t\tconst rows = [...byDay.entries()]\n\t\t\t\t\t.sort(([a], [b]) => a.localeCompare(b))\n\t\t\t\t\t.map(([day, list]) => ({\n\t\t\t\t\t\ttimestamp: day,\n\t\t\t\t\t\tmetrics: { pageviews: list.length, visitors: countVisitors(list) },\n\t\t\t\t\t}))\n\t\t\t\treturn {\n\t\t\t\t\trows,\n\t\t\t\t\ttotals: { pageviews: matched.length, visitors: countVisitors(matched) },\n\t\t\t\t\tmeta: { provider: 'memory', fetchedAt: q.dateRange.end.toISOString() },\n\t\t\t\t}\n\t\t\t}\n\t\t\tconst pageviews = matched.length\n\t\t\tconst visitors = countVisitors(matched)\n\t\t\treturn {\n\t\t\t\trows: [{ metrics: { pageviews, visitors } }],\n\t\t\t\ttotals: { pageviews, visitors },\n\t\t\t\tmeta: { provider: 'memory', fetchedAt: q.dateRange.end.toISOString() },\n\t\t\t}\n\t\t},\n\t}\n}\n"],"mappings":";AA0BA,MAAM,eAAsC;CAC3C,cAAc;CACd,UAAU;CACV,uBAAuB;CACvB,YAAY;CACZ,gBAAgB;CAChB,iBAAiB;CACjB,SAAA,IAjB2C,IAAI;EAC/C;EACA;EACA;EACA;EACA;EACA;CACD,CAUO;CACN,YAAA,IAViD,IAAI;EAAC;EAAQ;EAAY;EAAW;CAAQ,CAUpF;CACT,iBAAiB;CACjB,WAAW;CACX,gBAAgB;EAAE,UAAU;EAAK,WAAW;CAAK;AAClD;AAOA,SAAgB,gBAAwC;CACvD,MAAM,SAAwB,CAAC;CAE/B,MAAM,WAAW,GAAgB,MAA+B;EAC/D,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,OAAO;EACxC,OAAO,EAAE,aAAa,EAAE,UAAU,SAAS,EAAE,aAAa,EAAE,UAAU;CACvE;CAEA,OAAO;EACN,IAAI;EACJ,OAAO;EACP;EACA,oBAAoB;EACpB,SAAS,UAAU;GAClB,OAAO,KAAK,KAAK;EAClB;EACA,aAAa;GACZ,OAAO,SAAS;EACjB;EACA,MAAM,MAAM,GAAmB,MAAgD;GAC9E,MAAM,UAAU,OAAO,QAAQ,MAAM,QAAQ,GAAG,CAAC,CAAC;GAClD,MAAM,iBAAiB,SACtB,IAAI,IAAI,KAAK,KAAK,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,UAAU,aAAa,CAAC,CAAC,EAAE;GAC5E,IAAI,EAAE,gBAAgB,OAAO;IAC5B,MAAM,wBAAQ,IAAI,IAA2B;IAC7C,KAAK,MAAM,KAAK,SAAS;KACxB,MAAM,MAAM,IAAI,KACf,KAAK,IACJ,EAAE,UAAU,eAAe,GAC3B,EAAE,UAAU,YAAY,GACxB,EAAE,UAAU,WAAW,CACxB,CACD,EAAE,YAAY;KACd,MAAM,OAAO,MAAM,IAAI,GAAG,KAAK,CAAC;KAChC,KAAK,KAAK,CAAC;KACX,MAAM,IAAI,KAAK,IAAI;IACpB;IAOA,OAAO;KACN,MAPY,CAAC,GAAG,MAAM,QAAQ,CAAC,EAC9B,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC,EACrC,KAAK,CAAC,KAAK,WAAW;MACtB,WAAW;MACX,SAAS;OAAE,WAAW,KAAK;OAAQ,UAAU,cAAc,IAAI;MAAE;KAClE,EAEG;KACH,QAAQ;MAAE,WAAW,QAAQ;MAAQ,UAAU,cAAc,OAAO;KAAE;KACtE,MAAM;MAAE,UAAU;MAAU,WAAW,EAAE,UAAU,IAAI,YAAY;KAAE;IACtE;GACD;GACA,MAAM,YAAY,QAAQ;GAC1B,MAAM,WAAW,cAAc,OAAO;GACtC,OAAO;IACN,MAAM,CAAC,EAAE,SAAS;KAAE;KAAW;IAAS,EAAE,CAAC;IAC3C,QAAQ;KAAE;KAAW;IAAS;IAC9B,MAAM;KAAE,UAAU;KAAU,WAAW,EAAE,UAAU,IAAI,YAAY;IAAE;GACtE;EACD;CACD;AACD"}
1
+ {"version":3,"file":"memoryAdapter.js","names":[],"sources":["../../src/testing/memoryAdapter.ts"],"sourcesContent":["import { ProviderHttpError } from '../adapters/http/fetchJson'\nimport type {\n\tAdapterContext,\n\tAnalyticsAdapter,\n\tAnalyticsCapabilities,\n\tAnalyticsQuery,\n\tAnalyticsResult,\n\tDimensionKey,\n\tMetricKey,\n} from '../core/contract'\n\ninterface MemoryEvent {\n\tpath: string\n\ttimestamp: Date\n\tvisitor?: string\n}\n\nconst metrics: ReadonlySet<MetricKey> = new Set([\n\t'pageviews',\n\t'visitors',\n\t'visits',\n\t'sessions',\n\t'bounceRate',\n\t'avgDuration',\n])\nconst dimensions: ReadonlySet<DimensionKey> = new Set(['page', 'referrer', 'country', 'device'])\n\nconst capabilities: AnalyticsCapabilities = {\n\tperPageQuery: true,\n\trealtime: true,\n\trealtimeWindowMinutes: 5,\n\tcomparison: true,\n\tminGranularity: 'minute',\n\tmaxLookbackDays: null,\n\tmetrics,\n\tdimensions,\n\tfilters: new Set(['page']),\n\tfilterOperators: new Set(['eq']),\n\tbatchPageReport: true,\n\trateLimit: null,\n\trecommendedTtl: { realtime: 300, aggregate: 3600 },\n}\n\nexport interface MemoryAnalyticsAdapter extends AnalyticsAdapter {\n\trecord(event: MemoryEvent): void\n\treset(): void\n\t/** Test seam for engine resilience: the next query() call rejects with err, then resets. */\n\tfailNext(err?: Error): void\n}\n\nexport function memoryAdapter(): MemoryAnalyticsAdapter {\n\tconst events: MemoryEvent[] = []\n\tlet pendingFailure: Error | undefined\n\n\t// Only page has a backing MemoryEvent field; other declared dimensions drop as unsupported.\n\tconst matchesFilters = (e: MemoryEvent, q: AnalyticsQuery): boolean =>\n\t\t(q.filters ?? []).every((filter) => {\n\t\t\tif (filter.dimension !== 'page' || filter.operator !== 'eq') {\n\t\t\t\treturn true\n\t\t\t}\n\t\t\treturn e.path === filter.value\n\t\t})\n\n\tconst inRange = (e: MemoryEvent, q: AnalyticsQuery): boolean => {\n\t\tif (q.path && e.path !== q.path) return false\n\t\tif (!matchesFilters(e, q)) return false\n\t\treturn e.timestamp >= q.dateRange.start && e.timestamp <= q.dateRange.end\n\t}\n\n\treturn {\n\t\tid: 'memory',\n\t\tlabel: 'In-memory (testing)',\n\t\tcapabilities,\n\t\tisConfigured: () => true,\n\t\trecord: (event) => {\n\t\t\tevents.push(event)\n\t\t},\n\t\treset: () => {\n\t\t\tevents.length = 0\n\t\t},\n\t\tfailNext: (err) => {\n\t\t\tpendingFailure = err ?? new ProviderHttpError(500, 'memory', 'memory: injected failure')\n\t\t},\n\t\tasync query(q: AnalyticsQuery, _ctx: AdapterContext): Promise<AnalyticsResult> {\n\t\t\tif (pendingFailure) {\n\t\t\t\tconst err = pendingFailure\n\t\t\t\tpendingFailure = undefined\n\t\t\t\tthrow err\n\t\t\t}\n\t\t\tconst matched = events.filter((e) => inRange(e, q))\n\t\t\tconst countVisitors = (list: MemoryEvent[]): number =>\n\t\t\t\tnew Set(list.map((e) => e.visitor ?? e.path + e.timestamp.toDateString())).size\n\t\t\tif (q.granularity === 'day') {\n\t\t\t\tconst byDay = new Map<string, MemoryEvent[]>()\n\t\t\t\tfor (const e of matched) {\n\t\t\t\t\tconst day = new Date(\n\t\t\t\t\t\tDate.UTC(\n\t\t\t\t\t\t\te.timestamp.getUTCFullYear(),\n\t\t\t\t\t\t\te.timestamp.getUTCMonth(),\n\t\t\t\t\t\t\te.timestamp.getUTCDate()\n\t\t\t\t\t\t)\n\t\t\t\t\t).toISOString()\n\t\t\t\t\tconst list = byDay.get(day) ?? []\n\t\t\t\t\tlist.push(e)\n\t\t\t\t\tbyDay.set(day, list)\n\t\t\t\t}\n\t\t\t\tconst rows = [...byDay.entries()]\n\t\t\t\t\t.sort(([a], [b]) => a.localeCompare(b))\n\t\t\t\t\t.map(([day, list]) => ({\n\t\t\t\t\t\ttimestamp: day,\n\t\t\t\t\t\tmetrics: { pageviews: list.length, visitors: countVisitors(list) },\n\t\t\t\t\t}))\n\t\t\t\treturn {\n\t\t\t\t\trows,\n\t\t\t\t\ttotals: { pageviews: matched.length, visitors: countVisitors(matched) },\n\t\t\t\t\tmeta: { provider: 'memory', fetchedAt: q.dateRange.end.toISOString() },\n\t\t\t\t}\n\t\t\t}\n\t\t\tconst pageviews = matched.length\n\t\t\tconst visitors = countVisitors(matched)\n\t\t\treturn {\n\t\t\t\trows: [{ metrics: { pageviews, visitors } }],\n\t\t\t\ttotals: { pageviews, visitors },\n\t\t\t\tmeta: { provider: 'memory', fetchedAt: q.dateRange.end.toISOString() },\n\t\t\t}\n\t\t},\n\t}\n}\n"],"mappings":";;AA2BA,MAAM,eAAsC;CAC3C,cAAc;CACd,UAAU;CACV,uBAAuB;CACvB,YAAY;CACZ,gBAAgB;CAChB,iBAAiB;CACjB,SAAA,IAjB2C,IAAI;EAC/C;EACA;EACA;EACA;EACA;EACA;CACD,CAUO;CACN,YAAA,IAViD,IAAI;EAAC;EAAQ;EAAY;EAAW;CAAQ,CAUpF;CACT,SAAS,IAAI,IAAI,CAAC,MAAM,CAAC;CACzB,iBAAiB,IAAI,IAAI,CAAC,IAAI,CAAC;CAC/B,iBAAiB;CACjB,WAAW;CACX,gBAAgB;EAAE,UAAU;EAAK,WAAW;CAAK;AAClD;AASA,SAAgB,gBAAwC;CACvD,MAAM,SAAwB,CAAC;CAC/B,IAAI;CAGJ,MAAM,kBAAkB,GAAgB,OACtC,EAAE,WAAW,CAAC,GAAG,OAAO,WAAW;EACnC,IAAI,OAAO,cAAc,UAAU,OAAO,aAAa,MACtD,OAAO;EAER,OAAO,EAAE,SAAS,OAAO;CAC1B,CAAC;CAEF,MAAM,WAAW,GAAgB,MAA+B;EAC/D,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,OAAO;EACxC,IAAI,CAAC,eAAe,GAAG,CAAC,GAAG,OAAO;EAClC,OAAO,EAAE,aAAa,EAAE,UAAU,SAAS,EAAE,aAAa,EAAE,UAAU;CACvE;CAEA,OAAO;EACN,IAAI;EACJ,OAAO;EACP;EACA,oBAAoB;EACpB,SAAS,UAAU;GAClB,OAAO,KAAK,KAAK;EAClB;EACA,aAAa;GACZ,OAAO,SAAS;EACjB;EACA,WAAW,QAAQ;GAClB,iBAAiB,OAAO,IAAI,kBAAkB,KAAK,UAAU,0BAA0B;EACxF;EACA,MAAM,MAAM,GAAmB,MAAgD;GAC9E,IAAI,gBAAgB;IACnB,MAAM,MAAM;IACZ,iBAAiB,KAAA;IACjB,MAAM;GACP;GACA,MAAM,UAAU,OAAO,QAAQ,MAAM,QAAQ,GAAG,CAAC,CAAC;GAClD,MAAM,iBAAiB,SACtB,IAAI,IAAI,KAAK,KAAK,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,UAAU,aAAa,CAAC,CAAC,EAAE;GAC5E,IAAI,EAAE,gBAAgB,OAAO;IAC5B,MAAM,wBAAQ,IAAI,IAA2B;IAC7C,KAAK,MAAM,KAAK,SAAS;KACxB,MAAM,MAAM,IAAI,KACf,KAAK,IACJ,EAAE,UAAU,eAAe,GAC3B,EAAE,UAAU,YAAY,GACxB,EAAE,UAAU,WAAW,CACxB,CACD,EAAE,YAAY;KACd,MAAM,OAAO,MAAM,IAAI,GAAG,KAAK,CAAC;KAChC,KAAK,KAAK,CAAC;KACX,MAAM,IAAI,KAAK,IAAI;IACpB;IAOA,OAAO;KACN,MAPY,CAAC,GAAG,MAAM,QAAQ,CAAC,EAC9B,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC,EACrC,KAAK,CAAC,KAAK,WAAW;MACtB,WAAW;MACX,SAAS;OAAE,WAAW,KAAK;OAAQ,UAAU,cAAc,IAAI;MAAE;KAClE,EAEG;KACH,QAAQ;MAAE,WAAW,QAAQ;MAAQ,UAAU,cAAc,OAAO;KAAE;KACtE,MAAM;MAAE,UAAU;MAAU,WAAW,EAAE,UAAU,IAAI,YAAY;KAAE;IACtE;GACD;GACA,MAAM,YAAY,QAAQ;GAC1B,MAAM,WAAW,cAAc,OAAO;GACtC,OAAO;IACN,MAAM,CAAC,EAAE,SAAS;KAAE;KAAW;IAAS,EAAE,CAAC;IAC3C,QAAQ;KAAE;KAAW;IAAS;IAC9B,MAAM;KAAE,UAAU;KAAU,WAAW,EAAE,UAAU,IAAI,YAAY;IAAE;GACtE;EACD;CACD;AACD"}
@@ -0,0 +1,48 @@
1
+ import { ResolvedAutoCapture } from "../core/options.js";
2
+ import { TrackerWindow } from "./types.js";
3
+
4
+ //#region src/tracker/autoCapture.d.ts
5
+ /** Event name for a click on a link leaving the site. */
6
+ declare const OUTBOUND_EVENT = "outbound_link";
7
+ /** Event name for a click on a link whose target is a file. */
8
+ declare const DOWNLOAD_EVENT = "file_download";
9
+ /** Event name for a crossed scroll threshold; `props.depth` carries which one. */
10
+ declare const SCROLL_EVENT = "scroll_depth";
11
+ declare const GOAL_ATTRIBUTE = "data-analytics-goal";
12
+ interface AutoCaptureHandlers {
13
+ track(name: string, props?: Record<string, unknown>): void;
14
+ trackGoal(slug: string, opts?: {
15
+ value?: number;
16
+ currency?: string;
17
+ }): void;
18
+ }
19
+ interface AutoCapture {
20
+ /** Deepest scroll reached on the current page, or undefined when the toggle is off. */
21
+ scrollDepth(): number | undefined;
22
+ /** Clears the per-page state (scroll thresholds) after a navigation. */
23
+ resetPage(): void;
24
+ destroy(): void;
25
+ }
26
+ /**
27
+ * The delegated listeners behind `capture.autoCapture`. Everything is bound once on
28
+ * `document` in the capture phase, so a handler that stops propagation (or a link that
29
+ * navigates away) cannot swallow the event first, and the listener set never grows with
30
+ * the DOM.
31
+ *
32
+ * A link that is both outbound and a download reports both, matching how the vendors
33
+ * ship those as two independent extensions; turning one toggle off never changes what
34
+ * the other counts.
35
+ *
36
+ * Scroll thresholds are evaluated on scroll only, never on load or on a route change, so
37
+ * a fresh page whose DOM has not rendered yet cannot inherit the previous page's depth.
38
+ * The max fed into the pageview still folds in the position at read time, so a page too
39
+ * short to scroll still reports its depth.
40
+ */
41
+ declare const createAutoCapture: (args: {
42
+ win: TrackerWindow;
43
+ options: ResolvedAutoCapture;
44
+ handlers: AutoCaptureHandlers;
45
+ }) => AutoCapture;
46
+ //#endregion
47
+ export { AutoCapture, AutoCaptureHandlers, DOWNLOAD_EVENT, GOAL_ATTRIBUTE, OUTBOUND_EVENT, SCROLL_EVENT, createAutoCapture };
48
+ //# sourceMappingURL=autoCapture.d.ts.map
@@ -0,0 +1,129 @@
1
+ //#region src/tracker/autoCapture.ts
2
+ /** Event name for a click on a link leaving the site. */
3
+ const OUTBOUND_EVENT = "outbound_link";
4
+ /** Event name for a click on a link whose target is a file. */
5
+ const DOWNLOAD_EVENT = "file_download";
6
+ /** Event name for a crossed scroll threshold; `props.depth` carries which one. */
7
+ const SCROLL_EVENT = "scroll_depth";
8
+ const GOAL_ATTRIBUTE = "data-analytics-goal";
9
+ const VALUE_ATTRIBUTE = "data-analytics-value";
10
+ const CURRENCY_ATTRIBUTE = "data-analytics-currency";
11
+ const DOWNLOAD_EXTENSIONS = new Set([
12
+ "pdf",
13
+ "zip",
14
+ "csv",
15
+ "xlsx",
16
+ "xls",
17
+ "docx",
18
+ "doc",
19
+ "pptx",
20
+ "mp3",
21
+ "mp4",
22
+ "dmg",
23
+ "exe",
24
+ "apk",
25
+ "rar",
26
+ "7z",
27
+ "txt"
28
+ ]);
29
+ const SCROLL_THRESHOLDS = [
30
+ 25,
31
+ 50,
32
+ 75,
33
+ 100
34
+ ];
35
+ const linkFor = (target) => target instanceof Element ? target.closest("a[href]") : null;
36
+ const isDownload = (url) => {
37
+ const extension = url.pathname.split(".").pop()?.toLowerCase();
38
+ return Boolean(extension) && DOWNLOAD_EXTENSIONS.has(extension);
39
+ };
40
+ const goalPayload = (el) => {
41
+ const raw = el.getAttribute(VALUE_ATTRIBUTE)?.trim();
42
+ const value = raw ? Number(raw) : NaN;
43
+ const currency = el.getAttribute(CURRENCY_ATTRIBUTE);
44
+ return {
45
+ ...Number.isFinite(value) ? { value } : {},
46
+ ...currency ? { currency } : {}
47
+ };
48
+ };
49
+ const currentDepth = (win) => {
50
+ const doc = win.document.documentElement;
51
+ const height = Math.max(doc?.scrollHeight ?? 0, win.document.body?.scrollHeight ?? 0);
52
+ if (height <= 0) return 0;
53
+ const viewed = (win.scrollY ?? 0) + (win.innerHeight ?? 0);
54
+ return Math.max(0, Math.min(100, Math.round(viewed / height * 100)));
55
+ };
56
+ /**
57
+ * The delegated listeners behind `capture.autoCapture`. Everything is bound once on
58
+ * `document` in the capture phase, so a handler that stops propagation (or a link that
59
+ * navigates away) cannot swallow the event first, and the listener set never grows with
60
+ * the DOM.
61
+ *
62
+ * A link that is both outbound and a download reports both, matching how the vendors
63
+ * ship those as two independent extensions; turning one toggle off never changes what
64
+ * the other counts.
65
+ *
66
+ * Scroll thresholds are evaluated on scroll only, never on load or on a route change, so
67
+ * a fresh page whose DOM has not rendered yet cannot inherit the previous page's depth.
68
+ * The max fed into the pageview still folds in the position at read time, so a page too
69
+ * short to scroll still reports its depth.
70
+ */
71
+ const createAutoCapture = (args) => {
72
+ const { win, options, handlers } = args;
73
+ const doc = win.document;
74
+ let maxDepth = 0;
75
+ let fired = /* @__PURE__ */ new Set();
76
+ const onClick = (event) => {
77
+ const link = linkFor(event.target);
78
+ if (link) {
79
+ let url = null;
80
+ try {
81
+ url = new URL(link.href, win.location.href);
82
+ } catch {
83
+ url = null;
84
+ }
85
+ if (url && (url.protocol === "http:" || url.protocol === "https:")) {
86
+ if (options.outboundLinks && url.origin !== win.location.origin) handlers.track(OUTBOUND_EVENT, { url: url.href });
87
+ if (options.fileDownloads && isDownload(url)) handlers.track(DOWNLOAD_EVENT, { url: url.href });
88
+ }
89
+ }
90
+ if (!options.goalAttribute) return;
91
+ const goalEl = event.target instanceof Element ? event.target.closest(`[${GOAL_ATTRIBUTE}]`) : null;
92
+ const slug = goalEl?.getAttribute(GOAL_ATTRIBUTE);
93
+ if (goalEl && slug) handlers.trackGoal(slug, goalPayload(goalEl));
94
+ };
95
+ const onSubmit = (event) => {
96
+ const form = event.target instanceof Element ? event.target.closest(`[${GOAL_ATTRIBUTE}]`) : null;
97
+ const slug = form?.getAttribute(GOAL_ATTRIBUTE);
98
+ if (form && slug) handlers.trackGoal(slug, goalPayload(form));
99
+ };
100
+ const onScroll = () => {
101
+ const depth = currentDepth(win);
102
+ if (depth <= maxDepth) return;
103
+ maxDepth = depth;
104
+ for (const threshold of SCROLL_THRESHOLDS) if (depth >= threshold && !fired.has(threshold)) {
105
+ fired.add(threshold);
106
+ handlers.track(SCROLL_EVENT, { depth: threshold });
107
+ }
108
+ };
109
+ const clickBound = options.outboundLinks || options.fileDownloads || options.goalAttribute;
110
+ if (clickBound) doc.addEventListener("click", onClick, true);
111
+ if (options.goalAttribute) doc.addEventListener("submit", onSubmit, true);
112
+ if (options.scrollDepth) win.addEventListener("scroll", onScroll, { passive: true });
113
+ return {
114
+ scrollDepth: () => options.scrollDepth ? Math.max(maxDepth, currentDepth(win)) : void 0,
115
+ resetPage() {
116
+ maxDepth = 0;
117
+ fired = /* @__PURE__ */ new Set();
118
+ },
119
+ destroy() {
120
+ if (clickBound) doc.removeEventListener("click", onClick, true);
121
+ if (options.goalAttribute) doc.removeEventListener("submit", onSubmit, true);
122
+ if (options.scrollDepth) win.removeEventListener("scroll", onScroll);
123
+ }
124
+ };
125
+ };
126
+ //#endregion
127
+ export { DOWNLOAD_EVENT, GOAL_ATTRIBUTE, OUTBOUND_EVENT, SCROLL_EVENT, createAutoCapture };
128
+
129
+ //# sourceMappingURL=autoCapture.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"autoCapture.js","names":[],"sources":["../../src/tracker/autoCapture.ts"],"sourcesContent":["import type { ResolvedAutoCapture } from '../core/options'\nimport type { TrackerWindow } from './types'\n\n/** Event name for a click on a link leaving the site. */\nexport const OUTBOUND_EVENT = 'outbound_link'\n/** Event name for a click on a link whose target is a file. */\nexport const DOWNLOAD_EVENT = 'file_download'\n/** Event name for a crossed scroll threshold; `props.depth` carries which one. */\nexport const SCROLL_EVENT = 'scroll_depth'\n\nexport const GOAL_ATTRIBUTE = 'data-analytics-goal'\nconst VALUE_ATTRIBUTE = 'data-analytics-value'\nconst CURRENCY_ATTRIBUTE = 'data-analytics-currency'\n\nconst DOWNLOAD_EXTENSIONS = new Set([\n\t'pdf',\n\t'zip',\n\t'csv',\n\t'xlsx',\n\t'xls',\n\t'docx',\n\t'doc',\n\t'pptx',\n\t'mp3',\n\t'mp4',\n\t'dmg',\n\t'exe',\n\t'apk',\n\t'rar',\n\t'7z',\n\t'txt',\n])\n\nconst SCROLL_THRESHOLDS = [25, 50, 75, 100] as const\n\nexport interface AutoCaptureHandlers {\n\ttrack(name: string, props?: Record<string, unknown>): void\n\ttrackGoal(slug: string, opts?: { value?: number; currency?: string }): void\n}\n\nexport interface AutoCapture {\n\t/** Deepest scroll reached on the current page, or undefined when the toggle is off. */\n\tscrollDepth(): number | undefined\n\t/** Clears the per-page state (scroll thresholds) after a navigation. */\n\tresetPage(): void\n\tdestroy(): void\n}\n\nconst linkFor = (target: EventTarget | null): HTMLAnchorElement | null =>\n\ttarget instanceof Element ? target.closest('a[href]') : null\n\nconst isDownload = (url: URL): boolean => {\n\tconst extension = url.pathname.split('.').pop()?.toLowerCase()\n\treturn Boolean(extension) && DOWNLOAD_EXTENSIONS.has(extension as string)\n}\n\nconst goalPayload = (el: Element): { value?: number; currency?: string } => {\n\t// Blank is absent, not zero: `Number('')` is 0, and an unfilled template slot must not\n\t// book a zero-revenue conversion.\n\tconst raw = el.getAttribute(VALUE_ATTRIBUTE)?.trim()\n\tconst value = raw ? Number(raw) : Number.NaN\n\tconst currency = el.getAttribute(CURRENCY_ATTRIBUTE)\n\treturn {\n\t\t...(Number.isFinite(value) ? { value } : {}),\n\t\t...(currency ? { currency } : {}),\n\t}\n}\n\nconst currentDepth = (win: TrackerWindow): number => {\n\tconst doc = win.document.documentElement\n\tconst height = Math.max(doc?.scrollHeight ?? 0, win.document.body?.scrollHeight ?? 0)\n\tif (height <= 0) {\n\t\treturn 0\n\t}\n\tconst viewed = (win.scrollY ?? 0) + (win.innerHeight ?? 0)\n\treturn Math.max(0, Math.min(100, Math.round((viewed / height) * 100)))\n}\n\n/**\n * The delegated listeners behind `capture.autoCapture`. Everything is bound once on\n * `document` in the capture phase, so a handler that stops propagation (or a link that\n * navigates away) cannot swallow the event first, and the listener set never grows with\n * the DOM.\n *\n * A link that is both outbound and a download reports both, matching how the vendors\n * ship those as two independent extensions; turning one toggle off never changes what\n * the other counts.\n *\n * Scroll thresholds are evaluated on scroll only, never on load or on a route change, so\n * a fresh page whose DOM has not rendered yet cannot inherit the previous page's depth.\n * The max fed into the pageview still folds in the position at read time, so a page too\n * short to scroll still reports its depth.\n */\nexport const createAutoCapture = (args: {\n\twin: TrackerWindow\n\toptions: ResolvedAutoCapture\n\thandlers: AutoCaptureHandlers\n}): AutoCapture => {\n\tconst { win, options, handlers } = args\n\tconst doc = win.document\n\tlet maxDepth = 0\n\tlet fired = new Set<number>()\n\n\tconst onClick = (event: Event) => {\n\t\tconst link = linkFor(event.target)\n\t\tif (link) {\n\t\t\tlet url: URL | null = null\n\t\t\ttry {\n\t\t\t\turl = new URL(link.href, win.location.href)\n\t\t\t} catch {\n\t\t\t\turl = null\n\t\t\t}\n\t\t\tif (url && (url.protocol === 'http:' || url.protocol === 'https:')) {\n\t\t\t\tif (options.outboundLinks && url.origin !== win.location.origin) {\n\t\t\t\t\thandlers.track(OUTBOUND_EVENT, { url: url.href })\n\t\t\t\t}\n\t\t\t\tif (options.fileDownloads && isDownload(url)) {\n\t\t\t\t\thandlers.track(DOWNLOAD_EVENT, { url: url.href })\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t\tif (!options.goalAttribute) {\n\t\t\treturn\n\t\t}\n\t\tconst goalEl =\n\t\t\tevent.target instanceof Element ? event.target.closest(`[${GOAL_ATTRIBUTE}]`) : null\n\t\tconst slug = goalEl?.getAttribute(GOAL_ATTRIBUTE)\n\t\tif (goalEl && slug) {\n\t\t\thandlers.trackGoal(slug, goalPayload(goalEl))\n\t\t}\n\t}\n\n\tconst onSubmit = (event: Event) => {\n\t\tconst form =\n\t\t\tevent.target instanceof Element ? event.target.closest(`[${GOAL_ATTRIBUTE}]`) : null\n\t\tconst slug = form?.getAttribute(GOAL_ATTRIBUTE)\n\t\tif (form && slug) {\n\t\t\thandlers.trackGoal(slug, goalPayload(form))\n\t\t}\n\t}\n\n\tconst onScroll = () => {\n\t\tconst depth = currentDepth(win)\n\t\tif (depth <= maxDepth) {\n\t\t\treturn\n\t\t}\n\t\tmaxDepth = depth\n\t\tfor (const threshold of SCROLL_THRESHOLDS) {\n\t\t\tif (depth >= threshold && !fired.has(threshold)) {\n\t\t\t\tfired.add(threshold)\n\t\t\t\thandlers.track(SCROLL_EVENT, { depth: threshold })\n\t\t\t}\n\t\t}\n\t}\n\n\tconst clickBound = options.outboundLinks || options.fileDownloads || options.goalAttribute\n\tif (clickBound) {\n\t\tdoc.addEventListener('click', onClick, true)\n\t}\n\tif (options.goalAttribute) {\n\t\tdoc.addEventListener('submit', onSubmit, true)\n\t}\n\tif (options.scrollDepth) {\n\t\twin.addEventListener('scroll', onScroll, { passive: true })\n\t}\n\n\treturn {\n\t\tscrollDepth: () => (options.scrollDepth ? Math.max(maxDepth, currentDepth(win)) : undefined),\n\t\tresetPage() {\n\t\t\tmaxDepth = 0\n\t\t\tfired = new Set<number>()\n\t\t},\n\t\tdestroy() {\n\t\t\tif (clickBound) {\n\t\t\t\tdoc.removeEventListener('click', onClick, true)\n\t\t\t}\n\t\t\tif (options.goalAttribute) {\n\t\t\t\tdoc.removeEventListener('submit', onSubmit, true)\n\t\t\t}\n\t\t\tif (options.scrollDepth) {\n\t\t\t\twin.removeEventListener('scroll', onScroll)\n\t\t\t}\n\t\t},\n\t}\n}\n"],"mappings":"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"}
@@ -0,0 +1,24 @@
1
+ import { ConsentState, TrackerWindow } from "./types.js";
2
+
3
+ //#region src/tracker/consent.d.ts
4
+ /** Where a persisted decision lives. Stable across releases: hosts read it too. */
5
+ declare const CONSENT_STORAGE_KEY = "analytics:consent";
6
+ /**
7
+ * How many events wait for a decision before the oldest is dropped. A visitor who never
8
+ * answers the banner must not grow the tab's memory without bound.
9
+ */
10
+ declare const CONSENT_QUEUE_LIMIT = 100;
11
+ /** Reads the persisted decision. Null when absent, unreadable, or not a decision. */
12
+ declare const readConsent: (win: TrackerWindow) => ConsentState | null;
13
+ declare const writeConsent: (win: TrackerWindow, state: ConsentState) => void;
14
+ interface ConsentQueue<T> {
15
+ push(item: T): void;
16
+ drain(): T[];
17
+ clear(): void;
18
+ readonly size: number;
19
+ }
20
+ /** Bounded FIFO buffer holding events until a consent decision arrives. */
21
+ declare const createConsentQueue: <T>(limit?: number) => ConsentQueue<T>;
22
+ //#endregion
23
+ export { CONSENT_QUEUE_LIMIT, CONSENT_STORAGE_KEY, createConsentQueue, readConsent, writeConsent };
24
+ //# sourceMappingURL=consent.d.ts.map
@@ -0,0 +1,48 @@
1
+ //#region src/tracker/consent.ts
2
+ /** Where a persisted decision lives. Stable across releases: hosts read it too. */
3
+ const CONSENT_STORAGE_KEY = "analytics:consent";
4
+ /**
5
+ * How many events wait for a decision before the oldest is dropped. A visitor who never
6
+ * answers the banner must not grow the tab's memory without bound.
7
+ */
8
+ const CONSENT_QUEUE_LIMIT = 100;
9
+ const isConsentState = (value) => value === "granted" || value === "denied";
10
+ /** Reads the persisted decision. Null when absent, unreadable, or not a decision. */
11
+ const readConsent = (win) => {
12
+ try {
13
+ const stored = win.localStorage?.getItem(CONSENT_STORAGE_KEY);
14
+ return isConsentState(stored) ? stored : null;
15
+ } catch {
16
+ return null;
17
+ }
18
+ };
19
+ const writeConsent = (win, state) => {
20
+ try {
21
+ win.localStorage?.setItem(CONSENT_STORAGE_KEY, state);
22
+ } catch {}
23
+ };
24
+ /** Bounded FIFO buffer holding events until a consent decision arrives. */
25
+ const createConsentQueue = (limit = 100) => {
26
+ let items = [];
27
+ return {
28
+ push(item) {
29
+ items.push(item);
30
+ if (items.length > limit) items.splice(0, items.length - limit);
31
+ },
32
+ drain() {
33
+ const drained = items;
34
+ items = [];
35
+ return drained;
36
+ },
37
+ clear() {
38
+ items = [];
39
+ },
40
+ get size() {
41
+ return items.length;
42
+ }
43
+ };
44
+ };
45
+ //#endregion
46
+ export { CONSENT_QUEUE_LIMIT, CONSENT_STORAGE_KEY, createConsentQueue, readConsent, writeConsent };
47
+
48
+ //# sourceMappingURL=consent.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"consent.js","names":[],"sources":["../../src/tracker/consent.ts"],"sourcesContent":["import type { ConsentState, TrackerWindow } from './types'\n\n/** Where a persisted decision lives. Stable across releases: hosts read it too. */\nexport const CONSENT_STORAGE_KEY = 'analytics:consent'\n\n/**\n * How many events wait for a decision before the oldest is dropped. A visitor who never\n * answers the banner must not grow the tab's memory without bound.\n */\nexport const CONSENT_QUEUE_LIMIT = 100\n\nconst isConsentState = (value: unknown): value is ConsentState =>\n\tvalue === 'granted' || value === 'denied'\n\n/** Reads the persisted decision. Null when absent, unreadable, or not a decision. */\nexport const readConsent = (win: TrackerWindow): ConsentState | null => {\n\ttry {\n\t\tconst stored = win.localStorage?.getItem(CONSENT_STORAGE_KEY)\n\t\treturn isConsentState(stored) ? stored : null\n\t} catch {\n\t\t// Storage disabled (Safari private mode, a strict partitioning policy).\n\t\treturn null\n\t}\n}\n\nexport const writeConsent = (win: TrackerWindow, state: ConsentState): void => {\n\ttry {\n\t\twin.localStorage?.setItem(CONSENT_STORAGE_KEY, state)\n\t} catch {\n\t\t// Storage disabled; the decision holds for this page only.\n\t}\n}\n\nexport interface ConsentQueue<T> {\n\tpush(item: T): void\n\tdrain(): T[]\n\tclear(): void\n\treadonly size: number\n}\n\n/** Bounded FIFO buffer holding events until a consent decision arrives. */\nexport const createConsentQueue = <T>(limit: number = CONSENT_QUEUE_LIMIT): ConsentQueue<T> => {\n\tlet items: T[] = []\n\treturn {\n\t\tpush(item) {\n\t\t\titems.push(item)\n\t\t\tif (items.length > limit) {\n\t\t\t\titems.splice(0, items.length - limit)\n\t\t\t}\n\t\t},\n\t\tdrain() {\n\t\t\tconst drained = items\n\t\t\titems = []\n\t\t\treturn drained\n\t\t},\n\t\tclear() {\n\t\t\titems = []\n\t\t},\n\t\tget size() {\n\t\t\treturn items.length\n\t\t},\n\t}\n}\n"],"mappings":";;AAGA,MAAa,sBAAsB;;;;;AAMnC,MAAa,sBAAsB;AAEnC,MAAM,kBAAkB,UACvB,UAAU,aAAa,UAAU;;AAGlC,MAAa,eAAe,QAA4C;CACvE,IAAI;EACH,MAAM,SAAS,IAAI,cAAc,QAAQ,mBAAmB;EAC5D,OAAO,eAAe,MAAM,IAAI,SAAS;CAC1C,QAAQ;EAEP,OAAO;CACR;AACD;AAEA,MAAa,gBAAgB,KAAoB,UAA8B;CAC9E,IAAI;EACH,IAAI,cAAc,QAAQ,qBAAqB,KAAK;CACrD,QAAQ,CAER;AACD;;AAUA,MAAa,sBAAyB,QAAA,QAAyD;CAC9F,IAAI,QAAa,CAAC;CAClB,OAAO;EACN,KAAK,MAAM;GACV,MAAM,KAAK,IAAI;GACf,IAAI,MAAM,SAAS,OAClB,MAAM,OAAO,GAAG,MAAM,SAAS,KAAK;EAEtC;EACA,QAAQ;GACP,MAAM,UAAU;GAChB,QAAQ,CAAC;GACT,OAAO;EACR;EACA,QAAQ;GACP,QAAQ,CAAC;EACV;EACA,IAAI,OAAO;GACV,OAAO,MAAM;EACd;CACD;AACD"}
@@ -0,0 +1,18 @@
1
+ import { TrackerConfig } from "../capture/trackerConfig.js";
2
+ import { Tracker, TrackerOptions } from "./types.js";
3
+
4
+ //#region src/tracker/createTracker.d.ts
5
+ /** Stand-in for a host with no DOM (server rendering, a worker). Every call is a no-op. */
6
+ declare const createNoopTracker: () => Tracker;
7
+ /**
8
+ * The browser tracker: one sink per capture slot, a consent gate in front of the slots the
9
+ * server marked as gated, SPA page tracking, and the auto-capture listeners.
10
+ *
11
+ * Every event fans out to every slot; there is no dual-write of one slot's events into
12
+ * another. The config is a server-rendered snapshot, so an unknown goal slug is still sent:
13
+ * the server may know goals the snapshot predates.
14
+ */
15
+ declare const createTracker: (config: TrackerConfig, options?: TrackerOptions) => Tracker;
16
+ //#endregion
17
+ export { createNoopTracker, createTracker };
18
+ //# sourceMappingURL=createTracker.d.ts.map
@@ -0,0 +1,163 @@
1
+ import { createAutoCapture } from "./autoCapture.js";
2
+ import { createConsentQueue, readConsent, writeConsent } from "./consent.js";
3
+ import { createScriptLoader } from "./loadScript.js";
4
+ import { createPageTracking } from "./pageTracking.js";
5
+ import { createNativeSink } from "./sinks/native.js";
6
+ import { createPlausibleSink } from "./sinks/plausible.js";
7
+ import { createPosthogSink } from "./sinks/posthog.js";
8
+ import { createUmamiSink } from "./sinks/umami.js";
9
+ //#region src/tracker/createTracker.ts
10
+ /** Stand-in for a host with no DOM (server rendering, a worker). Every call is a no-op. */
11
+ const createNoopTracker = () => ({
12
+ page: () => void 0,
13
+ track: () => void 0,
14
+ trackGoal: () => void 0,
15
+ consent: () => void 0,
16
+ flush: () => void 0,
17
+ destroy: () => void 0
18
+ });
19
+ const buildSink = (args) => {
20
+ const { slot, win, loadScript, ingestPath, scrollDepth } = args;
21
+ const vendor = {
22
+ slot: slot.slot,
23
+ win,
24
+ scripts: slot.snippet.scripts,
25
+ loadScript
26
+ };
27
+ switch (slot.kind) {
28
+ case "native": return createNativeSink({
29
+ slot: slot.slot,
30
+ win,
31
+ url: ingestPath,
32
+ scrollDepth
33
+ });
34
+ case "posthog": return createPosthogSink(vendor);
35
+ case "plausible": return createPlausibleSink(vendor);
36
+ case "umami": return createUmamiSink(vendor);
37
+ }
38
+ };
39
+ /**
40
+ * The browser tracker: one sink per capture slot, a consent gate in front of the slots the
41
+ * server marked as gated, SPA page tracking, and the auto-capture listeners.
42
+ *
43
+ * Every event fans out to every slot; there is no dual-write of one slot's events into
44
+ * another. The config is a server-rendered snapshot, so an unknown goal slug is still sent:
45
+ * the server may know goals the snapshot predates.
46
+ */
47
+ const createTracker = (config, options = {}) => {
48
+ const win = options.window ?? globalThis.window;
49
+ if (!win) return createNoopTracker();
50
+ const persist = options.persistConsent !== false;
51
+ const loadScript = options.loadScript ?? createScriptLoader(win, options.nonce);
52
+ const queue = createConsentQueue();
53
+ let auto = null;
54
+ let state = persist ? readConsent(win) : null;
55
+ const entries = config.slots.map((slot) => ({
56
+ requiresConsent: slot.requiresConsent,
57
+ sink: buildSink({
58
+ slot,
59
+ win,
60
+ loadScript,
61
+ ingestPath: config.ingestPath,
62
+ scrollDepth: () => auto?.scrollDepth()
63
+ })
64
+ }));
65
+ const load = (sink) => {
66
+ sink.ready().catch(() => void 0);
67
+ };
68
+ /**
69
+ * Slots are isolated from each other and from the caller: a vendor global that throws,
70
+ * or an event that cannot be serialized, must not skip the remaining slots or escape
71
+ * into the host's click handler.
72
+ */
73
+ const guard = (run) => {
74
+ try {
75
+ run();
76
+ } catch {}
77
+ };
78
+ const deliver = (sink, event) => {
79
+ guard(() => sink.send(event));
80
+ };
81
+ const dispatch = (event) => {
82
+ for (const entry of entries) if (!entry.requiresConsent || state === "granted") deliver(entry.sink, event);
83
+ else if (state !== "denied") queue.push({
84
+ sink: entry.sink,
85
+ event
86
+ });
87
+ };
88
+ const context = () => ({
89
+ path: win.location.pathname,
90
+ hostname: win.location.hostname,
91
+ ...win.document.referrer ? { referrer: win.document.referrer } : {}
92
+ });
93
+ const page = () => {
94
+ dispatch({
95
+ type: "pageview",
96
+ ...context()
97
+ });
98
+ auto?.resetPage();
99
+ };
100
+ const track = (name, props) => {
101
+ dispatch({
102
+ type: "event",
103
+ name,
104
+ ...context(),
105
+ ...props ? { props } : {}
106
+ });
107
+ };
108
+ const trackGoal = (slug, opts) => {
109
+ const goal = config.goals.find((candidate) => candidate.slug === slug);
110
+ const value = opts?.value ?? goal?.value?.fixed;
111
+ const currency = opts?.currency ?? goal?.currency;
112
+ dispatch({
113
+ type: "goal",
114
+ name: slug,
115
+ ...context(),
116
+ ...value === void 0 ? {} : { value },
117
+ ...currency === void 0 ? {} : { currency }
118
+ });
119
+ };
120
+ const flush = () => {
121
+ for (const entry of entries) guard(() => entry.sink.flush?.());
122
+ };
123
+ auto = createAutoCapture({
124
+ win,
125
+ options: config.autoCapture,
126
+ handlers: {
127
+ track,
128
+ trackGoal
129
+ }
130
+ });
131
+ const pageTracking = createPageTracking(win, page);
132
+ win.addEventListener("pagehide", flush);
133
+ for (const entry of entries) if (!entry.requiresConsent || state === "granted") load(entry.sink);
134
+ page();
135
+ return {
136
+ page,
137
+ track,
138
+ trackGoal,
139
+ flush,
140
+ consent(next) {
141
+ state = next;
142
+ if (persist) writeConsent(win, next);
143
+ if (next === "denied") {
144
+ queue.clear();
145
+ return;
146
+ }
147
+ for (const entry of entries) if (entry.requiresConsent) load(entry.sink);
148
+ for (const queued of queue.drain()) deliver(queued.sink, queued.event);
149
+ },
150
+ destroy() {
151
+ flush();
152
+ pageTracking.destroy();
153
+ auto?.destroy();
154
+ auto = null;
155
+ win.removeEventListener("pagehide", flush);
156
+ queue.clear();
157
+ }
158
+ };
159
+ };
160
+ //#endregion
161
+ export { createNoopTracker, createTracker };
162
+
163
+ //# sourceMappingURL=createTracker.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"createTracker.js","names":[],"sources":["../../src/tracker/createTracker.ts"],"sourcesContent":["import type { TrackerConfig, TrackerSlotConfig } from '../capture/trackerConfig'\nimport { type AutoCapture, createAutoCapture } from './autoCapture'\nimport { createConsentQueue, readConsent, writeConsent } from './consent'\nimport { createScriptLoader } from './loadScript'\nimport { createPageTracking } from './pageTracking'\nimport { createNativeSink } from './sinks/native'\nimport { createPlausibleSink } from './sinks/plausible'\nimport { createPosthogSink } from './sinks/posthog'\nimport { createUmamiSink } from './sinks/umami'\nimport type {\n\tConsentState,\n\tLoadScript,\n\tSink,\n\tTracker,\n\tTrackerEvent,\n\tTrackerOptions,\n\tTrackerWindow,\n} from './types'\n\n/** Stand-in for a host with no DOM (server rendering, a worker). Every call is a no-op. */\nexport const createNoopTracker = (): Tracker => ({\n\tpage: () => undefined,\n\ttrack: () => undefined,\n\ttrackGoal: () => undefined,\n\tconsent: () => undefined,\n\tflush: () => undefined,\n\tdestroy: () => undefined,\n})\n\nconst buildSink = (args: {\n\tslot: TrackerSlotConfig\n\twin: TrackerWindow\n\tloadScript: LoadScript\n\tingestPath: string\n\tscrollDepth: () => number | undefined\n}): Sink => {\n\tconst { slot, win, loadScript, ingestPath, scrollDepth } = args\n\tconst vendor = { slot: slot.slot, win, scripts: slot.snippet.scripts, loadScript }\n\tswitch (slot.kind) {\n\t\tcase 'native':\n\t\t\treturn createNativeSink({ slot: slot.slot, win, url: ingestPath, scrollDepth })\n\t\tcase 'posthog':\n\t\t\treturn createPosthogSink(vendor)\n\t\tcase 'plausible':\n\t\t\treturn createPlausibleSink(vendor)\n\t\tcase 'umami':\n\t\t\treturn createUmamiSink(vendor)\n\t}\n}\n\n/**\n * The browser tracker: one sink per capture slot, a consent gate in front of the slots the\n * server marked as gated, SPA page tracking, and the auto-capture listeners.\n *\n * Every event fans out to every slot; there is no dual-write of one slot's events into\n * another. The config is a server-rendered snapshot, so an unknown goal slug is still sent:\n * the server may know goals the snapshot predates.\n */\nexport const createTracker = (config: TrackerConfig, options: TrackerOptions = {}): Tracker => {\n\tconst win = options.window ?? (globalThis as { window?: TrackerWindow }).window\n\tif (!win) {\n\t\treturn createNoopTracker()\n\t}\n\tconst persist = options.persistConsent !== false\n\tconst loadScript = options.loadScript ?? createScriptLoader(win, options.nonce)\n\tconst queue = createConsentQueue<{ sink: Sink; event: TrackerEvent }>()\n\tlet auto: AutoCapture | null = null\n\tlet state: ConsentState | null = persist ? readConsent(win) : null\n\n\tconst entries = config.slots.map((slot) => ({\n\t\trequiresConsent: slot.requiresConsent,\n\t\tsink: buildSink({\n\t\t\tslot,\n\t\t\twin,\n\t\t\tloadScript,\n\t\t\tingestPath: config.ingestPath,\n\t\t\tscrollDepth: () => auto?.scrollDepth(),\n\t\t}),\n\t}))\n\n\tconst load = (sink: Sink) => {\n\t\tvoid sink.ready().catch(() => undefined)\n\t}\n\n\t/**\n\t * Slots are isolated from each other and from the caller: a vendor global that throws,\n\t * or an event that cannot be serialized, must not skip the remaining slots or escape\n\t * into the host's click handler.\n\t */\n\tconst guard = (run: () => void) => {\n\t\ttry {\n\t\t\trun()\n\t\t} catch {\n\t\t\t// Dropped, like every other delivery failure.\n\t\t}\n\t}\n\n\tconst deliver = (sink: Sink, event: TrackerEvent) => {\n\t\tguard(() => sink.send(event))\n\t}\n\n\tconst dispatch = (event: TrackerEvent) => {\n\t\tfor (const entry of entries) {\n\t\t\tif (!entry.requiresConsent || state === 'granted') {\n\t\t\t\tdeliver(entry.sink, event)\n\t\t\t} else if (state !== 'denied') {\n\t\t\t\tqueue.push({ sink: entry.sink, event })\n\t\t\t}\n\t\t}\n\t}\n\n\tconst context = (): Pick<TrackerEvent, 'path' | 'hostname' | 'referrer'> => ({\n\t\tpath: win.location.pathname,\n\t\thostname: win.location.hostname,\n\t\t...(win.document.referrer ? { referrer: win.document.referrer } : {}),\n\t})\n\n\tconst page = () => {\n\t\tdispatch({ type: 'pageview', ...context() })\n\t\tauto?.resetPage()\n\t}\n\n\tconst track = (name: string, props?: Record<string, unknown>) => {\n\t\tdispatch({ type: 'event', name, ...context(), ...(props ? { props } : {}) })\n\t}\n\n\tconst trackGoal = (slug: string, opts?: { value?: number; currency?: string }) => {\n\t\tconst goal = config.goals.find((candidate) => candidate.slug === slug)\n\t\tconst value = opts?.value ?? goal?.value?.fixed\n\t\tconst currency = opts?.currency ?? goal?.currency\n\t\tdispatch({\n\t\t\ttype: 'goal',\n\t\t\tname: slug,\n\t\t\t...context(),\n\t\t\t...(value === undefined ? {} : { value }),\n\t\t\t...(currency === undefined ? {} : { currency }),\n\t\t})\n\t}\n\n\tconst flush = () => {\n\t\tfor (const entry of entries) {\n\t\t\tguard(() => entry.sink.flush?.())\n\t\t}\n\t}\n\n\tauto = createAutoCapture({\n\t\twin,\n\t\toptions: config.autoCapture,\n\t\thandlers: { track, trackGoal },\n\t})\n\tconst pageTracking = createPageTracking(win, page)\n\twin.addEventListener('pagehide', flush)\n\n\tfor (const entry of entries) {\n\t\tif (!entry.requiresConsent || state === 'granted') {\n\t\t\tload(entry.sink)\n\t\t}\n\t}\n\tpage()\n\n\treturn {\n\t\tpage,\n\t\ttrack,\n\t\ttrackGoal,\n\t\tflush,\n\t\tconsent(next) {\n\t\t\tstate = next\n\t\t\tif (persist) {\n\t\t\t\twriteConsent(win, next)\n\t\t\t}\n\t\t\tif (next === 'denied') {\n\t\t\t\tqueue.clear()\n\t\t\t\treturn\n\t\t\t}\n\t\t\tfor (const entry of entries) {\n\t\t\t\tif (entry.requiresConsent) {\n\t\t\t\t\tload(entry.sink)\n\t\t\t\t}\n\t\t\t}\n\t\t\tfor (const queued of queue.drain()) {\n\t\t\t\tdeliver(queued.sink, queued.event)\n\t\t\t}\n\t\t},\n\t\tdestroy() {\n\t\t\tflush()\n\t\t\tpageTracking.destroy()\n\t\t\tauto?.destroy()\n\t\t\tauto = null\n\t\t\twin.removeEventListener('pagehide', flush)\n\t\t\tqueue.clear()\n\t\t},\n\t}\n}\n"],"mappings":"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"}
@@ -0,0 +1,22 @@
1
+ import { Tracker, TrackerOptions } from "./types.js";
2
+
3
+ //#region src/tracker/initTracker.d.ts
4
+ /**
5
+ * Where the plugin mounts the public tracker config on a default install. The only place
6
+ * the path is written down on the client: the RSC path hands the config over directly, and
7
+ * an app that moved `routes.api` passes its own `endpoint`.
8
+ */
9
+ declare const DEFAULT_TRACKER_ENDPOINT = "/api/analytics/tracker";
10
+ interface InitTrackerArgs extends TrackerOptions {
11
+ endpoint?: string;
12
+ }
13
+ /**
14
+ * Boots the tracker from the public tracker endpoint, for hosts that render no RSC. The
15
+ * request is same-origin so a scoped install resolves the visitor's tenant from the request
16
+ * itself. A config that cannot be fetched yields a tracker that does nothing rather than a
17
+ * rejected promise: a missing analytics config must never break the page that awaited it.
18
+ */
19
+ declare const initTracker: (args?: InitTrackerArgs) => Promise<Tracker>;
20
+ //#endregion
21
+ export { DEFAULT_TRACKER_ENDPOINT, InitTrackerArgs, initTracker };
22
+ //# sourceMappingURL=initTracker.d.ts.map
@@ -0,0 +1,33 @@
1
+ import { createNoopTracker, createTracker } from "./createTracker.js";
2
+ //#region src/tracker/initTracker.ts
3
+ /**
4
+ * Where the plugin mounts the public tracker config on a default install. The only place
5
+ * the path is written down on the client: the RSC path hands the config over directly, and
6
+ * an app that moved `routes.api` passes its own `endpoint`.
7
+ */
8
+ const DEFAULT_TRACKER_ENDPOINT = "/api/analytics/tracker";
9
+ /**
10
+ * Boots the tracker from the public tracker endpoint, for hosts that render no RSC. The
11
+ * request is same-origin so a scoped install resolves the visitor's tenant from the request
12
+ * itself. A config that cannot be fetched yields a tracker that does nothing rather than a
13
+ * rejected promise: a missing analytics config must never break the page that awaited it.
14
+ */
15
+ const initTracker = async (args = {}) => {
16
+ const { endpoint = DEFAULT_TRACKER_ENDPOINT, ...options } = args;
17
+ const win = options.window ?? globalThis.window;
18
+ if (!win) return createNoopTracker();
19
+ try {
20
+ const response = await win.fetch(endpoint, { credentials: "same-origin" });
21
+ if (!response.ok) return createNoopTracker();
22
+ return createTracker(await response.json(), {
23
+ ...options,
24
+ window: win
25
+ });
26
+ } catch {
27
+ return createNoopTracker();
28
+ }
29
+ };
30
+ //#endregion
31
+ export { DEFAULT_TRACKER_ENDPOINT, initTracker };
32
+
33
+ //# sourceMappingURL=initTracker.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"initTracker.js","names":[],"sources":["../../src/tracker/initTracker.ts"],"sourcesContent":["import type { TrackerConfig } from '../capture/trackerConfig'\nimport { createNoopTracker, createTracker } from './createTracker'\nimport type { Tracker, TrackerOptions, TrackerWindow } from './types'\n\n/**\n * Where the plugin mounts the public tracker config on a default install. The only place\n * the path is written down on the client: the RSC path hands the config over directly, and\n * an app that moved `routes.api` passes its own `endpoint`.\n */\nexport const DEFAULT_TRACKER_ENDPOINT = '/api/analytics/tracker'\n\nexport interface InitTrackerArgs extends TrackerOptions {\n\tendpoint?: string\n}\n\n/**\n * Boots the tracker from the public tracker endpoint, for hosts that render no RSC. The\n * request is same-origin so a scoped install resolves the visitor's tenant from the request\n * itself. A config that cannot be fetched yields a tracker that does nothing rather than a\n * rejected promise: a missing analytics config must never break the page that awaited it.\n */\nexport const initTracker = async (args: InitTrackerArgs = {}): Promise<Tracker> => {\n\tconst { endpoint = DEFAULT_TRACKER_ENDPOINT, ...options } = args\n\tconst win = options.window ?? (globalThis as { window?: TrackerWindow }).window\n\tif (!win) {\n\t\treturn createNoopTracker()\n\t}\n\ttry {\n\t\tconst response = await win.fetch(endpoint, { credentials: 'same-origin' })\n\t\tif (!response.ok) {\n\t\t\treturn createNoopTracker()\n\t\t}\n\t\treturn createTracker((await response.json()) as TrackerConfig, { ...options, window: win })\n\t} catch {\n\t\treturn createNoopTracker()\n\t}\n}\n"],"mappings":";;;;;;;AASA,MAAa,2BAA2B;;;;;;;AAYxC,MAAa,cAAc,OAAO,OAAwB,CAAC,MAAwB;CAClF,MAAM,EAAE,WAAW,0BAA0B,GAAG,YAAY;CAC5D,MAAM,MAAM,QAAQ,UAAW,WAA0C;CACzE,IAAI,CAAC,KACJ,OAAO,kBAAkB;CAE1B,IAAI;EACH,MAAM,WAAW,MAAM,IAAI,MAAM,UAAU,EAAE,aAAa,cAAc,CAAC;EACzE,IAAI,CAAC,SAAS,IACb,OAAO,kBAAkB;EAE1B,OAAO,cAAe,MAAM,SAAS,KAAK,GAAqB;GAAE,GAAG;GAAS,QAAQ;EAAI,CAAC;CAC3F,QAAQ;EACP,OAAO,kBAAkB;CAC1B;AACD"}
@@ -0,0 +1,14 @@
1
+ import { LoadScript, TrackerWindow } from "./types.js";
2
+
3
+ //#region src/tracker/loadScript.d.ts
4
+ /**
5
+ * The default `loadScript` seam: injects a snippet script into `<head>`, resolving once it
6
+ * has run. A script the page already carries is a no-op, which is what makes the RSC path
7
+ * safe: `AnalyticsScripts` renders the same snippets server-side, and the sink booting over
8
+ * them must not load a second copy. Inline scripts resolve as soon as they are appended,
9
+ * since appending runs them.
10
+ */
11
+ declare const createScriptLoader: (win: TrackerWindow, nonce?: string) => LoadScript;
12
+ //#endregion
13
+ export { createScriptLoader };
14
+ //# sourceMappingURL=loadScript.d.ts.map