@reopt-ai/data-contract 0.1.0 → 0.3.0

package/dist/query.cjs

@@ -23,12 +23,12 @@
 
 
 
-var _chunkDHSMXB54cjs = require('./chunk-DHSMXB54.cjs');
 
+var _chunkI2T4HRBMcjs = require('./chunk-I2T4HRBM.cjs');
 
 
-var _chunkZQVRSCTWcjs = require('./chunk-ZQVRSCTW.cjs');
 
+var _chunkKXEQGD3Ecjs = require('./chunk-KXEQGD3E.cjs');
 
 
 
@@ -55,5 +55,7 @@ var _chunkZQVRSCTWcjs = require('./chunk-ZQVRSCTW.cjs');
 
 
 
-exports.QUERY_API_PATHS = _chunkDHSMXB54cjs.QUERY_API_PATHS; exports.QUERY_ERROR_CODES = _chunkDHSMXB54cjs.QUERY_ERROR_CODES; exports.isValidTimeZone = _chunkDHSMXB54cjs.isValidTimeZone; exports.zChannelFilter = _chunkDHSMXB54cjs.zChannelFilter; exports.zDate = _chunkZQVRSCTWcjs.zDate; exports.zEventsTimeseriesData = _chunkDHSMXB54cjs.zEventsTimeseriesData; exports.zEventsTimeseriesInput = _chunkDHSMXB54cjs.zEventsTimeseriesInput; exports.zEventsTimeseriesResponse = _chunkDHSMXB54cjs.zEventsTimeseriesResponse; exports.zFunnelData = _chunkDHSMXB54cjs.zFunnelData; exports.zFunnelInput = _chunkDHSMXB54cjs.zFunnelInput; exports.zFunnelResponse = _chunkDHSMXB54cjs.zFunnelResponse; exports.zFunnelStep = _chunkDHSMXB54cjs.zFunnelStep; exports.zGranularity = _chunkDHSMXB54cjs.zGranularity; exports.zInstant = _chunkZQVRSCTWcjs.zInstant; exports.zQueryEnvelope = _chunkDHSMXB54cjs.zQueryEnvelope; exports.zQueryError = _chunkDHSMXB54cjs.zQueryError; exports.zQueryErrorCode = _chunkDHSMXB54cjs.zQueryErrorCode; exports.zQueryMeta = _chunkDHSMXB54cjs.zQueryMeta; exports.zRetentionCell = _chunkDHSMXB54cjs.zRetentionCell; exports.zRetentionData = _chunkDHSMXB54cjs.zRetentionData; exports.zRetentionInput = _chunkDHSMXB54cjs.zRetentionInput; exports.zRetentionInterval = _chunkDHSMXB54cjs.zRetentionInterval; exports.zRetentionResponse = _chunkDHSMXB54cjs.zRetentionResponse; exports.zTimeseriesBreakdown = _chunkDHSMXB54cjs.zTimeseriesBreakdown; exports.zTimeseriesPoint = _chunkDHSMXB54cjs.zTimeseriesPoint; exports.zTimezone = _chunkDHSMXB54cjs.zTimezone;
+
+
+exports.QUERY_API_PATHS = _chunkI2T4HRBMcjs.QUERY_API_PATHS; exports.QUERY_ERROR_CODES = _chunkI2T4HRBMcjs.QUERY_ERROR_CODES; exports.isValidTimeZone = _chunkI2T4HRBMcjs.isValidTimeZone; exports.zBucketStart = _chunkI2T4HRBMcjs.zBucketStart; exports.zChannelFilter = _chunkI2T4HRBMcjs.zChannelFilter; exports.zDate = _chunkKXEQGD3Ecjs.zDate; exports.zEventsTimeseriesData = _chunkI2T4HRBMcjs.zEventsTimeseriesData; exports.zEventsTimeseriesInput = _chunkI2T4HRBMcjs.zEventsTimeseriesInput; exports.zEventsTimeseriesResponse = _chunkI2T4HRBMcjs.zEventsTimeseriesResponse; exports.zFunnelData = _chunkI2T4HRBMcjs.zFunnelData; exports.zFunnelInput = _chunkI2T4HRBMcjs.zFunnelInput; exports.zFunnelResponse = _chunkI2T4HRBMcjs.zFunnelResponse; exports.zFunnelStep = _chunkI2T4HRBMcjs.zFunnelStep; exports.zGranularity = _chunkI2T4HRBMcjs.zGranularity; exports.zInstant = _chunkKXEQGD3Ecjs.zInstant; exports.zQueryEnvelope = _chunkI2T4HRBMcjs.zQueryEnvelope; exports.zQueryError = _chunkI2T4HRBMcjs.zQueryError; exports.zQueryErrorCode = _chunkI2T4HRBMcjs.zQueryErrorCode; exports.zQueryMeta = _chunkI2T4HRBMcjs.zQueryMeta; exports.zRetentionCell = _chunkI2T4HRBMcjs.zRetentionCell; exports.zRetentionData = _chunkI2T4HRBMcjs.zRetentionData; exports.zRetentionInput = _chunkI2T4HRBMcjs.zRetentionInput; exports.zRetentionInterval = _chunkI2T4HRBMcjs.zRetentionInterval; exports.zRetentionResponse = _chunkI2T4HRBMcjs.zRetentionResponse; exports.zTimeseriesBreakdown = _chunkI2T4HRBMcjs.zTimeseriesBreakdown; exports.zTimeseriesPoint = _chunkI2T4HRBMcjs.zTimeseriesPoint; exports.zTimezone = _chunkI2T4HRBMcjs.zTimezone;
 //# sourceMappingURL=query.cjs.map

package/dist/query.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/eric/reopt-ai/reopt-data/packages/data-contract/dist/query.cjs"],"names":[],"mappings":"AAAA;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,wDAA6B;AAC7B;AACE;AACA;AACF,wDAA6B;AAC7B;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,uhDAAC","file":"/Users/eric/reopt-ai/reopt-data/packages/data-contract/dist/query.cjs"}
+{"version":3,"sources":["/Users/eric/reopt-ai/reopt-data/packages/data-contract/dist/query.cjs"],"names":[],"mappings":"AAAA;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,wDAA6B;AAC7B;AACE;AACA;AACF,wDAA6B;AAC7B;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,8kDAAC","file":"/Users/eric/reopt-ai/reopt-data/packages/data-contract/dist/query.cjs"}

