@interfere/react 0.0.1 → 0.0.2-alpha.0

package/dist/client.d.mts

@@ -0,0 +1,15 @@
+import { SessionServiceTag } from "./effect/layers/session.layer.mjs";
+import { ConfigTag } from "./effect/tags.mjs";
+import { EventPayload } from "./core/events/event-registry.mjs";
+import { ValidationError } from "./effect/errors.mjs";
+import { ContextServiceTag } from "./effect/layers/context.layer.mjs";
+import { QueueServiceTag } from "./effect/layers/queue.layer.mjs";
+import { Effect } from "effect";
+import { EventType } from "@interfere/types/sdk/plugins/lib/types";
+
+//#region src/client.d.ts
+type CaptureFn = <T extends EventType>(type: T, payload: EventPayload<T>) => void;
+declare function captureEffect<T extends EventType>(type: T, payload: EventPayload<T>): Effect.Effect<void, ValidationError, QueueServiceTag | SessionServiceTag | ConfigTag | ContextServiceTag>;
+declare const capture: CaptureFn;
+//#endregion
+export { CaptureFn, capture, captureEffect };

package/dist/client.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.mts","names":[],"sources":["../src/client.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;KAaY,SAAA,cAAuB,iBAC3B,YACG,aAAa;iBA0BR,wBAAwB,iBAChC,YACG,aAAa,KAAE,MAAA,CAAA,aAAA,iBAAA,kBAAA,iBAAA,GAAA,SAAA,GAAA;cAqFb,SAAS"}

package/dist/client.mjs

@@ -0,0 +1,75 @@
+import { dynamicRegistry } from "./core/events/event-registry.mjs";
+import { buildEnvelopeEffect } from "./effect/build-envelope.mjs";
+import { ValidationError } from "./effect/errors.mjs";
+import { ContextServiceTag } from "./effect/layers/context.layer.mjs";
+import { QueueServiceTag } from "./effect/layers/queue.layer.mjs";
+import { withSpan } from "./effect/layers/tracer.layer.mjs";
+import { forkWithSDK } from "./effect/runtime-services.mjs";
+import { Effect } from "effect";
+
+//#region src/client.ts
+function enrichPayload(basePayload, properties) {
+	if (typeof basePayload === "object" && basePayload !== null) {
+		const merged = {
+			...basePayload.properties ?? {},
+			...properties
+		};
+		return {
+			...basePayload,
+			properties: merged
+		};
+	}
+	return { properties };
+}
+function captureEffect(type, payload) {
+	const handler = dynamicRegistry.get(type);
+	if (!handler) return Effect.gen(function* () {
+		const queue = yield* QueueServiceTag;
+		const env = yield* buildEnvelopeEffect({
+			type,
+			payload
+		});
+		yield* queue.add(env);
+		yield* Effect.logTrace("Captured event with no handler", {
+			type,
+			envelopeId: env.uuid,
+			path: "fast"
+		});
+	}).pipe(Effect.withSpan("capture.fast", { attributes: { type } }));
+	return Effect.gen(function* () {
+		const queue = yield* QueueServiceTag;
+		const context = yield* ContextServiceTag;
+		const validated = yield* withSpan("capture.validate", Effect.sync(() => handler ? handler.schema.safeParse(payload) : {
+			success: false,
+			error: { issues: [{ message: "Missing handler" }] }
+		}).pipe(Effect.flatMap((result) => result.success === true ? Effect.succeed(result.data) : Effect.fail(new ValidationError({
+			message: "Invalid payload",
+			payload,
+			issues: result.error?.issues
+		})))), { attributes: { type } });
+		const transformed = handler && "transform" in handler && typeof handler.transform === "function" ? handler.transform(validated) : validated;
+		const env = yield* buildEnvelopeEffect({
+			type,
+			payload: handler?.enrich === true ? yield* withSpan("capture.enrich", context.getOnce().pipe(Effect.map((properties) => enrichPayload(transformed, properties))), { attributes: { type } }) : transformed
+		});
+		yield* queue.add(env);
+		yield* Effect.logTrace("Captured event with handler", {
+			type,
+			envelopeId: env.uuid
+		});
+	}).pipe(Effect.withSpan("capture.full", { attributes: { type } }));
+}
+const capture = (type, payload) => {
+	if (typeof window === "undefined") return;
+	forkWithSDK(captureEffect(type, payload).pipe(Effect.catchTag("ValidationError", (err) => Effect.logError("Invalid event payload", {
+		type,
+		payload,
+		issues: err.issues
+	})), Effect.catchAll((err) => Effect.logError("Failed to capture event", {
+		type,
+		error: String(err)
+	}))));
+};
+
+//#endregion
+export { capture, captureEffect };

