@interfere/react 0.0.1 → 0.0.2-alpha.1

package/dist/hooks/use-session.d.mts

@@ -0,0 +1,40 @@
+//#region src/hooks/use-session.d.ts
+/**
+ * React hook to get the current session ID.
+ * Automatically handles cleanup on unmount.
+ *
+ * @returns Object with sessionId (string | null) and loading state
+ *
+ * @example
+ * function MyComponent() {
+ *   const { sessionId, loading, error } = useSession();
+ *
+ *   if (loading) return <div>Loading session...</div>;
+ *   if (error) return <div>Error: {error.message}</div>;
+ *
+ *   return <div>Session ID: {sessionId}</div>;
+ * }
+ */
+declare function useSession(): {
+  sessionId: string | null;
+  loading: boolean;
+  error: Error | null;
+};
+/**
+ * React hook to execute a callback when the session is ready.
+ * Automatically handles cleanup on unmount.
+ *
+ * @param callback Function to call with the session ID
+ * @param deps Dependency array for the callback
+ *
+ * @example
+ * function MyComponent() {
+ *   useSessionReady((sessionId) => {
+ *     console.log('Session is ready:', sessionId);
+ *     // Send analytics event, initialize tracking, etc.
+ *   }, []);
+ * }
+ */
+declare function useSessionReady(callback: (sessionId: string) => void, deps?: React.DependencyList): void;
+//#endregion
+export { useSession, useSessionReady };

package/dist/hooks/use-session.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-session.d.mts","names":[],"sources":["../../src/hooks/use-session.ts"],"sourcesContent":[],"mappings":";;AAsBA;AA2EA;;;;;;;;;;;;;;iBA3EgB,UAAA,CAAA;;;SAAU;;;;;;;;;;;;;;;;;iBA2EV,eAAA,+CAER,KAAA,CAAM"}

package/dist/hooks/use-session.mjs

@@ -0,0 +1,96 @@
+import { SessionServiceTag } from "../effect/layers/session.layer.mjs";
+import { runWithSDK } from "../effect/runtime-services.mjs";
+import { Effect, Option } from "effect";
+import { useEffect, useState } from "react";
+
+//#region src/hooks/use-session.ts
+/**
+* React hook to get the current session ID.
+* Automatically handles cleanup on unmount.
+*
+* @returns Object with sessionId (string | null) and loading state
+*
+* @example
+* function MyComponent() {
+*   const { sessionId, loading, error } = useSession();
+*
+*   if (loading) return <div>Loading session...</div>;
+*   if (error) return <div>Error: {error.message}</div>;
+*
+*   return <div>Session ID: {sessionId}</div>;
+* }
+*/
+function useSession() {
+	const [sessionId, setSessionId] = useState(null);
+	const [loading, setLoading] = useState(true);
+	const [error, setError] = useState(null);
+	useEffect(() => {
+		runWithSDK(Effect.gen(function* () {
+			const sidOpt = yield* (yield* SessionServiceTag).getSessionId();
+			if (Option.isSome(sidOpt)) {
+				setSessionId(sidOpt.value);
+				setLoading(false);
+				return true;
+			}
+			return false;
+		})).then((has) => {
+			if (has) return;
+		});
+		const controller = new AbortController();
+		runWithSDK(Effect.gen(function* () {
+			return yield* (yield* SessionServiceTag).whenSessionReady({
+				signal: controller.signal,
+				timeout: 3e4
+			});
+		})).then((id) => {
+			setSessionId(id);
+			setLoading(false);
+		}).catch((err) => {
+			if (!controller.signal.aborted) {
+				setError(err instanceof Error ? err : new Error(String(err)));
+				setLoading(false);
+			}
+		});
+		return () => {
+			controller.abort();
+		};
+	}, []);
+	return {
+		sessionId,
+		loading,
+		error
+	};
+}
+/**
+* React hook to execute a callback when the session is ready.
+* Automatically handles cleanup on unmount.
+*
+* @param callback Function to call with the session ID
+* @param deps Dependency array for the callback
+*
+* @example
+* function MyComponent() {
+*   useSessionReady((sessionId) => {
+*     console.log('Session is ready:', sessionId);
+*     // Send analytics event, initialize tracking, etc.
+*   }, []);
+* }
+*/
+function useSessionReady(callback, deps = []) {
+	useEffect(() => {
+		const controller = new AbortController();
+		runWithSDK(Effect.gen(function* () {
+			return yield* (yield* SessionServiceTag).whenSessionReady({ signal: controller.signal });
+		})).then((sessionId) => {
+			if (!controller.signal.aborted) callback(sessionId);
+		}).catch((err) => {
+			if (!controller.signal.aborted) runWithSDK(Effect.logError("Failed to get session", { error: String(err) }));
+		});
+		return () => {
+			controller.abort();
+		};
+	}, deps);
+}
+
+//#endregion
+export { useSession, useSessionReady };

