@interfere/react 0.0.1 → 0.0.2-alpha.1

package/dist/core/plugins/impl/server-tracing.mjs

@@ -0,0 +1,160 @@
+import { createEffectPlugin } from "../plugin-event-system.mjs";
+import { Effect } from "effect";
+import { nanoid } from "nanoid";
+
+//#region src/core/plugins/impl/server-tracing.ts
+const X_INTERFERE_REQUEST_HEADER = "x-interfere-request";
+/**
+* Generate a unique request ID
+*/
+function generateRequestId() {
+	return nanoid();
+}
+/**
+* Check if a URL matches any of the tracing origins
+*/
+function shouldTraceUrl(url, tracingOrigins) {
+	if (!tracingOrigins) return false;
+	if (tracingOrigins === true) try {
+		const currentOrigin = window.location.origin;
+		return new URL(url, window.location.href).origin === currentOrigin;
+	} catch {
+		return false;
+	}
+	for (const pattern of tracingOrigins) if (typeof pattern === "string" && url.includes(pattern) || pattern instanceof RegExp && pattern.test(url)) return true;
+	return false;
+}
+/**
+* Get session ID synchronously from localStorage.
+*
+* NOTE: Unlike other plugins that use `ctx.capture()` (which automatically
+* gets session ID via `buildEnvelopeEffect()` -> `SessionServiceTag`),
+* this plugin needs synchronous access because:
+* 1. We're patching network requests (fetch/XHR) synchronously
+* 2. Headers must be set synchronously before requests are sent
+*
+* The session service stores the session ID in localStorage (see session.layer.ts),
+* so reading directly is safe and matches the storage location used by the service.
+*/
+function getSessionIdSync() {
+	if (typeof window === "undefined") return null;
+	try {
+		const storage = window.localStorage;
+		if (!storage) return null;
+		return storage.getItem("__interfere_session_id__");
+	} catch {
+		return null;
+	}
+}
+/**
+* Get session ID asynchronously (for fetch API compatibility).
+* Uses synchronous read since session ID is stored in localStorage.
+*/
+function getSessionIdAsync() {
+	return Promise.resolve(getSessionIdSync());
+}
+/**
+* Create the x-interfere-request header value
+*/
+function createRequestHeader(sessionId, requestId) {
+	return `${sessionId ?? ""}/${requestId}`;
+}
+var server_tracing_default = createEffectPlugin("serverTracing", {
+	name: "serverTracing",
+	setup: (ctx) => Effect.gen(function* () {
+		if (typeof window === "undefined") {
+			ctx.log.debug("serverTracing: SSR - skipping setup");
+			return;
+		}
+		const tracingOrigins = true;
+		ctx.log.debug("serverTracing: patching fetch and XMLHttpRequest", { tracingOrigins });
+		const originalFetch = window.fetch.bind(window);
+		const extractUrl = (input) => {
+			if (typeof input === "string") try {
+				return new URL(input, window.location.href).href;
+			} catch {
+				return input;
+			}
+			if (input instanceof URL) return input.href;
+			try {
+				return new URL(input.url, window.location.href).href;
+			} catch {
+				return input.url;
+			}
+		};
+		const mergeHeaders = (init, request) => {
+			const headers = new Headers(init?.headers);
+			if (request) {
+				for (const [key, value] of request.headers.entries()) if (!headers.has(key)) headers.set(key, value);
+			}
+			return headers;
+		};
+		const patchedFetch = async (input, init) => {
+			const url = extractUrl(input);
+			if (!(url && shouldTraceUrl(url, tracingOrigins))) {
+				ctx.log.debug("serverTracing: skipping URL", {
+					url,
+					tracingOrigins
+				});
+				return originalFetch(input, init);
+			}
+			const sessionId = await getSessionIdAsync();
+			const requestId = generateRequestId();
+			const headerValue = createRequestHeader(sessionId, requestId);
+			ctx.log.debug("serverTracing: injecting header", {
+				url,
+				sessionId,
+				requestId,
+				headerValue
+			});
+			const headers = mergeHeaders(init, input instanceof Request ? input : void 0);
+			headers.set(X_INTERFERE_REQUEST_HEADER, headerValue);
+			if (input instanceof Request) return originalFetch(new Request(input, { headers }));
+			return originalFetch(input, {
+				...init,
+				headers
+			});
+		};
+		window.fetch = patchedFetch;
+		const originalXHROpen = XMLHttpRequest.prototype.open;
+		const originalXHRSend = XMLHttpRequest.prototype.send;
+		const originalSetRequestHeader = XMLHttpRequest.prototype.setRequestHeader;
+		XMLHttpRequest.prototype.open = function(method, url, ...rest) {
+			this._interfereUrl = typeof url === "string" ? url : url.href;
+			return originalXHROpen.call(this, method, url, ...rest);
+		};
+		XMLHttpRequest.prototype.setRequestHeader = function(name, value) {
+			const url = this._interfereUrl;
+			if (url && shouldTraceUrl(url, tracingOrigins)) {
+				const headerValue = createRequestHeader(getSessionIdSync(), generateRequestId());
+				if (!this._interfereHeaderSet) {
+					originalSetRequestHeader.call(this, X_INTERFERE_REQUEST_HEADER, headerValue);
+					this._interfereHeaderSet = true;
+				}
+			}
+			return originalSetRequestHeader.call(this, name, value);
+		};
+		XMLHttpRequest.prototype.send = function(body) {
+			const url = this._interfereUrl;
+			if (url && shouldTraceUrl(url, tracingOrigins) && !this._interfereHeaderSet) {
+				const headerValue = createRequestHeader(getSessionIdSync(), generateRequestId());
+				originalSetRequestHeader.call(this, X_INTERFERE_REQUEST_HEADER, headerValue);
+				this._interfereHeaderSet = true;
+			}
+			return originalXHRSend.call(this, body);
+		};
+		return {
+			key: "serverTracing",
+			cleanup: () => {
+				ctx.log.debug("serverTracing: removing patches");
+				window.fetch = originalFetch;
+				XMLHttpRequest.prototype.open = originalXHROpen;
+				XMLHttpRequest.prototype.send = originalXHRSend;
+				XMLHttpRequest.prototype.setRequestHeader = originalSetRequestHeader;
+			}
+		};
+	})
+});
+
+//#endregion
+export { server_tracing_default as default };

