@cordy/electro 1.2.3 → 1.2.5

package/dist/index.d.mts

@@ -16,90 +16,9 @@ declare enum FeatureStatus {
   ERROR = "error"
 }
 //#endregion
-//#region src/core/view/types.d.ts
-type ViewId = string;
-/** Runtime view registry entry — injected by CLI via __ELECTRO_VIEW_REGISTRY__. */
-interface ViewRegistryEntry {
-  id: ViewId;
-  hasRenderer: boolean;
-  webPreferences?: Record<string, unknown>;
-}
-/** A WebContentsView augmented with `load()` for renderer-linked views. */
-type ElectroView = WebContentsView & {
-  load(): Promise<void>;
-};
-/** Public interface — hides the View class. */
-interface ViewInstance {
-  readonly id: ViewId;
-  /** Create the WebContentsView. Idempotent: returns existing if alive. */
-  create(): ElectroView;
-  /** Return the live ElectroView, or null if not yet created / destroyed. */
-  view(): ElectroView | null;
-  /** Destroy the WebContentsView and clear refs. */
-  destroy(): void;
-}
-//#endregion
-//#region src/core/view/manager.d.ts
-/**
-* ViewManager — global registry for view instances.
-*
-* Views are registered at runtime startup and accessible from any feature.
-* Views are idempotent: `get(id).create()` returns the same instance if alive.
-*/
-declare class ViewManager {
-  private readonly instances;
-  register(view: ViewInstance): void;
-  get(id: ViewId): ViewInstance | null;
-  destroyAll(): void;
-}
-//#endregion
-//#region src/core/window/types.d.ts
-type WindowId = string;
-interface WindowConfig<TApi = void> {
-  id: WindowId;
-  options?: BaseWindowConstructorOptions;
-  api?: (window: BaseWindow) => TApi;
-}
-/** Base window interface (without API methods). */
-interface WindowBase {
-  readonly id: WindowId;
-  /** Create the BaseWindow. Idempotent: returns existing if alive. */
-  create(): BaseWindow;
-  /** The live BaseWindow, or null if not yet created / destroyed. */
-  readonly window: BaseWindow | null;
-  /** Destroy the BaseWindow and clear refs. */
-  destroy(): void;
-}
-/**
-* Public interface — API methods are mixed directly onto the object.
-* Access API methods directly: `window.show()` instead of `window.api?.show()`.
-*/
-type CreatedWindow<TApi = void> = WindowBase & (TApi extends void ? {} : TApi) & {
-  /** @internal Phantom type for API type inference. */readonly __apiType?: TApi;
-};
-/** Type-erased interface for managers. */
-interface WindowInstance {
-  readonly id: WindowId;
-  create(): BaseWindow;
-  readonly window: BaseWindow | null;
-  destroy(): void;
-}
-//#endregion
-//#region src/core/window/manager.d.ts
-/**
-* WindowManager — global registry for window instances.
-*
-* Windows are registered at runtime startup and accessible from any feature.
-*/
-declare class WindowManager {
-  private readonly instances;
-  register(window: WindowInstance): void;
-  get(id: WindowId): WindowInstance | null;
-  destroyAll(): void;
-}
-//#endregion
 //#region src/core/event-bus/types.d.ts
 type EventHandler = (payload: unknown) => void;
