@almadar/ui 6.27.0 → 6.28.0

package/dist/{EntityBindingContext-CTZw2DbY.d.cts → EntityBindingContext-C6FgxdfG.d.cts}

@@ -1,6 +1,6 @@
 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 { ResolvedEntity, EventPayload, EntityRow, UserContext, OrbitalSchema, BusEventSource, SExpr, ResolvedTrait, ResolvedTraitBinding, TraitConfig } from '@almadar/core';
 import { AnyPatternConfig } from '@almadar/core/patterns';
 import { ServerEffectResult, TransitionResult } from '@almadar/runtime';
 
@@ -169,7 +169,18 @@ interface ServerBridgeContextValue {
         result: TransitionResult;
     }>, 
     /** Part G: the client's own current entity snapshot per trait. */
-    entityByTrait?: Readonly<Record<string, EntityRow>>) => Promise<SendEventResult>;
+    entityByTrait?: Readonly<Record<string, EntityRow>>, 
+    /**
+     * The current viewer (persona), for `@user.X` guard/effect bindings.
+     * The persona-switcher's picked viewer never used to reach server-side
+     * effects on the stateless path — it only ever drove client-side guard
+     * evaluation — so a `fetch`/`persist` comparing against `@user.id`
+     * (e.g. a chat channel's `member == @user.id` scope filter, a profile
+     * page's self-lookup) always compared against `undefined` (confirmed
+     * 2026-09-17). `undefined` here sends the request unauthenticated,
+     * exactly as before this field existed.
+     */
+    user?: UserContext) => Promise<SendEventResult>;
 }
 /**
  * Transport adapter for ServerBridgeProvider. Decouples the bridge's
@@ -213,7 +224,9 @@ interface ServerBridgeTransport {
      * misrouted to the standalone `std-project-manager` orbital of the
      * same name). An unmodified server ignores the extra field.
      */
-    behaviorHint?: string) => Promise<OrbitalEventResponse>;
+    behaviorHint?: string, 
+    /** See `ServerBridgeContextValue.sendEvent`'s `user` param. */
+    user?: UserContext) => Promise<OrbitalEventResponse>;
 }
 /**
  * Supplies the bearer token the hosting server authenticates with. Resolved

package/dist/{EntityBindingContext-CTZw2DbY.d.ts → EntityBindingContext-C6FgxdfG.d.ts}

@@ -1,6 +1,6 @@
 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 { ResolvedEntity, EventPayload, EntityRow, UserContext, OrbitalSchema, BusEventSource, SExpr, ResolvedTrait, ResolvedTraitBinding, TraitConfig } from '@almadar/core';
 import { AnyPatternConfig } from '@almadar/core/patterns';
 import { ServerEffectResult, TransitionResult } from '@almadar/runtime';
 
@@ -169,7 +169,18 @@ interface ServerBridgeContextValue {
         result: TransitionResult;
     }>, 
     /** Part G: the client's own current entity snapshot per trait. */
-    entityByTrait?: Readonly<Record<string, EntityRow>>) => Promise<SendEventResult>;
+    entityByTrait?: Readonly<Record<string, EntityRow>>, 
+    /**
+     * The current viewer (persona), for `@user.X` guard/effect bindings.
+     * The persona-switcher's picked viewer never used to reach server-side
+     * effects on the stateless path — it only ever drove client-side guard
+     * evaluation — so a `fetch`/`persist` comparing against `@user.id`
+     * (e.g. a chat channel's `member == @user.id` scope filter, a profile
+     * page's self-lookup) always compared against `undefined` (confirmed
+     * 2026-09-17). `undefined` here sends the request unauthenticated,
+     * exactly as before this field existed.
+     */
+    user?: UserContext) => Promise<SendEventResult>;
 }
 /**
  * Transport adapter for ServerBridgeProvider. Decouples the bridge's
@@ -213,7 +224,9 @@ interface ServerBridgeTransport {
      * misrouted to the standalone `std-project-manager` orbital of the
      * same name). An unmodified server ignores the extra field.
      */