package/dist/client.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.mjs","names":["capture: CaptureFn"],"sources":["../src/client.ts"],"sourcesContent":["import type { EventType } from \"@interfere/types/sdk/plugins/lib/types\";\nimport { Effect } from \"effect\";\nimport {\n  dynamicRegistry,\n  type EventPayload,\n} from \"./core/events/event-registry.js\";\nimport { buildEnvelopeEffect } from \"./effect/build-envelope.js\";\nimport { ValidationError } from \"./effect/errors.js\";\nimport { ContextServiceTag } from \"./effect/layers/context.layer.js\";\nimport { QueueServiceTag } from \"./effect/layers/queue.layer.js\";\nimport { withSpan } from \"./effect/layers/tracer.layer.js\";\nimport { forkWithSDK } from \"./effect/runtime-services.js\";\n\nexport type CaptureFn = <T extends EventType>(\n  type: T,\n  payload: EventPayload<T>\n) => void;\n\ntype EnrichedPayload<T> =\n  T extends Record<string, unknown>\n    ? T & { properties?: Record<string, unknown> }\n    : { properties: Record<string, unknown> };\n\nfunction enrichPayload<T>(\n  basePayload: T,\n  properties: Record<string, unknown>\n): EnrichedPayload<T> {\n  if (typeof basePayload === \"object\" && basePayload !== null) {\n    const existing = (basePayload as EnrichedPayload<T>).properties;\n\n    const merged = { ...(existing ?? {}), ...properties };\n\n    return {\n      ...basePayload,\n      properties: merged,\n    } as EnrichedPayload<T>;\n  }\n\n  return { properties } as EnrichedPayload<T>;\n}\n\nexport function captureEffect<T extends EventType>(\n  type: T,\n  payload: EventPayload<T>\n) {\n  const handler = dynamicRegistry.get(type);\n\n  if (!handler) {\n    return Effect.gen(function* () {\n      const queue = yield* QueueServiceTag;\n      const env = yield* buildEnvelopeEffect({ type, payload });\n\n      yield* queue.add(env);\n\n      yield* Effect.logTrace(\"Captured event with no handler\", {\n        type,\n        envelopeId: env.uuid,\n        path: \"fast\",\n      });\n    }).pipe(Effect.withSpan(\"capture.fast\", { attributes: { type } }));\n  }\n\n  return Effect.gen(function* () {\n    const queue = yield* QueueServiceTag;\n    const context = yield* ContextServiceTag;\n\n    const validated = yield* withSpan(\n      \"capture.validate\",\n      Effect.sync(() =>\n        handler\n          ? handler.schema.safeParse(payload)\n          : {\n              success: false,\n              error: { issues: [{ message: \"Missing handler\" }] },\n            }\n      ).pipe(\n        Effect.flatMap((result) =>\n          result.success === true\n            ? Effect.succeed((result as { data: unknown }).data)\n            : Effect.fail(\n                new ValidationError({\n                  message: \"Invalid payload\",\n                  payload,\n                  issues: (result as { error?: { issues?: unknown } }).error\n                    ?.issues,\n                })\n              )\n        )\n      ),\n      { attributes: { type } }\n    );\n\n    const transformed =\n      handler &&\n      \"transform\" in handler &&\n      typeof handler.transform === \"function\"\n        ? (handler.transform as (input: unknown) => unknown)(validated)\n        : validated;\n\n    const finalPayload =\n      handler?.enrich === true\n        ? yield* withSpan(\n            \"capture.enrich\",\n            context\n              .getOnce()\n              .pipe(\n                Effect.map((properties) =>\n                  enrichPayload(transformed, properties)\n                )\n              ),\n            { attributes: { type } }\n          )\n        : transformed;\n\n    const env = yield* buildEnvelopeEffect({\n      type,\n      payload: finalPayload as EventPayload<T>,\n    });\n\n    yield* queue.add(env);\n\n    yield* Effect.logTrace(\"Captured event with handler\", {\n      type,\n      envelopeId: env.uuid,\n    });\n  }).pipe(Effect.withSpan(\"capture.full\", { attributes: { type } }));\n}\n\nexport const capture: CaptureFn = <T extends EventType>(\n  type: T,\n  payload: EventPayload<T>\n) => {\n  if (typeof window === \"undefined\") {\n    return;\n  }\n\n  forkWithSDK(\n    captureEffect(type, payload).pipe(\n      Effect.catchTag(\"ValidationError\", (err) =>\n        Effect.logError(\"Invalid event payload\", {\n          type,\n          payload,\n          issues: err.issues,\n        })\n      ),\n      Effect.catchAll((err) =>\n        Effect.logError(\"Failed to capture event\", {\n          type,\n          error: String(err),\n        })\n      )\n    )\n  );\n};\n"],"mappings":";;;;;;;;;;AAuBA,SAAS,cACP,aACA,YACoB;AACpB,KAAI,OAAO,gBAAgB,YAAY,gBAAgB,MAAM;EAG3D,MAAM,SAAS;GAAE,GAFC,YAAmC,cAEpB,EAAE;GAAG,GAAG;GAAY;AAErD,SAAO;GACL,GAAG;GACH,YAAY;GACb;;AAGH,QAAO,EAAE,YAAY;;AAGvB,SAAgB,cACd,MACA,SACA;CACA,MAAM,UAAU,gBAAgB,IAAI,KAAK;AAEzC,KAAI,CAAC,QACH,QAAO,OAAO,IAAI,aAAa;EAC7B,MAAM,QAAQ,OAAO;EACrB,MAAM,MAAM,OAAO,oBAAoB;GAAE;GAAM;GAAS,CAAC;AAEzD,SAAO,MAAM,IAAI,IAAI;AAErB,SAAO,OAAO,SAAS,kCAAkC;GACvD;GACA,YAAY,IAAI;GAChB,MAAM;GACP,CAAC;GACF,CAAC,KAAK,OAAO,SAAS,gBAAgB,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC,CAAC;AAGpE,QAAO,OAAO,IAAI,aAAa;EAC7B,MAAM,QAAQ,OAAO;EACrB,MAAM,UAAU,OAAO;EAEvB,MAAM,YAAY,OAAO,SACvB,oBACA,OAAO,WACL,UACI,QAAQ,OAAO,UAAU,QAAQ,GACjC;GACE,SAAS;GACT,OAAO,EAAE,QAAQ,CAAC,EAAE,SAAS,mBAAmB,CAAC,EAAE;GACpD,CACN,CAAC,KACA,OAAO,SAAS,WACd,OAAO,YAAY,OACf,OAAO,QAAS,OAA6B,KAAK,GAClD,OAAO,KACL,IAAI,gBAAgB;GAClB,SAAS;GACT;GACA,QAAS,OAA4C,OACjD;GACL,CAAC,CACH,CACN,CACF,EACD,EAAE,YAAY,EAAE,MAAM,EAAE,CACzB;EAED,MAAM,cACJ,WACA,eAAe,WACf,OAAO,QAAQ,cAAc,aACxB,QAAQ,UAA0C,UAAU,GAC7D;EAiBN,MAAM,MAAM,OAAO,oBAAoB;GACrC;GACA,SAhBA,SAAS,WAAW,OAChB,OAAO,SACL,kBACA,QACG,SAAS,CACT,KACC,OAAO,KAAK,eACV,cAAc,aAAa,WAAW,CACvC,CACF,EACH,EAAE,YAAY,EAAE,MAAM,EAAE,CACzB,GACD;GAKL,CAAC;AAEF,SAAO,MAAM,IAAI,IAAI;AAErB,SAAO,OAAO,SAAS,+BAA+B;GACpD;GACA,YAAY,IAAI;GACjB,CAAC;GACF,CAAC,KAAK,OAAO,SAAS,gBAAgB,EAAE,YAAY,EAAE,MAAM,EAAE,CAAC,CAAC;;AAGpE,MAAaA,WACX,MACA,YACG;AACH,KAAI,OAAO,WAAW,YACpB;AAGF,aACE,cAAc,MAAM,QAAQ,CAAC,KAC3B,OAAO,SAAS,oBAAoB,QAClC,OAAO,SAAS,yBAAyB;EACvC;EACA;EACA,QAAQ,IAAI;EACb,CAAC,CACH,EACD,OAAO,UAAU,QACf,OAAO,SAAS,2BAA2B;EACzC;EACA,OAAO,OAAO,IAAI;EACnB,CAAC,CACH,CACF,CACF"}