package/dist/core/plugins/impl/server-tracing.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-tracing.mjs","names":["originalFetch: typeof window.fetch","patchedFetch: typeof window.fetch"],"sources":["../../../../src/core/plugins/impl/server-tracing.ts"],"sourcesContent":["import { Effect } from \"effect\";\nimport { nanoid } from \"nanoid\";\n\nimport { createEffectPlugin } from \"../plugin-event-system.js\";\n\nconst X_INTERFERE_REQUEST_HEADER = \"x-interfere-request\";\n\n/**\n * Generate a unique request ID\n */\nfunction generateRequestId(): string {\n  return nanoid();\n}\n\n/**\n * Check if a URL matches any of the tracing origins\n */\nfunction shouldTraceUrl(\n  url: string,\n  tracingOrigins?: boolean | (string | RegExp)[]\n): boolean {\n  if (!tracingOrigins) {\n    return false;\n  }\n\n  if (tracingOrigins === true) {\n    // If true, match all URLs on the same origin\n    try {\n      const currentOrigin = window.location.origin;\n      const urlObj = new URL(url, window.location.href);\n      return urlObj.origin === currentOrigin;\n    } catch {\n      // If URL parsing fails, default to false\n      return false;\n    }\n  }\n\n  // Check against array of patterns\n  for (const pattern of tracingOrigins) {\n    if (\n      (typeof pattern === \"string\" && url.includes(pattern)) ||\n      (pattern instanceof RegExp && pattern.test(url))\n    ) {\n      return true;\n    }\n  }\n\n  return false;\n}\n\n/**\n * Get session ID synchronously from localStorage.\n *\n * NOTE: Unlike other plugins that use `ctx.capture()` (which automatically\n * gets session ID via `buildEnvelopeEffect()` -> `SessionServiceTag`),\n * this plugin needs synchronous access because:\n * 1. We're patching network requests (fetch/XHR) synchronously\n * 2. Headers must be set synchronously before requests are sent\n *\n * The session service stores the session ID in localStorage (see session.layer.ts),\n * so reading directly is safe and matches the storage location used by the service.\n */\nfunction getSessionIdSync(): string | null {\n  if (typeof window === \"undefined\") {\n    return null;\n  }\n\n  try {\n    const storage = window.localStorage;\n    if (!storage) {\n      return null;\n    }\n\n    const stored = storage.getItem(\"__interfere_session_id__\");\n    return stored;\n  } catch {\n    // Storage might be blocked or unavailable\n    return null;\n  }\n}\n\n/**\n * Get session ID asynchronously (for fetch API compatibility).\n * Uses synchronous read since session ID is stored in localStorage.\n */\nfunction getSessionIdAsync(): Promise<string | null> {\n  return Promise.resolve(getSessionIdSync());\n}\n\n/**\n * Create the x-interfere-request header value\n */\nfunction createRequestHeader(\n  sessionId: string | null,\n  requestId: string\n): string {\n  // Format: {sessionId}/{requestId}\n  // If no session ID yet, use empty string as placeholder\n  return `${sessionId ?? \"\"}/${requestId}`;\n}\n\nexport type ServerTracingAPI = null;\n\nexport default createEffectPlugin(\"serverTracing\", {\n  name: \"serverTracing\",\n  setup: (ctx) =>\n    Effect.gen(function* () {\n      if (typeof window === \"undefined\") {\n        ctx.log.debug(\"serverTracing: SSR - skipping setup\");\n        return;\n      }\n\n      // Default to true - trace all same-origin requests\n      // This is plugin-specific config, not part of base SDK config\n      const tracingOrigins = true;\n\n      ctx.log.debug(\"serverTracing: patching fetch and XMLHttpRequest\", {\n        tracingOrigins,\n      });\n\n      // Patch fetch API\n      const originalFetch: typeof window.fetch = window.fetch.bind(window);\n\n      const extractUrl = (input: RequestInfo | URL): string => {\n        if (typeof input === \"string\") {\n          // If it's a relative URL, convert to absolute\n          try {\n            return new URL(input, window.location.href).href;\n          } catch {\n            return input;\n          }\n        }\n        if (input instanceof URL) {\n          return input.href;\n        }\n        // Request.url might be relative, convert to absolute\n        try {\n          return new URL(input.url, window.location.href).href;\n        } catch {\n          return input.url;\n        }\n      };\n\n      const mergeHeaders = (init?: RequestInit, request?: Request): Headers => {\n        const headers = new Headers(init?.headers);\n\n        if (request) {\n          for (const [key, value] of request.headers.entries()) {\n            if (!headers.has(key)) {\n              headers.set(key, value);\n            }\n          }\n        }\n\n        return headers;\n      };\n\n      const patchedFetch: typeof window.fetch = async (\n        input: RequestInfo | URL,\n        init?: RequestInit\n      ) => {\n        const url = extractUrl(input);\n\n        // Check if we should trace this request\n        const shouldTrace = url && shouldTraceUrl(url, tracingOrigins);\n        if (!shouldTrace) {\n          ctx.log.debug(\"serverTracing: skipping URL\", { url, tracingOrigins });\n          return originalFetch(input, init);\n        }\n\n        const sessionId = await getSessionIdAsync();\n        const requestId = generateRequestId();\n        const headerValue = createRequestHeader(sessionId, requestId);\n\n        ctx.log.debug(\"serverTracing: injecting header\", {\n          url,\n          sessionId,\n          requestId,\n          headerValue,\n        });\n\n        // Merge headers\n        const headers = mergeHeaders(\n          init,\n          input instanceof Request ? input : undefined\n        );\n\n        // Set x-interfere-request header\n        headers.set(X_INTERFERE_REQUEST_HEADER, headerValue);\n\n        // If input is a Request object, create a new Request\n        if (input instanceof Request) {\n          return originalFetch(\n            new Request(input, {\n              headers,\n            })\n          );\n        }\n\n        // Create new init object with merged headers\n        const newInit: RequestInit = {\n          ...init,\n          headers,\n        };\n\n        return originalFetch(input, newInit);\n      };\n\n      window.fetch = patchedFetch;\n\n      // Patch XMLHttpRequest\n      // We need to patch setRequestHeader to inject the header when needed\n      const originalXHROpen = XMLHttpRequest.prototype.open;\n      const originalXHRSend = XMLHttpRequest.prototype.send;\n      const originalSetRequestHeader =\n        XMLHttpRequest.prototype.setRequestHeader;\n\n      XMLHttpRequest.prototype.open = function (\n        method: string,\n        url: string | URL,\n        ...rest: unknown[]\n      ) {\n        // Store the URL for use later\n        const urlString = typeof url === \"string\" ? url : url.href;\n        (this as XMLHttpRequest & { _interfereUrl?: string })._interfereUrl =\n          urlString;\n\n        // Call original - XMLHttpRequest.open accepts 2-5 parameters\n        // biome-ignore lint/suspicious/noExplicitAny: XMLHttpRequest.open has variable arity\n        return (originalXHROpen as any).call(this, method, url, ...rest);\n      };\n\n      XMLHttpRequest.prototype.setRequestHeader = function (\n        name: string,\n        value: string\n      ) {\n        const url = (this as XMLHttpRequest & { _interfereUrl?: string })\n          ._interfereUrl;\n\n        // If this is a traced URL, inject our header\n        if (url && shouldTraceUrl(url, tracingOrigins)) {\n          // Get session ID synchronously for XHR\n          const sessionId = getSessionIdSync();\n          const requestId = generateRequestId();\n          const headerValue = createRequestHeader(sessionId, requestId);\n\n          // Set our header first if it hasn't been set\n          if (\n            !(this as XMLHttpRequest & { _interfereHeaderSet?: boolean })\n              ._interfereHeaderSet\n          ) {\n            originalSetRequestHeader.call(\n              this,\n              X_INTERFERE_REQUEST_HEADER,\n              headerValue\n            );\n            (\n              this as XMLHttpRequest & { _interfereHeaderSet?: boolean }\n            )._interfereHeaderSet = true;\n          }\n        }\n\n        return originalSetRequestHeader.call(this, name, value);\n      };\n\n      XMLHttpRequest.prototype.send = function (\n        body?: Document | XMLHttpRequestBodyInit | null\n      ) {\n        const url = (this as XMLHttpRequest & { _interfereUrl?: string })\n          ._interfereUrl;\n\n        // Ensure header is set if needed (fallback in case setRequestHeader wasn't called)\n        if (\n          url &&\n          shouldTraceUrl(url, tracingOrigins) &&\n          !(this as XMLHttpRequest & { _interfereHeaderSet?: boolean })\n            ._interfereHeaderSet\n        ) {\n          const sessionId = getSessionIdSync();\n          const requestId = generateRequestId();\n          const headerValue = createRequestHeader(sessionId, requestId);\n          originalSetRequestHeader.call(\n            this,\n            X_INTERFERE_REQUEST_HEADER,\n            headerValue\n          );\n          (\n            this as XMLHttpRequest & { _interfereHeaderSet?: boolean }\n          )._interfereHeaderSet = true;\n        }\n\n        return originalXHRSend.call(this, body);\n      };\n\n      return {\n        key: \"serverTracing\",\n        cleanup: () => {\n          ctx.log.debug(\"serverTracing: removing patches\");\n\n          window.fetch = originalFetch;\n          XMLHttpRequest.prototype.open = originalXHROpen;\n          XMLHttpRequest.prototype.send = originalXHRSend;\n          XMLHttpRequest.prototype.setRequestHeader = originalSetRequestHeader;\n        },\n      };\n    }),\n});\n"],"mappings":"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"}