package/dist/query.d.cts

@@ -108,6 +108,20 @@ declare const zEventsTimeseriesInput: z.ZodObject<{
     timezone: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 type EventsTimeseriesInput = z.input<typeof zEventsTimeseriesInput>;
+/**
+ * Bucket start as wall-clock time in `meta.timezone`, `YYYY-MM-DD HH:MM:SS`.
+ *
+ * Pinned rather than left to the backend, because a consumer keys its chart on
+ * this string: an unspecified format is one where two backends, or two
+ * granularities, can quietly disagree and produce two different keys for the
+ * same bucket.
+ *
+ * It is wall time, not an instant — for `Asia/Seoul` a day bucket reads
+ * `2026-08-24 00:00:00`, which is `2026-08-23T15:00:00Z`. Day, week and month
+ * buckets always carry `00:00:00`, so slicing the first ten characters is a
+ * safe way to get a date key.
+ */
+declare const zBucketStart: z.ZodString;
 declare const zTimeseriesPoint: z.ZodObject<{
     date: z.ZodString;
     count: z.ZodNumber;
@@ -334,29 +348,31 @@ declare const zRetentionResponse: z.ZodObject<{
     }, z.core.$strip>;
 }, z.core.$strip>;
 type RetentionResponse = z.infer<typeof zRetentionResponse>;
-declare const QUERY_ERROR_CODES: readonly ["unauthorized", "project_scope_mismatch", "query_scope_missing", "validation_failed", "unsupported_combination", "rate_limited", "query_timeout", "internal_error"];
+declare const QUERY_ERROR_CODES: readonly ["unauthorized", "project_scope_mismatch", "query_scope_missing", "validation_failed", "unsupported_combination", "project_purging", "rate_limited", "query_timeout", "internal_error"];
 declare const zQueryErrorCode: z.ZodEnum<{
+    validation_failed: "validation_failed";
     unauthorized: "unauthorized";
+    rate_limited: "rate_limited";
+    project_purging: "project_purging";
+    internal_error: "internal_error";
     project_scope_mismatch: "project_scope_mismatch";
     query_scope_missing: "query_scope_missing";
-    validation_failed: "validation_failed";
     unsupported_combination: "unsupported_combination";
-    rate_limited: "rate_limited";
     query_timeout: "query_timeout";
-    internal_error: "internal_error";
 }>;
 type QueryErrorCode = z.infer<typeof zQueryErrorCode>;
 declare const zQueryError: z.ZodObject<{
     status: z.ZodNumber;
     code: z.ZodEnum<{
+        validation_failed: "validation_failed";
         unauthorized: "unauthorized";
+        rate_limited: "rate_limited";
+        project_purging: "project_purging";
+        internal_error: "internal_error";
         project_scope_mismatch: "project_scope_mismatch";
         query_scope_missing: "query_scope_missing";
-        validation_failed: "validation_failed";
         unsupported_combination: "unsupported_combination";
-        rate_limited: "rate_limited";
         query_timeout: "query_timeout";
-        internal_error: "internal_error";
     }>;
     error: z.ZodString;
     message: z.ZodOptional<z.ZodString>;
@@ -371,4 +387,4 @@ declare const QUERY_API_PATHS: {
     readonly retention: "/api/v1/query/retention";
 };
 
-export { type ChannelFilter, type EventsTimeseriesData, type EventsTimeseriesInput, type EventsTimeseriesResponse, type FunnelData, type FunnelInput, type FunnelResponse, type Granularity, QUERY_API_PATHS, QUERY_ERROR_CODES, type QueryError, type QueryErrorCode, type QueryMeta, type RetentionData, type RetentionInput, type RetentionResponse, type TimeseriesBreakdown, type TimeseriesPoint, isValidTimeZone, zChannelFilter, zEventsTimeseriesData, zEventsTimeseriesInput, zEventsTimeseriesResponse, zFunnelData, zFunnelInput, zFunnelResponse, zFunnelStep, zGranularity, zQueryEnvelope, zQueryError, zQueryErrorCode, zQueryMeta, zRetentionCell, zRetentionData, zRetentionInput, zRetentionInterval, zRetentionResponse, zTimeseriesBreakdown, zTimeseriesPoint, zTimezone };
+export { type ChannelFilter, type EventsTimeseriesData, type EventsTimeseriesInput, type EventsTimeseriesResponse, type FunnelData, type FunnelInput, type FunnelResponse, type Granularity, QUERY_API_PATHS, QUERY_ERROR_CODES, type QueryError, type QueryErrorCode, type QueryMeta, type RetentionData, type RetentionInput, type RetentionResponse, type TimeseriesBreakdown, type TimeseriesPoint, isValidTimeZone, zBucketStart, zChannelFilter, zEventsTimeseriesData, zEventsTimeseriesInput, zEventsTimeseriesResponse, zFunnelData, zFunnelInput, zFunnelResponse, zFunnelStep, zGranularity, zQueryEnvelope, zQueryError, zQueryErrorCode, zQueryMeta, zRetentionCell, zRetentionData, zRetentionInput, zRetentionInterval, zRetentionResponse, zTimeseriesBreakdown, zTimeseriesPoint, zTimezone };

package/dist/query.d.ts

@@ -108,6 +108,20 @@ declare const zEventsTimeseriesInput: z.ZodObject<{
     timezone: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 type EventsTimeseriesInput = z.input<typeof zEventsTimeseriesInput>;
+/**
+ * Bucket start as wall-clock time in `meta.timezone`, `YYYY-MM-DD HH:MM:SS`.
+ *
+ * Pinned rather than left to the backend, because a consumer keys its chart on
+ * this string: an unspecified format is one where two backends, or two
+ * granularities, can quietly disagree and produce two different keys for the
+ * same bucket.
+ *
+ * It is wall time, not an instant — for `Asia/Seoul` a day bucket reads
+ * `2026-08-24 00:00:00`, which is `2026-08-23T15:00:00Z`. Day, week and month
+ * buckets always carry `00:00:00`, so slicing the first ten characters is a
+ * safe way to get a date key.
+ */
+declare const zBucketStart: z.ZodString;
 declare const zTimeseriesPoint: z.ZodObject<{
     date: z.ZodString;
     count: z.ZodNumber;
@@ -334,29 +348,31 @@ declare const zRetentionResponse: z.ZodObject<{
     }, z.core.$strip>;
 }, z.core.$strip>;
 type RetentionResponse = z.infer<typeof zRetentionResponse>;
-declare const QUERY_ERROR_CODES: readonly ["unauthorized", "project_scope_mismatch", "query_scope_missing", "validation_failed", "unsupported_combination", "rate_limited", "query_timeout", "internal_error"];
+declare const QUERY_ERROR_CODES: readonly ["unauthorized", "project_scope_mismatch", "query_scope_missing", "validation_failed", "unsupported_combination", "project_purging", "rate_limited", "query_timeout", "internal_error"];
 declare const zQueryErrorCode: z.ZodEnum<{
+    validation_failed: "validation_failed";
     unauthorized: "unauthorized";
+    rate_limited: "rate_limited";
+    project_purging: "project_purging";
+    internal_error: "internal_error";
     project_scope_mismatch: "project_scope_mismatch";
     query_scope_missing: "query_scope_missing";
-    validation_failed: "validation_failed";
     unsupported_combination: "unsupported_combination";
-    rate_limited: "rate_limited";
     query_timeout: "query_timeout";
-    internal_error: "internal_error";
 }>;
 type QueryErrorCode = z.infer<typeof zQueryErrorCode>;
 declare const zQueryError: z.ZodObject<{
     status: z.ZodNumber;
     code: z.ZodEnum<{
+        validation_failed: "validation_failed";
         unauthorized: "unauthorized";
+        rate_limited: "rate_limited";
+        project_purging: "project_purging";
+        internal_error: "internal_error";
         project_scope_mismatch: "project_scope_mismatch";
         query_scope_missing: "query_scope_missing";
-        validation_failed: "validation_failed";
         unsupported_combination: "unsupported_combination";
-        rate_limited: "rate_limited";
         query_timeout: "query_timeout";
-        internal_error: "internal_error";
     }>;
     error: z.ZodString;
     message: z.ZodOptional<z.ZodString>;
@@ -371,4 +387,4 @@ declare const QUERY_API_PATHS: {
     readonly retention: "/api/v1/query/retention";
 };
 
-export { type ChannelFilter, type EventsTimeseriesData, type EventsTimeseriesInput, type EventsTimeseriesResponse, type FunnelData, type FunnelInput, type FunnelResponse, type Granularity, QUERY_API_PATHS, QUERY_ERROR_CODES, type QueryError, type QueryErrorCode, type QueryMeta, type RetentionData, type RetentionInput, type RetentionResponse, type TimeseriesBreakdown, type TimeseriesPoint, isValidTimeZone, zChannelFilter, zEventsTimeseriesData, zEventsTimeseriesInput, zEventsTimeseriesResponse, zFunnelData, zFunnelInput, zFunnelResponse, zFunnelStep, zGranularity, zQueryEnvelope, zQueryError, zQueryErrorCode, zQueryMeta, zRetentionCell, zRetentionData, zRetentionInput, zRetentionInterval, zRetentionResponse, zTimeseriesBreakdown, zTimeseriesPoint, zTimezone };
+export { type ChannelFilter, type EventsTimeseriesData, type EventsTimeseriesInput, type EventsTimeseriesResponse, type FunnelData, type FunnelInput, type FunnelResponse, type Granularity, QUERY_API_PATHS, QUERY_ERROR_CODES, type QueryError, type QueryErrorCode, type QueryMeta, type RetentionData, type RetentionInput, type RetentionResponse, type TimeseriesBreakdown, type TimeseriesPoint, isValidTimeZone, zBucketStart, zChannelFilter, zEventsTimeseriesData, zEventsTimeseriesInput, zEventsTimeseriesResponse, zFunnelData, zFunnelInput, zFunnelResponse, zFunnelStep, zGranularity, zQueryEnvelope, zQueryError, zQueryErrorCode, zQueryMeta, zRetentionCell, zRetentionData, zRetentionInput, zRetentionInterval, zRetentionResponse, zTimeseriesBreakdown, zTimeseriesPoint, zTimezone };

package/dist/query.js

@@ -2,6 +2,7 @@ import {
   QUERY_API_PATHS,
   QUERY_ERROR_CODES,
   isValidTimeZone,
+  zBucketStart,
   zChannelFilter,
   zEventsTimeseriesData,
   zEventsTimeseriesInput,
@@ -23,15 +24,16 @@ import {
   zTimeseriesBreakdown,
   zTimeseriesPoint,
   zTimezone
-} from "./chunk-SJYY42BP.js";
+} from "./chunk-55IWO4S3.js";
 import {
   zDate,
   zInstant
-} from "./chunk-IAOPUBJU.js";
+} from "./chunk-2LJ7JLDX.js";
 export {
   QUERY_API_PATHS,
   QUERY_ERROR_CODES,
   isValidTimeZone,
+  zBucketStart,
   zChannelFilter,
   zDate,
   zEventsTimeseriesData,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reopt-ai/data-contract",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "Wire contract (zod schemas + typed client) for the reopt-data ingest and query APIs",
   "license": "MIT",
   "repository": {
@@ -30,6 +30,11 @@
       "import": "./dist/query.js",
       "require": "./dist/query.cjs"
     },
+    "./control": {
+      "types": "./dist/control.d.ts",
+      "import": "./dist/control.js",
+      "require": "./dist/control.cjs"
+    },
     "./client": {
       "types": "./dist/client.d.ts",
       "import": "./dist/client.js",
@@ -42,21 +47,21 @@
   "files": [
     "dist"
   ],
-  "scripts": {
-    "build": "tsup",
-    "check-types": "tsc --noEmit",
-    "dev": "tsup --watch",
-    "lint": "oxlint .",
-    "test": "pnpm run build && tsx --test src/__tests__/ingest.test.ts src/__tests__/query.test.ts src/__tests__/client.test.ts src/__tests__/package-identity.test.ts"
-  },
   "dependencies": {
     "zod": "^4.4.3"
   },
   "devDependencies": {
-    "@repo/typescript-config": "workspace:*",
     "@types/node": "^22.20.1",
     "tsup": "^8.5.1",
     "tsx": "^4.23.12",
-    "typescript": "^5.9.3"
+    "typescript": "^5.9.3",
+    "@repo/typescript-config": "0.0.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "check-types": "tsc --noEmit",
+    "dev": "tsup --watch",
+    "lint": "oxlint .",
+    "test": "pnpm run build && tsx --test src/__tests__/ingest.test.ts src/__tests__/query.test.ts src/__tests__/control.test.ts src/__tests__/client.test.ts src/__tests__/package-identity.test.ts"
   }
-}
+}

package/dist/chunk-DHSMXB54.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["/Users/eric/reopt-ai/reopt-data/packages/data-contract/dist/chunk-DHSMXB54.cjs","../src/query.ts"],"names":[],"mappings":"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","file":"/Users/eric/reopt-ai/reopt-data/packages/data-contract/dist/chunk-DHSMXB54.cjs","sourcesContent":[null,"/**\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 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 materialization was when the computation ran, in seconds:\n   * the age of the oldest raw event not yet materialized, or `0` when nothing\n   * is pending.\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(),\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  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(10).default(5),\n});\nexport type TimeseriesBreakdown = z.infer<typeof zTimeseriesBreakdown>;\n\nexport const zEventsTimeseriesInput = z.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  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});\nexport type EventsTimeseriesInput = z.input<typeof zEventsTimeseriesInput>;\n\nexport const zTimeseriesPoint = z.object({\n  /** Bucket start, formatted by the analytics backend for the requested granularity. */\n  date: z.string(),\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.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});\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.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});\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      cohortDate: z.string(),\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// ─── 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  /** 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} as const;\n"]}

package/dist/chunk-HRKELGGH.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["/Users/eric/reopt-ai/reopt-data/packages/data-contract/dist/chunk-HRKELGGH.cjs","../src/ingest.ts"],"names":[],"mappings":"AAAA;ACWA,0BAAkB;AAGX,IAAM,qBAAA,EAAuB,CAAC,eAAA,EAAiB,aAAA,EAAe,aAAa,CAAA;AAG3E,IAAM,wBAAA,EAA0B,KAAA;AAEvC,IAAM,qBAAA,EAAuB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAM3B,OAAA,EAAS,MAAA,CAAE,IAAA,CAAK,CAAA;AAAA;AAAA,EAEhB,SAAA,EAAW,MAAA,CAAE,MAAA,CAAO,CAAA,CAAE,GAAA,CAAI,CAAA,CAAE,WAAA,CAAY;AAC1C,CAAA;AAEO,IAAM,cAAA,EAAgB,MAAA,CAC1B,MAAA,CAAO;AAAA,EACN,IAAA,EAAM,MAAA,CAAE,MAAA,CAAO,CAAA,CAAE,GAAA,CAAI,CAAC,CAAA,CAAE,GAAA,CAAI,GAAG,CAAA;AAAA,EAC/B,UAAA,EAAY,MAAA,CAAE,MAAA,CAAO,MAAA,CAAE,MAAA,CAAO,CAAA,EAAG,MAAA,CAAE,OAAA,CAAQ,CAAC,CAAA,CAAE,QAAA,CAAS,CAAA;AAAA,EACvD,SAAA,EAAW,MAAA,CAAE,MAAA,CAAO,CAAA,CAAE,GAAA,CAAI,GAAG,CAAA,CAAE,EAAA,CAAG,MAAA,CAAE,MAAA,CAAO,CAAC,CAAA,CAAE,QAAA,CAAS;AACzD,CAAC,CAAA,CACA,MAAA,CAAO,CAAC,IAAA,EAAA,GAAS,CAAC,oBAAA,CAAqB,QAAA,CAAS,IAAA,CAAK,IAAa,CAAA,EAAG;AAAA,EACpE,OAAA,EAAS,CAAA,gDAAA,EAAmD,oBAAA,CAAqB,IAAA,CAAK,IAAI,CAAC,CAAA,CAAA;AAC9E,EAAA;AACd;AAEsC;AACY,EAAA;AACX,EAAA;AACD,EAAA;AACJ,EAAA;AACA,EAAA;AACoB,EAAA;AACxD;AAEyC;AACW,EAAA;AAChB,EAAA;AACG,EAAA;AACvC;AAEyC;AACW,EAAA;AAChB,EAAA;AACG,EAAA;AACvC;AAEgE;AACuB,EAAA;AACM,EAAA;AACpB,EAAA;AACA,EAAA;AACzE;AAqB+C;AACF;AAUN;AAAA;AAEtC,EAAA;AAAA;AAEA,EAAA;AAAA;AAEA,EAAA;AACF;AACqE;AAG5B;AAAA;AAErB,EAAA;AAAA;AAEkB,EAAA;AAC5B,EAAA;AACqB,EAAA;AAC9B;AAGoB;AAAA;AAEoB,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAME,EAAA;AAAA;AAEP,EAAA;AACpC;AAG0C;AAClB,EAAA;AACF,EAAA;AACd,EAAA;AACH,EAAA;AACe,EAAA;AACnB;AAQ+C;AAClB,EAAA;AACR,EAAA;AACd,EAAA;AACH,EAAA;AAC8B,EAAA;AACY,EAAA;AAC9C;AAEiF;AAcY;AACd,EAAA;AAChF;AAQkC;AAAA;AAEhC,EAAA;AAAA;AAEA,EAAA;AAAA;AAEA,EAAA;AAAA;AAEA,EAAA;AAAA;AAEA,EAAA;AAAA;AAEA,EAAA;AAAA;AAEA,EAAA;AAAA;AAEA,EAAA;AAAA;AAEA,EAAA;AAAA;AAEA,EAAA;AACF;AACyD;AAGpB;AACZ,EAAA;AACjB,EAAA;AACU,EAAA;AACa,EAAA;AAAA;AAEA,EAAA;AACE,EAAA;AAChC;ADtF6F;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA","file":"/Users/eric/reopt-ai/reopt-data/packages/data-contract/dist/chunk-HRKELGGH.cjs","sourcesContent":[null,"/**\n * `POST /api/track` — the ingest contract.\n *\n * The request shape is shared by both credential modes. The *response* shape\n * is where server-ingest differs: it reports per-event rejections instead of\n * failing a whole batch, because a forwarder that stalls on one malformed row\n * stops forwarding forever.\n *\n * Absorbed from the former internal `@reopt/ingest-contract`; that package is\n * now a deprecated re-export of this module.\n */\nimport { z } from \"zod\";\n\n/** Event names the pipeline reserves for its own session bookkeeping. */\nexport const RESERVED_EVENT_NAMES = [\"session_start\", \"session_end\", \"screen_view\"] as const;\n\n/** Hard cap enforced by the route before the body is even parsed. */\nexport const MAX_TRACK_PAYLOAD_BYTES = 512_000;\n\nconst zClientEventMetadata = {\n  /**\n   * Client-generated UUID. This is the idempotency key: it becomes the\n   * `RawEvent` primary key, scoped to the project. Re-sending the same\n   * eventId is always safe and always reported as a duplicate.\n   */\n  eventId: z.uuid(),\n  /** Event time, epoch milliseconds. */\n  timestamp: z.number().int().nonnegative(),\n};\n\nexport const zTrackPayload = z\n  .object({\n    name: z.string().min(1).max(200),\n    properties: z.record(z.string(), z.unknown()).optional(),\n    profileId: z.string().max(500).or(z.number()).optional(),\n  })\n  .refine((data) => !RESERVED_EVENT_NAMES.includes(data.name as never), {\n    message: `Event name cannot be one of the reserved names: ${RESERVED_EVENT_NAMES.join(\", \")}`,\n    path: [\"name\"],\n  });\n\nexport const zIdentifyPayload = z.object({\n  profileId: z.string().min(1).max(500).or(z.number()),\n  firstName: z.string().max(200).optional(),\n  lastName: z.string().max(200).optional(),\n  email: z.email().max(320).optional(),\n  avatar: z.url().max(2000).optional(),\n  properties: z.record(z.string(), z.unknown()).optional(),\n});\n\nexport const zIncrementPayload = z.object({\n  profileId: z.string().min(1).max(500).or(z.number()),\n  property: z.string().min(1).max(200),\n  value: z.number().positive().optional(),\n});\n\nexport const zDecrementPayload = z.object({\n  profileId: z.string().min(1).max(500).or(z.number()),\n  property: z.string().min(1).max(200),\n  value: z.number().positive().optional(),\n});\n\nexport const zTrackHandlerPayload = z.discriminatedUnion(\"type\", [\n  z.object({ type: z.literal(\"track\"), payload: zTrackPayload, ...zClientEventMetadata }),\n  z.object({ type: z.literal(\"identify\"), payload: zIdentifyPayload, ...zClientEventMetadata }),\n  z.object({ type: z.literal(\"increment\"), payload: zIncrementPayload, ...zClientEventMetadata }),\n  z.object({ type: z.literal(\"decrement\"), payload: zDecrementPayload, ...zClientEventMetadata }),\n]);\n\nexport type ITrackPayload = z.infer<typeof zTrackPayload>;\nexport type IIdentifyPayload = z.infer<typeof zIdentifyPayload>;\nexport type IIncrementPayload = z.infer<typeof zIncrementPayload>;\nexport type IDecrementPayload = z.infer<typeof zDecrementPayload>;\nexport type ITrackHandlerPayload = z.infer<typeof zTrackHandlerPayload>;\n\n// ─── Ingest mode ────────────────────────────────────────────────────────────\n\n/**\n * Decided by the credential presented, never by a header the caller sets:\n * `reopt-write-key` alone → `browser`, `reopt-client-id` + `reopt-client-secret`\n * → `server`. A separate mode header could disagree with the credential; this\n * cannot.\n *\n * `browser` keeps the 5-second click dedup and device-scoped sessions.\n * `server` drops both and relies solely on `eventId` idempotency — a server\n * batch legitimately contains the same event name many times within one second,\n * and its \"device\" is a process, not a person.\n */\nexport const INGEST_MODES = [\"browser\", \"server\"] as const;\nexport const zIngestMode = z.enum(INGEST_MODES);\nexport type IngestMode = z.infer<typeof zIngestMode>;\n\n// ─── Response ───────────────────────────────────────────────────────────────\n\n/**\n * Why a single event in a batch was dropped. These are permanent: re-sending\n * the same row produces the same rejection, so a forwarder should count it as\n * skipped and advance its cursor rather than retry.\n */\nexport const INGEST_REJECTION_REASONS = [\n  /** Failed the zod schema (bad eventId, missing name, wrong types…). */\n  \"validation_failed\",\n  /** Used one of RESERVED_EVENT_NAMES. */\n  \"reserved_name\",\n  /** Another row earlier in the same batch already claimed this eventId. */\n  \"duplicate_in_batch\",\n] as const;\nexport const zIngestRejectionReason = z.enum(INGEST_REJECTION_REASONS);\nexport type IngestRejectionReason = z.infer<typeof zIngestRejectionReason>;\n\nexport const zIngestRejection = z.object({\n  /** May be absent or malformed on `validation_failed` — hence `string`, not `uuid`. */\n  eventId: z.string(),\n  /** Position in the submitted batch. The only reliable identifier when eventId itself is bad. */\n  index: z.number().int().nonnegative(),\n  reason: zIngestRejectionReason,\n  message: z.string().optional(),\n});\nexport type IngestRejection = z.infer<typeof zIngestRejection>;\n\nconst ingestCounts = {\n  /** Raw events newly persisted by this request. */\n  accepted: z.number().int().nonnegative(),\n  /**\n   * Events the server already had. In `server` mode this is exactly the\n   * eventId-idempotency count; in `browser` mode it also includes the\n   * 5-second click dedup.\n   */\n  duplicates: z.number().int().nonnegative(),\n  /** Always `[]` in `browser` mode, where a bad row fails the whole batch. */\n  rejected: z.array(zIngestRejection),\n};\n\n/** 200 — accepted and handed to the materialize queue. */\nexport const zIngestOkResponse = z.object({\n  status: z.literal(\"ok\"),\n  requestId: z.string(),\n  mode: zIngestMode,\n  ...ingestCounts,\n  queued: z.boolean(),\n});\n\n/**\n * 202 — raw events landed, but enqueueing the materialize task failed. No data\n * is lost: the `replay-unmaterialized` cron picks these up. A forwarder should\n * treat this as success and advance its cursor. Carries the same counts as 200\n * so the reconciliation below works here too.\n */\nexport const zIngestAcceptedResponse = z.object({\n  status: z.literal(\"accepted\"),\n  requestId: z.string(),\n  mode: zIngestMode,\n  ...ingestCounts,\n  backgroundQueued: z.literal(false),\n  replay: z.literal(\"unmaterialized-raw-events\"),\n});\n\nexport const zIngestResponse = z.discriminatedUnion(\"status\", [zIngestOkResponse, zIngestAcceptedResponse]);\n\nexport type IngestOkResponse = z.infer<typeof zIngestOkResponse>;\nexport type IngestAcceptedResponse = z.infer<typeof zIngestAcceptedResponse>;\nexport type IngestResponse = z.infer<typeof zIngestResponse>;\n\n/**\n * The reconciliation a forwarder runs on every 2xx:\n *\n *     accepted + duplicates + rejected.length === events sent\n *\n * A mismatch means the server silently dropped something, which is exactly the\n * failure mode this contract exists to make impossible to miss.\n */\nexport function reconcileIngestResponse(response: IngestResponse, sentCount: number): boolean {\n  return response.accepted + response.duplicates + response.rejected.length === sentCount;\n}\n\n// ─── Errors ─────────────────────────────────────────────────────────────────\n\n/**\n * Stable machine-readable codes. Branch on these, never on `error`/`message`,\n * which are prose and may be reworded.\n */\nexport const INGEST_ERROR_CODES = [\n  /** 401 — unknown or mismatched credentials. Stop and alert; do not retry. */\n  \"unauthorized\",\n  /** 400 — body was not valid JSON. */\n  \"invalid_json\",\n  /** 400 — request exceeded MAX_TRACK_PAYLOAD_BYTES. Split the batch. */\n  \"payload_too_large\",\n  /** 400 — zero events submitted. */\n  \"empty_batch\",\n  /** 400 — batch contained a `type: \"alias\"` event, which is not supported. */\n  \"alias_unsupported\",\n  /** 400 — the project has no organization; it cannot be billed or quota-checked. */\n  \"project_without_organization\",\n  /** 400 — `browser` mode only: a row failed validation. `server` mode reports these in `rejected[]`. */\n  \"validation_failed\",\n  /** 429 — per-project request rate limit. `Retry-After` set. Pause this tick, keep the cursor. */\n  \"rate_limited\",\n  /** 429 — the organization's monthly event quota is exhausted. `Retry-After` set (capped at 1h). Alert: a human must raise the limit. */\n  \"quota_exceeded\",\n  /** 500 — unexpected server failure. Back off and retry. */\n  \"internal_error\",\n] as const;\nexport const zIngestErrorCode = z.enum(INGEST_ERROR_CODES);\nexport type IngestErrorCode = z.infer<typeof zIngestErrorCode>;\n\nexport const zIngestError = z.object({\n  status: z.number().int(),\n  code: zIngestErrorCode,\n  error: z.string(),\n  message: z.string().optional(),\n  /** zod issues, when `code === \"validation_failed\"`. */\n  errors: z.unknown().optional(),\n  requestId: z.string().optional(),\n});\nexport type IngestError = z.infer<typeof zIngestError>;\n"]}

package/dist/chunk-IAOPUBJU.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * `@reopt-ai/data-contract` — the wire contract between reopt-data and its\n * server-credential consumers (RFC-0023).\n *\n * Subpaths:\n *   `@reopt-ai/data-contract`         this module — version, shared primitives, errors\n *   `@reopt-ai/data-contract/ingest`  POST /api/track request + response schemas\n *   `@reopt-ai/data-contract/query`   POST /api/v1/query/* request + response schemas\n *   `@reopt-ai/data-contract/client`  createDataClient() — typed fetch over both\n *\n * Only `/client` touches `fetch`; everything else is pure zod. The single\n * runtime dependency is zod, deliberately — consumers bundle this.\n */\nimport { z } from \"zod\";\n\n/**\n * Contract version. Bumped on any breaking change to a schema in this package.\n * The server echoes the version it was built against in `x-reopt-contract-version`;\n * `createDataClient` surfaces a mismatch rather than guessing.\n */\nexport const CONTRACT_VERSION = \"0.1.0\";\n\n/** Response header carrying the server's contract version. */\nexport const CONTRACT_VERSION_HEADER = \"x-reopt-contract-version\";\n\n/** Request header names shared by the ingest and query planes. */\nexport const CLIENT_ID_HEADER = \"reopt-client-id\";\nexport const CLIENT_SECRET_HEADER = \"reopt-client-secret\";\nexport const WRITE_KEY_HEADER = \"reopt-write-key\";\nexport const DEVICE_ID_HEADER = \"reopt-device-id\";\nexport const REQUEST_ID_HEADER = \"x-request-id\";\n\n/**\n * A UTC calendar date. Windows are inclusive on both ends and are widened\n * server-side to `startDate T00:00:00Z` .. `endDate T23:59:59Z`.\n */\nexport const zDate = z.string().regex(/^\\d{4}-\\d{2}-\\d{2}$/, \"expected YYYY-MM-DD (UTC)\");\n\n/** ISO-8601 instant, as produced by `Date#toISOString()`. */\nexport const zInstant = z.string().min(20);\n\n/**\n * Client credentials. The same pair authenticates both planes; what a given\n * client may reach is decided server-side by `Client.scopes`\n * (`\"ingest\"` / `\"query\"` / `\"provision\"`).\n */\nexport interface ClientCredentials {\n  clientId: string;\n  clientSecret: string;\n}\n\n/**\n * Every non-2xx response from either plane, plus the two failures the client\n * itself raises (`contract_mismatch`, `network_error`).\n */\nexport class DataApiError extends Error {\n  /**\n   * Brand for {@link DataApiError.is}. A bundler that inlines this module into\n   * more than one entry point produces two distinct classes, and `instanceof`\n   * silently stops matching — the brand survives that, and realm boundaries.\n   */\n  readonly isDataApiError = true as const;\n\n  readonly status: number;\n  readonly code: string;\n  readonly requestId?: string;\n  /** Parsed from `Retry-After`, in milliseconds. Only set on 429. */\n  readonly retryAfterMs?: number;\n  /** zod issues for `validation_failed`, or the raw body when unparseable. */\n  readonly details?: unknown;\n\n  constructor(init: {\n    message: string;\n    status: number;\n    code: string;\n    requestId?: string;\n    retryAfterMs?: number;\n    details?: unknown;\n  }) {\n    super(init.message);\n    this.name = \"DataApiError\";\n    this.status = init.status;\n    this.code = init.code;\n    this.requestId = init.requestId;\n    this.retryAfterMs = init.retryAfterMs;\n    this.details = init.details;\n  }\n\n  /** 429 and 5xx are worth retrying; 4xx are the caller's fault and are not. */\n  get retryable(): boolean {\n    return this.status === 429 || this.status >= 500;\n  }\n\n  /**\n   * Prefer this over `instanceof` in a `catch`. It holds even when the class\n   * has been duplicated — across CJS entry points, across bundler chunks, or\n   * across realms — where `instanceof` quietly returns false.\n   */\n  static is(value: unknown): value is DataApiError {\n    return (\n      value instanceof DataApiError ||\n      (typeof value === \"object\" && value !== null && (value as { isDataApiError?: unknown }).isDataApiError === true)\n    );\n  }\n}\n"],"mappings":";AAaA,SAAS,SAAS;AAOX,IAAM,mBAAmB;AAGzB,IAAM,0BAA0B;AAGhC,IAAM,mBAAmB;AACzB,IAAM,uBAAuB;AAC7B,IAAM,mBAAmB;AACzB,IAAM,mBAAmB;AACzB,IAAM,oBAAoB;AAM1B,IAAM,QAAQ,EAAE,OAAO,EAAE,MAAM,uBAAuB,2BAA2B;AAGjF,IAAM,WAAW,EAAE,OAAO,EAAE,IAAI,EAAE;AAgBlC,IAAM,eAAN,MAAM,sBAAqB,MAAM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAM7B,iBAAiB;AAAA,EAEjB;AAAA,EACA;AAAA,EACA;AAAA;AAAA,EAEA;AAAA;AAAA,EAEA;AAAA,EAET,YAAY,MAOT;AACD,UAAM,KAAK,OAAO;AAClB,SAAK,OAAO;AACZ,SAAK,SAAS,KAAK;AACnB,SAAK,OAAO,KAAK;AACjB,SAAK,YAAY,KAAK;AACtB,SAAK,eAAe,KAAK;AACzB,SAAK,UAAU,KAAK;AAAA,EACtB;AAAA;AAAA,EAGA,IAAI,YAAqB;AACvB,WAAO,KAAK,WAAW,OAAO,KAAK,UAAU;AAAA,EAC/C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,OAAO,GAAG,OAAuC;AAC/C,WACE,iBAAiB,iBAChB,OAAO,UAAU,YAAY,UAAU,QAAS,MAAuC,mBAAmB;AAAA,EAE/G;AACF;","names":[]}

