@interfere/types 0.1.0-alpha.1 → 0.1.0-alpha.2

package/dist/sdk/config.mjs

@@ -1,8 +1,7 @@
 import { PLUGIN_MANIFEST } from "./plugins/manifest.mjs";
-import { API_URL } from "@interfere/constants/api";
 import { z } from "zod/v4";
+import { API_URL } from "@interfere/constants/api";
 import { envSchema, runtimeSchema } from "#sdk/runtime";
-
 //#region src/sdk/config.ts
 const DEFAULT_BATCH_SIZE = 10;
 const DEFAULT_BATCH_MS = 250;
@@ -64,6 +63,5 @@ const persistenceTypeSchema = z.enum([
 	"sessionStorage",
 	"memory"
 ]);
-
 //#endregion
-export { apiBaseUrlSchema, configInputSchema, configSchema, featuresSchema, offlineStorageSchema, persistenceTypeSchema };
+export { apiBaseUrlSchema, configInputSchema, configSchema, featuresSchema, offlineStorageSchema, persistenceTypeSchema };

package/dist/sdk/config.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"config.mjs","names":[],"sources":["../../src/sdk/config.ts"],"sourcesContent":["import { API_URL } from \"@interfere/constants/api\";\n\nimport { z } from \"zod/v4\";\n\nimport { envSchema, runtimeSchema } from \"#sdk/runtime\";\n\nimport type { PluginKey } from \"./plugins/lib/types.js\";\nimport { PLUGIN_MANIFEST } from \"./plugins/manifest.js\";\n\nconst DEFAULT_BATCH_SIZE = 10;\nconst DEFAULT_BATCH_MS = 250;\n\nexport const offlineStorageSchema = z\n  .object({\n    /**\n     * Whether to enable offline storage (IndexedDB persistence).\n     * When enabled, envelopes that fail to send are stored and retried when connectivity returns.\n     * @default false\n     */\n    enabled: z.boolean().default(false),\n    /**\n     * Maximum number of envelopes to store offline.\n     * @default 100\n     */\n    maxQueueSize: z.number().default(100),\n  })\n  .default({ enabled: false, maxQueueSize: 100 });\n\nexport type OfflineStorage = z.infer<typeof offlineStorageSchema>;\n\nexport const apiBaseUrlSchema = z.union([\n  z.string(),\n  z.enum([API_URL, \"http://localhost:3001\"]),\n]);\n\nexport const featuresSchema = z\n  .object(\n    Object.fromEntries(\n      PLUGIN_MANIFEST.map((plugin) => [\n        plugin.name,\n        z.boolean().default(plugin.defaultEnabled),\n      ])\n    ) as Record<PluginKey, z.ZodDefault<z.ZodBoolean>>\n  )\n  .partial()\n  .default(\n    Object.fromEntries(\n      PLUGIN_MANIFEST.map((plugin) => [plugin.name, plugin.defaultEnabled])\n    )\n  );\n\nexport type Features = z.infer<typeof featuresSchema>;\n\nconst baseSdkConfigSchema = z.object({\n  features: featuresSchema,\n  metadata: z.object({\n    buildId: z.string().nullable(),\n    releaseId: z.string().nullable(),\n    environment: envSchema,\n    runtime: runtimeSchema,\n  }),\n  batch: z\n    .object({\n      size: z.number().default(DEFAULT_BATCH_SIZE),\n      ms: z.number().default(DEFAULT_BATCH_MS),\n    })\n    .default(() => ({ size: DEFAULT_BATCH_SIZE, ms: DEFAULT_BATCH_MS })),\n  /**\n   * Offline storage configuration.\n   * When enabled, envelopes that fail to send are persisted to IndexedDB and\n   * retried when connectivity returns.\n   * @default { enabled: false }\n   */\n  offline: offlineStorageSchema,\n});\n\nconst proxyConfigSchema = z.object({ proxyUrl: z.string() });\n\nconst directConfigSchema = z.object({\n  ingestUrl: z.string(),\n  surfaceToken: z.string(),\n});\n\nexport const configSchema = baseSdkConfigSchema\n  .and(z.union([proxyConfigSchema, directConfigSchema]))\n  .transform((cfg) => {\n    const env = cfg.metadata.environment;\n    const replayDefault = env !== \"development\";\n\n    if (cfg.features.replay === undefined) {\n      cfg.features = {\n        ...cfg.features,\n        replay: replayDefault,\n      };\n    }\n    return cfg;\n  });\n\nexport type Config = z.output<typeof configSchema>;\n\nexport const configInputSchema = z\n  .object({\n    features: featuresSchema.optional(),\n    metadata: z\n      .object({\n        buildId: z.string().nullable(),\n        releaseId: z.string().nullable(),\n        environment: envSchema,\n        runtime: runtimeSchema,\n      })\n      .partial()\n      .optional(),\n    batch: z\n      .object({\n        size: z.number(),\n        ms: z.number(),\n      })\n      .partial()\n      .optional(),\n    offline: offlineStorageSchema.optional(),\n  })\n  .and(z.union([proxyConfigSchema, directConfigSchema]));\n\nexport type ConfigInput = z.infer<typeof configInputSchema>;\n\nexport const persistenceTypeSchema = z.enum([\n  \"localStorage\",\n  \"sessionStorage\",\n  \"memory\",\n]);\n\nexport type PersistenceType = z.infer<typeof persistenceTypeSchema>;\n"],"mappings":";;;;;;AASA,MAAM,qBAAqB;AAC3B,MAAM,mBAAmB;AAEzB,MAAa,uBAAuB,EACjC,OAAO;CAMN,SAAS,EAAE,SAAS,CAAC,QAAQ,MAAM;CAKnC,cAAc,EAAE,QAAQ,CAAC,QAAQ,IAAI;CACtC,CAAC,CACD,QAAQ;CAAE,SAAS;CAAO,cAAc;CAAK,CAAC;AAIjD,MAAa,mBAAmB,EAAE,MAAM,CACtC,EAAE,QAAQ,EACV,EAAE,KAAK,CAAC,SAAS,wBAAwB,CAAC,CAC3C,CAAC;AAEF,MAAa,iBAAiB,EAC3B,OACC,OAAO,YACL,gBAAgB,KAAK,WAAW,CAC9B,OAAO,MACP,EAAE,SAAS,CAAC,QAAQ,OAAO,eAAe,CAC3C,CAAC,CACH,CACF,CACA,SAAS,CACT,QACC,OAAO,YACL,gBAAgB,KAAK,WAAW,CAAC,OAAO,MAAM,OAAO,eAAe,CAAC,CACtE,CACF;AAIH,MAAM,sBAAsB,EAAE,OAAO;CACnC,UAAU;CACV,UAAU,EAAE,OAAO;EACjB,SAAS,EAAE,QAAQ,CAAC,UAAU;EAC9B,WAAW,EAAE,QAAQ,CAAC,UAAU;EAChC,aAAa;EACb,SAAS;EACV,CAAC;CACF,OAAO,EACJ,OAAO;EACN,MAAM,EAAE,QAAQ,CAAC,QAAQ,mBAAmB;EAC5C,IAAI,EAAE,QAAQ,CAAC,QAAQ,iBAAiB;EACzC,CAAC,CACD,eAAe;EAAE,MAAM;EAAoB,IAAI;EAAkB,EAAE;CAOtE,SAAS;CACV,CAAC;AAEF,MAAM,oBAAoB,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC;AAE5D,MAAM,qBAAqB,EAAE,OAAO;CAClC,WAAW,EAAE,QAAQ;CACrB,cAAc,EAAE,QAAQ;CACzB,CAAC;AAEF,MAAa,eAAe,oBACzB,IAAI,EAAE,MAAM,CAAC,mBAAmB,mBAAmB,CAAC,CAAC,CACrD,WAAW,QAAQ;CAElB,MAAM,gBADM,IAAI,SAAS,gBACK;AAE9B,KAAI,IAAI,SAAS,WAAW,OAC1B,KAAI,WAAW;EACb,GAAG,IAAI;EACP,QAAQ;EACT;AAEH,QAAO;EACP;AAIJ,MAAa,oBAAoB,EAC9B,OAAO;CACN,UAAU,eAAe,UAAU;CACnC,UAAU,EACP,OAAO;EACN,SAAS,EAAE,QAAQ,CAAC,UAAU;EAC9B,WAAW,EAAE,QAAQ,CAAC,UAAU;EAChC,aAAa;EACb,SAAS;EACV,CAAC,CACD,SAAS,CACT,UAAU;CACb,OAAO,EACJ,OAAO;EACN,MAAM,EAAE,QAAQ;EAChB,IAAI,EAAE,QAAQ;EACf,CAAC,CACD,SAAS,CACT,UAAU;CACb,SAAS,qBAAqB,UAAU;CACzC,CAAC,CACD,IAAI,EAAE,MAAM,CAAC,mBAAmB,mBAAmB,CAAC,CAAC;AAIxD,MAAa,wBAAwB,EAAE,KAAK;CAC1C;CACA;CACA;CACD,CAAC"}
+{"version":3,"file":"config.mjs","names":[],"sources":["../../src/sdk/config.ts"],"sourcesContent":["import { API_URL } from \"@interfere/constants/api\";\n\nimport { z } from \"zod/v4\";\n\nimport { envSchema, runtimeSchema } from \"#sdk/runtime\";\n\nimport { PLUGIN_MANIFEST, type PluginKey } from \"./plugins/manifest.js\";\n\nconst DEFAULT_BATCH_SIZE = 10;\nconst DEFAULT_BATCH_MS = 250;\n\nexport const offlineStorageSchema = z\n  .object({\n    /**\n     * Whether to enable offline storage (IndexedDB persistence).\n     * When enabled, envelopes that fail to send are stored and retried when connectivity returns.\n     * @default false\n     */\n    enabled: z.boolean().default(false),\n    /**\n     * Maximum number of envelopes to store offline.\n     * @default 100\n     */\n    maxQueueSize: z.number().default(100),\n  })\n  .default({ enabled: false, maxQueueSize: 100 });\n\nexport type OfflineStorage = z.infer<typeof offlineStorageSchema>;\n\nexport const apiBaseUrlSchema = z.union([\n  z.string(),\n  z.enum([API_URL, \"http://localhost:3001\"]),\n]);\n\nexport const featuresSchema = z\n  .object(\n    Object.fromEntries(\n      PLUGIN_MANIFEST.map((plugin) => [\n        plugin.name,\n        z.boolean().default(plugin.defaultEnabled),\n      ])\n    ) as Record<PluginKey, z.ZodDefault<z.ZodBoolean>>\n  )\n  .partial()\n  .default(\n    Object.fromEntries(\n      PLUGIN_MANIFEST.map((plugin) => [plugin.name, plugin.defaultEnabled])\n    )\n  );\n\nexport type Features = z.infer<typeof featuresSchema>;\n\nconst baseSdkConfigSchema = z.object({\n  features: featuresSchema,\n  metadata: z.object({\n    buildId: z.string().nullable(),\n    releaseId: z.string().nullable(),\n    environment: envSchema,\n    runtime: runtimeSchema,\n  }),\n  batch: z\n    .object({\n      size: z.number().default(DEFAULT_BATCH_SIZE),\n      ms: z.number().default(DEFAULT_BATCH_MS),\n    })\n    .default(() => ({ size: DEFAULT_BATCH_SIZE, ms: DEFAULT_BATCH_MS })),\n  /**\n   * Offline storage configuration.\n   * When enabled, envelopes that fail to send are persisted to IndexedDB and\n   * retried when connectivity returns.\n   * @default { enabled: false }\n   */\n  offline: offlineStorageSchema,\n});\n\nconst proxyConfigSchema = z.object({ proxyUrl: z.string() });\n\nconst directConfigSchema = z.object({\n  ingestUrl: z.string(),\n  surfaceToken: z.string(),\n});\n\nexport const configSchema = baseSdkConfigSchema\n  .and(z.union([proxyConfigSchema, directConfigSchema]))\n  .transform((cfg) => {\n    const env = cfg.metadata.environment;\n    const replayDefault = env !== \"development\";\n\n    if (cfg.features.replay === undefined) {\n      cfg.features = {\n        ...cfg.features,\n        replay: replayDefault,\n      };\n    }\n    return cfg;\n  });\n\nexport type Config = z.output<typeof configSchema>;\n\nexport const configInputSchema = z\n  .object({\n    features: featuresSchema.optional(),\n    metadata: z\n      .object({\n        buildId: z.string().nullable(),\n        releaseId: z.string().nullable(),\n        environment: envSchema,\n        runtime: runtimeSchema,\n      })\n      .partial()\n      .optional(),\n    batch: z\n      .object({\n        size: z.number(),\n        ms: z.number(),\n      })\n      .partial()\n      .optional(),\n    offline: offlineStorageSchema.optional(),\n  })\n  .and(z.union([proxyConfigSchema, directConfigSchema]));\n\nexport type ConfigInput = z.infer<typeof configInputSchema>;\n\nexport const persistenceTypeSchema = z.enum([\n  \"localStorage\",\n  \"sessionStorage\",\n  \"memory\",\n]);\n\nexport type PersistenceType = z.infer<typeof persistenceTypeSchema>;\n"],"mappings":";;;;;AAQA,MAAM,qBAAqB;AAC3B,MAAM,mBAAmB;AAEzB,MAAa,uBAAuB,EACjC,OAAO;CAMN,SAAS,EAAE,SAAS,CAAC,QAAQ,MAAM;CAKnC,cAAc,EAAE,QAAQ,CAAC,QAAQ,IAAI;CACtC,CAAC,CACD,QAAQ;CAAE,SAAS;CAAO,cAAc;CAAK,CAAC;AAIjD,MAAa,mBAAmB,EAAE,MAAM,CACtC,EAAE,QAAQ,EACV,EAAE,KAAK,CAAC,SAAS,wBAAwB,CAAC,CAC3C,CAAC;AAEF,MAAa,iBAAiB,EAC3B,OACC,OAAO,YACL,gBAAgB,KAAK,WAAW,CAC9B,OAAO,MACP,EAAE,SAAS,CAAC,QAAQ,OAAO,eAAe,CAC3C,CAAC,CACH,CACF,CACA,SAAS,CACT,QACC,OAAO,YACL,gBAAgB,KAAK,WAAW,CAAC,OAAO,MAAM,OAAO,eAAe,CAAC,CACtE,CACF;AAIH,MAAM,sBAAsB,EAAE,OAAO;CACnC,UAAU;CACV,UAAU,EAAE,OAAO;EACjB,SAAS,EAAE,QAAQ,CAAC,UAAU;EAC9B,WAAW,EAAE,QAAQ,CAAC,UAAU;EAChC,aAAa;EACb,SAAS;EACV,CAAC;CACF,OAAO,EACJ,OAAO;EACN,MAAM,EAAE,QAAQ,CAAC,QAAQ,mBAAmB;EAC5C,IAAI,EAAE,QAAQ,CAAC,QAAQ,iBAAiB;EACzC,CAAC,CACD,eAAe;EAAE,MAAM;EAAoB,IAAI;EAAkB,EAAE;CAOtE,SAAS;CACV,CAAC;AAEF,MAAM,oBAAoB,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC;AAE5D,MAAM,qBAAqB,EAAE,OAAO;CAClC,WAAW,EAAE,QAAQ;CACrB,cAAc,EAAE,QAAQ;CACzB,CAAC;AAEF,MAAa,eAAe,oBACzB,IAAI,EAAE,MAAM,CAAC,mBAAmB,mBAAmB,CAAC,CAAC,CACrD,WAAW,QAAQ;CAElB,MAAM,gBADM,IAAI,SAAS,gBACK;AAE9B,KAAI,IAAI,SAAS,WAAW,KAAA,EAC1B,KAAI,WAAW;EACb,GAAG,IAAI;EACP,QAAQ;EACT;AAEH,QAAO;EACP;AAIJ,MAAa,oBAAoB,EAC9B,OAAO;CACN,UAAU,eAAe,UAAU;CACnC,UAAU,EACP,OAAO;EACN,SAAS,EAAE,QAAQ,CAAC,UAAU;EAC9B,WAAW,EAAE,QAAQ,CAAC,UAAU;EAChC,aAAa;EACb,SAAS;EACV,CAAC,CACD,SAAS,CACT,UAAU;CACb,OAAO,EACJ,OAAO;EACN,MAAM,EAAE,QAAQ;EAChB,IAAI,EAAE,QAAQ;EACf,CAAC,CACD,SAAS,CACT,UAAU;CACb,SAAS,qBAAqB,UAAU;CACzC,CAAC,CACD,IAAI,EAAE,MAAM,CAAC,mBAAmB,mBAAmB,CAAC,CAAC;AAIxD,MAAa,wBAAwB,EAAE,KAAK;CAC1C;CACA;CACA;CACD,CAAC"}