package/dist/core/plugins/plugin-event-system.d.mts

@@ -0,0 +1,47 @@
+import { AnyEventDefinition, EventDefinitionFor, EventSchemas, EventsForPlugin } from "../events/plugin-event-types.mjs";
+import { Plugin, PluginContext } from "../schemas.mjs";
+import { Effect } from "effect";
+import { PluginKey } from "@interfere/types/sdk/plugins/lib/types";
+import { z } from "zod";
+
+//#region src/core/plugins/plugin-event-system.d.ts
+type SetupResult = {
+  api?: object;
+  cleanup?: () => void;
+} | undefined;
+declare function createPlugin<TKey extends PluginKey>(key: TKey, config: {
+  name: string;
+  events?: readonly Extract<AnyEventDefinition, {
+    type: EventsForPlugin<TKey>;
+  }>[];
+  setup: (ctx: PluginContext) => SetupResult | Promise<SetupResult>;
+}): Plugin<TKey, unknown>;
+declare function createEffectPlugin<TKey extends PluginKey>(key: TKey, config: {
+  name: string;
+  events?: readonly Extract<AnyEventDefinition, {
+    type: EventsForPlugin<TKey>;
+  }>[];
+  setup: (ctx: PluginContext) => Effect.Effect<{
+    api?: object;
+    cleanup?: () => void;
+  } | undefined, never>;
+}): Plugin<TKey, unknown>;
+declare function createEffectPlugin<TKey extends PluginKey, TConfig>(key: TKey, config: {
+  name: string;
+  events?: readonly Extract<AnyEventDefinition, {
+    type: EventsForPlugin<TKey>;
+  }>[];
+  config: TConfig;
+  setup: (ctx: PluginContext, config: TConfig) => Effect.Effect<{
+    api?: object;
+    cleanup?: () => void;
+  } | undefined, never>;
+}): Plugin<TKey, unknown>;
+type FinalEventDefinition<T extends keyof EventSchemas> = EventDefinitionFor<T>;
+declare function defineEvent<T extends keyof EventSchemas>(type: T): {
+  enrich: (v?: boolean) => EventDefinitionFor<T>;
+  transform: <TOut>(fn: (input: z.infer<EventSchemas[T]>) => TOut) => EventDefinitionFor<T>;
+  value: () => EventDefinitionFor<T>;
+};
+//#endregion
+export { FinalEventDefinition, createEffectPlugin, createPlugin, defineEvent };

package/dist/core/plugins/plugin-event-system.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-event-system.d.mts","names":[],"sources":["../../../src/core/plugins/plugin-event-system.ts"],"sourcesContent":[],"mappings":";;;;;;;KAiBK,WAAA;;EAAA,OAAA,CAAA,EAAA,GAAA,GAAW,IAAA;AAOhB,CAAA,GAAgB,SAAA;AAA0B,iBAA1B,YAA0B,CAAA,aAAA,SAAA,CAAA,CAAA,GAAA,EACnC,IADmC,EAAA,MAAA,EAAA;EACnC,IAAA,EAAA,MAAA;EAID,MAAA,CAAA,EAAA,SADgB,OAChB,CAAA,kBAAA,EAAA;IACwB,IAAA,EAAhB,eAAgB,CAAA,IAAA,CAAA;EAAhB,CAAA,CAAA,EAAA;EAFQ,KAAA,EAAA,CAAA,GAAA,EAIL,aAJK,EAAA,GAIa,WAJb,GAI2B,OAJ3B,CAImC,WAJnC,CAAA;CAIL,CAAA,EAEd,MAFc,CAEP,IAFO,EAAA,OAAA,CAAA;AAAkB,iBA8BnB,kBA9BmB,CAAA,aA8Ba,SA9Bb,CAAA,CAAA,GAAA,EA+B5B,IA/B4B,EAAA,MAAA,EAAA;EAAsB,IAAA,EAAA,MAAA;EAAR,MAAA,CAAA,EAAA,SAkC3B,OAlC2B,CAmC3C,kBAnC2C,EAAA;IAEvC,IAAA,EAkCI,eAlCJ,CAkCoB,IAlCpB,CAAA;EAAP,CAAA,CAAA,EAAA;EAAM,KAAA,EAAA,CAAA,GAAA,EAoCQ,aApCR,EAAA,GAoC0B,MAAA,CAAW,MApCrC,CAAA;IA4BO,GAAA,CAAA,EAAA,MAAA;IAAgC,OAAA,CAAA,EAAA,GAAA,GAAA,IAAA;EACzC,CAAA,GAAA,SAAA,EAAA,KAAA,CAAA;CAID,CAAA,EAYH,MAZG,CAYI,IAZJ,EAAA,OAAA,CAAA;AACwB,iBAad,kBAbc,CAAA,aAakB,SAblB,EAAA,OAAA,CAAA,CAAA,GAAA,EAcvB,IAduB,EAAA,MAAA,EAAA;EAAhB,IAAA,EAAA,MAAA;EAFQ,MAAA,CAAA,EAAA,SAmBA,OAnBA,CAoBhB,kBApBgB,EAAA;IAIL,IAAA,EAiBH,eAjBG,CAiBa,IAjBb,CAAA;EAAkB,CAAA,CAAA,EAAW;EASpC,MAAA,EAUE,OAVF;EAAP,KAAA,EAAA,CAAA,GAAA,EAYQ,aAZR,EAAA,MAAA,EAaW,OAbX,EAAA,GAcM,MAAA,CAAW,MAdjB,CAAA;IAAM,GAAA,CAAA,EAAA,MAAA;IAEO,OAAA,CAAA,EAAA,GAAA,GAAA,IAAkB;EAAc,CAAA,GAAA,SAAA,EAAA,KAAA,CAAA;CACzC,CAAA,EAoBJ,MApBI,CAoBG,IApBH,EAAA,OAAA,CAAA;AAID,KA2DM,oBA3DN,CAAA,UAAA,MA2D2C,YA3D3C,CAAA,GA4DJ,kBA5DI,CA4De,CA5Df,CAAA;AACwB,iBA0Fd,WA1Fc,CAAA,UAAA,MA0Fc,YA1Fd,CAAA,CAAA,IAAA,EA0FkC,CA1FlC,CAAA,EAAA;EAAhB,MAAA,EAAA,CAAA,CAAA,CAAA,EAAA,OAAA,EAAA,GA8FU,kBA9FV,CA8FU,CA9FV,CAAA;EAFQ,SAAA,EAAA,CAAA,IAAA,CAAA,CAAA,EAAA,EAAA,CAAA,KAAA,EAiGY,CAAA,CAAE,KAjGd,CAiGoB,YAjGpB,CAiGiC,CAjGjC,CAAA,CAAA,EAAA,GAiGyC,IAjGzC,EAAA,GAiG6C,kBAjG7C,CAiG6C,CAjG7C,CAAA;EAIV,KAAA,EAAA,GAAA,qBAAA,EAAA,CAAA;CAED"}

package/dist/core/plugins/plugin-event-system.mjs

