@interfere/react 0.1.0-alpha.4 → 0.1.0-alpha.6

package/dist/client.d.mts

@@ -1,15 +1,8 @@
-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 };
+export { CaptureFn, capture };

package/dist/client.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.mts","names":[],"sources":["../src/client.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;KAeY,SAAA,cAAuB,iBAC3B,YACG,aAAa;iBA0BR,wBAAwB,iBAChC,YACG,aAAa,KAAE,MAAA,CAAA,aAAA,iBAAA,kBAAA,iBAAA,GAAA,SAAA,GAAA;cAqFb,SAAS"}
+{"version":3,"file":"client.d.mts","names":[],"sources":["../src/client.ts"],"mappings":";;;;KAQY,SAAA,cAAuB,SAAA,EACjC,IAAA,EAAM,CAAA,EACN,OAAA,EAAS,YAAA,CAAa,CAAA;AAAA,cAGX,OAAA,EAAS,SAAA"}

package/dist/client.mjs

@@ -1,75 +1,14 @@
-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 { EventCapture } from "./core/plugins/services/event-capture.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)
-	}))));
+	forkWithSDK(Effect.gen(function* () {
+		yield* (yield* EventCapture).capture(type, payload);
+	}).pipe(Effect.withSpan("capture")));
 };
 
 //#endregion
-export { capture, captureEffect };
+export { capture };

package/dist/client.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"client.mjs","names":["capture: CaptureFn"],"sources":["../src/client.ts"],"sourcesContent":["import type { EventType } from \"@interfere/types/sdk/plugins/lib/types\";\n\nimport { Effect } from \"effect\";\n\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":";;;;;;;;;;AAyBA,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"}
+{"version":3,"file":"client.mjs","names":[],"sources":["../src/client.ts"],"sourcesContent":["import type { EventType } from \"@interfere/types/sdk/plugins/lib/types\";\n\nimport { Effect } from \"effect\";\n\nimport type { EventPayload } from \"./core/events/event-registry.js\";\nimport { EventCapture } from \"./core/plugins/services/event-capture.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\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    Effect.gen(function* () {\n      const eventCapture = yield* EventCapture;\n      yield* eventCapture.capture(type, payload);\n    }).pipe(Effect.withSpan(\"capture\"))\n  );\n};\n"],"mappings":";;;;;AAaA,MAAa,WACX,MACA,YACG;AACH,KAAI,OAAO,WAAW,YACpB;AAGF,aACE,OAAO,IAAI,aAAa;AAEtB,UADqB,OAAO,cACR,QAAQ,MAAM,QAAQ;GAC1C,CAAC,KAAK,OAAO,SAAS,UAAU,CAAC,CACpC"}

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

@@ -0,0 +1,12 @@
+import { EventDefinitionFor, EventSchemas } from "./plugin-event-types.mjs";
+import { z } from "zod";
+
+//#region src/core/events/define-event.d.ts
+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, defineEvent };

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

@@ -0,0 +1 @@
+{"version":3,"file":"define-event.d.mts","names":[],"sources":["../../../src/core/events/define-event.ts"],"mappings":";;;;KAKY,oBAAA,iBAAqC,YAAA,IAC/C,kBAAA,CAAmB,CAAA;AAAA,iBA+BL,WAAA,iBAA4B,YAAA,CAAA,CAAc,IAAA,EAAM,CAAA;2BAIxC,kBAAA,CAAA,CAAA;oBACJ,EAAA,GAAO,KAAA,EAAO,CAAA,CAAE,KAAA,CAAM,YAAA,CAAa,CAAA,OAAQ,IAAA,KAAI,kBAAA,CAAA,CAAA"}

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

@@ -0,0 +1,39 @@
+import { eventConfigs, eventSchemas } from "./plugin-event-types.mjs";
+
+//#region src/core/events/define-event.ts
+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 { defineEvent };

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