package/dist/hooks/use-session.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-session.mjs","names":[],"sources":["../../src/hooks/use-session.ts"],"sourcesContent":["import { Effect, Option } from \"effect\";\nimport { useEffect, useState } from \"react\";\n\nimport { SessionServiceTag } from \"../effect/layers/session.layer.js\";\nimport { runWithSDK } from \"../effect/runtime-services.js\";\n\n/**\n * React hook to get the current session ID.\n * Automatically handles cleanup on unmount.\n *\n * @returns Object with sessionId (string | null) and loading state\n *\n * @example\n * function MyComponent() {\n *   const { sessionId, loading, error } = useSession();\n *\n *   if (loading) return <div>Loading session...</div>;\n *   if (error) return <div>Error: {error.message}</div>;\n *\n *   return <div>Session ID: {sessionId}</div>;\n * }\n */\nexport function useSession() {\n  const [sessionId, setSessionId] = useState<string | null>(null);\n  const [loading, setLoading] = useState(true);\n  const [error, setError] = useState<Error | null>(null);\n\n  useEffect(() => {\n    // Check if session already exists\n    // Try to read session id from SessionService\n    runWithSDK(\n      Effect.gen(function* () {\n        const session = yield* SessionServiceTag;\n        const sidOpt = yield* session.getSessionId();\n        if (Option.isSome(sidOpt)) {\n          setSessionId(sidOpt.value);\n          setLoading(false);\n          return true as const;\n        }\n        return false as const;\n      })\n    ).then((has) => {\n      if (has) {\n        return;\n      }\n    });\n\n    // Create AbortController for cleanup\n    const controller = new AbortController();\n\n    // Wait for session to be ready\n    runWithSDK(\n      Effect.gen(function* () {\n        const session = yield* SessionServiceTag;\n        const sid = yield* session.whenSessionReady({\n          signal: controller.signal,\n          timeout: 30_000,\n        });\n        return sid;\n      })\n    )\n      .then((id) => {\n        setSessionId(id);\n        setLoading(false);\n      })\n      .catch((err) => {\n        // Only set error if not aborted (aborted = component unmounted)\n        if (!controller.signal.aborted) {\n          setError(err instanceof Error ? err : new Error(String(err)));\n          setLoading(false);\n        }\n      });\n\n    // Cleanup function - abort the polling on unmount\n    return () => {\n      controller.abort();\n    };\n  }, []);\n\n  return { sessionId, loading, error };\n}\n\n/**\n * React hook to execute a callback when the session is ready.\n * Automatically handles cleanup on unmount.\n *\n * @param callback Function to call with the session ID\n * @param deps Dependency array for the callback\n *\n * @example\n * function MyComponent() {\n *   useSessionReady((sessionId) => {\n *     console.log('Session is ready:', sessionId);\n *     // Send analytics event, initialize tracking, etc.\n *   }, []);\n * }\n */\nexport function useSessionReady(\n  callback: (sessionId: string) => void,\n  deps: React.DependencyList = []\n) {\n  useEffect(() => {\n    const controller = new AbortController();\n\n    runWithSDK(\n      Effect.gen(function* () {\n        const session = yield* SessionServiceTag;\n        const sid = yield* session.whenSessionReady({\n          signal: controller.signal,\n        });\n        return sid;\n      })\n    )\n      .then((sessionId: string) => {\n        if (!controller.signal.aborted) {\n          callback(sessionId);\n        }\n      })\n      .catch((err: unknown) => {\n        // Silently ignore abort errors (component unmounted)\n        if (!controller.signal.aborted) {\n          // biome-ignore lint/complexity/noVoid: necessary to avoid blocking\n          void runWithSDK(\n            Effect.logError(\"Failed to get session\", {\n              error: String(err),\n            })\n          );\n        }\n      });\n\n    return () => {\n      controller.abort();\n    };\n    // biome-ignore lint/correctness/useExhaustiveDependencies: we want to pass the deps to the effect\n  }, deps);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAsBA,SAAgB,aAAa;CAC3B,MAAM,CAAC,WAAW,gBAAgB,SAAwB,KAAK;CAC/D,MAAM,CAAC,SAAS,cAAc,SAAS,KAAK;CAC5C,MAAM,CAAC,OAAO,YAAY,SAAuB,KAAK;AAEtD,iBAAgB;AAGd,aACE,OAAO,IAAI,aAAa;GAEtB,MAAM,SAAS,QADC,OAAO,mBACO,cAAc;AAC5C,OAAI,OAAO,OAAO,OAAO,EAAE;AACzB,iBAAa,OAAO,MAAM;AAC1B,eAAW,MAAM;AACjB,WAAO;;AAET,UAAO;IACP,CACH,CAAC,MAAM,QAAQ;AACd,OAAI,IACF;IAEF;EAGF,MAAM,aAAa,IAAI,iBAAiB;AAGxC,aACE,OAAO,IAAI,aAAa;AAMtB,UAJY,QADI,OAAO,mBACI,iBAAiB;IAC1C,QAAQ,WAAW;IACnB,SAAS;IACV,CAAC;IAEF,CACH,CACE,MAAM,OAAO;AACZ,gBAAa,GAAG;AAChB,cAAW,MAAM;IACjB,CACD,OAAO,QAAQ;AAEd,OAAI,CAAC,WAAW,OAAO,SAAS;AAC9B,aAAS,eAAe,QAAQ,MAAM,IAAI,MAAM,OAAO,IAAI,CAAC,CAAC;AAC7D,eAAW,MAAM;;IAEnB;AAGJ,eAAa;AACX,cAAW,OAAO;;IAEnB,EAAE,CAAC;AAEN,QAAO;EAAE;EAAW;EAAS;EAAO;;;;;;;;;;;;;;;;;AAkBtC,SAAgB,gBACd,UACA,OAA6B,EAAE,EAC/B;AACA,iBAAgB;EACd,MAAM,aAAa,IAAI,iBAAiB;AAExC,aACE,OAAO,IAAI,aAAa;AAKtB,UAHY,QADI,OAAO,mBACI,iBAAiB,EAC1C,QAAQ,WAAW,QACpB,CAAC;IAEF,CACH,CACE,MAAM,cAAsB;AAC3B,OAAI,CAAC,WAAW,OAAO,QACrB,UAAS,UAAU;IAErB,CACD,OAAO,QAAiB;AAEvB,OAAI,CAAC,WAAW,OAAO,QAErB,CAAK,WACH,OAAO,SAAS,yBAAyB,EACvC,OAAO,OAAO,IAAI,EACnB,CAAC,CACH;IAEH;AAEJ,eAAa;AACX,cAAW,OAAO;;IAGnB,KAAK"}

package/dist/package.mjs

