@10x-media/analytics 1.0.0-beta.7 → 1.0.0-beta.8
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 +48 -0
- package/README.md +8 -2
- package/dist/adapters/ga4/ga4.js +3 -2
- package/dist/adapters/ga4/ga4.js.map +1 -1
- package/dist/adapters/plausible/plausible.js +2 -1
- package/dist/adapters/plausible/plausible.js.map +1 -1
- package/dist/capture/slots.js +16 -5
- package/dist/capture/slots.js.map +1 -1
- package/dist/capture/trackerConfig.d.ts +1 -0
- package/dist/capture/trackerConfig.js +28 -3
- package/dist/capture/trackerConfig.js.map +1 -1
- package/dist/charts/BarList.d.ts +15 -1
- package/dist/charts/BarList.js +34 -18
- package/dist/charts/BarList.js.map +1 -1
- package/dist/charts/TrendChart.d.ts +16 -3
- package/dist/charts/TrendChart.js +172 -106
- package/dist/charts/TrendChart.js.map +1 -1
- package/dist/charts/bars.d.ts +2 -0
- package/dist/charts/bars.js +2 -1
- package/dist/charts/bars.js.map +1 -1
- package/dist/charts/bucket.js +10 -1
- package/dist/charts/bucket.js.map +1 -1
- package/dist/charts/spline.js +2 -2
- package/dist/charts/spline.js.map +1 -1
- package/dist/charts/styles.js +18 -1
- package/dist/charts/styles.js.map +1 -1
- package/dist/core/cacheKey.js +13 -1
- package/dist/core/cacheKey.js.map +1 -1
- package/dist/core/contract.d.ts +14 -7
- package/dist/core/contract.js +29 -1
- package/dist/core/contract.js.map +1 -1
- package/dist/core/granularity.js +1 -1
- package/dist/core/options.d.ts +54 -5
- package/dist/core/options.js +59 -2
- package/dist/core/options.js.map +1 -1
- package/dist/core/scopedRead.js +33 -23
- package/dist/core/scopedRead.js.map +1 -1
- package/dist/core/serverEvent.d.ts +42 -0
- package/dist/core/serverEvent.js +12 -0
- package/dist/core/serverEvent.js.map +1 -0
- package/dist/exports/client.d.ts +8 -2
- package/dist/exports/client.js +6 -1
- package/dist/exports/rsc.d.ts +5 -1
- package/dist/exports/rsc.js +6 -3
- package/dist/exports/types.d.ts +12 -4
- package/dist/exports/types.js +2 -2
- package/dist/fields/AnalyticsPanelClient.js +1 -1
- package/dist/fields/AnalyticsPanelField.js +1 -1
- package/dist/fields/AnalyticsStatField.js +2 -2
- package/dist/fields/config/MetricSelectField.js +2 -2
- package/dist/fields/config/MetricSelectField.js.map +1 -1
- package/dist/fields/config/SourceSelectField.js +2 -2
- package/dist/fields/config/SourceSelectField.js.map +1 -1
- package/dist/fields/config/fetchSources.d.ts +5 -1
- package/dist/fields/readForDocument.d.ts +5 -0
- package/dist/fields/readForDocument.js +5 -5
- package/dist/fields/readForDocument.js.map +1 -1
- package/dist/goals/GoalSelectField.d.ts +7 -0
- package/dist/goals/GoalSelectField.js +77 -0
- package/dist/goals/GoalSelectField.js.map +1 -0
- package/dist/goals/collection.js +250 -0
- package/dist/goals/collection.js.map +1 -0
- package/dist/goals/currency.js +14 -0
- package/dist/goals/currency.js.map +1 -0
- package/dist/goals/fetchGoals.d.ts +18 -0
- package/dist/goals/fetchGoals.js +29 -0
- package/dist/goals/fetchGoals.js.map +1 -0
- package/dist/goals/goalField.d.ts +31 -0
- package/dist/goals/goalField.js +56 -0
- package/dist/goals/goalField.js.map +1 -0
- package/dist/goals/goalsEndpoint.d.ts +1 -0
- package/dist/goals/goalsEndpoint.js +55 -0
- package/dist/goals/goalsEndpoint.js.map +1 -0
- package/dist/goals/resolver.d.ts +8 -0
- package/dist/goals/resolver.js +147 -0
- package/dist/goals/resolver.js.map +1 -0
- package/dist/goals/trackGoalAction.d.ts +74 -0
- package/dist/goals/trackGoalAction.js +139 -0
- package/dist/goals/trackGoalAction.js.map +1 -0
- package/dist/goals/useAnalyticsGoals.d.ts +20 -0
- package/dist/goals/useAnalyticsGoals.js +67 -0
- package/dist/goals/useAnalyticsGoals.js.map +1 -0
- package/dist/index.d.ts +10 -3
- package/dist/index.js +74 -11
- package/dist/index.js.map +1 -1
- package/dist/native/ingest/device.js +11 -3
- package/dist/native/ingest/device.js.map +1 -1
- package/dist/native/ingest/endpoint.d.ts +1 -0
- package/dist/native/ingest/endpoint.js +2 -17
- package/dist/native/ingest/endpoint.js.map +1 -1
- package/dist/native/ingest/normalizeEvent.d.ts +20 -0
- package/dist/native/ingest/normalizeEvent.js +3 -2
- package/dist/native/ingest/normalizeEvent.js.map +1 -1
- package/dist/native/ingest/serverTrack.d.ts +20 -0
- package/dist/native/ingest/serverTrack.js +99 -0
- package/dist/native/ingest/serverTrack.js.map +1 -0
- package/dist/native/ingest/validate.js +27 -0
- package/dist/native/ingest/validate.js.map +1 -0
- package/dist/native/nativeAdapter.d.ts +1 -1
- package/dist/native/nativeAdapter.js +21 -10
- package/dist/native/nativeAdapter.js.map +1 -1
- package/dist/native/retention/pruneTask.js +1 -1
- package/dist/native/rollups/insertIfNew.js +36 -2
- package/dist/native/rollups/insertIfNew.js.map +1 -1
- package/dist/plugin/documentEndpoint.js +27 -9
- package/dist/plugin/documentEndpoint.js.map +1 -1
- package/dist/plugin/paths.js +5 -1
- package/dist/plugin/paths.js.map +1 -1
- package/dist/plugin/queryEndpoint.js +113 -0
- package/dist/plugin/queryEndpoint.js.map +1 -0
- package/dist/plugin/readContextForRequest.js +71 -0
- package/dist/plugin/readContextForRequest.js.map +1 -0
- package/dist/plugin/realtimeEndpoint.js +6 -3
- package/dist/plugin/realtimeEndpoint.js.map +1 -1
- package/dist/plugin/runtime.js +31 -1
- package/dist/plugin/runtime.js.map +1 -1
- package/dist/plugin/scopeFieldBoot.js +22 -0
- package/dist/plugin/scopeFieldBoot.js.map +1 -0
- package/dist/plugin/sourcesEndpoint.js +13 -51
- package/dist/plugin/sourcesEndpoint.js.map +1 -1
- package/dist/plugin/warmTask.js +0 -0
- package/dist/plugin/warmTask.js.map +1 -1
- package/dist/providers/collection.js +15 -9
- package/dist/providers/collection.js.map +1 -1
- package/dist/providers/resolver.js.map +1 -1
- package/dist/query/dates.js +64 -0
- package/dist/query/dates.js.map +1 -0
- package/dist/query/errors.d.ts +17 -0
- package/dist/query/errors.js +10 -0
- package/dist/query/errors.js.map +1 -0
- package/dist/query/fetchQuery.d.ts +59 -0
- package/dist/query/fetchQuery.js +110 -0
- package/dist/query/fetchQuery.js.map +1 -0
- package/dist/query/parse.d.ts +22 -0
- package/dist/query/parse.js +168 -0
- package/dist/query/parse.js.map +1 -0
- package/dist/query/response.d.ts +36 -0
- package/dist/timeframe/tz.js +17 -6
- package/dist/timeframe/tz.js.map +1 -1
- package/dist/translations/ar.js +98 -1
- package/dist/translations/ar.js.map +1 -1
- package/dist/translations/de.js +98 -1
- package/dist/translations/de.js.map +1 -1
- package/dist/translations/en.js +98 -1
- package/dist/translations/en.js.map +1 -1
- package/dist/translations/es.js +98 -1
- package/dist/translations/es.js.map +1 -1
- package/dist/translations/fr.js +98 -1
- package/dist/translations/fr.js.map +1 -1
- package/dist/translations/id.js +98 -1
- package/dist/translations/id.js.map +1 -1
- package/dist/translations/keys.d.ts +97 -0
- package/dist/translations/keys.js +98 -1
- package/dist/translations/keys.js.map +1 -1
- package/dist/translations/ko.js +98 -1
- package/dist/translations/ko.js.map +1 -1
- package/dist/translations/metricKeys.js +1 -1
- package/dist/translations/metricKeys.js.map +1 -1
- package/dist/translations/pt.js +98 -1
- package/dist/translations/pt.js.map +1 -1
- package/dist/translations/ru.js +98 -1
- package/dist/translations/ru.js.map +1 -1
- package/dist/translations/uk.js +98 -1
- package/dist/translations/uk.js.map +1 -1
- package/dist/translations/zh.js +98 -1
- package/dist/translations/zh.js.map +1 -1
- package/dist/view/AnalyticsNavLink.d.ts +19 -0
- package/dist/view/AnalyticsNavLink.js +40 -0
- package/dist/view/AnalyticsNavLink.js.map +1 -0
- package/dist/view/AnalyticsView.d.ts +23 -0
- package/dist/view/AnalyticsView.js +45 -0
- package/dist/view/AnalyticsView.js.map +1 -0
- package/dist/view/AnalyticsViewClient.d.ts +15 -0
- package/dist/view/AnalyticsViewClient.js +189 -0
- package/dist/view/AnalyticsViewClient.js.map +1 -0
- package/dist/view/authRedirect.js +32 -0
- package/dist/view/authRedirect.js.map +1 -0
- package/dist/view/conversionRate.js +18 -0
- package/dist/view/conversionRate.js.map +1 -0
- package/dist/view/dayRange.js +68 -0
- package/dist/view/dayRange.js.map +1 -0
- package/dist/view/gating.d.ts +1 -0
- package/dist/view/gating.js +105 -0
- package/dist/view/gating.js.map +1 -0
- package/dist/view/labels.js +44 -0
- package/dist/view/labels.js.map +1 -0
- package/dist/view/registerView.js +48 -0
- package/dist/view/registerView.js.map +1 -0
- package/dist/view/sections/Breakdowns.js +157 -0
- package/dist/view/sections/Breakdowns.js.map +1 -0
- package/dist/view/sections/EmptyStates.js +92 -0
- package/dist/view/sections/EmptyStates.js.map +1 -0
- package/dist/view/sections/FilterChips.js +41 -0
- package/dist/view/sections/FilterChips.js.map +1 -0
- package/dist/view/sections/GoalsPanel.js +81 -0
- package/dist/view/sections/GoalsPanel.js.map +1 -0
- package/dist/view/sections/OverviewCards.js +65 -0
- package/dist/view/sections/OverviewCards.js.map +1 -0
- package/dist/view/sections/RealtimeStrip.js +77 -0
- package/dist/view/sections/RealtimeStrip.js.map +1 -0
- package/dist/view/sections/Toolbar.js +179 -0
- package/dist/view/sections/Toolbar.js.map +1 -0
- package/dist/view/sections/Trend.js +119 -0
- package/dist/view/sections/Trend.js.map +1 -0
- package/dist/view/sections/styles.js +74 -0
- package/dist/view/sections/styles.js.map +1 -0
- package/dist/view/state.js +206 -0
- package/dist/view/state.js.map +1 -0
- package/dist/view/useViewQueries.js +150 -0
- package/dist/view/useViewQueries.js.map +1 -0
- package/dist/view/viewProps.d.ts +40 -0
- package/dist/view/viewProps.js +90 -0
- package/dist/view/viewProps.js.map +1 -0
- package/dist/widgets/AnalyticsBreakdownWidget.d.ts +2 -1
- package/dist/widgets/AnalyticsBreakdownWidget.js +22 -4
- package/dist/widgets/AnalyticsBreakdownWidget.js.map +1 -1
- package/dist/widgets/AnalyticsGoalsWidget.d.ts +14 -0
- package/dist/widgets/AnalyticsGoalsWidget.js +188 -0
- package/dist/widgets/AnalyticsGoalsWidget.js.map +1 -0
- package/dist/widgets/AnalyticsMetricWidget.d.ts +2 -1
- package/dist/widgets/AnalyticsMetricWidget.js +35 -12
- package/dist/widgets/AnalyticsMetricWidget.js.map +1 -1
- package/dist/widgets/AnalyticsRealtimeWidget.d.ts +2 -1
- package/dist/widgets/AnalyticsRealtimeWidget.js +42 -22
- package/dist/widgets/AnalyticsRealtimeWidget.js.map +1 -1
- package/dist/widgets/AnalyticsTrendWidget.d.ts +2 -1
- package/dist/widgets/AnalyticsTrendWidget.js +51 -15
- package/dist/widgets/AnalyticsTrendWidget.js.map +1 -1
- package/dist/widgets/WidgetViewLink.js +17 -0
- package/dist/widgets/WidgetViewLink.js.map +1 -0
- package/dist/widgets/breakdownTypes.js +28 -1
- package/dist/widgets/breakdownTypes.js.map +1 -1
- package/dist/widgets/cardChrome.js +31 -7
- package/dist/widgets/cardChrome.js.map +1 -1
- package/dist/widgets/range.js +43 -12
- package/dist/widgets/range.js.map +1 -1
- package/dist/widgets/readForWidget.d.ts +12 -0
- package/dist/widgets/readForWidget.js +6 -5
- package/dist/widgets/readForWidget.js.map +1 -1
- package/dist/widgets/readForWidgetBreakdown.d.ts +15 -0
- package/dist/widgets/readForWidgetBreakdown.js +10 -7
- package/dist/widgets/readForWidgetBreakdown.js.map +1 -1
- package/dist/widgets/readForWidgetGoals.d.ts +57 -0
- package/dist/widgets/readForWidgetGoals.js +126 -0
- package/dist/widgets/readForWidgetGoals.js.map +1 -0
- package/dist/widgets/readForWidgetSeries.d.ts +13 -0
- package/dist/widgets/readForWidgetSeries.js +30 -12
- package/dist/widgets/readForWidgetSeries.js.map +1 -1
- package/dist/widgets/registerWidgets.js +49 -6
- package/dist/widgets/registerWidgets.js.map +1 -1
- package/dist/widgets/types.js +12 -1
- package/dist/widgets/types.js.map +1 -1
- package/dist/widgets/viewLink.d.ts +22 -0
- package/dist/widgets/viewLink.js +83 -0
- package/dist/widgets/viewLink.js.map +1 -0
- package/package.json +9 -4
|
@@ -0,0 +1,59 @@
|
|
|
1
|
+
import { AnalyticsFilter, DimensionKey, Granularity, MetricKey } from "../core/contract.js";
|
|
2
|
+
import { QueryError } from "./errors.js";
|
|
3
|
+
import { QueryResponse } from "./response.js";
|
|
4
|
+
|
|
5
|
+
//#region src/query/fetchQuery.d.ts
|
|
6
|
+
/** A client-side mirror of the parameters `parseQueryParams` reads off the request. */
|
|
7
|
+
interface QueryRequest {
|
|
8
|
+
metrics: MetricKey[];
|
|
9
|
+
dimensions?: DimensionKey[];
|
|
10
|
+
from: string;
|
|
11
|
+
to: string;
|
|
12
|
+
granularity?: Granularity;
|
|
13
|
+
filters?: AnalyticsFilter[];
|
|
14
|
+
limit?: number;
|
|
15
|
+
order?: {
|
|
16
|
+
metric: MetricKey;
|
|
17
|
+
direction: 'asc' | 'desc';
|
|
18
|
+
};
|
|
19
|
+
compare?: 'previous';
|
|
20
|
+
source?: string;
|
|
21
|
+
/**
|
|
22
|
+
* Read another scope's data. Platform readers only: the endpoint answers
|
|
23
|
+
* `400 untrusted_scope` for any caller that may not read across scopes.
|
|
24
|
+
*/
|
|
25
|
+
scope?: string;
|
|
26
|
+
path?: string;
|
|
27
|
+
hostname?: string;
|
|
28
|
+
timezone?: string;
|
|
29
|
+
}
|
|
30
|
+
/**
|
|
31
|
+
* Builds the query endpoint URL from a fixed field order (not object insertion order),
|
|
32
|
+
* so two `QueryRequest`s with the same values always produce the same URL string. That
|
|
33
|
+
* determinism is what `fetchQuery`'s in-flight dedupe keys on.
|
|
34
|
+
*/
|
|
35
|
+
declare const buildQueryUrl: (apiRoute: string, request: QueryRequest) => string;
|
|
36
|
+
/** Thrown by `fetchQuery` for any non-2xx response; `error` is set only when the body parsed as the endpoint's error shape. */
|
|
37
|
+
declare class QueryFetchError extends Error {
|
|
38
|
+
readonly status: number;
|
|
39
|
+
readonly error?: QueryError;
|
|
40
|
+
readonly retryAfter?: number;
|
|
41
|
+
constructor(status: number, error?: QueryError, retryAfter?: number);
|
|
42
|
+
}
|
|
43
|
+
/**
|
|
44
|
+
* Fetches `GET /analytics/query`, deduping concurrent identical requests (same URL) into
|
|
45
|
+
* one underlying fetch; the entry clears on settle (success or failure), so a later call
|
|
46
|
+
* always sees fresh data and a failed one retries instead of pinning the error.
|
|
47
|
+
*
|
|
48
|
+
* Dedupe means the shared fetch itself never carries a caller's `AbortSignal`, since
|
|
49
|
+
* aborting it would also cancel every other caller sharing that in-flight request.
|
|
50
|
+
* `init.signal` instead races the caller's own promise against the abort: aborting
|
|
51
|
+
* rejects that caller without touching the shared fetch. Use distinct requests (varying
|
|
52
|
+
* a param) when one caller's cancellation must actually stop the network call.
|
|
53
|
+
*/
|
|
54
|
+
declare const fetchQuery: (apiRoute: string, request: QueryRequest, init?: {
|
|
55
|
+
signal?: AbortSignal;
|
|
56
|
+
}) => Promise<QueryResponse>;
|
|
57
|
+
//#endregion
|
|
58
|
+
export { QueryFetchError, QueryRequest, buildQueryUrl, fetchQuery };
|
|
59
|
+
//# sourceMappingURL=fetchQuery.d.ts.map
|
|
@@ -0,0 +1,110 @@
|
|
|
1
|
+
import { QUERY_PATH } from "../plugin/paths.js";
|
|
2
|
+
//#region src/query/fetchQuery.ts
|
|
3
|
+
/**
|
|
4
|
+
* Builds the query endpoint URL from a fixed field order (not object insertion order),
|
|
5
|
+
* so two `QueryRequest`s with the same values always produce the same URL string. That
|
|
6
|
+
* determinism is what `fetchQuery`'s in-flight dedupe keys on.
|
|
7
|
+
*/
|
|
8
|
+
const buildQueryUrl = (apiRoute, request) => {
|
|
9
|
+
const params = new URLSearchParams();
|
|
10
|
+
params.set("metrics", request.metrics.join(","));
|
|
11
|
+
if (request.dimensions && request.dimensions.length > 0) params.set("dimensions", request.dimensions.join(","));
|
|
12
|
+
params.set("from", request.from);
|
|
13
|
+
params.set("to", request.to);
|
|
14
|
+
if (request.granularity !== void 0) params.set("granularity", request.granularity);
|
|
15
|
+
if (request.filters && request.filters.length > 0) params.set("filters", JSON.stringify(request.filters));
|
|
16
|
+
if (request.limit !== void 0) params.set("limit", String(request.limit));
|
|
17
|
+
if (request.order !== void 0) params.set("order", `${request.order.metric}:${request.order.direction}`);
|
|
18
|
+
if (request.compare !== void 0) params.set("compare", request.compare);
|
|
19
|
+
if (request.source !== void 0) params.set("source", request.source);
|
|
20
|
+
if (request.scope !== void 0) params.set("scope", request.scope);
|
|
21
|
+
if (request.path !== void 0) params.set("path", request.path);
|
|
22
|
+
if (request.hostname !== void 0) params.set("hostname", request.hostname);
|
|
23
|
+
if (request.timezone !== void 0) params.set("timezone", request.timezone);
|
|
24
|
+
return `${apiRoute.endsWith("/") ? apiRoute.slice(0, -1) : apiRoute}${QUERY_PATH}?${params.toString()}`;
|
|
25
|
+
};
|
|
26
|
+
const isRecord = (value) => typeof value === "object" && value !== null;
|
|
27
|
+
/**
|
|
28
|
+
* Only the query endpoint's structured body counts. The plugin's other read endpoints
|
|
29
|
+
* answer a flat `{ "error": "forbidden" }`, which must not land in `QueryFetchError.error`
|
|
30
|
+
* as a string where a `QueryError` is declared.
|
|
31
|
+
*/
|
|
32
|
+
const isQueryErrorResponse = (value) => {
|
|
33
|
+
if (!isRecord(value)) return false;
|
|
34
|
+
const error = value.error;
|
|
35
|
+
return isRecord(error) && typeof error.code === "string" && typeof error.message === "string";
|
|
36
|
+
};
|
|
37
|
+
/** Thrown by `fetchQuery` for any non-2xx response; `error` is set only when the body parsed as the endpoint's error shape. */
|
|
38
|
+
var QueryFetchError = class extends Error {
|
|
39
|
+
status;
|
|
40
|
+
error;
|
|
41
|
+
retryAfter;
|
|
42
|
+
constructor(status, error, retryAfter) {
|
|
43
|
+
super(error?.message ?? `analytics query request failed with status ${status}`);
|
|
44
|
+
this.name = "QueryFetchError";
|
|
45
|
+
this.status = status;
|
|
46
|
+
if (error !== void 0) this.error = error;
|
|
47
|
+
if (retryAfter !== void 0) this.retryAfter = retryAfter;
|
|
48
|
+
}
|
|
49
|
+
};
|
|
50
|
+
const readRetryAfter = (res) => {
|
|
51
|
+
const header = res.headers.get("Retry-After");
|
|
52
|
+
if (header === null) return void 0;
|
|
53
|
+
const seconds = Number(header);
|
|
54
|
+
return Number.isFinite(seconds) ? Math.floor(seconds) : void 0;
|
|
55
|
+
};
|
|
56
|
+
const runFetch = async (url) => {
|
|
57
|
+
const res = await fetch(url, {
|
|
58
|
+
credentials: "include",
|
|
59
|
+
headers: { Accept: "application/json" }
|
|
60
|
+
});
|
|
61
|
+
if (!res.ok) {
|
|
62
|
+
let error;
|
|
63
|
+
try {
|
|
64
|
+
const body = await res.json();
|
|
65
|
+
if (isQueryErrorResponse(body)) error = body.error;
|
|
66
|
+
} catch {}
|
|
67
|
+
throw new QueryFetchError(res.status, error, readRetryAfter(res));
|
|
68
|
+
}
|
|
69
|
+
return await res.json();
|
|
70
|
+
};
|
|
71
|
+
const inFlight = /* @__PURE__ */ new Map();
|
|
72
|
+
/**
|
|
73
|
+
* Fetches `GET /analytics/query`, deduping concurrent identical requests (same URL) into
|
|
74
|
+
* one underlying fetch; the entry clears on settle (success or failure), so a later call
|
|
75
|
+
* always sees fresh data and a failed one retries instead of pinning the error.
|
|
76
|
+
*
|
|
77
|
+
* Dedupe means the shared fetch itself never carries a caller's `AbortSignal`, since
|
|
78
|
+
* aborting it would also cancel every other caller sharing that in-flight request.
|
|
79
|
+
* `init.signal` instead races the caller's own promise against the abort: aborting
|
|
80
|
+
* rejects that caller without touching the shared fetch. Use distinct requests (varying
|
|
81
|
+
* a param) when one caller's cancellation must actually stop the network call.
|
|
82
|
+
*/
|
|
83
|
+
const fetchQuery = (apiRoute, request, init) => {
|
|
84
|
+
const url = buildQueryUrl(apiRoute, request);
|
|
85
|
+
let pending = inFlight.get(url);
|
|
86
|
+
if (!pending) {
|
|
87
|
+
pending = runFetch(url).finally(() => {
|
|
88
|
+
inFlight.delete(url);
|
|
89
|
+
});
|
|
90
|
+
inFlight.set(url, pending);
|
|
91
|
+
}
|
|
92
|
+
const signal = init?.signal;
|
|
93
|
+
if (!signal) return pending;
|
|
94
|
+
if (signal.aborted) return Promise.reject(signal.reason);
|
|
95
|
+
return new Promise((resolve, reject) => {
|
|
96
|
+
const onAbort = () => reject(signal.reason);
|
|
97
|
+
signal.addEventListener("abort", onAbort, { once: true });
|
|
98
|
+
pending.then((value) => {
|
|
99
|
+
signal.removeEventListener("abort", onAbort);
|
|
100
|
+
resolve(value);
|
|
101
|
+
}, (err) => {
|
|
102
|
+
signal.removeEventListener("abort", onAbort);
|
|
103
|
+
reject(err);
|
|
104
|
+
});
|
|
105
|
+
});
|
|
106
|
+
};
|
|
107
|
+
//#endregion
|
|
108
|
+
export { QueryFetchError, buildQueryUrl, fetchQuery };
|
|
109
|
+
|
|
110
|
+
//# sourceMappingURL=fetchQuery.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"fetchQuery.js","names":[],"sources":["../../src/query/fetchQuery.ts"],"sourcesContent":["import type { AnalyticsFilter, DimensionKey, Granularity, MetricKey } from '../core/contract'\nimport { QUERY_PATH } from '../plugin/paths'\nimport type { QueryError } from './errors'\nimport type { QueryErrorResponse, QueryResponse } from './response'\n\n/** A client-side mirror of the parameters `parseQueryParams` reads off the request. */\nexport interface QueryRequest {\n\tmetrics: MetricKey[]\n\tdimensions?: DimensionKey[]\n\tfrom: string\n\tto: string\n\tgranularity?: Granularity\n\tfilters?: AnalyticsFilter[]\n\tlimit?: number\n\torder?: { metric: MetricKey; direction: 'asc' | 'desc' }\n\tcompare?: 'previous'\n\tsource?: string\n\t/**\n\t * Read another scope's data. Platform readers only: the endpoint answers\n\t * `400 untrusted_scope` for any caller that may not read across scopes.\n\t */\n\tscope?: string\n\tpath?: string\n\thostname?: string\n\ttimezone?: string\n}\n\n/**\n * Builds the query endpoint URL from a fixed field order (not object insertion order),\n * so two `QueryRequest`s with the same values always produce the same URL string. That\n * determinism is what `fetchQuery`'s in-flight dedupe keys on.\n */\nexport const buildQueryUrl = (apiRoute: string, request: QueryRequest): string => {\n\tconst params = new URLSearchParams()\n\tparams.set('metrics', request.metrics.join(','))\n\tif (request.dimensions && request.dimensions.length > 0) {\n\t\tparams.set('dimensions', request.dimensions.join(','))\n\t}\n\tparams.set('from', request.from)\n\tparams.set('to', request.to)\n\tif (request.granularity !== undefined) {\n\t\tparams.set('granularity', request.granularity)\n\t}\n\tif (request.filters && request.filters.length > 0) {\n\t\tparams.set('filters', JSON.stringify(request.filters))\n\t}\n\tif (request.limit !== undefined) {\n\t\tparams.set('limit', String(request.limit))\n\t}\n\tif (request.order !== undefined) {\n\t\tparams.set('order', `${request.order.metric}:${request.order.direction}`)\n\t}\n\tif (request.compare !== undefined) {\n\t\tparams.set('compare', request.compare)\n\t}\n\tif (request.source !== undefined) {\n\t\tparams.set('source', request.source)\n\t}\n\tif (request.scope !== undefined) {\n\t\tparams.set('scope', request.scope)\n\t}\n\tif (request.path !== undefined) {\n\t\tparams.set('path', request.path)\n\t}\n\tif (request.hostname !== undefined) {\n\t\tparams.set('hostname', request.hostname)\n\t}\n\tif (request.timezone !== undefined) {\n\t\tparams.set('timezone', request.timezone)\n\t}\n\tconst base = apiRoute.endsWith('/') ? apiRoute.slice(0, -1) : apiRoute\n\treturn `${base}${QUERY_PATH}?${params.toString()}`\n}\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n\ttypeof value === 'object' && value !== null\n\n/**\n * Only the query endpoint's structured body counts. The plugin's other read endpoints\n * answer a flat `{ \"error\": \"forbidden\" }`, which must not land in `QueryFetchError.error`\n * as a string where a `QueryError` is declared.\n */\nconst isQueryErrorResponse = (value: unknown): value is QueryErrorResponse => {\n\tif (!isRecord(value)) return false\n\tconst error = value.error\n\treturn isRecord(error) && typeof error.code === 'string' && typeof error.message === 'string'\n}\n\n/** Thrown by `fetchQuery` for any non-2xx response; `error` is set only when the body parsed as the endpoint's error shape. */\nexport class QueryFetchError extends Error {\n\treadonly status: number\n\treadonly error?: QueryError\n\treadonly retryAfter?: number\n\n\tconstructor(status: number, error?: QueryError, retryAfter?: number) {\n\t\tsuper(error?.message ?? `analytics query request failed with status ${status}`)\n\t\tthis.name = 'QueryFetchError'\n\t\tthis.status = status\n\t\tif (error !== undefined) this.error = error\n\t\tif (retryAfter !== undefined) this.retryAfter = retryAfter\n\t}\n}\n\nconst readRetryAfter = (res: Response): number | undefined => {\n\tconst header = res.headers.get('Retry-After')\n\tif (header === null) return undefined\n\t// The HTTP-date form is not a number, so it yields no delay rather than a bogus one;\n\t// a fractional delay floors, since callers schedule in whole seconds.\n\tconst seconds = Number(header)\n\treturn Number.isFinite(seconds) ? Math.floor(seconds) : undefined\n}\n\nconst runFetch = async (url: string): Promise<QueryResponse> => {\n\tconst res = await fetch(url, {\n\t\tcredentials: 'include',\n\t\theaders: { Accept: 'application/json' },\n\t})\n\tif (!res.ok) {\n\t\tlet error: QueryError | undefined\n\t\ttry {\n\t\t\tconst body: unknown = await res.json()\n\t\t\tif (isQueryErrorResponse(body)) error = body.error\n\t\t} catch {\n\t\t\t// Body wasn't JSON; error stays undefined and the status still carries the failure.\n\t\t}\n\t\tthrow new QueryFetchError(res.status, error, readRetryAfter(res))\n\t}\n\treturn (await res.json()) as QueryResponse\n}\n\nconst inFlight = new Map<string, Promise<QueryResponse>>()\n\n/**\n * Fetches `GET /analytics/query`, deduping concurrent identical requests (same URL) into\n * one underlying fetch; the entry clears on settle (success or failure), so a later call\n * always sees fresh data and a failed one retries instead of pinning the error.\n *\n * Dedupe means the shared fetch itself never carries a caller's `AbortSignal`, since\n * aborting it would also cancel every other caller sharing that in-flight request.\n * `init.signal` instead races the caller's own promise against the abort: aborting\n * rejects that caller without touching the shared fetch. Use distinct requests (varying\n * a param) when one caller's cancellation must actually stop the network call.\n */\nexport const fetchQuery = (\n\tapiRoute: string,\n\trequest: QueryRequest,\n\tinit?: { signal?: AbortSignal }\n): Promise<QueryResponse> => {\n\tconst url = buildQueryUrl(apiRoute, request)\n\tlet pending = inFlight.get(url)\n\tif (!pending) {\n\t\tpending = runFetch(url).finally(() => {\n\t\t\tinFlight.delete(url)\n\t\t})\n\t\tinFlight.set(url, pending)\n\t}\n\n\tconst signal = init?.signal\n\tif (!signal) return pending\n\tif (signal.aborted) return Promise.reject(signal.reason)\n\n\treturn new Promise<QueryResponse>((resolve, reject) => {\n\t\tconst onAbort = () => reject(signal.reason)\n\t\tsignal.addEventListener('abort', onAbort, { once: true })\n\t\tpending.then(\n\t\t\t(value) => {\n\t\t\t\tsignal.removeEventListener('abort', onAbort)\n\t\t\t\tresolve(value)\n\t\t\t},\n\t\t\t(err: unknown) => {\n\t\t\t\tsignal.removeEventListener('abort', onAbort)\n\t\t\t\treject(err)\n\t\t\t}\n\t\t)\n\t})\n}\n"],"mappings":"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"}
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
import { AnalyticsQuery } from "../core/contract.js";
|
|
2
|
+
import { QueryError } from "./errors.js";
|
|
3
|
+
|
|
4
|
+
//#region src/query/parse.d.ts
|
|
5
|
+
/**
|
|
6
|
+
* A validated read request. `source` and `scope` are absent by design: the handler must
|
|
7
|
+
* resolve both before the parser can run, and reads them itself through {@link readParam}.
|
|
8
|
+
*/
|
|
9
|
+
interface ParsedQuery {
|
|
10
|
+
query: AnalyticsQuery;
|
|
11
|
+
compare: 'previous' | null;
|
|
12
|
+
}
|
|
13
|
+
type ParseResult = {
|
|
14
|
+
ok: true;
|
|
15
|
+
value: ParsedQuery;
|
|
16
|
+
} | {
|
|
17
|
+
ok: false;
|
|
18
|
+
error: QueryError;
|
|
19
|
+
};
|
|
20
|
+
//#endregion
|
|
21
|
+
export { ParseResult, ParsedQuery };
|
|
22
|
+
//# sourceMappingURL=parse.d.ts.map
|
|
@@ -0,0 +1,168 @@
|
|
|
1
|
+
import { DIMENSION_KEYS, FILTER_OPERATORS } from "../core/contract.js";
|
|
2
|
+
import { isValidTimeZone } from "../timeframe/tz.js";
|
|
3
|
+
import { METRIC_KEYS } from "../translations/metricKeys.js";
|
|
4
|
+
import { GRANULARITY_ORDER } from "../core/granularity.js";
|
|
5
|
+
import { parseDayOrInstant } from "./dates.js";
|
|
6
|
+
import { queryError } from "./errors.js";
|
|
7
|
+
//#region src/query/parse.ts
|
|
8
|
+
const KNOWN_METRICS = new Set(Object.keys(METRIC_KEYS));
|
|
9
|
+
const KNOWN_DIMENSIONS = new Set(DIMENSION_KEYS);
|
|
10
|
+
const KNOWN_OPERATORS = new Set(FILTER_OPERATORS);
|
|
11
|
+
const KNOWN_GRANULARITIES = new Set(GRANULARITY_ORDER);
|
|
12
|
+
const DAY_MS = 864e5;
|
|
13
|
+
const fail = (code, message, param) => ({
|
|
14
|
+
ok: false,
|
|
15
|
+
error: queryError(code, message, param)
|
|
16
|
+
});
|
|
17
|
+
/** Echo a rejected value back in a message without letting a caller inflate the response. */
|
|
18
|
+
const echo = (value) => value.length > 40 ? `${value.slice(0, 40)}...` : value;
|
|
19
|
+
/**
|
|
20
|
+
* A trimmed non-empty parameter, or null when absent or blank. Exported so the handler
|
|
21
|
+
* reads `source` and `scope` (which it must resolve before the parser can run) exactly
|
|
22
|
+
* the way the parser reads everything else.
|
|
23
|
+
*/
|
|
24
|
+
const readParam = (params, name) => {
|
|
25
|
+
const raw = params.get(name)?.trim();
|
|
26
|
+
return raw ? raw : null;
|
|
27
|
+
};
|
|
28
|
+
const commaList = (raw) => raw.split(",").map((part) => part.trim()).filter((part) => part.length > 0);
|
|
29
|
+
const dedupe = (values) => [...new Set(values)];
|
|
30
|
+
const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
|
|
31
|
+
const parseFilters = (raw, capabilities) => {
|
|
32
|
+
let decoded;
|
|
33
|
+
try {
|
|
34
|
+
decoded = JSON.parse(raw);
|
|
35
|
+
} catch {
|
|
36
|
+
return fail("invalid_param", "filters must be a JSON array", "filters");
|
|
37
|
+
}
|
|
38
|
+
if (!Array.isArray(decoded)) return fail("invalid_param", "filters must be a JSON array", "filters");
|
|
39
|
+
if (decoded.length > 10) return fail("invalid_param", `at most 10 filters are allowed`, "filters");
|
|
40
|
+
const filterable = new Set(capabilities.filters);
|
|
41
|
+
const operators = new Set(capabilities.filterOperators);
|
|
42
|
+
const parsed = [];
|
|
43
|
+
for (const item of decoded) {
|
|
44
|
+
if (!isRecord(item)) return fail("invalid_param", "each filter must be an object", "filters");
|
|
45
|
+
const { dimension, operator, value } = item;
|
|
46
|
+
if (typeof dimension !== "string" || !KNOWN_DIMENSIONS.has(dimension)) return fail("invalid_param", `unknown filter dimension: ${echo(String(dimension))}`, "filters");
|
|
47
|
+
if (typeof operator !== "string" || !KNOWN_OPERATORS.has(operator)) return fail("invalid_param", `unknown filter operator: ${echo(String(operator))}`, "filters");
|
|
48
|
+
if (typeof value !== "string") return fail("invalid_param", "each filter value must be a string", "filters");
|
|
49
|
+
const trimmed = value.trim();
|
|
50
|
+
if (trimmed.length < 1 || trimmed.length > 256) return fail("invalid_param", `each filter value must be 1 to 256 characters`, "filters");
|
|
51
|
+
if (!filterable.has(dimension)) return fail("unsupported_filter", `source cannot filter on ${dimension}`, "filters");
|
|
52
|
+
if (!operators.has(operator)) return fail("unsupported_operator", `source does not support ${operator}`, "filters");
|
|
53
|
+
parsed.push({
|
|
54
|
+
dimension,
|
|
55
|
+
operator,
|
|
56
|
+
value: trimmed
|
|
57
|
+
});
|
|
58
|
+
}
|
|
59
|
+
return parsed;
|
|
60
|
+
};
|
|
61
|
+
/**
|
|
62
|
+
* Validate a query string against a source's serialized capabilities. Rules are evaluated
|
|
63
|
+
* in a fixed order and the first failure wins: timezone, metrics, dimensions, from/to,
|
|
64
|
+
* granularity, filters, limit, order, compare, path, hostname. Within each, a value
|
|
65
|
+
* outside the contract's own union is `invalid_param` and a contract value the source
|
|
66
|
+
* lacks is its `unsupported_*` code. Unknown parameters are ignored; `source` and `scope`
|
|
67
|
+
* pass through unvalidated, since only the handler knows whether they are trusted.
|
|
68
|
+
*/
|
|
69
|
+
const parseQueryParams = (params, args) => {
|
|
70
|
+
const rawTimezone = readParam(params, "timezone");
|
|
71
|
+
if (rawTimezone !== null && !isValidTimeZone(rawTimezone)) return fail("invalid_param", `unknown timezone: ${echo(rawTimezone)}`, "timezone");
|
|
72
|
+
const timezone = rawTimezone ?? args.timezone;
|
|
73
|
+
const rawMetrics = readParam(params, "metrics");
|
|
74
|
+
const metricList = rawMetrics ? commaList(rawMetrics) : [];
|
|
75
|
+
if (metricList.length === 0) return fail("invalid_param", "metrics is required", "metrics");
|
|
76
|
+
const unknownMetric = metricList.find((m) => !KNOWN_METRICS.has(m));
|
|
77
|
+
if (unknownMetric !== void 0) return fail("invalid_param", `unknown metric: ${echo(unknownMetric)}`, "metrics");
|
|
78
|
+
const metrics = dedupe(metricList);
|
|
79
|
+
if (metrics.length > 10) return fail("invalid_param", `at most 10 metrics are allowed`, "metrics");
|
|
80
|
+
const servedMetrics = new Set(args.capabilities.metrics);
|
|
81
|
+
const unsupportedMetric = metrics.find((m) => !servedMetrics.has(m));
|
|
82
|
+
if (unsupportedMetric !== void 0) return fail("unsupported_metric", `source does not serve ${unsupportedMetric}`, "metrics");
|
|
83
|
+
const rawDimensions = readParam(params, "dimensions");
|
|
84
|
+
const dimensionList = rawDimensions ? commaList(rawDimensions) : [];
|
|
85
|
+
const unknownDimension = dimensionList.find((d) => !KNOWN_DIMENSIONS.has(d));
|
|
86
|
+
if (unknownDimension !== void 0) return fail("invalid_param", `unknown dimension: ${echo(unknownDimension)}`, "dimensions");
|
|
87
|
+
const dimensions = dedupe(dimensionList);
|
|
88
|
+
if (dimensions.length > 2) return fail("invalid_param", `at most 2 dimensions are allowed`, "dimensions");
|
|
89
|
+
const servedDimensions = new Set(args.capabilities.dimensions);
|
|
90
|
+
const unsupportedDimension = dimensions.find((d) => !servedDimensions.has(d));
|
|
91
|
+
if (unsupportedDimension !== void 0) return fail("unsupported_dimension", `source does not break down by ${unsupportedDimension}`, "dimensions");
|
|
92
|
+
const rawFrom = readParam(params, "from");
|
|
93
|
+
const rawTo = readParam(params, "to");
|
|
94
|
+
if (!rawFrom) return fail("invalid_param", "from is required", "from");
|
|
95
|
+
const start = parseDayOrInstant(rawFrom, {
|
|
96
|
+
timezone,
|
|
97
|
+
edge: "start"
|
|
98
|
+
});
|
|
99
|
+
if (!start) return fail("invalid_param", `from is not a date: ${echo(rawFrom)}`, "from");
|
|
100
|
+
if (!rawTo) return fail("invalid_param", "to is required", "to");
|
|
101
|
+
const end = parseDayOrInstant(rawTo, {
|
|
102
|
+
timezone,
|
|
103
|
+
edge: "end"
|
|
104
|
+
});
|
|
105
|
+
if (!end) return fail("invalid_param", `to is not a date: ${echo(rawTo)}`, "to");
|
|
106
|
+
if (end.getTime() < start.getTime()) return fail("invalid_param", "to must not be before from", "to");
|
|
107
|
+
if (end.getTime() - start.getTime() > 366 * DAY_MS) return fail("range_too_long", `the range must not exceed 366 days`, "to");
|
|
108
|
+
const rawGranularity = readParam(params, "granularity");
|
|
109
|
+
if (rawGranularity !== null && !KNOWN_GRANULARITIES.has(rawGranularity)) return fail("invalid_param", `unknown granularity: ${echo(rawGranularity)}`, "granularity");
|
|
110
|
+
const granularity = rawGranularity;
|
|
111
|
+
if (granularity !== null && GRANULARITY_ORDER.indexOf(granularity) < GRANULARITY_ORDER.indexOf(args.capabilities.minGranularity)) return fail("unsupported_granularity", `source buckets no finer than ${args.capabilities.minGranularity}`, "granularity");
|
|
112
|
+
const rawFilters = readParam(params, "filters");
|
|
113
|
+
const filters = rawFilters === null ? [] : parseFilters(rawFilters, args.capabilities);
|
|
114
|
+
if (!Array.isArray(filters)) return filters;
|
|
115
|
+
const rawLimit = readParam(params, "limit");
|
|
116
|
+
let limit = 50;
|
|
117
|
+
if (rawLimit !== null) {
|
|
118
|
+
if (!/^\d+$/.test(rawLimit)) return fail("invalid_param", `limit must be an integer: ${echo(rawLimit)}`, "limit");
|
|
119
|
+
limit = Number(rawLimit);
|
|
120
|
+
if (limit < 1 || limit > 500) return fail("invalid_param", `limit must be between 1 and 500`, "limit");
|
|
121
|
+
}
|
|
122
|
+
const rawOrder = readParam(params, "order");
|
|
123
|
+
let order;
|
|
124
|
+
if (rawOrder !== null) {
|
|
125
|
+
const parts = rawOrder.split(":");
|
|
126
|
+
const metric = parts[0] ?? "";
|
|
127
|
+
const direction = parts[1] ?? "";
|
|
128
|
+
if (parts.length !== 2 || direction !== "asc" && direction !== "desc") return fail("invalid_param", "order must be <metric>:<asc|desc>", "order");
|
|
129
|
+
const ordered = metrics.find((m) => m === metric);
|
|
130
|
+
if (ordered === void 0) return fail("invalid_param", `order metric is not in metrics: ${echo(metric)}`, "order");
|
|
131
|
+
order = {
|
|
132
|
+
metric: ordered,
|
|
133
|
+
direction
|
|
134
|
+
};
|
|
135
|
+
}
|
|
136
|
+
const rawCompare = readParam(params, "compare");
|
|
137
|
+
if (rawCompare !== null && rawCompare !== "previous") return fail("invalid_param", `compare must be "previous": ${echo(rawCompare)}`, "compare");
|
|
138
|
+
if (rawCompare === "previous" && !args.capabilities.comparison) return fail("invalid_param", "source does not support comparison", "compare");
|
|
139
|
+
const path = readParam(params, "path");
|
|
140
|
+
if (path !== null && path.length > 512) return fail("invalid_param", `path must be at most 512 characters`, "path");
|
|
141
|
+
const hostname = readParam(params, "hostname");
|
|
142
|
+
if (hostname !== null && hostname.length > 253) return fail("invalid_param", `hostname must be at most 253 characters`, "hostname");
|
|
143
|
+
return {
|
|
144
|
+
ok: true,
|
|
145
|
+
value: {
|
|
146
|
+
query: {
|
|
147
|
+
metrics,
|
|
148
|
+
dateRange: {
|
|
149
|
+
start,
|
|
150
|
+
end
|
|
151
|
+
},
|
|
152
|
+
limit,
|
|
153
|
+
timezone,
|
|
154
|
+
...dimensions.length > 0 ? { dimensions } : {},
|
|
155
|
+
...granularity !== null ? { granularity } : {},
|
|
156
|
+
...filters.length > 0 ? { filters } : {},
|
|
157
|
+
...order ? { order } : {},
|
|
158
|
+
...path !== null ? { path } : {},
|
|
159
|
+
...hostname !== null ? { hostname } : {}
|
|
160
|
+
},
|
|
161
|
+
compare: rawCompare === "previous" ? "previous" : null
|
|
162
|
+
}
|
|
163
|
+
};
|
|
164
|
+
};
|
|
165
|
+
//#endregion
|
|
166
|
+
export { parseQueryParams, readParam };
|
|
167
|
+
|
|
168
|
+
//# sourceMappingURL=parse.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"parse.js","names":[],"sources":["../../src/query/parse.ts"],"sourcesContent":["import type { SerializedCapabilities } from '../core/capabilities'\nimport {\n\ttype AnalyticsFilter,\n\ttype AnalyticsQuery,\n\tDIMENSION_KEYS,\n\ttype DimensionKey,\n\tFILTER_OPERATORS,\n\ttype FilterOperator,\n\ttype Granularity,\n\ttype MetricKey,\n} from '../core/contract'\nimport { GRANULARITY_ORDER } from '../core/granularity'\nimport { isValidTimeZone } from '../timeframe/tz'\nimport { METRIC_KEYS } from '../translations/metricKeys'\nimport { parseDayOrInstant } from './dates'\nimport { type QueryError, queryError } from './errors'\nimport {\n\tDEFAULT_QUERY_LIMIT,\n\tMAX_QUERY_DIMENSIONS,\n\tMAX_QUERY_FILTER_VALUE_LENGTH,\n\tMAX_QUERY_FILTERS,\n\tMAX_QUERY_HOSTNAME_LENGTH,\n\tMAX_QUERY_LIMIT,\n\tMAX_QUERY_METRICS,\n\tMAX_QUERY_PATH_LENGTH,\n\tMAX_QUERY_RANGE_DAYS,\n\tMIN_QUERY_LIMIT,\n} from './limits'\n\n/**\n * A validated read request. `source` and `scope` are absent by design: the handler must\n * resolve both before the parser can run, and reads them itself through {@link readParam}.\n */\nexport interface ParsedQuery {\n\tquery: AnalyticsQuery\n\tcompare: 'previous' | null\n}\n\nexport type ParseResult = { ok: true; value: ParsedQuery } | { ok: false; error: QueryError }\n\nexport interface ParseQueryArgs {\n\tcapabilities: SerializedCapabilities\n\t/** Reporting timezone the plugin resolved for this request; the `timezone` param overrides it. */\n\ttimezone: string\n}\n\nconst KNOWN_METRICS = new Set<string>(Object.keys(METRIC_KEYS))\nconst KNOWN_DIMENSIONS = new Set<string>(DIMENSION_KEYS)\nconst KNOWN_OPERATORS = new Set<string>(FILTER_OPERATORS)\nconst KNOWN_GRANULARITIES = new Set<string>(GRANULARITY_ORDER)\nconst DAY_MS = 86_400_000\n\nconst fail = (code: QueryError['code'], message: string, param: string): ParseResult => ({\n\tok: false,\n\terror: queryError(code, message, param),\n})\n\n/** Echo a rejected value back in a message without letting a caller inflate the response. */\nconst echo = (value: string): string => (value.length > 40 ? `${value.slice(0, 40)}...` : value)\n\n/**\n * A trimmed non-empty parameter, or null when absent or blank. Exported so the handler\n * reads `source` and `scope` (which it must resolve before the parser can run) exactly\n * the way the parser reads everything else.\n */\nexport const readParam = (params: URLSearchParams, name: string): string | null => {\n\tconst raw = params.get(name)?.trim()\n\treturn raw ? raw : null\n}\n\nconst commaList = (raw: string): string[] =>\n\traw\n\t\t.split(',')\n\t\t.map((part) => part.trim())\n\t\t.filter((part) => part.length > 0)\n\nconst dedupe = <T extends string>(values: T[]): T[] => [...new Set(values)]\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n\ttypeof value === 'object' && value !== null && !Array.isArray(value)\n\nconst parseFilters = (\n\traw: string,\n\tcapabilities: SerializedCapabilities\n): AnalyticsFilter[] | ParseResult => {\n\tlet decoded: unknown\n\ttry {\n\t\tdecoded = JSON.parse(raw)\n\t} catch {\n\t\treturn fail('invalid_param', 'filters must be a JSON array', 'filters')\n\t}\n\tif (!Array.isArray(decoded)) {\n\t\treturn fail('invalid_param', 'filters must be a JSON array', 'filters')\n\t}\n\tif (decoded.length > MAX_QUERY_FILTERS) {\n\t\treturn fail('invalid_param', `at most ${MAX_QUERY_FILTERS} filters are allowed`, 'filters')\n\t}\n\tconst filterable = new Set<string>(capabilities.filters)\n\tconst operators = new Set<string>(capabilities.filterOperators)\n\tconst parsed: AnalyticsFilter[] = []\n\tfor (const item of decoded) {\n\t\tif (!isRecord(item)) {\n\t\t\treturn fail('invalid_param', 'each filter must be an object', 'filters')\n\t\t}\n\t\tconst { dimension, operator, value } = item\n\t\tif (typeof dimension !== 'string' || !KNOWN_DIMENSIONS.has(dimension)) {\n\t\t\treturn fail(\n\t\t\t\t'invalid_param',\n\t\t\t\t`unknown filter dimension: ${echo(String(dimension))}`,\n\t\t\t\t'filters'\n\t\t\t)\n\t\t}\n\t\tif (typeof operator !== 'string' || !KNOWN_OPERATORS.has(operator)) {\n\t\t\treturn fail('invalid_param', `unknown filter operator: ${echo(String(operator))}`, 'filters')\n\t\t}\n\t\tif (typeof value !== 'string') {\n\t\t\treturn fail('invalid_param', 'each filter value must be a string', 'filters')\n\t\t}\n\t\tconst trimmed = value.trim()\n\t\tif (trimmed.length < 1 || trimmed.length > MAX_QUERY_FILTER_VALUE_LENGTH) {\n\t\t\treturn fail(\n\t\t\t\t'invalid_param',\n\t\t\t\t`each filter value must be 1 to ${MAX_QUERY_FILTER_VALUE_LENGTH} characters`,\n\t\t\t\t'filters'\n\t\t\t)\n\t\t}\n\t\tif (!filterable.has(dimension)) {\n\t\t\treturn fail('unsupported_filter', `source cannot filter on ${dimension}`, 'filters')\n\t\t}\n\t\tif (!operators.has(operator)) {\n\t\t\treturn fail('unsupported_operator', `source does not support ${operator}`, 'filters')\n\t\t}\n\t\tparsed.push({\n\t\t\tdimension: dimension as DimensionKey,\n\t\t\toperator: operator as FilterOperator,\n\t\t\tvalue: trimmed,\n\t\t})\n\t}\n\treturn parsed\n}\n\n/**\n * Validate a query string against a source's serialized capabilities. Rules are evaluated\n * in a fixed order and the first failure wins: timezone, metrics, dimensions, from/to,\n * granularity, filters, limit, order, compare, path, hostname. Within each, a value\n * outside the contract's own union is `invalid_param` and a contract value the source\n * lacks is its `unsupported_*` code. Unknown parameters are ignored; `source` and `scope`\n * pass through unvalidated, since only the handler knows whether they are trusted.\n */\nexport const parseQueryParams = (params: URLSearchParams, args: ParseQueryArgs): ParseResult => {\n\tconst rawTimezone = readParam(params, 'timezone')\n\tif (rawTimezone !== null && !isValidTimeZone(rawTimezone)) {\n\t\treturn fail('invalid_param', `unknown timezone: ${echo(rawTimezone)}`, 'timezone')\n\t}\n\tconst timezone = rawTimezone ?? args.timezone\n\n\tconst rawMetrics = readParam(params, 'metrics')\n\tconst metricList = rawMetrics ? commaList(rawMetrics) : []\n\tif (metricList.length === 0) {\n\t\treturn fail('invalid_param', 'metrics is required', 'metrics')\n\t}\n\tconst unknownMetric = metricList.find((m) => !KNOWN_METRICS.has(m))\n\tif (unknownMetric !== undefined) {\n\t\treturn fail('invalid_param', `unknown metric: ${echo(unknownMetric)}`, 'metrics')\n\t}\n\tconst metrics = dedupe(metricList) as MetricKey[]\n\tif (metrics.length > MAX_QUERY_METRICS) {\n\t\treturn fail('invalid_param', `at most ${MAX_QUERY_METRICS} metrics are allowed`, 'metrics')\n\t}\n\tconst servedMetrics = new Set<string>(args.capabilities.metrics)\n\tconst unsupportedMetric = metrics.find((m) => !servedMetrics.has(m))\n\tif (unsupportedMetric !== undefined) {\n\t\treturn fail('unsupported_metric', `source does not serve ${unsupportedMetric}`, 'metrics')\n\t}\n\n\tconst rawDimensions = readParam(params, 'dimensions')\n\tconst dimensionList = rawDimensions ? commaList(rawDimensions) : []\n\tconst unknownDimension = dimensionList.find((d) => !KNOWN_DIMENSIONS.has(d))\n\tif (unknownDimension !== undefined) {\n\t\treturn fail('invalid_param', `unknown dimension: ${echo(unknownDimension)}`, 'dimensions')\n\t}\n\tconst dimensions = dedupe(dimensionList) as DimensionKey[]\n\tif (dimensions.length > MAX_QUERY_DIMENSIONS) {\n\t\treturn fail(\n\t\t\t'invalid_param',\n\t\t\t`at most ${MAX_QUERY_DIMENSIONS} dimensions are allowed`,\n\t\t\t'dimensions'\n\t\t)\n\t}\n\tconst servedDimensions = new Set<string>(args.capabilities.dimensions)\n\tconst unsupportedDimension = dimensions.find((d) => !servedDimensions.has(d))\n\tif (unsupportedDimension !== undefined) {\n\t\treturn fail(\n\t\t\t'unsupported_dimension',\n\t\t\t`source does not break down by ${unsupportedDimension}`,\n\t\t\t'dimensions'\n\t\t)\n\t}\n\n\tconst rawFrom = readParam(params, 'from')\n\tconst rawTo = readParam(params, 'to')\n\tif (!rawFrom) {\n\t\treturn fail('invalid_param', 'from is required', 'from')\n\t}\n\tconst start = parseDayOrInstant(rawFrom, { timezone, edge: 'start' })\n\tif (!start) {\n\t\treturn fail('invalid_param', `from is not a date: ${echo(rawFrom)}`, 'from')\n\t}\n\tif (!rawTo) {\n\t\treturn fail('invalid_param', 'to is required', 'to')\n\t}\n\tconst end = parseDayOrInstant(rawTo, { timezone, edge: 'end' })\n\tif (!end) {\n\t\treturn fail('invalid_param', `to is not a date: ${echo(rawTo)}`, 'to')\n\t}\n\tif (end.getTime() < start.getTime()) {\n\t\treturn fail('invalid_param', 'to must not be before from', 'to')\n\t}\n\tif (end.getTime() - start.getTime() > MAX_QUERY_RANGE_DAYS * DAY_MS) {\n\t\treturn fail('range_too_long', `the range must not exceed ${MAX_QUERY_RANGE_DAYS} days`, 'to')\n\t}\n\n\tconst rawGranularity = readParam(params, 'granularity')\n\tif (rawGranularity !== null && !KNOWN_GRANULARITIES.has(rawGranularity)) {\n\t\treturn fail('invalid_param', `unknown granularity: ${echo(rawGranularity)}`, 'granularity')\n\t}\n\tconst granularity = rawGranularity as Granularity | null\n\tif (\n\t\tgranularity !== null &&\n\t\tGRANULARITY_ORDER.indexOf(granularity) <\n\t\t\tGRANULARITY_ORDER.indexOf(args.capabilities.minGranularity)\n\t) {\n\t\treturn fail(\n\t\t\t'unsupported_granularity',\n\t\t\t`source buckets no finer than ${args.capabilities.minGranularity}`,\n\t\t\t'granularity'\n\t\t)\n\t}\n\n\tconst rawFilters = readParam(params, 'filters')\n\tconst filters = rawFilters === null ? [] : parseFilters(rawFilters, args.capabilities)\n\tif (!Array.isArray(filters)) {\n\t\treturn filters\n\t}\n\n\tconst rawLimit = readParam(params, 'limit')\n\tlet limit = DEFAULT_QUERY_LIMIT\n\tif (rawLimit !== null) {\n\t\tif (!/^\\d+$/.test(rawLimit)) {\n\t\t\treturn fail('invalid_param', `limit must be an integer: ${echo(rawLimit)}`, 'limit')\n\t\t}\n\t\tlimit = Number(rawLimit)\n\t\tif (limit < MIN_QUERY_LIMIT || limit > MAX_QUERY_LIMIT) {\n\t\t\treturn fail(\n\t\t\t\t'invalid_param',\n\t\t\t\t`limit must be between ${MIN_QUERY_LIMIT} and ${MAX_QUERY_LIMIT}`,\n\t\t\t\t'limit'\n\t\t\t)\n\t\t}\n\t}\n\n\tconst rawOrder = readParam(params, 'order')\n\tlet order: AnalyticsQuery['order']\n\tif (rawOrder !== null) {\n\t\tconst parts = rawOrder.split(':')\n\t\tconst metric = parts[0] ?? ''\n\t\tconst direction = parts[1] ?? ''\n\t\tif (parts.length !== 2 || (direction !== 'asc' && direction !== 'desc')) {\n\t\t\treturn fail('invalid_param', 'order must be <metric>:<asc|desc>', 'order')\n\t\t}\n\t\tconst ordered = metrics.find((m) => m === metric)\n\t\tif (ordered === undefined) {\n\t\t\treturn fail('invalid_param', `order metric is not in metrics: ${echo(metric)}`, 'order')\n\t\t}\n\t\torder = { metric: ordered, direction }\n\t}\n\n\tconst rawCompare = readParam(params, 'compare')\n\tif (rawCompare !== null && rawCompare !== 'previous') {\n\t\treturn fail('invalid_param', `compare must be \"previous\": ${echo(rawCompare)}`, 'compare')\n\t}\n\tif (rawCompare === 'previous' && !args.capabilities.comparison) {\n\t\treturn fail('invalid_param', 'source does not support comparison', 'compare')\n\t}\n\n\tconst path = readParam(params, 'path')\n\tif (path !== null && path.length > MAX_QUERY_PATH_LENGTH) {\n\t\treturn fail('invalid_param', `path must be at most ${MAX_QUERY_PATH_LENGTH} characters`, 'path')\n\t}\n\tconst hostname = readParam(params, 'hostname')\n\tif (hostname !== null && hostname.length > MAX_QUERY_HOSTNAME_LENGTH) {\n\t\treturn fail(\n\t\t\t'invalid_param',\n\t\t\t`hostname must be at most ${MAX_QUERY_HOSTNAME_LENGTH} characters`,\n\t\t\t'hostname'\n\t\t)\n\t}\n\n\tconst query: AnalyticsQuery = {\n\t\tmetrics,\n\t\tdateRange: { start, end },\n\t\tlimit,\n\t\ttimezone,\n\t\t...(dimensions.length > 0 ? { dimensions } : {}),\n\t\t...(granularity !== null ? { granularity } : {}),\n\t\t...(filters.length > 0 ? { filters } : {}),\n\t\t...(order ? { order } : {}),\n\t\t...(path !== null ? { path } : {}),\n\t\t...(hostname !== null ? { hostname } : {}),\n\t}\n\treturn {\n\t\tok: true,\n\t\tvalue: { query, compare: rawCompare === 'previous' ? 'previous' : null },\n\t}\n}\n"],"mappings":"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"}
|
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
import { AnalyticsQuery, AnalyticsResult } from "../core/contract.js";
|
|
2
|
+
import { SerializedCapabilities } from "../core/capabilities.js";
|
|
3
|
+
import { QueryError } from "./errors.js";
|
|
4
|
+
|
|
5
|
+
//#region src/query/response.d.ts
|
|
6
|
+
/** Identity of the source a read was served by; its capabilities travel beside it. */
|
|
7
|
+
interface QuerySourceRef {
|
|
8
|
+
id: string;
|
|
9
|
+
label: string;
|
|
10
|
+
/** `config` for an adapter every scope shares, `runtime` for one resolved per scope. */
|
|
11
|
+
kind: 'config' | 'runtime';
|
|
12
|
+
}
|
|
13
|
+
/** An `AnalyticsQuery` as it survives JSON: the date range's instants are ISO strings. */
|
|
14
|
+
type SerializedAnalyticsQuery = Omit<AnalyticsQuery, 'dateRange'> & {
|
|
15
|
+
dateRange: {
|
|
16
|
+
start: string;
|
|
17
|
+
end: string;
|
|
18
|
+
};
|
|
19
|
+
};
|
|
20
|
+
/** Successful answer of `GET /analytics/query`. */
|
|
21
|
+
interface QueryResponse {
|
|
22
|
+
result: AnalyticsResult;
|
|
23
|
+
/** The equal-length window before `query.dateRange`, present only for `compare=previous`. */
|
|
24
|
+
comparison?: AnalyticsResult;
|
|
25
|
+
source: QuerySourceRef;
|
|
26
|
+
capabilities: SerializedCapabilities;
|
|
27
|
+
/** The query after validation and defaulting, so a client renders what it actually got. */
|
|
28
|
+
query: SerializedAnalyticsQuery;
|
|
29
|
+
}
|
|
30
|
+
/** Every non-2xx answer of `GET /analytics/query`. */
|
|
31
|
+
interface QueryErrorResponse {
|
|
32
|
+
error: QueryError;
|
|
33
|
+
}
|
|
34
|
+
//#endregion
|
|
35
|
+
export { QueryErrorResponse, QueryResponse, QuerySourceRef, SerializedAnalyticsQuery };
|
|
36
|
+
//# sourceMappingURL=response.d.ts.map
|
package/dist/timeframe/tz.js
CHANGED
|
@@ -45,22 +45,22 @@ const sameLocalDay = (date, ymd, tz) => {
|
|
|
45
45
|
* offsets, so the candidate that still falls on `ymd` (the transition instant, local
|
|
46
46
|
* 01:00) is taken instead of the refined one that fell back onto the previous day.
|
|
47
47
|
*/
|
|
48
|
-
const
|
|
48
|
+
const startOfCalendarDayInTz = (ymd, tz = "UTC") => {
|
|
49
49
|
const asUtc = Date.UTC(ymd.year, ymd.month - 1, ymd.day);
|
|
50
50
|
const guess = new Date(asUtc - offsetMs(new Date(asUtc), tz));
|
|
51
51
|
const refined = new Date(asUtc - offsetMs(guess, tz));
|
|
52
52
|
if (sameLocalDay(refined, ymd, tz)) return refined;
|
|
53
53
|
if (sameLocalDay(guess, ymd, tz)) return guess;
|
|
54
|
-
return
|
|
54
|
+
return startOfCalendarDayInTz(zonedParts(refined.getTime() > guess.getTime() ? refined : guess, tz), tz);
|
|
55
55
|
};
|
|
56
56
|
/** Start of `date`'s local day in `tz`. */
|
|
57
57
|
const startOfDayInTz = (date, tz = "UTC") => {
|
|
58
|
-
return
|
|
58
|
+
return startOfCalendarDayInTz(zonedParts(date, tz), tz);
|
|
59
59
|
};
|
|
60
60
|
/** Start of `date`'s local month in `tz`. */
|
|
61
61
|
const startOfMonthInTz = (date, tz = "UTC") => {
|
|
62
62
|
const p = zonedParts(date, tz);
|
|
63
|
-
return
|
|
63
|
+
return startOfCalendarDayInTz({
|
|
64
64
|
year: p.year,
|
|
65
65
|
month: p.month,
|
|
66
66
|
day: 1
|
|
@@ -68,7 +68,7 @@ const startOfMonthInTz = (date, tz = "UTC") => {
|
|
|
68
68
|
};
|
|
69
69
|
/** Start of `date`'s local year in `tz`. */
|
|
70
70
|
const startOfYearInTz = (date, tz = "UTC") => {
|
|
71
|
-
return
|
|
71
|
+
return startOfCalendarDayInTz({
|
|
72
72
|
year: zonedParts(date, tz).year,
|
|
73
73
|
month: 1,
|
|
74
74
|
day: 1
|
|
@@ -95,6 +95,17 @@ const startOfWeekInTz = (date, tz = "UTC") => {
|
|
|
95
95
|
};
|
|
96
96
|
/** ISO string of `date`'s local day start in `tz`; the canonical day-bucket key. */
|
|
97
97
|
const zonedDayIso = (date, tz = "UTC") => startOfDayInTz(date, tz).toISOString();
|
|
98
|
+
/**
|
|
99
|
+
* `date`'s local calendar date in `tz` as `YYYY-MM-DD`, the form day-granular provider APIs
|
|
100
|
+
* take. Not `zonedDayIso(...).slice(0, 10)`: that returns the UTC spelling of the local day
|
|
101
|
+
* start, which names the previous calendar day for every zone east of UTC.
|
|
102
|
+
*/
|
|
103
|
+
const zonedCalendarDay = (date, tz = "UTC") => {
|
|
104
|
+
const p = zonedParts(date, tz);
|
|
105
|
+
const month = String(p.month).padStart(2, "0");
|
|
106
|
+
const day = String(p.day).padStart(2, "0");
|
|
107
|
+
return `${String(p.year).padStart(4, "0")}-${month}-${day}`;
|
|
108
|
+
};
|
|
98
109
|
/** True when `tz` is a resolvable IANA identifier. */
|
|
99
110
|
const isValidTimeZone = (tz) => {
|
|
100
111
|
try {
|
|
@@ -105,6 +116,6 @@ const isValidTimeZone = (tz) => {
|
|
|
105
116
|
}
|
|
106
117
|
};
|
|
107
118
|
//#endregion
|
|
108
|
-
export { addDaysInTz, isValidTimeZone, startOfDayInTz, startOfMonthInTz, startOfWeekInTz, startOfYearInTz, zonedDayIso };
|
|
119
|
+
export { addDaysInTz, isValidTimeZone, startOfCalendarDayInTz, startOfDayInTz, startOfMonthInTz, startOfWeekInTz, startOfYearInTz, zonedCalendarDay, zonedDayIso };
|
|
109
120
|
|
|
110
121
|
//# sourceMappingURL=tz.js.map
|
package/dist/timeframe/tz.js.map
CHANGED
|
@@ -1 +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 */\
|
|
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 */\nexport const startOfCalendarDayInTz = (\n\tymd: { year: number; month: number; day: number },\n\ttz: string = DEFAULT_TIMEZONE\n): 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 startOfCalendarDayInTz(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 startOfCalendarDayInTz(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 startOfCalendarDayInTz({ 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 startOfCalendarDayInTz({ 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/**\n * `date`'s local calendar date in `tz` as `YYYY-MM-DD`, the form day-granular provider APIs\n * take. Not `zonedDayIso(...).slice(0, 10)`: that returns the UTC spelling of the local day\n * start, which names the previous calendar day for every zone east of UTC.\n */\nexport const zonedCalendarDay = (date: Date, tz: string = DEFAULT_TIMEZONE): string => {\n\tconst p = zonedParts(date, tz)\n\tconst month = String(p.month).padStart(2, '0')\n\tconst day = String(p.day).padStart(2, '0')\n\treturn `${String(p.year).padStart(4, '0')}-${month}-${day}`\n}\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":"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"}
|