-    behaviorHint?: string) => Promise<OrbitalEventResponse>;
+    behaviorHint?: string, 
+    /** See `ServerBridgeContextValue.sendEvent`'s `user` param. */
+    user?: UserContext) => Promise<OrbitalEventResponse>;
 }
 /**
  * Supplies the bearer token the hosting server authenticates with. Resolved

package/dist/avl/index.cjs

@@ -60835,7 +60835,7 @@ function NavStackRefBridge({ apiRef }) {
   }, [api, apiRef]);
   return null;
 }
-function TraitInitializer({ traits: traits2, routeParams, orbitalNames, onNavigate, onNavigateBack, onLocalFallback, localFallbackTimeoutMs, persistence, traitConfigsByName, orbitalsByTrait, embeddedTraits, callsiteCaptureChildrenByTrait, serverActiveTraits, children }) {
+function TraitInitializer({ traits: traits2, routeParams, orbitalNames, onNavigate, onNavigateBack, onLocalFallback, localFallbackTimeoutMs, persistence, traitConfigsByName, orbitalsByTrait, embeddedTraits, callsiteCaptureChildrenByTrait, serverActiveTraits, user, children }) {
   const bridge = providers.useServerBridge();
   const activeTraitNames = React96.useMemo(
     () => new Set(traits2.map((b) => b.trait.name).filter((n) => !!n)),
@@ -60867,12 +60867,12 @@ function TraitInitializer({ traits: traits2, routeParams, orbitalNames, onNaviga
         void bridge.sendEvent(name, event, withActiveTraits(payload), tick, sourceTrait);
         continue;
       }
-      void bridge.sendEvent(name, event, withActiveTraits(payload), void 0, void 0, locallyEmitted, results, entityByTrait).then(({ effects, meta }) => {
+      void bridge.sendEvent(name, event, withActiveTraits(payload), void 0, void 0, locallyEmitted, results, entityByTrait, user ?? void 0).then(({ effects, meta }) => {
         recordServerResponse(name, event, { ...meta, effectResults: effectResultsToTraces(meta.effectResults) });
         applyServerEffects(effects, uiSlots, onNavigate, embeddedTraits, activeTraitNamesRef.current, onNavigateBack);
       });
     }
-  }, [bridge.connected, bridge.sendEvent, orbitalNames, uiSlots, onNavigate, onNavigateBack, embeddedTraits, activeTraitNames, withActiveTraits]);
+  }, [bridge.connected, bridge.sendEvent, orbitalNames, uiSlots, onNavigate, onNavigateBack, embeddedTraits, activeTraitNames, withActiveTraits, user]);
   const opts = orbitalNames ? { onEventProcessed, navigate: onNavigate, navigateBack: onNavigateBack, traitConfigsByName, orbitalsByTrait, embeddedTraits, callsiteCaptureChildrenByTrait, initPayload: routeParams } : { navigate: onNavigate, navigateBack: onNavigateBack, persistence, traitConfigsByName, orbitalsByTrait, embeddedTraits, callsiteCaptureChildrenByTrait, initPayload: routeParams };
   const { sendEvent, entityBindingSource } = useTraitStateMachine(traits2, uiSlots, opts);
   const initSentRef = React96.useRef(false);
@@ -60914,7 +60914,17 @@ function TraitInitializer({ traits: traits2, routeParams, orbitalNames, onNaviga
     initSentRef.current = true;
     (async () => {
       for (const name of orbitalNames) {
-        const { effects, meta } = await bridge.sendEvent(name, "INIT", withActiveTraits({ ...routeParams ?? {} }));
+        const { effects, meta } = await bridge.sendEvent(
+          name,
+          "INIT",
+          withActiveTraits({ ...routeParams ?? {} }),
+          void 0,
+          void 0,
+          void 0,
+          void 0,
+          void 0,
+          user ?? void 0
+        );
         recordServerResponse(name, "INIT", { ...meta, effectResults: effectResultsToTraces(meta.effectResults) });
         const effectTraces = [
           { type: "fetch", args: [], status: "executed" },
@@ -60935,7 +60945,7 @@ function TraitInitializer({ traits: traits2, routeParams, orbitalNames, onNaviga
         applyServerEffects(effects, uiSlots, onNavigate, embeddedTraits, activeTraitNamesRef.current, onNavigateBack);
       }
     })();
-  }, [bridge.connected, orbitalNames, bridge.sendEvent, uiSlots, onNavigate, onNavigateBack, embeddedTraits, activeTraitNames, withActiveTraits, routeParams]);
+  }, [bridge.connected, orbitalNames, bridge.sendEvent, uiSlots, onNavigate, onNavigateBack, embeddedTraits, activeTraitNames, withActiveTraits, routeParams, user]);
   return /* @__PURE__ */ jsxRuntime.jsx(providers.EntityBindingContext.Provider, { value: entityBindingSource, children });
 }
 function FitToBox({ children }) {
@@ -60962,7 +60972,7 @@ function FitToBox({ children }) {
   }, []);
   return /* @__PURE__ */ jsxRuntime.jsx("div", { ref: outerRef, className: "relative h-full w-full overflow-hidden", children: /* @__PURE__ */ jsxRuntime.jsx("div", { ref: innerRef, style: { transform: `scale(${scale})`, transformOrigin: "top left", width: "fit-content" }, children }) });
 }
-function SchemaRunner({ schema, serverUrl, transport, getAccessToken, mockData, pageName, routeParams, onNavigate, onNavigateBack, onLocalFallback, localFallbackTimeoutMs, persistence }) {
+function SchemaRunner({ schema, serverUrl, transport, getAccessToken, mockData, pageName, routeParams, onNavigate, onNavigateBack, onLocalFallback, localFallbackTimeoutMs, persistence, user }) {
   const { traits: traits2, allEntities, allTraits, ir } = useResolvedSchema(schema, pageName);
   const allPageTraits = React96.useMemo(() => {
     let base;
@@ -61127,6 +61137,7 @@ function SchemaRunner({ schema, serverUrl, transport, getAccessToken, mockData,
           onLocalFallback,
           localFallbackTimeoutMs,
           persistence,
+          user,
           children: /* @__PURE__ */ jsxRuntime.jsx(providers.OrbitalThemeProvider, { theme: activeOrbitalTheme, children: /* @__PURE__ */ jsxRuntime.jsx(Box, { className: "h-full min-h-full overflow-auto p-4", children: /* @__PURE__ */ jsxRuntime.jsx(UISlotRenderer, { includeHud: true, hudMode: "inline", includeFloating: true }) }) })
         }
       )
@@ -61333,7 +61344,8 @@ function OrbPreview({
                   onNavigateBack: handleNavigateBack,
                   onLocalFallback: handleLocalFallback,
                   localFallbackTimeoutMs,
-                  persistence
+                  persistence,
+                  user
                 }
               ) }) : /* @__PURE__ */ jsxRuntime.jsx(
                 SchemaRunner,
@@ -61349,7 +61361,8 @@ function OrbPreview({
                   onNavigateBack: handleNavigateBack,
                   onLocalFallback: handleLocalFallback,
                   localFallbackTimeoutMs,
-                  persistence
+                  persistence,
+                  user
                 }
               ) }) })
             ]

package/dist/avl/index.js

@@ -60759,7 +60759,7 @@ function NavStackRefBridge({ apiRef }) {
   }, [api, apiRef]);
   return null;
 }
