@almadar/ui 4.30.0 → 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) {
@@ -49402,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) {
@@ -49356,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) {
@@ -35905,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) {
@@ -35860,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.30.0",
+  "version": "4.31.0",
   "description": "React UI components, hooks, and providers for Almadar",
   "type": "module",
   "sideEffects": [