package/dist/core/events/event-registry.d.mts

@@ -0,0 +1,23 @@
+import { AnyEventDefinition, EventHandlerConfig, EventSchemas } from "./plugin-event-types.mjs";
+import { EventType } from "@interfere/types/sdk/plugins/lib/types";
+import { z } from "zod";
+
+//#region src/core/events/event-registry.d.ts
+type EventHandlerFor<T extends EventType> = T extends keyof EventSchemas ? EventHandlerConfig<EventSchemas[T]> : never;
+type EventPayload<T extends EventType> = T extends keyof EventSchemas ? z.infer<EventSchemas[T]> : never;
+declare function getEventHandler<T extends EventType>(type: T): EventHandlerFor<T> | undefined;
+declare function hasEventHandler(type: EventType): type is keyof EventSchemas;
+type PluginEventHandler<T extends EventType = EventType> = {
+  eventType: T;
+  handler: EventHandlerFor<T>;
+};
+declare class DynamicEventRegistry {
+  private readonly dynamicHandlers;
+  register<T extends EventType>(eventType: T, handler: EventHandlerFor<T>): void;
+  registerDefinition(def: AnyEventDefinition): void;
+  get<T extends EventType>(eventType: T): EventHandlerFor<T> | undefined;
+  merge(handlers: PluginEventHandler[]): void;
+}
+declare const dynamicRegistry: DynamicEventRegistry;
+//#endregion
+export { DynamicEventRegistry, EventHandlerFor, EventPayload, PluginEventHandler, dynamicRegistry, getEventHandler, hasEventHandler };

package/dist/core/events/event-registry.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-registry.d.mts","names":[],"sources":["../../../src/core/events/event-registry.ts"],"sourcesContent":[],"mappings":";;;;;KAUY,0BAA0B,aAAa,gBAAgB,eAC/D,mBAAmB,aAAa;KAIxB,uBAAuB,aAAa,gBAAgB,eAC5D,CAAA,CAAE,MAAM,aAAa;AANb,iBAUI,eAVW,CAAA,UAUe,SAVf,CAAA,CAAA,IAAA,EAWnB,CAXmB,CAAA,EAYxB,eAZwB,CAYR,CAZQ,CAAA,GAAA,SAAA;AAAW,iBAkBtB,eAAA,CAlBsB,IAAA,EAkBA,SAlBA,CAAA,EAAA,IAAA,IAAA,MAkB0B,YAlB1B;AAAa,KAuBvC,kBAvBuC,CAAA,UAuBV,SAvBU,GAuBE,SAvBF,CAAA,GAAA;EAAgB,SAAA,EAwBtD,CAxBsD;EAC5C,OAAA,EAwBZ,eAxBY,CAwBI,CAxBJ,CAAA;CAAa;AAAhC,cA4BS,oBAAA,CA5BT;EAAkB,iBAAA,eAAA;EAIV,QAAA,CAAA,UA8BS,SA9BG,CAAA,CAAA,SAAA,EA+BT,CA/BS,EAAA,OAAA,EAgCX,eAhCW,CAgCK,CAhCL,CAAA,CAAA,EAAA,IAAA;EAAW,kBAAA,CAAA,GAAA,EAwCT,kBAxCS,CAAA,EAAA,IAAA;EAAa,GAAA,CAAA,UAgDhC,SAhDgC,CAAA,CAAA,SAAA,EAgDV,CAhDU,CAAA,EAgDN,eAhDM,CAgDU,CAhDV,CAAA,GAAA,SAAA;EAAgB,KAAA,CAAA,QAAA,EAuD9C,kBAvD8C,EAAA,CAAA,EAAA,IAAA;;AACvC,cA8DZ,eA9DY,EA8DG,oBA9DH"}

package/dist/core/events/event-registry.mjs

@@ -0,0 +1,32 @@
+import { eventSchemas } from "./plugin-event-types.mjs";
+
+//#region src/core/events/event-registry.ts
+function getEventHandler(type) {
+	return dynamicRegistry.get(type);
+}
+function hasEventHandler(type) {
+	return type in eventSchemas;
+}
+var DynamicEventRegistry = class {
+	dynamicHandlers = /* @__PURE__ */ new Map();
+	register(eventType, handler) {
+		this.dynamicHandlers.set(eventType, handler);
+	}
+	registerDefinition(def) {
+		this.dynamicHandlers.set(def.type, {
+			schema: def.schema,
+			enrich: def.enrich,
+			transform: def.transform
+		});
+	}
+	get(eventType) {
+		return this.dynamicHandlers.get(eventType);
+	}
+	merge(handlers) {
+		for (const { eventType, handler } of handlers) this.register(eventType, handler);
+	}
+};
+const dynamicRegistry = new DynamicEventRegistry();
+
+//#endregion
+export { DynamicEventRegistry, dynamicRegistry, getEventHandler, hasEventHandler };

