@10x-media/analytics 0.1.0-beta.4 → 1.0.0-beta.6

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 (112) hide show
  1. package/CHANGELOG.md +25 -0
  2. package/LICENSE +21 -21
  3. package/dist/adapters/ga4/ga4.js +13 -0
  4. package/dist/adapters/ga4/ga4.js.map +1 -1
  5. package/dist/adapters/plausible/plausible.js +11 -0
  6. package/dist/adapters/plausible/plausible.js.map +1 -1
  7. package/dist/adapters/posthog/posthog.js +37 -3
  8. package/dist/adapters/posthog/posthog.js.map +1 -1
  9. package/dist/adapters/series.js +11 -1
  10. package/dist/adapters/series.js.map +1 -1
  11. package/dist/adapters/umami/umami.js +2 -0
  12. package/dist/adapters/umami/umami.js.map +1 -1
  13. package/dist/core/capabilities.d.ts +17 -2
  14. package/dist/core/capabilities.js +15 -1
  15. package/dist/core/capabilities.js.map +1 -1
  16. package/dist/core/contract.d.ts +7 -2
  17. package/dist/core/contract.js.map +1 -1
  18. package/dist/core/options.d.ts +4 -2
  19. package/dist/core/options.js +7 -2
  20. package/dist/core/options.js.map +1 -1
  21. package/dist/core/scopedRead.js +7 -6
  22. package/dist/core/scopedRead.js.map +1 -1
  23. package/dist/exports/client.d.ts +5 -1
  24. package/dist/exports/client.js +4 -1
  25. package/dist/exports/rsc.d.ts +3 -3
  26. package/dist/exports/types.d.ts +3 -2
  27. package/dist/fields/config/MetricSelectField.d.ts +23 -0
  28. package/dist/fields/config/MetricSelectField.js +51 -0
  29. package/dist/fields/config/MetricSelectField.js.map +1 -0
  30. package/dist/fields/config/SourceSelectField.d.ts +14 -0
  31. package/dist/fields/config/SourceSelectField.js +46 -0
  32. package/dist/fields/config/SourceSelectField.js.map +1 -0
  33. package/dist/fields/config/fetchSources.d.ts +12 -0
  34. package/dist/fields/config/fetchSources.js +29 -0
  35. package/dist/fields/config/fetchSources.js.map +1 -0
  36. package/dist/fields/config/narrow.js +30 -0
  37. package/dist/fields/config/narrow.js.map +1 -0
  38. package/dist/fields/config/sourcesState.js +11 -0
  39. package/dist/fields/config/sourcesState.js.map +1 -0
  40. package/dist/fields/config/toSelectOption.js +27 -0
  41. package/dist/fields/config/toSelectOption.js.map +1 -0
  42. package/dist/fields/config/useAnalyticsSources.d.ts +19 -0
  43. package/dist/fields/config/useAnalyticsSources.js +59 -0
  44. package/dist/fields/config/useAnalyticsSources.js.map +1 -0
  45. package/dist/index.js +26 -10
  46. package/dist/index.js.map +1 -1
  47. package/dist/native/collections/rollups.js +15 -3
  48. package/dist/native/collections/rollups.js.map +1 -1
  49. package/dist/native/nativeAdapter.js +81 -2
  50. package/dist/native/nativeAdapter.js.map +1 -1
  51. package/dist/native/query/eventAgg.js +135 -0
  52. package/dist/native/query/eventAgg.js.map +1 -0
  53. package/dist/native/rollups/applyDistinctDeltas.js +1 -1
  54. package/dist/native/rollups/applyDistinctDeltas.js.map +1 -1
  55. package/dist/native/rollups/bumpRollup.js +2 -1
  56. package/dist/native/rollups/bumpRollup.js.map +1 -1
  57. package/dist/native/rollups/deltas.js +45 -8
  58. package/dist/native/rollups/deltas.js.map +1 -1
  59. package/dist/plugin/paths.js +3 -1
  60. package/dist/plugin/paths.js.map +1 -1
  61. package/dist/plugin/realtimeEndpoint.js +2 -2
  62. package/dist/plugin/realtimeEndpoint.js.map +1 -1
  63. package/dist/plugin/runtime.js.map +1 -1
  64. package/dist/plugin/sourcesEndpoint.js +53 -0
  65. package/dist/plugin/sourcesEndpoint.js.map +1 -0
  66. package/dist/providers/access.js +2 -1
  67. package/dist/providers/access.js.map +1 -1
  68. package/dist/providers/collection.js +1 -0
  69. package/dist/providers/collection.js.map +1 -1
  70. package/dist/sync/collection.js +23 -7
  71. package/dist/sync/collection.js.map +1 -1
  72. package/dist/sync/syncTask.js +12 -4
  73. package/dist/sync/syncTask.js.map +1 -1
  74. package/dist/testing/memoryAdapter.js +7 -0
  75. package/dist/testing/memoryAdapter.js.map +1 -1
  76. package/dist/translations/ar.js +77 -0
  77. package/dist/translations/ar.js.map +1 -0
  78. package/dist/translations/es.js +77 -0
  79. package/dist/translations/es.js.map +1 -0
  80. package/dist/translations/fr.js +77 -0
  81. package/dist/translations/fr.js.map +1 -0
  82. package/dist/translations/id.js +77 -0
  83. package/dist/translations/id.js.map +1 -0
  84. package/dist/translations/index.d.ts +10 -1
  85. package/dist/translations/index.js +19 -1
  86. package/dist/translations/index.js.map +1 -1
  87. package/dist/translations/ko.js +77 -0
  88. package/dist/translations/ko.js.map +1 -0
  89. package/dist/translations/pt.js +77 -0
  90. package/dist/translations/pt.js.map +1 -0
  91. package/dist/translations/ru.js +77 -0
  92. package/dist/translations/ru.js.map +1 -0
  93. package/dist/translations/uk.js +77 -0
  94. package/dist/translations/uk.js.map +1 -0
  95. package/dist/translations/zh.js +77 -0
  96. package/dist/translations/zh.js.map +1 -0
  97. package/dist/widgets/AnalyticsRealtimeWidget.js +2 -2
  98. package/dist/widgets/AnalyticsRealtimeWidget.js.map +1 -1
  99. package/dist/widgets/readForWidget.d.ts +2 -1
  100. package/dist/widgets/readForWidget.js +10 -2
  101. package/dist/widgets/readForWidget.js.map +1 -1
  102. package/dist/widgets/readForWidgetBreakdown.d.ts +2 -1
  103. package/dist/widgets/readForWidgetBreakdown.js +7 -2
  104. package/dist/widgets/readForWidgetBreakdown.js.map +1 -1
  105. package/dist/widgets/readForWidgetSeries.d.ts +2 -1
  106. package/dist/widgets/readForWidgetSeries.js +10 -2
  107. package/dist/widgets/readForWidgetSeries.js.map +1 -1
  108. package/dist/widgets/realtimePoll.js +4 -1
  109. package/dist/widgets/realtimePoll.js.map +1 -1
  110. package/dist/widgets/registerWidgets.js +14 -4
  111. package/dist/widgets/registerWidgets.js.map +1 -1
  112. package/package.json +5 -5
@@ -1,5 +1,14 @@
1
1
  import { startOfDayInTz } from "../../timeframe/tz.js";
2
2
  //#region src/native/rollups/deltas.ts