package/dist/sdk/env.d.mts

@@ -0,0 +1,9 @@
+import { z } from "zod/v4";
+
+//#region src/sdk/env.d.ts
+declare const interfereEnvValueSchema: z.ZodString;
+type InterfereEnvValue = z.infer<typeof interfereEnvValueSchema>;
+declare function parseEnvValue(value: unknown): InterfereEnvValue | null;
+declare function readFirstEnvValue(env: Record<string, string | undefined>, keys: readonly string[]): InterfereEnvValue | null;
+//#endregion
+export { InterfereEnvValue, interfereEnvValueSchema, parseEnvValue, readFirstEnvValue };

package/dist/sdk/env.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.mts","names":[],"sources":["../../src/sdk/env.ts"],"mappings":";;;cAEa,uBAAA,EAAuB,CAAA,CAAA,SAAA;AAAA,KACxB,iBAAA,GAAoB,CAAA,CAAE,KAAA,QAAa,uBAAA;AAAA,iBAE/B,aAAA,CAAc,KAAA,YAAiB,iBAAA;AAAA,iBAS/B,iBAAA,CACd,GAAA,EAAK,MAAA,8BACL,IAAA,sBACC,iBAAA"}

package/dist/sdk/env.mjs

@@ -0,0 +1,17 @@
+import { z } from "zod/v4";
+//#region src/sdk/env.ts
+const interfereEnvValueSchema = z.string().trim().min(1);
+function parseEnvValue(value) {
+	const parsed = interfereEnvValueSchema.safeParse(value);
+	if (!parsed.success) return null;
+	return parsed.data;
+}
+function readFirstEnvValue(env, keys) {
+	for (const key of keys) {
+		const value = parseEnvValue(env[key]);
+		if (value !== null) return value;
+	}
+	return null;
+}
+//#endregion
+export { interfereEnvValueSchema, parseEnvValue, readFirstEnvValue };