package/dist/core/events/event-registry.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-registry.mjs","names":[],"sources":["../../../src/core/events/event-registry.ts"],"sourcesContent":["import type { EventType } from \"@interfere/types/sdk/plugins/lib/types\";\nimport type { z } from \"zod\";\nimport {\n  type AnyEventDefinition,\n  type EventHandlerConfig,\n  type EventSchemas,\n  eventSchemas,\n} from \"./plugin-event-types.js\";\n\n// Type to get the handler for a specific event type\nexport type EventHandlerFor<T extends EventType> = T extends keyof EventSchemas\n  ? EventHandlerConfig<EventSchemas[T]>\n  : never;\n\n// Type to get the schema input type for an event\nexport type EventPayload<T extends EventType> = T extends keyof EventSchemas\n  ? z.infer<EventSchemas[T]>\n  : never;\n\n// Runtime helper to get handler with full type information\nexport function getEventHandler<T extends EventType>(\n  type: T\n): EventHandlerFor<T> | undefined {\n  // All events are now plugin-registered\n  return dynamicRegistry.get(type);\n}\n\n// Type guard to check if an event type has a handler\nexport function hasEventHandler(type: EventType): type is keyof EventSchemas {\n  return type in eventSchemas;\n}\n\n// Plugin registration system for dynamic event handlers\nexport type PluginEventHandler<T extends EventType = EventType> = {\n  eventType: T;\n  handler: EventHandlerFor<T>;\n};\n\n// Advanced type for plugin-provided event handlers\nexport class DynamicEventRegistry {\n  private readonly dynamicHandlers = new Map<\n    EventType,\n    EventHandlerConfig<z.ZodType>\n  >();\n\n  register<T extends EventType>(\n    eventType: T,\n    handler: EventHandlerFor<T>\n  ): void {\n    this.dynamicHandlers.set(\n      eventType,\n      handler as EventHandlerConfig<z.ZodType>\n    );\n  }\n\n  registerDefinition(def: AnyEventDefinition): void {\n    this.dynamicHandlers.set(def.type, {\n      schema: def.schema,\n      enrich: def.enrich,\n      transform: def.transform,\n    } as EventHandlerConfig<z.ZodType>);\n  }\n\n  get<T extends EventType>(eventType: T): EventHandlerFor<T> | undefined {\n    // Only check dynamic handlers since all events are plugin-registered\n    return this.dynamicHandlers.get(eventType) as\n      | EventHandlerFor<T>\n      | undefined;\n  }\n\n  merge(handlers: PluginEventHandler[]): void {\n    for (const { eventType, handler } of handlers) {\n      this.register(eventType, handler);\n    }\n  }\n}\n\n// Export a singleton instance for the dynamic registry\nexport const dynamicRegistry = new DynamicEventRegistry();\n"],"mappings":";;;AAoBA,SAAgB,gBACd,MACgC;AAEhC,QAAO,gBAAgB,IAAI,KAAK;;AAIlC,SAAgB,gBAAgB,MAA6C;AAC3E,QAAO,QAAQ;;AAUjB,IAAa,uBAAb,MAAkC;CAChC,AAAiB,kCAAkB,IAAI,KAGpC;CAEH,SACE,WACA,SACM;AACN,OAAK,gBAAgB,IACnB,WACA,QACD;;CAGH,mBAAmB,KAA+B;AAChD,OAAK,gBAAgB,IAAI,IAAI,MAAM;GACjC,QAAQ,IAAI;GACZ,QAAQ,IAAI;GACZ,WAAW,IAAI;GAChB,CAAkC;;CAGrC,IAAyB,WAA8C;AAErE,SAAO,KAAK,gBAAgB,IAAI,UAAU;;CAK5C,MAAM,UAAsC;AAC1C,OAAK,MAAM,EAAE,WAAW,aAAa,SACnC,MAAK,SAAS,WAAW,QAAQ;;;AAMvC,MAAa,kBAAkB,IAAI,sBAAsB"}

package/dist/core/events/plugin-event-types.d.mts

@@ -0,0 +1,92 @@
+import { PluginManifest } from "@interfere/types/sdk/plugins/manifest";
+import { EventType, PluginKey } from "@interfere/types/sdk/plugins/lib/types";
+import { z } from "zod";
+
+//#region src/core/events/plugin-event-types.d.ts
+type PluginRegistrationInManifest = PluginManifest[number];
+type EventsForPlugin<K$1 extends PluginKey> = Extract<PluginRegistrationInManifest, {
+  name: K$1;
+}>["events"][number]["name"];
+declare const eventSchemas: {
+  readonly error: 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>;
+    }, 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>;
+  readonly rage_click: z.ZodObject<{
+    count: z.ZodNumber;
+    timeWindow: z.ZodNumber;
+    selector: z.ZodString;
+    text: z.ZodString;
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+    timestamp: z.ZodNumber;
+  }, z.core.$strip>;
+  readonly ui_event: z.ZodObject<{
+    event: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+  }, z.core.$strip>;
+  readonly replay_chunk: z.ZodObject<{
+    ts: z.ZodNumber;
+    count: z.ZodNumber;
+    events: z.ZodArray<z.ZodString>;
+  }, z.core.$strip>;
+  readonly session_summary: z.ZodObject<{
+    summary: z.ZodString;
+    pageTitle: z.ZodString;
+    pageUrl: z.ZodURL;
+    contentLength: z.ZodNumber;
+    timestamp: z.ZodNumber;
+  }, z.core.$strip>;
+  readonly pageview: z.ZodObject<{
+    url: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>;
+  readonly pageleave: z.ZodObject<{
+    url: z.ZodString;
+    durationMs: z.ZodOptional<z.ZodNumber>;
+  }, z.core.$strip>;
+};
+/** Per-event configuration derived from PLUGIN_MANIFEST. */
+declare const eventConfigs: Record<"error" | "replay_chunk" | "rage_click" | "session_summary" | "pageview" | "pageleave" | "ui_event", {
+  enrich: boolean;
+}>;
+type EventSchemas = typeof eventSchemas;
+type AnyEventDefinition = { [K in keyof EventSchemas]: {
+  type: K;
+  schema: EventSchemas[K];
+  enrich?: boolean;
+  transform?: (input: z.infer<EventSchemas[K]>) => unknown;
+} }[keyof EventSchemas];
+type EventDefinitionFor<T extends EventType> = T extends keyof EventSchemas ? {
+  type: T;
+  schema: EventSchemas[T];
+  enrich?: boolean;
+  transform?: (input: z.infer<EventSchemas[T]>) => unknown;
+} : never;
+type ValidatePluginEvents<K$1 extends PluginKey, Events extends readonly AnyEventDefinition[]> = Events extends readonly (infer E)[] ? E extends AnyEventDefinition ? E["type"] extends EventsForPlugin<K$1> ? Events : never : never : never;
+type EventHandlerConfig<TSchema extends z.ZodType<unknown>, TInput = z.infer<TSchema>, TOutput = TInput> = {
+  schema: TSchema;
+  enrich: boolean;
+  transform?: (input: TInput) => TOutput;
+};
+//#endregion
+export { AnyEventDefinition, EventDefinitionFor, EventHandlerConfig, EventSchemas, EventsForPlugin, ValidatePluginEvents, eventConfigs, eventSchemas };