3
+ /**
4
+ * Distinct metrics (visitors, sessions) are exact per bucket and must never be summed
5
+ * across buckets, so an unfiltered read has to hit its own exact family rather than
6
+ * derive from a hostname-scoped one (or vice versa). Every bucket is therefore emitted
7
+ * twice when a hostname is present: once in the hostname-less ('') family that unfiltered
8
+ * reads use, and once more in the exact-hostname family that a hostname-scoped read uses.
9
+ * Both families stay per-bucket exact at the cost of one extra bucket set per distinct
10
+ * hostname a site sees.
11
+ */
3
12
  function computeRollupDeltas(event) {
4
13
  const period = startOfDayInTz(event.timestamp, event.timezone);
5
14
  const inc = {
@@ -8,21 +17,49 @@ function computeRollupDeltas(event) {
8
17
  durationMs: event.durationMs ?? 0,
9
18
  samples: 1
10
19
  };
11
- const make = (path, dimension, dimvalue) => ({
20
+ const make = (bucket, hostname) => ({
12
21
  key: {
13
22
  granularity: "day",
14
23
  period,
15
- path,
16
- dimension,
17
- dimvalue,
24
+ path: bucket[0],
25
+ dimension: bucket[1],
26
+ dimvalue: bucket[2],
27
+ hostname,
18
28
  ...event.scope !== void 0 ? { scope: event.scope } : {}
19
29
  },
20
30
  inc: { ...inc }
21
31
  });
22
- const deltas = [make(event.path, "", ""), make("", "", "")];
23
- if (event.country) deltas.push(make("", "country", event.country));
24
- if (event.device) deltas.push(make("", "device", event.device));
25
- if (event.source) deltas.push(make("", "source", event.source));
32
+ const buckets = [[
33
+ event.path,
34
+ "",
35
+ ""
36
+ ], [
37
+ "",
38
+ "",
39
+ ""
40
+ ]];
41
+ if (event.type === "event" && event.name) buckets.push([
42
+ "",
43
+ "event",
44
+ event.name
45
+ ]);
46
+ if (event.country) buckets.push([
47
+ "",
48
+ "country",
49
+ event.country
50
+ ]);
51
+ if (event.device) buckets.push([
52
+ "",
53
+ "device",
54
+ event.device
55
+ ]);
56
+ if (event.source) buckets.push([
57
+ "",
58
+ "source",
59
+ event.source
60
+ ]);
61
+ const deltas = buckets.map((bucket) => make(bucket, ""));
62
+ if (event.hostname) deltas.push(...buckets.map((bucket) => make(bucket, event.hostname)));
26
63
  return deltas;
27
64
  }
28
65
  //#endregion
@@ -1 +1 @@
1
- {"version":3,"file":"deltas.js","names":[],"sources":["../../../src/native/rollups/deltas.ts"],"sourcesContent":["import { startOfDayInTz } from '../../timeframe/tz'\nimport type { StoredEvent } from '../ingest/normalizeEvent'\n\nexport interface RollupKey {\n\tgranularity: 'day'\n\tperiod: Date\n\tpath: string\n\tdimension: string\n\tdimvalue: string\n\t/** Present only in scoped installs, where it is part of the unique bucket. */\n\tscope?: string\n}\n\nexport type RollupMetric =\n\t| 'pageviews'\n\t| 'events'\n\t| 'durationMs'\n\t| 'samples'\n\t| 'visitors'\n\t| 'sessions'\n\nexport interface RollupDelta {\n\tkey: RollupKey\n\tinc: { pageviews: number; events: number; durationMs: number; samples: number }\n}\n\nexport function computeRollupDeltas(event: StoredEvent): RollupDelta[] {\n\t// Bucket into the event's reporting-timezone day (UTC when unset), fixing the day\n\t// boundary at ingest. Existing rollups are not re-bucketed if the timezone changes.\n\tconst period = startOfDayInTz(event.timestamp, event.timezone)\n\tconst inc = {\n\t\tpageviews: event.type === 'pageview' ? 1 : 0,\n\t\tevents: event.type === 'event' ? 1 : 0,\n\t\tdurationMs: event.durationMs ?? 0,\n\t\tsamples: 1,\n\t}\n\tconst make = (path: string, dimension: string, dimvalue: string): RollupDelta => ({\n\t\tkey: {\n\t\t\tgranularity: 'day',\n\t\t\tperiod,\n\t\t\tpath,\n\t\t\tdimension,\n\t\t\tdimvalue,\n\t\t\t...(event.scope !== undefined ? { scope: event.scope } : {}),\n\t\t},\n\t\tinc: { ...inc },\n\t})\n\tconst deltas: RollupDelta[] = [make(event.path, '', ''), make('', '', '')]\n\tif (event.country) {\n\t\tdeltas.push(make('', 'country', event.country))\n\t}\n\tif (event.device) {\n\t\tdeltas.push(make('', 'device', event.device))\n\t}\n\tif (event.source) {\n\t\tdeltas.push(make('', 'source', event.source))\n\t}\n\treturn deltas\n}\n"],"mappings":";;AA0BA,SAAgB,oBAAoB,OAAmC;CAGtE,MAAM,SAAS,eAAe,MAAM,WAAW,MAAM,QAAQ;CAC7D,MAAM,MAAM;EACX,WAAW,MAAM,SAAS,aAAa,IAAI;EAC3C,QAAQ,MAAM,SAAS,UAAU,IAAI;EACrC,YAAY,MAAM,cAAc;EAChC,SAAS;CACV;CACA,MAAM,QAAQ,MAAc,WAAmB,cAAmC;EACjF,KAAK;GACJ,aAAa;GACb;GACA;GACA;GACA;GACA,GAAI,MAAM,UAAU,KAAA,IAAY,EAAE,OAAO,MAAM,MAAM,IAAI,CAAC;EAC3D;EACA,KAAK,EAAE,GAAG,IAAI;CACf;CACA,MAAM,SAAwB,CAAC,KAAK,MAAM,MAAM,IAAI,EAAE,GAAG,KAAK,IAAI,IAAI,EAAE,CAAC;CACzE,IAAI,MAAM,SACT,OAAO,KAAK,KAAK,IAAI,WAAW,MAAM,OAAO,CAAC;CAE/C,IAAI,MAAM,QACT,OAAO,KAAK,KAAK,IAAI,UAAU,MAAM,MAAM,CAAC;CAE7C,IAAI,MAAM,QACT,OAAO,KAAK,KAAK,IAAI,UAAU,MAAM,MAAM,CAAC;CAE7C,OAAO;AACR"}
1
+ {"version":3,"file":"deltas.js","names":[],"sources":["../../../src/native/rollups/deltas.ts"],"sourcesContent":["import { startOfDayInTz } from '../../timeframe/tz'\nimport type { StoredEvent } from '../ingest/normalizeEvent'\n\nexport interface RollupKey {\n\tgranularity: 'day'\n\tperiod: Date\n\tpath: string\n\tdimension: string\n\tdimvalue: string\n\t/** '' is the hostname-less bucket family; a real hostname is its own family. */\n\thostname: string\n\t/** Present only in scoped installs, where it is part of the unique bucket. */\n\tscope?: string\n}\n\nexport type RollupMetric =\n\t| 'pageviews'\n\t| 'events'\n\t| 'durationMs'\n\t| 'samples'\n\t| 'visitors'\n\t| 'sessions'\n\nexport interface RollupDelta {\n\tkey: RollupKey\n\tinc: { pageviews: number; events: number; durationMs: number; samples: number }\n}\n\n/**\n * Distinct metrics (visitors, sessions) are exact per bucket and must never be summed\n * across buckets, so an unfiltered read has to hit its own exact family rather than\n * derive from a hostname-scoped one (or vice versa). Every bucket is therefore emitted\n * twice when a hostname is present: once in the hostname-less ('') family that unfiltered\n * reads use, and once more in the exact-hostname family that a hostname-scoped read uses.\n * Both families stay per-bucket exact at the cost of one extra bucket set per distinct\n * hostname a site sees.\n */\nexport function computeRollupDeltas(event: StoredEvent): RollupDelta[] {\n\t// Bucket into the event's reporting-timezone day (UTC when unset), fixing the day\n\t// boundary at ingest. Existing rollups are not re-bucketed if the timezone changes.\n\tconst period = startOfDayInTz(event.timestamp, event.timezone)\n\tconst inc = {\n\t\tpageviews: event.type === 'pageview' ? 1 : 0,\n\t\tevents: event.type === 'event' ? 1 : 0,\n\t\tdurationMs: event.durationMs ?? 0,\n\t\tsamples: 1,\n\t}\n\tconst make = (\n\t\tbucket: [path: string, dimension: string, dimvalue: string],\n\t\thostname: string\n\t): RollupDelta => ({\n\t\tkey: {\n\t\t\tgranularity: 'day',\n\t\t\tperiod,\n\t\t\tpath: bucket[0],\n\t\t\tdimension: bucket[1],\n\t\t\tdimvalue: bucket[2],\n\t\t\thostname,\n\t\t\t...(event.scope !== undefined ? { scope: event.scope } : {}),\n\t\t},\n\t\tinc: { ...inc },\n\t})\n\tconst buckets: Array<[path: string, dimension: string, dimvalue: string]> = [\n\t\t[event.path, '', ''],\n\t\t['', '', ''],\n\t]\n\tif (event.type === 'event' && event.name) {\n\t\tbuckets.push(['', 'event', event.name])\n\t}\n\tif (event.country) {\n\t\tbuckets.push(['', 'country', event.country])\n\t}\n\tif (event.device) {\n\t\tbuckets.push(['', 'device', event.device])\n\t}\n\tif (event.source) {\n\t\tbuckets.push(['', 'source', event.source])\n\t}\n\tconst deltas = buckets.map((bucket) => make(bucket, ''))\n\tif (event.hostname) {\n\t\tdeltas.push(...buckets.map((bucket) => make(bucket, event.hostname)))\n\t}\n\treturn deltas\n}\n"],"mappings":";;;;;;;;;;;AAqCA,SAAgB,oBAAoB,OAAmC;CAGtE,MAAM,SAAS,eAAe,MAAM,WAAW,MAAM,QAAQ;CAC7D,MAAM,MAAM;EACX,WAAW,MAAM,SAAS,aAAa,IAAI;EAC3C,QAAQ,MAAM,SAAS,UAAU,IAAI;EACrC,YAAY,MAAM,cAAc;EAChC,SAAS;CACV;CACA,MAAM,QACL,QACA,cACkB;EAClB,KAAK;GACJ,aAAa;GACb;GACA,MAAM,OAAO;GACb,WAAW,OAAO;GAClB,UAAU,OAAO;GACjB;GACA,GAAI,MAAM,UAAU,KAAA,IAAY,EAAE,OAAO,MAAM,MAAM,IAAI,CAAC;EAC3D;EACA,KAAK,EAAE,GAAG,IAAI;CACf;CACA,MAAM,UAAsE,CAC3E;EAAC,MAAM;EAAM;EAAI;CAAE,GACnB;EAAC;EAAI;EAAI;CAAE,CACZ;CACA,IAAI,MAAM,SAAS,WAAW,MAAM,MACnC,QAAQ,KAAK;EAAC;EAAI;EAAS,MAAM;CAAI,CAAC;CAEvC,IAAI,MAAM,SACT,QAAQ,KAAK;EAAC;EAAI;EAAW,MAAM;CAAO,CAAC;CAE5C,IAAI,MAAM,QACT,QAAQ,KAAK;EAAC;EAAI;EAAU,MAAM;CAAM,CAAC;CAE1C,IAAI,MAAM,QACT,QAAQ,KAAK;EAAC;EAAI;EAAU,MAAM;CAAM,CAAC;CAE1C,MAAM,SAAS,QAAQ,KAAK,WAAW,KAAK,QAAQ,EAAE,CAAC;CACvD,IAAI,MAAM,UACT,OAAO,KAAK,GAAG,QAAQ,KAAK,WAAW,KAAK,QAAQ,MAAM,QAAQ,CAAC,CAAC;CAErE,OAAO;AACR"}
@@ -5,7 +5,9 @@
5
5
  * pulling server code into the bundle.
6
6
  */
7
7
  const DOCUMENT_PATH = "/analytics/document";
8
+ const SOURCES_PATH = "/analytics/sources";
9
+ const REALTIME_PATH = "/analytics/realtime";
8
10
  //#endregion
9
- export { DOCUMENT_PATH };
11
+ export { DOCUMENT_PATH, REALTIME_PATH, SOURCES_PATH };
10
12
 
11
13
  //# sourceMappingURL=paths.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"paths.js","names":[],"sources":["../../src/plugin/paths.ts"],"sourcesContent":["/**\n * Endpoint paths shared between server registration and client fetchers. Kept in a\n * dependency-free leaf module so client components can import the path without\n * pulling server code into the bundle.\n */\nexport const DOCUMENT_PATH = '/analytics/document'\n"],"mappings":";;;;;;AAKA,MAAa,gBAAgB"}
1
+ {"version":3,"file":"paths.js","names":[],"sources":["../../src/plugin/paths.ts"],"sourcesContent":["/**\n * Endpoint paths shared between server registration and client fetchers. Kept in a\n * dependency-free leaf module so client components can import the path without\n * pulling server code into the bundle.\n */\nexport const DOCUMENT_PATH = '/analytics/document'\nexport const SOURCES_PATH = '/analytics/sources'\nexport const REALTIME_PATH = '/analytics/realtime'\n"],"mappings":";;;;;;AAKA,MAAa,gBAAgB;AAC7B,MAAa,eAAe;AAC5B,MAAa,gBAAgB"}
@@ -1,3 +1,4 @@
1
+ import "./paths.js";
1
2
  import { readForWidgetRealtime } from "../widgets/readForWidgetRealtime.js";
2
3
  //#region src/plugin/realtimeEndpoint.ts
3
4
  const ALLOWED_METRICS = ["visitors", "pageviews"];
@@ -8,7 +9,6 @@ const ALLOWED_WINDOWS = [
8
9
  60
9
10
  ];
10
11
  const DEFAULT_WINDOW = 30;
11
- const REALTIME_PATH = "/analytics/realtime";
12
12
  /**
13
13
  * Authenticated GET handler for the realtime widget poller. Reads + clamps the query
14
14
  * params, then delegates to readForWidgetRealtime. Returns 401 for an anonymous request.
@@ -31,6 +31,6 @@ const makeRealtimeHandler = () => async (req) => {
31
31
  return Response.json(result);
32
32
  };
33
33
  //#endregion
34
- export { REALTIME_PATH, makeRealtimeHandler };
34
+ export { makeRealtimeHandler };
35
35
 
36
36
  //# sourceMappingURL=realtimeEndpoint.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"realtimeEndpoint.js","names":[],"sources":["../../src/plugin/realtimeEndpoint.ts"],"sourcesContent":["import type { PayloadHandler } from 'payload'\nimport type { MetricKey } from '../core/contract'\nimport { readForWidgetRealtime } from '../widgets/readForWidgetRealtime'\n\nconst ALLOWED_METRICS: MetricKey[] = ['visitors', 'pageviews']\nconst ALLOWED_WINDOWS = [5, 15, 30, 60]\nconst DEFAULT_WINDOW = 30\n\nexport const REALTIME_PATH = '/analytics/realtime'\n\n/**\n * Authenticated GET handler for the realtime widget poller. Reads + clamps the query\n * params, then delegates to readForWidgetRealtime. Returns 401 for an anonymous request.\n * The gate is any authenticated user (not admin-panel access specifically); the response\n * is integer counts only. Tightening to admin-only is a post-v1 option.\n */\nexport const makeRealtimeHandler = (): PayloadHandler => async (req) => {\n\tif (!req.user) {\n\t\treturn Response.json({ error: 'unauthorized' }, { status: 401 })\n\t}\n\tconst params = new URL(req.url ?? '', 'http://localhost').searchParams\n\tconst rawMetric = params.get('metric')\n\tconst metric: MetricKey = ALLOWED_METRICS.includes(rawMetric as MetricKey)\n\t\t? (rawMetric as MetricKey)\n\t\t: 'visitors'\n\tconst rawWindow = Number(params.get('windowMinutes'))\n\tconst windowMinutes = ALLOWED_WINDOWS.includes(rawWindow) ? rawWindow : DEFAULT_WINDOW\n\tconst dataSource = params.get('dataSource') ?? undefined\n\tconst result = await readForWidgetRealtime({\n\t\treq,\n\t\tmetric,\n\t\twindowMinutes,\n\t\tadapterId: dataSource,\n\t\tnow: new Date(),\n\t})\n\treturn Response.json(result)\n}\n"],"mappings":";;AAIA,MAAM,kBAA+B,CAAC,YAAY,WAAW;AAC7D,MAAM,kBAAkB;CAAC;CAAG;CAAI;CAAI;AAAE;AACtC,MAAM,iBAAiB;AAEvB,MAAa,gBAAgB;;;;;;;AAQ7B,MAAa,4BAA4C,OAAO,QAAQ;CACvE,IAAI,CAAC,IAAI,MACR,OAAO,SAAS,KAAK,EAAE,OAAO,eAAe,GAAG,EAAE,QAAQ,IAAI,CAAC;CAEhE,MAAM,SAAS,IAAI,IAAI,IAAI,OAAO,IAAI,kBAAkB,EAAE;CAC1D,MAAM,YAAY,OAAO,IAAI,QAAQ;CACrC,MAAM,SAAoB,gBAAgB,SAAS,SAAsB,IACrE,YACD;CACH,MAAM,YAAY,OAAO,OAAO,IAAI,eAAe,CAAC;CAGpD,MAAM,SAAS,MAAM,sBAAsB;EAC1C;EACA;EACA,eALqB,gBAAgB,SAAS,SAAS,IAAI,YAAY;EAMvE,WALkB,OAAO,IAAI,YAAY,KAAK,KAAA;EAM9C,qBAAK,IAAI,KAAK;CACf,CAAC;CACD,OAAO,SAAS,KAAK,MAAM;AAC5B"}
1
+ {"version":3,"file":"realtimeEndpoint.js","names":[],"sources":["../../src/plugin/realtimeEndpoint.ts"],"sourcesContent":["import type { PayloadHandler } from 'payload'\nimport type { MetricKey } from '../core/contract'\nimport { readForWidgetRealtime } from '../widgets/readForWidgetRealtime'\nimport { REALTIME_PATH } from './paths'\n\nexport { REALTIME_PATH }\n\nconst ALLOWED_METRICS: MetricKey[] = ['visitors', 'pageviews']\nconst ALLOWED_WINDOWS = [5, 15, 30, 60]\nconst DEFAULT_WINDOW = 30\n\n/**\n * Authenticated GET handler for the realtime widget poller. Reads + clamps the query\n * params, then delegates to readForWidgetRealtime. Returns 401 for an anonymous request.\n * The gate is any authenticated user (not admin-panel access specifically); the response\n * is integer counts only. Tightening to admin-only is a post-v1 option.\n */\nexport const makeRealtimeHandler = (): PayloadHandler => async (req) => {\n\tif (!req.user) {\n\t\treturn Response.json({ error: 'unauthorized' }, { status: 401 })\n\t}\n\tconst params = new URL(req.url ?? '', 'http://localhost').searchParams\n\tconst rawMetric = params.get('metric')\n\tconst metric: MetricKey = ALLOWED_METRICS.includes(rawMetric as MetricKey)\n\t\t? (rawMetric as MetricKey)\n\t\t: 'visitors'\n\tconst rawWindow = Number(params.get('windowMinutes'))\n\tconst windowMinutes = ALLOWED_WINDOWS.includes(rawWindow) ? rawWindow : DEFAULT_WINDOW\n\tconst dataSource = params.get('dataSource') ?? undefined\n\tconst result = await readForWidgetRealtime({\n\t\treq,\n\t\tmetric,\n\t\twindowMinutes,\n\t\tadapterId: dataSource,\n\t\tnow: new Date(),\n\t})\n\treturn Response.json(result)\n}\n"],"mappings":";;;AAOA,MAAM,kBAA+B,CAAC,YAAY,WAAW;AAC7D,MAAM,kBAAkB;CAAC;CAAG;CAAI;CAAI;AAAE;AACtC,MAAM,iBAAiB;;;;;;;AAQvB,MAAa,4BAA4C,OAAO,QAAQ;CACvE,IAAI,CAAC,IAAI,MACR,OAAO,SAAS,KAAK,EAAE,OAAO,eAAe,GAAG,EAAE,QAAQ,IAAI,CAAC;CAEhE,MAAM,SAAS,IAAI,IAAI,IAAI,OAAO,IAAI,kBAAkB,EAAE;CAC1D,MAAM,YAAY,OAAO,IAAI,QAAQ;CACrC,MAAM,SAAoB,gBAAgB,SAAS,SAAsB,IACrE,YACD;CACH,MAAM,YAAY,OAAO,OAAO,IAAI,eAAe,CAAC;CAGpD,MAAM,SAAS,MAAM,sBAAsB;EAC1C;EACA;EACA,eALqB,gBAAgB,SAAS,SAAS,IAAI,YAAY;EAMvE,WALkB,OAAO,IAAI,YAAY,KAAK,KAAA;EAM9C,qBAAK,IAAI,KAAK;CACf,CAAC;CACD,OAAO,SAAS,KAAK,MAAM;AAC5B"}
@@ -1 +1 @@
1
- {"version":3,"file":"runtime.js","names":[],"sources":["../../src/plugin/runtime.ts"],"sourcesContent":["import type { Payload, PayloadRequest } from 'payload'\nimport type { ResolvedBinding } from '../binding/types'\nimport type { AdapterRegistry, RegistryResolver, ResolveRegistryArgs } from '../core/registry'\nimport type { Engine } from '../surfacing/engine'\nimport { DEFAULT_TIMEZONE } from '../timeframe/tz'\n\nexport interface AnalyticsRuntime {\n\tregistry: AdapterRegistry\n\t/** Per-scope adapter resolution; absent runtimes fall back to the static registry. */\n\tresolveRegistry?: RegistryResolver\n\t/** The plugin's scopeResolver bound at init; absent runtimes resolve null. */\n\tresolveScope?: (req: PayloadRequest) => Promise<string | null>\n\t/** The plugin's reportingTimezone bound at init; absent runtimes resolve 'UTC'. */\n\tresolveTimezone?: (req: PayloadRequest, scope?: string | null) => Promise<string>\n\t/** Id of the config adapter shared by every scope, when one is designated. */\n\tplatformAdapterId?: string\n\t/** Gate for cross-scope reads; absent runtimes require an authenticated user. */\n\tplatformRead?: (args: { req: PayloadRequest }) => boolean | Promise<boolean>\n\tbindings: Record<string, ResolvedBinding>\n\tengine: Engine\n\t/** Explicit TTL overrides; when a value is unset the adapter's recommendedTtl applies. */\n\tttl: { aggregate?: number; realtime?: number }\n\t/** Widget period-over-period comparison; false skips the previous-window read. */\n\tcomparison: boolean\n}\n\n/**\n * Stored on the Payload instance (not a module global) so the runtime survives the\n * separate `.` and `/rsc` bundles a consumer loads: a server-component bundle that\n * imported its own copy of a module-level map would never see what the plugin wrote.\n * `Symbol.for` keys into the cross-realm global symbol registry, so both bundles\n * resolve the same key on the same `payload` object.\n */\nconst RUNTIME_KEY = Symbol.for('@10x-media/analytics/runtime')\n\ntype RuntimeHost = { [RUNTIME_KEY]?: AnalyticsRuntime }\n\nexport const setRuntime = (payload: Payload, runtime: AnalyticsRuntime): void => {\n\t;(payload as unknown as RuntimeHost)[RUNTIME_KEY] = runtime\n}\n\nexport const getRuntime = (payload: Payload): AnalyticsRuntime | undefined =>\n\t(payload as unknown as RuntimeHost)[RUNTIME_KEY]\n\nexport const resolveScopeFor = (\n\truntime: AnalyticsRuntime,\n\treq: PayloadRequest\n): Promise<string | null> => runtime.resolveScope?.(req) ?? Promise.resolve(null)\n\nexport const resolveTimezoneFor = (\n\truntime: AnalyticsRuntime,\n\treq: PayloadRequest,\n\tscope?: string | null\n): Promise<string> => runtime.resolveTimezone?.(req, scope) ?? Promise.resolve(DEFAULT_TIMEZONE)\n\nexport const resolveRegistryFor = (\n\truntime: AnalyticsRuntime,\n\targs: ResolveRegistryArgs\n): Promise<AdapterRegistry> => runtime.resolveRegistry?.(args) ?? Promise.resolve(runtime.registry)\n\nexport const platformReadFor = async (\n\truntime: AnalyticsRuntime,\n\treq: PayloadRequest\n): Promise<boolean> =>\n\truntime.platformRead ? await runtime.platformRead({ req }) : Boolean(req.user)\n"],"mappings":";;;;;;;;AAiCA,MAAM,cAAc,OAAO,IAAI,8BAA8B;AAI7D,MAAa,cAAc,SAAkB,YAAoC;CAC/E,QAAoC,eAAe;AACrD;AAEA,MAAa,cAAc,YACzB,QAAmC;AAErC,MAAa,mBACZ,SACA,QAC4B,QAAQ,eAAe,GAAG,KAAK,QAAQ,QAAQ,IAAI;AAEhF,MAAa,sBACZ,SACA,KACA,UACqB,QAAQ,kBAAkB,KAAK,KAAK,KAAK,QAAQ,QAAA,KAAwB;AAE/F,MAAa,sBACZ,SACA,SAC8B,QAAQ,kBAAkB,IAAI,KAAK,QAAQ,QAAQ,QAAQ,QAAQ;AAElG,MAAa,kBAAkB,OAC9B,SACA,QAEA,QAAQ,eAAe,MAAM,QAAQ,aAAa,EAAE,IAAI,CAAC,IAAI,QAAQ,IAAI,IAAI"}
1
+ {"version":3,"file":"runtime.js","names":[],"sources":["../../src/plugin/runtime.ts"],"sourcesContent":["import type { Payload, PayloadRequest } from 'payload'\nimport type { ResolvedBinding } from '../binding/types'\nimport type { AdapterRegistry, RegistryResolver, ResolveRegistryArgs } from '../core/registry'\nimport type { Engine } from '../surfacing/engine'\nimport { DEFAULT_TIMEZONE } from '../timeframe/tz'\n\nexport interface AnalyticsRuntime {\n\tregistry: AdapterRegistry\n\t/** Per-scope adapter resolution; absent runtimes fall back to the static registry. */\n\tresolveRegistry?: RegistryResolver\n\t/** The plugin's scopeResolver bound at init; absent runtimes resolve null. */\n\tresolveScope?: (req: PayloadRequest) => Promise<string | null>\n\t/** The plugin's reportingTimezone bound at init; absent runtimes resolve 'UTC'. */\n\tresolveTimezone?: (req: PayloadRequest, scope?: string | null) => Promise<string>\n\t/** Id of the config adapter shared by every scope, when one is designated. */\n\tplatformAdapterId?: string\n\t/**\n\t * Ids of the config-time adapters shared by every scope (the ones passed to\n\t * `adapters` in plugin options). Runtime provider adapters (resolved per scope\n\t * from the providers collection or `providers.resolve`) are never in it.\n\t */\n\tconfigAdapterIds: ReadonlySet<string>\n\t/** Gate for cross-scope reads; absent runtimes require an authenticated user. */\n\tplatformRead?: (args: { req: PayloadRequest }) => boolean | Promise<boolean>\n\tbindings: Record<string, ResolvedBinding>\n\tengine: Engine\n\t/** Explicit TTL overrides; when a value is unset the adapter's recommendedTtl applies. */\n\tttl: { aggregate?: number; realtime?: number }\n\t/** Widget period-over-period comparison; false skips the previous-window read. */\n\tcomparison: boolean\n}\n\n/**\n * Stored on the Payload instance (not a module global) so the runtime survives the\n * separate `.` and `/rsc` bundles a consumer loads: a server-component bundle that\n * imported its own copy of a module-level map would never see what the plugin wrote.\n * `Symbol.for` keys into the cross-realm global symbol registry, so both bundles\n * resolve the same key on the same `payload` object.\n */\nconst RUNTIME_KEY = Symbol.for('@10x-media/analytics/runtime')\n\ntype RuntimeHost = { [RUNTIME_KEY]?: AnalyticsRuntime }\n\nexport const setRuntime = (payload: Payload, runtime: AnalyticsRuntime): void => {\n\t;(payload as unknown as RuntimeHost)[RUNTIME_KEY] = runtime\n}\n\nexport const getRuntime = (payload: Payload): AnalyticsRuntime | undefined =>\n\t(payload as unknown as RuntimeHost)[RUNTIME_KEY]\n\nexport const resolveScopeFor = (\n\truntime: AnalyticsRuntime,\n\treq: PayloadRequest\n): Promise<string | null> => runtime.resolveScope?.(req) ?? Promise.resolve(null)\n\nexport const resolveTimezoneFor = (\n\truntime: AnalyticsRuntime,\n\treq: PayloadRequest,\n\tscope?: string | null\n): Promise<string> => runtime.resolveTimezone?.(req, scope) ?? Promise.resolve(DEFAULT_TIMEZONE)\n\nexport const resolveRegistryFor = (\n\truntime: AnalyticsRuntime,\n\targs: ResolveRegistryArgs\n): Promise<AdapterRegistry> => runtime.resolveRegistry?.(args) ?? Promise.resolve(runtime.registry)\n\nexport const platformReadFor = async (\n\truntime: AnalyticsRuntime,\n\treq: PayloadRequest\n): Promise<boolean> =>\n\truntime.platformRead ? await runtime.platformRead({ req }) : Boolean(req.user)\n"],"mappings":";;;;;;;;AAuCA,MAAM,cAAc,OAAO,IAAI,8BAA8B;AAI7D,MAAa,cAAc,SAAkB,YAAoC;CAC/E,QAAoC,eAAe;AACrD;AAEA,MAAa,cAAc,YACzB,QAAmC;AAErC,MAAa,mBACZ,SACA,QAC4B,QAAQ,eAAe,GAAG,KAAK,QAAQ,QAAQ,IAAI;AAEhF,MAAa,sBACZ,SACA,KACA,UACqB,QAAQ,kBAAkB,KAAK,KAAK,KAAK,QAAQ,QAAA,KAAwB;AAE/F,MAAa,sBACZ,SACA,SAC8B,QAAQ,kBAAkB,IAAI,KAAK,QAAQ,QAAQ,QAAQ,QAAQ;AAElG,MAAa,kBAAkB,OAC9B,SACA,QAEA,QAAQ,eAAe,MAAM,QAAQ,aAAa,EAAE,IAAI,CAAC,IAAI,QAAQ,IAAI,IAAI"}
@@ -0,0 +1,53 @@
1
+ import { serializeCapabilities } from "../core/capabilities.js";
2
+ import { getRuntime, resolveRegistryFor, resolveScopeFor } from "./runtime.js";
3
+ import "./paths.js";
4
+ //#region src/plugin/sourcesEndpoint.ts
5
+ /**
6
+ * Authenticated GET listing the adapters visible to the requesting scope, with
7
+ * serialized capabilities for client-side pickers. Always answers for the
8
+ * caller's own resolved scope; there is deliberately no scope parameter, so a
9
+ * tenant can never enumerate another tenant's sources. Resolution failures
10
+ * degrade to the static config registry the same way reads do.
11
+ */
12
+ const makeSourcesHandler = () => async (req) => {
13
+ if (!req.user) return Response.json({ error: "unauthorized" }, { status: 401 });
14
+ const runtime = getRuntime(req.payload);
15
+ if (!runtime) return Response.json({
16
+ defaultId: null,
17
+ sources: []
18
+ });
19
+ try {
20
+ const scope = await resolveScopeFor(runtime, req);
21
+ const registry = await resolveRegistryFor(runtime, {
22
+ payload: req.payload,
23
+ req,
24
+ scope
25
+ });
26
+ const sources = registry.all().map((a) => ({
27
+ id: a.id,
28
+ label: a.label,
29
+ kind: runtime.configAdapterIds.has(a.id) ? "config" : "runtime",
30
+ capabilities: serializeCapabilities(a.capabilities)
31
+ }));
32
+ return Response.json({
33
+ defaultId: registry.default().id,
34
+ sources
35
+ });
36
+ } catch (err) {
37
+ req.payload.logger?.warn(`analytics: sources listing failed: ${String(err)}`);
38
+ const sources = runtime.registry.all().map((a) => ({
39
+ id: a.id,
40
+ label: a.label,
41
+ kind: "config",
42
+ capabilities: serializeCapabilities(a.capabilities)
43
+ }));
44
+ return Response.json({
45
+ defaultId: runtime.registry.default().id,
46
+ sources
47
+ });
48
+ }
49
+ };
50
+ //#endregion
51
+ export { makeSourcesHandler };
52
+
53
+ //# sourceMappingURL=sourcesEndpoint.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sourcesEndpoint.js","names":[],"sources":["../../src/plugin/sourcesEndpoint.ts"],"sourcesContent":["import type { PayloadHandler } from 'payload'\nimport { serializeCapabilities } from '../core/capabilities'\nimport { SOURCES_PATH } from './paths'\nimport { getRuntime, resolveRegistryFor, resolveScopeFor } from './runtime'\n\nexport { SOURCES_PATH }\n\n/**\n * Authenticated GET listing the adapters visible to the requesting scope, with\n * serialized capabilities for client-side pickers. Always answers for the\n * caller's own resolved scope; there is deliberately no scope parameter, so a\n * tenant can never enumerate another tenant's sources. Resolution failures\n * degrade to the static config registry the same way reads do.\n */\nexport const makeSourcesHandler = (): PayloadHandler => async (req) => {\n\tif (!req.user) {\n\t\treturn Response.json({ error: 'unauthorized' }, { status: 401 })\n\t}\n\tconst runtime = getRuntime(req.payload)\n\tif (!runtime) {\n\t\treturn Response.json({ defaultId: null, sources: [] })\n\t}\n\ttry {\n\t\tconst scope = await resolveScopeFor(runtime, req)\n\t\tconst registry = await resolveRegistryFor(runtime, { payload: req.payload, req, scope })\n\t\tconst sources = registry.all().map((a) => ({\n\t\t\tid: a.id,\n\t\t\tlabel: a.label,\n\t\t\tkind: runtime.configAdapterIds.has(a.id) ? ('config' as const) : ('runtime' as const),\n\t\t\tcapabilities: serializeCapabilities(a.capabilities),\n\t\t}))\n\t\treturn Response.json({ defaultId: registry.default().id, sources })\n\t} catch (err) {\n\t\treq.payload.logger?.warn(`analytics: sources listing failed: ${String(err)}`)\n\t\tconst sources = runtime.registry.all().map((a) => ({\n\t\t\tid: a.id,\n\t\t\tlabel: a.label,\n\t\t\tkind: 'config' as const,\n\t\t\tcapabilities: serializeCapabilities(a.capabilities),\n\t\t}))\n\t\treturn Response.json({ defaultId: runtime.registry.default().id, sources })\n\t}\n}\n"],"mappings":";;;;;;;;;;;AAcA,MAAa,2BAA2C,OAAO,QAAQ;CACtE,IAAI,CAAC,IAAI,MACR,OAAO,SAAS,KAAK,EAAE,OAAO,eAAe,GAAG,EAAE,QAAQ,IAAI,CAAC;CAEhE,MAAM,UAAU,WAAW,IAAI,OAAO;CACtC,IAAI,CAAC,SACJ,OAAO,SAAS,KAAK;EAAE,WAAW;EAAM,SAAS,CAAC;CAAE,CAAC;CAEtD,IAAI;EACH,MAAM,QAAQ,MAAM,gBAAgB,SAAS,GAAG;EAChD,MAAM,WAAW,MAAM,mBAAmB,SAAS;GAAE,SAAS,IAAI;GAAS;GAAK;EAAM,CAAC;EACvF,MAAM,UAAU,SAAS,IAAI,EAAE,KAAK,OAAO;GAC1C,IAAI,EAAE;GACN,OAAO,EAAE;GACT,MAAM,QAAQ,iBAAiB,IAAI,EAAE,EAAE,IAAK,WAAsB;GAClE,cAAc,sBAAsB,EAAE,YAAY;EACnD,EAAE;EACF,OAAO,SAAS,KAAK;GAAE,WAAW,SAAS,QAAQ,EAAE;GAAI;EAAQ,CAAC;CACnE,SAAS,KAAK;EACb,IAAI,QAAQ,QAAQ,KAAK,sCAAsC,OAAO,GAAG,GAAG;EAC5E,MAAM,UAAU,QAAQ,SAAS,IAAI,EAAE,KAAK,OAAO;GAClD,IAAI,EAAE;GACN,OAAO,EAAE;GACT,MAAM;GACN,cAAc,sBAAsB,EAAE,YAAY;EACnD,EAAE;EACF,OAAO,SAAS,KAAK;GAAE,WAAW,QAAQ,SAAS,QAAQ,EAAE;GAAI;EAAQ,CAAC;CAC3E;AACD"}
@@ -1,7 +1,8 @@
1
1
  //#region src/providers/access.ts
2
2
  const resolveOrNull = async (args, req) => {
3
3
  try {
4
- return await args.resolveScope(req);
4
+ const scope = await args.resolveScope(req);
5
+ return scope === "" ? null : scope;
5
6
  } catch {
6
7
  return null;
7
8
  }
@@ -1 +1 @@
1
- {"version":3,"file":"access.js","names":[],"sources":["../../src/providers/access.ts"],"sourcesContent":["import type { Access, PayloadRequest } from 'payload'\nimport type { PlatformReadAccess } from '../core/options'\n\nexport interface ProviderAccessArgs {\n\t/** True when the install configured a scopeResolver. */\n\tscoped: boolean\n\tscopeField: string\n\tresolveScope: (req: PayloadRequest) => Promise<string | null>\n\tplatformRead: PlatformReadAccess\n}\n\nconst resolveOrNull = async (\n\targs: ProviderAccessArgs,\n\treq: PayloadRequest\n): Promise<string | null> => {\n\ttry {\n\t\treturn await args.resolveScope(req)\n\t} catch {\n\t\treturn null\n\t}\n}\n\n/**\n * Row access (read/update/delete) for the provider collection. Unscoped\n * installs keep the historical any-authenticated-user behavior. Scoped\n * installs constrain every row operation to the request's resolved scope via\n * a where clause (so list views filter instead of erroring); the platformRead\n * gate lifts the constraint for platform admins. A null or unresolvable scope\n * fails closed.\n */\nexport const providerRowAccess = (args: ProviderAccessArgs): Access => {\n\treturn async ({ req }) => {\n\t\tif (!req.user) return false\n\t\tif (!args.scoped) return true\n\t\tif (await args.platformRead({ req })) return true\n\t\tconst scope = await resolveOrNull(args, req)\n\t\tif (scope === null) return false\n\t\treturn { [args.scopeField]: { equals: scope } }\n\t}\n}\n\n/**\n * Create access: any authenticated user in unscoped installs; in scoped\n * installs the requester needs a resolved scope (the stamp hook writes it) or\n * the platform grant (install-wide providers have no scope to resolve).\n */\nexport const providerCreateAccess = (args: ProviderAccessArgs): Access => {\n\treturn async ({ req }) => {\n\t\tif (!req.user) return false\n\t\tif (!args.scoped) return true\n\t\tif (await args.platformRead({ req })) return true\n\t\treturn (await resolveOrNull(args, req)) !== null\n\t}\n}\n"],"mappings":";AAWA,MAAM,gBAAgB,OACrB,MACA,QAC4B;CAC5B,IAAI;EACH,OAAO,MAAM,KAAK,aAAa,GAAG;CACnC,QAAQ;EACP,OAAO;CACR;AACD;;;;;;;;;AAUA,MAAa,qBAAqB,SAAqC;CACtE,OAAO,OAAO,EAAE,UAAU;EACzB,IAAI,CAAC,IAAI,MAAM,OAAO;EACtB,IAAI,CAAC,KAAK,QAAQ,OAAO;EACzB,IAAI,MAAM,KAAK,aAAa,EAAE,IAAI,CAAC,GAAG,OAAO;EAC7C,MAAM,QAAQ,MAAM,cAAc,MAAM,GAAG;EAC3C,IAAI,UAAU,MAAM,OAAO;EAC3B,OAAO,GAAG,KAAK,aAAa,EAAE,QAAQ,MAAM,EAAE;CAC/C;AACD;;;;;;AAOA,MAAa,wBAAwB,SAAqC;CACzE,OAAO,OAAO,EAAE,UAAU;EACzB,IAAI,CAAC,IAAI,MAAM,OAAO;EACtB,IAAI,CAAC,KAAK,QAAQ,OAAO;EACzB,IAAI,MAAM,KAAK,aAAa,EAAE,IAAI,CAAC,GAAG,OAAO;EAC7C,OAAQ,MAAM,cAAc,MAAM,GAAG,MAAO;CAC7C;AACD"}
1
+ {"version":3,"file":"access.js","names":[],"sources":["../../src/providers/access.ts"],"sourcesContent":["import type { Access, PayloadRequest } from 'payload'\nimport type { PlatformReadAccess } from '../core/options'\n\nexport interface ProviderAccessArgs {\n\t/** True when the install configured a scopeResolver. */\n\tscoped: boolean\n\tscopeField: string\n\tresolveScope: (req: PayloadRequest) => Promise<string | null>\n\tplatformRead: PlatformReadAccess\n}\n\nconst resolveOrNull = async (\n\targs: ProviderAccessArgs,\n\treq: PayloadRequest\n): Promise<string | null> => {\n\ttry {\n\t\tconst scope = await args.resolveScope(req)\n\t\treturn scope === '' ? null : scope\n\t} catch {\n\t\treturn null\n\t}\n}\n\n/**\n * Row access (read/update/delete) for the provider collection. Unscoped\n * installs keep the historical any-authenticated-user behavior. Scoped\n * installs constrain every row operation to the request's resolved scope via\n * a where clause (so list views filter instead of erroring); the platformRead\n * gate lifts the constraint for platform admins. A null or unresolvable scope\n * fails closed.\n */\nexport const providerRowAccess = (args: ProviderAccessArgs): Access => {\n\treturn async ({ req }) => {\n\t\tif (!req.user) return false\n\t\tif (!args.scoped) return true\n\t\tif (await args.platformRead({ req })) return true\n\t\tconst scope = await resolveOrNull(args, req)\n\t\tif (scope === null) return false\n\t\treturn { [args.scopeField]: { equals: scope } }\n\t}\n}\n\n/**\n * Create access: any authenticated user in unscoped installs; in scoped\n * installs the requester needs a resolved scope (the stamp hook writes it) or\n * the platform grant (install-wide providers have no scope to resolve).\n */\nexport const providerCreateAccess = (args: ProviderAccessArgs): Access => {\n\treturn async ({ req }) => {\n\t\tif (!req.user) return false\n\t\tif (!args.scoped) return true\n\t\tif (await args.platformRead({ req })) return true\n\t\treturn (await resolveOrNull(args, req)) !== null\n\t}\n}\n"],"mappings":";AAWA,MAAM,gBAAgB,OACrB,MACA,QAC4B;CAC5B,IAAI;EACH,MAAM,QAAQ,MAAM,KAAK,aAAa,GAAG;EACzC,OAAO,UAAU,KAAK,OAAO;CAC9B,QAAQ;EACP,OAAO;CACR;AACD;;;;;;;;;AAUA,MAAa,qBAAqB,SAAqC;CACtE,OAAO,OAAO,EAAE,UAAU;EACzB,IAAI,CAAC,IAAI,MAAM,OAAO;EACtB,IAAI,CAAC,KAAK,QAAQ,OAAO;EACzB,IAAI,MAAM,KAAK,aAAa,EAAE,IAAI,CAAC,GAAG,OAAO;EAC7C,MAAM,QAAQ,MAAM,cAAc,MAAM,GAAG;EAC3C,IAAI,UAAU,MAAM,OAAO;EAC3B,OAAO,GAAG,KAAK,aAAa,EAAE,QAAQ,MAAM,EAAE;CAC/C;AACD;;;;;;AAOA,MAAa,wBAAwB,SAAqC;CACzE,OAAO,OAAO,EAAE,UAAU;EACzB,IAAI,CAAC,IAAI,MAAM,OAAO;EACtB,IAAI,CAAC,KAAK,QAAQ,OAAO;EACzB,IAAI,MAAM,KAAK,aAAa,EAAE,IAAI,CAAC,GAAG,OAAO;EAC7C,OAAQ,MAAM,cAAc,MAAM,GAAG,MAAO;CAC7C;AACD"}
@@ -42,6 +42,7 @@ const buildProvidersCollection = (args) => {
42
42
  singular: labelForKey(keys.providersCollectionSingular),
43
43
  plural: labelForKey(keys.providersCollectionPlural)
44
44
  },
45
+ disableDuplicate: true,
45
46
  admin: {
46
47
  useAsTitle: "name",
47
48
  defaultColumns: [
@@ -1 +1 @@
1
- {"version":3,"file":"collection.js","names":[],"sources":["../../src/providers/collection.ts"],"sourcesContent":["import type { CollectionConfig, Field, TextareaField, TextField } from 'payload'\nimport { keys, type TranslationKey } from '../translations/keys'\nimport { labelForKey } from '../translations/server'\nimport type { ProviderAccessArgs } from './access'\nimport { providerCreateAccess, providerRowAccess } from './access'\nimport type { ProviderId } from './factory'\nimport { stampScope } from './stampScope'\n\nexport const PROVIDERS_SLUG = 'analytics-providers'\n\n/** Builds the sealed variant of a secret source field; injected so the fields peer stays lazy. */\nexport type BuildSecretField = (source: TextField | TextareaField) => Field[]\n\nexport interface BuildProvidersCollectionArgs extends ProviderAccessArgs {\n\tslug: string\n\taccess?: Partial<CollectionConfig['access']>\n\toverrides?: (collection: CollectionConfig) => CollectionConfig\n\t/** Called after any change or delete so the per-scope registry cache drops stale adapters. */\n\tonChange: () => void\n\tbuildSecret: BuildSecretField\n}\n\nconst textField = (name: string, label: TranslationKey, width?: string): Field => ({\n\tname,\n\ttype: 'text',\n\tlabel: labelForKey(label),\n\t...(width ? { admin: { width } } : {}),\n})\n\nconst secretField = (\n\targs: BuildProvidersCollectionArgs,\n\topts: { name: string; label: TranslationKey; width?: string }\n): Field[] =>\n\targs.buildSecret({\n\t\tname: opts.name,\n\t\ttype: 'text',\n\t\tlabel: labelForKey(opts.label),\n\t\t...(opts.width ? { admin: { width: opts.width } } : {}),\n\t})\n\nconst hostField = (): Field => ({\n\tname: 'host',\n\ttype: 'text',\n\tlabel: labelForKey(keys.providerFieldHost),\n\tadmin: { description: labelForKey(keys.providerFieldHostHelp) },\n})\n\nconst providerGroup = (provider: ProviderId, label: TranslationKey, fields: Field[]): Field => ({\n\tname: provider,\n\ttype: 'group',\n\tlabel: labelForKey(label),\n\tadmin: { condition: (data) => data?.provider === provider },\n\tfields,\n})\n\n/**\n * The runtime provider-settings collection: one document per provider (and per scope\n * in scoped installs). Admin-only by default; `access` entries override individual\n * operations and `overrides` reshapes the whole config last, so slugs, labels,\n * fields, and access all stay overridable.\n */\nexport const buildProvidersCollection = (args: BuildProvidersCollectionArgs): CollectionConfig => {\n\tconst collection: CollectionConfig = {\n\t\tslug: args.slug,\n\t\tlabels: {\n\t\t\tsingular: labelForKey(keys.providersCollectionSingular),\n\t\t\tplural: labelForKey(keys.providersCollectionPlural),\n\t\t},\n\t\tadmin: {\n\t\t\tuseAsTitle: 'name',\n\t\t\tdefaultColumns: ['name', 'provider', 'enabled'],\n\t\t\tgroup: 'Analytics',\n\t\t},\n\t\taccess: {\n\t\t\tread: providerRowAccess(args),\n\t\t\tcreate: providerCreateAccess(args),\n\t\t\tupdate: providerRowAccess(args),\n\t\t\tdelete: providerRowAccess(args),\n\t\t\t...args.access,\n\t\t},\n\t\thooks: {\n\t\t\tbeforeChange: [stampScope(args)],\n\t\t\tafterChange: [\n\t\t\t\t({ doc }) => {\n\t\t\t\t\targs.onChange()\n\t\t\t\t\treturn doc\n\t\t\t\t},\n\t\t\t],\n\t\t\tafterDelete: [\n\t\t\t\t({ doc }) => {\n\t\t\t\t\targs.onChange()\n\t\t\t\t\treturn doc\n\t\t\t\t},\n\t\t\t],\n\t\t},\n\t\tfields: [\n\t\t\t{\n\t\t\t\tname: 'name',\n\t\t\t\ttype: 'text',\n\t\t\t\trequired: true,\n\t\t\t\tlabel: labelForKey(keys.providerFieldName),\n\t\t\t},\n\t\t\t{\n\t\t\t\ttype: 'row',\n\t\t\t\tfields: [\n\t\t\t\t\t{\n\t\t\t\t\t\tname: 'provider',\n\t\t\t\t\t\ttype: 'select',\n\t\t\t\t\t\trequired: true,\n\t\t\t\t\t\tlabel: labelForKey(keys.providerFieldProvider),\n\t\t\t\t\t\toptions: [\n\t\t\t\t\t\t\t{ label: labelForKey(keys.providerNamePlausible), value: 'plausible' },\n\t\t\t\t\t\t\t{ label: labelForKey(keys.providerNameUmami), value: 'umami' },\n\t\t\t\t\t\t\t{ label: labelForKey(keys.providerNameGa4), value: 'ga4' },\n\t\t\t\t\t\t\t{ label: labelForKey(keys.providerNamePosthog), value: 'posthog' },\n\t\t\t\t\t\t],\n\t\t\t\t\t\tadmin: { width: '50%' },\n\t\t\t\t\t},\n\t\t\t\t\t{\n\t\t\t\t\t\tname: 'enabled',\n\t\t\t\t\t\ttype: 'checkbox',\n\t\t\t\t\t\tdefaultValue: true,\n\t\t\t\t\t\tlabel: labelForKey(keys.providerFieldEnabled),\n\t\t\t\t\t\tadmin: { width: '50%', style: { alignSelf: 'flex-end' } },\n\t\t\t\t\t},\n\t\t\t\t],\n\t\t\t},\n\t\t\t{\n\t\t\t\t// Written by scoped setups (or a tenant plugin's own field via `scopeField`);\n\t\t\t\t// hidden because single-site installs never touch it.\n\t\t\t\tname: 'scope',\n\t\t\t\ttype: 'text',\n\t\t\t\tindex: true,\n\t\t\t\tlabel: labelForKey(keys.providerFieldScope),\n\t\t\t\tadmin: { hidden: true },\n\t\t\t},\n\t\t\tproviderGroup('plausible', keys.providerNamePlausible, [\n\t\t\t\t{\n\t\t\t\t\ttype: 'row',\n\t\t\t\t\tfields: [\n\t\t\t\t\t\ttextField('siteId', keys.providerFieldSiteId, '50%'),\n\t\t\t\t\t\t...secretField(args, { name: 'apiKey', label: keys.providerFieldApiKey, width: '50%' }),\n\t\t\t\t\t],\n\t\t\t\t},\n\t\t\t\thostField(),\n\t\t\t]),\n\t\t\tproviderGroup('umami', keys.providerNameUmami, [\n\t\t\t\t{\n\t\t\t\t\ttype: 'row',\n\t\t\t\t\tfields: [\n\t\t\t\t\t\ttextField('websiteId', keys.providerFieldWebsiteId, '50%'),\n\t\t\t\t\t\t...secretField(args, { name: 'apiKey', label: keys.providerFieldApiKey, width: '50%' }),\n\t\t\t\t\t],\n\t\t\t\t},\n\t\t\t\t...secretField(args, { name: 'token', label: keys.providerFieldToken }),\n\t\t\t\thostField(),\n\t\t\t]),\n\t\t\tproviderGroup('ga4', keys.providerNameGa4, [\n\t\t\t\t{\n\t\t\t\t\ttype: 'row',\n\t\t\t\t\tfields: [\n\t\t\t\t\t\ttextField('propertyId', keys.providerFieldPropertyId, '50%'),\n\t\t\t\t\t\ttextField('projectId', keys.providerFieldProjectId, '50%'),\n\t\t\t\t\t],\n\t\t\t\t},\n\t\t\t\ttextField('clientEmail', keys.providerFieldClientEmail),\n\t\t\t\t...args.buildSecret({\n\t\t\t\t\tname: 'privateKey',\n\t\t\t\t\ttype: 'textarea',\n\t\t\t\t\tlabel: labelForKey(keys.providerFieldPrivateKey),\n\t\t\t\t}),\n\t\t\t]),\n\t\t\tproviderGroup('posthog', keys.providerNamePosthog, [\n\t\t\t\t{\n\t\t\t\t\ttype: 'row',\n\t\t\t\t\tfields: [\n\t\t\t\t\t\ttextField('projectId', keys.providerFieldProjectId, '50%'),\n\t\t\t\t\t\t...secretField(args, { name: 'apiKey', label: keys.providerFieldApiKey, width: '50%' }),\n\t\t\t\t\t],\n\t\t\t\t},\n\t\t\t\thostField(),\n\t\t\t]),\n\t\t],\n\t}\n\treturn args.overrides ? args.overrides(collection) : collection\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"collection.js","names":[],"sources":["../../src/providers/collection.ts"],"sourcesContent":["import type { CollectionConfig, Field, TextareaField, TextField } from 'payload'\nimport { keys, type TranslationKey } from '../translations/keys'\nimport { labelForKey } from '../translations/server'\nimport type { ProviderAccessArgs } from './access'\nimport { providerCreateAccess, providerRowAccess } from './access'\nimport type { ProviderId } from './factory'\nimport { stampScope } from './stampScope'\n\nexport const PROVIDERS_SLUG = 'analytics-providers'\n\n/** Builds the sealed variant of a secret source field; injected so the fields peer stays lazy. */\nexport type BuildSecretField = (source: TextField | TextareaField) => Field[]\n\nexport interface BuildProvidersCollectionArgs extends ProviderAccessArgs {\n\tslug: string\n\taccess?: Partial<CollectionConfig['access']>\n\toverrides?: (collection: CollectionConfig) => CollectionConfig\n\t/** Called after any change or delete so the per-scope registry cache drops stale adapters. */\n\tonChange: () => void\n\tbuildSecret: BuildSecretField\n}\n\nconst textField = (name: string, label: TranslationKey, width?: string): Field => ({\n\tname,\n\ttype: 'text',\n\tlabel: labelForKey(label),\n\t...(width ? { admin: { width } } : {}),\n})\n\nconst secretField = (\n\targs: BuildProvidersCollectionArgs,\n\topts: { name: string; label: TranslationKey; width?: string }\n): Field[] =>\n\targs.buildSecret({\n\t\tname: opts.name,\n\t\ttype: 'text',\n\t\tlabel: labelForKey(opts.label),\n\t\t...(opts.width ? { admin: { width: opts.width } } : {}),\n\t})\n\nconst hostField = (): Field => ({\n\tname: 'host',\n\ttype: 'text',\n\tlabel: labelForKey(keys.providerFieldHost),\n\tadmin: { description: labelForKey(keys.providerFieldHostHelp) },\n})\n\nconst providerGroup = (provider: ProviderId, label: TranslationKey, fields: Field[]): Field => ({\n\tname: provider,\n\ttype: 'group',\n\tlabel: labelForKey(label),\n\tadmin: { condition: (data) => data?.provider === provider },\n\tfields,\n})\n\n/**\n * The runtime provider-settings collection: one document per provider (and per scope\n * in scoped installs). Admin-only by default; `access` entries override individual\n * operations and `overrides` reshapes the whole config last, so slugs, labels,\n * fields, and access all stay overridable.\n */\nexport const buildProvidersCollection = (args: BuildProvidersCollectionArgs): CollectionConfig => {\n\tconst collection: CollectionConfig = {\n\t\tslug: args.slug,\n\t\tlabels: {\n\t\t\tsingular: labelForKey(keys.providersCollectionSingular),\n\t\t\tplural: labelForKey(keys.providersCollectionPlural),\n\t\t},\n\t\tdisableDuplicate: true,\n\t\tadmin: {\n\t\t\tuseAsTitle: 'name',\n\t\t\tdefaultColumns: ['name', 'provider', 'enabled'],\n\t\t\tgroup: 'Analytics',\n\t\t},\n\t\taccess: {\n\t\t\tread: providerRowAccess(args),\n\t\t\tcreate: providerCreateAccess(args),\n\t\t\tupdate: providerRowAccess(args),\n\t\t\tdelete: providerRowAccess(args),\n\t\t\t...args.access,\n\t\t},\n\t\thooks: {\n\t\t\tbeforeChange: [stampScope(args)],\n\t\t\tafterChange: [\n\t\t\t\t({ doc }) => {\n\t\t\t\t\targs.onChange()\n\t\t\t\t\treturn doc\n\t\t\t\t},\n\t\t\t],\n\t\t\tafterDelete: [\n\t\t\t\t({ doc }) => {\n\t\t\t\t\targs.onChange()\n\t\t\t\t\treturn doc\n\t\t\t\t},\n\t\t\t],\n\t\t},\n\t\tfields: [\n\t\t\t{\n\t\t\t\tname: 'name',\n\t\t\t\ttype: 'text',\n\t\t\t\trequired: true,\n\t\t\t\tlabel: labelForKey(keys.providerFieldName),\n\t\t\t},\n\t\t\t{\n\t\t\t\ttype: 'row',\n\t\t\t\tfields: [\n\t\t\t\t\t{\n\t\t\t\t\t\tname: 'provider',\n\t\t\t\t\t\ttype: 'select',\n\t\t\t\t\t\trequired: true,\n\t\t\t\t\t\tlabel: labelForKey(keys.providerFieldProvider),\n\t\t\t\t\t\toptions: [\n\t\t\t\t\t\t\t{ label: labelForKey(keys.providerNamePlausible), value: 'plausible' },\n\t\t\t\t\t\t\t{ label: labelForKey(keys.providerNameUmami), value: 'umami' },\n\t\t\t\t\t\t\t{ label: labelForKey(keys.providerNameGa4), value: 'ga4' },\n\t\t\t\t\t\t\t{ label: labelForKey(keys.providerNamePosthog), value: 'posthog' },\n\t\t\t\t\t\t],\n\t\t\t\t\t\tadmin: { width: '50%' },\n\t\t\t\t\t},\n\t\t\t\t\t{\n\t\t\t\t\t\tname: 'enabled',\n\t\t\t\t\t\ttype: 'checkbox',\n\t\t\t\t\t\tdefaultValue: true,\n\t\t\t\t\t\tlabel: labelForKey(keys.providerFieldEnabled),\n\t\t\t\t\t\tadmin: { width: '50%', style: { alignSelf: 'flex-end' } },\n\t\t\t\t\t},\n\t\t\t\t],\n\t\t\t},\n\t\t\t{\n\t\t\t\t// Written by scoped setups (or a tenant plugin's own field via `scopeField`);\n\t\t\t\t// hidden because single-site installs never touch it.\n\t\t\t\tname: 'scope',\n\t\t\t\ttype: 'text',\n\t\t\t\tindex: true,\n\t\t\t\tlabel: labelForKey(keys.providerFieldScope),\n\t\t\t\tadmin: { hidden: true },\n\t\t\t},\n\t\t\tproviderGroup('plausible', keys.providerNamePlausible, [\n\t\t\t\t{\n\t\t\t\t\ttype: 'row',\n\t\t\t\t\tfields: [\n\t\t\t\t\t\ttextField('siteId', keys.providerFieldSiteId, '50%'),\n\t\t\t\t\t\t...secretField(args, { name: 'apiKey', label: keys.providerFieldApiKey, width: '50%' }),\n\t\t\t\t\t],\n\t\t\t\t},\n\t\t\t\thostField(),\n\t\t\t]),\n\t\t\tproviderGroup('umami', keys.providerNameUmami, [\n\t\t\t\t{\n\t\t\t\t\ttype: 'row',\n\t\t\t\t\tfields: [\n\t\t\t\t\t\ttextField('websiteId', keys.providerFieldWebsiteId, '50%'),\n\t\t\t\t\t\t...secretField(args, { name: 'apiKey', label: keys.providerFieldApiKey, width: '50%' }),\n\t\t\t\t\t],\n\t\t\t\t},\n\t\t\t\t...secretField(args, { name: 'token', label: keys.providerFieldToken }),\n\t\t\t\thostField(),\n\t\t\t]),\n\t\t\tproviderGroup('ga4', keys.providerNameGa4, [\n\t\t\t\t{\n\t\t\t\t\ttype: 'row',\n\t\t\t\t\tfields: [\n\t\t\t\t\t\ttextField('propertyId', keys.providerFieldPropertyId, '50%'),\n\t\t\t\t\t\ttextField('projectId', keys.providerFieldProjectId, '50%'),\n\t\t\t\t\t],\n\t\t\t\t},\n\t\t\t\ttextField('clientEmail', keys.providerFieldClientEmail),\n\t\t\t\t...args.buildSecret({\n\t\t\t\t\tname: 'privateKey',\n\t\t\t\t\ttype: 'textarea',\n\t\t\t\t\tlabel: labelForKey(keys.providerFieldPrivateKey),\n\t\t\t\t}),\n\t\t\t]),\n\t\t\tproviderGroup('posthog', keys.providerNamePosthog, [\n\t\t\t\t{\n\t\t\t\t\ttype: 'row',\n\t\t\t\t\tfields: [\n\t\t\t\t\t\ttextField('projectId', keys.providerFieldProjectId, '50%'),\n\t\t\t\t\t\t...secretField(args, { name: 'apiKey', label: keys.providerFieldApiKey, width: '50%' }),\n\t\t\t\t\t],\n\t\t\t\t},\n\t\t\t\thostField(),\n\t\t\t]),\n\t\t],\n\t}\n\treturn args.overrides ? args.overrides(collection) : collection\n}\n"],"mappings":"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"}
@@ -1,3 +1,4 @@
1
+ import { providerRowAccess } from "../providers/access.js";
1
2
  //#region src/sync/collection.ts
2
3
  const METRIC_FIELDS = [
3
4
  "pageviews",
@@ -14,12 +15,15 @@ const METRIC_FIELDS = [
14
15
  * substrate for custom reporting rather than something to browse and edit; pass
15
16
  * `sync: { hidden: false }` to surface it. `admin.hidden` only hides the nav entry, so
16
17
  * the collection stays fully queryable through the REST/local API either way. The unique
17
- * (source, date) index makes re-syncs idempotent and is cross-DB clean (both key columns
18
- * are required, so NOT NULL on Postgres, which would otherwise treat repeated rows as
19
- * distinct). Metric fields are nullable so a provider that omits a metric is
20
- * distinguishable from a real zero.
18
+ * (source, date, scope) index makes re-syncs idempotent and is cross-DB clean (all key
19
+ * columns are required, so NOT NULL on Postgres, which would otherwise treat repeated rows
20
+ * as distinct). Metric fields are nullable so a provider that omits a metric is
21
+ * distinguishable from a real zero. Read access reuses `providerRowAccess`: unscoped
22
+ * installs keep the any-authenticated-user behavior, scoped installs constrain reads to the
23
+ * request's resolved scope (or lift the constraint for a platform-read grant). Writes stay
24
+ * locked to the sync job, which writes with `overrideAccess: true`.
21
25
  */
22
- const syncCollection = (slug, hidden = true) => ({
26
+ const syncCollection = (slug, hidden, access) => ({
23
27
  slug,
24
28
  admin: {
25
29
  hidden,
@@ -32,7 +36,7 @@ const syncCollection = (slug, hidden = true) => ({
32
36
  ]
33
37
  },
34
38
  access: {
35
- read: ({ req }) => Boolean(req.user),
39
+ read: providerRowAccess(access),
36
40
  create: () => false,
37
41
  update: () => false,
38
42
  delete: () => false
@@ -50,6 +54,14 @@ const syncCollection = (slug, hidden = true) => ({
50
54
  required: true,
51
55
  index: true
52
56
  },
57
+ {
58
+ name: "scope",
59
+ type: "text",
60
+ required: true,
61
+ defaultValue: "",
62
+ index: true,
63
+ validate: ((value) => typeof value === "string" ? true : "invalid scope")
64
+ },
53
65
  ...METRIC_FIELDS.map((name) => ({
54
66
  name,
55
67
  type: "number"
@@ -60,7 +72,11 @@ const syncCollection = (slug, hidden = true) => ({
60
72
  }
61
73
  ],
62
74
  indexes: [{
63
- fields: ["source", "date"],
75
+ fields: [
76
+ "source",
77
+ "date",
78
+ "scope"
79
+ ],
64
80
  unique: true
65
81
  }]
66
82
  });
@@ -1 +1 @@
1
- {"version":3,"file":"collection.js","names":[],"sources":["../../src/sync/collection.ts"],"sourcesContent":["import type { CollectionConfig, Field } from 'payload'\n\nexport const SYNC_DEFAULT_SLUG = 'analytics-daily'\n\nexport const METRIC_FIELDS = [\n\t'pageviews',\n\t'visitors',\n\t'sessions',\n\t'avgDuration',\n\t'bounceRate',\n\t'events',\n] as const\n\nexport type SyncMetric = (typeof METRIC_FIELDS)[number]\n\n/**\n * The sync tier's queryable collection: one row per (source, date) of a provider's daily\n * metrics. It is read-only and machine-written (writes are locked to the sync job, which\n * uses overrideAccess), and hidden from the admin nav by default because it is a query\n * substrate for custom reporting rather than something to browse and edit; pass\n * `sync: { hidden: false }` to surface it. `admin.hidden` only hides the nav entry, so\n * the collection stays fully queryable through the REST/local API either way. The unique\n * (source, date) index makes re-syncs idempotent and is cross-DB clean (both key columns\n * are required, so NOT NULL on Postgres, which would otherwise treat repeated rows as\n * distinct). Metric fields are nullable so a provider that omits a metric is\n * distinguishable from a real zero.\n */\nexport const syncCollection = (slug: string, hidden = true): CollectionConfig => ({\n\tslug,\n\tadmin: {\n\t\thidden,\n\t\tuseAsTitle: 'source',\n\t\tdefaultColumns: ['source', 'date', 'pageviews', 'visitors'],\n\t},\n\taccess: {\n\t\tread: ({ req }) => Boolean(req.user),\n\t\tcreate: () => false,\n\t\tupdate: () => false,\n\t\tdelete: () => false,\n\t},\n\tfields: [\n\t\t{ name: 'source', type: 'text', required: true, index: true },\n\t\t{ name: 'date', type: 'date', required: true, index: true },\n\t\t...METRIC_FIELDS.map((name): Field => ({ name, type: 'number' })),\n\t\t{ name: 'syncedAt', type: 'date' },\n\t],\n\tindexes: [{ fields: ['source', 'date'], unique: true }],\n})\n"],"mappings":";AAIA,MAAa,gBAAgB;CAC5B;CACA;CACA;CACA;CACA;CACA;AACD;;;;;;;;;;;;;AAgBA,MAAa,kBAAkB,MAAc,SAAS,UAA4B;CACjF;CACA,OAAO;EACN;EACA,YAAY;EACZ,gBAAgB;GAAC;GAAU;GAAQ;GAAa;EAAU;CAC3D;CACA,QAAQ;EACP,OAAO,EAAE,UAAU,QAAQ,IAAI,IAAI;EACnC,cAAc;EACd,cAAc;EACd,cAAc;CACf;CACA,QAAQ;EACP;GAAE,MAAM;GAAU,MAAM;GAAQ,UAAU;GAAM,OAAO;EAAK;EAC5D;GAAE,MAAM;GAAQ,MAAM;GAAQ,UAAU;GAAM,OAAO;EAAK;EAC1D,GAAG,cAAc,KAAK,UAAiB;GAAE;GAAM,MAAM;EAAS,EAAE;EAChE;GAAE,MAAM;GAAY,MAAM;EAAO;CAClC;CACA,SAAS,CAAC;EAAE,QAAQ,CAAC,UAAU,MAAM;EAAG,QAAQ;CAAK,CAAC;AACvD"}
1
+ {"version":3,"file":"collection.js","names":[],"sources":["../../src/sync/collection.ts"],"sourcesContent":["import type { CollectionConfig, Field, TextFieldSingleValidation } from 'payload'\nimport type { ProviderAccessArgs } from '../providers/access'\nimport { providerRowAccess } from '../providers/access'\n\nexport const SYNC_DEFAULT_SLUG = 'analytics-daily'\n\nexport const METRIC_FIELDS = [\n\t'pageviews',\n\t'visitors',\n\t'sessions',\n\t'avgDuration',\n\t'bounceRate',\n\t'events',\n] as const\n\nexport type SyncMetric = (typeof METRIC_FIELDS)[number]\n\n/**\n * The sync tier's queryable collection: one row per (source, date) of a provider's daily\n * metrics. It is read-only and machine-written (writes are locked to the sync job, which\n * uses overrideAccess), and hidden from the admin nav by default because it is a query\n * substrate for custom reporting rather than something to browse and edit; pass\n * `sync: { hidden: false }` to surface it. `admin.hidden` only hides the nav entry, so\n * the collection stays fully queryable through the REST/local API either way. The unique\n * (source, date, scope) index makes re-syncs idempotent and is cross-DB clean (all key\n * columns are required, so NOT NULL on Postgres, which would otherwise treat repeated rows\n * as distinct). Metric fields are nullable so a provider that omits a metric is\n * distinguishable from a real zero. Read access reuses `providerRowAccess`: unscoped\n * installs keep the any-authenticated-user behavior, scoped installs constrain reads to the\n * request's resolved scope (or lift the constraint for a platform-read grant). Writes stay\n * locked to the sync job, which writes with `overrideAccess: true`.\n */\nexport const syncCollection = (\n\tslug: string,\n\thidden: boolean,\n\taccess: ProviderAccessArgs\n): CollectionConfig => ({\n\tslug,\n\tadmin: {\n\t\thidden,\n\t\tuseAsTitle: 'source',\n\t\tdefaultColumns: ['source', 'date', 'pageviews', 'visitors'],\n\t},\n\taccess: {\n\t\tread: providerRowAccess(access),\n\t\tcreate: () => false,\n\t\tupdate: () => false,\n\t\tdelete: () => false,\n\t},\n\tfields: [\n\t\t{ name: 'source', type: 'text', required: true, index: true },\n\t\t{ name: 'date', type: 'date', required: true, index: true },\n\t\t{\n\t\t\tname: 'scope',\n\t\t\ttype: 'text',\n\t\t\trequired: true,\n\t\t\tdefaultValue: '',\n\t\t\tindex: true,\n\t\t\t// '' is the deliberate sentinel for \"no scope\"; Payload's default text\n\t\t\t// validator treats it as failing `required`, so accept any string.\n\t\t\tvalidate: ((value) =>\n\t\t\t\ttypeof value === 'string' ? true : 'invalid scope') as TextFieldSingleValidation,\n\t\t},\n\t\t...METRIC_FIELDS.map((name): Field => ({ name, type: 'number' })),\n\t\t{ name: 'syncedAt', type: 'date' },\n\t],\n\tindexes: [{ fields: ['source', 'date', 'scope'], unique: true }],\n})\n"],"mappings":";;AAMA,MAAa,gBAAgB;CAC5B;CACA;CACA;CACA;CACA;CACA;AACD;;;;;;;;;;;;;;;;AAmBA,MAAa,kBACZ,MACA,QACA,YACuB;CACvB;CACA,OAAO;EACN;EACA,YAAY;EACZ,gBAAgB;GAAC;GAAU;GAAQ;GAAa;EAAU;CAC3D;CACA,QAAQ;EACP,MAAM,kBAAkB,MAAM;EAC9B,cAAc;EACd,cAAc;EACd,cAAc;CACf;CACA,QAAQ;EACP;GAAE,MAAM;GAAU,MAAM;GAAQ,UAAU;GAAM,OAAO;EAAK;EAC5D;GAAE,MAAM;GAAQ,MAAM;GAAQ,UAAU;GAAM,OAAO;EAAK;EAC1D;GACC,MAAM;GACN,MAAM;GACN,UAAU;GACV,cAAc;GACd,OAAO;GAGP,YAAY,UACX,OAAO,UAAU,WAAW,OAAO;EACrC;EACA,GAAG,cAAc,KAAK,UAAiB;GAAE;GAAM,MAAM;EAAS,EAAE;EAChE;GAAE,MAAM;GAAY,MAAM;EAAO;CAClC;CACA,SAAS,CAAC;EAAE,QAAQ;GAAC;GAAU;GAAQ;EAAO;EAAG,QAAQ;CAAK,CAAC;AAChE"}
@@ -9,14 +9,15 @@ const DAY_MS = 864e5;
9
9
  * `date`, each present numeric metric is copied, absent metrics are omitted (stored null).
10
10
  * Returns null when the row has no usable timestamp, so a malformed row is skipped not written.
11
11
  */
12
- const toSyncRow = (source, row, syncedAt) => {
12
+ const toSyncRow = (source, row, opts) => {
13
13
  if (!row.timestamp) return null;
14
14
  const date = new Date(row.timestamp);
15
15
  if (Number.isNaN(date.getTime())) return null;
16
16
  const doc = {
17
17
  source,
18
18
  date,
19
- syncedAt
19
+ syncedAt: opts.syncedAt,
20
+ scope: opts.scope ?? ""
20
21
  };
21
22
  for (const metric of METRIC_FIELDS) {
22
23
  const value = row.metrics[metric];
@@ -28,7 +29,11 @@ const startOfUtcDay = (d) => new Date(Date.UTC(d.getUTCFullYear(), d.getUTCMonth
28
29
  const upsertDailyRow = async (req, collectionSlug, row) => {
29
30
  const found = (await req.payload.find({
30
31
  collection: collectionSlug,
31
- where: { and: [{ source: { equals: row.source } }, { date: { equals: row.date.toISOString() } }] },
32
+ where: { and: [
33
+ { source: { equals: row.source } },
34
+ { date: { equals: row.date.toISOString() } },
35
+ { scope: { equals: row.scope } }
36
+ ] },
32
37
  limit: 1,
33
38
  depth: 0,
34
39
  overrideAccess: true
@@ -96,7 +101,10 @@ const syncTask = (opts) => ({
96
101
  continue;
97
102
  }
98
103
  for (const row of result.rows) {
99
- const doc = toSyncRow(adapter.id, row, now);
104
+ const doc = toSyncRow(adapter.id, row, {
105
+ syncedAt: now,
106
+ scope: scope ?? ""
107
+ });
100
108
  if (!doc) continue;
101
109
  try {
102
110
  await upsertDailyRow(req, opts.collectionSlug, doc);
@@ -1 +1 @@
1
- {"version":3,"file":"syncTask.js","names":[],"sources":["../../src/sync/syncTask.ts"],"sourcesContent":["import type { PayloadRequest, TaskConfig } from 'payload'\nimport type { AnalyticsResult, AnalyticsRow } from '../core/contract'\nimport { supportsGranularity } from '../core/granularity'\nimport { getRuntime, resolveRegistryFor, resolveScopeFor } from '../plugin/runtime'\nimport { METRIC_FIELDS, type SyncMetric } from './collection'\n\nexport const SYNC_TASK_SLUG = 'analytics-sync'\n\nconst DAY_MS = 86_400_000\n\nexport type SyncRow = { source: string; date: Date; syncedAt: Date } & Partial<\n\tRecord<SyncMetric, number>\n>\n\nexport interface SyncTaskOptions {\n\tcron: string\n\tlookbackDays: number\n\tcollectionSlug: string\n\tadapterIds?: string[]\n}\n\n/**\n * Map one daily `AnalyticsRow` to a sync-collection doc: the row's UTC-day timestamp becomes\n * `date`, each present numeric metric is copied, absent metrics are omitted (stored null).\n * Returns null when the row has no usable timestamp, so a malformed row is skipped not written.\n */\nexport const toSyncRow = (source: string, row: AnalyticsRow, syncedAt: Date): SyncRow | null => {\n\tif (!row.timestamp) {\n\t\treturn null\n\t}\n\tconst date = new Date(row.timestamp)\n\tif (Number.isNaN(date.getTime())) {\n\t\treturn null\n\t}\n\tconst doc: SyncRow = { source, date, syncedAt }\n\tfor (const metric of METRIC_FIELDS) {\n\t\tconst value = row.metrics[metric]\n\t\tif (typeof value === 'number') {\n\t\t\tdoc[metric] = value\n\t\t}\n\t}\n\treturn doc\n}\n\nconst startOfUtcDay = (d: Date): Date =>\n\tnew Date(Date.UTC(d.getUTCFullYear(), d.getUTCMonth(), d.getUTCDate()))\n\nconst upsertDailyRow = async (\n\treq: PayloadRequest,\n\tcollectionSlug: string,\n\trow: SyncRow\n): Promise<void> => {\n\tconst existing = await req.payload.find({\n\t\tcollection: collectionSlug as never,\n\t\twhere: {\n\t\t\tand: [{ source: { equals: row.source } }, { date: { equals: row.date.toISOString() } }],\n\t\t},\n\t\tlimit: 1,\n\t\tdepth: 0,\n\t\toverrideAccess: true,\n\t})\n\tconst found = existing.docs[0] as { id: string | number } | undefined\n\tif (found) {\n\t\tawait req.payload.update({\n\t\t\tcollection: collectionSlug as never,\n\t\t\tid: found.id,\n\t\t\tdata: row as never,\n\t\t\toverrideAccess: true,\n\t\t})\n\t\treturn\n\t}\n\tawait req.payload.create({\n\t\tcollection: collectionSlug as never,\n\t\tdata: row as never,\n\t\toverrideAccess: true,\n\t})\n}\n\n/**\n * Opt-in Payload task that ETLs each configured provider adapter's last `lookbackDays` of\n * daily metrics into the sync collection (one upserted row per source + day), reading\n * through the surfacing engine so the pull rides its queue / backoff / cache. Native is\n * excluded (its data already lives in the rollups collection); each provider runs in its\n * own try/catch so one failure does not abort the rest.\n */\nexport const syncTask = (\n\topts: SyncTaskOptions\n): TaskConfig<{ input: Record<string, never>; output: { synced: number; failed: number } }> => ({\n\tslug: SYNC_TASK_SLUG,\n\thandler: async ({ req }) => {\n\t\tconst runtime = getRuntime(req.payload)\n\t\tif (!runtime) {\n\t\t\treturn { output: { synced: 0, failed: 0 } }\n\t\t}\n\t\tconst now = new Date()\n\t\tconst dateRange = {\n\t\t\tstart: new Date(startOfUtcDay(now).getTime() - (opts.lookbackDays - 1) * DAY_MS),\n\t\t\tend: now,\n\t\t}\n\t\tlet synced = 0\n\t\tlet failed = 0\n\t\t// A job req may lack the request shape an app's scopeResolver expects;\n\t\t// degrade to the install scope rather than failing the whole run.\n\t\tconst scope = await resolveScopeFor(runtime, req).catch(() => null)\n\t\tconst registry = await resolveRegistryFor(runtime, { payload: req.payload, req, scope })\n\t\tfor (const adapter of registry.all()) {\n\t\t\tif (adapter.id === 'native') {\n\t\t\t\tcontinue\n\t\t\t}\n\t\t\tif (opts.adapterIds && !opts.adapterIds.includes(adapter.id)) {\n\t\t\t\tcontinue\n\t\t\t}\n\t\t\tif (!adapter.isConfigured() || !supportsGranularity(adapter.capabilities, 'day')) {\n\t\t\t\tcontinue\n\t\t\t}\n\t\t\tconst metrics = METRIC_FIELDS.filter((m) => adapter.capabilities.metrics.has(m))\n\t\t\tif (metrics.length === 0) {\n\t\t\t\tcontinue\n\t\t\t}\n\t\t\tlet result: AnalyticsResult\n\t\t\ttry {\n\t\t\t\tresult = await runtime.engine.read(adapter, {\n\t\t\t\t\tmetrics,\n\t\t\t\t\tdateRange,\n\t\t\t\t\tgranularity: 'day',\n\t\t\t\t\tscope: scope ?? undefined,\n\t\t\t\t})\n\t\t\t} catch (err) {\n\t\t\t\tfailed++\n\t\t\t\treq.payload.logger.warn(\n\t\t\t\t\t`analytics sync: adapter \"${adapter.id}\" read failed: ${String(err)}`\n\t\t\t\t)\n\t\t\t\tcontinue\n\t\t\t}\n\t\t\tfor (const row of result.rows) {\n\t\t\t\tconst doc = toSyncRow(adapter.id, row, now)\n\t\t\t\tif (!doc) {\n\t\t\t\t\tcontinue\n\t\t\t\t}\n\t\t\t\ttry {\n\t\t\t\t\tawait upsertDailyRow(req, opts.collectionSlug, doc)\n\t\t\t\t\tsynced++\n\t\t\t\t} catch (err) {\n\t\t\t\t\tfailed++\n\t\t\t\t\treq.payload.logger.warn(\n\t\t\t\t\t\t`analytics sync: upsert for \"${adapter.id}\" on ${doc.date.toISOString()} failed: ${String(err)}`\n\t\t\t\t\t)\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t\treturn { output: { synced, failed } }\n\t},\n\tschedule: [{ cron: opts.cron, queue: 'default' }],\n})\n"],"mappings":"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"}
1
+ {"version":3,"file":"syncTask.js","names":[],"sources":["../../src/sync/syncTask.ts"],"sourcesContent":["import type { PayloadRequest, TaskConfig } from 'payload'\nimport type { AnalyticsResult, AnalyticsRow } from '../core/contract'\nimport { supportsGranularity } from '../core/granularity'\nimport { getRuntime, resolveRegistryFor, resolveScopeFor } from '../plugin/runtime'\nimport { METRIC_FIELDS, type SyncMetric } from './collection'\n\nexport const SYNC_TASK_SLUG = 'analytics-sync'\n\nconst DAY_MS = 86_400_000\n\nexport type SyncRow = { source: string; date: Date; syncedAt: Date; scope: string } & Partial<\n\tRecord<SyncMetric, number>\n>\n\nexport interface SyncTaskOptions {\n\tcron: string\n\tlookbackDays: number\n\tcollectionSlug: string\n\tadapterIds?: string[]\n}\n\n/**\n * Map one daily `AnalyticsRow` to a sync-collection doc: the row's UTC-day timestamp becomes\n * `date`, each present numeric metric is copied, absent metrics are omitted (stored null).\n * Returns null when the row has no usable timestamp, so a malformed row is skipped not written.\n */\nexport const toSyncRow = (\n\tsource: string,\n\trow: AnalyticsRow,\n\topts: { syncedAt: Date; scope?: string }\n): SyncRow | null => {\n\tif (!row.timestamp) {\n\t\treturn null\n\t}\n\tconst date = new Date(row.timestamp)\n\tif (Number.isNaN(date.getTime())) {\n\t\treturn null\n\t}\n\tconst doc: SyncRow = { source, date, syncedAt: opts.syncedAt, scope: opts.scope ?? '' }\n\tfor (const metric of METRIC_FIELDS) {\n\t\tconst value = row.metrics[metric]\n\t\tif (typeof value === 'number') {\n\t\t\tdoc[metric] = value\n\t\t}\n\t}\n\treturn doc\n}\n\nconst startOfUtcDay = (d: Date): Date =>\n\tnew Date(Date.UTC(d.getUTCFullYear(), d.getUTCMonth(), d.getUTCDate()))\n\nconst upsertDailyRow = async (\n\treq: PayloadRequest,\n\tcollectionSlug: string,\n\trow: SyncRow\n): Promise<void> => {\n\tconst existing = await req.payload.find({\n\t\tcollection: collectionSlug as never,\n\t\twhere: {\n\t\t\tand: [\n\t\t\t\t{ source: { equals: row.source } },\n\t\t\t\t{ date: { equals: row.date.toISOString() } },\n\t\t\t\t{ scope: { equals: row.scope } },\n\t\t\t],\n\t\t},\n\t\tlimit: 1,\n\t\tdepth: 0,\n\t\toverrideAccess: true,\n\t})\n\tconst found = existing.docs[0] as { id: string | number } | undefined\n\tif (found) {\n\t\tawait req.payload.update({\n\t\t\tcollection: collectionSlug as never,\n\t\t\tid: found.id,\n\t\t\tdata: row as never,\n\t\t\toverrideAccess: true,\n\t\t})\n\t\treturn\n\t}\n\tawait req.payload.create({\n\t\tcollection: collectionSlug as never,\n\t\tdata: row as never,\n\t\toverrideAccess: true,\n\t})\n}\n\n/**\n * Opt-in Payload task that ETLs each configured provider adapter's last `lookbackDays` of\n * daily metrics into the sync collection (one upserted row per source + day), reading\n * through the surfacing engine so the pull rides its queue / backoff / cache. Native is\n * excluded (its data already lives in the rollups collection); each provider runs in its\n * own try/catch so one failure does not abort the rest.\n */\nexport const syncTask = (\n\topts: SyncTaskOptions\n): TaskConfig<{ input: Record<string, never>; output: { synced: number; failed: number } }> => ({\n\tslug: SYNC_TASK_SLUG,\n\thandler: async ({ req }) => {\n\t\tconst runtime = getRuntime(req.payload)\n\t\tif (!runtime) {\n\t\t\treturn { output: { synced: 0, failed: 0 } }\n\t\t}\n\t\tconst now = new Date()\n\t\tconst dateRange = {\n\t\t\tstart: new Date(startOfUtcDay(now).getTime() - (opts.lookbackDays - 1) * DAY_MS),\n\t\t\tend: now,\n\t\t}\n\t\tlet synced = 0\n\t\tlet failed = 0\n\t\t// A job req may lack the request shape an app's scopeResolver expects;\n\t\t// degrade to the install scope rather than failing the whole run.\n\t\tconst scope = await resolveScopeFor(runtime, req).catch(() => null)\n\t\tconst registry = await resolveRegistryFor(runtime, { payload: req.payload, req, scope })\n\t\tfor (const adapter of registry.all()) {\n\t\t\tif (adapter.id === 'native') {\n\t\t\t\tcontinue\n\t\t\t}\n\t\t\tif (opts.adapterIds && !opts.adapterIds.includes(adapter.id)) {\n\t\t\t\tcontinue\n\t\t\t}\n\t\t\tif (!adapter.isConfigured() || !supportsGranularity(adapter.capabilities, 'day')) {\n\t\t\t\tcontinue\n\t\t\t}\n\t\t\tconst metrics = METRIC_FIELDS.filter((m) => adapter.capabilities.metrics.has(m))\n\t\t\tif (metrics.length === 0) {\n\t\t\t\tcontinue\n\t\t\t}\n\t\t\tlet result: AnalyticsResult\n\t\t\ttry {\n\t\t\t\tresult = await runtime.engine.read(adapter, {\n\t\t\t\t\tmetrics,\n\t\t\t\t\tdateRange,\n\t\t\t\t\tgranularity: 'day',\n\t\t\t\t\tscope: scope ?? undefined,\n\t\t\t\t})\n\t\t\t} catch (err) {\n\t\t\t\tfailed++\n\t\t\t\treq.payload.logger.warn(\n\t\t\t\t\t`analytics sync: adapter \"${adapter.id}\" read failed: ${String(err)}`\n\t\t\t\t)\n\t\t\t\tcontinue\n\t\t\t}\n\t\t\tfor (const row of result.rows) {\n\t\t\t\tconst doc = toSyncRow(adapter.id, row, { syncedAt: now, scope: scope ?? '' })\n\t\t\t\tif (!doc) {\n\t\t\t\t\tcontinue\n\t\t\t\t}\n\t\t\t\ttry {\n\t\t\t\t\tawait upsertDailyRow(req, opts.collectionSlug, doc)\n\t\t\t\t\tsynced++\n\t\t\t\t} catch (err) {\n\t\t\t\t\tfailed++\n\t\t\t\t\treq.payload.logger.warn(\n\t\t\t\t\t\t`analytics sync: upsert for \"${adapter.id}\" on ${doc.date.toISOString()} failed: ${String(err)}`\n\t\t\t\t\t)\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t\treturn { output: { synced, failed } }\n\t},\n\tschedule: [{ cron: opts.cron, queue: 'default' }],\n})\n"],"mappings":"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"}
@@ -20,6 +20,8 @@ const capabilities = {
20
20
  "country",
21
21
  "device"
22
22
  ]),
23
+ filters: new Set(["page"]),
24
+ filterOperators: new Set(["eq"]),
23
25
  batchPageReport: true,
24
26
  rateLimit: null,
25
27
  recommendedTtl: {
@@ -29,8 +31,13 @@ const capabilities = {
29
31
  };
30
32
  function memoryAdapter() {
31
33
  const events = [];
34
+ const matchesFilters = (e, q) => (q.filters ?? []).every((filter) => {
35
+ if (filter.dimension !== "page" || filter.operator !== "eq") return true;
36
+ return e.path === filter.value;
37
+ });
32
38
  const inRange = (e, q) => {
33
39
  if (q.path && e.path !== q.path) return false;
40
+ if (!matchesFilters(e, q)) return false;
34
41
  return e.timestamp >= q.dateRange.start && e.timestamp <= q.dateRange.end;
35
42
  };
36
43
  return {
@@ -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 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}\n\nexport function memoryAdapter(): MemoryAnalyticsAdapter {\n\tconst events: MemoryEvent[] = []\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\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,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;AAOA,SAAgB,gBAAwC;CACvD,MAAM,SAAwB,CAAC;CAG/B,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,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"}
@@ -0,0 +1,77 @@
1
+ import { keys } from "./keys.js";
2
+ //#region src/translations/ar.ts
3
+ const ar = {
4
+ [keys.pluginName]: "Analytics",
5
+ [keys.tabAnalytics]: "Analytics",
6
+ [keys.metricPageviews]: "مشاهدات الصفحة",
7
+ [keys.metricVisitors]: "الزوار",
8
+ [keys.metricSessions]: "الجلسات",
9
+ [keys.metricEvents]: "الأحداث",
10
+ [keys.metricAvgDuration]: "متوسط المدة",
11
+ [keys.metricBounceRate]: "معدل الارتداد",
12
+ [keys.metricScrollDepth]: "عمق التمرير",
13
+ [keys.metricConversions]: "التحويلات",
14
+ [keys.metricRevenue]: "الإيرادات",
15
+ [keys.stateNoData]: "لا توجد بيانات تحليلات بعد",
16
+ [keys.stateNew]: "جديد",
17
+ [keys.stateNotBound]: "التحليلات غير مهيأة لهذه المجموعة",
18
+ [keys.stateNotConfigured]: "اربط مزود تحليلات",
19
+ [keys.stateUnavailable]: "غير متاح لمصدر البيانات هذا",
20
+ [keys.timeframeToday]: "اليوم",
21
+ [keys.timeframeLast7Days]: "آخر 7 أيام",
22
+ [keys.timeframeLast30Days]: "آخر 30 يومًا",
23
+ [keys.timeframeLast90Days]: "آخر 90 يومًا",
24
+ [keys.timeframeThisMonth]: "هذا الشهر",
25
+ [keys.timeframeThisYear]: "هذه السنة",
26
+ [keys.timeframeLastYear]: "السنة الماضية",
27
+ [keys.timeframeAllTime]: "كل الوقت",
28
+ [keys.widgetMetricLabel]: "المقياس",
29
+ [keys.widgetTrendLabel]: "الاتجاه",
30
+ [keys.widgetBreakdownPages]: "أهم الصفحات",
31
+ [keys.widgetBreakdownSources]: "أهم المصادر",
32
+ [keys.widgetBreakdownDevices]: "الأجهزة",
33
+ [keys.widgetBreakdownCountries]: "الدول",
34
+ [keys.widgetFieldLimit]: "الصفوف",
35
+ [keys.stateNoBreakdown]: "لا توجد بيانات بعد",
36
+ [keys.stateClamped]: "يتم عرض أقصى نطاق يدعمه المزود",
37
+ [keys.widgetFieldTitle]: "العنوان",
38
+ [keys.widgetFieldMetric]: "المقياس",
39
+ [keys.widgetFieldTimeframe]: "الفترة الزمنية",
40
+ [keys.widgetFieldDataSource]: "مصدر البيانات",
41
+ [keys.widgetFieldTitlePlaceholder]: "مثال: مشاهدات الصفحة اليومية",
42
+ [keys.widgetTimeframeCustom]: "نطاق مخصص",
43
+ [keys.widgetFieldRange]: "نطاق التاريخ",
44
+ [keys.dateRangePlaceholder]: "اختر نطاق التاريخ...",
45
+ [keys.widgetFieldWindow]: "النافذة الزمنية",
46
+ [keys.widgetRealtimeLabel]: "نشط الآن",
47
+ [keys.widgetRealtimeCaption]: "نشط في هذه اللحظة",
48
+ [keys.widgetRealtimePaused]: "تم إيقاف التحديثات المباشرة مؤقتًا",
49
+ [keys.comparisonVsPrevious]: "مقارنة بالفترة السابقة",
50
+ [keys.comparisonIncrease]: "ارتفاع",
51
+ [keys.comparisonDecrease]: "انخفاض",
52
+ [keys.comparisonNoChange]: "بلا تغيير",
53
+ [keys.providersCollectionSingular]: "مزود تحليلات",
54
+ [keys.providersCollectionPlural]: "مزودو التحليلات",
55
+ [keys.providerFieldName]: "الاسم",
56
+ [keys.providerFieldProvider]: "المزود",
57
+ [keys.providerFieldEnabled]: "مفعّل",
58
+ [keys.providerFieldScope]: "النطاق",
59
+ [keys.providerFieldSiteId]: "معرّف الموقع",
60
+ [keys.providerFieldApiKey]: "مفتاح API",
61
+ [keys.providerFieldHost]: "المضيف",
62
+ [keys.providerFieldHostHelp]: "اتركه فارغًا لاستخدام سحابة المزود الافتراضية",
63
+ [keys.providerFieldWebsiteId]: "معرّف الموقع الإلكتروني",
64
+ [keys.providerFieldToken]: "رمز API",
65
+ [keys.providerFieldPropertyId]: "معرّف الخاصية",
66
+ [keys.providerFieldClientEmail]: "البريد الإلكتروني للعميل",
67
+ [keys.providerFieldPrivateKey]: "المفتاح الخاص",
68
+ [keys.providerFieldProjectId]: "معرّف المشروع",
69
+ [keys.providerNamePlausible]: "Plausible",
70
+ [keys.providerNameUmami]: "Umami",
71
+ [keys.providerNameGa4]: "Google Analytics 4",
72
+ [keys.providerNamePosthog]: "PostHog"
73
+ };
74
+ //#endregion
75
+ export { ar };
76
+
77
+ //# sourceMappingURL=ar.js.map