@10x-media/analytics 0.1.0-beta.1 → 0.1.0-beta.3
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.
- package/CHANGELOG.md +64 -0
- package/README.md +1 -0
- package/dist/adapters/ga4/ga4.js +17 -7
- package/dist/adapters/ga4/ga4.js.map +1 -1
- package/dist/adapters/plausible/plausible.js +5 -0
- package/dist/adapters/plausible/plausible.js.map +1 -1
- package/dist/adapters/posthog/posthog.js +28 -17
- package/dist/adapters/posthog/posthog.js.map +1 -1
- package/dist/adapters/umami/umami.js +1 -1
- package/dist/adapters/umami/umami.js.map +1 -1
- package/dist/binding/types.d.ts +9 -7
- package/dist/charts/TrendChart.js +17 -8
- package/dist/charts/TrendChart.js.map +1 -1
- package/dist/charts/bucket.js +31 -24
- package/dist/charts/bucket.js.map +1 -1
- package/dist/core/cacheKey.js +4 -7
- package/dist/core/cacheKey.js.map +1 -1
- package/dist/core/contract.d.ts +12 -1
- package/dist/core/contract.js.map +1 -1
- package/dist/core/options.d.ts +27 -2
- package/dist/core/options.js +15 -8
- package/dist/core/options.js.map +1 -1
- package/dist/exports/rsc.d.ts +6 -3
- package/dist/exports/rsc.js +5 -2
- package/dist/fields/AnalyticsPanelClient.js +193 -0
- package/dist/fields/AnalyticsPanelClient.js.map +1 -0
- package/dist/fields/AnalyticsPanelField.d.ts +28 -0
- package/dist/fields/AnalyticsPanelField.js +54 -0
- package/dist/fields/AnalyticsPanelField.js.map +1 -0
- package/dist/fields/AnalyticsStatField.d.ts +1 -1
- package/dist/fields/AnalyticsStatField.js +14 -3
- package/dist/fields/AnalyticsStatField.js.map +1 -1
- package/dist/fields/emptyState.js +46 -0
- package/dist/fields/emptyState.js.map +1 -0
- package/dist/fields/factories.d.ts +10 -2
- package/dist/fields/factories.js +33 -4
- package/dist/fields/factories.js.map +1 -1
- package/dist/fields/readForDocument.d.ts +57 -0
- package/dist/fields/readForDocument.js +50 -10
- package/dist/fields/readForDocument.js.map +1 -1
- package/dist/index.d.ts +2 -2
- package/dist/index.js +29 -4
- package/dist/index.js.map +1 -1
- package/dist/native/ingest/endpoint.js +5 -2
- package/dist/native/ingest/endpoint.js.map +1 -1
- package/dist/native/ingest/normalizeEvent.js +3 -2
- package/dist/native/ingest/normalizeEvent.js.map +1 -1
- package/dist/native/ingest/writeEvent.js +2 -1
- package/dist/native/ingest/writeEvent.js.map +1 -1
- package/dist/native/nativeAdapter.js +7 -4
- package/dist/native/nativeAdapter.js.map +1 -1
- package/dist/native/rollupAcc.js +9 -6
- package/dist/native/rollupAcc.js.map +1 -1
- package/dist/native/rollups/bumpRollup.js +17 -1
- package/dist/native/rollups/bumpRollup.js.map +1 -1
- package/dist/native/rollups/deltas.js +2 -2
- package/dist/native/rollups/deltas.js.map +1 -1
- package/dist/plugin/documentEndpoint.js +80 -0
- package/dist/plugin/documentEndpoint.js.map +1 -0
- package/dist/plugin/paths.js +11 -0
- package/dist/plugin/paths.js.map +1 -0
- package/dist/plugin/runtime.js +2 -1
- package/dist/plugin/runtime.js.map +1 -1
- package/dist/plugin/warmTask.js +1 -1
- package/dist/surfacing/engine.js +5 -5
- package/dist/surfacing/engine.js.map +1 -1
- package/dist/sync/collection.js +11 -6
- package/dist/sync/collection.js.map +1 -1
- package/dist/sync/syncTask.js +1 -1
- package/dist/timeframe/presets.js +12 -16
- package/dist/timeframe/presets.js.map +1 -1
- package/dist/timeframe/tz.js +110 -0
- package/dist/timeframe/tz.js.map +1 -0
- package/dist/translations/de.js +78 -0
- package/dist/translations/de.js.map +1 -0
- package/dist/translations/en.js +5 -2
- package/dist/translations/en.js.map +1 -1
- package/dist/translations/index.d.ts +2 -1
- package/dist/translations/index.js +6 -2
- package/dist/translations/index.js.map +1 -1
- package/dist/translations/keys.d.ts +5 -2
- package/dist/translations/keys.js +5 -2
- package/dist/translations/keys.js.map +1 -1
- package/dist/translations/metricKeys.js +0 -2
- package/dist/translations/metricKeys.js.map +1 -1
- package/dist/widgets/AnalyticsBreakdownWidget.js +1 -1
- package/dist/widgets/AnalyticsMetricWidget.js +9 -1
- package/dist/widgets/AnalyticsMetricWidget.js.map +1 -1
- package/dist/widgets/AnalyticsRealtimeWidget.js +1 -1
- package/dist/widgets/AnalyticsTrendWidget.js +10 -2
- package/dist/widgets/AnalyticsTrendWidget.js.map +1 -1
- package/dist/widgets/ComparisonDelta.js +83 -0
- package/dist/widgets/ComparisonDelta.js.map +1 -0
- package/dist/widgets/cardChrome.d.ts +8 -0
- package/dist/widgets/comparison.js +43 -0
- package/dist/widgets/comparison.js.map +1 -0
- package/dist/widgets/readForWidget.d.ts +4 -0
- package/dist/widgets/readForWidget.js +26 -11
- package/dist/widgets/readForWidget.js.map +1 -1
- package/dist/widgets/readForWidgetBreakdown.js +13 -8
- package/dist/widgets/readForWidgetBreakdown.js.map +1 -1
- package/dist/widgets/readForWidgetRealtime.js +1 -1
- package/dist/widgets/readForWidgetRealtime.js.map +1 -1
- package/dist/widgets/readForWidgetSeries.d.ts +6 -0
- package/dist/widgets/readForWidgetSeries.js +60 -40
- package/dist/widgets/readForWidgetSeries.js.map +1 -1
- package/dist/widgets/registerWidgets.js +148 -169
- package/dist/widgets/registerWidgets.js.map +1 -1
- package/package.json +5 -5
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"bumpRollup.js","names":[],"sources":["../../../src/native/rollups/bumpRollup.ts"],"sourcesContent":["import type { Payload } from 'payload'\nimport { ROLLUPS_SLUG } from '../collections/rollups'\nimport type { RollupKey, RollupMetric } from './deltas'\n\nconst PG_TABLE_KEY = 'analytics_rollups'\n\n// payload.db raw-access shapes are intentionally loose; these narrow casts reach the\n// Mongoose driver collection / Drizzle instance for atomic upserts (no public typed API).\ntype MongoDb = {\n\tname: 'mongoose'\n\tcollections: Record<\n\t\tstring,\n\t\t{ collection: { updateOne: (f: object, u: object, o: object) => Promise<unknown> } }\n\t>\n}\ntype PgDb = {\n\tname: 'postgres'\n\tdrizzle: {\n\t\tinsert: (t: unknown) => {\n\t\t\tvalues: (v: unknown) => { onConflictDoUpdate: (c: unknown) => Promise<unknown> }\n\t\t}\n\t}\n\ttables: Record<string, Record<string, unknown>>\n\ttableNameMap: Map<string, string>\n}\n\nconst ZERO: Record<RollupMetric, number> = {\n\tpageviews: 0,\n\tevents: 0,\n\tdurationMs: 0,\n\tsamples: 0,\n\tvisitors: 0,\n\tsessions: 0,\n}\n\n// Always seed every metric on insert: Payload's defaultValue is applied app-side, not as\n// a SQL default, so a raw insert that omits a NOT NULL metric column would fail on Postgres.\nexport async function bumpRollup(\n\tpayload: Payload,\n\tkey: RollupKey,\n\tinc: Partial<Record<RollupMetric, number>>\n): Promise<void> {\n\tif (payload.db.name === 'mongoose') {\n\t\tconst db = payload.db as unknown as MongoDb\n\t\tconst model = db.collections[ROLLUPS_SLUG]\n\t\tif (!model) throw new Error(`analytics: mongoose collection \"${ROLLUPS_SLUG}\" not found`)\n\t\tconst setOnInsert: Record<string, unknown> = { ...key }\n\t\tfor (const [metric, zero] of Object.entries(ZERO)) {\n\t\t\tif (!(metric in inc)) setOnInsert[metric] = zero\n\t\t}\n\t\tawait model.collection.updateOne(\n\t\t\tkey,\n\t\t\t{ $inc: inc, $setOnInsert: setOnInsert },\n\t\t\t{ upsert: true }\n\t\t)\n\t\treturn\n\t}\n\tconst { sql } = await
|
|
1
|
+
{"version":3,"file":"bumpRollup.js","names":[],"sources":["../../../src/native/rollups/bumpRollup.ts"],"sourcesContent":["import type { Payload } from 'payload'\nimport { ROLLUPS_SLUG } from '../collections/rollups'\nimport type { RollupKey, RollupMetric } from './deltas'\n\nconst PG_TABLE_KEY = 'analytics_rollups'\n\ntype PostgresSqlModule = { sql: typeof import('@payloadcms/db-postgres')['sql'] }\n\n/**\n * Loads the optional Postgres peer without a literal specifier: bundlers (Turbopack, webpack,\n * Vite) resolve literal dynamic imports at build time, which fails a Mongo host's build even\n * though this branch is unreachable there. The function-built specifier is opaque to their\n * analyzers, the ignore comments cover bundlers that would still warn, and the type-only\n * reference above erases at compile time, so the package is touched only when the Postgres\n * branch actually runs.\n */\nconst importPostgresSql = (): Promise<PostgresSqlModule> => {\n\tconst specifier = ['@payloadcms', 'db-postgres'].join('/')\n\treturn import(\n\t\t/* webpackIgnore: true */ /* turbopackIgnore: true */ /* @vite-ignore */ specifier\n\t) as Promise<PostgresSqlModule>\n}\n\n// payload.db raw-access shapes are intentionally loose; these narrow casts reach the\n// Mongoose driver collection / Drizzle instance for atomic upserts (no public typed API).\ntype MongoDb = {\n\tname: 'mongoose'\n\tcollections: Record<\n\t\tstring,\n\t\t{ collection: { updateOne: (f: object, u: object, o: object) => Promise<unknown> } }\n\t>\n}\ntype PgDb = {\n\tname: 'postgres'\n\tdrizzle: {\n\t\tinsert: (t: unknown) => {\n\t\t\tvalues: (v: unknown) => { onConflictDoUpdate: (c: unknown) => Promise<unknown> }\n\t\t}\n\t}\n\ttables: Record<string, Record<string, unknown>>\n\ttableNameMap: Map<string, string>\n}\n\nconst ZERO: Record<RollupMetric, number> = {\n\tpageviews: 0,\n\tevents: 0,\n\tdurationMs: 0,\n\tsamples: 0,\n\tvisitors: 0,\n\tsessions: 0,\n}\n\n// Always seed every metric on insert: Payload's defaultValue is applied app-side, not as\n// a SQL default, so a raw insert that omits a NOT NULL metric column would fail on Postgres.\nexport async function bumpRollup(\n\tpayload: Payload,\n\tkey: RollupKey,\n\tinc: Partial<Record<RollupMetric, number>>\n): Promise<void> {\n\tif (payload.db.name === 'mongoose') {\n\t\tconst db = payload.db as unknown as MongoDb\n\t\tconst model = db.collections[ROLLUPS_SLUG]\n\t\tif (!model) throw new Error(`analytics: mongoose collection \"${ROLLUPS_SLUG}\" not found`)\n\t\tconst setOnInsert: Record<string, unknown> = { ...key }\n\t\tfor (const [metric, zero] of Object.entries(ZERO)) {\n\t\t\tif (!(metric in inc)) setOnInsert[metric] = zero\n\t\t}\n\t\tawait model.collection.updateOne(\n\t\t\tkey,\n\t\t\t{ $inc: inc, $setOnInsert: setOnInsert },\n\t\t\t{ upsert: true }\n\t\t)\n\t\treturn\n\t}\n\tconst { sql } = await importPostgresSql()\n\tconst db = payload.db as unknown as PgDb\n\tconst tableName = db.tableNameMap.get(PG_TABLE_KEY)\n\tif (!tableName) throw new Error(`analytics: drizzle table \"${PG_TABLE_KEY}\" not found`)\n\tconst table = db.tables[tableName]\n\tif (!table) throw new Error(`analytics: drizzle table object for \"${tableName}\" not found`)\n\tconst set: Record<string, unknown> = {}\n\tfor (const [metric, amount] of Object.entries(inc)) {\n\t\tset[metric] = sql`${table[metric]} + ${amount}`\n\t}\n\t// The conflict target must match the unique index exactly, which includes the\n\t// scope column only in scoped installs (mirrored by a scope key on RollupKey).\n\tconst target = [table.granularity, table.period, table.path, table.dimension, table.dimvalue]\n\tif (key.scope !== undefined) {\n\t\ttarget.push(table.scope)\n\t}\n\tawait db.drizzle\n\t\t.insert(table)\n\t\t.values({ ...key, ...ZERO, ...inc })\n\t\t.onConflictDoUpdate({ target, set })\n}\n"],"mappings":";;AAIA,MAAM,eAAe;;;;;;;;;AAYrB,MAAM,0BAAsD;CAE3D,OAAO;;;;EADW,CAAC,eAAe,aAAa,EAAE,KAAK,GAE4B;;AAEnF;AAsBA,MAAM,OAAqC;CAC1C,WAAW;CACX,QAAQ;CACR,YAAY;CACZ,SAAS;CACT,UAAU;CACV,UAAU;AACX;AAIA,eAAsB,WACrB,SACA,KACA,KACgB;CAChB,IAAI,QAAQ,GAAG,SAAS,YAAY;EAEnC,MAAM,QADK,QAAQ,GACF,YAAY;EAC7B,IAAI,CAAC,OAAO,MAAM,IAAI,MAAM,mCAAmC,aAAa,YAAY;EACxF,MAAM,cAAuC,EAAE,GAAG,IAAI;EACtD,KAAK,MAAM,CAAC,QAAQ,SAAS,OAAO,QAAQ,IAAI,GAC/C,IAAI,EAAE,UAAU,MAAM,YAAY,UAAU;EAE7C,MAAM,MAAM,WAAW,UACtB,KACA;GAAE,MAAM;GAAK,cAAc;EAAY,GACvC,EAAE,QAAQ,KAAK,CAChB;EACA;CACD;CACA,MAAM,EAAE,QAAQ,MAAM,kBAAkB;CACxC,MAAM,KAAK,QAAQ;CACnB,MAAM,YAAY,GAAG,aAAa,IAAI,YAAY;CAClD,IAAI,CAAC,WAAW,MAAM,IAAI,MAAM,6BAA6B,aAAa,YAAY;CACtF,MAAM,QAAQ,GAAG,OAAO;CACxB,IAAI,CAAC,OAAO,MAAM,IAAI,MAAM,wCAAwC,UAAU,YAAY;CAC1F,MAAM,MAA+B,CAAC;CACtC,KAAK,MAAM,CAAC,QAAQ,WAAW,OAAO,QAAQ,GAAG,GAChD,IAAI,UAAU,GAAG,GAAG,MAAM,QAAQ,KAAK;CAIxC,MAAM,SAAS;EAAC,MAAM;EAAa,MAAM;EAAQ,MAAM;EAAM,MAAM;EAAW,MAAM;CAAQ;CAC5F,IAAI,IAAI,UAAU,KAAA,GACjB,OAAO,KAAK,MAAM,KAAK;CAExB,MAAM,GAAG,QACP,OAAO,KAAK,EACZ,OAAO;EAAE,GAAG;EAAK,GAAG;EAAM,GAAG;CAAI,CAAC,EAClC,mBAAmB;EAAE;EAAQ;CAAI,CAAC;AACrC"}
|
|
@@ -1,7 +1,7 @@
|
|
|
1
|
+
import { startOfDayInTz } from "../../timeframe/tz.js";
|
|
1
2
|
//#region src/native/rollups/deltas.ts
|
|
2
|
-
const startOfUtcDay = (d) => new Date(Date.UTC(d.getUTCFullYear(), d.getUTCMonth(), d.getUTCDate()));
|
|
3
3
|
function computeRollupDeltas(event) {
|
|
4
|
-
const period =
|
|
4
|
+
const period = startOfDayInTz(event.timestamp, event.timezone);
|
|
5
5
|
const inc = {
|
|
6
6
|
pageviews: event.type === "pageview" ? 1 : 0,
|
|
7
7
|
events: event.type === "event" ? 1 : 0,
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"deltas.js","names":[],"sources":["../../../src/native/rollups/deltas.ts"],"sourcesContent":["import 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\
|
|
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"}
|
|
@@ -0,0 +1,80 @@
|
|
|
1
|
+
import { getRuntime } from "./runtime.js";
|
|
2
|
+
import { TIMEFRAME_PRESETS } from "../timeframe/presets.js";
|
|
3
|
+
import { readForField } from "../fields/readForDocument.js";
|
|
4
|
+
import { METRIC_KEYS } from "../translations/metricKeys.js";
|
|
5
|
+
import "./paths.js";
|
|
6
|
+
//#region src/plugin/documentEndpoint.ts
|
|
7
|
+
const KNOWN_METRICS = new Set(Object.keys(METRIC_KEYS));
|
|
8
|
+
const MAX_METRICS = 8;
|
|
9
|
+
const parseMetrics = (raw) => {
|
|
10
|
+
if (!raw) return null;
|
|
11
|
+
const metrics = raw.split(",").map((m) => m.trim()).filter((m) => KNOWN_METRICS.has(m));
|
|
12
|
+
return metrics.length > 0 ? metrics.slice(0, MAX_METRICS) : null;
|
|
13
|
+
};
|
|
14
|
+
const parseRange = (from, to) => {
|
|
15
|
+
if (!from || !to) return null;
|
|
16
|
+
const start = new Date(from);
|
|
17
|
+
const end = new Date(to);
|
|
18
|
+
if (Number.isNaN(start.getTime()) || Number.isNaN(end.getTime()) || start >= end) return null;
|
|
19
|
+
return {
|
|
20
|
+
start,
|
|
21
|
+
end
|
|
22
|
+
};
|
|
23
|
+
};
|
|
24
|
+
/**
|
|
25
|
+
* Authenticated GET handler behind the interactive document analytics panel. The
|
|
26
|
+
* caller must be able to read the target document (enforced through `findByID`
|
|
27
|
+
* without `overrideAccess`), so analytics never leak for content the user cannot
|
|
28
|
+
* see; an unreadable or missing document is a uniform 404. Timeframe, metrics, and
|
|
29
|
+
* data source are whitelist-validated; `timeframe=custom` requires a parseable
|
|
30
|
+
* `from`/`to` pair.
|
|
31
|
+
*/
|
|
32
|
+
const makeDocumentHandler = () => async (req) => {
|
|
33
|
+
if (!req.user) return Response.json({ error: "unauthorized" }, { status: 401 });
|
|
34
|
+
const runtime = getRuntime(req.payload);
|
|
35
|
+
if (!runtime) return Response.json({ error: "unavailable" }, { status: 503 });
|
|
36
|
+
const params = new URL(req.url ?? "", "http://localhost").searchParams;
|
|
37
|
+
const collection = params.get("collection") ?? "";
|
|
38
|
+
const id = params.get("id") ?? "";
|
|
39
|
+
if (!runtime.bindings[collection] || !id) return Response.json({ error: "not found" }, { status: 404 });
|
|
40
|
+
const rawTimeframe = params.get("timeframe") ?? "last30days";
|
|
41
|
+
const range = rawTimeframe === "custom" ? parseRange(params.get("from"), params.get("to")) : void 0;
|
|
42
|
+
const timeframe = TIMEFRAME_PRESETS.includes(rawTimeframe) ? rawTimeframe : "last30days";
|
|
43
|
+
if (rawTimeframe === "custom" && !range) return Response.json({ error: "invalid range" }, { status: 400 });
|
|
44
|
+
const metrics = parseMetrics(params.get("metrics")) ?? [
|
|
45
|
+
"pageviews",
|
|
46
|
+
"visitors",
|
|
47
|
+
"sessions",
|
|
48
|
+
"avgDuration"
|
|
49
|
+
];
|
|
50
|
+
let data;
|
|
51
|
+
try {
|
|
52
|
+
data = await req.payload.findByID({
|
|
53
|
+
collection,
|
|
54
|
+
id,
|
|
55
|
+
depth: 0,
|
|
56
|
+
overrideAccess: false,
|
|
57
|
+
user: req.user,
|
|
58
|
+
req
|
|
59
|
+
});
|
|
60
|
+
} catch {
|
|
61
|
+
return Response.json({ error: "not found" }, { status: 404 });
|
|
62
|
+
}
|
|
63
|
+
const result = await readForField({
|
|
64
|
+
req,
|
|
65
|
+
collectionSlug: collection,
|
|
66
|
+
data,
|
|
67
|
+
metrics,
|
|
68
|
+
timeframe,
|
|
69
|
+
range: range ?? void 0,
|
|
70
|
+
adapterId: params.get("dataSource") ?? void 0,
|
|
71
|
+
now: /* @__PURE__ */ new Date(),
|
|
72
|
+
compare: params.get("compare") === "1",
|
|
73
|
+
series: params.get("series") === "1"
|
|
74
|
+
});
|
|
75
|
+
return Response.json(result);
|
|
76
|
+
};
|
|
77
|
+
//#endregion
|
|
78
|
+
export { makeDocumentHandler };
|
|
79
|
+
|
|
80
|
+
//# sourceMappingURL=documentEndpoint.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"documentEndpoint.js","names":[],"sources":["../../src/plugin/documentEndpoint.ts"],"sourcesContent":["import type { CollectionSlug, PayloadHandler } from 'payload'\nimport type { BindingDoc } from '../binding/types'\nimport type { DateRange, MetricKey } from '../core/contract'\nimport { readForField } from '../fields/readForDocument'\nimport { TIMEFRAME_PRESETS, type TimeframePreset } from '../timeframe/presets'\nimport { METRIC_KEYS } from '../translations/metricKeys'\nimport { DOCUMENT_PATH } from './paths'\nimport { getRuntime } from './runtime'\n\nexport { DOCUMENT_PATH }\n\nconst KNOWN_METRICS = new Set(Object.keys(METRIC_KEYS) as MetricKey[])\nconst MAX_METRICS = 8\n\nconst parseMetrics = (raw: string | null): MetricKey[] | null => {\n\tif (!raw) {\n\t\treturn null\n\t}\n\tconst metrics = raw\n\t\t.split(',')\n\t\t.map((m) => m.trim())\n\t\t.filter((m): m is MetricKey => KNOWN_METRICS.has(m as MetricKey))\n\treturn metrics.length > 0 ? metrics.slice(0, MAX_METRICS) : null\n}\n\nconst parseRange = (from: string | null, to: string | null): DateRange | null => {\n\tif (!from || !to) {\n\t\treturn null\n\t}\n\tconst start = new Date(from)\n\tconst end = new Date(to)\n\tif (Number.isNaN(start.getTime()) || Number.isNaN(end.getTime()) || start >= end) {\n\t\treturn null\n\t}\n\treturn { start, end }\n}\n\n/**\n * Authenticated GET handler behind the interactive document analytics panel. The\n * caller must be able to read the target document (enforced through `findByID`\n * without `overrideAccess`), so analytics never leak for content the user cannot\n * see; an unreadable or missing document is a uniform 404. Timeframe, metrics, and\n * data source are whitelist-validated; `timeframe=custom` requires a parseable\n * `from`/`to` pair.\n */\nexport const makeDocumentHandler = (): 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({ error: 'unavailable' }, { status: 503 })\n\t}\n\tconst params = new URL(req.url ?? '', 'http://localhost').searchParams\n\tconst collection = params.get('collection') ?? ''\n\tconst id = params.get('id') ?? ''\n\tif (!runtime.bindings[collection] || !id) {\n\t\treturn Response.json({ error: 'not found' }, { status: 404 })\n\t}\n\tconst rawTimeframe = params.get('timeframe') ?? 'last30days'\n\tconst range =\n\t\trawTimeframe === 'custom' ? parseRange(params.get('from'), params.get('to')) : undefined\n\tconst timeframe: TimeframePreset = TIMEFRAME_PRESETS.includes(rawTimeframe as TimeframePreset)\n\t\t? (rawTimeframe as TimeframePreset)\n\t\t: 'last30days'\n\tif (rawTimeframe === 'custom' && !range) {\n\t\treturn Response.json({ error: 'invalid range' }, { status: 400 })\n\t}\n\tconst metrics = parseMetrics(params.get('metrics')) ?? [\n\t\t'pageviews',\n\t\t'visitors',\n\t\t'sessions',\n\t\t'avgDuration',\n\t]\n\tlet data: BindingDoc\n\ttry {\n\t\tdata = (await req.payload.findByID({\n\t\t\tcollection: collection as CollectionSlug,\n\t\t\tid,\n\t\t\tdepth: 0,\n\t\t\toverrideAccess: false,\n\t\t\tuser: req.user,\n\t\t\treq,\n\t\t})) as BindingDoc\n\t} catch {\n\t\treturn Response.json({ error: 'not found' }, { status: 404 })\n\t}\n\tconst result = await readForField({\n\t\treq,\n\t\tcollectionSlug: collection,\n\t\tdata,\n\t\tmetrics,\n\t\ttimeframe,\n\t\trange: range ?? undefined,\n\t\tadapterId: params.get('dataSource') ?? undefined,\n\t\tnow: new Date(),\n\t\tcompare: params.get('compare') === '1',\n\t\tseries: params.get('series') === '1',\n\t})\n\treturn Response.json(result)\n}\n"],"mappings":";;;;;;AAWA,MAAM,gBAAgB,IAAI,IAAI,OAAO,KAAK,WAAW,CAAgB;AACrE,MAAM,cAAc;AAEpB,MAAM,gBAAgB,QAA2C;CAChE,IAAI,CAAC,KACJ,OAAO;CAER,MAAM,UAAU,IACd,MAAM,GAAG,EACT,KAAK,MAAM,EAAE,KAAK,CAAC,EACnB,QAAQ,MAAsB,cAAc,IAAI,CAAc,CAAC;CACjE,OAAO,QAAQ,SAAS,IAAI,QAAQ,MAAM,GAAG,WAAW,IAAI;AAC7D;AAEA,MAAM,cAAc,MAAqB,OAAwC;CAChF,IAAI,CAAC,QAAQ,CAAC,IACb,OAAO;CAER,MAAM,QAAQ,IAAI,KAAK,IAAI;CAC3B,MAAM,MAAM,IAAI,KAAK,EAAE;CACvB,IAAI,OAAO,MAAM,MAAM,QAAQ,CAAC,KAAK,OAAO,MAAM,IAAI,QAAQ,CAAC,KAAK,SAAS,KAC5E,OAAO;CAER,OAAO;EAAE;EAAO;CAAI;AACrB;;;;;;;;;AAUA,MAAa,4BAA4C,OAAO,QAAQ;CACvE,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,OAAO,cAAc,GAAG,EAAE,QAAQ,IAAI,CAAC;CAE/D,MAAM,SAAS,IAAI,IAAI,IAAI,OAAO,IAAI,kBAAkB,EAAE;CAC1D,MAAM,aAAa,OAAO,IAAI,YAAY,KAAK;CAC/C,MAAM,KAAK,OAAO,IAAI,IAAI,KAAK;CAC/B,IAAI,CAAC,QAAQ,SAAS,eAAe,CAAC,IACrC,OAAO,SAAS,KAAK,EAAE,OAAO,YAAY,GAAG,EAAE,QAAQ,IAAI,CAAC;CAE7D,MAAM,eAAe,OAAO,IAAI,WAAW,KAAK;CAChD,MAAM,QACL,iBAAiB,WAAW,WAAW,OAAO,IAAI,MAAM,GAAG,OAAO,IAAI,IAAI,CAAC,IAAI,KAAA;CAChF,MAAM,YAA6B,kBAAkB,SAAS,YAA+B,IACzF,eACD;CACH,IAAI,iBAAiB,YAAY,CAAC,OACjC,OAAO,SAAS,KAAK,EAAE,OAAO,gBAAgB,GAAG,EAAE,QAAQ,IAAI,CAAC;CAEjE,MAAM,UAAU,aAAa,OAAO,IAAI,SAAS,CAAC,KAAK;EACtD;EACA;EACA;EACA;CACD;CACA,IAAI;CACJ,IAAI;EACH,OAAQ,MAAM,IAAI,QAAQ,SAAS;GACtB;GACZ;GACA,OAAO;GACP,gBAAgB;GAChB,MAAM,IAAI;GACV;EACD,CAAC;CACF,QAAQ;EACP,OAAO,SAAS,KAAK,EAAE,OAAO,YAAY,GAAG,EAAE,QAAQ,IAAI,CAAC;CAC7D;CACA,MAAM,SAAS,MAAM,aAAa;EACjC;EACA,gBAAgB;EAChB;EACA;EACA;EACA,OAAO,SAAS,KAAA;EAChB,WAAW,OAAO,IAAI,YAAY,KAAK,KAAA;EACvC,qBAAK,IAAI,KAAK;EACd,SAAS,OAAO,IAAI,SAAS,MAAM;EACnC,QAAQ,OAAO,IAAI,QAAQ,MAAM;CAClC,CAAC;CACD,OAAO,SAAS,KAAK,MAAM;AAC5B"}
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
//#region src/plugin/paths.ts
|
|
2
|
+
/**
|
|
3
|
+
* Endpoint paths shared between server registration and client fetchers. Kept in a
|
|
4
|
+
* dependency-free leaf module so client components can import the path without
|
|
5
|
+
* pulling server code into the bundle.
|
|
6
|
+
*/
|
|
7
|
+
const DOCUMENT_PATH = "/analytics/document";
|
|
8
|
+
//#endregion
|
|
9
|
+
export { DOCUMENT_PATH };
|
|
10
|
+
|
|
11
|
+
//# sourceMappingURL=paths.js.map
|
|
@@ -0,0 +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"}
|
package/dist/plugin/runtime.js
CHANGED
|
@@ -12,9 +12,10 @@ const setRuntime = (payload, runtime) => {
|
|
|
12
12
|
};
|
|
13
13
|
const getRuntime = (payload) => payload[RUNTIME_KEY];
|
|
14
14
|
const resolveScopeFor = (runtime, req) => runtime.resolveScope?.(req) ?? Promise.resolve(null);
|
|
15
|
+
const resolveTimezoneFor = (runtime, req, scope) => runtime.resolveTimezone?.(req, scope) ?? Promise.resolve("UTC");
|
|
15
16
|
const resolveRegistryFor = (runtime, args) => runtime.resolveRegistry?.(args) ?? Promise.resolve(runtime.registry);
|
|
16
17
|
const platformReadFor = async (runtime, req) => runtime.platformRead ? await runtime.platformRead({ req }) : Boolean(req.user);
|
|
17
18
|
//#endregion
|
|
18
|
-
export { getRuntime, platformReadFor, resolveRegistryFor, resolveScopeFor, setRuntime };
|
|
19
|
+
export { getRuntime, platformReadFor, resolveRegistryFor, resolveScopeFor, resolveTimezoneFor, setRuntime };
|
|
19
20
|
|
|
20
21
|
//# sourceMappingURL=runtime.js.map
|
|
@@ -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'\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/** 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\tttl: { aggregate
|
|
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"}
|
package/dist/plugin/warmTask.js
CHANGED
|
@@ -1,9 +1,9 @@
|
|
|
1
1
|
import { TIMEFRAME_PRESETS } from "../timeframe/presets.js";
|
|
2
|
+
import { readForWidgetSeries } from "../widgets/readForWidgetSeries.js";
|
|
2
3
|
import { breakdownSpecBySlug } from "../widgets/breakdownTypes.js";
|
|
3
4
|
import { resolveCustomRange } from "../widgets/range.js";
|
|
4
5
|
import { readForWidget } from "../widgets/readForWidget.js";
|
|
5
6
|
import { readForWidgetBreakdown } from "../widgets/readForWidgetBreakdown.js";
|
|
6
|
-
import { readForWidgetSeries } from "../widgets/readForWidgetSeries.js";
|
|
7
7
|
import { WIDGET_METRICS } from "../widgets/types.js";
|
|
8
8
|
//#region src/plugin/warmTask.ts
|
|
9
9
|
const asString = (v) => typeof v === "string" ? v : void 0;
|
package/dist/surfacing/engine.js
CHANGED
|
@@ -1,15 +1,15 @@
|
|
|
1
|
+
import { startOfDayInTz } from "../timeframe/tz.js";
|
|
1
2
|
import { buildCacheKey } from "../core/cacheKey.js";
|
|
2
3
|
import { createCoalescer } from "./coalesce.js";
|
|
3
4
|
import { createQueue } from "./queue.js";
|
|
4
5
|
//#region src/surfacing/engine.ts
|
|
5
6
|
const DAY_MS = 864e5;
|
|
6
|
-
const
|
|
7
|
-
const clampRange = (range, maxLookbackDays) => {
|
|
7
|
+
const clampRange = (range, maxLookbackDays, tz = "UTC") => {
|
|
8
8
|
if (maxLookbackDays == null) return {
|
|
9
9
|
range,
|
|
10
10
|
clamped: false
|
|
11
11
|
};
|
|
12
|
-
const floor = /* @__PURE__ */ new Date(
|
|
12
|
+
const floor = /* @__PURE__ */ new Date(startOfDayInTz(range.end, tz).getTime() - maxLookbackDays * DAY_MS);
|
|
13
13
|
if (range.start.getTime() >= floor.getTime()) return {
|
|
14
14
|
range,
|
|
15
15
|
clamped: false
|
|
@@ -34,7 +34,7 @@ function createEngine(opts) {
|
|
|
34
34
|
const queue = createQueue(opts.queue);
|
|
35
35
|
return { async read(adapter, query) {
|
|
36
36
|
if (!adapter.isConfigured()) return emptyResult(adapter.id, query);
|
|
37
|
-
const { range, clamped } = clampRange(query.dateRange, adapter.capabilities.maxLookbackDays);
|
|
37
|
+
const { range, clamped } = clampRange(query.dateRange, adapter.capabilities.maxLookbackDays, query.timezone);
|
|
38
38
|
const q = clamped ? {
|
|
39
39
|
...query,
|
|
40
40
|
dateRange: range
|
|
@@ -51,7 +51,7 @@ function createEngine(opts) {
|
|
|
51
51
|
clamped: true
|
|
52
52
|
}
|
|
53
53
|
} : fresh;
|
|
54
|
-
const ttl =
|
|
54
|
+
const ttl = opts.ttl.aggregate ?? adapter.capabilities.recommendedTtl.aggregate;
|
|
55
55
|
await opts.store.set(key, result, ttl);
|
|
56
56
|
return result;
|
|
57
57
|
});
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"engine.js","names":[],"sources":["../../src/surfacing/engine.ts"],"sourcesContent":["import { buildCacheKey } from '../core/cacheKey'\nimport type { AnalyticsAdapter, AnalyticsQuery, AnalyticsResult } from '../core/contract'\nimport type { CacheStore } from './cacheStore'\nimport { createCoalescer } from './coalesce'\nimport { createQueue, type QueueOptions } from './queue'\n\nconst DAY_MS = 86_400_000\
|
|
1
|
+
{"version":3,"file":"engine.js","names":[],"sources":["../../src/surfacing/engine.ts"],"sourcesContent":["import { buildCacheKey } from '../core/cacheKey'\nimport type { AnalyticsAdapter, AnalyticsQuery, AnalyticsResult } from '../core/contract'\nimport { DEFAULT_TIMEZONE, startOfDayInTz } from '../timeframe/tz'\nimport type { CacheStore } from './cacheStore'\nimport { createCoalescer } from './coalesce'\nimport { createQueue, type QueueOptions } from './queue'\n\nconst DAY_MS = 86_400_000\n\nconst clampRange = (\n\trange: AnalyticsQuery['dateRange'],\n\tmaxLookbackDays: number | null,\n\ttz: string = DEFAULT_TIMEZONE\n): { range: AnalyticsQuery['dateRange']; clamped: boolean } => {\n\tif (maxLookbackDays == null) {\n\t\treturn { range, clamped: false }\n\t}\n\tconst floor = new Date(startOfDayInTz(range.end, tz).getTime() - maxLookbackDays * DAY_MS)\n\tif (range.start.getTime() >= floor.getTime()) {\n\t\treturn { range, clamped: false }\n\t}\n\treturn { range: { start: floor, end: range.end }, clamped: true }\n}\n\nexport interface EngineOptions {\n\tstore: CacheStore\n\tqueue: QueueOptions\n\t/** Explicit TTL overrides; when a value is unset the adapter's recommendedTtl applies. */\n\tttl: { aggregate?: number; realtime?: number }\n}\n\nexport interface Engine {\n\tread(adapter: AnalyticsAdapter, query: AnalyticsQuery): Promise<AnalyticsResult>\n}\n\nconst emptyResult = (provider: string, q: AnalyticsQuery): AnalyticsResult => ({\n\trows: [],\n\tmeta: { provider, fetchedAt: q.dateRange.end.toISOString() },\n})\n\nexport function createEngine(opts: EngineOptions): Engine {\n\tconst coalesce = createCoalescer<AnalyticsResult>()\n\tconst queue = createQueue(opts.queue)\n\n\treturn {\n\t\tasync read(adapter, query) {\n\t\t\tif (!adapter.isConfigured()) return emptyResult(adapter.id, query)\n\n\t\t\tconst { range, clamped } = clampRange(\n\t\t\t\tquery.dateRange,\n\t\t\t\tadapter.capabilities.maxLookbackDays,\n\t\t\t\tquery.timezone\n\t\t\t)\n\t\t\tconst q = clamped ? { ...query, dateRange: range } : query\n\t\t\tconst key = buildCacheKey(adapter.id, q)\n\t\t\treturn coalesce(key, async () => {\n\t\t\t\tconst cached = await opts.store.get<AnalyticsResult>(key)\n\t\t\t\tif (cached) return cached\n\n\t\t\t\tconst fresh = await queue.run(() => adapter.query(q, {}))\n\t\t\t\tconst result: AnalyticsResult = clamped\n\t\t\t\t\t? { ...fresh, meta: { ...fresh.meta, clamped: true } }\n\t\t\t\t\t: fresh\n\t\t\t\tconst ttl = opts.ttl.aggregate ?? adapter.capabilities.recommendedTtl.aggregate\n\t\t\t\tawait opts.store.set(key, result, ttl)\n\t\t\t\treturn result\n\t\t\t})\n\t\t},\n\t}\n}\n"],"mappings":";;;;;AAOA,MAAM,SAAS;AAEf,MAAM,cACL,OACA,iBACA,KAAA,UAC8D;CAC9D,IAAI,mBAAmB,MACtB,OAAO;EAAE;EAAO,SAAS;CAAM;CAEhC,MAAM,wBAAQ,IAAI,KAAK,eAAe,MAAM,KAAK,EAAE,EAAE,QAAQ,IAAI,kBAAkB,MAAM;CACzF,IAAI,MAAM,MAAM,QAAQ,KAAK,MAAM,QAAQ,GAC1C,OAAO;EAAE;EAAO,SAAS;CAAM;CAEhC,OAAO;EAAE,OAAO;GAAE,OAAO;GAAO,KAAK,MAAM;EAAI;EAAG,SAAS;CAAK;AACjE;AAaA,MAAM,eAAe,UAAkB,OAAwC;CAC9E,MAAM,CAAC;CACP,MAAM;EAAE;EAAU,WAAW,EAAE,UAAU,IAAI,YAAY;CAAE;AAC5D;AAEA,SAAgB,aAAa,MAA6B;CACzD,MAAM,WAAW,gBAAiC;CAClD,MAAM,QAAQ,YAAY,KAAK,KAAK;CAEpC,OAAO,EACN,MAAM,KAAK,SAAS,OAAO;EAC1B,IAAI,CAAC,QAAQ,aAAa,GAAG,OAAO,YAAY,QAAQ,IAAI,KAAK;EAEjE,MAAM,EAAE,OAAO,YAAY,WAC1B,MAAM,WACN,QAAQ,aAAa,iBACrB,MAAM,QACP;EACA,MAAM,IAAI,UAAU;GAAE,GAAG;GAAO,WAAW;EAAM,IAAI;EACrD,MAAM,MAAM,cAAc,QAAQ,IAAI,CAAC;EACvC,OAAO,SAAS,KAAK,YAAY;GAChC,MAAM,SAAS,MAAM,KAAK,MAAM,IAAqB,GAAG;GACxD,IAAI,QAAQ,OAAO;GAEnB,MAAM,QAAQ,MAAM,MAAM,UAAU,QAAQ,MAAM,GAAG,CAAC,CAAC,CAAC;GACxD,MAAM,SAA0B,UAC7B;IAAE,GAAG;IAAO,MAAM;KAAE,GAAG,MAAM;KAAM,SAAS;IAAK;GAAE,IACnD;GACH,MAAM,MAAM,KAAK,IAAI,aAAa,QAAQ,aAAa,eAAe;GACtE,MAAM,KAAK,MAAM,IAAI,KAAK,QAAQ,GAAG;GACrC,OAAO;EACR,CAAC;CACF,EACD;AACD"}
|
package/dist/sync/collection.js
CHANGED
|
@@ -9,15 +9,20 @@ const METRIC_FIELDS = [
|
|
|
9
9
|
];
|
|
10
10
|
/**
|
|
11
11
|
* The sync tier's queryable collection: one row per (source, date) of a provider's daily
|
|
12
|
-
* metrics.
|
|
13
|
-
*
|
|
14
|
-
*
|
|
15
|
-
*
|
|
16
|
-
*
|
|
12
|
+
* metrics. It is read-only and machine-written (writes are locked to the sync job, which
|
|
13
|
+
* uses overrideAccess), and hidden from the admin nav by default because it is a query
|
|
14
|
+
* substrate for custom reporting rather than something to browse and edit; pass
|
|
15
|
+
* `sync: { hidden: false }` to surface it. `admin.hidden` only hides the nav entry, so
|
|
16
|
+
* 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.
|
|
17
21
|
*/
|
|
18
|
-
const syncCollection = (slug) => ({
|
|
22
|
+
const syncCollection = (slug, hidden = true) => ({
|
|
19
23
|
slug,
|
|
20
24
|
admin: {
|
|
25
|
+
hidden,
|
|
21
26
|
useAsTitle: "source",
|
|
22
27
|
defaultColumns: [
|
|
23
28
|
"source",
|
|
@@ -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.
|
|
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"}
|
package/dist/sync/syncTask.js
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
|
-
import { getRuntime, resolveRegistryFor, resolveScopeFor } from "../plugin/runtime.js";
|
|
2
1
|
import { supportsGranularity } from "../core/granularity.js";
|
|
2
|
+
import { getRuntime, resolveRegistryFor, resolveScopeFor } from "../plugin/runtime.js";
|
|
3
3
|
import { METRIC_FIELDS } from "./collection.js";
|
|
4
4
|
//#region src/sync/syncTask.ts
|
|
5
5
|
const SYNC_TASK_SLUG = "analytics-sync";
|
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
import { addDaysInTz, startOfDayInTz, startOfMonthInTz, startOfYearInTz } from "./tz.js";
|
|
1
2
|
//#region src/timeframe/presets.ts
|
|
2
3
|
const TIMEFRAME_PRESETS = [
|
|
3
4
|
"today",
|
|
@@ -9,46 +10,41 @@ const TIMEFRAME_PRESETS = [
|
|
|
9
10
|
"lastYear",
|
|
10
11
|
"allTime"
|
|
11
12
|
];
|
|
12
|
-
const startOfUtcDay = (d) => new Date(Date.UTC(d.getUTCFullYear(), d.getUTCMonth(), d.getUTCDate()));
|
|
13
|
-
const daysBack = (d, days) => {
|
|
14
|
-
const start = startOfUtcDay(d);
|
|
15
|
-
start.setUTCDate(start.getUTCDate() - days);
|
|
16
|
-
return start;
|
|
17
|
-
};
|
|
18
13
|
/**
|
|
19
14
|
* Resolve a relative timeframe preset to an absolute `DateRange`. `now` is injected
|
|
20
|
-
* so callers stay deterministic. `end` is `now`; `start` is the
|
|
21
|
-
* window
|
|
15
|
+
* so callers stay deterministic. `end` is `now`; `start` is the day floor of the
|
|
16
|
+
* window in `tz` (defaulting to UTC, so day boundaries align with the reporting
|
|
17
|
+
* timezone). Inclusive day windows count the current day (`last7days` = today plus 6).
|
|
22
18
|
*/
|
|
23
|
-
const resolveTimeframe = (preset, now) => {
|
|
19
|
+
const resolveTimeframe = (preset, now, tz = "UTC") => {
|
|
24
20
|
const end = new Date(now);
|
|
25
21
|
switch (preset) {
|
|
26
22
|
case "today": return {
|
|
27
|
-
start:
|
|
23
|
+
start: startOfDayInTz(now, tz),
|
|
28
24
|
end
|
|
29
25
|
};
|
|
30
26
|
case "last7days": return {
|
|
31
|
-
start:
|
|
27
|
+
start: addDaysInTz(now, -6, tz),
|
|
32
28
|
end
|
|
33
29
|
};
|
|
34
30
|
case "last30days": return {
|
|
35
|
-
start:
|
|
31
|
+
start: addDaysInTz(now, -29, tz),
|
|
36
32
|
end
|
|
37
33
|
};
|
|
38
34
|
case "last90days": return {
|
|
39
|
-
start:
|
|
35
|
+
start: addDaysInTz(now, -89, tz),
|
|
40
36
|
end
|
|
41
37
|
};
|
|
42
38
|
case "thisMonth": return {
|
|
43
|
-
start:
|
|
39
|
+
start: startOfMonthInTz(now, tz),
|
|
44
40
|
end
|
|
45
41
|
};
|
|
46
42
|
case "thisYear": return {
|
|
47
|
-
start:
|
|
43
|
+
start: startOfYearInTz(now, tz),
|
|
48
44
|
end
|
|
49
45
|
};
|
|
50
46
|
case "lastYear": return {
|
|
51
|
-
start:
|
|
47
|
+
start: addDaysInTz(now, -364, tz),
|
|
52
48
|
end
|
|
53
49
|
};
|
|
54
50
|
case "allTime": return {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"presets.js","names":[],"sources":["../../src/timeframe/presets.ts"],"sourcesContent":["import type { DateRange } from '../core/contract'\n\nexport const TIMEFRAME_PRESETS = [\n\t'today',\n\t'last7days',\n\t'last30days',\n\t'last90days',\n\t'thisMonth',\n\t'thisYear',\n\t'lastYear',\n\t'allTime',\n] as const\n\nexport type TimeframePreset = (typeof TIMEFRAME_PRESETS)[number]\n\
|
|
1
|
+
{"version":3,"file":"presets.js","names":[],"sources":["../../src/timeframe/presets.ts"],"sourcesContent":["import type { DateRange } from '../core/contract'\nimport {\n\taddDaysInTz,\n\tDEFAULT_TIMEZONE,\n\tstartOfDayInTz,\n\tstartOfMonthInTz,\n\tstartOfYearInTz,\n} from './tz'\n\nexport const TIMEFRAME_PRESETS = [\n\t'today',\n\t'last7days',\n\t'last30days',\n\t'last90days',\n\t'thisMonth',\n\t'thisYear',\n\t'lastYear',\n\t'allTime',\n] as const\n\nexport type TimeframePreset = (typeof TIMEFRAME_PRESETS)[number]\n\n/**\n * Resolve a relative timeframe preset to an absolute `DateRange`. `now` is injected\n * so callers stay deterministic. `end` is `now`; `start` is the day floor of the\n * window in `tz` (defaulting to UTC, so day boundaries align with the reporting\n * timezone). Inclusive day windows count the current day (`last7days` = today plus 6).\n */\nexport const resolveTimeframe = (\n\tpreset: TimeframePreset,\n\tnow: Date,\n\ttz: string = DEFAULT_TIMEZONE\n): DateRange => {\n\tconst end = new Date(now)\n\tswitch (preset) {\n\t\tcase 'today':\n\t\t\treturn { start: startOfDayInTz(now, tz), end }\n\t\tcase 'last7days':\n\t\t\treturn { start: addDaysInTz(now, -6, tz), end }\n\t\tcase 'last30days':\n\t\t\treturn { start: addDaysInTz(now, -29, tz), end }\n\t\tcase 'last90days':\n\t\t\treturn { start: addDaysInTz(now, -89, tz), end }\n\t\tcase 'thisMonth':\n\t\t\treturn { start: startOfMonthInTz(now, tz), end }\n\t\tcase 'thisYear':\n\t\t\treturn { start: startOfYearInTz(now, tz), end }\n\t\tcase 'lastYear':\n\t\t\treturn { start: addDaysInTz(now, -364, tz), end }\n\t\tcase 'allTime':\n\t\t\treturn { start: new Date(0), end }\n\t}\n}\n"],"mappings":";;AASA,MAAa,oBAAoB;CAChC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACD;;;;;;;AAUA,MAAa,oBACZ,QACA,KACA,KAAA,UACe;CACf,MAAM,MAAM,IAAI,KAAK,GAAG;CACxB,QAAQ,QAAR;EACC,KAAK,SACJ,OAAO;GAAE,OAAO,eAAe,KAAK,EAAE;GAAG;EAAI;EAC9C,KAAK,aACJ,OAAO;GAAE,OAAO,YAAY,KAAK,IAAI,EAAE;GAAG;EAAI;EAC/C,KAAK,cACJ,OAAO;GAAE,OAAO,YAAY,KAAK,KAAK,EAAE;GAAG;EAAI;EAChD,KAAK,cACJ,OAAO;GAAE,OAAO,YAAY,KAAK,KAAK,EAAE;GAAG;EAAI;EAChD,KAAK,aACJ,OAAO;GAAE,OAAO,iBAAiB,KAAK,EAAE;GAAG;EAAI;EAChD,KAAK,YACJ,OAAO;GAAE,OAAO,gBAAgB,KAAK,EAAE;GAAG;EAAI;EAC/C,KAAK,YACJ,OAAO;GAAE,OAAO,YAAY,KAAK,MAAM,EAAE;GAAG;EAAI;EACjD,KAAK,WACJ,OAAO;GAAE,uBAAO,IAAI,KAAK,CAAC;GAAG;EAAI;CACnC;AACD"}
|
|
@@ -0,0 +1,110 @@
|
|
|
1
|
+
const formatterCache = /* @__PURE__ */ new Map();
|
|
2
|
+
const partsFormatter = (tz) => {
|
|
3
|
+
let formatter = formatterCache.get(tz);
|
|
4
|
+
if (!formatter) {
|
|
5
|
+
formatter = new Intl.DateTimeFormat("en-US", {
|
|
6
|
+
timeZone: tz,
|
|
7
|
+
hourCycle: "h23",
|
|
8
|
+
year: "numeric",
|
|
9
|
+
month: "2-digit",
|
|
10
|
+
day: "2-digit",
|
|
11
|
+
hour: "2-digit",
|
|
12
|
+
minute: "2-digit",
|
|
13
|
+
second: "2-digit"
|
|
14
|
+
});
|
|
15
|
+
formatterCache.set(tz, formatter);
|
|
16
|
+
}
|
|
17
|
+
return formatter;
|
|
18
|
+
};
|
|
19
|
+
/** Wall-clock parts `date` maps to in `tz`. */
|
|
20
|
+
const zonedParts = (date, tz) => {
|
|
21
|
+
const map = {};
|
|
22
|
+
for (const part of partsFormatter(tz).formatToParts(date)) if (part.type !== "literal") map[part.type] = part.value;
|
|
23
|
+
return {
|
|
24
|
+
year: Number(map.year),
|
|
25
|
+
month: Number(map.month),
|
|
26
|
+
day: Number(map.day),
|
|
27
|
+
hour: Number(map.hour),
|
|
28
|
+
minute: Number(map.minute),
|
|
29
|
+
second: Number(map.second)
|
|
30
|
+
};
|
|
31
|
+
};
|
|
32
|
+
/** Milliseconds `tz` is ahead of UTC at `date` (positive east of UTC). */
|
|
33
|
+
const offsetMs = (date, tz) => {
|
|
34
|
+
const p = zonedParts(date, tz);
|
|
35
|
+
return Date.UTC(p.year, p.month - 1, p.day, p.hour, p.minute, p.second) - Math.floor(date.getTime() / 1e3) * 1e3;
|
|
36
|
+
};
|
|
37
|
+
const sameLocalDay = (date, ymd, tz) => {
|
|
38
|
+
const p = zonedParts(date, tz);
|
|
39
|
+
return p.year === ymd.year && p.month === ymd.month && p.day === ymd.day;
|
|
40
|
+
};
|
|
41
|
+
/**
|
|
42
|
+
* The first instant of a wall-clock calendar date in `tz`. Usually local midnight; when a
|
|
43
|
+
* spring-forward transition lands exactly at midnight (Chile, Cuba) the 00:00 wall clock
|
|
44
|
+
* does not exist and the refinement below oscillates between the pre- and post-transition
|
|
45
|
+
* offsets, so the candidate that still falls on `ymd` (the transition instant, local
|
|
46
|
+
* 01:00) is taken instead of the refined one that fell back onto the previous day.
|
|
47
|
+
*/
|
|
48
|
+
const zonedMidnight = (ymd, tz) => {
|
|
49
|
+
const asUtc = Date.UTC(ymd.year, ymd.month - 1, ymd.day);
|
|
50
|
+
const guess = new Date(asUtc - offsetMs(new Date(asUtc), tz));
|
|
51
|
+
const refined = new Date(asUtc - offsetMs(guess, tz));
|
|
52
|
+
if (sameLocalDay(refined, ymd, tz)) return refined;
|
|
53
|
+
if (sameLocalDay(guess, ymd, tz)) return guess;
|
|
54
|
+
return zonedMidnight(zonedParts(refined.getTime() > guess.getTime() ? refined : guess, tz), tz);
|
|
55
|
+
};
|
|
56
|
+
/** Start of `date`'s local day in `tz`. */
|
|
57
|
+
const startOfDayInTz = (date, tz = "UTC") => {
|
|
58
|
+
return zonedMidnight(zonedParts(date, tz), tz);
|
|
59
|
+
};
|
|
60
|
+
/** Start of `date`'s local month in `tz`. */
|
|
61
|
+
const startOfMonthInTz = (date, tz = "UTC") => {
|
|
62
|
+
const p = zonedParts(date, tz);
|
|
63
|
+
return zonedMidnight({
|
|
64
|
+
year: p.year,
|
|
65
|
+
month: p.month,
|
|
66
|
+
day: 1
|
|
67
|
+
}, tz);
|
|
68
|
+
};
|
|
69
|
+
/** Start of `date`'s local year in `tz`. */
|
|
70
|
+
const startOfYearInTz = (date, tz = "UTC") => {
|
|
71
|
+
return zonedMidnight({
|
|
72
|
+
year: zonedParts(date, tz).year,
|
|
73
|
+
month: 1,
|
|
74
|
+
day: 1
|
|
75
|
+
}, tz);
|
|
76
|
+
};
|
|
77
|
+
/**
|
|
78
|
+
* Add `days` calendar days to `date`'s local day in `tz`, returning the resulting day
|
|
79
|
+
* start. The +12h buffer before re-flooring absorbs 23/25-hour DST days so stepping
|
|
80
|
+
* never lands short of, or past, the intended calendar day.
|
|
81
|
+
*/
|
|
82
|
+
const addDaysInTz = (date, days, tz = "UTC") => {
|
|
83
|
+
const start = startOfDayInTz(date, tz);
|
|
84
|
+
return startOfDayInTz(new Date(start.getTime() + days * 864e5 + 432e5), tz);
|
|
85
|
+
};
|
|
86
|
+
/**
|
|
87
|
+
* Start of the ISO week (Monday) containing `date`'s local day in `tz`. The weekday of a
|
|
88
|
+
* calendar Y-M-D is timezone-independent, so it is derived from the zoned date and the
|
|
89
|
+
* step back to Monday runs through `addDaysInTz` to stay DST-safe.
|
|
90
|
+
*/
|
|
91
|
+
const startOfWeekInTz = (date, tz = "UTC") => {
|
|
92
|
+
const p = zonedParts(date, tz);
|
|
93
|
+
const mondayIndex = (new Date(Date.UTC(p.year, p.month - 1, p.day)).getUTCDay() + 6) % 7;
|
|
94
|
+
return addDaysInTz(startOfDayInTz(date, tz), -mondayIndex, tz);
|
|
95
|
+
};
|
|
96
|
+
/** ISO string of `date`'s local day start in `tz`; the canonical day-bucket key. */
|
|
97
|
+
const zonedDayIso = (date, tz = "UTC") => startOfDayInTz(date, tz).toISOString();
|
|
98
|
+
/** True when `tz` is a resolvable IANA identifier. */
|
|
99
|
+
const isValidTimeZone = (tz) => {
|
|
100
|
+
try {
|
|
101
|
+
new Intl.DateTimeFormat("en-US", { timeZone: tz });
|
|
102
|
+
return true;
|
|
103
|
+
} catch {
|
|
104
|
+
return false;
|
|
105
|
+
}
|
|
106
|
+
};
|
|
107
|
+
//#endregion
|
|
108
|
+
export { addDaysInTz, isValidTimeZone, startOfDayInTz, startOfMonthInTz, startOfWeekInTz, startOfYearInTz, zonedDayIso };
|
|
109
|
+
|
|
110
|
+
//# sourceMappingURL=tz.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"tz.js","names":[],"sources":["../../src/timeframe/tz.ts"],"sourcesContent":["/**\n * IANA-timezone day math, built on `Intl.DateTimeFormat` so there is no dependency.\n * All reporting boundaries (timeframe windows, series axes, native rollup buckets,\n * cache-key day snaps) resolve through these helpers. `startOfDayInTz(d, 'UTC')` is\n * exactly the previous `Date.UTC(...)` day floor, so the default path is unchanged.\n */\n\nexport const DEFAULT_TIMEZONE = 'UTC'\n\ninterface ZonedParts {\n\tyear: number\n\tmonth: number\n\tday: number\n\thour: number\n\tminute: number\n\tsecond: number\n}\n\n// Constructing Intl.DateTimeFormat dominates the cost of these helpers (~14x), and they\n// run per event at ingest and in series loops, so formatters are cached per zone.\nconst formatterCache = new Map<string, Intl.DateTimeFormat>()\n\nconst partsFormatter = (tz: string): Intl.DateTimeFormat => {\n\tlet formatter = formatterCache.get(tz)\n\tif (!formatter) {\n\t\tformatter = new Intl.DateTimeFormat('en-US', {\n\t\t\ttimeZone: tz,\n\t\t\thourCycle: 'h23',\n\t\t\tyear: 'numeric',\n\t\t\tmonth: '2-digit',\n\t\t\tday: '2-digit',\n\t\t\thour: '2-digit',\n\t\t\tminute: '2-digit',\n\t\t\tsecond: '2-digit',\n\t\t})\n\t\tformatterCache.set(tz, formatter)\n\t}\n\treturn formatter\n}\n\n/** Wall-clock parts `date` maps to in `tz`. */\nconst zonedParts = (date: Date, tz: string): ZonedParts => {\n\tconst map: Record<string, string> = {}\n\tfor (const part of partsFormatter(tz).formatToParts(date)) {\n\t\tif (part.type !== 'literal') {\n\t\t\tmap[part.type] = part.value\n\t\t}\n\t}\n\treturn {\n\t\tyear: Number(map.year),\n\t\tmonth: Number(map.month),\n\t\tday: Number(map.day),\n\t\thour: Number(map.hour),\n\t\tminute: Number(map.minute),\n\t\tsecond: Number(map.second),\n\t}\n}\n\n/** Milliseconds `tz` is ahead of UTC at `date` (positive east of UTC). */\nconst offsetMs = (date: Date, tz: string): number => {\n\tconst p = zonedParts(date, tz)\n\tconst asUtc = Date.UTC(p.year, p.month - 1, p.day, p.hour, p.minute, p.second)\n\t// formatToParts drops sub-second precision, so compare against the truncated instant.\n\treturn asUtc - Math.floor(date.getTime() / 1000) * 1000\n}\n\nconst sameLocalDay = (\n\tdate: Date,\n\tymd: { year: number; month: number; day: number },\n\ttz: string\n): boolean => {\n\tconst p = zonedParts(date, tz)\n\treturn p.year === ymd.year && p.month === ymd.month && p.day === ymd.day\n}\n\n/**\n * The first instant of a wall-clock calendar date in `tz`. Usually local midnight; when a\n * spring-forward transition lands exactly at midnight (Chile, Cuba) the 00:00 wall clock\n * does not exist and the refinement below oscillates between the pre- and post-transition\n * offsets, so the candidate that still falls on `ymd` (the transition instant, local\n * 01:00) is taken instead of the refined one that fell back onto the previous day.\n */\nconst zonedMidnight = (ymd: { year: number; month: number; day: number }, tz: string): Date => {\n\tconst asUtc = Date.UTC(ymd.year, ymd.month - 1, ymd.day)\n\tconst guess = new Date(asUtc - offsetMs(new Date(asUtc), tz))\n\tconst refined = new Date(asUtc - offsetMs(guess, tz))\n\tif (sameLocalDay(refined, ymd, tz)) {\n\t\treturn refined\n\t}\n\tif (sameLocalDay(guess, ymd, tz)) {\n\t\treturn guess\n\t}\n\t// Neither candidate lands on ymd (the calendar date was skipped entirely, e.g. a\n\t// dateline change): fall forward to the later candidate's day start.\n\tconst later = refined.getTime() > guess.getTime() ? refined : guess\n\treturn zonedMidnight(zonedParts(later, tz), tz)\n}\n\n/** Start of `date`'s local day in `tz`. */\nexport const startOfDayInTz = (date: Date, tz: string = DEFAULT_TIMEZONE): Date => {\n\tconst p = zonedParts(date, tz)\n\treturn zonedMidnight(p, tz)\n}\n\n/** Start of `date`'s local month in `tz`. */\nexport const startOfMonthInTz = (date: Date, tz: string = DEFAULT_TIMEZONE): Date => {\n\tconst p = zonedParts(date, tz)\n\treturn zonedMidnight({ year: p.year, month: p.month, day: 1 }, tz)\n}\n\n/** Start of `date`'s local year in `tz`. */\nexport const startOfYearInTz = (date: Date, tz: string = DEFAULT_TIMEZONE): Date => {\n\tconst p = zonedParts(date, tz)\n\treturn zonedMidnight({ year: p.year, month: 1, day: 1 }, tz)\n}\n\n/**\n * Add `days` calendar days to `date`'s local day in `tz`, returning the resulting day\n * start. The +12h buffer before re-flooring absorbs 23/25-hour DST days so stepping\n * never lands short of, or past, the intended calendar day.\n */\nexport const addDaysInTz = (date: Date, days: number, tz: string = DEFAULT_TIMEZONE): Date => {\n\tconst start = startOfDayInTz(date, tz)\n\treturn startOfDayInTz(new Date(start.getTime() + days * 86_400_000 + 43_200_000), tz)\n}\n\n/**\n * Start of the ISO week (Monday) containing `date`'s local day in `tz`. The weekday of a\n * calendar Y-M-D is timezone-independent, so it is derived from the zoned date and the\n * step back to Monday runs through `addDaysInTz` to stay DST-safe.\n */\nexport const startOfWeekInTz = (date: Date, tz: string = DEFAULT_TIMEZONE): Date => {\n\tconst p = zonedParts(date, tz)\n\tconst dow = new Date(Date.UTC(p.year, p.month - 1, p.day)).getUTCDay()\n\tconst mondayIndex = (dow + 6) % 7\n\treturn addDaysInTz(startOfDayInTz(date, tz), -mondayIndex, tz)\n}\n\n/** ISO string of `date`'s local day start in `tz`; the canonical day-bucket key. */\nexport const zonedDayIso = (date: Date, tz: string = DEFAULT_TIMEZONE): string =>\n\tstartOfDayInTz(date, tz).toISOString()\n\n/** True when `tz` is a resolvable IANA identifier. */\nexport const isValidTimeZone = (tz: string): boolean => {\n\ttry {\n\t\tnew Intl.DateTimeFormat('en-US', { timeZone: tz })\n\t\treturn true\n\t} catch {\n\t\treturn false\n\t}\n}\n"],"mappings":"AAoBA,MAAM,iCAAiB,IAAI,IAAiC;AAE5D,MAAM,kBAAkB,OAAoC;CAC3D,IAAI,YAAY,eAAe,IAAI,EAAE;CACrC,IAAI,CAAC,WAAW;EACf,YAAY,IAAI,KAAK,eAAe,SAAS;GAC5C,UAAU;GACV,WAAW;GACX,MAAM;GACN,OAAO;GACP,KAAK;GACL,MAAM;GACN,QAAQ;GACR,QAAQ;EACT,CAAC;EACD,eAAe,IAAI,IAAI,SAAS;CACjC;CACA,OAAO;AACR;;AAGA,MAAM,cAAc,MAAY,OAA2B;CAC1D,MAAM,MAA8B,CAAC;CACrC,KAAK,MAAM,QAAQ,eAAe,EAAE,EAAE,cAAc,IAAI,GACvD,IAAI,KAAK,SAAS,WACjB,IAAI,KAAK,QAAQ,KAAK;CAGxB,OAAO;EACN,MAAM,OAAO,IAAI,IAAI;EACrB,OAAO,OAAO,IAAI,KAAK;EACvB,KAAK,OAAO,IAAI,GAAG;EACnB,MAAM,OAAO,IAAI,IAAI;EACrB,QAAQ,OAAO,IAAI,MAAM;EACzB,QAAQ,OAAO,IAAI,MAAM;CAC1B;AACD;;AAGA,MAAM,YAAY,MAAY,OAAuB;CACpD,MAAM,IAAI,WAAW,MAAM,EAAE;CAG7B,OAFc,KAAK,IAAI,EAAE,MAAM,EAAE,QAAQ,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAE5D,IAAI,KAAK,MAAM,KAAK,QAAQ,IAAI,GAAI,IAAI;AACpD;AAEA,MAAM,gBACL,MACA,KACA,OACa;CACb,MAAM,IAAI,WAAW,MAAM,EAAE;CAC7B,OAAO,EAAE,SAAS,IAAI,QAAQ,EAAE,UAAU,IAAI,SAAS,EAAE,QAAQ,IAAI;AACtE;;;;;;;;AASA,MAAM,iBAAiB,KAAmD,OAAqB;CAC9F,MAAM,QAAQ,KAAK,IAAI,IAAI,MAAM,IAAI,QAAQ,GAAG,IAAI,GAAG;CACvD,MAAM,QAAQ,IAAI,KAAK,QAAQ,SAAS,IAAI,KAAK,KAAK,GAAG,EAAE,CAAC;CAC5D,MAAM,UAAU,IAAI,KAAK,QAAQ,SAAS,OAAO,EAAE,CAAC;CACpD,IAAI,aAAa,SAAS,KAAK,EAAE,GAChC,OAAO;CAER,IAAI,aAAa,OAAO,KAAK,EAAE,GAC9B,OAAO;CAKR,OAAO,cAAc,WADP,QAAQ,QAAQ,IAAI,MAAM,QAAQ,IAAI,UAAU,OACvB,EAAE,GAAG,EAAE;AAC/C;;AAGA,MAAa,kBAAkB,MAAY,KAAA,UAAwC;CAElF,OAAO,cADG,WAAW,MAAM,EACN,GAAG,EAAE;AAC3B;;AAGA,MAAa,oBAAoB,MAAY,KAAA,UAAwC;CACpF,MAAM,IAAI,WAAW,MAAM,EAAE;CAC7B,OAAO,cAAc;EAAE,MAAM,EAAE;EAAM,OAAO,EAAE;EAAO,KAAK;CAAE,GAAG,EAAE;AAClE;;AAGA,MAAa,mBAAmB,MAAY,KAAA,UAAwC;CAEnF,OAAO,cAAc;EAAE,MADb,WAAW,MAAM,EACE,EAAE;EAAM,OAAO;EAAG,KAAK;CAAE,GAAG,EAAE;AAC5D;;;;;;AAOA,MAAa,eAAe,MAAY,MAAc,KAAA,UAAwC;CAC7F,MAAM,QAAQ,eAAe,MAAM,EAAE;CACrC,OAAO,eAAe,IAAI,KAAK,MAAM,QAAQ,IAAI,OAAO,QAAa,KAAU,GAAG,EAAE;AACrF;;;;;;AAOA,MAAa,mBAAmB,MAAY,KAAA,UAAwC;CACnF,MAAM,IAAI,WAAW,MAAM,EAAE;CAE7B,MAAM,eADM,IAAI,KAAK,KAAK,IAAI,EAAE,MAAM,EAAE,QAAQ,GAAG,EAAE,GAAG,CAAC,EAAE,UACpC,IAAI,KAAK;CAChC,OAAO,YAAY,eAAe,MAAM,EAAE,GAAG,CAAC,aAAa,EAAE;AAC9D;;AAGA,MAAa,eAAe,MAAY,KAAA,UACvC,eAAe,MAAM,EAAE,EAAE,YAAY;;AAGtC,MAAa,mBAAmB,OAAwB;CACvD,IAAI;EACH,IAAI,KAAK,eAAe,SAAS,EAAE,UAAU,GAAG,CAAC;EACjD,OAAO;CACR,QAAQ;EACP,OAAO;CACR;AACD"}
|
|
@@ -0,0 +1,78 @@
|
|
|
1
|
+
import { keys } from "./keys.js";
|
|
2
|
+
//#region src/translations/de.ts
|
|
3
|
+
/** German values, keyed by the same typed constants as `en.ts`. */
|
|
4
|
+
const de = {
|
|
5
|
+
[keys.pluginName]: "Analytics",
|
|
6
|
+
[keys.tabAnalytics]: "Analytics",
|
|
7
|
+
[keys.metricPageviews]: "Seitenaufrufe",
|
|
8
|
+
[keys.metricVisitors]: "Besucher",
|
|
9
|
+
[keys.metricSessions]: "Sitzungen",
|
|
10
|
+
[keys.metricEvents]: "Ereignisse",
|
|
11
|
+
[keys.metricAvgDuration]: "Ø Verweildauer",
|
|
12
|
+
[keys.metricBounceRate]: "Absprungrate",
|
|
13
|
+
[keys.metricScrollDepth]: "Scrolltiefe",
|
|
14
|
+
[keys.metricConversions]: "Conversions",
|
|
15
|
+
[keys.metricRevenue]: "Umsatz",
|
|
16
|
+
[keys.stateNoData]: "Noch keine Analysedaten",
|
|
17
|
+
[keys.stateNew]: "Neu",
|
|
18
|
+
[keys.stateNotBound]: "Analytics für diese Kollektion nicht konfiguriert",
|
|
19
|
+
[keys.stateNotConfigured]: "Analytics-Anbieter verbinden",
|
|
20
|
+
[keys.stateUnavailable]: "Für diese Datenquelle nicht verfügbar",
|
|
21
|
+
[keys.timeframeToday]: "Heute",
|
|
22
|
+
[keys.timeframeLast7Days]: "Letzte 7 Tage",
|
|
23
|
+
[keys.timeframeLast30Days]: "Letzte 30 Tage",
|
|
24
|
+
[keys.timeframeLast90Days]: "Letzte 90 Tage",
|
|
25
|
+
[keys.timeframeThisMonth]: "Aktueller Monat",
|
|
26
|
+
[keys.timeframeThisYear]: "Aktuelles Jahr",
|
|
27
|
+
[keys.timeframeLastYear]: "Letztes Jahr",
|
|
28
|
+
[keys.timeframeAllTime]: "Gesamter Zeitraum",
|
|
29
|
+
[keys.widgetMetricLabel]: "Kennzahl",
|
|
30
|
+
[keys.widgetTrendLabel]: "Verlauf",
|
|
31
|
+
[keys.widgetBreakdownPages]: "Top-Seiten",
|
|
32
|
+
[keys.widgetBreakdownSources]: "Top-Quellen",
|
|
33
|
+
[keys.widgetBreakdownDevices]: "Geräte",
|
|
34
|
+
[keys.widgetBreakdownCountries]: "Länder",
|
|
35
|
+
[keys.widgetFieldLimit]: "Zeilen",
|
|
36
|
+
[keys.stateNoBreakdown]: "Noch keine Daten",
|
|
37
|
+
[keys.stateClamped]: "Zeigt den maximalen Zeitraum des Anbieters",
|
|
38
|
+
[keys.widgetFieldTitle]: "Titel",
|
|
39
|
+
[keys.widgetFieldMetric]: "Kennzahl",
|
|
40
|
+
[keys.widgetFieldTimeframe]: "Zeitraum",
|
|
41
|
+
[keys.widgetFieldDataSource]: "Datenquelle",
|
|
42
|
+
[keys.widgetFieldTitlePlaceholder]: "z. B. Tägliche Seitenaufrufe",
|
|
43
|
+
[keys.widgetTimeframeCustom]: "Benutzerdefinierter Zeitraum",
|
|
44
|
+
[keys.widgetFieldRange]: "Datumsbereich",
|
|
45
|
+
[keys.dateRangePlaceholder]: "Datumsbereich auswählen...",
|
|
46
|
+
[keys.widgetFieldWindow]: "Fenster",
|
|
47
|
+
[keys.widgetRealtimeLabel]: "Gerade aktiv",
|
|
48
|
+
[keys.widgetRealtimeCaption]: "gerade aktiv",
|
|
49
|
+
[keys.widgetRealtimePaused]: "Live-Updates pausiert",
|
|
50
|
+
[keys.comparisonVsPrevious]: "vs. vorheriger Zeitraum",
|
|
51
|
+
[keys.comparisonIncrease]: "Gestiegen",
|
|
52
|
+
[keys.comparisonDecrease]: "Gesunken",
|
|
53
|
+
[keys.comparisonNoChange]: "Keine Änderung",
|
|
54
|
+
[keys.providersCollectionSingular]: "Analytics-Anbieter",
|
|
55
|
+
[keys.providersCollectionPlural]: "Analytics-Anbieter",
|
|
56
|
+
[keys.providerFieldProvider]: "Anbieter",
|
|
57
|
+
[keys.providerFieldEnabled]: "Aktiviert",
|
|
58
|
+
[keys.providerFieldScope]: "Bereich",
|
|
59
|
+
[keys.providerFieldSiteId]: "Website-ID",
|
|
60
|
+
[keys.providerFieldApiKey]: "API-Schlüssel",
|
|
61
|
+
[keys.providerFieldHost]: "Host",
|
|
62
|
+
[keys.providerFieldHostHelp]: "Leer lassen für Standard-Cloud des Anbieters",
|
|
63
|
+
[keys.providerFieldWebsiteId]: "Website-ID",
|
|
64
|
+
[keys.providerFieldToken]: "API-Token",
|
|
65
|
+
[keys.providerFieldPropertyId]: "Property-ID",
|
|
66
|
+
[keys.providerFieldClientEmail]: "Client-E-Mail",
|
|
67
|
+
[keys.providerFieldPrivateKey]: "Privater Schlüssel",
|
|
68
|
+
[keys.providerFieldProjectId]: "Projekt-ID",
|
|
69
|
+
[keys.providerSecretHelp]: "Nach dem Speichern maskiert angezeigt; neuen Wert eingeben zum Ersetzen",
|
|
70
|
+
[keys.providerNamePlausible]: "Plausible",
|
|
71
|
+
[keys.providerNameUmami]: "Umami",
|
|
72
|
+
[keys.providerNameGa4]: "Google Analytics 4",
|
|
73
|
+
[keys.providerNamePosthog]: "PostHog"
|
|
74
|
+
};
|
|
75
|
+
//#endregion
|
|
76
|
+
export { de };
|
|
77
|
+
|
|
78
|
+
//# sourceMappingURL=de.js.map
|