@rotorsoft/act 0.7.0 → 0.9.0

package/dist/index.js

@@ -804,54 +804,21 @@ var Act = class {
       action2,
       target,
       payload,
-      // @ts-expect-error type lost
       reactingTo,
       skipValidation
     );
     this.emit("committed", snapshots);
     return snapshots;
   }
-  /**
-   * Loads the current state snapshot for a specific stream.
-   *
-   * Reconstructs the current state by replaying events from the event store.
-   * Uses snapshots when available to optimize loading performance.
-   *
-   * @template SX - State schema type
-   * @template EX - Event schemas type
-   * @template AX - Action schemas type
-   * @param state - The state definition to load
-   * @param stream - The stream ID (state instance identifier)
-   * @param callback - Optional callback invoked with the loaded snapshot
-   * @returns The current state snapshot for the stream
-   *
-   * @example Load current state
-   * ```typescript
-   * const snapshot = await app.load(Counter, "counter-1");
-   * console.log(snapshot.state.count);    // Current count
-   * console.log(snapshot.version);        // Number of events applied
-   * console.log(snapshot.patches);        // Events since last snapshot
-   * ```
-   *
-   * @example With callback
-   * ```typescript
-   * const snapshot = await app.load(User, "user-123", (snap) => {
-   *   console.log("Loaded user:", snap.state.name);
-   * });
-   * ```
-   *
-   * @example Load multiple states
-   * ```typescript
-   * const [user, account] = await Promise.all([
-   *   app.load(User, "user-123"),
-   *   app.load(BankAccount, "account-456")
-   * ]);
-   * ```
-   *
-   * @see {@link Snapshot} for snapshot structure
-   */
-  async load(state2, stream, callback) {
-    const merged = this._states.get(state2.name) || state2;
+  async load(stateOrName, stream, callback) {
+    let merged;
+    if (typeof stateOrName === "string") {
+      const found = this._states.get(stateOrName);
+      if (!found) throw new Error(`State "${stateOrName}" not found`);
+      merged = found;
+    } else {
+      merged = this._states.get(stateOrName.name) || stateOrName;
+    }
     return await load(merged, stream, callback);
   }
   /**
@@ -964,7 +931,7 @@ var Act = class {
     for (const payload of payloads) {
       const { event, handler, options } = payload;
       try {
-        await handler(event, stream);
+        await handler(event, stream, this);
         at = event.id;
         handled++;
       } catch (error) {
@@ -1077,7 +1044,8 @@ var Act = class {
           );
           fetched.forEach(({ stream, lagging: lagging2, events }) => {
             const payloads = events.flatMap((event) => {
-              const register = this.registry.events[event.name] || [];
+              const register = this.registry.events[event.name];
+              if (!register) return [];
               return [...register.reactions.values()].filter((reaction) => {
                 const resolved = typeof reaction.resolver === "function" ? reaction.resolver(event) : reaction.resolver;
                 return resolved && resolved.target === stream;
@@ -1092,7 +1060,6 @@ var Act = class {
                 retry: 0,
                 lagging: lagging2
               },
-              // @ts-expect-error indexed by key
               payloads
             });
           });
@@ -1309,79 +1276,164 @@ var Act = class {
   }
 };
 
-// src/act-builder.ts
+// src/merge.ts
+import { ZodObject as ZodObject2 } from "zod";
+function baseTypeName(zodType) {
+  let t = zodType;
+  while (typeof t.unwrap === "function") {
+    t = t.unwrap();
+  }
+  return t.constructor.name;
+}
+function mergeSchemas(existing, incoming, stateName) {
+  if (existing instanceof ZodObject2 && incoming instanceof ZodObject2) {
+    const existingShape = existing.shape;
+    const incomingShape = incoming.shape;
+    for (const key of Object.keys(incomingShape)) {
+      if (key in existingShape) {
+        const existingBase = baseTypeName(existingShape[key]);
+        const incomingBase = baseTypeName(incomingShape[key]);
+        if (existingBase !== incomingBase) {
+          throw new Error(
+            `Schema conflict in "${stateName}": key "${key}" has type "${existingBase}" but incoming partial declares "${incomingBase}"`
+          );
+        }
+      }
+    }
+    return existing.extend(incomingShape);
+  }
+  return existing;
+}
+function mergeInits(existing, incoming) {
+  return () => ({ ...existing(), ...incoming() });
+}
+function registerState(state2, states, actions, events) {
+  if (states.has(state2.name)) {
+    const existing = states.get(state2.name);
+    for (const name of Object.keys(state2.actions)) {
+      if (existing.actions[name] === state2.actions[name]) continue;
+      if (actions[name]) throw new Error(`Duplicate action "${name}"`);
+    }
+    for (const name of Object.keys(state2.events)) {
+      if (existing.events[name] === state2.events[name]) continue;
+      if (events[name]) throw new Error(`Duplicate event "${name}"`);
+    }
+    const merged = {
+      ...existing,
+      state: mergeSchemas(existing.state, state2.state, state2.name),
+      init: mergeInits(existing.init, state2.init),
+      events: { ...existing.events, ...state2.events },
+      actions: { ...existing.actions, ...state2.actions },
+      patch: { ...existing.patch, ...state2.patch },
+      on: { ...existing.on, ...state2.on },
+      given: { ...existing.given, ...state2.given },
+      snap: state2.snap || existing.snap
+    };
+    states.set(state2.name, merged);
+    for (const name of Object.keys(merged.actions)) {
+      actions[name] = merged;
+    }
+    for (const name of Object.keys(state2.events)) {
+      if (events[name]) continue;
+      events[name] = {
+        schema: state2.events[name],
+        reactions: /* @__PURE__ */ new Map()
+      };
+    }
+  } else {
+    states.set(state2.name, state2);
+    for (const name of Object.keys(state2.actions)) {
+      if (actions[name]) throw new Error(`Duplicate action "${name}"`);
+      actions[name] = state2;
+    }
+    for (const name of Object.keys(state2.events)) {
+      if (events[name]) throw new Error(`Duplicate event "${name}"`);
+      events[name] = {
+        schema: state2.events[name],
+        reactions: /* @__PURE__ */ new Map()
+      };
+    }
+  }
+}
 var _this_ = ({ stream }) => ({
   source: stream,
   target: stream
 });
 var _void_ = () => void 0;