package/dist/core/events/plugin-event-types.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-event-types.d.mts","names":[],"sources":["../../../src/core/events/plugin-event-types.ts"],"sourcesContent":[],"mappings":";;;;;KAmBK,4BAAA,GAA+B;KAExB,4BAA0B,aAAa,QACjD;EAHG,IAAA,EAIK,GAJL;AAEL,CAAA,CAAA,CAAA,QAAY,CAAA,CAAA,MAAA,CAAA,CAAA,MAAe,CAAA;AAAW,cAMzB,YANyB,EAAA;EACpC,SAAA,KAAA,aAAA,CAAA;IACQ,MAAA,YAAA,YAAA,CAAA;MAFyC,IAAA,aAAA,CAAA;QAAO,QAAA,eAAA,YAAA,CAAA;MAM7C,CAAA,eAQH,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAGG,cAAY;;;KAUb,YAAA,UAAsB;KAGtB,kBAAA,iBACE;QACJ;UACE,aAAa;;sBAED,CAAA,CAAE,MAAM,aAAa;UAErC;KAGI,6BAA6B,aACvC,gBAAgB;EAxBL,IAAA,EA0BC,CA1BD;EAUD,MAAA,EAiBI,YAjBQ,CAiBK,CAjBL,CAAA;EAGZ,MAAA,CAAA,EAAA,OAAA;EACE,SAAA,CAAA,EAAA,CAAA,KAAA,EAec,CAAA,CAAE,KAfhB,CAesB,YAftB,CAemC,CAfnC,CAAA,CAAA,EAAA,GAAA,OAAA;CACJ,GAAA,KAAA;AACE,KAkBA,oBAlBA,CAAA,YAmBA,SAnBA,EAAA,eAAA,SAoBc,kBApBd,EAAA,CAAA,GAqBR,MArBQ,SAAA,SAAA,CAAA,KAAA,EAAA,CAAA,EAAA,GAAA,CAAA,SAsBE,kBAtBF,GAuBN,CAvBM,CAAA,MAAA,CAAA,SAuBY,eAvBZ,CAuB4B,GAvB5B,CAAA,GAwBJ,MAxBI,GAAA,KAAA,GAAA,KAAA,GAAA,KAAA;AAAa,KA8Bb,kBA9Ba,CAAA,gBA+BP,CAAA,CAAE,OA/BK,CAAA,OAAA,CAAA,EAAA,SAgCd,CAAA,CAAE,KAhCY,CAgCN,OAhCM,CAAA,EAAA,UAiCb,MAjCa,CAAA,GAAA;EAEO,MAAA,EAiCtB,OAjCsB;EAAa,MAAA,EAAA,OAAA;EAAnB,SAAA,CAAA,EAAA,CAAA,KAAA,EAmCJ,MAnCI,EAAA,GAmCO,OAnCP;CAElB"}

package/dist/core/events/plugin-event-types.mjs

@@ -0,0 +1,25 @@
+import { PLUGIN_MANIFEST } from "@interfere/types/sdk/plugins/manifest";
+import { sessionSummaryPayloadSchema } from "@interfere/types/sdk/plugins/payload/ai-summary";
+import { errorEnvelopePayloadSchema } from "@interfere/types/sdk/plugins/payload/errors";
+import { pageleavePayloadSchema, pageviewPayloadSchema, uiEventPayloadSchema } from "@interfere/types/sdk/plugins/payload/page-events";
+import { rageClickPayloadSchema } from "@interfere/types/sdk/plugins/payload/rage-click";
+import { replayChunkPayloadSchema } from "@interfere/types/sdk/plugins/payload/replay";
+
+//#region src/core/events/plugin-event-types.ts
+const eventSchemas = {
+	error: errorEnvelopePayloadSchema,
+	rage_click: rageClickPayloadSchema,
+	ui_event: uiEventPayloadSchema,
+	replay_chunk: replayChunkPayloadSchema,
+	session_summary: sessionSummaryPayloadSchema,
+	pageview: pageviewPayloadSchema,
+	pageleave: pageleavePayloadSchema
+};
+/** Per-event configuration derived from PLUGIN_MANIFEST. */
+const eventConfigs = PLUGIN_MANIFEST.reduce((acc, plugin) => {
+	for (const event of plugin.events) acc[event.name] = { enrich: event.enrich };
+	return acc;
+}, {});
+
+//#endregion
+export { eventConfigs, eventSchemas };

package/dist/core/events/plugin-event-types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-event-types.mjs","names":[],"sources":["../../../src/core/events/plugin-event-types.ts"],"sourcesContent":["import type {\n  EventType,\n  PluginKey,\n} from \"@interfere/types/sdk/plugins/lib/types\";\nimport {\n  PLUGIN_MANIFEST,\n  type PluginManifest,\n} from \"@interfere/types/sdk/plugins/manifest\";\nimport { sessionSummaryPayloadSchema } from \"@interfere/types/sdk/plugins/payload/ai-summary\";\nimport { errorEnvelopePayloadSchema } from \"@interfere/types/sdk/plugins/payload/errors\";\nimport {\n  pageleavePayloadSchema,\n  pageviewPayloadSchema,\n  uiEventPayloadSchema,\n} from \"@interfere/types/sdk/plugins/payload/page-events\";\nimport { rageClickPayloadSchema } from \"@interfere/types/sdk/plugins/payload/rage-click\";\nimport { replayChunkPayloadSchema } from \"@interfere/types/sdk/plugins/payload/replay\";\nimport type { z } from \"zod\";\n\ntype PluginRegistrationInManifest = PluginManifest[number];\n\nexport type EventsForPlugin<K extends PluginKey> = Extract<\n  PluginRegistrationInManifest,\n  { name: K }\n>[\"events\"][number][\"name\"];\n\n// Define the canonical event schemas and configurations\nexport const eventSchemas = {\n  error: errorEnvelopePayloadSchema,\n  rage_click: rageClickPayloadSchema,\n  ui_event: uiEventPayloadSchema,\n  replay_chunk: replayChunkPayloadSchema,\n  session_summary: sessionSummaryPayloadSchema,\n  pageview: pageviewPayloadSchema,\n  pageleave: pageleavePayloadSchema,\n} as const;\n\n/** Per-event configuration derived from PLUGIN_MANIFEST. */\nexport const eventConfigs = PLUGIN_MANIFEST.reduce(\n  (acc, plugin) => {\n    for (const event of plugin.events) {\n      acc[event.name as EventType] = { enrich: event.enrich };\n    }\n    return acc;\n  },\n  {} as Record<EventType, { enrich: boolean }>\n);\n\nexport type EventSchemas = typeof eventSchemas;\n\n// Discriminated union for all possible event definitions\nexport type AnyEventDefinition = {\n  [K in keyof EventSchemas]: {\n    type: K;\n    schema: EventSchemas[K];\n    enrich?: boolean;\n    transform?: (input: z.infer<EventSchemas[K]>) => unknown;\n  };\n}[keyof EventSchemas];\n\n// Strongly typed event definition for a specific event type\nexport type EventDefinitionFor<T extends EventType> =\n  T extends keyof EventSchemas\n    ? {\n        type: T;\n        schema: EventSchemas[T];\n        enrich?: boolean;\n        transform?: (input: z.infer<EventSchemas[T]>) => unknown;\n      }\n    : never;\n\n// Helper to validate that an array of event definitions matches a plugin's allowed events\nexport type ValidatePluginEvents<\n  K extends PluginKey,\n  Events extends readonly AnyEventDefinition[],\n> = Events extends readonly (infer E)[]\n  ? E extends AnyEventDefinition\n    ? E[\"type\"] extends EventsForPlugin<K>\n      ? Events\n      : never\n    : never\n  : never;\n\n// Type-safe event handler configuration\nexport type EventHandlerConfig<\n  TSchema extends z.ZodType<unknown>,\n  TInput = z.infer<TSchema>,\n  TOutput = TInput,\n> = {\n  schema: TSchema;\n  enrich: boolean;\n  transform?: (input: TInput) => TOutput;\n};\n"],"mappings":";;;;;;;;AA2BA,MAAa,eAAe;CAC1B,OAAO;CACP,YAAY;CACZ,UAAU;CACV,cAAc;CACd,iBAAiB;CACjB,UAAU;CACV,WAAW;CACZ;;AAGD,MAAa,eAAe,gBAAgB,QACzC,KAAK,WAAW;AACf,MAAK,MAAM,SAAS,OAAO,OACzB,KAAI,MAAM,QAAqB,EAAE,QAAQ,MAAM,QAAQ;AAEzD,QAAO;GAET,EAAE,CACH"}

