@reopt-ai/data-contract 0.6.3 → 0.7.0

package/dist/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","names":[],"sources":["../src/query.ts"],"mappings":"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"}

package/dist/query.js

@@ -1,86 +1,247 @@
-import {
-  QUERY_API_PATHS,
-  QUERY_ERROR_CODES,
-  isValidTimeZone,
-  zBucketStart,
-  zChannelFilter,
-  zEventPropertyFilter,
-  zEventsTimeseriesData,
-  zEventsTimeseriesInput,
-  zEventsTimeseriesResponse,
-  zFunnelData,
-  zFunnelInput,
-  zFunnelResponse,
-  zFunnelStep,
-  zGranularity,
-  zQueryEnvelope,
-  zQueryError,
-  zQueryErrorCode,
-  zQueryMeta,
-  zQuerySource,
-  zRetentionCell,
-  zRetentionData,
-  zRetentionInput,
-  zRetentionInterval,
-  zRetentionResponse,
-  zTimeseriesBreakdown,
-  zTimeseriesPoint,
-  zTimezone,
-  zTrafficDimension,
-  zTrafficOverviewData,
-  zTrafficOverviewInput,
-  zTrafficOverviewResponse,
-  zTrafficSeriesPoint,
-  zTrafficSourceRow,
-  zTrafficSourcesData,
-  zTrafficSourcesInput,
-  zTrafficSourcesResponse,
-  zTrafficTotals
-} from "./chunk-NJ4JKNBX.js";
-import {
-  zDate,
-  zInstant
-} from "./chunk-JCEWUSUM.js";
-import "./chunk-PSUINLW7.js";
-export {
-  QUERY_API_PATHS,
-  QUERY_ERROR_CODES,
-  isValidTimeZone,
-  zBucketStart,
-  zChannelFilter,
-  zDate,
-  zEventPropertyFilter,
-  zEventsTimeseriesData,
-  zEventsTimeseriesInput,
-  zEventsTimeseriesResponse,
-  zFunnelData,
-  zFunnelInput,
-  zFunnelResponse,
-  zFunnelStep,
-  zGranularity,
-  zInstant,
-  zQueryEnvelope,
-  zQueryError,
-  zQueryErrorCode,
-  zQueryMeta,
-  zQuerySource,
-  zRetentionCell,
-  zRetentionData,
-  zRetentionInput,
-  zRetentionInterval,
-  zRetentionResponse,
-  zTimeseriesBreakdown,
-  zTimeseriesPoint,
-  zTimezone,
-  zTrafficDimension,
-  zTrafficOverviewData,
-  zTrafficOverviewInput,
-  zTrafficOverviewResponse,
-  zTrafficSeriesPoint,
-  zTrafficSourceRow,
-  zTrafficSourcesData,
-  zTrafficSourcesInput,
-  zTrafficSourcesResponse,
-  zTrafficTotals
+import { zDate, zInstant } from "./index.js";
+import { z } from "zod";
+//#region src/query.ts
+const zGranularity = z.enum([
+	"hour",
+	"day",
+	"week",
+	"month"
+]);
+const zTimezone = z.string().min(1).max(64).refine(isValidTimeZone, { message: "unknown IANA time zone" });
+function isValidTimeZone(value) {
+	try {
+		new Intl.DateTimeFormat("en-US", { timeZone: value });
+		return true;
+	} catch {
+		return false;
+	}
+}
+const zChannelFilter = z.object({
+	referrerTypes: z.array(z.string()).optional(),
+	channelTypes: z.array(z.string()).optional(),
+	utmSources: z.array(z.string()).optional(),
+	utmMediums: z.array(z.string()).optional(),
+	utmCampaigns: z.array(z.string()).optional()
+}).optional();
+const zQuerySource = z.enum([
+	"rollup",
+	"raw",
+	"mixed"
+]);
+const zQueryMeta = z.object({
+	projectId: z.string(),
+	computedAt: zInstant,
+	cacheAgeSeconds: z.number().int().nonnegative(),
+	ingestLagSeconds: z.number().int().nonnegative().nullable(),
+	ingestLagStatus: z.enum(["known", "unknown"]),
+	ingestDeadLetterCount: z.number().int().nonnegative().nullable(),
+	cached: z.boolean(),
+	timezone: z.string(),
+	source: zQuerySource,
+	requestId: z.string()
+});
+function zQueryEnvelope(data) {
+	return z.object({
+		data,
+		meta: zQueryMeta
+	});
+}
+const zTimeseriesBreakdown = z.object({
+	kind: z.literal("property"),
+	key: z.string().min(1).max(200),
+	topN: z.number().int().min(1).max(100).default(5)
+});
+const zEventPropertyFilter = z.object({
+	key: z.string().min(1).max(200),
+	operator: z.literal("eq").default("eq"),
+	value: z.string().min(1).max(500)
+});
+const zEventsTimeseriesInput = z.object({
+	projectId: z.string().min(1),
+	startDate: zDate,
+	endDate: zDate,
+	granularity: zGranularity.default("day"),
+	eventName: z.string().min(1).max(200).optional(),
+	propertyFilters: z.array(zEventPropertyFilter).max(10).optional(),
+	breakdown: zTimeseriesBreakdown.optional(),
+	segmentId: z.string().min(1).optional(),
+	timezone: zTimezone.optional(),
+	includeInternal: z.boolean().default(false)
+}).refine((input) => input.startDate <= input.endDate, {
+	message: "endDate must be on or after startDate",
+	path: ["endDate"]
+});
+const zBucketStart = z.string().regex(/^\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2}$/, "expected 'YYYY-MM-DD HH:MM:SS'");
+const zTimeseriesPoint = z.object({
+	date: zBucketStart,
+	count: z.number().int().nonnegative()
+});
+const zEventsTimeseriesData = z.object({
+	granularity: zGranularity,
+	timezone: z.string(),
+	series: z.array(zTimeseriesPoint),
+	breakdown: z.array(z.object({
+		value: z.string(),
+		points: z.array(zTimeseriesPoint)
+	})).optional()
+});
+const zEventsTimeseriesResponse = zQueryEnvelope(zEventsTimeseriesData);
+const zFunnelInput = z.object({
+	projectId: z.string().min(1),
+	steps: z.array(z.string().min(1).max(200)).min(2).max(10),
+	startDate: zDate,
+	endDate: zDate,
+	windowSeconds: z.number().int().min(60).max(2592e3).default(86400),
+	segmentId: z.string().min(1).optional(),
+	channelFilter: zChannelFilter,
+	timezone: zTimezone.optional(),
+	includeInternal: z.boolean().default(false)
+}).refine((input) => input.startDate <= input.endDate, {
+	message: "endDate must be on or after startDate",
+	path: ["endDate"]
+});
+const zFunnelStep = z.object({
+	step: z.number().int().min(1),
+	name: z.string(),
+	users: z.number().int().nonnegative(),
+	conversionRate: z.number(),
+	dropoffRate: z.number(),
+	dropoffUsers: z.number().int().nonnegative()
+});
+const zFunnelData = z.object({
+	steps: z.array(zFunnelStep),
+	totalUsers: z.number().int().nonnegative(),
+	overallConversionRate: z.number()
+});
+const zFunnelResponse = zQueryEnvelope(zFunnelData);
+const zRetentionInterval = z.enum([
+	"day",
+	"week",
+	"month"
+]);
+const zRetentionInput = z.object({
+	projectId: z.string().min(1),
+	startDate: zDate,
+	endDate: zDate,
+	interval: zRetentionInterval.default("day"),
+	periods: z.number().int().min(1).max(30).default(7),
+	startEvent: z.string().min(1).max(200).optional(),
+	returnEvent: z.string().min(1).max(200).optional(),
+	retentionType: z.enum(["bounded", "unbounded"]).default("bounded"),
+	cohortMode: z.enum(["first-ever", "first-in-window"]).default("first-ever"),
+	segmentId: z.string().min(1).optional(),
+	channelFilter: zChannelFilter,
+	timezone: zTimezone.optional(),
+	includeInternal: z.boolean().default(false)
+}).refine((input) => input.startDate <= input.endDate, {
+	message: "endDate must be on or after startDate",
+	path: ["endDate"]
+});
+const zRetentionCell = z.object({
+	period: z.number().int().nonnegative(),
+	users: z.number().int().nonnegative(),
+	rate: z.number()
+});
+const zRetentionData = z.object({
+	matrix: z.array(z.object({
+		cohortDate: zBucketStart,
+		cohortSize: z.number().int().nonnegative(),
+		retention: z.array(zRetentionCell)
+	})),
+	averageRetention: z.array(z.object({
+		period: z.number().int().nonnegative(),
+		rate: z.number()
+	})),
+	interval: zRetentionInterval,
+	periods: z.number().int(),
+	retentionType: z.enum(["bounded", "unbounded"]),
+	timezone: z.string()
+});
+const zRetentionResponse = zQueryEnvelope(zRetentionData);
+const zTrafficOverviewInput = z.object({
+	projectId: z.string().min(1),
+	startDate: zDate,
+	endDate: zDate,
+	granularity: zGranularity.default("day"),
+	timezone: zTimezone.optional()
+}).refine((input) => input.startDate <= input.endDate, {
+	message: "endDate must be on or after startDate",
+	path: ["endDate"]
+});
+const zTrafficTotals = z.object({
+	sessions: z.number().int().nonnegative(),
+	pageviews: z.number().int().nonnegative(),
+	newVisitors: z.number().int().nonnegative(),
+	returningVisitors: z.number().int().nonnegative(),
+	bounceRate: z.number()
+});
+const zTrafficSeriesPoint = zTrafficTotals.extend({ date: zBucketStart });
+const zTrafficOverviewData = z.object({
+	granularity: zGranularity,
+	timezone: z.string(),
+	totals: zTrafficTotals,
+	series: z.array(zTrafficSeriesPoint)
+});
+const zTrafficOverviewResponse = zQueryEnvelope(zTrafficOverviewData);
+const zTrafficDimension = z.enum([
+	"channel",
+	"referrer",
+	"utm"
+]);
+const zTrafficSourcesInput = z.object({
+	projectId: z.string().min(1),
+	startDate: zDate,
+	endDate: zDate,
+	dimension: zTrafficDimension,
+	limit: z.number().int().min(1).max(100).default(10),
+	timezone: zTimezone.optional()
+}).refine((input) => input.startDate <= input.endDate, {
+	message: "endDate must be on or after startDate",
+	path: ["endDate"]
+});
+const zTrafficSourceRow = zTrafficTotals.extend({
+	key: z.string(),
+	channelType: z.string().optional(),
+	referrerName: z.string().optional(),
+	referrerType: z.string().optional(),
+	utmSource: z.string().optional(),
+	utmMedium: z.string().optional(),
+	utmCampaign: z.string().optional()
+});
+const zTrafficSourcesData = z.object({
+	dimension: zTrafficDimension,
+	timezone: z.string(),
+	rows: z.array(zTrafficSourceRow)
+});
+const zTrafficSourcesResponse = zQueryEnvelope(zTrafficSourcesData);
+const QUERY_ERROR_CODES = [
+	"unauthorized",
+	"project_scope_mismatch",
+	"query_scope_missing",
+	"validation_failed",
+	"unsupported_combination",
+	"project_purging",
+	"rate_limited",
+	"query_timeout",
+	"internal_error"
+];
+const zQueryErrorCode = z.enum(QUERY_ERROR_CODES);
+const zQueryError = z.object({
+	status: z.number().int(),
+	code: zQueryErrorCode,
+	error: z.string(),
+	message: z.string().optional(),
+	errors: z.unknown().optional(),
+	requestId: z.string().optional()
+});
+const QUERY_API_PATHS = {
+	eventsTimeseries: "/api/v1/query/events/timeseries",
+	funnel: "/api/v1/query/funnel",
+	retention: "/api/v1/query/retention",
+	trafficOverview: "/api/v1/query/traffic/overview",
+	trafficSources: "/api/v1/query/traffic/sources"
 };