-function TraitInitializer({ traits: traits2, routeParams, orbitalNames, onNavigate, onNavigateBack, onLocalFallback, localFallbackTimeoutMs, persistence, traitConfigsByName, orbitalsByTrait, embeddedTraits, callsiteCaptureChildrenByTrait, serverActiveTraits, children }) {
+function TraitInitializer({ traits: traits2, routeParams, orbitalNames, onNavigate, onNavigateBack, onLocalFallback, localFallbackTimeoutMs, persistence, traitConfigsByName, orbitalsByTrait, embeddedTraits, callsiteCaptureChildrenByTrait, serverActiveTraits, user, children }) {
   const bridge = useServerBridge();
   const activeTraitNames = useMemo(
     () => new Set(traits2.map((b) => b.trait.name).filter((n) => !!n)),
@@ -60791,12 +60791,12 @@ function TraitInitializer({ traits: traits2, routeParams, orbitalNames, onNaviga
         void bridge.sendEvent(name, event, withActiveTraits(payload), tick, sourceTrait);
         continue;
       }
-      void bridge.sendEvent(name, event, withActiveTraits(payload), void 0, void 0, locallyEmitted, results, entityByTrait).then(({ effects, meta }) => {
+      void bridge.sendEvent(name, event, withActiveTraits(payload), void 0, void 0, locallyEmitted, results, entityByTrait, user ?? void 0).then(({ effects, meta }) => {
         recordServerResponse(name, event, { ...meta, effectResults: effectResultsToTraces(meta.effectResults) });
         applyServerEffects(effects, uiSlots, onNavigate, embeddedTraits, activeTraitNamesRef.current, onNavigateBack);
       });
     }
-  }, [bridge.connected, bridge.sendEvent, orbitalNames, uiSlots, onNavigate, onNavigateBack, embeddedTraits, activeTraitNames, withActiveTraits]);
+  }, [bridge.connected, bridge.sendEvent, orbitalNames, uiSlots, onNavigate, onNavigateBack, embeddedTraits, activeTraitNames, withActiveTraits, user]);
   const opts = orbitalNames ? { onEventProcessed, navigate: onNavigate, navigateBack: onNavigateBack, traitConfigsByName, orbitalsByTrait, embeddedTraits, callsiteCaptureChildrenByTrait, initPayload: routeParams } : { navigate: onNavigate, navigateBack: onNavigateBack, persistence, traitConfigsByName, orbitalsByTrait, embeddedTraits, callsiteCaptureChildrenByTrait, initPayload: routeParams };
   const { sendEvent, entityBindingSource } = useTraitStateMachine(traits2, uiSlots, opts);
   const initSentRef = useRef(false);
@@ -60838,7 +60838,17 @@ function TraitInitializer({ traits: traits2, routeParams, orbitalNames, onNaviga
     initSentRef.current = true;
     (async () => {
       for (const name of orbitalNames) {
-        const { effects, meta } = await bridge.sendEvent(name, "INIT", withActiveTraits({ ...routeParams ?? {} }));
+        const { effects, meta } = await bridge.sendEvent(
+          name,
+          "INIT",
+          withActiveTraits({ ...routeParams ?? {} }),
+          void 0,
+          void 0,
+          void 0,
+          void 0,
+          void 0,
+          user ?? void 0
+        );
         recordServerResponse(name, "INIT", { ...meta, effectResults: effectResultsToTraces(meta.effectResults) });
         const effectTraces = [
           { type: "fetch", args: [], status: "executed" },
@@ -60859,7 +60869,7 @@ function TraitInitializer({ traits: traits2, routeParams, orbitalNames, onNaviga
         applyServerEffects(effects, uiSlots, onNavigate, embeddedTraits, activeTraitNamesRef.current, onNavigateBack);
       }
     })();
-  }, [bridge.connected, orbitalNames, bridge.sendEvent, uiSlots, onNavigate, onNavigateBack, embeddedTraits, activeTraitNames, withActiveTraits, routeParams]);
+  }, [bridge.connected, orbitalNames, bridge.sendEvent, uiSlots, onNavigate, onNavigateBack, embeddedTraits, activeTraitNames, withActiveTraits, routeParams, user]);
   return /* @__PURE__ */ jsx(EntityBindingContext.Provider, { value: entityBindingSource, children });
 }
 function FitToBox({ children }) {
@@ -60886,7 +60896,7 @@ function FitToBox({ children }) {
   }, []);
   return /* @__PURE__ */ jsx("div", { ref: outerRef, className: "relative h-full w-full overflow-hidden", children: /* @__PURE__ */ jsx("div", { ref: innerRef, style: { transform: `scale(${scale})`, transformOrigin: "top left", width: "fit-content" }, children }) });
 }
-function SchemaRunner({ schema, serverUrl, transport, getAccessToken, mockData, pageName, routeParams, onNavigate, onNavigateBack, onLocalFallback, localFallbackTimeoutMs, persistence }) {
+function SchemaRunner({ schema, serverUrl, transport, getAccessToken, mockData, pageName, routeParams, onNavigate, onNavigateBack, onLocalFallback, localFallbackTimeoutMs, persistence, user }) {
   const { traits: traits2, allEntities, allTraits, ir } = useResolvedSchema(schema, pageName);
   const allPageTraits = useMemo(() => {
     let base;
@@ -61051,6 +61061,7 @@ function SchemaRunner({ schema, serverUrl, transport, getAccessToken, mockData,
           onLocalFallback,
           localFallbackTimeoutMs,
           persistence,
+          user,
           children: /* @__PURE__ */ jsx(OrbitalThemeProvider, { theme: activeOrbitalTheme, children: /* @__PURE__ */ jsx(Box, { className: "h-full min-h-full overflow-auto p-4", children: /* @__PURE__ */ jsx(UISlotRenderer, { includeHud: true, hudMode: "inline", includeFloating: true }) }) })
         }
       )
@@ -61257,7 +61268,8 @@ function OrbPreview({
                   onNavigateBack: handleNavigateBack,
                   onLocalFallback: handleLocalFallback,
                   localFallbackTimeoutMs,
-                  persistence
+                  persistence,
+                  user
                 }
               ) }) : /* @__PURE__ */ jsx(
                 SchemaRunner,
@@ -61273,7 +61285,8 @@ function OrbPreview({
                   onNavigateBack: handleNavigateBack,
                   onLocalFallback: handleLocalFallback,
                   localFallbackTimeoutMs,
-                  persistence
+                  persistence,
+                  user
                 }
               ) }) })
             ]