@@ -0,0 +1,75 @@
+import { eventConfigs, eventSchemas } from "../events/plugin-event-types.mjs";
+import { dynamicRegistry } from "../events/event-registry.mjs";
+import { runWithSDK } from "../../effect/runtime-services.mjs";
+
+//#region src/core/plugins/plugin-event-system.ts
+function createPlugin(key, config) {
+	return {
+		name: config.name,
+		events: config.events,
+		async setup(ctx) {
+			if (config.events) for (const eventDef of config.events) dynamicRegistry.registerDefinition(eventDef);
+			const result = await Promise.resolve(config.setup(ctx));
+			if (!result) return {
+				key,
+				api: void 0,
+				cleanup: void 0
+			};
+			return {
+				key,
+				api: result.api,
+				cleanup: result.cleanup
+			};
+		}
+	};
+}
+function createEffectPlugin(key, config) {
+	return createPlugin(key, {
+		name: config.name,
+		events: config.events,
+		setup: (ctx) => {
+			if ("config" in config && config.config !== void 0) {
+				const setupFnWithConfig = config.setup;
+				return runWithSDK(setupFnWithConfig(ctx, config.config));
+			}
+			const setupFnWithoutConfig = config.setup;
+			return runWithSDK(setupFnWithoutConfig(ctx));
+		}
+	});
+}
+var FinalEventDefBuilder = class {
+	def;
+	constructor(type) {
+		this.def = {
+			type,
+			schema: eventSchemas[type],
+			enrich: eventConfigs[type].enrich
+		};
+	}
+	enrich(value = true) {
+		return {
+			...this.def,
+			enrich: value
+		};
+	}
+	transform(fn) {
+		return {
+			...this.def,
+			transform: fn
+		};
+	}
+	value() {
+		return { ...this.def };
+	}
+};
+function defineEvent(type) {
+	const builder = new FinalEventDefBuilder(type);
+	return {
+		enrich: (v) => builder.enrich(v ?? true),
+		transform: (fn) => builder.transform(fn),
+		value: () => builder.value()
+	};
+}
+
+//#endregion
+export { createEffectPlugin, createPlugin, defineEvent };

package/dist/core/plugins/plugin-event-system.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-event-system.mjs","names":[],"sources":["../../../src/core/plugins/plugin-event-system.ts"],"sourcesContent":["import type { PluginKey } from \"@interfere/types/sdk/plugins/lib/types\";\n\nimport type { Effect as EffectType } from \"effect\";\nimport type { z } from \"zod\";\n\nimport { runWithSDK } from \"../../effect/runtime-services.js\";\nimport { dynamicRegistry } from \"../events/event-registry.js\";\nimport {\n  type AnyEventDefinition,\n  type EventDefinitionFor,\n  type EventSchemas,\n  type EventsForPlugin,\n  eventConfigs,\n  eventSchemas,\n} from \"../events/plugin-event-types.js\";\nimport type { Plugin, PluginContext } from \"../schemas.js\";\n\ntype SetupResult =\n  | {\n      api?: object;\n      cleanup?: () => void;\n    }\n  | undefined;\n\nexport function createPlugin<TKey extends PluginKey>(\n  key: TKey,\n  config: {\n    name: string;\n    events?: readonly Extract<\n      AnyEventDefinition,\n      { type: EventsForPlugin<TKey> }\n    >[];\n    setup: (ctx: PluginContext) => SetupResult | Promise<SetupResult>;\n  }\n): Plugin<TKey, unknown> {\n  return {\n    name: config.name,\n    events: config.events,\n    async setup(ctx: PluginContext) {\n      // Register event handlers if provided\n      if (config.events) {\n        for (const eventDef of config.events) {\n          dynamicRegistry.registerDefinition(eventDef);\n        }\n      }\n\n      // Run the plugin's setup\n      const result = await Promise.resolve(config.setup(ctx));\n\n      if (!result) {\n        return { key, api: undefined, cleanup: undefined };\n      }\n\n      return {\n        key,\n        api: result.api,\n        cleanup: result.cleanup,\n      };\n    },\n  };\n}\n\nexport function createEffectPlugin<TKey extends PluginKey>(\n  key: TKey,\n  config: {\n    name: string;\n    events?: readonly Extract<\n      AnyEventDefinition,\n      { type: EventsForPlugin<TKey> }\n    >[];\n    setup: (ctx: PluginContext) => EffectType.Effect<\n      | {\n          api?: object;\n          cleanup?: () => void;\n        }\n      | undefined,\n      never\n    >;\n  }\n): Plugin<TKey, unknown>;\n\nexport function createEffectPlugin<TKey extends PluginKey, TConfig>(\n  key: TKey,\n  config: {\n    name: string;\n    events?: readonly Extract<\n      AnyEventDefinition,\n      { type: EventsForPlugin<TKey> }\n    >[];\n    config: TConfig;\n    setup: (\n      ctx: PluginContext,\n      config: TConfig\n    ) => EffectType.Effect<\n      | {\n          api?: object;\n          cleanup?: () => void;\n        }\n      | undefined,\n      never\n    >;\n  }\n): Plugin<TKey, unknown>;\n\nexport function createEffectPlugin<TKey extends PluginKey, TConfig = undefined>(\n  key: TKey,\n  config: {\n    name: string;\n    events?: readonly Extract<\n      AnyEventDefinition,\n      { type: EventsForPlugin<TKey> }\n    >[];\n    config?: TConfig;\n    setup: (\n      ctx: PluginContext,\n      config?: TConfig\n    ) => EffectType.Effect<\n      | {\n          api?: object;\n          cleanup?: () => void;\n        }\n      | undefined,\n      never\n    >;\n  }\n): Plugin<TKey, unknown> {\n  return createPlugin(key, {\n    name: config.name,\n    events: config.events,\n    setup: (ctx) => {\n      if (\"config\" in config && config.config !== undefined) {\n        const setupFnWithConfig = config.setup as (\n          context: PluginContext,\n          cfg: TConfig\n        ) => EffectType.Effect<SetupResult, never>;\n        return runWithSDK(setupFnWithConfig(ctx, config.config));\n      }\n      const setupFnWithoutConfig = config.setup as (\n        context: PluginContext\n      ) => EffectType.Effect<SetupResult, never>;\n      return runWithSDK(setupFnWithoutConfig(ctx));\n    },\n  });\n}\n\nexport type FinalEventDefinition<T extends keyof EventSchemas> =\n  EventDefinitionFor<T>;\n\nclass FinalEventDefBuilder<T extends keyof EventSchemas> {\n  private readonly def: FinalEventDefinition<T>;\n\n  constructor(type: T) {\n    this.def = {\n      type,\n      schema: eventSchemas[type],\n      enrich: eventConfigs[type].enrich,\n    } as FinalEventDefinition<T>;\n  }\n\n  enrich(value = true): FinalEventDefinition<T> {\n    return { ...this.def, enrich: value } as FinalEventDefinition<T>;\n  }\n\n  transform<TOut>(\n    fn: (input: z.infer<EventSchemas[T]>) => TOut\n  ): FinalEventDefinition<T> {\n    return {\n      ...this.def,\n      transform: fn as (i: unknown) => unknown,\n    } as FinalEventDefinition<T>;\n  }\n\n  value(): FinalEventDefinition<T> {\n    return { ...this.def } as FinalEventDefinition<T>;\n  }\n}\n\nexport function defineEvent<T extends keyof EventSchemas>(type: T) {\n  const builder = new FinalEventDefBuilder(type);\n\n  return {\n    enrich: (v?: boolean) => builder.enrich(v ?? true),\n    transform: <TOut>(fn: (input: z.infer<EventSchemas[T]>) => TOut) =>\n      builder.transform(fn),\n    value: () => builder.value(),\n  };\n}\n"],"mappings":";;;;;AAwBA,SAAgB,aACd,KACA,QAQuB;AACvB,QAAO;EACL,MAAM,OAAO;EACb,QAAQ,OAAO;EACf,MAAM,MAAM,KAAoB;AAE9B,OAAI,OAAO,OACT,MAAK,MAAM,YAAY,OAAO,OAC5B,iBAAgB,mBAAmB,SAAS;GAKhD,MAAM,SAAS,MAAM,QAAQ,QAAQ,OAAO,MAAM,IAAI,CAAC;AAEvD,OAAI,CAAC,OACH,QAAO;IAAE;IAAK,KAAK;IAAW,SAAS;IAAW;AAGpD,UAAO;IACL;IACA,KAAK,OAAO;IACZ,SAAS,OAAO;IACjB;;EAEJ;;AA6CH,SAAgB,mBACd,KACA,QAmBuB;AACvB,QAAO,aAAa,KAAK;EACvB,MAAM,OAAO;EACb,QAAQ,OAAO;EACf,QAAQ,QAAQ;AACd,OAAI,YAAY,UAAU,OAAO,WAAW,QAAW;IACrD,MAAM,oBAAoB,OAAO;AAIjC,WAAO,WAAW,kBAAkB,KAAK,OAAO,OAAO,CAAC;;GAE1D,MAAM,uBAAuB,OAAO;AAGpC,UAAO,WAAW,qBAAqB,IAAI,CAAC;;EAE/C,CAAC;;AAMJ,IAAM,uBAAN,MAAyD;CACvD,AAAiB;CAEjB,YAAY,MAAS;AACnB,OAAK,MAAM;GACT;GACA,QAAQ,aAAa;GACrB,QAAQ,aAAa,MAAM;GAC5B;;CAGH,OAAO,QAAQ,MAA+B;AAC5C,SAAO;GAAE,GAAG,KAAK;GAAK,QAAQ;GAAO;;CAGvC,UACE,IACyB;AACzB,SAAO;GACL,GAAG,KAAK;GACR,WAAW;GACZ;;CAGH,QAAiC;AAC/B,SAAO,EAAE,GAAG,KAAK,KAAK;;;AAI1B,SAAgB,YAA0C,MAAS;CACjE,MAAM,UAAU,IAAI,qBAAqB,KAAK;AAE9C,QAAO;EACL,SAAS,MAAgB,QAAQ,OAAO,KAAK,KAAK;EAClD,YAAkB,OAChB,QAAQ,UAAU,GAAG;EACvB,aAAa,QAAQ,OAAO;EAC7B"}