+//#endregion
+export { QUERY_API_PATHS, QUERY_ERROR_CODES, isValidTimeZone, zBucketStart, zChannelFilter, zDate, zEventPropertyFilter, zEventsTimeseriesData, zEventsTimeseriesInput, zEventsTimeseriesResponse, zFunnelData, zFunnelInput, zFunnelResponse, zFunnelStep, zGranularity, zInstant, zQueryEnvelope, zQueryError, zQueryErrorCode, zQueryMeta, zQuerySource, zRetentionCell, zRetentionData, zRetentionInput, zRetentionInterval, zRetentionResponse, zTimeseriesBreakdown, zTimeseriesPoint, zTimezone, zTrafficDimension, zTrafficOverviewData, zTrafficOverviewInput, zTrafficOverviewResponse, zTrafficSeriesPoint, zTrafficSourceRow, zTrafficSourcesData, zTrafficSourcesInput, zTrafficSourcesResponse, zTrafficTotals };
+
 //# sourceMappingURL=query.js.map

package/dist/query.js.map

@@ -1 +1 @@
-{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}
+{"version":3,"file":"query.js","names":[],"sources":["../src/query.ts"],"sourcesContent":["/**\n * `POST /api/v1/query/*` — the read contract.\n *\n * Server credentials, project-scoped: the authenticated client's projectId must\n * equal the `projectId` in the body, or the request is refused. Reads are POSTs\n * because the inputs nest (funnel steps, channel filters) and would not survive\n * a query string; consumers cache on their own side, so HTTP cache semantics\n * buy nothing here.\n *\n * Response shapes mirror the existing dashboard computations exactly — this\n * plane re-exposes them, it does not add new math.\n */\nimport { z } from \"zod\";\nimport { zDate, zInstant } from \"./index.js\";\n\nexport { zDate, zInstant };\n\n/** Bucket width for a time series. */\nexport const zGranularity = z.enum([\"hour\", \"day\", \"week\", \"month\"]);\nexport type Granularity = z.infer<typeof zGranularity>;\n\n/**\n * IANA time zone name, e.g. `Asia/Seoul`. Decides two things at once: where a\n * calendar day starts, and therefore which bucket an event falls in.\n *\n * A Korean brand reading \"23 Aug: 120 visits\" means 23 Aug in Seoul. Computed\n * in UTC, that headline silently covers 23 Aug 09:00 through 24 Aug 09:00 —\n * wrong by nine hours in a way nothing on the page reveals.\n *\n * Validated against the runtime's own zone database rather than a regex, so an\n * unknown name fails here with a clear message instead of deep inside a query.\n */\nexport const zTimezone = z.string().min(1).max(64).refine(isValidTimeZone, { message: \"unknown IANA time zone\" });\n\nexport function isValidTimeZone(value: string): boolean {\n  try {\n    new Intl.DateTimeFormat(\"en-US\", { timeZone: value });\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Acquisition-channel filter. Every field is a set — an event matches when its\n * value is in the set; omitted fields do not constrain. Mirrors the dashboard's\n * `channelFilterSchema` field-for-field.\n */\nexport const zChannelFilter = z\n  .object({\n    referrerTypes: z.array(z.string()).optional(),\n    channelTypes: z.array(z.string()).optional(),\n    utmSources: z.array(z.string()).optional(),\n    utmMediums: z.array(z.string()).optional(),\n    utmCampaigns: z.array(z.string()).optional(),\n  })\n  .optional();\nexport type ChannelFilter = z.infer<typeof zChannelFilter>;\n\n// ─── Envelope ───────────────────────────────────────────────────────────────\n\n/**\n * Staleness is reported as two independent numbers, never as one sum, because\n * the two have different remedies: a stale cache resolves itself at the next\n * TTL, while ingest lag means the read model is genuinely behind and the right\n * response is an \"aggregating\" badge, not a refresh.\n */\nexport const zQuerySource = z.enum([\"rollup\", \"raw\", \"mixed\"]);\nexport type QuerySource = z.infer<typeof zQuerySource>;\n\nexport const zQueryMeta = z.object({\n  projectId: z.string(),\n  /** When the underlying computation actually ran. On a cache hit, when the cached value was computed. */\n  computedAt: zInstant,\n  /** Age of the returned computation, in seconds. `0` on a cache miss. */\n  cacheAgeSeconds: z.number().int().nonnegative(),\n  /**\n   * How far behind live materialization was when the computation ran, in\n   * seconds. `0` means no live event is pending; `null` means measurement\n   * failed and must never be interpreted as fresh.\n   *\n   * Deliberately not `now - max(events.created_at)` — that conflates \"the\n   * pipeline is behind\" with \"this project is quiet\", and grows without bound\n   * on an idle project.\n   */\n  ingestLagSeconds: z.number().int().nonnegative().nullable(),\n  /** Whether the freshness measurement itself succeeded. */\n  ingestLagStatus: z.enum([\"known\", \"unknown\"]),\n  /**\n   * Pending events older than the live replay window. Kept separate so an old\n   * permanently failing event neither pegs live lag nor disappears behind 0.\n   * `null` means the measurement failed.\n   */\n  ingestDeadLetterCount: z.number().int().nonnegative().nullable(),\n  cached: z.boolean(),\n  /**\n   * The time zone actually used to place bucket and window boundaries — the\n   * resolved value, not the requested one. Read it rather than assuming the\n   * request was honoured: when no zone is given anywhere it is `\"UTC\"`, and\n   * that is exactly the case a consumer needs to notice.\n   */\n  timezone: z.string(),\n  /**\n   * Where the numbers came from. `rollup`: pre-aggregated hourly tables;\n   * `raw`: a scan of the event/session tables; `mixed`: finished hours from\n   * the rollup, the hour still in progress from raw. Diagnostic — the values\n   * agree either way — but a consumer that expected `rollup` and sees `raw`\n   * has asked for a combination the rollups cannot serve.\n   */\n  source: zQuerySource,\n  requestId: z.string(),\n});\nexport type QueryMeta = z.infer<typeof zQueryMeta>;\n\n/** Every query response is `{ data, meta }`. */\nexport function zQueryEnvelope<T extends z.ZodTypeAny>(data: T) {\n  return z.object({ data, meta: zQueryMeta });\n}\n\n// ─── events.timeseries ──────────────────────────────────────────────────────\n\n/**\n * v1 breaks down by `properties` JSON keys only. Built-in columns\n * (country / os / browser / utm_*) have a totals breakdown in the backend but\n * no *time series* variant, and this plane does not add new computations.\n */\nexport const zTimeseriesBreakdown = z.object({\n  kind: z.literal(\"property\"),\n  key: z.string().min(1).max(200),\n  topN: z.number().int().min(1).max(100).default(5),\n});\nexport type TimeseriesBreakdown = z.infer<typeof zTimeseriesBreakdown>;\n\n/** Exact-match filter for a top-level event `properties` key. Multiple filters are ANDed. */\nexport const zEventPropertyFilter = z.object({\n  key: z.string().min(1).max(200),\n  operator: z.literal(\"eq\").default(\"eq\"),\n  value: z.string().min(1).max(500),\n});\nexport type EventPropertyFilter = z.infer<typeof zEventPropertyFilter>;\n\nexport const zEventsTimeseriesInput = z\n  .object({\n    projectId: z.string().min(1),\n    startDate: zDate,\n    endDate: zDate,\n    granularity: zGranularity.default(\"day\"),\n    /** Omit to count every event in the window. */\n    eventName: z.string().min(1).max(200).optional(),\n    /** Exact matches against top-level `properties` keys. Every item must match. */\n    propertyFilters: z.array(zEventPropertyFilter).max(10).optional(),\n    breakdown: zTimeseriesBreakdown.optional(),\n    /**\n     * Cannot be combined with `breakdown` — the backend's breakdown time series\n     * takes no segment. Sending both is refused with `unsupported_combination`\n     * rather than silently ignoring one of them.\n     */\n    segmentId: z.string().min(1).optional(),\n    /** Omit to fall back to the project's configured zone, then to UTC. */\n    timezone: zTimezone.optional(),\n    /**\n     * Events whose catalogue status is `internal` (operational probes) are\n     * left out by default. A probe that needs to find its own event sets this.\n     */\n    includeInternal: z.boolean().default(false),\n  })\n  .refine((input) => input.startDate <= input.endDate, {\n    message: \"endDate must be on or after startDate\",\n    path: [\"endDate\"],\n  });\nexport type EventsTimeseriesInput = z.input<typeof zEventsTimeseriesInput>;\n\n/**\n * Bucket start as wall-clock time in `meta.timezone`, `YYYY-MM-DD HH:MM:SS`.\n *\n * Pinned rather than left to the backend, because a consumer keys its chart on\n * this string: an unspecified format is one where two backends, or two\n * granularities, can quietly disagree and produce two different keys for the\n * same bucket.\n *\n * It is wall time, not an instant — for `Asia/Seoul` a day bucket reads\n * `2026-08-24 00:00:00`, which is `2026-08-23T15:00:00Z`. Day, week and month\n * buckets always carry `00:00:00`, so slicing the first ten characters is a\n * safe way to get a date key.\n */\nexport const zBucketStart = z.string().regex(/^\\d{4}-\\d{2}-\\d{2} \\d{2}:\\d{2}:\\d{2}$/, \"expected 'YYYY-MM-DD HH:MM:SS'\");\n\nexport const zTimeseriesPoint = z.object({\n  date: zBucketStart,\n  count: z.number().int().nonnegative(),\n});\nexport type TimeseriesPoint = z.infer<typeof zTimeseriesPoint>;\n\nexport const zEventsTimeseriesData = z.object({\n  granularity: zGranularity,\n  /** Zone the buckets were cut in. Mirrors `meta.timezone`. */\n  timezone: z.string(),\n  /** Total per bucket. Always present, with or without a breakdown. */\n  series: z.array(zTimeseriesPoint),\n  /** Present only when `breakdown` was requested: the top-N values, each with its own series. */\n  breakdown: z\n    .array(\n      z.object({\n        value: z.string(),\n        points: z.array(zTimeseriesPoint),\n      })\n    )\n    .optional(),\n});\nexport type EventsTimeseriesData = z.infer<typeof zEventsTimeseriesData>;\n\nexport const zEventsTimeseriesResponse = zQueryEnvelope(zEventsTimeseriesData);\nexport type EventsTimeseriesResponse = z.infer<typeof zEventsTimeseriesResponse>;\n\n// ─── funnel ─────────────────────────────────────────────────────────────────\n\nexport const zFunnelInput = z\n  .object({\n    projectId: z.string().min(1),\n    /** Ordered event names. A user counts at step k if they reached at least step k. */\n    steps: z.array(z.string().min(1).max(200)).min(2).max(10),\n    startDate: zDate,\n    endDate: zDate,\n    /** Max seconds between the first and last step for a conversion to count. Default 24h. */\n    windowSeconds: z.number().int().min(60).max(2_592_000).default(86_400),\n    segmentId: z.string().min(1).optional(),\n    channelFilter: zChannelFilter,\n    /**\n     * Decides where `startDate` / `endDate` fall. A funnel has no buckets, so\n     * this only moves the window — but a nine-hour window shift changes who is\n     * in the funnel.\n     */\n    timezone: zTimezone.optional(),\n    /** Accepted for symmetry with events.timeseries; funnel steps are named explicitly, so nothing is filtered. */\n    includeInternal: z.boolean().default(false),\n  })\n  .refine((input) => input.startDate <= input.endDate, {\n    message: \"endDate must be on or after startDate\",\n    path: [\"endDate\"],\n  });\nexport type FunnelInput = z.input<typeof zFunnelInput>;\n\nexport const zFunnelStep = z.object({\n  step: z.number().int().min(1),\n  name: z.string(),\n  users: z.number().int().nonnegative(),\n  /** Percent of the previous step that reached this one. `100` for step 1. */\n  conversionRate: z.number(),\n  /** Percent of the previous step that did not. `0` for step 1. */\n  dropoffRate: z.number(),\n  dropoffUsers: z.number().int().nonnegative(),\n});\n\nexport const zFunnelData = z.object({\n  steps: z.array(zFunnelStep),\n  totalUsers: z.number().int().nonnegative(),\n  /** Percent of step-1 users that reached the last step. */\n  overallConversionRate: z.number(),\n});\nexport type FunnelData = z.infer<typeof zFunnelData>;\n\nexport const zFunnelResponse = zQueryEnvelope(zFunnelData);\nexport type FunnelResponse = z.infer<typeof zFunnelResponse>;\n\n// ─── retention ──────────────────────────────────────────────────────────────\n\nexport const zRetentionInterval = z.enum([\"day\", \"week\", \"month\"]);\n\nexport const zRetentionInput = z\n  .object({\n    projectId: z.string().min(1),\n    startDate: zDate,\n    endDate: zDate,\n    interval: zRetentionInterval.default(\"day\"),\n    periods: z.number().int().min(1).max(30).default(7),\n    startEvent: z.string().min(1).max(200).optional(),\n    returnEvent: z.string().min(1).max(200).optional(),\n    /** `bounded`: returned in exactly period N. `unbounded`: returned in period N or later. */\n    retentionType: z.enum([\"bounded\", \"unbounded\"]).default(\"bounded\"),\n    /**\n     * `first-ever` (default): the cohort is everyone whose true first activity\n     * landed in the window, read from the first-seen aggregate. `startEvent`,\n     * `segmentId` and `channelFilter` then constrain only the *returning* side.\n     * `first-in-window`: the cohort is selected by scanning events in the window\n     * with all filters applied. Slower, but filters apply to cohort selection.\n     */\n    cohortMode: z.enum([\"first-ever\", \"first-in-window\"]).default(\"first-ever\"),\n    segmentId: z.string().min(1).optional(),\n    channelFilter: zChannelFilter,\n    /**\n     * Decides where a cohort day starts, and so which period a return falls in.\n     *\n     * Honoured under both cohort modes. Note that a non-UTC zone makes\n     * `first-ever` read raw events instead of its daily rollup — the rollup is\n     * cut on UTC days and cannot be re-cut after the fact — so expect a slower\n     * query in exchange for cohorts that match the reader's calendar.\n     */\n    timezone: zTimezone.optional(),\n    /** Accepted for symmetry with events.timeseries; retention reads named or all-event activity and does not yet apply the internal filter. */\n    includeInternal: z.boolean().default(false),\n  })\n  .refine((input) => input.startDate <= input.endDate, {\n    message: \"endDate must be on or after startDate\",\n    path: [\"endDate\"],\n  });\nexport type RetentionInput = z.input<typeof zRetentionInput>;\n\nexport const zRetentionCell = z.object({\n  /** `0` is the cohort's own period. */\n  period: z.number().int().nonnegative(),\n  users: z.number().int().nonnegative(),\n  /** Percent of `cohortSize`. */\n  rate: z.number(),\n});\n\nexport const zRetentionData = z.object({\n  matrix: z.array(\n    z.object({\n      /** Cohort bucket start, same shape and zone as {@link zBucketStart}. */\n      cohortDate: zBucketStart,\n      cohortSize: z.number().int().nonnegative(),\n      /** Length is `periods + 1`, index-aligned to `period`. */\n      retention: z.array(zRetentionCell),\n    })\n  ),\n  /** Unweighted mean rate per period across cohorts. */\n  averageRetention: z.array(z.object({ period: z.number().int().nonnegative(), rate: z.number() })),\n  interval: zRetentionInterval,\n  periods: z.number().int(),\n  retentionType: z.enum([\"bounded\", \"unbounded\"]),\n  /** Zone the cohort days were cut in. Mirrors `meta.timezone`. */\n  timezone: z.string(),\n});\nexport type RetentionData = z.infer<typeof zRetentionData>;\n\nexport const zRetentionResponse = zQueryEnvelope(zRetentionData);\nexport type RetentionResponse = z.infer<typeof zRetentionResponse>;\n\n// ─── traffic ────────────────────────────────────────────────────────────────\n\n/**\n * Session-level traffic for a brand site, served from the hourly rollups.\n * `newVisitors` counts sessions whose device was first seen inside them;\n * `returningVisitors` is the rest. Both are session counts, not people —\n * \"visitor\" is the vocabulary the dashboards already use.\n */\nexport const zTrafficOverviewInput = z\n  .object({\n    projectId: z.string().min(1),\n    startDate: zDate,\n    endDate: zDate,\n    granularity: zGranularity.default(\"day\"),\n    timezone: zTimezone.optional(),\n  })\n  .refine((input) => input.startDate <= input.endDate, {\n    message: \"endDate must be on or after startDate\",\n    path: [\"endDate\"],\n  });\nexport type TrafficOverviewInput = z.input<typeof zTrafficOverviewInput>;\n\nexport const zTrafficTotals = z.object({\n  sessions: z.number().int().nonnegative(),\n  pageviews: z.number().int().nonnegative(),\n  newVisitors: z.number().int().nonnegative(),\n  returningVisitors: z.number().int().nonnegative(),\n  /** Percent of sessions that bounced, two decimals. */\n  bounceRate: z.number(),\n});\nexport type TrafficTotals = z.infer<typeof zTrafficTotals>;\n\nexport const zTrafficSeriesPoint = zTrafficTotals.extend({ date: zBucketStart });\n\nexport const zTrafficOverviewData = z.object({\n  granularity: zGranularity,\n  timezone: z.string(),\n  totals: zTrafficTotals,\n  series: z.array(zTrafficSeriesPoint),\n});\nexport type TrafficOverviewData = z.infer<typeof zTrafficOverviewData>;\nexport const zTrafficOverviewResponse = zQueryEnvelope(zTrafficOverviewData);\nexport type TrafficOverviewResponse = z.infer<typeof zTrafficOverviewResponse>;\n\nexport const zTrafficDimension = z.enum([\"channel\", \"referrer\", \"utm\"]);\nexport type TrafficDimension = z.infer<typeof zTrafficDimension>;\n\nexport const zTrafficSourcesInput = z\n  .object({\n    projectId: z.string().min(1),\n    startDate: zDate,\n    endDate: zDate,\n    /** `channel`: channel_type · `referrer`: referrer name+type · `utm`: source/medium/campaign. */\n    dimension: zTrafficDimension,\n    limit: z.number().int().min(1).max(100).default(10),\n    timezone: zTimezone.optional(),\n  })\n  .refine((input) => input.startDate <= input.endDate, {\n    message: \"endDate must be on or after startDate\",\n    path: [\"endDate\"],\n  });\nexport type TrafficSourcesInput = z.input<typeof zTrafficSourcesInput>;\n\nexport const zTrafficSourceRow = zTrafficTotals.extend({\n  /** Display key for the row: the channel, the referrer name, or `source / medium / campaign`. */\n  key: z.string(),\n  channelType: z.string().optional(),\n  referrerName: z.string().optional(),\n  referrerType: z.string().optional(),\n  utmSource: z.string().optional(),\n  utmMedium: z.string().optional(),\n  utmCampaign: z.string().optional(),\n});\nexport type TrafficSourceRow = z.infer<typeof zTrafficSourceRow>;\n\nexport const zTrafficSourcesData = z.object({\n  dimension: zTrafficDimension,\n  timezone: z.string(),\n  /** Ordered by sessions, descending. */\n  rows: z.array(zTrafficSourceRow),\n});\nexport type TrafficSourcesData = z.infer<typeof zTrafficSourcesData>;\nexport const zTrafficSourcesResponse = zQueryEnvelope(zTrafficSourcesData);\nexport type TrafficSourcesResponse = z.infer<typeof zTrafficSourcesResponse>;\n\n// ─── Errors ─────────────────────────────────────────────────────────────────\n\nexport const QUERY_ERROR_CODES = [\n  /** 401 — unknown or mismatched credentials. */\n  \"unauthorized\",\n  /** 403 — the credential's project is not the project asked about. */\n  \"project_scope_mismatch\",\n  /** 403 — the credential lacks the `query` scope. Provision a query-scoped client. */\n  \"query_scope_missing\",\n  /** 400 — input failed the schema. `errors` carries the zod issues. */\n  \"validation_failed\",\n  /** 400 — inputs are individually valid but cannot be served together (e.g. breakdown + segmentId). */\n  \"unsupported_combination\",\n  /** 410 — the project is being deleted. Permanent; stop asking. */\n  \"project_purging\",\n  /** 429 — per-credential query rate limit. `Retry-After` set. */\n  \"rate_limited\",\n  /** 504 — the analytics backend exceeded its statement timeout. Narrow the window. */\n  \"query_timeout\",\n  /** 500 — unexpected server failure. */\n  \"internal_error\",\n] as const;\nexport const zQueryErrorCode = z.enum(QUERY_ERROR_CODES);\nexport type QueryErrorCode = z.infer<typeof zQueryErrorCode>;\n\nexport const zQueryError = z.object({\n  status: z.number().int(),\n  code: zQueryErrorCode,\n  error: z.string(),\n  message: z.string().optional(),\n  errors: z.unknown().optional(),\n  requestId: z.string().optional(),\n});\nexport type QueryError = z.infer<typeof zQueryError>;\n\n/** Paths, so the client and the route handlers cannot drift apart. */\nexport const QUERY_API_PATHS = {\n  eventsTimeseries: \"/api/v1/query/events/timeseries\",\n  funnel: \"/api/v1/query/funnel\",\n  retention: \"/api/v1/query/retention\",\n  trafficOverview: \"/api/v1/query/traffic/overview\",\n  trafficSources: \"/api/v1/query/traffic/sources\",\n} as const;\n"],"mappings":"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"}