@@ -0,0 +1 @@
+{"version":3,"file":"define-event.mjs","names":[],"sources":["../../../src/core/events/define-event.ts"],"sourcesContent":["import type { z } from \"zod\";\n\nimport type { EventDefinitionFor, EventSchemas } from \"./plugin-event-types.js\";\nimport { eventConfigs, eventSchemas } from \"./plugin-event-types.js\";\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":";;;AAQA,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/events/event-registry.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"event-registry.d.mts","names":[],"sources":["../../../src/core/events/event-registry.ts"],"sourcesContent":[],"mappings":";;;;;KAYY,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,UAuBlC,kBAvBkC,CAAA,UAuBL,SAvBK,GAuBO,SAvBP,CAAA,CAAA;EAAgB,SAAA,EAwBtD,CAxBsD;EAC5C,OAAA,EAwBZ,eAxBY,CAwBI,CAxBJ,CAAA;;AAAnB,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"}
+{"version":3,"file":"event-registry.d.mts","names":[],"sources":["../../../src/core/events/event-registry.ts"],"mappings":";;;;;KAYY,eAAA,WAA0B,SAAA,IAAa,CAAA,eAAgB,YAAA,GAC/D,kBAAA,CAAmB,YAAA,CAAa,CAAA;AAAA,KAIxB,YAAA,WAAuB,SAAA,IAAa,CAAA,eAAgB,YAAA,GAC5D,CAAA,CAAE,KAAA,CAAM,YAAA,CAAa,CAAA;AAAA,iBAIT,eAAA,WAA0B,SAAA,CAAA,CACxC,IAAA,EAAM,CAAA,GACL,eAAA,CAAgB,CAAA;AAAA,iBAMH,eAAA,CAAgB,IAAA,EAAM,SAAA,GAAY,IAAA,UAAc,YAAA;AAAA,UAK/C,kBAAA,WAA6B,SAAA,GAAY,SAAA;EACxD,SAAA,EAAW,CAAA;EACX,OAAA,EAAS,eAAA,CAAgB,CAAA;AAAA;AAAA,cAId,oBAAA;EAAA,iBACM,eAAA;EAKjB,QAAA,WAAmB,SAAA,CAAA,CACjB,SAAA,EAAW,CAAA,EACX,OAAA,EAAS,eAAA,CAAgB,CAAA;EAQ3B,kBAAA,CAAmB,GAAA,EAAK,kBAAA;EAQxB,GAAA,WAAc,SAAA,CAAA,CAAW,SAAA,EAAW,CAAA,GAAI,eAAA,CAAgB,CAAA;EAOxD,KAAA,CAAM,QAAA,EAAU,kBAAA;AAAA;AAAA,cAQL,eAAA,EAAe,oBAAA"}

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

@@ -4,8 +4,8 @@ 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;
+type EventsForPlugin<K extends PluginKey> = Extract<PluginRegistrationInManifest, {
+  name: K;
 }>["events"][number]["name"];
 declare const eventSchemas: {
   readonly error: z.ZodObject<{
@@ -31,6 +31,42 @@ declare const eventSchemas: {
       server: "server";
       edge: "edge";
     }>;
+    mechanism: z.ZodOptional<z.ZodObject<{
+      type: z.ZodString;
+      handled: z.ZodBoolean;
+      synthetic: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    nextjs: z.ZodOptional<z.ZodObject<{
+      routerKind: z.ZodOptional<z.ZodEnum<{
+        "Pages Router": "Pages Router";
+        "App Router": "App Router";
+      }>>;
+      routePath: z.ZodOptional<z.ZodString>;
+      routeType: z.ZodOptional<z.ZodEnum<{
+        render: "render";
+        route: "route";
+        action: "action";
+        middleware: "middleware";
+        proxy: "proxy";
+      }>>;
+      renderSource: z.ZodOptional<z.ZodEnum<{
+        "react-server-components": "react-server-components";
+        "react-server-components-payload": "react-server-components-payload";
+        "server-rendering": "server-rendering";
+      }>>;
+      revalidateReason: z.ZodOptional<z.ZodEnum<{
+        "on-demand": "on-demand";
+        stale: "stale";
+      }>>;
+      renderType: z.ZodOptional<z.ZodEnum<{
+        dynamic: "dynamic";
+        "dynamic-resume": "dynamic-resume";
+      }>>;
+      requestPath: z.ZodOptional<z.ZodString>;
+      requestMethod: z.ZodOptional<z.ZodString>;
+      errorDigest: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    captureSource: z.ZodOptional<z.ZodString>;
   }, z.core.$strip>;
   readonly rage_click: z.ZodObject<{
     count: z.ZodNumber;
@@ -48,6 +84,8 @@ declare const eventSchemas: {
     ts: z.ZodNumber;
     count: z.ZodNumber;
     events: z.ZodArray<z.ZodString>;
+    first_event_ts: z.ZodOptional<z.ZodNumber>;
+    last_event_ts: z.ZodOptional<z.ZodNumber>;
   }, z.core.$strip>;
   readonly session_summary: z.ZodObject<{
     summary: z.ZodString;
@@ -66,7 +104,7 @@ declare const eventSchemas: {
   }, 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", {
+declare const eventConfigs: Record<"error" | "rage_click" | "ui_event" | "replay_chunk" | "session_summary" | "pageview" | "pageleave", {
   enrich: boolean;
 }>;
 type EventSchemas = typeof eventSchemas;
@@ -82,10 +120,10 @@ type EventDefinitionFor<T extends EventType> = T extends keyof EventSchemas ? {
   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 ValidatePluginEvents<K extends PluginKey, Events extends readonly AnyEventDefinition[]> = Events extends readonly (infer E)[] ? E extends AnyEventDefinition ? E["type"] extends EventsForPlugin<K> ? Events : never : never : never;
 interface EventHandlerConfig<TSchema extends z.ZodType<unknown>, TInput = z.infer<TSchema>, TOutput = TInput> {
-  schema: TSchema;
   enrich: boolean;
+  schema: TSchema;
   transform?: (input: TInput) => TOutput;
 }
 //#endregion

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

@@ -1 +1 @@
-{"version":3,"file":"plugin-event-types.d.mts","names":[],"sources":["../../../src/core/events/plugin-event-types.ts"],"sourcesContent":[],"mappings":";;;;;KAoBK,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,UA8BR,kBA9BQ,CAAA,gBA+BP,CAAA,CAAE,OA/BK,CAAA,OAAA,CAAA,EAAA,SAgCd,CAAA,CAAE,KAhCY,CAgCN,OAhCM,CAAA,EAAA,UAiCb,MAjCa,CAAA,CAAA;EAEO,MAAA,EAiCtB,OAjCsB;EAAa,MAAA,EAAA,OAAA;EAAnB,SAAA,CAAA,EAAA,CAAA,KAAA,EAmCJ,MAnCI,EAAA,GAmCO,OAnCP"}
+{"version":3,"file":"plugin-event-types.d.mts","names":[],"sources":["../../../src/core/events/plugin-event-types.ts"],"mappings":";;;;;KAoBK,4BAAA,GAA+B,cAAA;AAAA,KAExB,eAAA,WAA0B,SAAA,IAAa,OAAA,CACjD,4BAAA;EACE,IAAA,EAAM,CAAA;AAAA;AAAA,cAIG,YAAA;EAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAWA,YAAA,EAAY,MAAA;EAAA,MAAA;AAAA;AAAA,KAUb,YAAA,UAAsB,YAAA;AAAA,KAGtB,kBAAA,iBACE,YAAA;EACV,IAAA,EAAM,CAAA;EACN,MAAA,EAAQ,YAAA,CAAa,CAAA;EACrB,MAAA;EACA,SAAA,IAAa,KAAA,EAAO,CAAA,CAAE,KAAA,CAAM,YAAA,CAAa,CAAA;AAAA,UAErC,YAAA;AAAA,KAGI,kBAAA,WAA6B,SAAA,IACvC,CAAA,eAAgB,YAAA;EAEV,IAAA,EAAM,CAAA;EACN,MAAA,EAAQ,YAAA,CAAa,CAAA;EACrB,MAAA;EACA,SAAA,IAAa,KAAA,EAAO,CAAA,CAAE,KAAA,CAAM,YAAA,CAAa,CAAA;AAAA;AAAA,KAKrC,oBAAA,WACA,SAAA,0BACc,kBAAA,MACtB,MAAA,gCACA,CAAA,SAAU,kBAAA,GACR,CAAA,iBAAkB,eAAA,CAAgB,CAAA,IAChC,MAAA;AAAA,UAMS,kBAAA,iBACC,CAAA,CAAE,OAAA,oBACT,CAAA,CAAE,KAAA,CAAM,OAAA,aACP,MAAA;EAEV,MAAA;EACA,MAAA,EAAQ,OAAA;EACR,SAAA,IAAa,KAAA,EAAO,MAAA,KAAW,OAAA;AAAA"}

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

@@ -1 +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\";\n\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 interface 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":";;;;;;;;AA4BA,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"}
+{"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\";\n\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 interface EventHandlerConfig<\n  TSchema extends z.ZodType<unknown>,\n  TInput = z.infer<TSchema>,\n  TOutput = TInput,\n> {\n  enrich: boolean;\n  schema: TSchema;\n  transform?: (input: TInput) => TOutput;\n}\n"],"mappings":";;;;;;;;AA4BA,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/define-plugin.d.mts

@@ -0,0 +1,43 @@
+import { AnyEventDefinition } from "../events/plugin-event-types.mjs";
+import { EventCapture } from "./services/event-capture.mjs";
+import { PluginConfig } from "./services/plugin-config.mjs";
+import { PluginLogger } from "./services/plugin-logger.mjs";
+import { PluginRuntime } from "./services/plugin-runtime.mjs";
+import { SessionInfo } from "./services/session-info.mjs";
+import { Effect, Layer } from "effect";
+import { PluginKey } from "@interfere/types/sdk/plugins/lib/types";
+
+//#region src/core/plugins/define-plugin.d.ts
+type BasePluginServices = EventCapture | SessionInfo | PluginConfig | PluginLogger | PluginRuntime;
+interface PluginSetupResult<API = unknown> {
+  readonly api?: API;
+  readonly cleanup?: () => void;
+}
+/**
+ * A loadable plugin definition. The private layer type `RPrivate` is hidden
+ * by capturing it in the `load` closure, avoiding variance issues when storing
+ * heterogeneous plugins in collections.
+ */
+interface PluginDef<K extends string = string, API = unknown> {
+  readonly events?: readonly AnyEventDefinition[];
+  readonly key: K;
+  readonly load: <R>(baseLayer: Layer.Layer<BasePluginServices, never, R>) => Effect.Effect<PluginSetupResult<API>, never, R>;
+  readonly name: string;
+}
+/**
+ * Define a plugin with a private layer. The `RPrivate` type parameter is
+ * captured in the returned `load` function closure, so callers don't need
+ * to know about it.
+ *
+ * The setup Effect receives both the plugin's private services (RPrivate) and
+ * the base plugin services (PluginRuntime, PluginLogger, etc.) so it can fork
+ * Effects via PluginRuntime.
+ */
+declare function definePlugin<K extends PluginKey, API, RPrivate>(key: K, options: {
+  readonly name: string;
+  readonly events?: readonly AnyEventDefinition[];
+  readonly layer: Layer.Layer<RPrivate, never, BasePluginServices>;
+  readonly setup: Effect.Effect<PluginSetupResult<API>, never, RPrivate | BasePluginServices>;
+}): PluginDef<K, API>;
+//#endregion
+export { BasePluginServices, PluginDef, PluginSetupResult, definePlugin };

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

@@ -0,0 +1 @@
+{"version":3,"file":"define-plugin.d.mts","names":[],"sources":["../../../src/core/plugins/define-plugin.ts"],"mappings":";;;;;;;;;;KAWY,kBAAA,GACR,YAAA,GACA,WAAA,GACA,YAAA,GACA,YAAA,GACA,aAAA;AAAA,UAEa,iBAAA;EAAA,SACN,GAAA,GAAM,GAAA;EAAA,SACN,OAAA;AAAA;;;;;;UAQM,SAAA;EAAA,SACN,MAAA,YAAkB,kBAAA;EAAA,SAClB,GAAA,EAAK,CAAA;EAAA,SACL,IAAA,MACP,SAAA,EAAW,KAAA,CAAM,KAAA,CAAM,kBAAA,SAA2B,CAAA,MAC/C,MAAA,CAAO,MAAA,CAAO,iBAAA,CAAkB,GAAA,UAAa,CAAA;EAAA,SACzC,IAAA;AAAA;;;;AAhBX;;;;;;iBA4BgB,YAAA,WAAuB,SAAA,gBAAA,CACrC,GAAA,EAAK,CAAA,EACL,OAAA;EAAA,SACW,IAAA;EAAA,SACA,MAAA,YAAkB,kBAAA;EAAA,SAClB,KAAA,EAAO,KAAA,CAAM,KAAA,CAAM,QAAA,SAAiB,kBAAA;EAAA,SACpC,KAAA,EAAO,MAAA,CAAO,MAAA,CACrB,iBAAA,CAAkB,GAAA,UAElB,QAAA,GAAW,kBAAA;AAAA,IAGd,SAAA,CAAU,CAAA,EAAG,GAAA"}

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

@@ -0,0 +1,23 @@
+import { Effect, Layer } from "effect";
+
+//#region src/core/plugins/define-plugin.ts
+/**
+* Define a plugin with a private layer. The `RPrivate` type parameter is
+* captured in the returned `load` function closure, so callers don't need
+* to know about it.
+*
+* The setup Effect receives both the plugin's private services (RPrivate) and
+* the base plugin services (PluginRuntime, PluginLogger, etc.) so it can fork
+* Effects via PluginRuntime.
+*/
+function definePlugin(key, options) {
+	return {
+		key,
+		name: options.name,
+		events: options.events,
+		load: (baseLayer) => options.setup.pipe(Effect.provide(Layer.merge(options.layer.pipe(Layer.provide(baseLayer)), baseLayer)))
+	};
+}
+
+//#endregion
+export { definePlugin };

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

@@ -0,0 +1 @@
+{"version":3,"file":"define-plugin.mjs","names":[],"sources":["../../../src/core/plugins/define-plugin.ts"],"sourcesContent":["import type { PluginKey } from \"@interfere/types/sdk/plugins/lib/types\";\n\nimport { Effect, Layer } from \"effect\";\n\nimport type { AnyEventDefinition } from \"../events/plugin-event-types.js\";\nimport type { EventCapture } from \"./services/event-capture.js\";\nimport type { PluginConfig } from \"./services/plugin-config.js\";\nimport type { PluginLogger } from \"./services/plugin-logger.js\";\nimport type { PluginRuntime } from \"./services/plugin-runtime.js\";\nimport type { SessionInfo } from \"./services/session-info.js\";\n\nexport type BasePluginServices =\n  | EventCapture\n  | SessionInfo\n  | PluginConfig\n  | PluginLogger\n  | PluginRuntime;\n\nexport interface PluginSetupResult<API = unknown> {\n  readonly api?: API;\n  readonly cleanup?: () => void;\n}\n\n/**\n * A loadable plugin definition. The private layer type `RPrivate` is hidden\n * by capturing it in the `load` closure, avoiding variance issues when storing\n * heterogeneous plugins in collections.\n */\nexport interface PluginDef<K extends string = string, API = unknown> {\n  readonly events?: readonly AnyEventDefinition[];\n  readonly key: K;\n  readonly load: <R>(\n    baseLayer: Layer.Layer<BasePluginServices, never, R>\n  ) => Effect.Effect<PluginSetupResult<API>, never, R>;\n  readonly name: string;\n}\n\n/**\n * Define a plugin with a private layer. The `RPrivate` type parameter is\n * captured in the returned `load` function closure, so callers don't need\n * to know about it.\n *\n * The setup Effect receives both the plugin's private services (RPrivate) and\n * the base plugin services (PluginRuntime, PluginLogger, etc.) so it can fork\n * Effects via PluginRuntime.\n */\nexport function definePlugin<K extends PluginKey, API, RPrivate>(\n  key: K,\n  options: {\n    readonly name: string;\n    readonly events?: readonly AnyEventDefinition[];\n    readonly layer: Layer.Layer<RPrivate, never, BasePluginServices>;\n    readonly setup: Effect.Effect<\n      PluginSetupResult<API>,\n      never,\n      RPrivate | BasePluginServices\n    >;\n  }\n): PluginDef<K, API> {\n  return {\n    key,\n    name: options.name,\n    events: options.events,\n    load: (baseLayer) =>\n      options.setup.pipe(\n        Effect.provide(\n          Layer.merge(options.layer.pipe(Layer.provide(baseLayer)), baseLayer)\n        )\n      ),\n  };\n}\n"],"mappings":";;;;;;;;;;;;AA8CA,SAAgB,aACd,KACA,SAUmB;AACnB,QAAO;EACL;EACA,MAAM,QAAQ;EACd,QAAQ,QAAQ;EAChB,OAAO,cACL,QAAQ,MAAM,KACZ,OAAO,QACL,MAAM,MAAM,QAAQ,MAAM,KAAK,MAAM,QAAQ,UAAU,CAAC,EAAE,UAAU,CACrE,CACF;EACJ"}

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

@@ -1 +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"}
+{"version":3,"file":"dom-utils.d.mts","names":[],"sources":["../../../src/core/plugins/dom-utils.ts"],"mappings":";iBAIgB,kBAAA,CAAmB,OAAA,EAAS,OAAA;AAAA,iBAgB5B,cAAA,CAAe,OAAA,EAAS,WAAA;AAAA,cAU3B,QAAA;6BAGZ,kBAAA;yBAAA,cAAA;AAAA"}

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

@@ -0,0 +1,18 @@
+import { EventPayload } from "../../../events/event-registry.mjs";
+import { EventCapture } from "../../services/event-capture.mjs";
+import { PluginLogger } from "../../services/plugin-logger.mjs";
+import { Context, Effect, Layer } from "effect";
+
+//#region src/core/plugins/impl/ai-summary/ai-summary-plugin-api.d.ts
+type SessionSummaryPayload = EventPayload<"session_summary">;
+interface AiSummaryPluginApiService {
+  readonly captureSessionSummary: (payload: SessionSummaryPayload) => Effect.Effect<void>;
+  readonly log: {
+    readonly debug: (message: string) => Effect.Effect<void>;
+  };
+}
+declare const AiSummaryPluginApi_base: Context.TagClass<AiSummaryPluginApi, "@interfere/plugins/ai-summary/AiSummaryPluginApi", AiSummaryPluginApiService>;
+declare class AiSummaryPluginApi extends AiSummaryPluginApi_base {}
+declare const AiSummaryPluginApiLayer: Layer.Layer<AiSummaryPluginApi, never, EventCapture | PluginLogger>;
+//#endregion
+export { AiSummaryPluginApi, AiSummaryPluginApiLayer };

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

@@ -0,0 +1 @@
+{"version":3,"file":"ai-summary-plugin-api.d.mts","names":[],"sources":["../../../../../src/core/plugins/impl/ai-summary/ai-summary-plugin-api.ts"],"mappings":";;;;;;KAMK,qBAAA,GAAwB,YAAA;AAAA,UAEnB,yBAAA;EAAA,SACC,qBAAA,GACP,OAAA,EAAS,qBAAA,KACN,MAAA,CAAO,MAAA;EAAA,SACH,GAAA;IAAA,SACE,KAAA,GAAQ,OAAA,aAAoB,MAAA,CAAO,MAAA;EAAA;AAAA;AAAA,cAAM,uBAAA;cAIzC,kBAAA,SAA2B,uBAAA;AAAA,cAI3B,uBAAA,EAAuB,KAAA,CAAA,KAAA,CAAA,kBAAA,SAAA,YAAA,GAAA,YAAA"}

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

@@ -0,0 +1,17 @@
+import { EventCapture } from "../../services/event-capture.mjs";
+import { PluginLogger } from "../../services/plugin-logger.mjs";
+import { Context, Effect, Layer } from "effect";
+
+//#region src/core/plugins/impl/ai-summary/ai-summary-plugin-api.ts
+var AiSummaryPluginApi = class extends Context.Tag("@interfere/plugins/ai-summary/AiSummaryPluginApi")() {};
+const AiSummaryPluginApiLayer = Layer.effect(AiSummaryPluginApi, Effect.gen(function* () {
+	const capture = yield* EventCapture;
+	const logger = yield* PluginLogger;
+	return AiSummaryPluginApi.of({
+		captureSessionSummary: (payload) => capture.capture("session_summary", payload).pipe(Effect.withSpan("plugin.ai.session_summary")),
+		log: { debug: logger.debug }
+	});
+}));
+
+//#endregion
+export { AiSummaryPluginApi, AiSummaryPluginApiLayer };

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

@@ -0,0 +1 @@
+{"version":3,"file":"ai-summary-plugin-api.mjs","names":[],"sources":["../../../../../src/core/plugins/impl/ai-summary/ai-summary-plugin-api.ts"],"sourcesContent":["import { Context, Effect, Layer } from \"effect\";\n\nimport type { EventPayload } from \"../../../events/event-registry.js\";\nimport { EventCapture } from \"../../services/event-capture.js\";\nimport { PluginLogger } from \"../../services/plugin-logger.js\";\n\ntype SessionSummaryPayload = EventPayload<\"session_summary\">;\n\ninterface AiSummaryPluginApiService {\n  readonly captureSessionSummary: (\n    payload: SessionSummaryPayload\n  ) => Effect.Effect<void>;\n  readonly log: {\n    readonly debug: (message: string) => Effect.Effect<void>;\n  };\n}\n\nexport class AiSummaryPluginApi extends Context.Tag(\n  \"@interfere/plugins/ai-summary/AiSummaryPluginApi\"\n)<AiSummaryPluginApi, AiSummaryPluginApiService>() {}\n\nexport const AiSummaryPluginApiLayer = Layer.effect(\n  AiSummaryPluginApi,\n  Effect.gen(function* () {\n    const capture = yield* EventCapture;\n    const logger = yield* PluginLogger;\n\n    return AiSummaryPluginApi.of({\n      captureSessionSummary: (payload) =>\n        capture\n          .capture(\"session_summary\", payload)\n          .pipe(Effect.withSpan(\"plugin.ai.session_summary\")),\n      log: {\n        debug: logger.debug,\n      },\n    });\n  })\n);\n"],"mappings":";;;;;AAiBA,IAAa,qBAAb,cAAwC,QAAQ,IAC9C,mDACD,EAAiD,CAAC;AAEnD,MAAa,0BAA0B,MAAM,OAC3C,oBACA,OAAO,IAAI,aAAa;CACtB,MAAM,UAAU,OAAO;CACvB,MAAM,SAAS,OAAO;AAEtB,QAAO,mBAAmB,GAAG;EAC3B,wBAAwB,YACtB,QACG,QAAQ,mBAAmB,QAAQ,CACnC,KAAK,OAAO,SAAS,4BAA4B,CAAC;EACvD,KAAK,EACH,OAAO,OAAO,OACf;EACF,CAAC;EACF,CACH"}

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

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

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

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

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

@@ -0,0 +1,151 @@
+import { PluginRuntime } from "../../services/plugin-runtime.mjs";
+import { definePlugin } from "../../define-plugin.mjs";
+import { defineEvent } from "../../../events/define-event.mjs";
+import { AiSummaryPluginApi, AiSummaryPluginApiLayer } from "./ai-summary-plugin-api.mjs";
+import { Data, Duration, Effect, Fiber, Ref } from "effect";
+
+//#region src/core/plugins/impl/ai-summary/plugin.ts
+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;
+var AiSummaryCreateFailed = class extends Data.TaggedError("AiSummaryCreateFailed") {};
+var AiSummaryPromptFailed = class extends Data.TaggedError("AiSummaryPromptFailed") {};
+var plugin_default = definePlugin("aiSummary", {
+	name: "aiSummary",
+	events: [defineEvent("session_summary").value()],
+	layer: AiSummaryPluginApiLayer,
+	setup: Effect.gen(function* () {
+		const api = yield* AiSummaryPluginApi;
+		const runtime = yield* PluginRuntime;
+		if (typeof window === "undefined" || typeof document === "undefined" || !("ai" in window) || !window.ai?.summarizer) {
+			yield* api.log.debug("aiSummary: unsupported environment or missing API");
+			return {};
+		}
+		const ai = window.ai;
+		if ((yield* Effect.promise(() => ai.summarizer?.capabilities() ?? Promise.resolve({ available: "no" })))?.available !== "readily") {
+			yield* api.log.debug("aiSummary: summarizer not readily available");
+			return {};
+		}
+		if (!ai.summarizer) {
+			yield* api.log.debug("aiSummary: summarizer missing after capability check");
+			return {};
+		}
+		const isCapturingRef = yield* Ref.make(false);
+		const lastCaptureTimeRef = yield* Ref.make(0);
+		const scheduledFiberRef = yield* Ref.make(null);
+		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);
+		const performSummaryFlow = Effect.fn("AiSummary.performSummaryFlow")((nowTs) => Effect.gen(function* () {
+			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 session = yield* Effect.tryPromise({
+				try: () => summarizer.create(),
+				catch: (cause) => new AiSummaryCreateFailed({
+					message: "AI summarizer create() failed",
+					cause
+				})
+			}).pipe(Effect.catchAll((error) => api.log.debug(`AI summarizer create() failed: ${error.message}`).pipe(Effect.as(null))));
+			if (!session) return;
+			const summary = yield* Effect.tryPromise({
+				try: () => session.prompt(contextualText),
+				catch: (cause) => new AiSummaryPromptFailed({
+					message: "AI summarizer prompt() failed",
+					cause
+				})
+			}).pipe(Effect.catchAll((error) => api.log.debug(`AI summarizer prompt() failed: ${error.message}`).pipe(Effect.as(null))));
+			if (!(typeof summary === "string" && isSummaryMeaningful(summary))) return;
+			yield* api.captureSessionSummary({
+				summary,
+				pageTitle: title,
+				pageUrl: url,
+				contentLength: fullText.length,
+				timestamp: nowTs
+			});
+		}));
+		const captureNow = Effect.fn("AiSummary.captureNow")(function* () {
+			const nowTs = Date.now();
+			const isCapturing = yield* Ref.get(isCapturingRef);
+			const lastCaptureTime = yield* Ref.get(lastCaptureTimeRef);
+			if (isCapturing || nowTs - lastCaptureTime < MIN_CAPTURE_INTERVAL_MS) return;
+			yield* Ref.set(isCapturingRef, true);
+			yield* Ref.set(lastCaptureTimeRef, nowTs);
+			yield* performSummaryFlow(nowTs).pipe(Effect.ensuring(Ref.set(isCapturingRef, false)));
+		});
+		const scheduleCapture = Effect.fn("AiSummary.scheduleCapture")((delayMs) => Effect.gen(function* () {
+			if (yield* Ref.get(isCapturingRef)) return;
+			const previousFiber = yield* Ref.get(scheduledFiberRef);
+			if (previousFiber) yield* Fiber.interrupt(previousFiber);
+			const fiber = yield* Effect.sleep(Duration.millis(delayMs)).pipe(Effect.zipRight(captureNow()), Effect.forkDaemon);
+			yield* Ref.set(scheduledFiberRef, fiber);
+		}));
+		const observer = new MutationObserver(() => {
+			runtime.fork(scheduleCapture(DEBOUNCE_DELAY_MS));
+		});
+		observer.observe(document.body, {
+			childList: true,
+			subtree: true,
+			characterData: false,
+			attributes: false
+		});
+		const handleVisibilityChange = () => {
+			if (document.visibilityState === "visible") runtime.fork(captureNow());
+		};
+		document.addEventListener("visibilitychange", handleVisibilityChange);
+		yield* scheduleCapture(INITIAL_CAPTURE_DELAY_MS);
+		return { cleanup: () => {
+			observer.disconnect();
+			document.removeEventListener("visibilitychange", handleVisibilityChange);
+			runtime.fork(Effect.gen(function* () {
+				const fiber = yield* Ref.get(scheduledFiberRef);
+				if (fiber) {
+					yield* Fiber.interrupt(fiber);
+					yield* Ref.set(scheduledFiberRef, null);
+				}
+			}));
+		} };
+	}).pipe(Effect.withSpan("plugins.aiSummary.setup"))
+});
+
+//#endregion
+export { plugin_default as default };