package/dist/core/plugins/dom-utils.d.mts

@@ -0,0 +1,9 @@
+//#region src/core/plugins/dom-utils.d.ts
+declare function getElementSelector(element: Element): string;
+declare function getElementText(element: HTMLElement): string | null;
+declare const DomUtils: {
+  getElementSelector: typeof getElementSelector;
+  getElementText: typeof getElementText;
+};
+//#endregion
+export { DomUtils, getElementSelector, getElementText };

package/dist/core/plugins/dom-utils.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dom-utils.d.mts","names":[],"sources":["../../../src/core/plugins/dom-utils.ts"],"sourcesContent":[],"mappings":";iBAIgB,kBAAA,UAA4B;AAA5B,iBAgBA,cAAA,CAhB4B,OAAO,EAgBX,WAhBW,CAAA,EAAA,MAAA,GAAA,IAAA;AAgBnC,cAUH,QAViB,EAAA;EAUjB,kBAGZ,EAAA,OAAA,kBAAA;yBAAA"}

package/dist/core/plugins/dom-utils.mjs

@@ -0,0 +1,25 @@
+//#region src/core/plugins/dom-utils.ts
+const CLASS_REGEX = /\s+/;
+function getElementSelector(element) {
+	const node = element;
+	if (node.id) return `#${node.id}`;
+	if (typeof node.className === "string" && node.className.trim().length > 0) {
+		const classes = node.className.trim().split(CLASS_REGEX).join(".");
+		return `${node.tagName?.toLowerCase() || "element"}.${classes}`;
+	}
+	return node.tagName?.toLowerCase() || "element";
+}
+function getElementText(element) {
+	if (element.tagName === "INPUT") {
+		const input = element;
+		return input.placeholder || input.value || null;
+	}
+	return element.textContent?.trim() || null;
+}
+const DomUtils = {
+	getElementSelector,
+	getElementText
+};
+
+//#endregion
+export { DomUtils, getElementSelector, getElementText };

package/dist/core/plugins/dom-utils.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"dom-utils.mjs","names":[],"sources":["../../../src/core/plugins/dom-utils.ts"],"sourcesContent":["// Shared DOM helpers for plugin implementations\n\nconst CLASS_REGEX = /\\s+/;\n\nexport function getElementSelector(element: Element): string {\n  const node = element as HTMLElement;\n\n  if (node.id) {\n    return `#${node.id}`;\n  }\n\n  if (typeof node.className === \"string\" && node.className.trim().length > 0) {\n    const classes = node.className.trim().split(CLASS_REGEX).join(\".\");\n    const tag = node.tagName?.toLowerCase() || \"element\";\n    return `${tag}.${classes}`;\n  }\n\n  return node.tagName?.toLowerCase() || \"element\";\n}\n\nexport function getElementText(element: HTMLElement): string | null {\n  if (element.tagName === \"INPUT\") {\n    const input = element as HTMLInputElement;\n    return input.placeholder || input.value || null;\n  }\n\n  const text = element.textContent?.trim();\n  return text || null;\n}\n\nexport const DomUtils = {\n  getElementSelector,\n  getElementText,\n};\n"],"mappings":";AAEA,MAAM,cAAc;AAEpB,SAAgB,mBAAmB,SAA0B;CAC3D,MAAM,OAAO;AAEb,KAAI,KAAK,GACP,QAAO,IAAI,KAAK;AAGlB,KAAI,OAAO,KAAK,cAAc,YAAY,KAAK,UAAU,MAAM,CAAC,SAAS,GAAG;EAC1E,MAAM,UAAU,KAAK,UAAU,MAAM,CAAC,MAAM,YAAY,CAAC,KAAK,IAAI;AAElE,SAAO,GADK,KAAK,SAAS,aAAa,IAAI,UAC7B,GAAG;;AAGnB,QAAO,KAAK,SAAS,aAAa,IAAI;;AAGxC,SAAgB,eAAe,SAAqC;AAClE,KAAI,QAAQ,YAAY,SAAS;EAC/B,MAAM,QAAQ;AACd,SAAO,MAAM,eAAe,MAAM,SAAS;;AAI7C,QADa,QAAQ,aAAa,MAAM,IACzB;;AAGjB,MAAa,WAAW;CACtB;CACA;CACD"}

package/dist/core/plugins/impl/ai-summary.d.mts

@@ -0,0 +1,6 @@
+import { Plugin } from "../../schemas.mjs";
+
+//#region src/core/plugins/impl/ai-summary.d.ts
+declare const _default: Plugin<"aiSummary", unknown>;
+//#endregion
+export { _default as default };

package/dist/core/plugins/impl/ai-summary.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-summary.d.mts","names":[],"sources":["../../../../src/core/plugins/impl/ai-summary.ts"],"sourcesContent":[],"mappings":""}

package/dist/core/plugins/impl/ai-summary.mjs