package/dist/core/plugins/plugin-loader.d.mts

@@ -0,0 +1,22 @@
+import { InferredApis, KnownPluginApis, Plugin, PluginContext } from "../schemas.mjs";
+import { Effect } from "effect";
+import { Config } from "@interfere/types/sdk/config";
+import { PluginKey } from "@interfere/types/sdk/plugins/lib/types";
+
+//#region src/core/plugins/plugin-loader.d.ts
+type PluginCleanup = () => void;
+interface PluginLoader {
+  loadAndSetupPlugins<P extends readonly Plugin<string, unknown>[] | undefined>(config: Config, pluginContext: PluginContext, userPlugins?: P): Promise<{
+    cleanups: PluginCleanup[];
+    apis: Partial<KnownPluginApis & (P extends undefined ? Record<never, never> : InferredApis<NonNullable<P>>)>;
+    keys: Set<PluginKey | (P extends undefined ? never : InferredPluginKey<P>)>;
+  }>;
+}
+type InferredPluginKey<P> = P extends readonly Plugin<string, unknown>[] ? P[number] extends Plugin<infer K, unknown> ? K : never : never;
+declare function loadAndSetupPluginsEffect<P extends readonly Plugin<string, unknown>[] | undefined>(config: Config, pluginContext: PluginContext, userPlugins?: P): Effect.Effect<{
+  cleanups: PluginCleanup[];
+  apis: Readonly<Partial<KnownPluginApis & (P extends undefined ? Record<never, never> : InferredApis<NonNullable<P>>)>>;
+  keys: Set<PluginKey | (P extends undefined ? never : InferredPluginKey<P>)>;
+}, never, never>;
+//#endregion
+export { PluginCleanup, PluginLoader, loadAndSetupPluginsEffect };

package/dist/core/plugins/plugin-loader.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-loader.d.mts","names":[],"sources":["../../../src/core/plugins/plugin-loader.ts"],"sourcesContent":[],"mappings":";;;;;;KAkBY,aAAA;UAEK,YAAA;EAFL,mBAAa,CAAA,UAAA,SAGgB,MAHhB,CAAA,MAAA,EAAA,OAAA,CAAA,EAAA,GAAA,SAAA,CAAA,CAAA,MAAA,EAIb,MAJa,EAAA,aAAA,EAKN,aALM,EAAA,WAAA,CAAA,EAMP,CANO,CAAA,EAOpB,OAPoB,CAAA;IAER,QAAA,EAMH,aANe,EAAA;IACY,IAAA,EAM/B,OAN+B,CAOnC,eAPmC,GAAA,CAQhC,CARgC,SAAA,SAAA,GAS7B,MAT6B,CAAA,KAAA,EAAA,KAAA,CAAA,GAU7B,YAV6B,CAUhB,WAVgB,CAUJ,CAVI,CAAA,CAAA,CAAA,CAAA;IAC7B,IAAA,EAWF,GAXE,CAWE,SAXF,GAAA,CAWe,CAXf,SAAA,SAAA,GAAA,KAAA,GAW6C,iBAX7C,CAW+D,CAX/D,CAAA,CAAA,CAAA;EACO,CAAA,CAAA;;KAcd,iBAXS,CAAA,CAAA,CAAA,GAWc,CAXd,SAAA,SAWiC,MAXjC,CAAA,MAAA,EAAA,OAAA,CAAA,EAAA,GAYV,CAZU,CAAA,MAAA,CAAA,SAYQ,MAZR,CAAA,KAAA,EAAA,EAAA,OAAA,CAAA,GAAA,CAAA,GAAA,KAAA,GAAA,KAAA;AAER,iBAoBU,yBApBV,CAAA,UAAA,SAqBe,MArBf,CAAA,MAAA,EAAA,OAAA,CAAA,EAAA,GAAA,SAAA,CAAA,CAAA,MAAA,EAsBI,MAtBJ,EAAA,aAAA,EAsB2B,aAtB3B,EAAA,WAAA,CAAA,EAsBwD,CAtBxD,CAAA,EAsByD,MAAA,CAAA,MAtBzD,CAAA;EACG,QAAA,eAAA,EAAA;EACG,IAAA,UAAA,QAAA,gBAAA,GAAA,EAAA,SAAA,SAAA,SAAA,CAAA,KAAA,EAAA,KAAA,CAAA,eAAA,YAAA,EAAA,CAAA,CAAA,CAAA,CAAA,CAAA;EACyB,IAAA,EAmQjB,GAnQiB,CAoQ7B,SApQ6B,GAAA,CAoQhB,CApQgB,SAAA,SAAA,GAAA,KAAA,GAoQc,iBApQd,CAoQgC,CApQhC,CAAA,CAAA,CAAA;CAAZ,EAAA,KAAA,EAAA,KAAA,CAAA"}

package/dist/core/plugins/plugin-loader.mjs