package/dist/chunk-SJYY42BP.js.map

@@ -1 +0,0 @@
-{"version":3,"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 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 materialization was when the computation ran, in seconds:\n   * the age of the oldest raw event not yet materialized, or `0` when nothing\n   * is pending.\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(),\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  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(10).default(5),\n});\nexport type TimeseriesBreakdown = z.infer<typeof zTimeseriesBreakdown>;\n\nexport const zEventsTimeseriesInput = z.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  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});\nexport type EventsTimeseriesInput = z.input<typeof zEventsTimeseriesInput>;\n\nexport const zTimeseriesPoint = z.object({\n  /** Bucket start, formatted by the analytics backend for the requested granularity. */\n  date: z.string(),\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.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});\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.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});\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      cohortDate: z.string(),\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// ─── 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  /** 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} as const;\n"],"mappings":"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","names":[]}

package/dist/chunk-ZQVRSCTW.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["/Users/eric/reopt-ai/reopt-data/packages/data-contract/dist/chunk-ZQVRSCTW.cjs","../src/index.ts"],"names":[],"mappings":"AAAA;ACaA,0BAAkB;AAOX,IAAM,iBAAA,EAAmB,OAAA;AAGzB,IAAM,wBAAA,EAA0B,0BAAA;AAGhC,IAAM,iBAAA,EAAmB,iBAAA;AACzB,IAAM,qBAAA,EAAuB,qBAAA;AAC7B,IAAM,iBAAA,EAAmB,iBAAA;AACzB,IAAM,iBAAA,EAAmB,iBAAA;AACzB,IAAM,kBAAA,EAAoB,cAAA;AAM1B,IAAM,MAAA,EAAQ,MAAA,CAAE,MAAA,CAAO,CAAA,CAAE,KAAA,CAAM,qBAAA,EAAuB,2BAA2B,CAAA;AAGjF,IAAM,SAAA,EAAW,MAAA,CAAE,MAAA,CAAO,CAAA,CAAE,GAAA,CAAI,EAAE,CAAA;AAgBlC,IAAM,aAAA,YAAN,MAAM,cAAA,QAAqB,MAAM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,iBAM7B,eAAA,EAAiB,KAAA;AAAA,EAEjB;AAAA,EACA;AAAA,EACA;AAAA;AAAA,EAEA;AAAA;AAAA,EAEA;AAAA,EAET,WAAA,CAAY,IAAA,EAOT;AACD,IAAA,KAAA,CAAM,IAAA,CAAK,OAAO,qCAAA;AAClB,IAAA,IAAA,CAAK,KAAA,EAAO,cAAA;AACZ,IAAA,IAAA,CAAK,OAAA,EAAS,IAAA,CAAK,MAAA;AACnB,IAAA,IAAA,CAAK,KAAA,EAAO,IAAA,CAAK,IAAA;AACjB,IAAA,IAAA,CAAK,UAAA,EAAY,IAAA,CAAK,SAAA;AACtB,IAAA,IAAA,CAAK,aAAA,EAAe,IAAA,CAAK,YAAA;AACzB,IAAA,IAAA,CAAK,QAAA,EAAU,IAAA,CAAK,OAAA;AAAA,EACtB;AAAA;AAAA,EAGA,IAAI,SAAA,CAAA,EAAqB;AACvB,IAAA,OAAO,IAAA,CAAK,OAAA,IAAW,IAAA,GAAO,IAAA,CAAK,OAAA,GAAU,GAAA;AAAA,EAC/C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,OAAO,EAAA,CAAG,KAAA,EAAuC;AAC/C,IAAA,OACE,MAAA,WAAiB,cAAA,GAChB,OAAO,MAAA,IAAU,SAAA,GAAY,MAAA,IAAU,KAAA,GAAS,KAAA,CAAuC,eAAA,IAAmB,IAAA;AAAA,EAE/G;AACF,UAAA;ADzDA;AACA;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,2aAAC","file":"/Users/eric/reopt-ai/reopt-data/packages/data-contract/dist/chunk-ZQVRSCTW.cjs","sourcesContent":[null,"/**\n * `@reopt-ai/data-contract` — the wire contract between reopt-data and its\n * server-credential consumers (RFC-0023).\n *\n * Subpaths:\n *   `@reopt-ai/data-contract`         this module — version, shared primitives, errors\n *   `@reopt-ai/data-contract/ingest`  POST /api/track request + response schemas\n *   `@reopt-ai/data-contract/query`   POST /api/v1/query/* request + response schemas\n *   `@reopt-ai/data-contract/client`  createDataClient() — typed fetch over both\n *\n * Only `/client` touches `fetch`; everything else is pure zod. The single\n * runtime dependency is zod, deliberately — consumers bundle this.\n */\nimport { z } from \"zod\";\n\n/**\n * Contract version. Bumped on any breaking change to a schema in this package.\n * The server echoes the version it was built against in `x-reopt-contract-version`;\n * `createDataClient` surfaces a mismatch rather than guessing.\n */\nexport const CONTRACT_VERSION = \"0.1.0\";\n\n/** Response header carrying the server's contract version. */\nexport const CONTRACT_VERSION_HEADER = \"x-reopt-contract-version\";\n\n/** Request header names shared by the ingest and query planes. */\nexport const CLIENT_ID_HEADER = \"reopt-client-id\";\nexport const CLIENT_SECRET_HEADER = \"reopt-client-secret\";\nexport const WRITE_KEY_HEADER = \"reopt-write-key\";\nexport const DEVICE_ID_HEADER = \"reopt-device-id\";\nexport const REQUEST_ID_HEADER = \"x-request-id\";\n\n/**\n * A UTC calendar date. Windows are inclusive on both ends and are widened\n * server-side to `startDate T00:00:00Z` .. `endDate T23:59:59Z`.\n */\nexport const zDate = z.string().regex(/^\\d{4}-\\d{2}-\\d{2}$/, \"expected YYYY-MM-DD (UTC)\");\n\n/** ISO-8601 instant, as produced by `Date#toISOString()`. */\nexport const zInstant = z.string().min(20);\n\n/**\n * Client credentials. The same pair authenticates both planes; what a given\n * client may reach is decided server-side by `Client.scopes`\n * (`\"ingest\"` / `\"query\"` / `\"provision\"`).\n */\nexport interface ClientCredentials {\n  clientId: string;\n  clientSecret: string;\n}\n\n/**\n * Every non-2xx response from either plane, plus the two failures the client\n * itself raises (`contract_mismatch`, `network_error`).\n */\nexport class DataApiError extends Error {\n  /**\n   * Brand for {@link DataApiError.is}. A bundler that inlines this module into\n   * more than one entry point produces two distinct classes, and `instanceof`\n   * silently stops matching — the brand survives that, and realm boundaries.\n   */\n  readonly isDataApiError = true as const;\n\n  readonly status: number;\n  readonly code: string;\n  readonly requestId?: string;\n  /** Parsed from `Retry-After`, in milliseconds. Only set on 429. */\n  readonly retryAfterMs?: number;\n  /** zod issues for `validation_failed`, or the raw body when unparseable. */\n  readonly details?: unknown;\n\n  constructor(init: {\n    message: string;\n    status: number;\n    code: string;\n    requestId?: string;\n    retryAfterMs?: number;\n    details?: unknown;\n  }) {\n    super(init.message);\n    this.name = \"DataApiError\";\n    this.status = init.status;\n    this.code = init.code;\n    this.requestId = init.requestId;\n    this.retryAfterMs = init.retryAfterMs;\n    this.details = init.details;\n  }\n\n  /** 429 and 5xx are worth retrying; 4xx are the caller's fault and are not. */\n  get retryable(): boolean {\n    return this.status === 429 || this.status >= 500;\n  }\n\n  /**\n   * Prefer this over `instanceof` in a `catch`. It holds even when the class\n   * has been duplicated — across CJS entry points, across bundler chunks, or\n   * across realms — where `instanceof` quietly returns false.\n   */\n  static is(value: unknown): value is DataApiError {\n    return (\n      value instanceof DataApiError ||\n      (typeof value === \"object\" && value !== null && (value as { isDataApiError?: unknown }).isDataApiError === true)\n    );\n  }\n}\n"]}