@almadar/ui 4.29.1 → 4.31.0

package/dist/avl/index.cjs

@@ -49005,7 +49005,7 @@ init_logger();
 
 // runtime/createClientEffectHandlers.ts
 function createClientEffectHandlers(options) {
-  const { eventBus, slotSetter, navigate, notify } = options;
+  const { eventBus, slotSetter, navigate, notify, callService } = options;
   return {
     emit: (event, payload) => {
       const prefixedEvent = event.startsWith("UI:") ? event : `UI:${event}`;
@@ -49017,9 +49017,24 @@ function createClientEffectHandlers(options) {
     set: () => {
       console.warn("[ClientEffectHandlers] set is server-side only, ignored on client");
     },
-    callService: async () => {
-      console.warn("[ClientEffectHandlers] callService is server-side only, ignored on client");
-      return {};
+    callService: async (service, action, params) => {
+      if (callService) return callService(service, action, params);
+      const mockId = `mock_${service}_${action}_${Math.random().toString(36).slice(2, 10)}`;
+      const paramsEcho = {};
+      if (params) {
+        for (const [k, v] of Object.entries(params)) {
+          if (v !== void 0 && (typeof v === "string" || typeof v === "number" || typeof v === "boolean" || v === null || v instanceof Date)) {
+            paramsEcho[k] = v;
+          }
+        }
+      }
+      return {
+        id: mockId,
+        clientSecret: `secret_${mockId}`,
+        success: true,
+        status: "succeeded",
+        ...paramsEcho
+      };
     },
     renderUI: (slot, pattern, props) => {
       if (pattern === null) {
@@ -49325,7 +49340,18 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
       orbitalsByTrait: JSON.stringify(orbitalsByTrait ?? null)
     });
     const bindingMap = new Map(bindings.map((b) => [b.trait.name, b]));
-    const results = currentManager.sendEvent(normalizedEvent, payload);
+    const entityByTrait = {};
+    for (const [name, fields] of traitFieldStatesRef.current) {
+      if (fields && Object.keys(fields).length > 0) {
+        entityByTrait[name] = fields;
+      }
+    }
+    const results = currentManager.sendEvent(
+      normalizedEvent,
+      payload,
+      void 0,
+      entityByTrait
+    );
     crossTraitLog.debug("processEvent:results", {
       event: normalizedEvent,
       executedCount: results.length,
@@ -49391,7 +49417,8 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
             }
           },
           navigate: optionsRef.current?.navigate,
-          notify: optionsRef.current?.notify
+          notify: optionsRef.current?.notify,
+          callService: optionsRef.current?.callService
         });
         const persistence = optionsRef.current?.persistence;
         let handlers = clientHandlers;

package/dist/avl/index.js

@@ -48959,7 +48959,7 @@ init_logger();
 
 // runtime/createClientEffectHandlers.ts
 function createClientEffectHandlers(options) {
-  const { eventBus, slotSetter, navigate, notify } = options;
+  const { eventBus, slotSetter, navigate, notify, callService } = options;
   return {
     emit: (event, payload) => {
       const prefixedEvent = event.startsWith("UI:") ? event : `UI:${event}`;
@@ -48971,9 +48971,24 @@ function createClientEffectHandlers(options) {
     set: () => {
       console.warn("[ClientEffectHandlers] set is server-side only, ignored on client");
     },
-    callService: async () => {
-      console.warn("[ClientEffectHandlers] callService is server-side only, ignored on client");
-      return {};
+    callService: async (service, action, params) => {
+      if (callService) return callService(service, action, params);
+      const mockId = `mock_${service}_${action}_${Math.random().toString(36).slice(2, 10)}`;
+      const paramsEcho = {};
+      if (params) {
+        for (const [k, v] of Object.entries(params)) {
+          if (v !== void 0 && (typeof v === "string" || typeof v === "number" || typeof v === "boolean" || v === null || v instanceof Date)) {
+            paramsEcho[k] = v;
+          }
+        }
+      }
+      return {
+        id: mockId,
+        clientSecret: `secret_${mockId}`,
+        success: true,
+        status: "succeeded",
+        ...paramsEcho
+      };
     },
     renderUI: (slot, pattern, props) => {
       if (pattern === null) {
@@ -49279,7 +49294,18 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
       orbitalsByTrait: JSON.stringify(orbitalsByTrait ?? null)
     });
     const bindingMap = new Map(bindings.map((b) => [b.trait.name, b]));
-    const results = currentManager.sendEvent(normalizedEvent, payload);
+    const entityByTrait = {};
+    for (const [name, fields] of traitFieldStatesRef.current) {
+      if (fields && Object.keys(fields).length > 0) {
+        entityByTrait[name] = fields;
+      }
+    }
+    const results = currentManager.sendEvent(
+      normalizedEvent,
+      payload,
+      void 0,
+      entityByTrait
+    );
     crossTraitLog.debug("processEvent:results", {
       event: normalizedEvent,
       executedCount: results.length,
@@ -49345,7 +49371,8 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
             }
           },
           navigate: optionsRef.current?.navigate,
-          notify: optionsRef.current?.notify
+          notify: optionsRef.current?.notify,
+          callService: optionsRef.current?.callService
         });
         const persistence = optionsRef.current?.persistence;
         let handlers = clientHandlers;

package/dist/runtime/createClientEffectHandlers.d.ts

@@ -5,7 +5,7 @@
  *
  * @packageDocumentation
  */
-import type { EventPayload } from '@almadar/core';
+import type { EventPayload, ServiceParams } from '@almadar/core';
 import type { EffectHandlers } from '@almadar/runtime';
 export interface ClientEventBus {
     emit: (type: string, payload?: EventPayload) => void;
@@ -19,5 +19,13 @@ export interface CreateClientEffectHandlersOptions {
     slotSetter: SlotSetter;
     navigate?: (path: string, params?: Record<string, unknown>) => void;
     notify?: (message: string, type: 'success' | 'error' | 'warning' | 'info') => void;
+    /**
+     * Optional consumer-supplied call-service handler. When set, it runs
+     * instead of the default mock fallback — use to wire the playground
+     * to real backends. When omitted, `callService` returns a synthetic
+     * mock result so service-atom chains advance end-to-end in offline /
+     * standalone-preview mode (see OrbitalServerRuntime's mock parallel).
+     */
+    callService?: (service: string, action: string, params?: ServiceParams) => Promise<unknown>;
 }
 export declare function createClientEffectHandlers(options: CreateClientEffectHandlersOptions): EffectHandlers;

package/dist/runtime/index.cjs

@@ -35397,7 +35397,7 @@ init_logger();
 
 // runtime/createClientEffectHandlers.ts
 function createClientEffectHandlers(options) {
-  const { eventBus, slotSetter, navigate, notify } = options;
+  const { eventBus, slotSetter, navigate, notify, callService } = options;
   return {
     emit: (event, payload) => {
       const prefixedEvent = event.startsWith("UI:") ? event : `UI:${event}`;
@@ -35409,9 +35409,24 @@ function createClientEffectHandlers(options) {
     set: () => {
       console.warn("[ClientEffectHandlers] set is server-side only, ignored on client");
     },
-    callService: async () => {
-      console.warn("[ClientEffectHandlers] callService is server-side only, ignored on client");
-      return {};
+    callService: async (service, action, params) => {
+      if (callService) return callService(service, action, params);
+      const mockId = `mock_${service}_${action}_${Math.random().toString(36).slice(2, 10)}`;
+      const paramsEcho = {};
+      if (params) {
+        for (const [k, v] of Object.entries(params)) {
+          if (v !== void 0 && (typeof v === "string" || typeof v === "number" || typeof v === "boolean" || v === null || v instanceof Date)) {
+            paramsEcho[k] = v;
+          }
+        }
+      }
+      return {
+        id: mockId,
+        clientSecret: `secret_${mockId}`,
+        success: true,
+        status: "succeeded",
+        ...paramsEcho
+      };
     },
     renderUI: (slot, pattern, props) => {
       if (pattern === null) {
@@ -35828,7 +35843,18 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
       orbitalsByTrait: JSON.stringify(orbitalsByTrait ?? null)
     });
     const bindingMap = new Map(bindings.map((b) => [b.trait.name, b]));
-    const results = currentManager.sendEvent(normalizedEvent, payload);
+    const entityByTrait = {};
+    for (const [name, fields] of traitFieldStatesRef.current) {
+      if (fields && Object.keys(fields).length > 0) {
+        entityByTrait[name] = fields;
+      }
+    }
+    const results = currentManager.sendEvent(
+      normalizedEvent,
+      payload,
+      void 0,
+      entityByTrait
+    );
     crossTraitLog.debug("processEvent:results", {
       event: normalizedEvent,
       executedCount: results.length,
@@ -35894,7 +35920,8 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
             }
           },
           navigate: optionsRef.current?.navigate,
-          notify: optionsRef.current?.notify
+          notify: optionsRef.current?.notify,
+          callService: optionsRef.current?.callService
         });
         const persistence = optionsRef.current?.persistence;
         let handlers = clientHandlers;

package/dist/runtime/index.js

@@ -35352,7 +35352,7 @@ init_logger();
 
 // runtime/createClientEffectHandlers.ts
 function createClientEffectHandlers(options) {
-  const { eventBus, slotSetter, navigate, notify } = options;
+  const { eventBus, slotSetter, navigate, notify, callService } = options;
   return {
     emit: (event, payload) => {
       const prefixedEvent = event.startsWith("UI:") ? event : `UI:${event}`;
@@ -35364,9 +35364,24 @@ function createClientEffectHandlers(options) {
     set: () => {
       console.warn("[ClientEffectHandlers] set is server-side only, ignored on client");
     },
-    callService: async () => {
-      console.warn("[ClientEffectHandlers] callService is server-side only, ignored on client");
-      return {};
+    callService: async (service, action, params) => {
+      if (callService) return callService(service, action, params);
+      const mockId = `mock_${service}_${action}_${Math.random().toString(36).slice(2, 10)}`;
+      const paramsEcho = {};
+      if (params) {
+        for (const [k, v] of Object.entries(params)) {
+          if (v !== void 0 && (typeof v === "string" || typeof v === "number" || typeof v === "boolean" || v === null || v instanceof Date)) {
+            paramsEcho[k] = v;
+          }
+        }
+      }
+      return {
+        id: mockId,
+        clientSecret: `secret_${mockId}`,
+        success: true,
+        status: "succeeded",
+        ...paramsEcho
+      };
     },
     renderUI: (slot, pattern, props) => {
       if (pattern === null) {
@@ -35783,7 +35798,18 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
       orbitalsByTrait: JSON.stringify(orbitalsByTrait ?? null)
     });
     const bindingMap = new Map(bindings.map((b) => [b.trait.name, b]));
-    const results = currentManager.sendEvent(normalizedEvent, payload);
+    const entityByTrait = {};
+    for (const [name, fields] of traitFieldStatesRef.current) {
+      if (fields && Object.keys(fields).length > 0) {
+        entityByTrait[name] = fields;
+      }
+    }
+    const results = currentManager.sendEvent(
+      normalizedEvent,
+      payload,
+      void 0,
+      entityByTrait
+    );
     crossTraitLog.debug("processEvent:results", {
       event: normalizedEvent,
       executedCount: results.length,
@@ -35849,7 +35875,8 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
             }
           },
           navigate: optionsRef.current?.navigate,
-          notify: optionsRef.current?.notify
+          notify: optionsRef.current?.notify,
+          callService: optionsRef.current?.callService
         });
         const persistence = optionsRef.current?.persistence;
         let handlers = clientHandlers;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@almadar/ui",
-  "version": "4.29.1",
+  "version": "4.31.0",
   "description": "React UI components, hooks, and providers for Almadar",
   "type": "module",
   "sideEffects": [
@@ -125,7 +125,7 @@
     "@almadar/core": ">=7.12.0",
     "@almadar/evaluator": ">=2.9.2",
     "@almadar/patterns": "^2.21.0",
-    "@almadar/runtime": "^6.0.0",
+    "@almadar/runtime": "^6.2.0",
     "@almadar/std": ">=6.4.1",
     "@almadar/syntax": ">=1.3.1",
     "@xyflow/react": "12.10.1",