effectable 0.1.0

package/build/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Effectable entry point: bootstrap, store, component, connect, runtime.
+ * Re-exports bootstrap, store, component, connect, and runtime for a single entry
+ * (Effectable or selective imports).
+ *
+ * Note on name conflicts:
+ * - UseRef and UseImperativeHandle from runtime/HandleRegistry are for registering
+ *   imperative handles in HandleRegistry (legacy mechanism).
+ * - UseRef and UseImperativeHandle from component/refs are for GraphRuntime
+ *   (fiber-based declarative tree, mounted lifecycle).
+ * To resolve the conflict, the runtime versions are exported with the Handle* alias.
+ *
+ * @module Effectable
+ */
+export * from './bootstrap';
+export * from './store';
+export * from './component';
+export * from './connect';
+export { HandleRegistry, forwardRef, UseRef as HandleRegistryUseRef, UseImperativeHandle as HandleRegistryUseImperativeHandle, } from './runtime/HandleRegistry';
+export { CommandBus } from './runtime/CommandBus';
+export { QueryBus } from './runtime/QueryBus';
+export { EventBus } from './runtime/EventBus';
+export type { RuntimeCommand, RuntimeQuery, RuntimeEvent, RuntimeDispose, CommandHandler, QueryHandler, EventHandler, RuntimeCommandHandlerContract, RuntimeQueryHandlerContract, } from './runtime/types';
+export { UseCommandBus, UseQueryBus, UseEventBus, OnCommand, OnQuery, OnEvent, createRuntimeBuses, wireRuntimeBuses, wireRuntimeBusesIfDecorated, instanceUsesRuntimeBusDecorators, wireRuntimeBusesAll, } from './runtime/BusDecorators';
+export type { RuntimeBusesBundle } from './runtime/BusDecorators';
+//# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAG1B,OAAO,EACL,cAAc,EACd,UAAU,EACV,MAAM,IAAI,oBAAoB,EAC9B,mBAAmB,IAAI,iCAAiC,GACzD,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,YAAY,EACV,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,6BAA6B,EAC7B,2BAA2B,GAC5B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,aAAa,EACb,WAAW,EACX,WAAW,EACX,SAAS,EACT,OAAO,EACP,OAAO,EACP,kBAAkB,EAClB,gBAAgB,EAChB,2BAA2B,EAC3B,gCAAgC,EAChC,mBAAmB,GACpB,MAAM,yBAAyB,CAAC;AACjC,YAAY,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC"}

package/build/index.js