package/dist/sdk/env.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.mjs","names":[],"sources":["../../src/sdk/env.ts"],"sourcesContent":["import { z } from \"zod/v4\";\n\nexport const interfereEnvValueSchema = z.string().trim().min(1);\nexport type InterfereEnvValue = z.infer<typeof interfereEnvValueSchema>;\n\nexport function parseEnvValue(value: unknown): InterfereEnvValue | null {\n  const parsed = interfereEnvValueSchema.safeParse(value);\n  if (!parsed.success) {\n    return null;\n  }\n\n  return parsed.data;\n}\n\nexport function readFirstEnvValue(\n  env: Record<string, string | undefined>,\n  keys: readonly string[]\n): InterfereEnvValue | null {\n  for (const key of keys) {\n    const value = parseEnvValue(env[key]);\n    if (value !== null) {\n      return value;\n    }\n  }\n\n  return null;\n}\n"],"mappings":";;AAEA,MAAa,0BAA0B,EAAE,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE;AAG/D,SAAgB,cAAc,OAA0C;CACtE,MAAM,SAAS,wBAAwB,UAAU,MAAM;AACvD,KAAI,CAAC,OAAO,QACV,QAAO;AAGT,QAAO,OAAO;;AAGhB,SAAgB,kBACd,KACA,MAC0B;AAC1B,MAAK,MAAM,OAAO,MAAM;EACtB,MAAM,QAAQ,cAAc,IAAI,KAAK;AACrC,MAAI,UAAU,KACZ,QAAO;;AAIX,QAAO"}