@@ -0,0 +1,142 @@
+import { dynamicRegistry } from "../events/event-registry.mjs";
+import { withSpan } from "../../effect/layers/tracer.layer.mjs";
+import { Effect } from "effect";
+import { PLUGIN_MANIFEST } from "@interfere/types/sdk/plugins/manifest";
+
+//#region src/core/plugins/plugin-loader.ts
+function loadAndSetupPluginsEffect(config, pluginContext, userPlugins) {
+	const handlers = [];
+	const apis = {};
+	const keys = /* @__PURE__ */ new Set();
+	const registerPluginEvents = (plugin) => Effect.gen(function* () {
+		const withEvents = plugin;
+		if (withEvents.events && withEvents.events.length > 0) {
+			yield* Effect.logTrace(`Registering ${withEvents.events.length} events for plugin '${plugin.name}'`).pipe(Effect.annotateLogs({
+				plugin: plugin.name,
+				eventCount: withEvents.events.length
+			}));
+			for (const eventDef of withEvents.events) dynamicRegistry.registerDefinition(eventDef);
+		}
+	});
+	const registerExposeKey = (expose) => Effect.gen(function* () {
+		if (expose.key && isPluginKey(expose.key)) {
+			keys.add(expose.key);
+			yield* Effect.logTrace(`Plugin '${expose.key}' registered`).pipe(Effect.annotateLogs({ expose }));
+		}
+	});
+	const registerExposeCleanup = (expose) => Effect.gen(function* () {
+		if (typeof expose.cleanup === "function") {
+			handlers.push(expose.cleanup);
+			yield* Effect.logTrace(`Plugin '${expose.key}' registered expose cleanup`).pipe(Effect.annotateLogs({ expose }));
+		}
+	});
+	const registerExposeApi = (expose) => Effect.gen(function* () {
+		if (expose.api && expose.key) {
+			apis[expose.key] = expose.api;
+			yield* Effect.logTrace(`Plugin '${expose.key}' exposed API`).pipe(Effect.annotateLogs({
+				key: expose.key,
+				api: expose.api
+			}));
+		}
+	});
+	const processSetupResult = (result) => Effect.gen(function* () {
+		if (!result) {
+			yield* Effect.logTrace("Plugin returned no expose (skipped)");
+			return;
+		}
+		if (typeof result === "function") {
+			handlers.push(result);
+			yield* Effect.logTrace(`Registered cleanup handler - ${handlers.length} total`).pipe(Effect.annotateLogs({ result }));
+			return;
+		}
+		yield* registerExposeKey(result);
+		yield* registerExposeCleanup(result);
+		yield* registerExposeApi(result);
+	});
+	const setupPlugin = (plugin) => Effect.gen(function* () {
+		try {
+			yield* Effect.logTrace(`Setting up plugin '${plugin.name}'`).pipe(Effect.annotateLogs({ plugin: plugin.name }));
+			yield* registerPluginEvents(plugin);
+			yield* processSetupResult(yield* withSpan("plugin.setup", Effect.promise(() => Promise.resolve(plugin.setup(pluginContext))), { attributes: { pluginName: plugin.name } }));
+			yield* Effect.logTrace(`Plugin '${plugin.name}' setup complete`).pipe(Effect.annotateLogs({ plugin: plugin.name }));
+		} catch (error) {
+			yield* Effect.logError("Failed to setup plugin").pipe(Effect.annotateLogs({
+				plugin: plugin.name,
+				error: error instanceof Error ? error.message : String(error)
+			}));
+		}
+	});
+	const loadPluginModule = (key) => {
+		switch (key) {
+			case "errors": return import("./impl/errors.mjs");
+			case "replay": return import("./impl/replay.mjs");
+			case "rageClick": return import("./impl/rage-click.mjs");
+			case "aiSummary": return import("./impl/ai-summary.mjs");
+			case "pageEvents": return import("./impl/page-events.mjs");
+			case "serverTracing": return import("./impl/server-tracing.mjs");
+			default: return Promise.reject(/* @__PURE__ */ new Error(`Unknown plugin key: ${key}`));
+		}
+	};
+	const isPluginKey = (key) => typeof key === "string" && PLUGIN_MANIFEST.some(({ name }) => name === key);
+	const createLoadPluginEffect = (key) => Effect.gen(function* () {
+		try {
+			yield* Effect.logTrace("Importing plugin module").pipe(Effect.annotateLogs({ key }));
+			const mod = yield* Effect.promise(() => loadPluginModule(key));
+			yield* Effect.logTrace("Imported plugin module").pipe(Effect.annotateLogs({ key }));
+			const plugin = mod.default;
+			if (plugin && typeof plugin === "object") yield* setupPlugin(plugin);
+			else yield* Effect.logError("Plugin missing default export").pipe(Effect.annotateLogs({ key }));
+		} catch (error) {
+			yield* Effect.logError("Failed to import plugin").pipe(Effect.annotateLogs({
+				key,
+				error: String(error)
+			}));
+		}
+	});
+	const loadBuiltinPlugins = Effect.gen(function* () {
+		const loadPromises = [];
+		const entries = Object.entries(config.features);
+		const enabled = entries.filter(([_, v]) => v).map(([k]) => k);
+		const disabled = entries.filter(([_, v]) => !v).map(([k]) => k);
+		yield* Effect.logDebug(`Loading ${enabled.length} plugins (${disabled.length ?? "Nothing"} disabled)`).pipe(Effect.annotateLogs({
+			total: entries.length,
+			enabled,
+			disabled
+		}));
+		for (const [key, value] of entries) {
+			if (!value) {
+				yield* Effect.logTrace(`Plugin '${key}' disabled`).pipe(Effect.annotateLogs({ key }));
+				continue;
+			}
+			if (!isPluginKey(key)) {
+				yield* Effect.logError("Invalid plugin key", { key });
+				continue;
+			}
+			const loadPlugin = createLoadPluginEffect(key);
+			loadPromises.push(loadPlugin);
+		}
+		yield* Effect.all(loadPromises, { concurrency: "unbounded" });
+	});
+	const loadUserPlugins = Effect.gen(function* () {
+		if (userPlugins) {
+			const setupPromises = userPlugins.map((plugin) => setupPlugin(plugin));
+			yield* Effect.all(setupPromises, { concurrency: "unbounded" });
+		}
+	});
+	const warnIfNoPluginsLoaded = Effect.gen(function* () {
+		if (Object.keys(apis).length === 0) yield* Effect.logWarning("No plugins were loaded. Check your config.features to enable plugins.");
+	});
+	return Effect.gen(function* () {
+		yield* Effect.logTrace("Starting plugin loading process").pipe(Effect.annotateLogs({ config }));
+		yield* Effect.all([loadBuiltinPlugins, loadUserPlugins], { concurrency: "unbounded" });
+		yield* warnIfNoPluginsLoaded;
+		return {
+			cleanups: handlers,
+			apis: Object.freeze({ ...apis }),
+			keys
+		};
+	});
+}
+
+//#endregion
+export { loadAndSetupPluginsEffect };