@@ -0,0 +1,60 @@
+"use strict";
+/**
+ * Effectable entry point: bootstrap, store, component, connect, runtime.
+ * Re-exports bootstrap, store, component, connect, and runtime for a single entry
+ * (Effectable or selective imports).
+ *
+ * Note on name conflicts:
+ * - UseRef and UseImperativeHandle from runtime/HandleRegistry are for registering
+ *   imperative handles in HandleRegistry (legacy mechanism).
+ * - UseRef and UseImperativeHandle from component/refs are for GraphRuntime
+ *   (fiber-based declarative tree, mounted lifecycle).
+ * To resolve the conflict, the runtime versions are exported with the Handle* alias.
+ *
+ * @module Effectable
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.wireRuntimeBusesAll = exports.instanceUsesRuntimeBusDecorators = exports.wireRuntimeBusesIfDecorated = exports.wireRuntimeBuses = exports.createRuntimeBuses = exports.OnEvent = exports.OnQuery = exports.OnCommand = exports.UseEventBus = exports.UseQueryBus = exports.UseCommandBus = exports.EventBus = exports.QueryBus = exports.CommandBus = exports.HandleRegistryUseImperativeHandle = exports.HandleRegistryUseRef = exports.forwardRef = exports.HandleRegistry = void 0;
+__exportStar(require("./bootstrap"), exports);
+__exportStar(require("./store"), exports);
+__exportStar(require("./component"), exports);
+__exportStar(require("./connect"), exports);
+// runtime: export with aliases for UseRef/UseImperativeHandle to avoid conflict with component/refs
+var HandleRegistry_1 = require("./runtime/HandleRegistry");
+Object.defineProperty(exports, "HandleRegistry", { enumerable: true, get: function () { return HandleRegistry_1.HandleRegistry; } });
+Object.defineProperty(exports, "forwardRef", { enumerable: true, get: function () { return HandleRegistry_1.forwardRef; } });
+Object.defineProperty(exports, "HandleRegistryUseRef", { enumerable: true, get: function () { return HandleRegistry_1.UseRef; } });
+Object.defineProperty(exports, "HandleRegistryUseImperativeHandle", { enumerable: true, get: function () { return HandleRegistry_1.UseImperativeHandle; } });
+var CommandBus_1 = require("./runtime/CommandBus");
+Object.defineProperty(exports, "CommandBus", { enumerable: true, get: function () { return CommandBus_1.CommandBus; } });
+var QueryBus_1 = require("./runtime/QueryBus");
+Object.defineProperty(exports, "QueryBus", { enumerable: true, get: function () { return QueryBus_1.QueryBus; } });
+var EventBus_1 = require("./runtime/EventBus");
+Object.defineProperty(exports, "EventBus", { enumerable: true, get: function () { return EventBus_1.EventBus; } });
+var BusDecorators_1 = require("./runtime/BusDecorators");
+Object.defineProperty(exports, "UseCommandBus", { enumerable: true, get: function () { return BusDecorators_1.UseCommandBus; } });
+Object.defineProperty(exports, "UseQueryBus", { enumerable: true, get: function () { return BusDecorators_1.UseQueryBus; } });
+Object.defineProperty(exports, "UseEventBus", { enumerable: true, get: function () { return BusDecorators_1.UseEventBus; } });
+Object.defineProperty(exports, "OnCommand", { enumerable: true, get: function () { return BusDecorators_1.OnCommand; } });
+Object.defineProperty(exports, "OnQuery", { enumerable: true, get: function () { return BusDecorators_1.OnQuery; } });
+Object.defineProperty(exports, "OnEvent", { enumerable: true, get: function () { return BusDecorators_1.OnEvent; } });
+Object.defineProperty(exports, "createRuntimeBuses", { enumerable: true, get: function () { return BusDecorators_1.createRuntimeBuses; } });
+Object.defineProperty(exports, "wireRuntimeBuses", { enumerable: true, get: function () { return BusDecorators_1.wireRuntimeBuses; } });
+Object.defineProperty(exports, "wireRuntimeBusesIfDecorated", { enumerable: true, get: function () { return BusDecorators_1.wireRuntimeBusesIfDecorated; } });
+Object.defineProperty(exports, "instanceUsesRuntimeBusDecorators", { enumerable: true, get: function () { return BusDecorators_1.instanceUsesRuntimeBusDecorators; } });
+Object.defineProperty(exports, "wireRuntimeBusesAll", { enumerable: true, get: function () { return BusDecorators_1.wireRuntimeBusesAll; } });
+//# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;GAaG;;;;;;;;;;;;;;;;;AAEH,8CAA4B;AAC5B,0CAAwB;AACxB,8CAA4B;AAC5B,4CAA0B;AAE1B,oGAAoG;AACpG,2DAKkC;AAJhC,gHAAA,cAAc,OAAA;AACd,4GAAA,UAAU,OAAA;AACV,sHAAA,MAAM,OAAwB;AAC9B,mIAAA,mBAAmB,OAAqC;AAE1D,mDAAkD;AAAzC,wGAAA,UAAU,OAAA;AACnB,+CAA8C;AAArC,oGAAA,QAAQ,OAAA;AACjB,+CAA8C;AAArC,oGAAA,QAAQ,OAAA;AAYjB,yDAYiC;AAX/B,8GAAA,aAAa,OAAA;AACb,4GAAA,WAAW,OAAA;AACX,4GAAA,WAAW,OAAA;AACX,0GAAA,SAAS,OAAA;AACT,wGAAA,OAAO,OAAA;AACP,wGAAA,OAAO,OAAA;AACP,mHAAA,kBAAkB,OAAA;AAClB,iHAAA,gBAAgB,OAAA;AAChB,4HAAA,2BAA2B,OAAA;AAC3B,iIAAA,gCAAgC,OAAA;AAChC,oHAAA,mBAAmB,OAAA"}

package/build/runtime/BusDecorators.d.ts

@@ -0,0 +1,113 @@
+/**
+ * Decorators and wiring for CommandBus / QueryBus / EventBus.
+ *
+ * Property: `@UseCommandBus()`, `@UseQueryBus()`, `@UseEventBus()` — inject a bus instance into a field.
+ * Method: `@OnCommand(type)`, `@OnQuery(type)`, `@OnEvent(type)` — register a method as a handler.
+ *
+ * After creating an instance, call `wireRuntimeBuses(instance, buses)`; it returns a disposer.
+ *
+ * @module Effectable/runtime/BusDecorators
+ */
+import 'reflect-metadata';
+import { CommandBus } from './CommandBus';
+import { EventBus } from './EventBus';
+import { QueryBus } from './QueryBus';
+import type { RuntimeCommand, RuntimeEvent, RuntimeQuery } from './types';
+/**
+ * Marks a field for CommandBus instance injection in `wireRuntimeBuses`.
+ *
+ * @returns {PropertyDecorator} property decorator
+ */
+export declare function UseCommandBus(): PropertyDecorator;
+/**
+ * Marks a field for QueryBus instance injection in `wireRuntimeBuses`.
+ *
+ * @returns {PropertyDecorator} property decorator
+ */
+export declare function UseQueryBus(): PropertyDecorator;
+/**
+ * Marks a field for EventBus instance injection in `wireRuntimeBuses`.
+ *
+ * @returns {PropertyDecorator} property decorator
+ */
+export declare function UseEventBus(): PropertyDecorator;
+/**
+ * Registers a method as the sole command handler for the given type (via CommandBus.register).
+ *
+ * @param {string} commandType - string command type
+ * @returns {MethodDecorator} method decorator
+ */
+export declare function OnCommand(commandType: string): MethodDecorator;
+/**
+ * Registers a method as the sole query handler for the given type (via QueryBus.register).
+ *
+ * @param {string} queryType - string query type
+ * @returns {MethodDecorator} method decorator
+ */
+export declare function OnQuery(queryType: string): MethodDecorator;
+/**
+ * Subscribes a method to events of the given type (via EventBus.subscribe).
+ *
+ * @param {string} eventType - string event type
+ * @returns {MethodDecorator} method decorator
+ */
+export declare function OnEvent(eventType: string): MethodDecorator;
+/**
+ * Bundle of three buses of one compatible type family.
+ */
+export interface RuntimeBusesBundle<TCommand extends RuntimeCommand = RuntimeCommand, TQuery extends RuntimeQuery = RuntimeQuery, TEvent extends RuntimeEvent = RuntimeEvent> {
+    commandBus: CommandBus<TCommand>;
+    queryBus: QueryBus<TQuery>;
+    eventBus: EventBus<TEvent>;
+}
+/**
+ * Creates a new bus bundle (without hidden auto-binding to global state).
+ *
+ * @template TCommand
+ * @template TQuery
+ * @template TEvent
+ * @returns {RuntimeBusesBundle<TCommand, TQuery, TEvent>} three new bus instances
+ */
+export declare function createRuntimeBuses<TCommand extends RuntimeCommand = RuntimeCommand, TQuery extends RuntimeQuery = RuntimeQuery, TEvent extends RuntimeEvent = RuntimeEvent>(): RuntimeBusesBundle<TCommand, TQuery, TEvent>;
+/**
+ * Returns true if the instance (or its base classes) has metadata for {@link wireRuntimeBuses}.
+ *
+ * @param {object} instance - component instance
+ * @returns {boolean}
+ */
+export declare function instanceUsesRuntimeBusDecorators(instance: object): boolean;
+/**
+ * Calls {@link wireRuntimeBuses} only if the constructor chain has relevant decorators.
+ *
+ * @template TCommand
+ * @template TQuery
+ * @template TEvent
+ * @param {object} instance - instance
+ * @param {RuntimeBusesBundle<TCommand, TQuery, TEvent>} buses - buses
+ * @returns {(() => void) | null} disposer or null if wiring is not needed
+ */
+export declare function wireRuntimeBusesIfDecorated<TCommand extends RuntimeCommand, TQuery extends RuntimeQuery, TEvent extends RuntimeEvent>(instance: object, buses: RuntimeBusesBundle<TCommand, TQuery, TEvent>): (() => void) | null;
+/**
+ * Injects buses into `@Use*Bus` fields and registers `@OnCommand` / `@OnQuery` / `@OnEvent` handlers.
+ *
+ * @template TCommand
+ * @template TQuery
+ * @template TEvent
+ * @param {object} instance - class instance with decorator metadata
+ * @param {RuntimeBusesBundle<TCommand, TQuery, TEvent>} buses - bus bundle
+ * @returns {() => void} disposer: removes registrations and subscriptions created by this call
+ */
+export declare function wireRuntimeBuses<TCommand extends RuntimeCommand, TQuery extends RuntimeQuery, TEvent extends RuntimeEvent>(instance: object, buses: RuntimeBusesBundle<TCommand, TQuery, TEvent>): () => void;
+/**
+ * Wires multiple instances to one bus bundle: calls {@link wireRuntimeBuses} for each.
+ * Order in `instances` defines wiring order; the disposer unregisters in reverse order.
+ *
+ * @template TCommand
+ * @template TQuery
+ * @template TEvent
+ * @param buses - shared {@link RuntimeBusesBundle} (including the three fields from `BootstrapHandle.runtime`)
+ * @param instances - instances with `@Use*Bus` / `@OnCommand` / `@OnQuery` / `@OnEvent` decorators
+ * @returns {() => void} single disposer for all wiring calls
+ */
+export declare function wireRuntimeBusesAll<TCommand extends RuntimeCommand, TQuery extends RuntimeQuery, TEvent extends RuntimeEvent>(buses: RuntimeBusesBundle<TCommand, TQuery, TEvent>, instances: readonly object[]): () => void;
+//# sourceMappingURL=BusDecorators.d.ts.map