@@ -0,0 +1,100 @@
+//#region package.json
+var name = "@interfere/react";
+var version = "0.0.2-alpha.1";
+var package_default = {
+	name,
+	version,
+	license: "MIT",
+	description: "Build apps that never break.",
+	keywords: [
+		"observability",
+		"typescript",
+		"react",
+		"logging",
+		"error-tracking",
+		"session-replay"
+	],
+	homepage: "https://interfere.com",
+	bugs: { "url": "mailto:support@interfere.com" },
+	author: "Interfere <support@interfere.com> (https://interfere.com)",
+	files: ["dist"],
+	type: "module",
+	main: "./dist/index.mjs",
+	types: "./dist/index.d.mts",
+	typesVersions: { "*": {
+		"server/*": ["dist/server/*.d.mts"],
+		"*": ["dist/*.d.mts"]
+	} },
+	exports: {
+		"./provider": {
+			"@source": "./src/provider.tsx",
+			"types": "./dist/provider.d.mts",
+			"default": "./dist/provider.mjs"
+		},
+		"./server/*": {
+			"@source": "./src/server/*.ts",
+			"types": "./dist/server/*.d.mts",
+			"default": "./dist/server/*.mjs"
+		},
+		"./core/runtime/*": {
+			"@source": "./src/core/runtime/*.ts",
+			"types": "./dist/core/runtime/*.d.mts",
+			"default": "./dist/core/runtime/*.mjs"
+		},
+		"./core/*": {
+			"@source": "./src/core/*.ts",
+			"types": "./dist/core/*.d.mts",
+			"default": "./dist/core/*.mjs"
+		},
+		"./*": {
+			"@source": "./src/*.ts",
+			"types": "./dist/*.d.mts",
+			"default": "./dist/*.mjs"
+		}
+	},
+	sideEffects: false,
+	publishConfig: { "access": "public" },
+	scripts: {
+		"build": "tsdown",
+		"dev": "tsdown --watch",
+		"typecheck": "tsc --noEmit --incremental",
+		"test": "vitest run --coverage"
+	},
+	dependencies: {
+		"@effect/platform": "catalog:",
+		"@interfere/constants": "workspace:*",
+		"@interfere/effect-utils": "workspace:*",
+		"@interfere/types": "workspace:*",
+		"@rrweb/packer": "catalog:",
+		"@ua-parser-js/pro-enterprise": "catalog:",
+		"effect": "catalog:",
+		"nanoid": "catalog:",
+		"rrweb": "catalog:",
+		"uuid": "catalog:",
+		"zod": "catalog:"
+	},
+	peerDependencies: {
+		"react": ">=18",
+		"react-dom": ">=18"
+	},
+	devDependencies: {
+		"@interfere/test-utils": "workspace:*",
+		"@interfere/typescript-config": "workspace:*",
+		"@interfere/vitest-config": "workspace:*",
+		"@rrweb/types": "catalog:",
+		"@types/node": "catalog:",
+		"@types/react": "catalog:",
+		"@types/react-dom": "catalog:",
+		"@vitest/coverage-v8": "catalog:",
+		"jsdom": "catalog:",
+		"msw": "catalog:",
+		"react": "catalog:",
+		"react-dom": "catalog:",
+		"tsdown": "catalog:",
+		"typescript": "catalog:",
+		"vitest": "catalog:"
+	}
+};
+
+//#endregion
+export { package_default as default, name, version };

package/dist/package.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"package.mjs","names":[],"sources":["../package.json"],"sourcesContent":[""],"mappings":""}

package/dist/provider.d.mts

@@ -0,0 +1,17 @@
+import { InterfereProviderValue, Plugin } from "./core/schemas.mjs";
+import { Config } from "@interfere/types/sdk/config";
+import { PropsWithChildren, ReactNode } from "react";
+
+//#region src/provider.d.ts
+interface InterfereProviderProps extends PropsWithChildren {
+  config: Config;
+  plugins?: Plugin[];
+}
+declare function InterfereProvider({
+  children,
+  config,
+  plugins
+}: InterfereProviderProps): ReactNode;
+declare function useInterfere(): InterfereProviderValue;
+//#endregion
+export { InterfereProvider, InterfereProviderProps, useInterfere };

package/dist/provider.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.mts","names":[],"sources":["../src/provider.tsx"],"sourcesContent":[],"mappings":";;;;;UAwBiB,sBAAA,SAA+B;UACtC;EADO,OAAA,CAAA,EAEL,MAFK,EAAA;;AAEL,iBAGI,iBAAA,CAHJ;EAAA,QAAA;EAAA,MAAA;EAAA;AAAA,CAAA,EAOT,sBAPS,CAAA,EAOgB,SAPhB;AAFoC,iBA2BhC,YAAA,CAAA,CA3BgC,EA2BhB,sBA3BgB"}

package/dist/provider.mjs

@@ -0,0 +1,26 @@
+"use client";
+
+import { capture } from "./client.mjs";
+import { useRuntimeAndPlugins } from "./hooks/use-runtime-and-plugins.mjs";
+import { createContext, useContext, useMemo } from "react";
+import { jsx } from "react/jsx-runtime";
+
+//#region src/provider.tsx
+const InterfereContext = createContext({ capture });
+function InterfereProvider({ children, config, plugins }) {
+	const pluginApis = useRuntimeAndPlugins(config, plugins);
+	const contextValue = useMemo(() => ({
+		capture,
+		...pluginApis
+	}), [pluginApis]);
+	return /* @__PURE__ */ jsx(InterfereContext.Provider, {
+		value: contextValue,
+		children
+	});
+}
+function useInterfere() {
+	return useContext(InterfereContext);
+}
+
+//#endregion
+export { InterfereProvider, useInterfere };