package/dist/core/plugins/plugin-loader.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-loader.mjs","names":["handlers: PluginCleanup[]","apis: Apis<P>","loadPromises: Effect.Effect<void, never, never>[]"],"sources":["../../../src/core/plugins/plugin-loader.ts"],"sourcesContent":["import type { Config } from \"@interfere/types/sdk/config\";\nimport type { PluginKey } from \"@interfere/types/sdk/plugins/lib/types\";\nimport { PLUGIN_MANIFEST } from \"@interfere/types/sdk/plugins/manifest\";\n\nimport { Effect } from \"effect\";\n\nimport { withSpan } from \"../../effect/layers/tracer.layer.js\";\nimport { dynamicRegistry } from \"../events/event-registry.js\";\nimport type { AnyEventDefinition } from \"../events/plugin-event-types.js\";\nimport type {\n  InferredApis,\n  KnownPluginApis,\n  Plugin,\n  PluginContext,\n  PluginExpose,\n} from \"../schemas.js\";\n// Unified Plugin type; enhanced variants removed\n\nexport type PluginCleanup = () => void;\n\nexport interface PluginLoader {\n  loadAndSetupPlugins<P extends readonly Plugin<string, unknown>[] | undefined>(\n    config: Config,\n    pluginContext: PluginContext,\n    userPlugins?: P\n  ): Promise<{\n    cleanups: PluginCleanup[];\n    apis: Partial<\n      KnownPluginApis &\n        (P extends undefined\n          ? Record<never, never>\n          : InferredApis<NonNullable<P>>)\n    >;\n    keys: Set<PluginKey | (P extends undefined ? never : InferredPluginKey<P>)>;\n  }>;\n}\n\ntype InferredPluginKey<P> = P extends readonly Plugin<string, unknown>[]\n  ? P[number] extends Plugin<infer K, unknown>\n    ? K\n    : never\n  : never;\n\ntype Apis<P extends readonly Plugin<string, unknown>[] | undefined> = Partial<\n  KnownPluginApis &\n    (P extends undefined ? Record<never, never> : InferredApis<NonNullable<P>>)\n>;\n\nexport function loadAndSetupPluginsEffect<\n  P extends readonly Plugin<string, unknown>[] | undefined,\n>(config: Config, pluginContext: PluginContext, userPlugins?: P) {\n  const handlers: PluginCleanup[] = [];\n  const apis: Apis<P> = {};\n\n  const keys = new Set<\n    PluginKey | (P extends undefined ? never : InferredPluginKey<P>)\n  >();\n\n  // Register event handlers declared on the plugin\n  const registerPluginEvents = (plugin: Plugin) =>\n    Effect.gen(function* () {\n      const withEvents = plugin as { events?: readonly AnyEventDefinition[] };\n\n      if (withEvents.events && withEvents.events.length > 0) {\n        yield* Effect.logTrace(\n          `Registering ${withEvents.events.length} events for plugin '${plugin.name}'`\n        ).pipe(\n          Effect.annotateLogs({\n            plugin: plugin.name,\n            eventCount: withEvents.events.length,\n          })\n        );\n\n        for (const eventDef of withEvents.events) {\n          dynamicRegistry.registerDefinition(eventDef);\n        }\n      }\n    });\n\n  // Helpers to keep processSetupResult complexity low\n  const registerExposeKey = (expose: PluginExpose<string, unknown>) =>\n    Effect.gen(function* () {\n      if (expose.key && isPluginKey(expose.key)) {\n        keys.add(expose.key);\n\n        yield* Effect.logTrace(`Plugin '${expose.key}' registered`).pipe(\n          Effect.annotateLogs({ expose })\n        );\n      }\n    });\n\n  const registerExposeCleanup = (expose: PluginExpose<string, unknown>) =>\n    Effect.gen(function* () {\n      if (typeof expose.cleanup === \"function\") {\n        handlers.push(expose.cleanup);\n\n        yield* Effect.logTrace(\n          `Plugin '${expose.key}' registered expose cleanup`\n        ).pipe(Effect.annotateLogs({ expose }));\n      }\n    });\n\n  const registerExposeApi = (expose: PluginExpose<string, unknown>) =>\n    Effect.gen(function* () {\n      if (expose.api && expose.key) {\n        (apis as Record<string, unknown>)[expose.key] = expose.api;\n\n        yield* Effect.logTrace(`Plugin '${expose.key}' exposed API`).pipe(\n          Effect.annotateLogs({ key: expose.key, api: expose.api })\n        );\n      }\n    });\n\n  const processSetupResult = (\n    result: PluginExpose<string, unknown> | (() => void) | undefined\n  ) =>\n    Effect.gen(function* () {\n      if (!result) {\n        yield* Effect.logTrace(\"Plugin returned no expose (skipped)\");\n        return;\n      }\n\n      if (typeof result === \"function\") {\n        handlers.push(result);\n\n        yield* Effect.logTrace(\n          `Registered cleanup handler - ${handlers.length} total`\n        ).pipe(Effect.annotateLogs({ result }));\n\n        return;\n      }\n\n      yield* registerExposeKey(result);\n      yield* registerExposeCleanup(result);\n      yield* registerExposeApi(result);\n    });\n\n  const setupPlugin = (plugin: Plugin) =>\n    Effect.gen(function* () {\n      try {\n        yield* Effect.logTrace(`Setting up plugin '${plugin.name}'`).pipe(\n          Effect.annotateLogs({ plugin: plugin.name })\n        );\n\n        yield* registerPluginEvents(plugin);\n\n        const result = yield* withSpan(\n          \"plugin.setup\",\n          Effect.promise(() => Promise.resolve(plugin.setup(pluginContext))),\n          { attributes: { pluginName: plugin.name } }\n        );\n\n        yield* processSetupResult(result);\n\n        yield* Effect.logTrace(`Plugin '${plugin.name}' setup complete`).pipe(\n          Effect.annotateLogs({ plugin: plugin.name })\n        );\n      } catch (error) {\n        yield* Effect.logError(\"Failed to setup plugin\").pipe(\n          Effect.annotateLogs({\n            plugin: plugin.name,\n            error: error instanceof Error ? error.message : String(error),\n          })\n        );\n      }\n    });\n\n  // Helper to load a plugin module - all plugins export Plugin objects directly\n  // TODO: Replace with a dynamic import\n  const loadPluginModule = (key: PluginKey): Promise<{ default: Plugin }> => {\n    switch (key) {\n      case \"errors\":\n        return import(\"./impl/errors.js\");\n      case \"replay\":\n        return import(\"./impl/replay.js\");\n      case \"rageClick\":\n        return import(\"./impl/rage-click.js\");\n      case \"aiSummary\":\n        return import(\"./impl/ai-summary.js\");\n      case \"pageEvents\":\n        return import(\"./impl/page-events.js\");\n      case \"serverTracing\":\n        return import(\"./impl/server-tracing.js\");\n      default:\n        return Promise.reject(new Error(`Unknown plugin key: ${key}`));\n    }\n  };\n\n  // Check if a value is a valid plugin key\n  const isPluginKey = (key: unknown): key is PluginKey =>\n    typeof key === \"string\" && PLUGIN_MANIFEST.some(({ name }) => name === key);\n\n  const createLoadPluginEffect = (key: PluginKey) =>\n    Effect.gen(function* () {\n      try {\n        yield* Effect.logTrace(\"Importing plugin module\").pipe(\n          Effect.annotateLogs({ key })\n        );\n\n        const mod = yield* Effect.promise(() => loadPluginModule(key));\n\n        yield* Effect.logTrace(\"Imported plugin module\").pipe(\n          Effect.annotateLogs({ key })\n        );\n\n        const plugin = mod.default;\n\n        if (plugin && typeof plugin === \"object\") {\n          yield* setupPlugin(plugin);\n        } else {\n          yield* Effect.logError(\"Plugin missing default export\").pipe(\n            Effect.annotateLogs({ key })\n          );\n        }\n      } catch (error) {\n        yield* Effect.logError(\"Failed to import plugin\").pipe(\n          Effect.annotateLogs({ key, error: String(error) })\n        );\n      }\n    });\n\n  // Load built-in plugins based on config\n  const loadBuiltinPlugins = Effect.gen(function* () {\n    const loadPromises: Effect.Effect<void, never, never>[] = [];\n\n    const entries = Object.entries(config.features);\n    const enabled = entries.filter(([_, v]) => v).map(([k]) => k);\n    const disabled = entries.filter(([_, v]) => !v).map(([k]) => k);\n\n    yield* Effect.logDebug(\n      `Loading ${enabled.length} plugins (${disabled.length ?? \"Nothing\"} disabled)`\n    ).pipe(Effect.annotateLogs({ total: entries.length, enabled, disabled }));\n\n    for (const [key, value] of entries) {\n      if (!value) {\n        yield* Effect.logTrace(`Plugin '${key}' disabled`).pipe(\n          Effect.annotateLogs({ key })\n        );\n\n        continue;\n      }\n\n      if (!isPluginKey(key)) {\n        yield* Effect.logError(\"Invalid plugin key\", {\n          key,\n        });\n\n        continue;\n      }\n\n      const loadPlugin = createLoadPluginEffect(key);\n\n      loadPromises.push(loadPlugin);\n    }\n\n    // Run all plugin loads in parallel\n    yield* Effect.all(loadPromises, { concurrency: \"unbounded\" });\n  });\n\n  // Load user-provided plugins\n  const loadUserPlugins = Effect.gen(function* () {\n    if (userPlugins) {\n      const setupPromises = userPlugins.map((plugin) => setupPlugin(plugin));\n      yield* Effect.all(setupPromises, { concurrency: \"unbounded\" });\n    }\n  });\n\n  const warnIfNoPluginsLoaded = Effect.gen(function* () {\n    if (Object.keys(apis).length === 0) {\n      yield* Effect.logWarning(\n        \"No plugins were loaded. Check your config.features to enable plugins.\"\n      );\n    }\n  });\n\n  // Run everything: load first (in parallel), then warn if nothing loaded\n  return Effect.gen(function* () {\n    yield* Effect.logTrace(\"Starting plugin loading process\").pipe(\n      Effect.annotateLogs({ config })\n    );\n\n    yield* Effect.all([loadBuiltinPlugins, loadUserPlugins], {\n      concurrency: \"unbounded\",\n    });\n\n    yield* warnIfNoPluginsLoaded;\n\n    return {\n      cleanups: handlers,\n      apis: Object.freeze({ ...apis }),\n      keys: keys as Set<\n        PluginKey | (P extends undefined ? never : InferredPluginKey<P>)\n      >,\n    };\n  });\n}\n"],"mappings":"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"}