package/build/runtime/BusDecorators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BusDecorators.d.ts","sourceRoot":"","sources":["../../src/runtime/BusDecorators.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,kBAAkB,CAAC;AAE1B,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,KAAK,EAIV,cAAc,EACd,YAAY,EACZ,YAAY,EACb,MAAM,SAAS,CAAC;AA0BjB;;;;GAIG;AACH,wBAAgB,aAAa,IAAK,iBAAiB,CAIlD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,IAAK,iBAAiB,CAIhD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,IAAK,iBAAiB,CAIhD;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAE,WAAW,EAAE,MAAM,GAAG,eAAe,CAO/D;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAE,SAAS,EAAE,MAAM,GAAG,eAAe,CAO3D;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAE,SAAS,EAAE,MAAM,GAAG,eAAe,CAO3D;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB,CACjC,QAAQ,SAAS,cAAc,GAAG,cAAc,EAChD,MAAM,SAAS,YAAY,GAAG,YAAY,EAC1C,MAAM,SAAS,YAAY,GAAG,YAAY;IAE1C,UAAU,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC;IACjC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC3B,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;CAC5B;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,SAAS,cAAc,GAAG,cAAc,EAChD,MAAM,SAAS,YAAY,GAAG,YAAY,EAC1C,MAAM,SAAS,YAAY,GAAG,YAAY,KACtC,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,CAMjD;AAqCD;;;;;GAKG;AACH,wBAAgB,gCAAgC,CAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAkB3E;AAED;;;;;;;;;GASG;AACH,wBAAgB,2BAA2B,CACzC,QAAQ,SAAS,cAAc,EAC/B,MAAM,SAAS,YAAY,EAC3B,MAAM,SAAS,YAAY,EAE3B,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,GAClD,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAMrB;AAeD;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,SAAS,cAAc,EAC/B,MAAM,SAAS,YAAY,EAC3B,MAAM,SAAS,YAAY,EAE3B,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,GAClD,MAAM,IAAI,CAsEZ;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,SAAS,cAAc,EAC/B,MAAM,SAAS,YAAY,EAC3B,MAAM,SAAS,YAAY,EAE3B,KAAK,EAAE,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EACnD,SAAS,EAAE,SAAS,MAAM,EAAE,GAC3B,MAAM,IAAI,CAWZ"}

