@cordy/electro 1.2.4 → 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 = {
@@ -991,6 +1044,7 @@ var Runtime = class {
 	eventBus;
 	windowManager;
 	viewManager;
+	eventBridge = null;
 	constructor(config) {
 		this.state = new StateMachine({
 			transitions: RUNTIME_TRANSITIONS,
@@ -1007,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);
@@ -1018,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;
 		}
@@ -1028,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();
@@ -1624,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.4",
+    "version": "1.2.5",
     "description": "Electron framework — feature-first runtime, codegen, and Vite-based build system",
     "license": "MIT",
     "type": "module",