package/dist/report.cjs

@@ -1,85 +1,115 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});// src/report.ts
-var _zod = require('zod');
-var REPORT_SPEC_VERSION = 1;
-var zReportRange = _zod.z.string().regex(/^\d+[dhm]$/, "expected a relative range such as 7d or 24h");
-var zReportInterval = _zod.z.enum(["minute", "hour", "day", "week", "month"]);
-var zLegacyChartType = _zod.z.enum([
-  "linear",
-  "bar",
-  "pie",
-  "metric",
-  "area",
-  "gauge",
-  "scatter",
-  "table",
-  "sparkline"
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+let zod = require("zod");
+//#region src/report.ts
+const REPORT_SPEC_VERSION = 1;
+const zReportRange = zod.z.string().regex(/^\d+[dhm]$/, "expected a relative range such as 7d or 24h");
+const zReportInterval = zod.z.enum([
+	"minute",
+	"hour",
+	"day",
+	"week",
+	"month"
 ]);
-var zCommon = {
-  version: _zod.z.literal(REPORT_SPEC_VERSION),
-  range: zReportRange.default("30d"),
-  segmentId: _zod.z.string().min(1).optional()
+const zLegacyChartType = zod.z.enum([
+	"linear",
+	"bar",
+	"pie",
+	"metric",
+	"area",
+	"gauge",
+	"scatter",
+	"table",
+	"sparkline"
+]);
+const zCommon = {
+	version: zod.z.literal(1),
+	range: zReportRange.default("30d"),
+	segmentId: zod.z.string().min(1).optional()
 };
-var zTimeseriesReportSpec = _zod.z.object({
-  ...zCommon,
-  kind: _zod.z.literal("timeseries"),
-  chartType: zLegacyChartType,
-  interval: zReportInterval,
-  events: _zod.z.array(_zod.z.object({ name: _zod.z.string().min(1).max(200) })).min(1).max(20),
-  breakdowns: _zod.z.array(_zod.z.string().min(1).max(200)).max(5).default([]),
-  comparePrevious: _zod.z.boolean().default(false)
+const zTimeseriesReportSpec = zod.z.object({
+	...zCommon,
+	kind: zod.z.literal("timeseries"),
+	chartType: zLegacyChartType,
+	interval: zReportInterval,
+	events: zod.z.array(zod.z.object({ name: zod.z.string().min(1).max(200) })).min(1).max(20),
+	breakdowns: zod.z.array(zod.z.string().min(1).max(200)).max(5).default([]),
+	comparePrevious: zod.z.boolean().default(false)
+});
+const zFunnelReportSpec = zod.z.object({
+	...zCommon,
+	kind: zod.z.literal("funnel"),
+	steps: zod.z.array(zod.z.string().min(1).max(200)).min(2).max(10),
+	windowSeconds: zod.z.number().int().min(60).max(2592e3).default(86400)
 });
-var zFunnelReportSpec = _zod.z.object({
-  ...zCommon,
-  kind: _zod.z.literal("funnel"),
-  steps: _zod.z.array(_zod.z.string().min(1).max(200)).min(2).max(10),
-  windowSeconds: _zod.z.number().int().min(60).max(2592e3).default(86400)
+const zRetentionReportSpec = zod.z.object({
+	...zCommon,
+	kind: zod.z.literal("retention"),
+	interval: zod.z.enum([
+		"day",
+		"week",
+		"month"
+	]).default("day"),
+	periods: zod.z.number().int().min(1).max(30).default(7),
+	startEvent: zod.z.string().min(1).max(200).optional(),
+	returnEvent: zod.z.string().min(1).max(200).optional(),
+	retentionType: zod.z.enum(["bounded", "unbounded"]).default("bounded"),
+	cohortMode: zod.z.enum(["first-ever", "first-in-window"]).default("first-ever")
 });
-var zRetentionReportSpec = _zod.z.object({
-  ...zCommon,
-  kind: _zod.z.literal("retention"),
-  interval: _zod.z.enum(["day", "week", "month"]).default("day"),
-  periods: _zod.z.number().int().min(1).max(30).default(7),
-  startEvent: _zod.z.string().min(1).max(200).optional(),
-  returnEvent: _zod.z.string().min(1).max(200).optional(),
-  retentionType: _zod.z.enum(["bounded", "unbounded"]).default("bounded"),
-  cohortMode: _zod.z.enum(["first-ever", "first-in-window"]).default("first-ever")
+const zPathReportSpec = zod.z.object({
+	...zCommon,
+	kind: zod.z.literal("path"),
+	limit: zod.z.number().int().min(1).max(100).default(30),
+	startPage: zod.z.string().max(2e3).optional(),
+	endPage: zod.z.string().max(2e3).optional()
 });
-var zPathReportSpec = _zod.z.object({
-  ...zCommon,
-  kind: _zod.z.literal("path"),
-  limit: _zod.z.number().int().min(1).max(100).default(30),
-  startPage: _zod.z.string().max(2e3).optional(),
-  endPage: _zod.z.string().max(2e3).optional()
+const zErrorIssuesTopReportSpec = zod.z.object({
+	...zCommon,
+	kind: zod.z.literal("error_issues_top"),
+	limit: zod.z.union([zod.z.literal(5), zod.z.literal(10)]).default(5),
+	sort: zod.z.enum([
+		"occurrences",
+		"users",
+		"lastSeen"
+	]).default("occurrences"),
+	statuses: zod.z.array(zod.z.enum([
+		"active",
+		"resolved",
+		"pending_release",
+		"suppressed",
+		"archived"
+	])).min(1).max(5).default(["active"])
 });
-var zReportSpec = _zod.z.discriminatedUnion("kind", [
-  zTimeseriesReportSpec,
-  zFunnelReportSpec,
-  zRetentionReportSpec,
-  zPathReportSpec
+const zReportSpec = zod.z.discriminatedUnion("kind", [
+	zTimeseriesReportSpec,
+	zFunnelReportSpec,
+	zRetentionReportSpec,
+	zPathReportSpec,
+	zErrorIssuesTopReportSpec
 ]);
 function legacyReportToSpec(input) {
-  const events = _zod.z.array(_zod.z.object({ name: _zod.z.string().min(1).max(200) })).safeParse(input.events);
-  const breakdowns = _zod.z.array(_zod.z.string().min(1).max(200)).safeParse(input.breakdowns);
-  return zTimeseriesReportSpec.parse({
-    version: REPORT_SPEC_VERSION,
-    kind: "timeseries",
-    chartType: input.chartType,
-    interval: input.interval,
-    range: input.range,
-    events: events.success && events.data.length > 0 ? events.data : [{ name: "$pageview" }],
-    breakdowns: breakdowns.success ? breakdowns.data : []
-  });
+	const events = zod.z.array(zod.z.object({ name: zod.z.string().min(1).max(200) })).safeParse(input.events);
+	const breakdowns = zod.z.array(zod.z.string().min(1).max(200)).safeParse(input.breakdowns);
+	return zTimeseriesReportSpec.parse({
+		version: 1,
+		kind: "timeseries",
+		chartType: input.chartType,
+		interval: input.interval,
+		range: input.range,
+		events: events.success && events.data.length > 0 ? events.data : [{ name: "$pageview" }],
+		breakdowns: breakdowns.success ? breakdowns.data : []
+	});
 }
+//#endregion
+exports.REPORT_SPEC_VERSION = REPORT_SPEC_VERSION;
+exports.legacyReportToSpec = legacyReportToSpec;
+exports.zErrorIssuesTopReportSpec = zErrorIssuesTopReportSpec;
+exports.zFunnelReportSpec = zFunnelReportSpec;
+exports.zLegacyChartType = zLegacyChartType;
+exports.zPathReportSpec = zPathReportSpec;
+exports.zReportInterval = zReportInterval;
+exports.zReportRange = zReportRange;
+exports.zReportSpec = zReportSpec;
+exports.zRetentionReportSpec = zRetentionReportSpec;
+exports.zTimeseriesReportSpec = zTimeseriesReportSpec;
 
-
-
-
-
-
-
-
-
-
-
-exports.REPORT_SPEC_VERSION = REPORT_SPEC_VERSION; exports.legacyReportToSpec = legacyReportToSpec; exports.zFunnelReportSpec = zFunnelReportSpec; exports.zLegacyChartType = zLegacyChartType; exports.zPathReportSpec = zPathReportSpec; exports.zReportInterval = zReportInterval; exports.zReportRange = zReportRange; exports.zReportSpec = zReportSpec; exports.zRetentionReportSpec = zRetentionReportSpec; exports.zTimeseriesReportSpec = zTimeseriesReportSpec;
 //# sourceMappingURL=report.cjs.map

package/dist/report.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/eric/reopt-ai/reopt-data/packages/data-contract/dist/report.cjs","../src/report.ts"],"names":[],"mappings":"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","file":"/Users/eric/reopt-ai/reopt-data/packages/data-contract/dist/report.cjs","sourcesContent":[null,"import { z } from \"zod\";\n\nexport const REPORT_SPEC_VERSION = 1 as const;\n\nexport const zReportRange = z.string().regex(/^\\d+[dhm]$/, \"expected a relative range such as 7d or 24h\");\nexport const zReportInterval = z.enum([\"minute\", \"hour\", \"day\", \"week\", \"month\"]);\nexport const zLegacyChartType = z.enum([\n  \"linear\",\n  \"bar\",\n  \"pie\",\n  \"metric\",\n  \"area\",\n  \"gauge\",\n  \"scatter\",\n  \"table\",\n  \"sparkline\",\n]);\n\nconst zCommon = {\n  version: z.literal(REPORT_SPEC_VERSION),\n  range: zReportRange.default(\"30d\"),\n  segmentId: z.string().min(1).optional(),\n};\n\nexport const zTimeseriesReportSpec = z.object({\n  ...zCommon,\n  kind: z.literal(\"timeseries\"),\n  chartType: zLegacyChartType,\n  interval: zReportInterval,\n  events: z\n    .array(z.object({ name: z.string().min(1).max(200) }))\n    .min(1)\n    .max(20),\n  breakdowns: z.array(z.string().min(1).max(200)).max(5).default([]),\n  comparePrevious: z.boolean().default(false),\n});\n\nexport const zFunnelReportSpec = z.object({\n  ...zCommon,\n  kind: z.literal(\"funnel\"),\n  steps: z.array(z.string().min(1).max(200)).min(2).max(10),\n  windowSeconds: z.number().int().min(60).max(2_592_000).default(86_400),\n});\n\nexport const zRetentionReportSpec = z.object({\n  ...zCommon,\n  kind: z.literal(\"retention\"),\n  interval: z.enum([\"day\", \"week\", \"month\"]).default(\"day\"),\n  periods: z.number().int().min(1).max(30).default(7),\n  startEvent: z.string().min(1).max(200).optional(),\n  returnEvent: z.string().min(1).max(200).optional(),\n  retentionType: z.enum([\"bounded\", \"unbounded\"]).default(\"bounded\"),\n  cohortMode: z.enum([\"first-ever\", \"first-in-window\"]).default(\"first-ever\"),\n});\n\nexport const zPathReportSpec = z.object({\n  ...zCommon,\n  kind: z.literal(\"path\"),\n  limit: z.number().int().min(1).max(100).default(30),\n  startPage: z.string().max(2_000).optional(),\n  endPage: z.string().max(2_000).optional(),\n});\n\nexport const zReportSpec = z.discriminatedUnion(\"kind\", [\n  zTimeseriesReportSpec,\n  zFunnelReportSpec,\n  zRetentionReportSpec,\n  zPathReportSpec,\n]);\n\nexport type ReportSpec = z.infer<typeof zReportSpec>;\nexport type TimeseriesReportSpec = z.infer<typeof zTimeseriesReportSpec>;\n\n/** Convert a pre-ReportSpec row into the canonical v1 representation. */\nexport function legacyReportToSpec(input: {\n  chartType: z.infer<typeof zLegacyChartType>;\n  interval: z.infer<typeof zReportInterval>;\n  range: string;\n  events: unknown;\n  breakdowns: unknown;\n}): TimeseriesReportSpec {\n  const events = z.array(z.object({ name: z.string().min(1).max(200) })).safeParse(input.events);\n  const breakdowns = z.array(z.string().min(1).max(200)).safeParse(input.breakdowns);\n  return zTimeseriesReportSpec.parse({\n    version: REPORT_SPEC_VERSION,\n    kind: \"timeseries\",\n    chartType: input.chartType,\n    interval: input.interval,\n    range: input.range,\n    events: events.success && events.data.length > 0 ? events.data : [{ name: \"$pageview\" }],\n    breakdowns: breakdowns.success ? breakdowns.data : [],\n  });\n}\n"]}
+{"version":3,"file":"report.cjs","names":["z"],"sources":["../src/report.ts"],"sourcesContent":["import { z } from \"zod\";\n\nexport const REPORT_SPEC_VERSION = 1 as const;\n\nexport const zReportRange = z.string().regex(/^\\d+[dhm]$/, \"expected a relative range such as 7d or 24h\");\nexport const zReportInterval = z.enum([\"minute\", \"hour\", \"day\", \"week\", \"month\"]);\nexport const zLegacyChartType = z.enum([\n  \"linear\",\n  \"bar\",\n  \"pie\",\n  \"metric\",\n  \"area\",\n  \"gauge\",\n  \"scatter\",\n  \"table\",\n  \"sparkline\",\n]);\n\nconst zCommon = {\n  version: z.literal(REPORT_SPEC_VERSION),\n  range: zReportRange.default(\"30d\"),\n  segmentId: z.string().min(1).optional(),\n};\n\nexport const zTimeseriesReportSpec = z.object({\n  ...zCommon,\n  kind: z.literal(\"timeseries\"),\n  chartType: zLegacyChartType,\n  interval: zReportInterval,\n  events: z\n    .array(z.object({ name: z.string().min(1).max(200) }))\n    .min(1)\n    .max(20),\n  breakdowns: z.array(z.string().min(1).max(200)).max(5).default([]),\n  comparePrevious: z.boolean().default(false),\n});\n\nexport const zFunnelReportSpec = z.object({\n  ...zCommon,\n  kind: z.literal(\"funnel\"),\n  steps: z.array(z.string().min(1).max(200)).min(2).max(10),\n  windowSeconds: z.number().int().min(60).max(2_592_000).default(86_400),\n});\n\nexport const zRetentionReportSpec = z.object({\n  ...zCommon,\n  kind: z.literal(\"retention\"),\n  interval: z.enum([\"day\", \"week\", \"month\"]).default(\"day\"),\n  periods: z.number().int().min(1).max(30).default(7),\n  startEvent: z.string().min(1).max(200).optional(),\n  returnEvent: z.string().min(1).max(200).optional(),\n  retentionType: z.enum([\"bounded\", \"unbounded\"]).default(\"bounded\"),\n  cohortMode: z.enum([\"first-ever\", \"first-in-window\"]).default(\"first-ever\"),\n});\n\nexport const zPathReportSpec = z.object({\n  ...zCommon,\n  kind: z.literal(\"path\"),\n  limit: z.number().int().min(1).max(100).default(30),\n  startPage: z.string().max(2_000).optional(),\n  endPage: z.string().max(2_000).optional(),\n});\n\n/**\n * The issues throwing hardest, as a dashboard tile.\n *\n * The only spec kind with no `events`: it reads issues, which are rows in\n * Postgres joined to occurrence volumes, not an event query. `range` is\n * inherited from `zCommon` and is what the tile counts occurrences over.\n */\nexport const zErrorIssuesTopReportSpec = z.object({\n  ...zCommon,\n  kind: z.literal(\"error_issues_top\"),\n  limit: z.union([z.literal(5), z.literal(10)]).default(5),\n  sort: z.enum([\"occurrences\", \"users\", \"lastSeen\"]).default(\"occurrences\"),\n  /**\n   * Issue states the tile counts. Defaults to `active` alone: a dashboard tile\n   * is a thing somebody glances at to decide whether to act, and resolved\n   * issues are exactly the ones already decided.\n   */\n  statuses: z\n    .array(z.enum([\"active\", \"resolved\", \"pending_release\", \"suppressed\", \"archived\"]))\n    .min(1)\n    .max(5)\n    .default([\"active\"]),\n});\n\nexport const zReportSpec = z.discriminatedUnion(\"kind\", [\n  zTimeseriesReportSpec,\n  zFunnelReportSpec,\n  zRetentionReportSpec,\n  zPathReportSpec,\n  zErrorIssuesTopReportSpec,\n]);\n\nexport type ReportSpec = z.infer<typeof zReportSpec>;\nexport type TimeseriesReportSpec = z.infer<typeof zTimeseriesReportSpec>;\nexport type ErrorIssuesTopReportSpec = z.infer<typeof zErrorIssuesTopReportSpec>;\n\n/** Convert a pre-ReportSpec row into the canonical v1 representation. */\nexport function legacyReportToSpec(input: {\n  chartType: z.infer<typeof zLegacyChartType>;\n  interval: z.infer<typeof zReportInterval>;\n  range: string;\n  events: unknown;\n  breakdowns: unknown;\n}): TimeseriesReportSpec {\n  const events = z.array(z.object({ name: z.string().min(1).max(200) })).safeParse(input.events);\n  const breakdowns = z.array(z.string().min(1).max(200)).safeParse(input.breakdowns);\n  return zTimeseriesReportSpec.parse({\n    version: REPORT_SPEC_VERSION,\n    kind: \"timeseries\",\n    chartType: input.chartType,\n    interval: input.interval,\n    range: input.range,\n    events: events.success && events.data.length > 0 ? events.data : [{ name: \"$pageview\" }],\n    breakdowns: breakdowns.success ? breakdowns.data : [],\n  });\n}\n"],"mappings":"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"}