+
+// src/slice-builder.ts
+function isSlice(x) {
+  return x != null && x._tag === "Slice";
+}
+function slice(states = /* @__PURE__ */ new Map(), actions = {}, events = {}) {
+  const builder = {
+    with: (state2) => {
+      registerState(state2, states, actions, events);
+      return slice(states, actions, events);
+    },
+    on: (event) => ({
+      do: (handler, options) => {
+        const reaction = {
+          handler,
+          resolver: _this_,
+          options: {
+            blockOnError: options?.blockOnError ?? true,
+            maxRetries: options?.maxRetries ?? 3
+          }
+        };
+        const name = handler.name || `${String(event)}_${events[event].reactions.size}`;
+        events[event].reactions.set(name, reaction);
+        return {
+          ...builder,
+          to(resolver) {
+            events[event].reactions.set(name, {
+              ...reaction,
+              resolver: typeof resolver === "string" ? { target: resolver } : resolver
+            });
+            return builder;
+          },
+          void() {
+            events[event].reactions.set(name, {
+              ...reaction,
+              resolver: _void_
+            });
+            return builder;
+          }
+        };
+      }
+    }),
+    build: () => ({
+      _tag: "Slice",
+      states,
+      events
+    }),
+    events
+  };
+  return builder;
+}
+
+// src/act-builder.ts
 function act(states = /* @__PURE__ */ new Map(), registry = {
   actions: {},
   events: {}
 }) {
   const builder = {
-    /**
-     * Adds a state to the builder. When a state with the same name is already
-     * registered, merges the new partial's actions, events, patches, and handlers
-     * into the existing state (errors on duplicate action/event names).
-     *
-     * @template SX The type of state
-     * @template EX The type of events
-     * @template AX The type of actions
-     * @param state The state to add
-     * @returns The builder
-     */
-    with: (state2) => {
-      if (states.has(state2.name)) {
-        const existing = states.get(state2.name);
-        for (const name of Object.keys(state2.actions)) {
-          if (registry.actions[name])
-            throw new Error(`Duplicate action "${name}"`);
+    with: ((input) => {
+      if (isSlice(input)) {
+        for (const s of input.states.values()) {
+          registerState(s, states, registry.actions, registry.events);
         }
-        for (const name of Object.keys(state2.events)) {
-          if (registry.events[name])
-            throw new Error(`Duplicate event "${name}"`);
-        }
-        const merged = {
-          ...existing,
-          events: { ...existing.events, ...state2.events },
-          actions: { ...existing.actions, ...state2.actions },
-          patch: { ...existing.patch, ...state2.patch },
-          on: { ...existing.on, ...state2.on },
-          given: { ...existing.given, ...state2.given },
-          snap: state2.snap || existing.snap
-        };
-        states.set(state2.name, merged);
-        for (const name of Object.keys(merged.actions)) {
-          registry.actions[name] = merged;
-        }
-        for (const name of Object.keys(state2.events)) {
-          registry.events[name] = {
-            schema: state2.events[name],
-            reactions: /* @__PURE__ */ new Map()
-          };
-        }
-      } else {
-        states.set(state2.name, state2);
-        for (const name of Object.keys(state2.actions)) {
-          if (registry.actions[name])
-            throw new Error(`Duplicate action "${name}"`);
-          registry.actions[name] = state2;
-        }
-        for (const name of Object.keys(state2.events)) {
-          if (registry.events[name])
-            throw new Error(`Duplicate event "${name}"`);
-          registry.events[name] = {
-            schema: state2.events[name],
-            reactions: /* @__PURE__ */ new Map()
-          };
+        for (const eventName of Object.keys(input.events)) {
+          const sliceRegister = input.events[eventName];
+          for (const [name, reaction] of sliceRegister.reactions) {
+            registry.events[eventName].reactions.set(name, reaction);
+          }
         }
+        return act(states, registry);
       }
-      return act(
-        states,
-        registry
-      );
-    },
+      registerState(input, states, registry.actions, registry.events);
+      return act(states, registry);
+    }),
     /**
      * Adds a reaction to an event.
      *
@@ -1399,18 +1451,19 @@ function act(states = /* @__PURE__ */ new Map(), registry = {
             maxRetries: options?.maxRetries ?? 3
           }
         };
-        registry.events[event].reactions.set(handler.name, reaction);
+        const name = handler.name || `${String(event)}_${registry.events[event].reactions.size}`;
+        registry.events[event].reactions.set(name, reaction);
         return {
           ...builder,
           to(resolver) {
-            registry.events[event].reactions.set(handler.name, {
+            registry.events[event].reactions.set(name, {
               ...reaction,
               resolver: typeof resolver === "string" ? { target: resolver } : resolver
             });
             return builder;
           },
           void() {
-            registry.events[event].reactions.set(handler.name, {
+            registry.events[event].reactions.set(name, {
               ...reaction,
               resolver: _void_
             });
@@ -1504,10 +1557,12 @@ export {
   dispose,
   disposeAndExit,
   extend,
+  isSlice,
   logger,
   patch,
   port,
   sleep,
+  slice,
   state,
   store,
   validate