@almadar/ui 6.9.0 → 6.11.0

package/dist/{EntityBindingContext-Bn3ePJQC.d.cts → EntityBindingContext-D5lRu6p1.d.cts}

@@ -2,6 +2,7 @@ import * as React from 'react';
 import React__default, { ReactNode } from 'react';
 import { ResolvedEntity, EventPayload, EntityRow, OrbitalSchema, BusEventSource, SExpr, ResolvedTrait, ResolvedTraitBinding, TraitConfig } from '@almadar/core';
 import { AnyPatternConfig } from '@almadar/core/patterns';
+import { ServerEffectResult } from '@almadar/runtime';
 
 /**
  * EntitySchemaContext
@@ -111,6 +112,14 @@ interface OrbitalEventResponse {
         traitName: string;
         effect: ClientEffectTuple;
     }>;
+    /**
+     * Results from server-side effects (persist, call-service, set, …) —
+     * `ServerEffectResult`, JSON-serialized. Carries the
+     * persist effect's real outcome (action, entity, resulting id, denied)
+     * so the verification trace can read it instead of inferring success
+     * from a row-count delta.
+     */
+    effectResults?: ServerEffectResult[];
     error?: string;
 }
 interface ServerClientEffect {
@@ -137,6 +146,8 @@ interface ServerResponseMeta {
     /** Raw entity data from server response (for EntityStore advancement) */
     data?: Record<string, EntityRow[]>;
     emittedEvents: string[];
+    /** Server-side effect outcomes — see `OrbitalEventResponse.effectResults`. */
+    effectResults?: ServerEffectResult[];
     error?: string;
 }
 interface SendEventResult {
@@ -175,6 +186,12 @@ interface ServerBridgeTransport {
      */
     sendEvent: (orbitalName: string, event: string, payload?: EventPayload, clientId?: string, tick?: string, sourceTrait?: string) => Promise<OrbitalEventResponse>;
 }
+/**
+ * Supplies the bearer token the hosting server authenticates with. Resolved
+ * per request (tokens expire); `undefined` sends the request unauthenticated
+ * (dev servers with an auth bypass, standalone playground).
+ */
+type AccessTokenProvider = () => Promise<string | undefined>;
 /**
  * Access the server bridge. Returns a no-op stub when outside the provider.
  */
@@ -189,9 +206,15 @@ interface ServerBridgeProviderProps {
      * directly). Mutually exclusive with `serverUrl`.
      */
     transport?: ServerBridgeTransport;
+    /**
+     * Bearer token for the HTTP transport (`Authorization` on every fetch;
+     * `access_token` on the SSE URL, since EventSource cannot set headers).
+     * Ignored with a custom `transport`.
+     */
+    getAccessToken?: AccessTokenProvider;
     children: ReactNode;
 }
-declare function ServerBridgeProvider({ schema, serverUrl, transport: customTransport, children, }: ServerBridgeProviderProps): React.JSX.Element;
+declare function ServerBridgeProvider({ schema, serverUrl, transport: customTransport, getAccessToken, children, }: ServerBridgeProviderProps): React.JSX.Element;
 
 /**
  * TraitProvider Component
@@ -272,4 +295,4 @@ declare function useEntityBindingSnapshot(traitName: string | undefined): {
     state: string;
 };
 
-export { EntityBindingContext as E, type SendEventResult as S, TraitContext as T, type EntityBindingSource as a, type EntitySchemaContextValue as b, EntitySchemaProvider as c, type EntitySchemaProviderProps as d, type ServerBridgeContextValue as e, ServerBridgeProvider as f, type ServerBridgeProviderProps as g, type ServerBridgeTransport as h, type ServerClientEffect as i, type ServerResponseMeta as j, type TraitContextValue as k, type TraitInstance as l, TraitProvider as m, type TraitProviderProps as n, useEntitySchema as o, useEntitySchemaOptional as p, useServerBridge as q, useTrait as r, useTraitContext as s, useEntityBindingSnapshot as u };
+export { type AccessTokenProvider as A, EntityBindingContext as E, type SendEventResult as S, TraitContext as T, type EntityBindingSource as a, type EntitySchemaContextValue as b, EntitySchemaProvider as c, type EntitySchemaProviderProps as d, type ServerBridgeContextValue as e, ServerBridgeProvider as f, type ServerBridgeProviderProps as g, type ServerBridgeTransport as h, type ServerClientEffect as i, type ServerResponseMeta as j, type TraitContextValue as k, type TraitInstance as l, TraitProvider as m, type TraitProviderProps as n, useEntitySchema as o, useEntitySchemaOptional as p, useServerBridge as q, useTrait as r, useTraitContext as s, useEntityBindingSnapshot as u };

package/dist/{EntityBindingContext-Bn3ePJQC.d.ts → EntityBindingContext-D5lRu6p1.d.ts}

@@ -2,6 +2,7 @@ import * as React from 'react';
 import React__default, { ReactNode } from 'react';
 import { ResolvedEntity, EventPayload, EntityRow, OrbitalSchema, BusEventSource, SExpr, ResolvedTrait, ResolvedTraitBinding, TraitConfig } from '@almadar/core';
 import { AnyPatternConfig } from '@almadar/core/patterns';
+import { ServerEffectResult } from '@almadar/runtime';
 
 /**
  * EntitySchemaContext
@@ -111,6 +112,14 @@ interface OrbitalEventResponse {
         traitName: string;
         effect: ClientEffectTuple;
     }>;
+    /**
+     * Results from server-side effects (persist, call-service, set, …) —
+     * `ServerEffectResult`, JSON-serialized. Carries the
+     * persist effect's real outcome (action, entity, resulting id, denied)
+     * so the verification trace can read it instead of inferring success
+     * from a row-count delta.
+     */
+    effectResults?: ServerEffectResult[];
     error?: string;
 }
 interface ServerClientEffect {
@@ -137,6 +146,8 @@ interface ServerResponseMeta {
     /** Raw entity data from server response (for EntityStore advancement) */
     data?: Record<string, EntityRow[]>;
     emittedEvents: string[];
+    /** Server-side effect outcomes — see `OrbitalEventResponse.effectResults`. */
+    effectResults?: ServerEffectResult[];
     error?: string;
 }
 interface SendEventResult {
@@ -175,6 +186,12 @@ interface ServerBridgeTransport {
      */
     sendEvent: (orbitalName: string, event: string, payload?: EventPayload, clientId?: string, tick?: string, sourceTrait?: string) => Promise<OrbitalEventResponse>;
 }
+/**
+ * Supplies the bearer token the hosting server authenticates with. Resolved
+ * per request (tokens expire); `undefined` sends the request unauthenticated
+ * (dev servers with an auth bypass, standalone playground).
+ */
+type AccessTokenProvider = () => Promise<string | undefined>;
 /**
  * Access the server bridge. Returns a no-op stub when outside the provider.
  */
@@ -189,9 +206,15 @@ interface ServerBridgeProviderProps {
      * directly). Mutually exclusive with `serverUrl`.
      */
     transport?: ServerBridgeTransport;
+    /**
+     * Bearer token for the HTTP transport (`Authorization` on every fetch;
+     * `access_token` on the SSE URL, since EventSource cannot set headers).
+     * Ignored with a custom `transport`.
+     */
+    getAccessToken?: AccessTokenProvider;
     children: ReactNode;
 }
-declare function ServerBridgeProvider({ schema, serverUrl, transport: customTransport, children, }: ServerBridgeProviderProps): React.JSX.Element;
+declare function ServerBridgeProvider({ schema, serverUrl, transport: customTransport, getAccessToken, children, }: ServerBridgeProviderProps): React.JSX.Element;
 
 /**
  * TraitProvider Component
@@ -272,4 +295,4 @@ declare function useEntityBindingSnapshot(traitName: string | undefined): {
     state: string;
 };
 
-export { EntityBindingContext as E, type SendEventResult as S, TraitContext as T, type EntityBindingSource as a, type EntitySchemaContextValue as b, EntitySchemaProvider as c, type EntitySchemaProviderProps as d, type ServerBridgeContextValue as e, ServerBridgeProvider as f, type ServerBridgeProviderProps as g, type ServerBridgeTransport as h, type ServerClientEffect as i, type ServerResponseMeta as j, type TraitContextValue as k, type TraitInstance as l, TraitProvider as m, type TraitProviderProps as n, useEntitySchema as o, useEntitySchemaOptional as p, useServerBridge as q, useTrait as r, useTraitContext as s, useEntityBindingSnapshot as u };
+export { type AccessTokenProvider as A, EntityBindingContext as E, type SendEventResult as S, TraitContext as T, type EntityBindingSource as a, type EntitySchemaContextValue as b, EntitySchemaProvider as c, type EntitySchemaProviderProps as d, type ServerBridgeContextValue as e, ServerBridgeProvider as f, type ServerBridgeProviderProps as g, type ServerBridgeTransport as h, type ServerClientEffect as i, type ServerResponseMeta as j, type TraitContextValue as k, type TraitInstance as l, TraitProvider as m, type TraitProviderProps as n, useEntitySchema as o, useEntitySchemaOptional as p, useServerBridge as q, useTrait as r, useTraitContext as s, useEntityBindingSnapshot as u };

package/dist/{GameAudioProvider-Dk_Y3LN3.d.cts → GameAudioProvider-D8GynTNq.d.cts}

@@ -1,6 +1,6 @@
 import React__default from 'react';
 import { AudioManifest } from '@almadar/core';
-import { U as UiError } from './types-B3nHgnMG.cjs';
+import { U as UiError } from './paintDispatch-CK5uwYEq.cjs';
 
 /** Core owns the sound-manifest shape (`@almadar/core` `types/asset.ts`) so the
  *  pattern extractor and the generated `.lolo` factories resolve the same

package/dist/{GameAudioProvider-Ctceau1s.d.ts → GameAudioProvider-Dozqx4sL.d.ts}

@@ -1,6 +1,6 @@
 import React__default from 'react';
 import { AudioManifest } from '@almadar/core';
-import { U as UiError } from './types-B3nHgnMG.js';
+import { U as UiError } from './paintDispatch-CK5uwYEq.js';
 
 /** Core owns the sound-manifest shape (`@almadar/core` `types/asset.ts`) so the
  *  pattern extractor and the generated `.lolo` factories resolve the same