package/dist/core/runtime/config.d.mts

@@ -0,0 +1,14 @@
+import { Config } from "@interfere/types/sdk/config";
+import { Runtime } from "@interfere/types/sdk/runtime";
+
+//#region src/core/runtime/config.d.ts
+declare function getRuntime(): Runtime;
+declare function initConfig(input: unknown): void;
+declare function getConfig(): Config;
+interface IngestTarget {
+  url: string;
+  headers: Headers;
+}
+declare function resolveIngestTarget(): IngestTarget;
+//#endregion
+export { IngestTarget, getConfig, getRuntime, initConfig, resolveIngestTarget };

package/dist/core/runtime/config.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.mts","names":[],"sources":["../../../src/core/runtime/config.ts"],"sourcesContent":[],"mappings":";;;;iBAKgB,UAAA,CAAA,GAAc;iBAkBd,UAAA;AAlBA,iBAwBA,SAAA,CAAA,CAxBc,EAwBD,MAxBQ;AAkBrB,UAcC,YAAA,CAdS;EAMV,GAAA,EAAA,MAAA;EAQC,OAAA,EAEN,OAFkB;AAK7B;iBAAgB,mBAAA,CAAA,GAAuB"}

package/dist/core/runtime/config.mjs

@@ -0,0 +1,39 @@
+import { configSchema } from "@interfere/types/sdk/config";
+
+//#region src/core/runtime/config.ts
+let currentConfig;
+function getRuntime() {
+	if (typeof window !== "undefined") return "browser";
+	try {
+		if (process.env.NEXT_RUNTIME === "edge") return "edge";
+		return "node";
+	} catch (error) {
+		console.error("Error getting runtime: ", error);
+		return null;
+	}
+}
+function initConfig(input) {
+	currentConfig = {
+		...configSchema.parse(input),
+		runtime: getRuntime()
+	};
+}
+function getConfig() {
+	if (!currentConfig) throw new Error("Config not initialized");
+	return currentConfig;
+}
+function resolveIngestTarget() {
+	const cfg = getConfig();
+	if ("proxyUrl" in cfg) return {
+		url: cfg.proxyUrl,
+		headers: new Headers([["Content-Type", "application/json"]])
+	};
+	if ("ingestUrl" in cfg && "surfaceToken" in cfg) return {
+		url: cfg.ingestUrl,
+		headers: new Headers([["Content-Type", "application/json"], ["x-interfere-surface", cfg.surfaceToken]])
+	};
+	throw new Error("Invalid SDK config: must provide proxyUrl or (ingestUrl + surfaceToken)");
+}
+
+//#endregion
+export { getConfig, getRuntime, initConfig, resolveIngestTarget };

package/dist/core/runtime/config.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.mjs","names":["currentConfig: (Config & { runtime: Runtime }) | undefined"],"sources":["../../../src/core/runtime/config.ts"],"sourcesContent":["import { type Config, configSchema } from \"@interfere/types/sdk/config\";\nimport type { Runtime } from \"@interfere/types/sdk/runtime\";\n\nlet currentConfig: (Config & { runtime: Runtime }) | undefined;\n\nexport function getRuntime(): Runtime {\n  if (typeof window !== \"undefined\") {\n    return \"browser\";\n  }\n\n  try {\n    if (process.env.NEXT_RUNTIME === \"edge\") {\n      return \"edge\";\n    }\n\n    return \"node\";\n  } catch (error) {\n    console.error(\"Error getting runtime: \", error);\n\n    return null;\n  }\n}\n\nexport function initConfig(input: unknown) {\n  const parsed = configSchema.parse(input);\n\n  currentConfig = { ...parsed, runtime: getRuntime() };\n}\n\nexport function getConfig(): Config {\n  if (!currentConfig) {\n    throw new Error(\"Config not initialized\");\n  }\n\n  return currentConfig;\n}\n\nexport interface IngestTarget {\n  url: string;\n  headers: Headers;\n}\n\nexport function resolveIngestTarget(): IngestTarget {\n  const cfg = getConfig();\n\n  if (\"proxyUrl\" in cfg) {\n    return {\n      url: cfg.proxyUrl,\n      headers: new Headers([[\"Content-Type\", \"application/json\"]]),\n    };\n  }\n\n  if (\"ingestUrl\" in cfg && \"surfaceToken\" in cfg) {\n    return {\n      url: cfg.ingestUrl,\n      headers: new Headers([\n        [\"Content-Type\", \"application/json\"],\n        [\"x-interfere-surface\", cfg.surfaceToken],\n      ]),\n    };\n  }\n\n  throw new Error(\n    \"Invalid SDK config: must provide proxyUrl or (ingestUrl + surfaceToken)\"\n  );\n}\n"],"mappings":";;;AAGA,IAAIA;AAEJ,SAAgB,aAAsB;AACpC,KAAI,OAAO,WAAW,YACpB,QAAO;AAGT,KAAI;AACF,MAAI,QAAQ,IAAI,iBAAiB,OAC/B,QAAO;AAGT,SAAO;UACA,OAAO;AACd,UAAQ,MAAM,2BAA2B,MAAM;AAE/C,SAAO;;;AAIX,SAAgB,WAAW,OAAgB;AAGzC,iBAAgB;EAAE,GAFH,aAAa,MAAM,MAAM;EAEX,SAAS,YAAY;EAAE;;AAGtD,SAAgB,YAAoB;AAClC,KAAI,CAAC,cACH,OAAM,IAAI,MAAM,yBAAyB;AAG3C,QAAO;;AAQT,SAAgB,sBAAoC;CAClD,MAAM,MAAM,WAAW;AAEvB,KAAI,cAAc,IAChB,QAAO;EACL,KAAK,IAAI;EACT,SAAS,IAAI,QAAQ,CAAC,CAAC,gBAAgB,mBAAmB,CAAC,CAAC;EAC7D;AAGH,KAAI,eAAe,OAAO,kBAAkB,IAC1C,QAAO;EACL,KAAK,IAAI;EACT,SAAS,IAAI,QAAQ,CACnB,CAAC,gBAAgB,mBAAmB,EACpC,CAAC,uBAAuB,IAAI,aAAa,CAC1C,CAAC;EACH;AAGH,OAAM,IAAI,MACR,0EACD"}

package/dist/core/runtime/context.d.mts

@@ -0,0 +1,25 @@
+import { Effect } from "effect";
+import { IResult } from "@ua-parser-js/pro-enterprise";
+
+//#region src/core/runtime/context.d.ts
+interface ScreenProperties {
+  viewport: {
+    viewport_width: number;
+    viewport_height: number;
+  };
+  screen: {
+    screen_height: number;
+    screen_width: number;
+  };
+}
+interface CaptureSourceProperties {
+  sdk: {
+    name: string;
+    version: string;
+    language: string;
+  };
+}
+type ContextProperties = ScreenProperties & CaptureSourceProperties & IResult & Record<string, unknown>;
+declare function getContextProperties(): Effect.Effect<ContextProperties>;
+//#endregion
+export { ContextProperties, getContextProperties };

package/dist/core/runtime/context.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.mts","names":[],"sources":["../../../src/core/runtime/context.ts"],"sourcesContent":[],"mappings":";;;;UAKU,gBAAA;;IAAA,cAAA,EAAgB,MAAA;IAWhB,eAAA,EAAA,MAAuB;EAQrB,CAAA;EAAoB,MAAA,EAAA;IAC9B,aAAA,EAAA,MAAA;IACA,YAAA,EAAA,MAAA;EACA,CAAA;;AAEF,UAbU,uBAAA,CAa0B;;;;;;;KALxB,iBAAA,GAAoB,mBAC9B,0BACA,UACA;iBAEc,oBAAA,CAAA,GAAwB,MAAA,CAAO,OAAO"}