package/dist/provider.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.mjs","names":[],"sources":["../src/provider.tsx"],"sourcesContent":["\"use client\";\n\nimport type { Config } from \"@interfere/types/sdk/config\";\n\nimport {\n  createContext,\n  type PropsWithChildren,\n  type ReactNode,\n  useContext,\n  useMemo,\n} from \"react\";\n\nimport { capture } from \"./client.js\";\nimport type { InterfereProviderValue, Plugin } from \"./core/schemas.js\";\nimport { useRuntimeAndPlugins } from \"./hooks/use-runtime-and-plugins.js\";\n\nconst interfereContextDefaultValue: InterfereProviderValue = {\n  capture,\n};\n\nconst InterfereContext = createContext<InterfereProviderValue>(\n  interfereContextDefaultValue\n);\n\nexport interface InterfereProviderProps extends PropsWithChildren {\n  config: Config;\n  plugins?: Plugin[];\n}\n\nexport function InterfereProvider({\n  children,\n  config,\n  plugins,\n}: InterfereProviderProps): ReactNode {\n  const pluginApis = useRuntimeAndPlugins(config, plugins);\n\n  const contextValue = useMemo(\n    () => ({\n      capture,\n      ...pluginApis,\n    }),\n    [pluginApis]\n  );\n\n  return (\n    <InterfereContext.Provider value={contextValue}>\n      {children}\n    </InterfereContext.Provider>\n  );\n}\n\nexport function useInterfere(): InterfereProviderValue {\n  const context = useContext(InterfereContext);\n\n  return context;\n}\n"],"mappings":";;;;;;;;AAoBA,MAAM,mBAAmB,cAJoC,EAC3D,SACD,CAIA;AAOD,SAAgB,kBAAkB,EAChC,UACA,QACA,WACoC;CACpC,MAAM,aAAa,qBAAqB,QAAQ,QAAQ;CAExD,MAAM,eAAe,eACZ;EACL;EACA,GAAG;EACJ,GACD,CAAC,WAAW,CACb;AAED,QACE,oBAAC,iBAAiB;EAAS,OAAO;EAC/B;GACyB;;AAIhC,SAAgB,eAAuC;AAGrD,QAFgB,WAAW,iBAAiB"}

package/dist/server/auth.d.mts

@@ -0,0 +1,11 @@
+//#region src/server/auth.d.ts
+type FetchImpl = typeof fetch;
+declare function exchangeSecretForPublicToken(apiUrl: string, secret: string, fetchImpl?: FetchImpl): Promise<string | null>;
+declare function getPublicToken(params: {
+  apiUrl: string;
+  secret: string;
+  cacheTtlMs?: number;
+  fetchImpl?: FetchImpl;
+}): Promise<string | null>;
+//#endregion
+export { exchangeSecretForPublicToken, getPublicToken };

package/dist/server/auth.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.mts","names":[],"sources":["../../src/server/auth.ts"],"sourcesContent":[],"mappings":";KAAK,SAAA,UAAmB;AAAnB,iBAMiB,4BAAA,CANO,MAAA,EAAA,MAAA,EAAA,MAAA,EAAA,MAAA,EAAA,SAAA,CAAA,EAShB,SATgB,CAAA,EAU1B,OAV0B,CAAA,MAAA,GAAA,IAAA,CAAA;AAMP,iBAkCA,cAAA,CAlC4B,MAAA,EAGrC;EA+BS,MAAA,EAAA,MAAA;;;cAIR;IACV"}

package/dist/server/auth.mjs

@@ -0,0 +1,36 @@
+//#region src/server/auth.ts
+async function exchangeSecretForPublicToken(apiUrl, secret, fetchImpl = fetch) {
+	const res = await fetchImpl(`${apiUrl}/auth/exchange`, {
+		method: "POST",
+		headers: {
+			Authorization: `Bearer ${secret}`,
+			"Content-Type": "application/json"
+		}
+	});
+	if (!res.ok) return null;
+	const data = await res.json();
+	if (typeof data.publicToken === "string" && data.publicToken.length > 0) return data.publicToken;
+	return null;
+}
+const tokenCache = /* @__PURE__ */ new Map();
+function getCacheKey(apiUrl, secret) {
+	return `${apiUrl}::${secret}`;
+}
+async function getPublicToken(params) {
+	const { apiUrl, secret, cacheTtlMs = 36e5, fetchImpl = fetch } = params;
+	const now = Date.now();
+	const cacheKey = getCacheKey(apiUrl, secret);
+	const cached = tokenCache.get(cacheKey);
+	if (cached && cached.expiresAt > now) return cached.token;
+	const token = await exchangeSecretForPublicToken(apiUrl, secret, fetchImpl);
+	if (!token) return null;
+	tokenCache.set(cacheKey, {
+		token,
+		expiresAt: now + cacheTtlMs
+	});
+	for (const [key, value] of tokenCache.entries()) if (value.expiresAt <= now) tokenCache.delete(key);
+	return token;
+}
+
+//#endregion
+export { exchangeSecretForPublicToken, getPublicToken };