@@ -0,0 +1,122 @@
+import { createEffectPlugin, defineEvent } from "../plugin-event-system.mjs";
+import { Effect } from "effect";
+
+//#region src/core/plugins/impl/ai-summary.ts
+var ai_summary_default = createEffectPlugin("aiSummary", {
+	name: "aiSummary",
+	events: [defineEvent("session_summary").value()],
+	setup: (ctx) => Effect.gen(function* () {
+		if (typeof window === "undefined" || typeof document === "undefined" || !("ai" in window) || !window.ai?.summarizer) {
+			ctx.log.debug("aiSummary: unsupported environment or missing API");
+			return;
+		}
+		const ai = window.ai;
+		const capabilities = yield* Effect.promise(() => ai.summarizer?.capabilities() ?? Promise.resolve({ available: "no" }));
+		if (capabilities?.available !== "readily") {
+			ctx.log.debug("aiSummary: summarizer not readily available", { available: capabilities?.available });
+			return;
+		}
+		if (!ai.summarizer) {
+			ctx.log.debug("aiSummary: summarizer missing after capability check");
+			return;
+		}
+		let isCapturing = false;
+		let lastCaptureTime = 0;
+		const MIN_CAPTURE_INTERVAL_MS = 3e4;
+		const INITIAL_CAPTURE_DELAY_MS = 5e3;
+		const DEBOUNCE_DELAY_MS = 2e3;
+		const MIN_TEXT_LENGTH = 100;
+		const MAX_TEXT_LENGTH = 5e4;
+		const MAX_CONTEXT_TEXT_LENGTH = 1e4;
+		const MIN_NODE_TEXT_LENGTH = 3;
+		const MIN_SUMMARY_LENGTH = 20;
+		const shouldSkipForLength = (text) => text.length < MIN_TEXT_LENGTH || text.length > MAX_TEXT_LENGTH;
+		const acceptTextNode = (textNode) => {
+			const parent = textNode.parentElement;
+			if (!parent) return NodeFilter.FILTER_REJECT;
+			const tagName = parent.tagName.toLowerCase();
+			if (tagName === "script" || tagName === "style" || tagName === "noscript") return NodeFilter.FILTER_REJECT;
+			const style = window.getComputedStyle(parent);
+			if (style.display === "none" || style.visibility === "hidden" || style.opacity === "0") return NodeFilter.FILTER_REJECT;
+			const text = textNode.textContent?.trim();
+			if (!text || text.length < MIN_NODE_TEXT_LENGTH) return NodeFilter.FILTER_REJECT;
+			return NodeFilter.FILTER_ACCEPT;
+		};
+		const extractVisibleText = () => {
+			const walker = document.createTreeWalker(document.body, NodeFilter.SHOW_TEXT, { acceptNode: acceptTextNode });
+			const parts = [];
+			let current = walker.nextNode();
+			while (current) {
+				const text = current.textContent?.trim();
+				if (text && text.length >= MIN_NODE_TEXT_LENGTH) parts.push(text);
+				current = walker.nextNode();
+			}
+			return parts.join(" ");
+		};
+		const buildContextText = (title, url, description, content) => {
+			return `Title: ${title}\nURL: ${url}\n${description ? `Description: ${description}\n` : ""}Content: ${content.substring(0, MAX_CONTEXT_TEXT_LENGTH)}`;
+		};
+		const getPageMetadata = () => {
+			return {
+				title: document.title || "Untitled",
+				url: window.location.href,
+				description: document.querySelector("meta[name=\"description\"]")?.getAttribute("content") || ""
+			};
+		};
+		const isSummaryMeaningful = (text) => Boolean(text && text.length > MIN_SUMMARY_LENGTH);
+		async function performSummaryFlow(nowTs) {
+			const fullText = extractVisibleText();
+			if (shouldSkipForLength(fullText)) return;
+			const { title, url, description } = getPageMetadata();
+			const contextualText = buildContextText(title, url, description, fullText);
+			const summarizer = ai.summarizer;
+			if (!summarizer) return;
+			const summary = await (await summarizer.create()).prompt(contextualText);
+			if (!isSummaryMeaningful(summary)) return;
+			ctx.span("plugin.ai.session_summary", ctx.capture("session_summary", {
+				summary,
+				pageTitle: title,
+				pageUrl: url,
+				contentLength: fullText.length,
+				timestamp: nowTs
+			}));
+		}
+		const capturePageSummary = async () => {
+			const nowTs = Date.now();
+			if (isCapturing || nowTs - lastCaptureTime < MIN_CAPTURE_INTERVAL_MS) return;
+			isCapturing = true;
+			lastCaptureTime = nowTs;
+			try {
+				await performSummaryFlow(nowTs);
+			} catch (error) {
+				ctx.log.debug("Failed to capture AI session summary", { error });
+			} finally {
+				isCapturing = false;
+			}
+		};
+		const observer = new MutationObserver(() => {
+			if (!isCapturing) setTimeout(capturePageSummary, DEBOUNCE_DELAY_MS);
+		});
+		observer.observe(document.body, {
+			childList: true,
+			subtree: true,
+			characterData: false,
+			attributes: false
+		});
+		const handleVisibilityChange = () => {
+			if (document.visibilityState === "visible") capturePageSummary();
+		};
+		document.addEventListener("visibilitychange", handleVisibilityChange);
+		setTimeout(capturePageSummary, INITIAL_CAPTURE_DELAY_MS);
+		return {
+			key: "aiSummary",
+			cleanup: () => {
+				observer.disconnect();
+				document.removeEventListener("visibilitychange", handleVisibilityChange);
+			}
+		};
+	})
+});
+
+//#endregion
+export { ai_summary_default as default };