+type EventInterceptor = (channel: string, payload: unknown) => void;
 type EventSubscription = {
   channel: string;
   handler: EventHandler;
@@ -129,7 +48,10 @@ interface CreatedEvent<T = void> extends EventInstance {
 //#region src/core/event-bus/event-bus.d.ts
 declare class EventBus {
   private readonly subscriptions;
+  private readonly interceptors;
   publish(channel: string, payload?: unknown): void;
+  /** Register an interceptor that receives every published event. Returns an unsubscribe function. */
+  addInterceptor(fn: EventInterceptor): () => void;
   subscribe(channel: string, handler: EventHandler, ownerId: string): () => void;
   removeByOwner(ownerId: string): void;
 }
@@ -376,6 +298,89 @@ declare class StateMachine<TState extends string> {
   onTransition(cb: TransitionListener<TState>): () => void;
 }
 //#endregion
+//#region src/core/view/types.d.ts
+type ViewId = string;
+/** Runtime view registry entry — injected by CLI via __ELECTRO_VIEW_REGISTRY__. */
+interface ViewRegistryEntry {
+  id: ViewId;
+  hasRenderer: boolean;
+  features?: readonly string[];
+  webPreferences?: Record<string, unknown>;
+}
+/** A WebContentsView augmented with `load()` for renderer-linked views. */
+type ElectroView = WebContentsView & {
+  load(): Promise<void>;
+};
+/** Public interface — hides the View class. */
+interface ViewInstance {
+  readonly id: ViewId;
+  /** Create the WebContentsView. Idempotent: returns existing if alive. */
+  create(): ElectroView;
+  /** Return the live ElectroView, or null if not yet created / destroyed. */
+  view(): ElectroView | null;
+  /** Destroy the WebContentsView and clear refs. */
+  destroy(): void;
+}
+//#endregion
+//#region src/core/view/manager.d.ts
+/**
+* ViewManager — global registry for view instances.
+*
+* Views are registered at runtime startup and accessible from any feature.
+* Views are idempotent: `get(id).create()` returns the same instance if alive.
+*/
+declare class ViewManager {
+  private readonly instances;
+  register(view: ViewInstance): void;
+  get(id: ViewId): ViewInstance | null;
+  destroyAll(): void;
+}
+//#endregion
+//#region src/core/window/types.d.ts
+type WindowId = string;
+interface WindowConfig<TApi = void> {
+  id: WindowId;
+  options?: BaseWindowConstructorOptions;
+  api?: (window: BaseWindow) => TApi;
+}
+/** Base window interface (without API methods). */
+interface WindowBase {
+  readonly id: WindowId;
+  /** Create the BaseWindow. Idempotent: returns existing if alive. */
+  create(): BaseWindow;
+  /** The live BaseWindow, or null if not yet created / destroyed. */
+  readonly window: BaseWindow | null;
+  /** Destroy the BaseWindow and clear refs. */
+  destroy(): void;
+}
+/**
+* Public interface — API methods are mixed directly onto the object.
+* Access API methods directly: `window.show()` instead of `window.api?.show()`.
+*/
+type CreatedWindow<TApi = void> = WindowBase & (TApi extends void ? {} : TApi) & {
+  /** @internal Phantom type for API type inference. */readonly __apiType?: TApi;
+};
+/** Type-erased interface for managers. */
+interface WindowInstance {
+  readonly id: WindowId;
+  create(): BaseWindow;
+  readonly window: BaseWindow | null;
+  destroy(): void;
+}
+//#endregion
+//#region src/core/window/manager.d.ts
+/**
+* WindowManager — global registry for window instances.
+*
+* Windows are registered at runtime startup and accessible from any feature.
+*/
+declare class WindowManager {
+  private readonly instances;
+  register(window: WindowInstance): void;
+  get(id: WindowId): WindowInstance | null;
+  destroyAll(): void;
+}
+//#endregion
 //#region src/core/feature/manager.d.ts
 declare class FeatureManager {
   private logger;
@@ -679,6 +684,28 @@ declare class EventAccessor {
   on(event: string, handler: EventHandler): () => void;
 }
 //#endregion
+//#region src/core/event-bus/bridge.d.ts
+/**
+* Forwards EventBus publishes to renderer views via IPC.
+*
+* Respects deny-by-default policy: only views whose `features` array
+* includes the publishing feature's ID receive the event.
+*
+* IPC channel format: `electro:event:{featureId}:{eventName}`
+*/
+declare class EventBridge {
+  private readonly eventBus;
+  private readonly viewManager;
+  private readonly viewFeatures;
+  private removeInterceptor;
+  constructor(eventBus: EventBus, viewManager: ViewManager, viewRegistry: readonly ViewRegistryEntry[]);
+  /** Start forwarding events to eligible views. */
+  start(): void;
+  /** Stop forwarding and clean up. */
+  stop(): void;
+  private forward;
+}
+//#endregion
 //#region src/core/event-bus/helpers.d.ts
 /**
 * Creates a typed event definition.
@@ -746,6 +773,7 @@ declare class Runtime {
   private readonly eventBus;
   private readonly windowManager;
   private readonly viewManager;
+  private readonly eventBridge;
   constructor(config?: RuntimeConfig);
   register(features: FeatureConfig<any> | FeatureConfig<any>[]): void;
   start(): Promise<void>;
@@ -820,4 +848,4 @@ declare class PolicyEngine {
   getViewNames(): string[];
 }
 //#endregion
-export { type BaseContext, type CreatedEvent, type CreatedService, type CreatedTask, type CreatedWindow, type DefineConfigInput, type DefineRuntimeInput, type DefineViewInput, type ElectroConfig, type ElectroView, EventAccessor, type EventHandler, type EventId, type EventInstance, type EventSubscription, type FeatureConfig, type FeatureContext, type FeatureHandle, type FeatureId, type FeatureMap, FeatureStatus, type LogEntry, type LogHandler, type LoggerContext, PolicyDecision, PolicyEngine, type PolicyResult, Runtime, type RuntimeConfig, type RuntimeDefinition, RuntimeState, type ServiceConfig, type ServiceId, type ServiceInfo, type ServiceOwnerMap, ServiceScope, ServiceStatus, type StopMode, type TaskConfig, type TaskExecutionContext, type TaskHandle, type TaskId, TaskOverlapStrategy, type TaskOwnerMap, TaskRetryStrategy, TaskStatus, type TaskStatusInfo, type TypedContext, type ViewDefinition, type ViewId, type ViewInstance, type ViewMap, type ViewRegistryEntry, type WindowApiMap, type WindowConfig, type WindowId, type WindowInstance, createEvent, createFeature, createRuntime, createService, createTask, createWindow, defineConfig, defineRuntime, defineView };
+export { type BaseContext, type CreatedEvent, type CreatedService, type CreatedTask, type CreatedWindow, type DefineConfigInput, type DefineRuntimeInput, type DefineViewInput, type ElectroConfig, type ElectroView, EventAccessor, EventBridge, type EventHandler, type EventId, type EventInstance, type EventInterceptor, type EventSubscription, type FeatureConfig, type FeatureContext, type FeatureHandle, type FeatureId, type FeatureMap, FeatureStatus, type LogEntry, type LogHandler, type LoggerContext, PolicyDecision, PolicyEngine, type PolicyResult, Runtime, type RuntimeConfig, type RuntimeDefinition, RuntimeState, type ServiceConfig, type ServiceId, type ServiceInfo, type ServiceOwnerMap, ServiceScope, ServiceStatus, type StopMode, type TaskConfig, type TaskExecutionContext, type TaskHandle, type TaskId, TaskOverlapStrategy, type TaskOwnerMap, TaskRetryStrategy, TaskStatus, type TaskStatusInfo, type TypedContext, type ViewDefinition, type ViewId, type ViewInstance, type ViewMap, type ViewRegistryEntry, type WindowApiMap, type WindowConfig, type WindowId, type WindowInstance, createEvent, createFeature, createRuntime, createService, createTask, createWindow, defineConfig, defineRuntime, defineView };

package/dist/index.mjs

@@ -96,6 +96,51 @@ var EventAccessor = class {
 	}
 };
 
+//#endregion
+//#region src/core/event-bus/bridge.ts
+/**
+* Forwards EventBus publishes to renderer views via IPC.
+*
+* Respects deny-by-default policy: only views whose `features` array
+* includes the publishing feature's ID receive the event.
+*
+* IPC channel format: `electro:event:{featureId}:{eventName}`
+*/
+var EventBridge = class {
+	viewFeatures;
+	removeInterceptor = null;
+	constructor(eventBus, viewManager, viewRegistry) {
+		this.eventBus = eventBus;
+		this.viewManager = viewManager;
+		this.viewFeatures = /* @__PURE__ */ new Map();
+		for (const entry of viewRegistry) if (entry.features && entry.features.length > 0) this.viewFeatures.set(entry.id, new Set(entry.features));
+	}
+	/** Start forwarding events to eligible views. */
+	start() {
+		if (this.removeInterceptor) return;
+		this.removeInterceptor = this.eventBus.addInterceptor((channel, payload) => this.forward(channel, payload));
+	}
+	/** Stop forwarding and clean up. */
+	stop() {
+		this.removeInterceptor?.();
+		this.removeInterceptor = null;
+	}
+	forward(channel, payload) {
+		const colonIdx = channel.indexOf(":");
+		if (colonIdx === -1) return;
+		const featureId = channel.slice(0, colonIdx);
+		const ipcChannel = `electro:event:${channel}`;
+		for (const [viewId, allowed] of this.viewFeatures) {
+			if (!allowed.has(featureId)) continue;
+			const view = this.viewManager.get(viewId)?.view();
+			if (!view || view.webContents.isDestroyed()) continue;
+			try {
+				view.webContents.send(ipcChannel, payload);
+			} catch {}
+		}
+	}
+};
+
 //#endregion
 //#region src/core/event-bus/helpers.ts
 function createEvent(id, defaults) {
@@ -154,10 +199,18 @@ let RuntimeState = /* @__PURE__ */ function(RuntimeState) {
 //#region src/core/event-bus/event-bus.ts
 var EventBus = class {
 	subscriptions = /* @__PURE__ */ new Map();
+	interceptors = /* @__PURE__ */ new Set();
 	publish(channel, payload) {
 		const subs = this.subscriptions.get(channel);
-		if (!subs) return;
-		for (const sub of subs) sub.handler(payload);
+		if (subs) for (const sub of subs) sub.handler(payload);
+		for (const interceptor of this.interceptors) interceptor(channel, payload);
+	}
+	/** Register an interceptor that receives every published event. Returns an unsubscribe function. */
+	addInterceptor(fn) {
+		this.interceptors.add(fn);
+		return () => {
+			this.interceptors.delete(fn);
+		};
 	}
 	subscribe(channel, handler, ownerId) {
 		const sub = {
@@ -511,32 +564,33 @@ var Feature = class {
 			initial: FeatureStatus.NONE,
 			name: `feature "${config.id}"`
 		});
+		const fid = config.id;
 		this.context = {
 			getService: () => {
-				throw new Error("Services not yet initialized");
+				throw new Error(`[${fid}] ctx.getService() is not available — feature has not been initialized yet`);
 			},
 			getTask: () => {
-				throw new Error("Tasks not yet initialized");
+				throw new Error(`[${fid}] ctx.getTask() is not available — feature has not been initialized yet`);
 			},
 			getFeature: () => {
-				throw new Error("Features not yet initialized");
+				throw new Error(`[${fid}] ctx.getFeature() is not available — feature has not been initialized yet`);
 			},
 			events: {
 				publish: () => {
-					throw new Error("Events not yet initialized");
+					throw new Error(`[${fid}] ctx.events.publish() is not available — feature has not been initialized yet`);
 				},
 				on: () => {
-					throw new Error("Events not yet initialized");
+					throw new Error(`[${fid}] ctx.events.on() is not available — feature has not been initialized yet`);
 				}
 			},
 			getWindow: () => {
-				throw new Error("Window manager not available");
+				throw new Error(`[${fid}] ctx.getWindow() is not available — feature has not been initialized yet`);
 			},
 			createView: () => {
-				throw new Error("View manager not available");
+				throw new Error(`[${fid}] ctx.createView() is not available — feature has not been initialized yet`);
 			},
 			getView: () => {
-				throw new Error("View manager not available");
+				throw new Error(`[${fid}] ctx.getView() is not available — feature has not been initialized yet`);
 			},
 			logger: this.logger,
 			signal: this.controller.signal
@@ -581,12 +635,6 @@ var Feature = class {
 		for (const dep of features) if (dep.serviceManager) deps.set(dep.id, dep.serviceManager);
 		const accessor = new ServiceAccessor(this.serviceManager, deps);
 		this.context.getService = ((name) => accessor.get(name));
-		this.serviceManager.startup();
-		this.taskManager = new TaskManager(this.context);
-		for (const task of this.config.tasks ?? []) this.taskManager.register(task);
-		this.context.getTask = ((name) => {
-			return new TaskHandle(this.taskManager.getTaskInstance(name), this.context);
-		});
 		const declaredDeps = new Set(this.config.dependencies ?? []);
 		this.context.getFeature = ((name) => {
 			if (!declaredDeps.has(name)) throw new Error(`Feature "${name}" is not a declared dependency of "${this.id}"`);
@@ -624,6 +672,12 @@ var Feature = class {
 				return inst.view();
 			};
 		}
+		this.serviceManager.startup();
+		this.taskManager = new TaskManager(this.context);
+		for (const task of this.config.tasks ?? []) this.taskManager.register(task);
+		this.context.getTask = ((name) => {
+			return new TaskHandle(this.taskManager.getTaskInstance(name), this.context);
+		});
 	}
 };
 
@@ -712,8 +766,9 @@ var FeatureManager = class {
 			feature.transition(FeatureStatus.READY);
 		} catch (err) {
 			feature.transition(FeatureStatus.ERROR);
-			this.logger.error(id, `initialize failed`, { error: err instanceof Error ? err.message : String(err) });
-			if (feature.config.critical) throw new Error(`Critical feature "${id}" failed to initialize`);
+			const message = err instanceof Error ? err.message : String(err);
+			this.logger.error(id, `initialize failed: ${message}`);
+			if (feature.config.critical) throw new Error(`Critical feature "${id}" failed to initialize: ${message}`, { cause: err });
 		}
 	}
 	/**
@@ -738,8 +793,9 @@ var FeatureManager = class {
 			feature.transition(FeatureStatus.ACTIVATED);
 		} catch (err) {
 			feature.transition(FeatureStatus.ERROR);
-			this.logger.error(id, `activate failed`, { error: err instanceof Error ? err.message : String(err) });
-			if (feature.config.critical) throw new Error(`Critical feature "${id}" failed to activate`);
+			const message = err instanceof Error ? err.message : String(err);
+			this.logger.error(id, `activate failed: ${message}`);
+			if (feature.config.critical) throw new Error(`Critical feature "${id}" failed to activate: ${message}`, { cause: err });
 		}
 	}
 	/**
@@ -755,7 +811,8 @@ var FeatureManager = class {
 			feature.transition(FeatureStatus.DEACTIVATED);
 		} catch (err) {
 			feature.transition(FeatureStatus.ERROR);
-			this.logger.error(id, `deactivate failed`, { error: err instanceof Error ? err.message : String(err) });
+			const message = err instanceof Error ? err.message : String(err);
+			this.logger.error(id, `deactivate failed: ${message}`);
 		}
 	}
 	async destroy(id) {
@@ -767,7 +824,8 @@ var FeatureManager = class {
 			feature.transition(FeatureStatus.DESTROYED);
 		} catch (err) {
 			feature.transition(FeatureStatus.ERROR);
-			this.logger.error(id, `destroy failed`, { error: err instanceof Error ? err.message : String(err) });
+			const message = err instanceof Error ? err.message : String(err);
+			this.logger.error(id, `destroy failed: ${message}`);
 		}
 	}
 	/** Public: re-activate a DEACTIVATED or ERROR feature. */
@@ -986,6 +1044,7 @@ var Runtime = class {
 	eventBus;
 	windowManager;
 	viewManager;
+	eventBridge = null;
 	constructor(config) {
 		this.state = new StateMachine({
 			transitions: RUNTIME_TRANSITIONS,
@@ -1002,6 +1061,7 @@ var Runtime = class {
 		this.viewManager = new ViewManager();
 		const viewRegistry = typeof __ELECTRO_VIEW_REGISTRY__ !== "undefined" ? __ELECTRO_VIEW_REGISTRY__ : [];
 		for (const entry of viewRegistry) this.viewManager.register(new View(entry));
+		if (viewRegistry.some((v) => v.features && v.features.length > 0)) this.eventBridge = new EventBridge(this.eventBus, this.viewManager, viewRegistry);
 		this.featureManager.setWindowManager(this.windowManager);
 		this.featureManager.setViewManager(this.viewManager);
 		if (config?.features) this.featureManager.register(config.features);
@@ -1013,9 +1073,11 @@ var Runtime = class {
 	async start() {
 		this.state.transition(RuntimeState.STARTING);
 		try {
+			this.eventBridge?.start();
 			await this.featureManager.bootstrap();
 			this.state.transition(RuntimeState.RUNNING);
 		} catch (err) {
+			this.eventBridge?.stop();
 			this.state.transition(RuntimeState.FAILED);
 			throw err;
 		}
@@ -1023,6 +1085,7 @@ var Runtime = class {
 	async shutdown() {
 		this.state.assertState(RuntimeState.RUNNING);
 		this.state.transition(RuntimeState.STOPPING);
+		this.eventBridge?.stop();
 		await this.featureManager.shutdown();
 		this.viewManager.destroyAll();
 		this.windowManager.destroyAll();
@@ -1619,4 +1682,4 @@ var PolicyEngine = class {
 };
 
 //#endregion
-export { EventAccessor, FeatureStatus, PolicyDecision, PolicyEngine, Runtime, RuntimeState, ServiceScope, ServiceStatus, TaskOverlapStrategy, TaskRetryStrategy, TaskStatus, createEvent, createFeature, createRuntime, createService, createTask, createWindow, defineConfig, defineRuntime, defineView };
+export { EventAccessor, EventBridge, FeatureStatus, PolicyDecision, PolicyEngine, Runtime, RuntimeState, ServiceScope, ServiceStatus, TaskOverlapStrategy, TaskRetryStrategy, TaskStatus, createEvent, createFeature, createRuntime, createService, createTask, createWindow, defineConfig, defineRuntime, defineView };

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@cordy/electro",
-    "version": "1.2.3",
+    "version": "1.2.5",
     "description": "Electron framework — feature-first runtime, codegen, and Vite-based build system",
     "license": "MIT",
     "type": "module",