package/dist/server/auth.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.mjs","names":[],"sources":["../../src/server/auth.ts"],"sourcesContent":["type FetchImpl = typeof fetch;\n\ninterface ExchangeResponse {\n  publicToken: string;\n}\n\nexport async function exchangeSecretForPublicToken(\n  apiUrl: string,\n  secret: string,\n  fetchImpl: FetchImpl = fetch\n): Promise<string | null> {\n  const res = await fetchImpl(`${apiUrl}/auth/exchange`, {\n    method: \"POST\",\n    headers: {\n      Authorization: `Bearer ${secret}`,\n      \"Content-Type\": \"application/json\",\n    },\n  });\n\n  if (!res.ok) {\n    return null;\n  }\n\n  const data = (await res.json()) as Partial<ExchangeResponse>;\n  if (typeof data.publicToken === \"string\" && data.publicToken.length > 0) {\n    return data.publicToken;\n  }\n\n  return null;\n}\n\n// Use a Map to cache tokens keyed by apiUrl + secret to prevent token leakage between different configurations\nconst tokenCache = new Map<string, { token: string; expiresAt: number }>();\n\nfunction getCacheKey(apiUrl: string, secret: string): string {\n  // Create a unique cache key from apiUrl and secret\n  // Using a separator that's unlikely to appear in URLs or secrets\n  return `${apiUrl}::${secret}`;\n}\n\nexport async function getPublicToken(params: {\n  apiUrl: string;\n  secret: string;\n  cacheTtlMs?: number;\n  fetchImpl?: FetchImpl;\n}): Promise<string | null> {\n  const { apiUrl, secret, cacheTtlMs = 3_600_000, fetchImpl = fetch } = params;\n\n  const now = Date.now();\n  const cacheKey = getCacheKey(apiUrl, secret);\n\n  const cached = tokenCache.get(cacheKey);\n  if (cached && cached.expiresAt > now) {\n    return cached.token;\n  }\n\n  const token = await exchangeSecretForPublicToken(apiUrl, secret, fetchImpl);\n\n  if (!token) {\n    return null;\n  }\n\n  tokenCache.set(cacheKey, { token, expiresAt: now + cacheTtlMs });\n\n  // Clean up expired entries to prevent memory leak\n  for (const [key, value] of tokenCache.entries()) {\n    if (value.expiresAt <= now) {\n      tokenCache.delete(key);\n    }\n  }\n\n  return token;\n}\n"],"mappings":";AAMA,eAAsB,6BACpB,QACA,QACA,YAAuB,OACC;CACxB,MAAM,MAAM,MAAM,UAAU,GAAG,OAAO,iBAAiB;EACrD,QAAQ;EACR,SAAS;GACP,eAAe,UAAU;GACzB,gBAAgB;GACjB;EACF,CAAC;AAEF,KAAI,CAAC,IAAI,GACP,QAAO;CAGT,MAAM,OAAQ,MAAM,IAAI,MAAM;AAC9B,KAAI,OAAO,KAAK,gBAAgB,YAAY,KAAK,YAAY,SAAS,EACpE,QAAO,KAAK;AAGd,QAAO;;AAIT,MAAM,6BAAa,IAAI,KAAmD;AAE1E,SAAS,YAAY,QAAgB,QAAwB;AAG3D,QAAO,GAAG,OAAO,IAAI;;AAGvB,eAAsB,eAAe,QAKV;CACzB,MAAM,EAAE,QAAQ,QAAQ,aAAa,MAAW,YAAY,UAAU;CAEtE,MAAM,MAAM,KAAK,KAAK;CACtB,MAAM,WAAW,YAAY,QAAQ,OAAO;CAE5C,MAAM,SAAS,WAAW,IAAI,SAAS;AACvC,KAAI,UAAU,OAAO,YAAY,IAC/B,QAAO,OAAO;CAGhB,MAAM,QAAQ,MAAM,6BAA6B,QAAQ,QAAQ,UAAU;AAE3E,KAAI,CAAC,MACH,QAAO;AAGT,YAAW,IAAI,UAAU;EAAE;EAAO,WAAW,MAAM;EAAY,CAAC;AAGhE,MAAK,MAAM,CAAC,KAAK,UAAU,WAAW,SAAS,CAC7C,KAAI,MAAM,aAAa,IACrB,YAAW,OAAO,IAAI;AAI1B,QAAO"}

package/dist/server/capture.d.mts

@@ -0,0 +1,18 @@
+import { Config } from "@interfere/types/sdk/config";
+import { Env, Runtime } from "@interfere/types/sdk/runtime";
+import { Envelope } from "@interfere/types/sdk/envelope";
+
+//#region src/server/capture.d.ts
+declare function toJsonBytes(obj: unknown): number[];
+type ServerErrorMeta = Pick<Config["metadata"], "buildId" | "releaseId">;
+type ServerErrorEnvelopeInput = ServerErrorMeta & {
+  error: unknown;
+  request?: Request;
+  context?: Record<string, unknown>;
+  environment: string | Env;
+  runtime?: string | Runtime;
+};
+declare function buildServerErrorEnvelope(input: ServerErrorEnvelopeInput): Envelope;
+declare function sendEnvelopesToIngest(envelopes: Envelope[], ingestUrl: string, surfaceToken: string): Promise<void>;
+//#endregion
+export { ServerErrorEnvelopeInput, buildServerErrorEnvelope, sendEnvelopesToIngest, toJsonBytes };

package/dist/server/capture.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture.d.mts","names":[],"sources":["../../src/server/capture.ts"],"sourcesContent":[],"mappings":";;;;;iBAiBgB,WAAA;KA4EX,eAAA,GAAkB,KAAK;AA5EZ,KA8EJ,wBAAA,GAA2B,eA9EZ,GAAA;EA4EtB,KAAA,EAAA,OAAA;EAEO,OAAA,CAAA,EAEA,OAFA;EAA2B,OAAA,CAAA,EAG3B,MAH2B,CAAA,MAAA,EAAA,OAAA,CAAA;EAE3B,WAAA,EAAA,MAAA,GAEY,GAFZ;EACA,OAAA,CAAA,EAAA,MAAA,GAES,OAFT;CACY;AACH,iBAGL,wBAAA,CAHK,KAAA,EAIZ,wBAJY,CAAA,EAKlB,QALkB;AAAO,iBA2CN,qBAAA,CA3CM,SAAA,EA4Cf,QA5Ce,EAAA,EAAA,SAAA,EAAA,MAAA,EAAA,YAAA,EAAA,MAAA,CAAA,EA+CzB,OA/CyB,CAAA,IAAA,CAAA"}

package/dist/server/capture.mjs

@@ -0,0 +1,105 @@
+import { withSpan } from "../effect/layers/tracer.layer.mjs";
+import { Effect } from "effect";
+import { v7 } from "uuid";
+import { withInterfereLogger } from "@interfere/effect-utils/observability";
+import { normalizeEnv, normalizeRuntime } from "@interfere/types/sdk/runtime";
+
+//#region src/server/capture.ts
+function toJsonBytes(obj) {
+	const encoder = new TextEncoder();
+	return Array.from(encoder.encode(JSON.stringify(obj)));
+}
+const X_INTERFERE_REQUEST_HEADER = "x-interfere-request";
+/**
+* Parse x-interfere-request header to extract session ID and request ID
+* Format: {sessionId}/{requestId}
+*/
+function parseInterfereRequestHeader(headerValue) {
+	if (!headerValue) return {
+		sessionId: null,
+		requestId: null
+	};
+	const parts = headerValue.split("/");
+	if (parts.length !== 2) return {
+		sessionId: null,
+		requestId: null
+	};
+	return {
+		sessionId: parts[0] || null,
+		requestId: parts[1] || null
+	};
+}
+/**
+* Parse stack trace to extract frames
+* Similar logic to client-side error parsing
+*/
+const STACK_TRACE_REGEX = /at\s+(?:(.+?)\s+\()?(.+?):(\d+):(\d+)\)?/;
+function parseStackTrace(stack) {
+	if (!stack) return [{
+		file: { reported: null },
+		line: { reported: null },
+		column: { reported: null },
+		fn: { reported: null }
+	}];
+	const lines = stack.split("\n");
+	const frames = [];
+	for (const line of lines) {
+		const match = line.match(STACK_TRACE_REGEX);
+		if (match) frames.push({
+			file: { reported: match[2] || null },
+			line: { reported: match[3] ? Number.parseInt(match[3], 10) : null },
+			column: { reported: match[4] ? Number.parseInt(match[4], 10) : null },
+			fn: { reported: match[1] || null }
+		});
+	}
+	return frames.length > 0 ? frames : [{
+		file: { reported: null },
+		line: { reported: null },
+		column: { reported: null },
+		fn: { reported: null }
+	}];
+}
+function buildServerErrorEnvelope(input) {
+	const { error, request, buildId, releaseId, environment, runtime } = input;
+	let sessionId;
+	if (request) sessionId = parseInterfereRequestHeader(request.headers.get(X_INTERFERE_REQUEST_HEADER)).sessionId ?? `server_${v7()}`;
+	else sessionId = `server_${v7()}`;
+	const errorObj = error;
+	const errorPayload = {
+		frames: parseStackTrace(errorObj?.stack),
+		message: errorObj?.message ?? String(error ?? "Unknown error"),
+		name: errorObj?.name ?? "Error",
+		stack: errorObj?.stack ?? null,
+		errorSource: "server"
+	};
+	return {
+		v: 0,
+		runtime: normalizeRuntime(runtime),
+		environment: normalizeEnv(environment),
+		clientTs: Date.now(),
+		sessionId,
+		type: "error",
+		payload: errorPayload,
+		buildId: buildId ?? "unknown",
+		releaseId: releaseId ?? "unknown",
+		uuid: v7()
+	};
+}
+async function sendEnvelopesToIngest(envelopes, ingestUrl, surfaceToken) {
+	const response = await Effect.runPromise(withInterfereLogger("react", withSpan("server.sendEnvelopes", Effect.promise(() => fetch(ingestUrl, {
+		method: "POST",
+		headers: {
+			"Content-Type": "application/json",
+			"x-interfere-surface": surfaceToken
+		},
+		body: JSON.stringify(envelopes),
+		keepalive: true
+	})))));
+	if (!response.ok) {
+		const errorText = await response.text().catch(() => "");
+		throw new Error(`Failed to send envelopes to ingest: ${response.status} ${response.statusText}${errorText ? ` - ${errorText}` : ""}`);
+	}
+}
+
+//#endregion
+export { buildServerErrorEnvelope, sendEnvelopesToIngest, toJsonBytes };

package/dist/server/capture.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture.mjs","names":["frames: IngestedFrame[]","sessionId: string","uuidv7","errorPayload: ErrorEnvelopePayload"],"sources":["../../src/server/capture.ts"],"sourcesContent":["import { withInterfereLogger } from \"@interfere/effect-utils/observability\";\nimport type { IngestedFrame } from \"@interfere/types/data/frame\";\nimport type { Config } from \"@interfere/types/sdk/config\";\nimport type { Envelope } from \"@interfere/types/sdk/envelope\";\nimport type { ErrorEnvelopePayload } from \"@interfere/types/sdk/plugins/payload/errors\";\nimport {\n  type Env,\n  normalizeEnv,\n  normalizeRuntime,\n  type Runtime,\n} from \"@interfere/types/sdk/runtime\";\n\nimport { Effect } from \"effect\";\nimport { v7 as uuidv7 } from \"uuid\";\n\nimport { withSpan } from \"../effect/layers/tracer.layer.js\";\n\nexport function toJsonBytes(obj: unknown): number[] {\n  const encoder = new TextEncoder();\n  return Array.from(encoder.encode(JSON.stringify(obj)));\n}\n\nconst X_INTERFERE_REQUEST_HEADER = \"x-interfere-request\";\n\n/**\n * Parse x-interfere-request header to extract session ID and request ID\n * Format: {sessionId}/{requestId}\n */\nfunction parseInterfereRequestHeader(headerValue: string | null): {\n  sessionId: string | null;\n  requestId: string | null;\n} {\n  if (!headerValue) {\n    return { sessionId: null, requestId: null };\n  }\n\n  const parts = headerValue.split(\"/\");\n  if (parts.length !== 2) {\n    return { sessionId: null, requestId: null };\n  }\n\n  return {\n    sessionId: parts[0] || null,\n    requestId: parts[1] || null,\n  };\n}\n\n/**\n * Parse stack trace to extract frames\n * Similar logic to client-side error parsing\n */\nconst STACK_TRACE_REGEX = /at\\s+(?:(.+?)\\s+\\()?(.+?):(\\d+):(\\d+)\\)?/;\n\nfunction parseStackTrace(stack?: string): IngestedFrame[] {\n  if (!stack) {\n    return [\n      {\n        file: { reported: null },\n        line: { reported: null },\n        column: { reported: null },\n        fn: { reported: null },\n      },\n    ];\n  }\n\n  const lines = stack.split(\"\\n\");\n  const frames: IngestedFrame[] = [];\n\n  for (const line of lines) {\n    const match = line.match(STACK_TRACE_REGEX);\n\n    if (match) {\n      frames.push({\n        file: { reported: match[2] || null },\n        line: { reported: match[3] ? Number.parseInt(match[3], 10) : null },\n        column: { reported: match[4] ? Number.parseInt(match[4], 10) : null },\n        fn: { reported: match[1] || null },\n      });\n    }\n  }\n\n  return frames.length > 0\n    ? frames\n    : [\n        {\n          file: { reported: null },\n          line: { reported: null },\n          column: { reported: null },\n          fn: { reported: null },\n        },\n      ];\n}\n\ntype ServerErrorMeta = Pick<Config[\"metadata\"], \"buildId\" | \"releaseId\">;\n\nexport type ServerErrorEnvelopeInput = ServerErrorMeta & {\n  error: unknown;\n  request?: Request;\n  context?: Record<string, unknown>;\n  environment: string | Env;\n  runtime?: string | Runtime;\n};\n\nexport function buildServerErrorEnvelope(\n  input: ServerErrorEnvelopeInput\n): Envelope {\n  const { error, request, buildId, releaseId, environment, runtime } = input;\n\n  // Extract session ID from x-interfere-request header\n  let sessionId: string;\n  if (request) {\n    const headerValue = request.headers.get(X_INTERFERE_REQUEST_HEADER);\n    const parsed = parseInterfereRequestHeader(headerValue);\n    sessionId = parsed.sessionId ?? `server_${uuidv7()}`;\n  } else {\n    // Generate placeholder session ID if no request provided\n    sessionId = `server_${uuidv7()}`;\n  }\n\n  // Build error payload matching ErrorEnvelopePayload schema\n  const errorObj = error as Error;\n  const errorPayload: ErrorEnvelopePayload = {\n    frames: parseStackTrace(errorObj?.stack),\n    message: errorObj?.message ?? String(error ?? \"Unknown error\"),\n    name: errorObj?.name ?? \"Error\",\n    stack: errorObj?.stack ?? null,\n    errorSource: \"server\",\n  };\n\n  return {\n    v: 0,\n    runtime: normalizeRuntime(runtime),\n    environment: normalizeEnv(environment),\n    clientTs: Date.now(),\n    sessionId,\n    type: \"error\",\n    payload: errorPayload,\n    buildId: buildId ?? \"unknown\",\n    releaseId: releaseId ?? \"unknown\",\n    uuid: uuidv7(),\n  };\n}\n\nexport async function sendEnvelopesToIngest(\n  envelopes: Envelope[],\n  ingestUrl: string,\n  surfaceToken: string\n): Promise<void> {\n  const response = await Effect.runPromise(\n    withInterfereLogger(\n      \"react\",\n      withSpan(\n        \"server.sendEnvelopes\",\n        Effect.promise(() =>\n          fetch(ingestUrl, {\n            method: \"POST\",\n            headers: {\n              \"Content-Type\": \"application/json\",\n              \"x-interfere-surface\": surfaceToken,\n            },\n            body: JSON.stringify(envelopes),\n            keepalive: true,\n          })\n        )\n      )\n    )\n  );\n\n  if (!response.ok) {\n    const errorText = await response.text().catch(() => \"\");\n    throw new Error(\n      `Failed to send envelopes to ingest: ${response.status} ${response.statusText}${\n        errorText ? ` - ${errorText}` : \"\"\n      }`\n    );\n  }\n}\n"],"mappings":";;;;;;;AAiBA,SAAgB,YAAY,KAAwB;CAClD,MAAM,UAAU,IAAI,aAAa;AACjC,QAAO,MAAM,KAAK,QAAQ,OAAO,KAAK,UAAU,IAAI,CAAC,CAAC;;AAGxD,MAAM,6BAA6B;;;;;AAMnC,SAAS,4BAA4B,aAGnC;AACA,KAAI,CAAC,YACH,QAAO;EAAE,WAAW;EAAM,WAAW;EAAM;CAG7C,MAAM,QAAQ,YAAY,MAAM,IAAI;AACpC,KAAI,MAAM,WAAW,EACnB,QAAO;EAAE,WAAW;EAAM,WAAW;EAAM;AAG7C,QAAO;EACL,WAAW,MAAM,MAAM;EACvB,WAAW,MAAM,MAAM;EACxB;;;;;;AAOH,MAAM,oBAAoB;AAE1B,SAAS,gBAAgB,OAAiC;AACxD,KAAI,CAAC,MACH,QAAO,CACL;EACE,MAAM,EAAE,UAAU,MAAM;EACxB,MAAM,EAAE,UAAU,MAAM;EACxB,QAAQ,EAAE,UAAU,MAAM;EAC1B,IAAI,EAAE,UAAU,MAAM;EACvB,CACF;CAGH,MAAM,QAAQ,MAAM,MAAM,KAAK;CAC/B,MAAMA,SAA0B,EAAE;AAElC,MAAK,MAAM,QAAQ,OAAO;EACxB,MAAM,QAAQ,KAAK,MAAM,kBAAkB;AAE3C,MAAI,MACF,QAAO,KAAK;GACV,MAAM,EAAE,UAAU,MAAM,MAAM,MAAM;GACpC,MAAM,EAAE,UAAU,MAAM,KAAK,OAAO,SAAS,MAAM,IAAI,GAAG,GAAG,MAAM;GACnE,QAAQ,EAAE,UAAU,MAAM,KAAK,OAAO,SAAS,MAAM,IAAI,GAAG,GAAG,MAAM;GACrE,IAAI,EAAE,UAAU,MAAM,MAAM,MAAM;GACnC,CAAC;;AAIN,QAAO,OAAO,SAAS,IACnB,SACA,CACE;EACE,MAAM,EAAE,UAAU,MAAM;EACxB,MAAM,EAAE,UAAU,MAAM;EACxB,QAAQ,EAAE,UAAU,MAAM;EAC1B,IAAI,EAAE,UAAU,MAAM;EACvB,CACF;;AAaP,SAAgB,yBACd,OACU;CACV,MAAM,EAAE,OAAO,SAAS,SAAS,WAAW,aAAa,YAAY;CAGrE,IAAIC;AACJ,KAAI,QAGF,aADe,4BADK,QAAQ,QAAQ,IAAI,2BAA2B,CACZ,CACpC,aAAa,UAAUC,IAAQ;KAGlD,aAAY,UAAUA,IAAQ;CAIhC,MAAM,WAAW;CACjB,MAAMC,eAAqC;EACzC,QAAQ,gBAAgB,UAAU,MAAM;EACxC,SAAS,UAAU,WAAW,OAAO,SAAS,gBAAgB;EAC9D,MAAM,UAAU,QAAQ;EACxB,OAAO,UAAU,SAAS;EAC1B,aAAa;EACd;AAED,QAAO;EACL,GAAG;EACH,SAAS,iBAAiB,QAAQ;EAClC,aAAa,aAAa,YAAY;EACtC,UAAU,KAAK,KAAK;EACpB;EACA,MAAM;EACN,SAAS;EACT,SAAS,WAAW;EACpB,WAAW,aAAa;EACxB,MAAMD,IAAQ;EACf;;AAGH,eAAsB,sBACpB,WACA,WACA,cACe;CACf,MAAM,WAAW,MAAM,OAAO,WAC5B,oBACE,SACA,SACE,wBACA,OAAO,cACL,MAAM,WAAW;EACf,QAAQ;EACR,SAAS;GACP,gBAAgB;GAChB,uBAAuB;GACxB;EACD,MAAM,KAAK,UAAU,UAAU;EAC/B,WAAW;EACZ,CAAC,CACH,CACF,CACF,CACF;AAED,KAAI,CAAC,SAAS,IAAI;EAChB,MAAM,YAAY,MAAM,SAAS,MAAM,CAAC,YAAY,GAAG;AACvD,QAAM,IAAI,MACR,uCAAuC,SAAS,OAAO,GAAG,SAAS,aACjE,YAAY,MAAM,cAAc,KAEnC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@interfere/react",
-  "version": "0.0.1",
+  "version": "0.0.2-alpha.1",
   "license": "MIT",
   "description": "Build apps that never break.",
   "keywords": [
@@ -20,54 +20,87 @@
     "dist"
   ],
   "type": "module",