package/dist/providers/index.cjs

@@ -54890,7 +54890,7 @@ function createHttpTransport(serverUrl, getAccessToken) {
       } catch {
       }
     },
-    sendEvent: async (orbitalName, event, payload, clientId, tick, sourceTrait, results, entityByTrait, behaviorHint) => {
+    sendEvent: async (orbitalName, event, payload, clientId, tick, sourceTrait, results, entityByTrait, behaviorHint, user) => {
       const traits2 = results?.map((r) => ({ trait: r.traitName, from: r.result.previousState }));
       const body = {
         event,
@@ -54911,7 +54911,8 @@ function createHttpTransport(serverUrl, getAccessToken) {
         // "do nothing" and break every organism's INIT on the stateless path.
         ...results !== void 0 ? { traits: traits2 ?? [] } : {},
         ...entityByTrait ? { entityByTrait } : {},
-        ...behaviorHint !== void 0 ? { behavior: behaviorHint } : {}
+        ...behaviorHint !== void 0 ? { behavior: behaviorHint } : {},
+        ...user ? { user } : {}
       };
       const res = await fetch(`${serverUrl}/${orbitalName}/events`, {
         method: "POST",
@@ -54973,7 +54974,7 @@ function ServerBridgeProvider({
       disposedRef.current = true;
     };
   }, []);
-  const sendEvent = React89.useCallback(async (orbitalName, event, payload, tick, sourceTrait, locallyEmitted, results, entityByTrait) => {
+  const sendEvent = React89.useCallback(async (orbitalName, event, payload, tick, sourceTrait, locallyEmitted, results, entityByTrait, user) => {
     const emptyMeta = { success: false, transitioned: false, clientEffects: 0, dataEntities: {}, emittedEvents: [] };
     if (!connected) return { effects: [], meta: emptyMeta };
     if (tick !== void 0) {
@@ -54983,7 +54984,7 @@ function ServerBridgeProvider({
     return commandPump.enqueue(async () => {
       if (disposedRef.current) return { effects: [], meta: emptyMeta };
       try {
-        const result = await transport.sendEvent(orbitalName, event, payload, getTabClientId(), tick, sourceTrait, results, entityByTrait, schema.name);
+        const result = await transport.sendEvent(orbitalName, event, payload, getTabClientId(), tick, sourceTrait, results, entityByTrait, schema.name, user);
         const effects = [];
         const responseData = result.data || {};
         const dataEntities = {};

package/dist/providers/index.d.cts

@@ -6,7 +6,7 @@ export { a as CurrentPagePathContext, b as CurrentPagePathProvider, c as Current
 import { b as UserData } from '../UserContext-D566nfWA.cjs';
 export { U as UserContext, a as UserContextValue, c as UserProvider, d as UserProviderProps, u as useHasPermission, e as useHasRole, f as useUser, g as useUserForEvaluation } from '../UserContext-D566nfWA.cjs';
 import { E as EventBusContextType } from '../event-bus-types-Bl78kokd.cjs';
-export { A as AccessTokenProvider, E as EntityBindingContext, a as EntityBindingSource, b as EntitySchemaContextValue, c as EntitySchemaProvider, d as EntitySchemaProviderProps, S as SendEventResult, e as ServerBridgeContextValue, f as ServerBridgeProvider, g as ServerBridgeProviderProps, h as ServerBridgeTransport, i as ServerClientEffect, j as ServerResponseMeta, T as TraitContext, k as TraitContextValue, l as TraitInstance, m as TraitProvider, n as TraitProviderProps, u as useEntityBindingSnapshot, o as useEntitySchema, p as useEntitySchemaOptional, q as useServerBridge, r as useTrait, s as useTraitContext } from '../EntityBindingContext-CTZw2DbY.cjs';
+export { A as AccessTokenProvider, E as EntityBindingContext, a as EntityBindingSource, b as EntitySchemaContextValue, c as EntitySchemaProvider, d as EntitySchemaProviderProps, S as SendEventResult, e as ServerBridgeContextValue, f as ServerBridgeProvider, g as ServerBridgeProviderProps, h as ServerBridgeTransport, i as ServerClientEffect, j as ServerResponseMeta, T as TraitContext, k as TraitContextValue, l as TraitInstance, m as TraitProvider, n as TraitProviderProps, u as useEntityBindingSnapshot, o as useEntitySchema, p as useEntitySchemaOptional, q as useServerBridge, r as useTrait, s as useTraitContext } from '../EntityBindingContext-C6FgxdfG.cjs';
 import { i as UseOfflineExecutorResult, U as UseOfflineExecutorOptions } from '../offline-executor-DdV2o0Zu.cjs';
 export { N as NavigationContextValue, c as NavigationProvider, d as NavigationProviderProps, e as NavigationState, j as comparePathSpecificity, l as extractRouteParams, m as findPageByName, n as findPageByPath, o as getAllPages, p as getDefaultPage, q as matchPath, r as matchPathAmong, s as pathMatches, u as useActivePage, t as useInitPayload, v as useNavigateTo, w as useNavigation, x as useNavigationId, y as useNavigationState } from '../offline-executor-DdV2o0Zu.cjs';
 import '../verificationRegistry-DTrKDRoa.cjs';

package/dist/providers/index.d.ts

@@ -6,7 +6,7 @@ export { a as CurrentPagePathContext, b as CurrentPagePathProvider, c as Current
 import { b as UserData } from '../UserContext-D566nfWA.js';
 export { U as UserContext, a as UserContextValue, c as UserProvider, d as UserProviderProps, u as useHasPermission, e as useHasRole, f as useUser, g as useUserForEvaluation } from '../UserContext-D566nfWA.js';
 import { E as EventBusContextType } from '../event-bus-types-Bl78kokd.js';
-export { A as AccessTokenProvider, E as EntityBindingContext, a as EntityBindingSource, b as EntitySchemaContextValue, c as EntitySchemaProvider, d as EntitySchemaProviderProps, S as SendEventResult, e as ServerBridgeContextValue, f as ServerBridgeProvider, g as ServerBridgeProviderProps, h as ServerBridgeTransport, i as ServerClientEffect, j as ServerResponseMeta, T as TraitContext, k as TraitContextValue, l as TraitInstance, m as TraitProvider, n as TraitProviderProps, u as useEntityBindingSnapshot, o as useEntitySchema, p as useEntitySchemaOptional, q as useServerBridge, r as useTrait, s as useTraitContext } from '../EntityBindingContext-CTZw2DbY.js';
+export { A as AccessTokenProvider, E as EntityBindingContext, a as EntityBindingSource, b as EntitySchemaContextValue, c as EntitySchemaProvider, d as EntitySchemaProviderProps, S as SendEventResult, e as ServerBridgeContextValue, f as ServerBridgeProvider, g as ServerBridgeProviderProps, h as ServerBridgeTransport, i as ServerClientEffect, j as ServerResponseMeta, T as TraitContext, k as TraitContextValue, l as TraitInstance, m as TraitProvider, n as TraitProviderProps, u as useEntityBindingSnapshot, o as useEntitySchema, p as useEntitySchemaOptional, q as useServerBridge, r as useTrait, s as useTraitContext } from '../EntityBindingContext-C6FgxdfG.js';
 import { i as UseOfflineExecutorResult, U as UseOfflineExecutorOptions } from '../offline-executor-DdV2o0Zu.js';
 export { N as NavigationContextValue, c as NavigationProvider, d as NavigationProviderProps, e as NavigationState, j as comparePathSpecificity, l as extractRouteParams, m as findPageByName, n as findPageByPath, o as getAllPages, p as getDefaultPage, q as matchPath, r as matchPathAmong, s as pathMatches, u as useActivePage, t as useInitPayload, v as useNavigateTo, w as useNavigation, x as useNavigationId, y as useNavigationState } from '../offline-executor-DdV2o0Zu.js';
 import '../verificationRegistry-Cwa52VyK.js';

package/dist/providers/index.js

@@ -54816,7 +54816,7 @@ function createHttpTransport(serverUrl, getAccessToken) {
       } catch {
       }
     },
-    sendEvent: async (orbitalName, event, payload, clientId, tick, sourceTrait, results, entityByTrait, behaviorHint) => {
+    sendEvent: async (orbitalName, event, payload, clientId, tick, sourceTrait, results, entityByTrait, behaviorHint, user) => {
       const traits2 = results?.map((r) => ({ trait: r.traitName, from: r.result.previousState }));
       const body = {
         event,
@@ -54837,7 +54837,8 @@ function createHttpTransport(serverUrl, getAccessToken) {
         // "do nothing" and break every organism's INIT on the stateless path.
         ...results !== void 0 ? { traits: traits2 ?? [] } : {},
         ...entityByTrait ? { entityByTrait } : {},
-        ...behaviorHint !== void 0 ? { behavior: behaviorHint } : {}
+        ...behaviorHint !== void 0 ? { behavior: behaviorHint } : {},
+        ...user ? { user } : {}
       };
       const res = await fetch(`${serverUrl}/${orbitalName}/events`, {
         method: "POST",
@@ -54899,7 +54900,7 @@ function ServerBridgeProvider({
       disposedRef.current = true;
     };
   }, []);
-  const sendEvent = useCallback(async (orbitalName, event, payload, tick, sourceTrait, locallyEmitted, results, entityByTrait) => {
+  const sendEvent = useCallback(async (orbitalName, event, payload, tick, sourceTrait, locallyEmitted, results, entityByTrait, user) => {
     const emptyMeta = { success: false, transitioned: false, clientEffects: 0, dataEntities: {}, emittedEvents: [] };
     if (!connected) return { effects: [], meta: emptyMeta };
     if (tick !== void 0) {
@@ -54909,7 +54910,7 @@ function ServerBridgeProvider({
     return commandPump.enqueue(async () => {
       if (disposedRef.current) return { effects: [], meta: emptyMeta };
       try {
-        const result = await transport.sendEvent(orbitalName, event, payload, getTabClientId(), tick, sourceTrait, results, entityByTrait, schema.name);
+        const result = await transport.sendEvent(orbitalName, event, payload, getTabClientId(), tick, sourceTrait, results, entityByTrait, schema.name, user);
         const effects = [];
         const responseData = result.data || {};
         const dataEntities = {};

package/dist/runtime/index.cjs

@@ -55062,7 +55062,7 @@ function NavStackRefBridge({ apiRef }) {
   }, [api, apiRef]);
   return null;
 }
-function TraitInitializer({ traits: traits2, routeParams, orbitalNames, onNavigate, onNavigateBack, onLocalFallback, localFallbackTimeoutMs, persistence, traitConfigsByName, orbitalsByTrait, embeddedTraits, callsiteCaptureChildrenByTrait, serverActiveTraits, children }) {
+function TraitInitializer({ traits: traits2, routeParams, orbitalNames, onNavigate, onNavigateBack, onLocalFallback, localFallbackTimeoutMs, persistence, traitConfigsByName, orbitalsByTrait, embeddedTraits, callsiteCaptureChildrenByTrait, serverActiveTraits, user, children }) {
   const bridge = providers.useServerBridge();
   const activeTraitNames = React87.useMemo(
     () => new Set(traits2.map((b) => b.trait.name).filter((n) => !!n)),
@@ -55094,12 +55094,12 @@ function TraitInitializer({ traits: traits2, routeParams, orbitalNames, onNaviga
         void bridge.sendEvent(name, event, withActiveTraits(payload), tick, sourceTrait);
         continue;
       }
-      void bridge.sendEvent(name, event, withActiveTraits(payload), void 0, void 0, locallyEmitted, results, entityByTrait).then(({ effects, meta }) => {
+      void bridge.sendEvent(name, event, withActiveTraits(payload), void 0, void 0, locallyEmitted, results, entityByTrait, user ?? void 0).then(({ effects, meta }) => {
         recordServerResponse(name, event, { ...meta, effectResults: effectResultsToTraces(meta.effectResults) });
         applyServerEffects(effects, uiSlots, onNavigate, embeddedTraits, activeTraitNamesRef.current, onNavigateBack);
       });
     }
-  }, [bridge.connected, bridge.sendEvent, orbitalNames, uiSlots, onNavigate, onNavigateBack, embeddedTraits, activeTraitNames, withActiveTraits]);
+  }, [bridge.connected, bridge.sendEvent, orbitalNames, uiSlots, onNavigate, onNavigateBack, embeddedTraits, activeTraitNames, withActiveTraits, user]);
   const opts = orbitalNames ? { onEventProcessed, navigate: onNavigate, navigateBack: onNavigateBack, traitConfigsByName, orbitalsByTrait, embeddedTraits, callsiteCaptureChildrenByTrait, initPayload: routeParams } : { navigate: onNavigate, navigateBack: onNavigateBack, persistence, traitConfigsByName, orbitalsByTrait, embeddedTraits, callsiteCaptureChildrenByTrait, initPayload: routeParams };
   const { sendEvent, entityBindingSource } = useTraitStateMachine(traits2, uiSlots, opts);
   const initSentRef = React87.useRef(false);
@@ -55141,7 +55141,17 @@ function TraitInitializer({ traits: traits2, routeParams, orbitalNames, onNaviga
     initSentRef.current = true;
     (async () => {
       for (const name of orbitalNames) {
-        const { effects, meta } = await bridge.sendEvent(name, "INIT", withActiveTraits({ ...routeParams ?? {} }));
+        const { effects, meta } = await bridge.sendEvent(
+          name,
+          "INIT",
+          withActiveTraits({ ...routeParams ?? {} }),
+          void 0,
+          void 0,
+          void 0,
+          void 0,
+          void 0,
+          user ?? void 0
+        );
         recordServerResponse(name, "INIT", { ...meta, effectResults: effectResultsToTraces(meta.effectResults) });
         const effectTraces = [
           { type: "fetch", args: [], status: "executed" },
@@ -55162,7 +55172,7 @@ function TraitInitializer({ traits: traits2, routeParams, orbitalNames, onNaviga
         applyServerEffects(effects, uiSlots, onNavigate, embeddedTraits, activeTraitNamesRef.current, onNavigateBack);
       }
     })();
-  }, [bridge.connected, orbitalNames, bridge.sendEvent, uiSlots, onNavigate, onNavigateBack, embeddedTraits, activeTraitNames, withActiveTraits, routeParams]);
+  }, [bridge.connected, orbitalNames, bridge.sendEvent, uiSlots, onNavigate, onNavigateBack, embeddedTraits, activeTraitNames, withActiveTraits, routeParams, user]);
   return /* @__PURE__ */ jsxRuntime.jsx(providers.EntityBindingContext.Provider, { value: entityBindingSource, children });
 }
 function FitToBox({ children }) {
@@ -55189,7 +55199,7 @@ function FitToBox({ children }) {
   }, []);
   return /* @__PURE__ */ jsxRuntime.jsx("div", { ref: outerRef, className: "relative h-full w-full overflow-hidden", children: /* @__PURE__ */ jsxRuntime.jsx("div", { ref: innerRef, style: { transform: `scale(${scale})`, transformOrigin: "top left", width: "fit-content" }, children }) });
 }
-function SchemaRunner({ schema, serverUrl, transport, getAccessToken, mockData, pageName, routeParams, onNavigate, onNavigateBack, onLocalFallback, localFallbackTimeoutMs, persistence }) {
+function SchemaRunner({ schema, serverUrl, transport, getAccessToken, mockData, pageName, routeParams, onNavigate, onNavigateBack, onLocalFallback, localFallbackTimeoutMs, persistence, user }) {
   const { traits: traits2, allEntities, allTraits, ir } = useResolvedSchema(schema, pageName);
   const allPageTraits = React87.useMemo(() => {
     let base;
@@ -55354,6 +55364,7 @@ function SchemaRunner({ schema, serverUrl, transport, getAccessToken, mockData,
           onLocalFallback,
           localFallbackTimeoutMs,
           persistence,
+          user,
           children: /* @__PURE__ */ jsxRuntime.jsx(providers.OrbitalThemeProvider, { theme: activeOrbitalTheme, children: /* @__PURE__ */ jsxRuntime.jsx(Box, { className: "h-full min-h-full overflow-auto p-4", children: /* @__PURE__ */ jsxRuntime.jsx(UISlotRenderer, { includeHud: true, hudMode: "inline", includeFloating: true }) }) })
         }
       )
@@ -55560,7 +55571,8 @@ function OrbPreview({
                   onNavigateBack: handleNavigateBack,
                   onLocalFallback: handleLocalFallback,
                   localFallbackTimeoutMs,
-                  persistence
+                  persistence,
+                  user
                 }
               ) }) : /* @__PURE__ */ jsxRuntime.jsx(
                 SchemaRunner,
@@ -55576,7 +55588,8 @@ function OrbPreview({
                   onNavigateBack: handleNavigateBack,
                   onLocalFallback: handleLocalFallback,
                   localFallbackTimeoutMs,
-                  persistence
+                  persistence,
+                  user
                 }
               ) }) })
             ]

package/dist/runtime/index.d.cts

@@ -5,8 +5,8 @@ import * as _almadar_runtime from '@almadar/runtime';
 import { TraitState, TransitionResult, EffectHandlers } from '@almadar/runtime';
 import { K as KeyCaptureTable } from '../useKeyboardRouter-CVn8lfiX.cjs';
 import { c as useUISlots } from '../UISlotContext-BlRDbHDy.cjs';
-import { a as EntityBindingSource, h as ServerBridgeTransport, A as AccessTokenProvider } from '../EntityBindingContext-CTZw2DbY.cjs';
-export { b as EntitySchemaContextValue, c as EntitySchemaProvider, d as EntitySchemaProviderProps, e as ServerBridgeContextValue, f as ServerBridgeProvider, i as ServerClientEffect, T as TraitContext, k as TraitContextValue, l as TraitInstance, m as TraitProvider, n as TraitProviderProps, o as useEntitySchema, p as useEntitySchemaOptional, q as useServerBridge, r as useTrait, s as useTraitContext } from '../EntityBindingContext-CTZw2DbY.cjs';
+import { a as EntityBindingSource, h as ServerBridgeTransport, A as AccessTokenProvider } from '../EntityBindingContext-C6FgxdfG.cjs';
+export { b as EntitySchemaContextValue, c as EntitySchemaProvider, d as EntitySchemaProviderProps, e as ServerBridgeContextValue, f as ServerBridgeProvider, i as ServerClientEffect, T as TraitContext, k as TraitContextValue, l as TraitInstance, m as TraitProvider, n as TraitProviderProps, o as useEntitySchema, p as useEntitySchemaOptional, q as useServerBridge, r as useTrait, s as useTraitContext } from '../EntityBindingContext-C6FgxdfG.cjs';
 import '../verificationRegistry-DTrKDRoa.cjs';
 export { PERF_NAMESPACE, PerfEntry, PreparedPreviewSchema, adjustSchemaForMockData, buildMockData, clearPerf, perfEnd, perfStart, perfTime, prepareSchemaForPreview, wrapCallbackForEvent } from '@almadar/runtime/ui';
 import React__default, { ReactNode } from 'react';

package/dist/runtime/index.d.ts

@@ -5,8 +5,8 @@ import * as _almadar_runtime from '@almadar/runtime';
 import { TraitState, TransitionResult, EffectHandlers } from '@almadar/runtime';
 import { K as KeyCaptureTable } from '../useKeyboardRouter-B1pIi9jo.js';
 import { c as useUISlots } from '../UISlotContext-CB89mv7N.js';
-import { a as EntityBindingSource, h as ServerBridgeTransport, A as AccessTokenProvider } from '../EntityBindingContext-CTZw2DbY.js';
-export { b as EntitySchemaContextValue, c as EntitySchemaProvider, d as EntitySchemaProviderProps, e as ServerBridgeContextValue, f as ServerBridgeProvider, i as ServerClientEffect, T as TraitContext, k as TraitContextValue, l as TraitInstance, m as TraitProvider, n as TraitProviderProps, o as useEntitySchema, p as useEntitySchemaOptional, q as useServerBridge, r as useTrait, s as useTraitContext } from '../EntityBindingContext-CTZw2DbY.js';
+import { a as EntityBindingSource, h as ServerBridgeTransport, A as AccessTokenProvider } from '../EntityBindingContext-C6FgxdfG.js';
+export { b as EntitySchemaContextValue, c as EntitySchemaProvider, d as EntitySchemaProviderProps, e as ServerBridgeContextValue, f as ServerBridgeProvider, i as ServerClientEffect, T as TraitContext, k as TraitContextValue, l as TraitInstance, m as TraitProvider, n as TraitProviderProps, o as useEntitySchema, p as useEntitySchemaOptional, q as useServerBridge, r as useTrait, s as useTraitContext } from '../EntityBindingContext-C6FgxdfG.js';
 import '../verificationRegistry-Cwa52VyK.js';
 export { PERF_NAMESPACE, PerfEntry, PreparedPreviewSchema, adjustSchemaForMockData, buildMockData, clearPerf, perfEnd, perfStart, perfTime, prepareSchemaForPreview, wrapCallbackForEvent } from '@almadar/runtime/ui';
 import React__default, { ReactNode } from 'react';

package/dist/runtime/index.js

@@ -54988,7 +54988,7 @@ function NavStackRefBridge({ apiRef }) {
   }, [api, apiRef]);
   return null;
 }
-function TraitInitializer({ traits: traits2, routeParams, orbitalNames, onNavigate, onNavigateBack, onLocalFallback, localFallbackTimeoutMs, persistence, traitConfigsByName, orbitalsByTrait, embeddedTraits, callsiteCaptureChildrenByTrait, serverActiveTraits, children }) {
+function TraitInitializer({ traits: traits2, routeParams, orbitalNames, onNavigate, onNavigateBack, onLocalFallback, localFallbackTimeoutMs, persistence, traitConfigsByName, orbitalsByTrait, embeddedTraits, callsiteCaptureChildrenByTrait, serverActiveTraits, user, children }) {
   const bridge = useServerBridge();
   const activeTraitNames = useMemo(
     () => new Set(traits2.map((b) => b.trait.name).filter((n) => !!n)),
@@ -55020,12 +55020,12 @@ function TraitInitializer({ traits: traits2, routeParams, orbitalNames, onNaviga
         void bridge.sendEvent(name, event, withActiveTraits(payload), tick, sourceTrait);
         continue;
       }
-      void bridge.sendEvent(name, event, withActiveTraits(payload), void 0, void 0, locallyEmitted, results, entityByTrait).then(({ effects, meta }) => {
+      void bridge.sendEvent(name, event, withActiveTraits(payload), void 0, void 0, locallyEmitted, results, entityByTrait, user ?? void 0).then(({ effects, meta }) => {
         recordServerResponse(name, event, { ...meta, effectResults: effectResultsToTraces(meta.effectResults) });
         applyServerEffects(effects, uiSlots, onNavigate, embeddedTraits, activeTraitNamesRef.current, onNavigateBack);
       });
     }
-  }, [bridge.connected, bridge.sendEvent, orbitalNames, uiSlots, onNavigate, onNavigateBack, embeddedTraits, activeTraitNames, withActiveTraits]);
+  }, [bridge.connected, bridge.sendEvent, orbitalNames, uiSlots, onNavigate, onNavigateBack, embeddedTraits, activeTraitNames, withActiveTraits, user]);
   const opts = orbitalNames ? { onEventProcessed, navigate: onNavigate, navigateBack: onNavigateBack, traitConfigsByName, orbitalsByTrait, embeddedTraits, callsiteCaptureChildrenByTrait, initPayload: routeParams } : { navigate: onNavigate, navigateBack: onNavigateBack, persistence, traitConfigsByName, orbitalsByTrait, embeddedTraits, callsiteCaptureChildrenByTrait, initPayload: routeParams };
   const { sendEvent, entityBindingSource } = useTraitStateMachine(traits2, uiSlots, opts);
   const initSentRef = useRef(false);
@@ -55067,7 +55067,17 @@ function TraitInitializer({ traits: traits2, routeParams, orbitalNames, onNaviga
     initSentRef.current = true;
     (async () => {
       for (const name of orbitalNames) {
-        const { effects, meta } = await bridge.sendEvent(name, "INIT", withActiveTraits({ ...routeParams ?? {} }));
+        const { effects, meta } = await bridge.sendEvent(
+          name,
+          "INIT",
+          withActiveTraits({ ...routeParams ?? {} }),
+          void 0,
+          void 0,
+          void 0,
+          void 0,
+          void 0,
+          user ?? void 0
+        );
         recordServerResponse(name, "INIT", { ...meta, effectResults: effectResultsToTraces(meta.effectResults) });
         const effectTraces = [
           { type: "fetch", args: [], status: "executed" },
@@ -55088,7 +55098,7 @@ function TraitInitializer({ traits: traits2, routeParams, orbitalNames, onNaviga
         applyServerEffects(effects, uiSlots, onNavigate, embeddedTraits, activeTraitNamesRef.current, onNavigateBack);
       }
     })();
-  }, [bridge.connected, orbitalNames, bridge.sendEvent, uiSlots, onNavigate, onNavigateBack, embeddedTraits, activeTraitNames, withActiveTraits, routeParams]);
+  }, [bridge.connected, orbitalNames, bridge.sendEvent, uiSlots, onNavigate, onNavigateBack, embeddedTraits, activeTraitNames, withActiveTraits, routeParams, user]);
   return /* @__PURE__ */ jsx(EntityBindingContext.Provider, { value: entityBindingSource, children });
 }
 function FitToBox({ children }) {
@@ -55115,7 +55125,7 @@ function FitToBox({ children }) {
   }, []);
   return /* @__PURE__ */ jsx("div", { ref: outerRef, className: "relative h-full w-full overflow-hidden", children: /* @__PURE__ */ jsx("div", { ref: innerRef, style: { transform: `scale(${scale})`, transformOrigin: "top left", width: "fit-content" }, children }) });
 }
-function SchemaRunner({ schema, serverUrl, transport, getAccessToken, mockData, pageName, routeParams, onNavigate, onNavigateBack, onLocalFallback, localFallbackTimeoutMs, persistence }) {
+function SchemaRunner({ schema, serverUrl, transport, getAccessToken, mockData, pageName, routeParams, onNavigate, onNavigateBack, onLocalFallback, localFallbackTimeoutMs, persistence, user }) {
   const { traits: traits2, allEntities, allTraits, ir } = useResolvedSchema(schema, pageName);
   const allPageTraits = useMemo(() => {
     let base;
@@ -55280,6 +55290,7 @@ function SchemaRunner({ schema, serverUrl, transport, getAccessToken, mockData,
           onLocalFallback,
           localFallbackTimeoutMs,
           persistence,
+          user,
           children: /* @__PURE__ */ jsx(OrbitalThemeProvider, { theme: activeOrbitalTheme, children: /* @__PURE__ */ jsx(Box, { className: "h-full min-h-full overflow-auto p-4", children: /* @__PURE__ */ jsx(UISlotRenderer, { includeHud: true, hudMode: "inline", includeFloating: true }) }) })
         }
       )
@@ -55486,7 +55497,8 @@ function OrbPreview({
                   onNavigateBack: handleNavigateBack,
                   onLocalFallback: handleLocalFallback,
                   localFallbackTimeoutMs,
-                  persistence
+                  persistence,
+                  user
                 }
               ) }) : /* @__PURE__ */ jsx(
                 SchemaRunner,
@@ -55502,7 +55514,8 @@ function OrbPreview({
                   onNavigateBack: handleNavigateBack,
                   onLocalFallback: handleLocalFallback,
                   localFallbackTimeoutMs,
-                  persistence
+                  persistence,
+                  user
                 }
               ) }) })
             ]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@almadar/ui",
-  "version": "6.27.0",
+  "version": "6.28.0",
   "description": "React UI components, hooks, and providers for Almadar",
   "type": "module",
   "sideEffects": [