@almadar/ui 4.34.0 → 4.35.0

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;