-  "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
+  "main": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
+  "typesVersions": {
+    "*": {
+      "server/*": [
+        "dist/server/*.d.mts"
+      ],
+      "*": [
+        "dist/*.d.mts"
+      ]
+    }
+  },
   "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "default": "./dist/index.js"
+    "./provider": {
+      "@source": "./src/provider.tsx",
+      "types": "./dist/provider.d.mts",
+      "default": "./dist/provider.mjs"
     },
-    "./client": {
-      "types": "./dist/client.d.ts",
-      "default": "./dist/client.js"
+    "./server/*": {
+      "@source": "./src/server/*.ts",
+      "types": "./dist/server/*.d.mts",
+      "default": "./dist/server/*.mjs"
     },
-    "./provider": {
-      "types": "./dist/provider.d.ts",
-      "default": "./dist/provider.js"
+    "./core/runtime/*": {
+      "@source": "./src/core/runtime/*.ts",
+      "types": "./dist/core/runtime/*.d.mts",
+      "default": "./dist/core/runtime/*.mjs"
+    },
+    "./core/*": {
+      "@source": "./src/core/*.ts",
+      "types": "./dist/core/*.d.mts",
+      "default": "./dist/core/*.mjs"
+    },
+    "./*": {
+      "@source": "./src/*.ts",
+      "types": "./dist/*.d.mts",
+      "default": "./dist/*.mjs"
     }
   },
+  "sideEffects": false,
   "publishConfig": {
     "access": "public"
   },
   "dependencies": {
+    "@effect/platform": "^0.94.0",
     "@rrweb/packer": "2.0.0-alpha.18",
-    "@rrweb/types": "2.0.0-alpha.18",
+    "@ua-parser-js/pro-enterprise": "^2.0.6",
+    "effect": "^3.19.13",
     "nanoid": "^5.1.6",
     "rrweb": "2.0.0-alpha.18",
     "uuid": "^13.0.0",
-    "@interfere/constants": "0.0.1",
-    "@interfere/schemas": "0.0.7"
+    "zod": "^4.2.1",
+    "@interfere/constants": "0.0.2-alpha.0",
+    "@interfere/effect-utils": "0.0.2-alpha.0",
+    "@interfere/types": "0.0.2-alpha.0"
   },
   "peerDependencies": {
     "react": ">=18",
     "react-dom": ">=18"
   },
   "devDependencies": {
-    "@types/node": "22.15.29",
-    "@types/react": "19.1.16",
-    "@types/react-dom": "19.1.9",
-    "@vitest/coverage-v8": "^3.2.4",
-    "jsdom": "^27.0.0",
-    "react": "^19.1.1",
-    "react-dom": "^19.1.1",
+    "@rrweb/types": "2.0.0-alpha.18",
+    "@types/node": "^22.19.3",
+    "@types/react": "19.2.7",
+    "@types/react-dom": "19.2.3",
+    "@vitest/coverage-v8": "^4.0.16",
+    "jsdom": "^27.4.0",
+    "msw": "^2.12.7",
+    "react": "^19.2.3",
+    "react-dom": "^19.2.3",
+    "tsdown": "^0.18.3",
     "typescript": "5.9.3",
-    "vitest": "^3.2.4",
-    "@interfere/typescript-config": "1.0.2"
+    "vitest": "^4.0.16",
+    "@interfere/test-utils": "0.0.0",
+    "@interfere/typescript-config": "1.0.3-alpha.0",
+    "@interfere/vitest-config": "1.0.1-alpha.0"
   },
   "scripts": {
-    "build": "tsc",
-    "dev": "tsc --watch",
-    "check-types": "tsc --noEmit --incremental",
+    "build": "tsdown",
+    "dev": "tsdown --watch",
+    "typecheck": "tsc --noEmit --incremental",
     "test": "vitest run --coverage"
   }
 }

package/dist/__tests__/client.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=client.test.d.ts.map

package/dist/__tests__/client.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"client.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/client.test.ts"],"names":[],"mappings":""}