package/build/runtime/BusDecorators.js

@@ -0,0 +1,302 @@
+"use strict";
+/**
+ * Decorators and wiring for CommandBus / QueryBus / EventBus.
+ *
+ * Property: `@UseCommandBus()`, `@UseQueryBus()`, `@UseEventBus()` — inject a bus instance into a field.
+ * Method: `@OnCommand(type)`, `@OnQuery(type)`, `@OnEvent(type)` — register a method as a handler.
+ *
+ * After creating an instance, call `wireRuntimeBuses(instance, buses)`; it returns a disposer.
+ *
+ * @module Effectable/runtime/BusDecorators
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UseCommandBus = UseCommandBus;
+exports.UseQueryBus = UseQueryBus;
+exports.UseEventBus = UseEventBus;
+exports.OnCommand = OnCommand;
+exports.OnQuery = OnQuery;
+exports.OnEvent = OnEvent;
+exports.createRuntimeBuses = createRuntimeBuses;
+exports.instanceUsesRuntimeBusDecorators = instanceUsesRuntimeBusDecorators;
+exports.wireRuntimeBusesIfDecorated = wireRuntimeBusesIfDecorated;
+exports.wireRuntimeBuses = wireRuntimeBuses;
+exports.wireRuntimeBusesAll = wireRuntimeBusesAll;
+require("reflect-metadata");
+const CommandBus_1 = require("./CommandBus");
+const EventBus_1 = require("./EventBus");
+const QueryBus_1 = require("./QueryBus");
+const USE_COMMAND_BUS_PROPS = 'effectable:runtime:UseCommandBus:props';
+const USE_QUERY_BUS_PROPS = 'effectable:runtime:UseQueryBus:props';
+const USE_EVENT_BUS_PROPS = 'effectable:runtime:UseEventBus:props';
+const ON_COMMAND_ENTRIES = 'effectable:runtime:OnCommand:entries';
+const ON_QUERY_ENTRIES = 'effectable:runtime:OnQuery:entries';
+const ON_EVENT_ENTRIES = 'effectable:runtime:OnEvent:entries';
+function appendPropKey(ctor, metaKey, propertyKey) {
+    const key = String(propertyKey);
+    const current = Reflect.getMetadata(metaKey, ctor);
+    const next = typeof current === 'undefined' ? [key] : [...current, key];
+    Reflect.defineMetadata(metaKey, next, ctor);
+}
+function appendHandlerEntry(ctor, metaKey, entry) {
+    const current = Reflect.getMetadata(metaKey, ctor);
+    const next = typeof current === 'undefined' ? [entry] : [...current, entry];
+    Reflect.defineMetadata(metaKey, next, ctor);
+}
+/**
+ * Marks a field for CommandBus instance injection in `wireRuntimeBuses`.
+ *
+ * @returns {PropertyDecorator} property decorator
+ */
+function UseCommandBus() {
+    return (target, propertyKey) => {
+        appendPropKey(target.constructor, USE_COMMAND_BUS_PROPS, propertyKey);
+    };
+}
+/**
+ * Marks a field for QueryBus instance injection in `wireRuntimeBuses`.
+ *
+ * @returns {PropertyDecorator} property decorator
+ */
+function UseQueryBus() {
+    return (target, propertyKey) => {
+        appendPropKey(target.constructor, USE_QUERY_BUS_PROPS, propertyKey);
+    };
+}
+/**
+ * Marks a field for EventBus instance injection in `wireRuntimeBuses`.
+ *
+ * @returns {PropertyDecorator} property decorator
+ */
+function UseEventBus() {
+    return (target, propertyKey) => {
+        appendPropKey(target.constructor, USE_EVENT_BUS_PROPS, propertyKey);
+    };
+}
+/**
+ * Registers a method as the sole command handler for the given type (via CommandBus.register).
+ *
+ * @param {string} commandType - string command type
+ * @returns {MethodDecorator} method decorator
+ */
+function OnCommand(commandType) {
+    return (target, propertyKey) => {
+        appendHandlerEntry(target.constructor, ON_COMMAND_ENTRIES, {
+            type: commandType,
+            method: String(propertyKey),
+        });
+    };
+}
+/**
+ * Registers a method as the sole query handler for the given type (via QueryBus.register).
+ *
+ * @param {string} queryType - string query type
+ * @returns {MethodDecorator} method decorator
+ */
+function OnQuery(queryType) {
+    return (target, propertyKey) => {
+        appendHandlerEntry(target.constructor, ON_QUERY_ENTRIES, {
+            type: queryType,
+            method: String(propertyKey),
+        });
+    };
+}
+/**
+ * Subscribes a method to events of the given type (via EventBus.subscribe).
+ *
+ * @param {string} eventType - string event type
+ * @returns {MethodDecorator} method decorator
+ */
+function OnEvent(eventType) {
+    return (target, propertyKey) => {
+        appendHandlerEntry(target.constructor, ON_EVENT_ENTRIES, {
+            type: eventType,
+            method: String(propertyKey),
+        });
+    };
+}
+/**
+ * Creates a new bus bundle (without hidden auto-binding to global state).
+ *
+ * @template TCommand
+ * @template TQuery
+ * @template TEvent
+ * @returns {RuntimeBusesBundle<TCommand, TQuery, TEvent>} three new bus instances
+ */
+function createRuntimeBuses() {
+    return {
+        commandBus: new CommandBus_1.CommandBus(),
+        queryBus: new QueryBus_1.QueryBus(),
+        eventBus: new EventBus_1.EventBus(),
+    };
+}
+function getStringPropKeys(ctor, metaKey) {
+    const own = Reflect.getMetadata(metaKey, ctor);
+    return typeof own === 'undefined' ? [] : [...own];
+}
+function getHandlerEntries(ctor, metaKey) {
+    const own = Reflect.getMetadata(metaKey, ctor);
+    return typeof own === 'undefined' ? [] : [...own];
+}
+/**
+ * Constructor chain from leaf (instance.constructor) to base (prototype chain of functions).
+ * Needed for `connect` HOC: decorator metadata often lives on the base class while the instance is a subclass.
+ *
+ * @param {Function} leafCtor - instance constructor (subclass)
+ * @returns {Function[]} leaf-first: [Child, Parent, ...]
+ */
+function getConstructorChainLeafFirst(leafCtor) {
+    const chain = [];
+    const seen = new Set();
+    let current = leafCtor;
+    while (current != null && typeof current === 'function' && !seen.has(current)) {
+        seen.add(current);
+        chain.push(current);
+        const next = Object.getPrototypeOf(current);
+        if (typeof next !== 'function' || next === null) {
+            break;
+        }
+        current = next;
+    }
+    return chain;
+}
+/**
+ * Returns true if the instance (or its base classes) has metadata for {@link wireRuntimeBuses}.
+ *
+ * @param {object} instance - component instance
+ * @returns {boolean}
+ */
+function instanceUsesRuntimeBusDecorators(instance) {
+    const leafCtor = instance.constructor;
+    const chain = getConstructorChainLeafFirst(leafCtor);
+    for (const ctor of chain) {
+        if (getStringPropKeys(ctor, USE_COMMAND_BUS_PROPS).length > 0 ||
+            getStringPropKeys(ctor, USE_QUERY_BUS_PROPS).length > 0 ||
+            getStringPropKeys(ctor, USE_EVENT_BUS_PROPS).length > 0 ||
+            getHandlerEntries(ctor, ON_COMMAND_ENTRIES).length > 0 ||
+            getHandlerEntries(ctor, ON_QUERY_ENTRIES).length > 0 ||
+            getHandlerEntries(ctor, ON_EVENT_ENTRIES).length > 0) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * Calls {@link wireRuntimeBuses} only if the constructor chain has relevant decorators.
+ *
+ * @template TCommand
+ * @template TQuery
+ * @template TEvent
+ * @param {object} instance - instance
+ * @param {RuntimeBusesBundle<TCommand, TQuery, TEvent>} buses - buses
+ * @returns {(() => void) | null} disposer or null if wiring is not needed
+ */
+function wireRuntimeBusesIfDecorated(instance, buses) {
+    if (!instanceUsesRuntimeBusDecorators(instance)) {
+        return null;
+    }
+    return wireRuntimeBuses(instance, buses);
+}
+function assignBusProps(instance, ctor, metaKey, value) {
+    const keys = getStringPropKeys(ctor, metaKey);
+    const record = instance;
+    for (const key of keys) {
+        record[key] = value;
+    }
+}
+/**
+ * Injects buses into `@Use*Bus` fields and registers `@OnCommand` / `@OnQuery` / `@OnEvent` handlers.
+ *
+ * @template TCommand
+ * @template TQuery
+ * @template TEvent
+ * @param {object} instance - class instance with decorator metadata
+ * @param {RuntimeBusesBundle<TCommand, TQuery, TEvent>} buses - bus bundle
+ * @returns {() => void} disposer: removes registrations and subscriptions created by this call
+ */
+function wireRuntimeBuses(instance, buses) {
+    const leafCtor = instance.constructor;
+    const ctorChain = getConstructorChainLeafFirst(leafCtor);
+    const disposers = [];
+    // Base → leaf: last assign wins when field names collide.
+    for (let i = ctorChain.length - 1; i >= 0; i -= 1) {
+        const ctor = ctorChain[i];
+        assignBusProps(instance, ctor, USE_COMMAND_BUS_PROPS, buses.commandBus);
+        assignBusProps(instance, ctor, USE_QUERY_BUS_PROPS, buses.queryBus);
+        assignBusProps(instance, ctor, USE_EVENT_BUS_PROPS, buses.eventBus);
+    }
+    const mergedCommand = new Map();
+    const mergedQuery = new Map();
+    const mergedEvent = new Map();
+    for (let i = ctorChain.length - 1; i >= 0; i -= 1) {
+        const ctor = ctorChain[i];
+        for (const { type, method } of getHandlerEntries(ctor, ON_COMMAND_ENTRIES)) {
+            mergedCommand.set(type, method);
+        }
+        for (const { type, method } of getHandlerEntries(ctor, ON_QUERY_ENTRIES)) {
+            mergedQuery.set(type, method);
+        }
+        for (const { type, method } of getHandlerEntries(ctor, ON_EVENT_ENTRIES)) {
+            mergedEvent.set(type, method);
+        }
+    }
+    const record = instance;
+    for (const [type, method] of mergedCommand) {
+        const raw = record[method];
+        if (typeof raw !== 'function') {
+            throw new Error(`wireRuntimeBuses: OnCommand handler is not a function: ${method}`);
+        }
+        const handler = (command) => {
+            return raw.call(instance, command);
+        };
+        disposers.push(buses.commandBus.register(type, handler));
+    }
+    for (const [type, method] of mergedQuery) {
+        const raw = record[method];
+        if (typeof raw !== 'function') {
+            throw new Error(`wireRuntimeBuses: OnQuery handler is not a function: ${method}`);
+        }
+        const handler = (query) => {
+            return raw.call(instance, query);
+        };
+        disposers.push(buses.queryBus.register(type, handler));
+    }
+    for (const [type, method] of mergedEvent) {
+        const raw = record[method];
+        if (typeof raw !== 'function') {
+            throw new Error(`wireRuntimeBuses: OnEvent handler is not a function: ${method}`);
+        }
+        const handler = (event) => {
+            raw.call(instance, event);
+        };
+        disposers.push(buses.eventBus.subscribe(type, handler));
+    }
+    return () => {
+        for (const dispose of disposers.reverse()) {
+            dispose();
+        }
+    };
+}
+/**
+ * Wires multiple instances to one bus bundle: calls {@link wireRuntimeBuses} for each.
+ * Order in `instances` defines wiring order; the disposer unregisters in reverse order.
+ *
+ * @template TCommand
+ * @template TQuery
+ * @template TEvent
+ * @param buses - shared {@link RuntimeBusesBundle} (including the three fields from `BootstrapHandle.runtime`)
+ * @param instances - instances with `@Use*Bus` / `@OnCommand` / `@OnQuery` / `@OnEvent` decorators
+ * @returns {() => void} single disposer for all wiring calls
+ */
+function wireRuntimeBusesAll(buses, instances) {
+    const disposers = [];
+    for (let i = 0; i < instances.length; i += 1) {
+        const instance = instances[i];
+        disposers.push(wireRuntimeBuses(instance, buses));
+    }
+    return () => {
+        for (let j = disposers.length - 1; j >= 0; j -= 1) {
+            disposers[j]();
+        }
+    };
+}
+//# sourceMappingURL=BusDecorators.js.map

package/build/runtime/BusDecorators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BusDecorators.js","sourceRoot":"","sources":["../../src/runtime/BusDecorators.ts"],"names":[],"mappings":"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"}

package/build/runtime/CommandBus.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Lightweight command bus implementation.
+ *
+ * @module Effectable/runtime/CommandBus
+ */
+import type { CommandHandler, RuntimeCommand } from './types';
+/**
+ * Command bus with a single handler per command type.
+ */
+export declare class CommandBus<TCommand extends RuntimeCommand = RuntimeCommand> {
+    private readonly handlers;
+    /**
+     * Registers a command handler.
+     *
+     * @param {TCommand['type']} commandType - command type
+     * @param {CommandHandler<TCommand, TResult>} handler - command handler
+     * @returns {() => void} unregister function
+     * @throws {Error} if a handler is already registered
+     */
+    register<TResult>(commandType: TCommand['type'], handler: CommandHandler<TCommand, TResult>): () => void;
+    /**
+     * Executes a command through the registered handler.
+     *
+     * @param {TCommand} command - command
+     * @returns {Promise<TResult>} command handling result
+     * @throws {Error} if no handler is found
+     */
+    execute<TResult>(command: TCommand): Promise<TResult>;
+    /**
+     * Unregisters a command handler.
+     *
+     * @param {TCommand['type']} commandType - command type
+     * @returns {void}
+     */
+    unregister(commandType: TCommand['type']): void;
+    /**
+     * Clears all registered handlers.
+     *
+     * @returns {void}
+     */
+    clear(): void;
+}
+//# sourceMappingURL=CommandBus.d.ts.map

package/build/runtime/CommandBus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CommandBus.d.ts","sourceRoot":"","sources":["../../src/runtime/CommandBus.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9D;;GAEG;AACH,qBAAa,UAAU,CAAC,QAAQ,SAAS,cAAc,GAAG,cAAc;IACtE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAwD;IAEjF;;;;;;;OAOG;IACI,QAAQ,CAAC,OAAO,EACrB,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,EAC7B,OAAO,EAAE,cAAc,CAAC,QAAQ,EAAE,OAAO,CAAC,GACzC,MAAM,IAAI;IAWb;;;;;;OAMG;IACU,OAAO,CAAC,OAAO,EAAG,OAAO,EAAE,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC;IAUnE;;;;;OAKG;IACI,UAAU,CAAE,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,IAAI;IAIvD;;;;OAIG;IACI,KAAK,IAAK,IAAI;CAGtB"}

package/build/runtime/CommandBus.js

@@ -0,0 +1,65 @@
+"use strict";
+/**
+ * Lightweight command bus implementation.
+ *
+ * @module Effectable/runtime/CommandBus
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CommandBus = void 0;
+/**
+ * Command bus with a single handler per command type.
+ */
+class CommandBus {
+    handlers = new Map();
+    /**
+     * Registers a command handler.
+     *
+     * @param {TCommand['type']} commandType - command type
+     * @param {CommandHandler<TCommand, TResult>} handler - command handler
+     * @returns {() => void} unregister function
+     * @throws {Error} if a handler is already registered
+     */
+    register(commandType, handler) {
+        if (this.handlers.has(commandType)) {
+            throw new Error(`Command handler is already registered: ${commandType}`);
+        }
+        this.handlers.set(commandType, handler);
+        return () => {
+            this.unregister(commandType);
+        };
+    }
+    /**
+     * Executes a command through the registered handler.
+     *
+     * @param {TCommand} command - command
+     * @returns {Promise<TResult>} command handling result
+     * @throws {Error} if no handler is found
+     */
+    async execute(command) {
+        const handler = this.handlers.get(command.type);
+        if (typeof handler === 'undefined') {
+            throw new Error(`Command handler is not registered: ${command.type}`);
+        }
+        const result = await handler(command);
+        return result;
+    }
+    /**
+     * Unregisters a command handler.
+     *
+     * @param {TCommand['type']} commandType - command type
+     * @returns {void}
+     */
+    unregister(commandType) {
+        this.handlers.delete(commandType);
+    }
+    /**
+     * Clears all registered handlers.
+     *
+     * @returns {void}
+     */
+    clear() {
+        this.handlers.clear();
+    }
+}
+exports.CommandBus = CommandBus;
+//# sourceMappingURL=CommandBus.js.map

package/build/runtime/CommandBus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CommandBus.js","sourceRoot":"","sources":["../../src/runtime/CommandBus.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAIH;;GAEG;AACH,MAAa,UAAU;IACJ,QAAQ,GAAG,IAAI,GAAG,EAA6C,CAAC;IAEjF;;;;;;;OAOG;IACI,QAAQ,CACb,WAA6B,EAC7B,OAA0C;QAE1C,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;YACnC,MAAM,IAAI,KAAK,CAAC,0CAA0C,WAAW,EAAE,CAAC,CAAC;QAC3E,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,EAAE,OAA4C,CAAC,CAAC;QAC7E,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;QAC/B,CAAC,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACI,KAAK,CAAC,OAAO,CAAW,OAAiB;QAC9C,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAChD,IAAI,OAAO,OAAO,KAAK,WAAW,EAAE,CAAC;YACnC,MAAM,IAAI,KAAK,CAAC,sCAAsC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;QACxE,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;QACtC,OAAO,MAAiB,CAAC;IAC3B,CAAC;IAED;;;;;OAKG;IACI,UAAU,CAAE,WAA6B;QAC9C,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IACpC,CAAC;IAED;;;;OAIG;IACI,KAAK;QACV,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;CACF;AA5DD,gCA4DC"}