package/dist/sdk/envelope.d.mts

@@ -1,87 +1,236 @@
-import { EventType } from "./plugins/lib/types.mjs";
 import { z } from "zod/v4";
 
 //#region src/sdk/envelope.d.ts
 declare const envelopeVersion: z.ZodUnion<readonly [z.ZodLiteral<0>]>;
 type EnvelopeVersion = z.infer<typeof envelopeVersion>;
-declare const envelopeSchema: z.ZodIntersection<z.ZodObject<{
-  uuid: z.ZodUUID;
-  v: z.ZodUnion<readonly [z.ZodLiteral<0>]>;
-  runtime: z.ZodNullable<z.ZodEnum<{
-    edge: "edge";
-    browser: "browser";
-    node: "node";
+/**
+ * Indicates how the sessionId was resolved on the server.
+ *
+ * - "header": Extracted from x-interfere-request header (ideal case)
+ * - "async_context": Retrieved from AsyncLocalStorage context
+ * - "fallback": Generated as server-side fallback (breaks session continuity)
+ * - "client": Session ID was set on the client (browser SDK)
+ */
+declare const sessionSourceSchema: z.ZodOptional<z.ZodEnum<{
+  client: "client";
+  header: "header";
+  async_context: "async_context";
+  fallback: "fallback";
+}>>;
+type SessionSource = z.infer<typeof sessionSourceSchema>;
+declare const envelopeContextSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+  runtime: z.ZodLiteral<"browser">;
+  browser: z.ZodNullable<z.ZodObject<{
+    language: z.ZodOptional<z.ZodString>;
+    timezone: z.ZodOptional<z.ZodString>;
+    display: z.ZodObject<{
+      screen: z.ZodObject<{
+        height: z.ZodNumber;
+        width: z.ZodNumber;
+        orientation: z.ZodOptional<z.ZodString>;
+      }, z.core.$strip>;
+    }, z.core.$strip>;
+  }, z.core.$strip>>;
+  device: z.ZodNullable<z.ZodObject<{
+    browser: z.ZodObject<{
+      major: z.ZodOptional<z.ZodString>;
+      name: z.ZodOptional<z.ZodString>;
+      type: z.ZodOptional<z.ZodString>;
+      version: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    cpu: z.ZodObject<{
+      architecture: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    device: z.ZodObject<{
+      model: z.ZodOptional<z.ZodString>;
+      type: z.ZodOptional<z.ZodString>;
+      vendor: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    engine: z.ZodObject<{
+      name: z.ZodOptional<z.ZodString>;
+      version: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    os: z.ZodObject<{
+      name: z.ZodOptional<z.ZodString>;
+      version: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    ua: z.ZodString;
+  }, z.core.$strip>>;
+}, z.core.$strip>, z.ZodObject<{
+  errorDigest: z.ZodOptional<z.ZodString>;
+  renderSource: z.ZodOptional<z.ZodEnum<{
+    "react-server-components": "react-server-components";
+    "react-server-components-payload": "react-server-components-payload";
+    "server-rendering": "server-rendering";
+  }>>;
+  renderType: z.ZodOptional<z.ZodEnum<{
+    dynamic: "dynamic";
+    "dynamic-resume": "dynamic-resume";
+  }>>;
+  requestMethod: z.ZodOptional<z.ZodString>;
+  requestPath: z.ZodOptional<z.ZodString>;
+  revalidateReason: z.ZodOptional<z.ZodEnum<{
+    "on-demand": "on-demand";
+    stale: "stale";
+  }>>;
+  routePath: z.ZodOptional<z.ZodString>;
+  routeType: z.ZodOptional<z.ZodEnum<{
+    render: "render";
+    route: "route";
+    action: "action";
+    middleware: "middleware";
+    proxy: "proxy";
+  }>>;
+  routerKind: z.ZodOptional<z.ZodEnum<{
+    "Pages Router": "Pages Router";
+    "App Router": "App Router";
   }>>;
+  runtime: z.ZodLiteral<"nextjs">;
+}, z.core.$strip>, z.ZodObject<{
+  runtime: z.ZodLiteral<"edge">;
+}, z.core.$strip>], "runtime">;
+type EnvelopeContext = z.infer<typeof envelopeContextSchema>;
+declare const envelopeSchema: z.ZodIntersection<z.ZodObject<{
+  buildId: z.ZodString;
+  clientTs: z.ZodInt;
+  context: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+    runtime: z.ZodLiteral<"browser">;
+    browser: z.ZodNullable<z.ZodObject<{
+      language: z.ZodOptional<z.ZodString>;
+      timezone: z.ZodOptional<z.ZodString>;
+      display: z.ZodObject<{
+        screen: z.ZodObject<{
+          height: z.ZodNumber;
+          width: z.ZodNumber;
+          orientation: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+      }, z.core.$strip>;
+    }, z.core.$strip>>;
+    device: z.ZodNullable<z.ZodObject<{
+      browser: z.ZodObject<{
+        major: z.ZodOptional<z.ZodString>;
+        name: z.ZodOptional<z.ZodString>;
+        type: z.ZodOptional<z.ZodString>;
+        version: z.ZodOptional<z.ZodString>;
+      }, z.core.$strip>;
+      cpu: z.ZodObject<{
+        architecture: z.ZodOptional<z.ZodString>;
+      }, z.core.$strip>;
+      device: z.ZodObject<{
+        model: z.ZodOptional<z.ZodString>;
+        type: z.ZodOptional<z.ZodString>;
+        vendor: z.ZodOptional<z.ZodString>;
+      }, z.core.$strip>;
+      engine: z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        version: z.ZodOptional<z.ZodString>;
+      }, z.core.$strip>;
+      os: z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        version: z.ZodOptional<z.ZodString>;
+      }, z.core.$strip>;
+      ua: z.ZodString;
+    }, z.core.$strip>>;
+  }, z.core.$strip>, z.ZodObject<{
+    errorDigest: z.ZodOptional<z.ZodString>;
+    renderSource: z.ZodOptional<z.ZodEnum<{
+      "react-server-components": "react-server-components";
+      "react-server-components-payload": "react-server-components-payload";
+      "server-rendering": "server-rendering";
+    }>>;
+    renderType: z.ZodOptional<z.ZodEnum<{
+      dynamic: "dynamic";
+      "dynamic-resume": "dynamic-resume";
+    }>>;
+    requestMethod: z.ZodOptional<z.ZodString>;
+    requestPath: z.ZodOptional<z.ZodString>;
+    revalidateReason: z.ZodOptional<z.ZodEnum<{
+      "on-demand": "on-demand";
+      stale: "stale";
+    }>>;
+    routePath: z.ZodOptional<z.ZodString>;
+    routeType: z.ZodOptional<z.ZodEnum<{
+      render: "render";
+      route: "route";
+      action: "action";
+      middleware: "middleware";
+      proxy: "proxy";
+    }>>;
+    routerKind: z.ZodOptional<z.ZodEnum<{
+      "Pages Router": "Pages Router";
+      "App Router": "App Router";
+    }>>;
+    runtime: z.ZodLiteral<"nextjs">;
+  }, z.core.$strip>, z.ZodObject<{
+    runtime: z.ZodLiteral<"edge">;
+  }, z.core.$strip>], "runtime">>;
   environment: z.ZodNullable<z.ZodEnum<{
     development: "development";
     preview: "preview";
     production: "production";
   }>>;
-  buildId: z.ZodNullable<z.ZodString>;
   releaseId: z.ZodNullable<z.ZodString>;
-  clientTs: z.ZodInt;
-  sessionId: z.ZodNullable<z.ZodUUID>;
+  runtime: z.ZodNullable<z.ZodEnum<{
+    edge: "edge";
+    browser: "browser";
+    node: "node";
+  }>>;
+  sessionId: z.ZodNullable<z.ZodUnion<readonly [z.ZodUUID, z.ZodTemplateLiteral<`server_${string}`>]>>;
+  sessionSource: z.ZodOptional<z.ZodEnum<{
+    client: "client";
+    header: "header";
+    async_context: "async_context";
+    fallback: "fallback";
+  }>>;
+  uuid: z.ZodUUID;
+  v: z.ZodUnion<readonly [z.ZodLiteral<0>]>;
 }, z.core.$strip>, z.ZodDiscriminatedUnion<[z.ZodObject<{
-  type: z.ZodLiteral<"error">;
   payload: z.ZodObject<{
-    frames: z.ZodArray<z.ZodObject<{
-      file: z.ZodObject<{
-        reported: z.ZodNullable<z.ZodString>;
-      }, z.core.$strip>;
-      line: z.ZodObject<{
-        reported: z.ZodNullable<z.ZodNumber>;
-      }, z.core.$strip>;
-      column: z.ZodObject<{
-        reported: z.ZodNullable<z.ZodNumber>;
-      }, z.core.$strip>;
-      fn: z.ZodObject<{
-        reported: z.ZodNullable<z.ZodString>;
-      }, z.core.$strip>;
+    exceptions: z.ZodArray<z.ZodObject<{
+      type: z.ZodString;
+      value: z.ZodString;
+      mechanism: z.ZodOptional<z.ZodObject<{
+        type: z.ZodString;
+        handled: z.ZodBoolean;
+        synthetic: z.ZodOptional<z.ZodBoolean>;
+      }, z.core.$strip>>;
+      frames: z.ZodArray<z.ZodObject<{
+        fileName: z.ZodOptional<z.ZodString>;
+        functionName: z.ZodOptional<z.ZodString>;
+        lineNumber: z.ZodOptional<z.ZodNumber>;
+        columnNumber: z.ZodOptional<z.ZodNumber>;
+        source: z.ZodOptional<z.ZodString>;
+      }, z.core.$strip>>;
     }, z.core.$strip>>;
-    message: z.ZodNullable<z.ZodString>;
-    name: z.ZodNullable<z.ZodString>;
-    stack: z.ZodNullable<z.ZodString>;
-    errorSource: z.ZodEnum<{
-      client: "client";
-      server: "server";
-      edge: "edge";
-    }>;
-  }, z.core.$strip>;
-}, z.core.$strip>, z.ZodObject<{
-  type: z.ZodLiteral<"session_summary">;
-  payload: z.ZodObject<{
-    summary: z.ZodString;
-    pageTitle: z.ZodString;
-    pageUrl: z.ZodURL;
-    contentLength: z.ZodNumber;
-    timestamp: z.ZodNumber;
   }, z.core.$strip>;
+  type: z.ZodLiteral<"error">;
 }, z.core.$strip>, z.ZodObject<{
-  type: z.ZodLiteral<"pageview">;
   payload: z.ZodObject<{
     url: z.ZodString;
     title: z.ZodOptional<z.ZodString>;
   }, z.core.$strip>;
+  type: z.ZodLiteral<"pageview">;
 }, z.core.$strip>, z.ZodObject<{
-  type: z.ZodLiteral<"pageleave">;
   payload: z.ZodObject<{
     url: z.ZodString;
     durationMs: z.ZodOptional<z.ZodNumber>;
   }, z.core.$strip>;
+  type: z.ZodLiteral<"pageleave">;
 }, z.core.$strip>, z.ZodObject<{
-  type: z.ZodLiteral<"ui_event">;
   payload: z.ZodObject<{
     event: z.ZodRecord<z.ZodString, z.ZodUnknown>;
   }, z.core.$strip>;
+  type: z.ZodLiteral<"ui_event">;
 }, z.core.$strip>, z.ZodObject<{
-  type: z.ZodLiteral<"replay_chunk">;
   payload: z.ZodObject<{
     ts: z.ZodNumber;
     count: z.ZodNumber;
     events: z.ZodArray<z.ZodString>;
+    first_event_ts: z.ZodOptional<z.ZodNumber>;
+    last_event_ts: z.ZodOptional<z.ZodNumber>;
   }, z.core.$strip>;
+  type: z.ZodLiteral<"replay_chunk">;
 }, z.core.$strip>, z.ZodObject<{
-  type: z.ZodLiteral<"rage_click">;
   payload: z.ZodObject<{
     count: z.ZodNumber;
     timeWindow: z.ZodNumber;
@@ -91,88 +240,155 @@ declare const envelopeSchema: z.ZodIntersection<z.ZodObject<{
     y: z.ZodNumber;
     timestamp: z.ZodNumber;
   }, z.core.$strip>;
+  type: z.ZodLiteral<"rage_click">;
 }, z.core.$strip>], "type">>;
-type Envelope<Type extends EventType | undefined = undefined> = Type extends EventType ? Extract<z.infer<typeof envelopeSchema>, {
-  type: Type;
-}> : z.infer<typeof envelopeSchema>;
+type EnvelopeBase = z.infer<typeof envelopeSchema>;
+type EventType = EnvelopeBase["type"];
+type Envelope<T extends EventType | undefined = undefined> = T extends EventType ? Extract<EnvelopeBase, {
+  type: T;
+}> : EnvelopeBase;
+type EnvelopePayload<T extends EventType> = Envelope<T>["payload"];
 declare const stampedEnvelopeSchema: z.ZodIntersection<z.ZodIntersection<z.ZodObject<{
-  uuid: z.ZodUUID;
-  v: z.ZodUnion<readonly [z.ZodLiteral<0>]>;
-  runtime: z.ZodNullable<z.ZodEnum<{
-    edge: "edge";
-    browser: "browser";
-    node: "node";
-  }>>;
+  buildId: z.ZodString;
+  clientTs: z.ZodInt;
+  context: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+    runtime: z.ZodLiteral<"browser">;
+    browser: z.ZodNullable<z.ZodObject<{
+      language: z.ZodOptional<z.ZodString>;
+      timezone: z.ZodOptional<z.ZodString>;
+      display: z.ZodObject<{
+        screen: z.ZodObject<{
+          height: z.ZodNumber;
+          width: z.ZodNumber;
+          orientation: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+      }, z.core.$strip>;
+    }, z.core.$strip>>;
+    device: z.ZodNullable<z.ZodObject<{
+      browser: z.ZodObject<{
+        major: z.ZodOptional<z.ZodString>;
+        name: z.ZodOptional<z.ZodString>;
+        type: z.ZodOptional<z.ZodString>;
+        version: z.ZodOptional<z.ZodString>;
+      }, z.core.$strip>;
+      cpu: z.ZodObject<{
+        architecture: z.ZodOptional<z.ZodString>;
+      }, z.core.$strip>;
+      device: z.ZodObject<{
+        model: z.ZodOptional<z.ZodString>;
+        type: z.ZodOptional<z.ZodString>;
+        vendor: z.ZodOptional<z.ZodString>;
+      }, z.core.$strip>;
+      engine: z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        version: z.ZodOptional<z.ZodString>;
+      }, z.core.$strip>;
+      os: z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        version: z.ZodOptional<z.ZodString>;
+      }, z.core.$strip>;
+      ua: z.ZodString;
+    }, z.core.$strip>>;
+  }, z.core.$strip>, z.ZodObject<{
+    errorDigest: z.ZodOptional<z.ZodString>;
+    renderSource: z.ZodOptional<z.ZodEnum<{
+      "react-server-components": "react-server-components";
+      "react-server-components-payload": "react-server-components-payload";
+      "server-rendering": "server-rendering";
+    }>>;
+    renderType: z.ZodOptional<z.ZodEnum<{
+      dynamic: "dynamic";
+      "dynamic-resume": "dynamic-resume";
+    }>>;
+    requestMethod: z.ZodOptional<z.ZodString>;
+    requestPath: z.ZodOptional<z.ZodString>;
+    revalidateReason: z.ZodOptional<z.ZodEnum<{
+      "on-demand": "on-demand";
+      stale: "stale";
+    }>>;
+    routePath: z.ZodOptional<z.ZodString>;
+    routeType: z.ZodOptional<z.ZodEnum<{
+      render: "render";
+      route: "route";
+      action: "action";
+      middleware: "middleware";
+      proxy: "proxy";
+    }>>;
+    routerKind: z.ZodOptional<z.ZodEnum<{
+      "Pages Router": "Pages Router";
+      "App Router": "App Router";
+    }>>;
+    runtime: z.ZodLiteral<"nextjs">;
+  }, z.core.$strip>, z.ZodObject<{
+    runtime: z.ZodLiteral<"edge">;
+  }, z.core.$strip>], "runtime">>;
   environment: z.ZodNullable<z.ZodEnum<{
     development: "development";
     preview: "preview";
     production: "production";
   }>>;
-  buildId: z.ZodNullable<z.ZodString>;
   releaseId: z.ZodNullable<z.ZodString>;
-  clientTs: z.ZodInt;
-  sessionId: z.ZodNullable<z.ZodUUID>;
+  runtime: z.ZodNullable<z.ZodEnum<{
+    edge: "edge";
+    browser: "browser";
+    node: "node";
+  }>>;
+  sessionId: z.ZodNullable<z.ZodUnion<readonly [z.ZodUUID, z.ZodTemplateLiteral<`server_${string}`>]>>;
+  sessionSource: z.ZodOptional<z.ZodEnum<{
+    client: "client";
+    header: "header";
+    async_context: "async_context";
+    fallback: "fallback";
+  }>>;
+  uuid: z.ZodUUID;
+  v: z.ZodUnion<readonly [z.ZodLiteral<0>]>;
 }, z.core.$strip>, z.ZodDiscriminatedUnion<[z.ZodObject<{
-  type: z.ZodLiteral<"error">;
   payload: z.ZodObject<{
-    frames: z.ZodArray<z.ZodObject<{
-      file: z.ZodObject<{
-        reported: z.ZodNullable<z.ZodString>;
-      }, z.core.$strip>;
-      line: z.ZodObject<{
-        reported: z.ZodNullable<z.ZodNumber>;
-      }, z.core.$strip>;
-      column: z.ZodObject<{
-        reported: z.ZodNullable<z.ZodNumber>;
-      }, z.core.$strip>;
-      fn: z.ZodObject<{
-        reported: z.ZodNullable<z.ZodString>;
-      }, z.core.$strip>;
+    exceptions: z.ZodArray<z.ZodObject<{
+      type: z.ZodString;
+      value: z.ZodString;
+      mechanism: z.ZodOptional<z.ZodObject<{
+        type: z.ZodString;
+        handled: z.ZodBoolean;
+        synthetic: z.ZodOptional<z.ZodBoolean>;
+      }, z.core.$strip>>;
+      frames: z.ZodArray<z.ZodObject<{
+        fileName: z.ZodOptional<z.ZodString>;
+        functionName: z.ZodOptional<z.ZodString>;
+        lineNumber: z.ZodOptional<z.ZodNumber>;
+        columnNumber: z.ZodOptional<z.ZodNumber>;
+        source: z.ZodOptional<z.ZodString>;
+      }, z.core.$strip>>;
     }, z.core.$strip>>;
-    message: z.ZodNullable<z.ZodString>;
-    name: z.ZodNullable<z.ZodString>;
-    stack: z.ZodNullable<z.ZodString>;
-    errorSource: z.ZodEnum<{
-      client: "client";
-      server: "server";
-      edge: "edge";
-    }>;
-  }, z.core.$strip>;
-}, z.core.$strip>, z.ZodObject<{
-  type: z.ZodLiteral<"session_summary">;
-  payload: z.ZodObject<{
-    summary: z.ZodString;
-    pageTitle: z.ZodString;
-    pageUrl: z.ZodURL;
-    contentLength: z.ZodNumber;
-    timestamp: z.ZodNumber;
   }, z.core.$strip>;
+  type: z.ZodLiteral<"error">;
 }, z.core.$strip>, z.ZodObject<{
-  type: z.ZodLiteral<"pageview">;
   payload: z.ZodObject<{
     url: z.ZodString;
     title: z.ZodOptional<z.ZodString>;
   }, z.core.$strip>;
+  type: z.ZodLiteral<"pageview">;
 }, z.core.$strip>, z.ZodObject<{
-  type: z.ZodLiteral<"pageleave">;
   payload: z.ZodObject<{
     url: z.ZodString;
     durationMs: z.ZodOptional<z.ZodNumber>;
   }, z.core.$strip>;
+  type: z.ZodLiteral<"pageleave">;
 }, z.core.$strip>, z.ZodObject<{
-  type: z.ZodLiteral<"ui_event">;
   payload: z.ZodObject<{
     event: z.ZodRecord<z.ZodString, z.ZodUnknown>;
   }, z.core.$strip>;
+  type: z.ZodLiteral<"ui_event">;
 }, z.core.$strip>, z.ZodObject<{
-  type: z.ZodLiteral<"replay_chunk">;
   payload: z.ZodObject<{
     ts: z.ZodNumber;
     count: z.ZodNumber;
     events: z.ZodArray<z.ZodString>;
+    first_event_ts: z.ZodOptional<z.ZodNumber>;
+    last_event_ts: z.ZodOptional<z.ZodNumber>;
   }, z.core.$strip>;
+  type: z.ZodLiteral<"replay_chunk">;
 }, z.core.$strip>, z.ZodObject<{
-  type: z.ZodLiteral<"rage_click">;
   payload: z.ZodObject<{
     count: z.ZodNumber;
     timeWindow: z.ZodNumber;
@@ -182,9 +398,10 @@ declare const stampedEnvelopeSchema: z.ZodIntersection<z.ZodIntersection<z.ZodOb
     y: z.ZodNumber;
     timestamp: z.ZodNumber;
   }, z.core.$strip>;
+  type: z.ZodLiteral<"rage_click">;
 }, z.core.$strip>], "type">>, z.ZodObject<{
   surfaceSlug: z.ZodString;
 }, z.core.$strip>>;
 type StampedEnvelope = z.infer<typeof stampedEnvelopeSchema>;
 //#endregion
-export { Envelope, EnvelopeVersion, StampedEnvelope, envelopeSchema, stampedEnvelopeSchema };
+export { Envelope, EnvelopeContext, EnvelopePayload, EnvelopeVersion, EventType, SessionSource, StampedEnvelope, envelopeContextSchema, envelopeSchema, sessionSourceSchema, stampedEnvelopeSchema };

package/dist/sdk/envelope.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"envelope.d.mts","names":[],"sources":["../../src/sdk/envelope.ts"],"sourcesContent":[],"mappings":";;;;cAiBM,iBAAe,CAAA,CAAA,mBAAA,CAAA,CAAA;KAET,eAAA,GAAkB,CAAA,CAAE,aAAa;AAFvC,cAiBO,cAjBQ,EAiBM,CAAA,CAAA,eAjBN,CAiBM,CAAA,CAAA,SAjBN,CAAA;EAET,IAAA,WAAA;EAeC,CAAA,YAAA,CAAA,SAqCZ,aAAA,CAAA,CAAA,CAAA,CAAA,CAAA;;;;;;;;;;;;;;;;EArC0B,IAAA,cAAA,CAAA,OAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAuCf,sBAAsB,qCAChC,aAAa,YACT,QAAQ,CAAA,CAAE,aAAa;QAAyB;KAChD,CAAA,CAAE,aAAa;cAER,uBAAqB,CAAA,CAAA,gBAAA,CAAA,CAAA,gBAAA,CAAA,CAAA;;;;;;;;;;;;;;;EA5CP,QAAA,UAAA;EAAA,SAAA,eAAA,UAAA,CAAA;AAuC3B,CAAA,eAAoB,CAAA,yBAAA,CAAA,YAAA,CAAA;EAAc,IAAA,cAAA,CAAA,OAAA,CAAA;EAChC,OAAA,aAAA,CAAA;IAAa,MAAA,YAAA,YAAA,CAAA;MACc,IAAA,aAAA,CAAA;QAAb,QAAA,eAAA,YAAA,CAAA;MAAsC,CAAA,eAAA,CAAA;MAAhD,IAAA,aAAA,CAAA;QACe,QAAA,eAAA,YAAA,CAAA;MAAb,CAAA,eAAA,CAAA;MAAK,MAAA,aAAA,CAAA;QAEA,QAAA,eAKZ,YAAA,CAAA;;;;;;;;;;;;;;;;EALiC,IAAA,cAAA,CAAA,iBAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAOtB,eAAA,GAAkB,CAAA,CAAE,aAAa"}
+{"version":3,"file":"envelope.d.mts","names":[],"sources":["../../src/sdk/envelope.ts"],"mappings":";;;cAiBM,eAAA,EAAe,CAAA,CAAA,QAAA,WAAA,CAAA,CAAA,UAAA;AAAA,KAET,eAAA,GAAkB,CAAA,CAAE,KAAA,QAAa,eAAA;AAnBlB;;;;;;;;AAAA,cA6Bd,mBAAA,EAAmB,CAAA,CAAA,WAAA,CAAA,CAAA,CAAA,OAAA;;;;;;KAIpB,aAAA,GAAgB,CAAA,CAAE,KAAA,QAAa,mBAAA;AAAA,cAE9B,qBAAA,EAAqB,CAAA,CAAA,qBAAA,EAAA,CAAA,CAAA,SAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAMtB,eAAA,GAAkB,CAAA,CAAE,KAAA,QAAa,qBAAA;AAAA,cAehC,cAAA,EAAc,CAAA,CAAA,eAAA,CAAA,CAAA,CAAA,SAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KA6BtB,YAAA,GAAe,CAAA,CAAE,KAAA,QAAa,cAAA;AAAA,KAEvB,SAAA,GAAY,YAAA;AAAA,KAEZ,QAAA,WAAmB,SAAA,4BAC7B,CAAA,SAAU,SAAA,GAAY,OAAA,CAAQ,YAAA;EAAgB,IAAA,EAAM,CAAA;AAAA,KAAO,YAAA;AAAA,KAEjD,eAAA,WAA0B,SAAA,IAAa,QAAA,CAAS,CAAA;AAAA,cAE/C,qBAAA,EAAqB,CAAA,CAAA,eAAA,CAAA,CAAA,CAAA,eAAA,CAAA,CAAA,CAAA,SAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAOtB,eAAA,GAAkB,CAAA,CAAE,KAAA,QAAa,qBAAA"}