package/dist/core/plugins/impl/ai-summary.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-summary.mjs","names":["parts: string[]","current: Node | null","error: unknown"],"sources":["../../../../src/core/plugins/impl/ai-summary.ts"],"sourcesContent":["import { Effect } from \"effect\";\nimport { createEffectPlugin, defineEvent } from \"../plugin-event-system.js\";\n\ntype BrowserAITextSession = { prompt: (input: string) => Promise<string> };\n\nexport default createEffectPlugin(\"aiSummary\", {\n  name: \"aiSummary\",\n  events: [defineEvent(\"session_summary\").value()],\n  setup: (ctx) =>\n    Effect.gen(function* () {\n      // Skip in SSR or unsupported environments\n      if (\n        typeof window === \"undefined\" ||\n        typeof document === \"undefined\" ||\n        !(\"ai\" in window) ||\n        !(window.ai as { summarizer?: unknown })?.summarizer\n      ) {\n        ctx.log.debug(\"aiSummary: unsupported environment or missing API\");\n        return;\n      }\n\n      const ai = window.ai as {\n        summarizer?: {\n          create: () => Promise<BrowserAITextSession>;\n          capabilities: () => Promise<{ available: string }>;\n        };\n      };\n\n      // Check if the summarizer is available\n      const capabilities = yield* Effect.promise(\n        () =>\n          ai.summarizer?.capabilities() ?? Promise.resolve({ available: \"no\" })\n      );\n      if (capabilities?.available !== \"readily\") {\n        ctx.log.debug(\"aiSummary: summarizer not readily available\", {\n          available: capabilities?.available,\n        });\n        return;\n      }\n\n      if (!ai.summarizer) {\n        ctx.log.debug(\"aiSummary: summarizer missing after capability check\");\n\n        return;\n      }\n\n      let isCapturing = false;\n      let lastCaptureTime = 0;\n      const MIN_CAPTURE_INTERVAL_MS = 30_000;\n      const INITIAL_CAPTURE_DELAY_MS = 5000;\n      const DEBOUNCE_DELAY_MS = 2000;\n      const MIN_TEXT_LENGTH = 100;\n      const MAX_TEXT_LENGTH = 50_000;\n      const MAX_CONTEXT_TEXT_LENGTH = 10_000;\n      const MIN_NODE_TEXT_LENGTH = 3;\n      const MIN_SUMMARY_LENGTH = 20;\n\n      const shouldSkipForLength = (text: string) =>\n        text.length < MIN_TEXT_LENGTH || text.length > MAX_TEXT_LENGTH;\n\n      const acceptTextNode = (textNode: Node) => {\n        const parent = textNode.parentElement;\n        if (!parent) {\n          return NodeFilter.FILTER_REJECT;\n        }\n\n        const tagName = parent.tagName.toLowerCase();\n        if (\n          tagName === \"script\" ||\n          tagName === \"style\" ||\n          tagName === \"noscript\"\n        ) {\n          return NodeFilter.FILTER_REJECT;\n        }\n\n        const style = window.getComputedStyle(parent);\n        if (\n          style.display === \"none\" ||\n          style.visibility === \"hidden\" ||\n          style.opacity === \"0\"\n        ) {\n          return NodeFilter.FILTER_REJECT;\n        }\n\n        const text = textNode.textContent?.trim();\n        if (!text || text.length < MIN_NODE_TEXT_LENGTH) {\n          return NodeFilter.FILTER_REJECT;\n        }\n\n        return NodeFilter.FILTER_ACCEPT;\n      };\n\n      const extractVisibleText = (): string => {\n        const walker = document.createTreeWalker(\n          document.body,\n          NodeFilter.SHOW_TEXT,\n          { acceptNode: acceptTextNode }\n        );\n        const parts: string[] = [];\n\n        let current: Node | null = walker.nextNode();\n\n        while (current) {\n          const text = current.textContent?.trim();\n\n          if (text && text.length >= MIN_NODE_TEXT_LENGTH) {\n            parts.push(text);\n          }\n\n          current = walker.nextNode();\n        }\n\n        return parts.join(\" \");\n      };\n\n      const buildContextText = (\n        title: string,\n        url: string,\n        description: string,\n        content: string\n      ): string => {\n        const desc = description ? `Description: ${description}\\n` : \"\";\n\n        return `Title: ${title}\\nURL: ${url}\\n${desc}Content: ${content.substring(0, MAX_CONTEXT_TEXT_LENGTH)}`;\n      };\n\n      const getPageMetadata = () => {\n        const title = document.title || \"Untitled\";\n        const url = window.location.href;\n        const description =\n          document\n            .querySelector('meta[name=\"description\"]')\n            ?.getAttribute(\"content\") || \"\";\n\n        return { title, url, description };\n      };\n\n      const isSummaryMeaningful = (text: string | undefined) =>\n        Boolean(text && text.length > MIN_SUMMARY_LENGTH);\n\n      async function performSummaryFlow(nowTs: number) {\n        const fullText = extractVisibleText();\n        if (shouldSkipForLength(fullText)) {\n          return;\n        }\n\n        const { title, url, description } = getPageMetadata();\n        const contextualText = buildContextText(\n          title,\n          url,\n          description,\n          fullText\n        );\n\n        const summarizer = ai.summarizer;\n        if (!summarizer) {\n          return;\n        }\n\n        const session = await summarizer.create();\n        const summary = await session.prompt(contextualText);\n        if (!isSummaryMeaningful(summary)) {\n          return;\n        }\n\n        ctx.span(\n          \"plugin.ai.session_summary\",\n          ctx.capture(\"session_summary\", {\n            summary,\n            pageTitle: title,\n            pageUrl: url,\n            contentLength: fullText.length,\n            timestamp: nowTs,\n          })\n        );\n      }\n\n      const capturePageSummary = async () => {\n        const nowTs = Date.now();\n        if (isCapturing || nowTs - lastCaptureTime < MIN_CAPTURE_INTERVAL_MS) {\n          return;\n        }\n\n        isCapturing = true;\n        lastCaptureTime = nowTs;\n\n        try {\n          await performSummaryFlow(nowTs);\n        } catch (error: unknown) {\n          ctx.log.debug(\"Failed to capture AI session summary\", { error });\n        } finally {\n          isCapturing = false;\n        }\n      };\n\n      // Set up observers for content changes and navigation\n      const observer = new MutationObserver(() => {\n        // Debounce captures\n        if (!isCapturing) {\n          setTimeout(capturePageSummary, DEBOUNCE_DELAY_MS);\n        }\n      });\n\n      observer.observe(document.body, {\n        childList: true,\n        subtree: true,\n        characterData: false,\n        attributes: false,\n      });\n\n      // Capture on significant events\n      const handleVisibilityChange = () => {\n        if (document.visibilityState === \"visible\") {\n          capturePageSummary();\n        }\n      };\n\n      document.addEventListener(\"visibilitychange\", handleVisibilityChange);\n\n      // Initial capture after a delay\n      setTimeout(capturePageSummary, INITIAL_CAPTURE_DELAY_MS);\n\n      // Return cleanup function\n      return {\n        key: \"aiSummary\",\n        cleanup: () => {\n          observer.disconnect();\n          document.removeEventListener(\n            \"visibilitychange\",\n            handleVisibilityChange\n          );\n        },\n      };\n    }),\n});\n"],"mappings":"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"}

package/dist/core/plugins/impl/errors.d.mts

@@ -0,0 +1,9 @@
+import { Plugin } from "../../schemas.mjs";
+
+//#region src/core/plugins/impl/errors.d.ts
+type ErrorsAPI = {
+  captureError: (err: unknown, meta?: Record<string, unknown>) => void;
+};
+declare const _default: Plugin<"errors", unknown>;
+//#endregion
+export { ErrorsAPI, _default as default };

package/dist/core/plugins/impl/errors.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.mts","names":[],"sources":["../../../../src/core/plugins/impl/errors.ts"],"sourcesContent":[],"mappings":";;;KAwEY,SAAA;sCAC0B;;AADtC,cAEE,QAFmB,EAEnB,MAD0C,CAAA,QAAA,EAAA,OAAA,CAAA"}