@almadar/runtime 6.55.0 → 6.57.0

package/dist/{OrbitalServerRuntime-COuVFqev.d.ts → OrbitalServerRuntime-CgDV0DwN.d.ts}

@@ -1,5 +1,5 @@
 import { Router } from 'express';
-import { I as IEventBus, R as RuntimeEvent, a as EventListener, U as Unsubscribe, T as TraitDefinition, b as RuntimeConfig, c as TransitionObserver, d as TraitState, C as ConfigContext, e as TransitionResult, f as EvaluationContextExtensions, E as EffectHandlers } from './types-BOF75lWr.js';
+import { I as IEventBus, R as RuntimeEvent, a as EventListener, U as Unsubscribe, T as TraitDefinition, b as RuntimeConfig, c as TransitionObserver, d as TraitState, C as ConfigContext, e as TransitionResult, f as EvaluationContextExtensions, E as EffectHandlers } from './types-D20NPs1X.js';
 import { EventPayload, EventId, EntityRow, UserContext, Orbital, ServiceCallResult, TraitConfig, DeclaredTraitConfig, Entity, OrbitalSchema, Trait, PatternConfig, ResolvedPatternProps, SExpr, BusEventSource, RawUserClaims, OrbitalDefinition, TraitTick } from '@almadar/core';
 
 /**
@@ -899,11 +899,14 @@ declare class InMemoryPersistence implements PersistenceAdapter {
  * registry validation lives in `orbital validate` / `lolo` parse, not here.
  */
 type ClientRenderUITuple = ['render-ui', string, PatternConfig | null] | ['render-ui', string, PatternConfig | null, ResolvedPatternProps] | ['render-ui', string, PatternConfig | null, ResolvedPatternProps | undefined, number | undefined];
-type ClientNavigateTuple = ['navigate', string] | ['navigate', string, Record<string, string> | undefined];
+type ClientNavigateTuple = ['navigate', string] | ['navigate', string, Record<string, string> | undefined] | ['navigate', string, Record<string, string> | undefined, {
+    crumb?: string;
+}];
+type ClientNavigateBackTuple = ['navigate-back'];
 type ClientNotifyTuple = ['notify', string, string | SExpr | undefined] | ['notify', string, string | SExpr | undefined, {
     type?: string;
 }];
-type ClientEffectTuple = ClientRenderUITuple | ClientNavigateTuple | ClientNotifyTuple;
+type ClientEffectTuple = ClientRenderUITuple | ClientNavigateTuple | ClientNavigateBackTuple | ClientNotifyTuple;
 
 /** @deprecated Use OrbitalSchema from @almadar/core */
 type RuntimeOrbitalSchema = OrbitalSchema;
@@ -1490,4 +1493,4 @@ declare class OrbitalServerRuntime {
  */
 declare function createOrbitalServerRuntime(config?: OrbitalServerRuntimeConfig): OrbitalServerRuntime;
 
-export { normalizeEventKey as A, parseNamespacedEvent as B, preprocessSchema as C, processEvent as D, type EntitySharingMap as E, type ClientEffectTuple as F, type ClientNavigateTuple as G, type ClientNotifyTuple as H, type ImportChainLike as I, type ClientRenderUITuple as J, type EffectResult as K, type LoadResult as L, type LiveBroadcastItem as M, type LoaderConfig as N, type OrbitalEventRequest as O, type PersistenceAdapter as P, OrbitalServerRuntime as Q, type RegisteredOrbital as R, type SchemaLoader as S, type RuntimeTraitTick as T, type UnifiedLoaderOptions as U, createOrbitalServerRuntime as V, type LoadedSchema as a, type LoadedOrbital as b, EventBus as c, type EventNamespaceMap as d, InMemoryPersistence as e, type OrbitalEventResponse as f, type OrbitalServerRuntimeConfig as g, type PreprocessOptions as h, type PreprocessResult as i, type PreprocessedSchema as j, type ProcessEventOptions as k, type RuntimeOrbital as l, type RuntimeOrbitalSchema as m, type RuntimeTrait as n, StateMachineManager as o, collectDeclaredConfigDefaults as p, collectDeclaredEntityDefaults as q, createInitialTraitState as r, findInitialState as s, findTransition as t, getIsolatedCollectionName as u, getNamespacedEvent as v, isBrowser as w, isElectron as x, isNamespacedEvent as y, isNode as z };
+export { normalizeEventKey as A, parseNamespacedEvent as B, preprocessSchema as C, processEvent as D, type EntitySharingMap as E, type ClientEffectTuple as F, type ClientNavigateBackTuple as G, type ClientNavigateTuple as H, type ImportChainLike as I, type ClientNotifyTuple as J, type ClientRenderUITuple as K, type LoadResult as L, type EffectResult as M, type LiveBroadcastItem as N, type OrbitalEventRequest as O, type PersistenceAdapter as P, type LoaderConfig as Q, type RegisteredOrbital as R, type SchemaLoader as S, OrbitalServerRuntime as T, type UnifiedLoaderOptions as U, type RuntimeTraitTick as V, createOrbitalServerRuntime as W, type LoadedSchema as a, type LoadedOrbital as b, EventBus as c, type EventNamespaceMap as d, InMemoryPersistence as e, type OrbitalEventResponse as f, type OrbitalServerRuntimeConfig as g, type PreprocessOptions as h, type PreprocessResult as i, type PreprocessedSchema as j, type ProcessEventOptions as k, type RuntimeOrbital as l, type RuntimeOrbitalSchema as m, type RuntimeTrait as n, StateMachineManager as o, collectDeclaredConfigDefaults as p, collectDeclaredEntityDefaults as q, createInitialTraitState as r, findInitialState as s, findTransition as t, getIsolatedCollectionName as u, getNamespacedEvent as v, isBrowser as w, isElectron as x, isNamespacedEvent as y, isNode as z };

package/dist/OrbitalServerRuntime.d.ts

@@ -1,4 +1,4 @@
 import 'express';
-export { F as ClientEffectTuple, G as ClientNavigateTuple, H as ClientNotifyTuple, J as ClientRenderUITuple, K as EffectResult, e as InMemoryPersistence, M as LiveBroadcastItem, N as LoaderConfig, O as OrbitalEventRequest, f as OrbitalEventResponse, Q as OrbitalServerRuntime, g as OrbitalServerRuntimeConfig, P as PersistenceAdapter, R as RegisteredOrbital, l as RuntimeOrbital, m as RuntimeOrbitalSchema, n as RuntimeTrait, T as RuntimeTraitTick, p as collectDeclaredConfigDefaults, V as createOrbitalServerRuntime } from './OrbitalServerRuntime-COuVFqev.js';
-import './types-BOF75lWr.js';
+export { F as ClientEffectTuple, G as ClientNavigateBackTuple, H as ClientNavigateTuple, J as ClientNotifyTuple, K as ClientRenderUITuple, M as EffectResult, e as InMemoryPersistence, N as LiveBroadcastItem, Q as LoaderConfig, O as OrbitalEventRequest, f as OrbitalEventResponse, T as OrbitalServerRuntime, g as OrbitalServerRuntimeConfig, P as PersistenceAdapter, R as RegisteredOrbital, l as RuntimeOrbital, m as RuntimeOrbitalSchema, n as RuntimeTrait, V as RuntimeTraitTick, p as collectDeclaredConfigDefaults, W as createOrbitalServerRuntime } from './OrbitalServerRuntime-CgDV0DwN.js';
+import './types-D20NPs1X.js';
 import '@almadar/core';

package/dist/OrbitalServerRuntime.js

@@ -1,5 +1,5 @@
-import { createTickScheduler, EventBus, createUnifiedLoader, MockPersistenceAdapter, InMemoryPersistence, preprocessSchema, normalizeCallSiteConfigToValues, StateMachineManager, parseDurationString, validateEventPayload, formatPayloadValidationError, collectDeclaredConfigDefaults, collectDeclaredEntityDefaults, EffectExecutor } from './chunk-7CQLNJLN.js';
-export { InMemoryPersistence, collectDeclaredConfigDefaults } from './chunk-7CQLNJLN.js';
+import { createTickScheduler, EventBus, createUnifiedLoader, MockPersistenceAdapter, InMemoryPersistence, preprocessSchema, normalizeCallSiteConfigToValues, StateMachineManager, parseDurationString, validateEventPayload, formatPayloadValidationError, collectDeclaredConfigDefaults, collectDeclaredEntityDefaults, EffectExecutor } from './chunk-MMVKKLAP.js';
+export { InMemoryPersistence, collectDeclaredConfigDefaults } from './chunk-MMVKKLAP.js';
 import { isValidCronExpression } from './chunk-OU3ITB5S.js';
 import { createContextFromBindings, resolveCallSitePayloadCaptures, applyRowAccess, checkMutationAccess, accessDeniedMessage } from './chunk-ZJ62H3ES.js';
 import './chunk-T4VDAB4C.js';
@@ -1766,8 +1766,15 @@ var OrbitalServerRuntime = class {
         });
         pushClientEffect(["render-ui", slot, pattern, props, priority]);
       },
-      navigate: (path, params) => {
-        pushClientEffect(["navigate", path, params]);
+      navigate: (path, params, crumb) => {
+        if (crumb !== void 0) {
+          pushClientEffect(["navigate", path, params, { crumb }]);
+        } else {
+          pushClientEffect(["navigate", path, params]);
+        }
+      },
+      navigateBack: () => {
+        pushClientEffect(["navigate-back"]);
       },
       notify: (message, type) => {
         if (this.config.debug) {
@@ -1813,6 +1820,24 @@ var OrbitalServerRuntime = class {
         ...callSiteOverride ?? {}
       };
     }
+    if (bindings.config) {
+      const USER_FORWARD = /^@user(?:\.[\w]+)+$/;
+      let changed = false;
+      const resolved = {};
+      for (const [key, value] of Object.entries(bindings.config)) {
+        if (typeof value === "string" && USER_FORWARD.test(value)) {
+          let cur = user;
+          for (const seg of value.slice("@user.".length).split(".")) {
+            cur = cur !== null && typeof cur === "object" ? cur[seg] : void 0;
+          }
+          resolved[key] = typeof cur === "string" || typeof cur === "number" || typeof cur === "boolean" ? cur : "";
+          changed = true;
+        } else {
+          resolved[key] = value;
+        }
+      }
+      if (changed) bindings.config = resolved;
+    }
     const sigilPages = [];
     const seenPaths = /* @__PURE__ */ new Set();
     for (const reg of this.orbitals.values()) {

package/dist/ServerBridge.d.ts

@@ -1,4 +1,4 @@
-import { I as IEventBus } from './types-BOF75lWr.js';
+import { I as IEventBus } from './types-D20NPs1X.js';
 import { EventPayload } from '@almadar/core';
 
 /**

package/dist/{chunk-7CQLNJLN.js → chunk-MMVKKLAP.js}

@@ -886,12 +886,13 @@ var StateMachineManager = class {
 
 // src/types.ts
 var HANDLER_MANIFEST = {
-  client: ["render-ui", "render", "navigate", "notify", "emit", "set", "log", "ref", "deref", "watch", "send-server", "browser/open-file-picker", "browser/clipboard-read", "browser/clipboard-write", "browser/geolocation-current"],
+  client: ["render-ui", "render", "navigate", "navigate-back", "notify", "emit", "set", "log", "ref", "deref", "watch", "send-server", "browser/open-file-picker", "browser/clipboard-read", "browser/clipboard-write", "browser/geolocation-current"],
   server: ["persist", "fetch", "fetch-stream", "call-service", "emit", "set", "spawn", "despawn", "log", "ref", "deref", "swap!", "atomic", "os/watch-files", "os/watch-process", "os/watch-port", "os/watch-http", "os/watch-cron", "os/watch-signal", "os/watch-env", "os/debounce"],
   test: [
     "render-ui",
     "render",
     "navigate",
+    "navigate-back",
     "notify",
     "emit",
     "set",
@@ -1025,6 +1026,7 @@ var EffectExecutor = class _EffectExecutor {
       "render-ui": this.handlers.renderUI,
       "render": this.handlers.renderUI,
       "navigate": this.handlers.navigate,
+      "navigate-back": this.handlers.navigateBack,
       "notify": this.handlers.notify,
       "log": this.handlers.log,
       "ref": this.handlers.ref,
@@ -1572,13 +1574,27 @@ var EffectExecutor = class _EffectExecutor {
       case "navigate": {
         if (this.handlers.navigate) {
           const path = args[0];
+          if (typeof path !== "string" || path === "") {
+            effectLog.warn("navigate-path-unresolved", { pathType: typeof path });
+            break;
+          }
           const params = args[1];
-          this.handlers.navigate(path, params);
+          const options = args[2];
+          const crumb = options && typeof options.crumb === "string" && options.crumb !== "" ? options.crumb : void 0;
+          this.handlers.navigate(path, params, crumb);
         } else {
           this.logUnsupported("navigate");
         }
         break;
       }
+      case "navigate-back": {
+        if (this.handlers.navigateBack) {
+          this.handlers.navigateBack();
+        } else {
+          this.logUnsupported("navigate-back");
+        }
+        break;
+      }
       case "notify": {
         if (this.handlers.notify) {
           const message = args[0];
@@ -1919,6 +1935,17 @@ var EffectExecutor = class _EffectExecutor {
         }, emitCfg);
         break;
       }
+      case "browser/push-subscribe": {
+        const [, emitCfg] = this.splitSubstrateEmit(args);
+        await this.runSubstrate(async () => {
+          if (!this.handlers.browserPushSubscribe) {
+            this.logUnsupported("browser/push-subscribe");
+            return null;
+          }
+          return this.handlers.browserPushSubscribe();
+        }, emitCfg);
+        break;
+      }
       default: {
         if (operator.includes("/")) {
           const [positional, emitCfg] = this.splitSubstrateEmit(args);

package/dist/createOsHandlers.d.ts

@@ -1,4 +1,4 @@
-import { E as EffectHandlers } from './types-BOF75lWr.js';
+import { E as EffectHandlers } from './types-D20NPs1X.js';
 import { EventPayload } from '@almadar/core';
 
 /**

package/dist/index.d.ts

@@ -1,7 +1,7 @@
-import { g as RuntimePatternValue, B as BindingContext, f as EvaluationContextExtensions, P as PatternProps, E as EffectHandlers, h as EffectContext, i as ExecutionEnvironment, j as EffectResult, T as TraitDefinition } from './types-BOF75lWr.js';
-export { k as BrowserFileMeta, l as BrowserFilePickerOptions, m as BrowserGeolocationOptions, n as BrowserGeolocationPosition, C as ConfigContext, o as Effect, a as EventListener, H as HANDLER_MANIFEST, I as IEventBus, b as RuntimeConfig, R as RuntimeEvent, d as TraitState, c as TransitionObserver, e as TransitionResult, U as Unsubscribe } from './types-BOF75lWr.js';
-import { U as UnifiedLoaderOptions, S as SchemaLoader, I as ImportChainLike, L as LoadResult, a as LoadedSchema, b as LoadedOrbital, P as PersistenceAdapter } from './OrbitalServerRuntime-COuVFqev.js';
-export { E as EntitySharingMap, c as EventBus, d as EventNamespaceMap, e as InMemoryPersistence, O as OrbitalEventRequest, f as OrbitalEventResponse, g as OrbitalServerRuntimeConfig, h as PreprocessOptions, i as PreprocessResult, j as PreprocessedSchema, k as ProcessEventOptions, R as RegisteredOrbital, l as RuntimeOrbital, m as RuntimeOrbitalSchema, n as RuntimeTrait, o as StateMachineManager, p as collectDeclaredConfigDefaults, q as collectDeclaredEntityDefaults, r as createInitialTraitState, s as findInitialState, t as findTransition, u as getIsolatedCollectionName, v as getNamespacedEvent, w as isBrowser, x as isElectron, y as isNamespacedEvent, z as isNode, A as normalizeEventKey, B as parseNamespacedEvent, C as preprocessSchema, D as processEvent } from './OrbitalServerRuntime-COuVFqev.js';
+import { g as RuntimePatternValue, B as BindingContext, f as EvaluationContextExtensions, P as PatternProps, E as EffectHandlers, h as EffectContext, i as ExecutionEnvironment, j as EffectResult, T as TraitDefinition } from './types-D20NPs1X.js';
+export { k as BrowserFileMeta, l as BrowserFilePickerOptions, m as BrowserGeolocationOptions, n as BrowserGeolocationPosition, C as ConfigContext, o as Effect, a as EventListener, H as HANDLER_MANIFEST, I as IEventBus, b as RuntimeConfig, R as RuntimeEvent, d as TraitState, c as TransitionObserver, e as TransitionResult, U as Unsubscribe } from './types-D20NPs1X.js';
+import { U as UnifiedLoaderOptions, S as SchemaLoader, I as ImportChainLike, L as LoadResult, a as LoadedSchema, b as LoadedOrbital, P as PersistenceAdapter } from './OrbitalServerRuntime-CgDV0DwN.js';
+export { E as EntitySharingMap, c as EventBus, d as EventNamespaceMap, e as InMemoryPersistence, O as OrbitalEventRequest, f as OrbitalEventResponse, g as OrbitalServerRuntimeConfig, h as PreprocessOptions, i as PreprocessResult, j as PreprocessedSchema, k as ProcessEventOptions, R as RegisteredOrbital, l as RuntimeOrbital, m as RuntimeOrbitalSchema, n as RuntimeTrait, o as StateMachineManager, p as collectDeclaredConfigDefaults, q as collectDeclaredEntityDefaults, r as createInitialTraitState, s as findInitialState, t as findTransition, u as getIsolatedCollectionName, v as getNamespacedEvent, w as isBrowser, x as isElectron, y as isNamespacedEvent, z as isNode, A as normalizeEventKey, B as parseNamespacedEvent, C as preprocessSchema, D as processEvent } from './OrbitalServerRuntime-CgDV0DwN.js';
 import { EvaluationContext, SExpressionEvaluator } from '@almadar/evaluator';
 export { EvaluationContext, createMinimalContext } from '@almadar/evaluator';
 import { RenderBindingMarker, SExpr, TraitConfigObject, EventPayload, PatternConfig, EntityId, EntityField, EntityRow, EntityPersistence, ServiceParams, EntityAccessPolicies, PayloadField, OrbitalDefinition, OrbitalSchema } from '@almadar/core';
@@ -499,10 +499,14 @@ interface CreateClientEffectHandlersOptions {
     eventBus: ClientEventBus;
     /** Slot setter for render-ui effects */
     slotSetter: SlotSetter;
-    /** Navigate function for navigate effects */
+    /** Navigate function for navigate effects. `crumb` labels the target
+     * page's navigation-stack entry (from the effect's `{ crumb: … }`
+     * options). */
     navigate?: (path: string, params?: {
         [key: string]: string;
-    }) => void;
+    }, crumb?: string) => void;
+    /** Navigate-back function: pop the orbital-scoped navigation stack. */
+    navigateBack?: () => void;
     /** Notify function for notification effects */
     notify?: (message: string, type: 'success' | 'error' | 'warning' | 'info') => void;
     /**

package/dist/index.js

@@ -1,5 +1,5 @@
-import { EffectExecutor } from './chunk-7CQLNJLN.js';
-export { EffectExecutor, EventBus, HANDLER_MANIFEST, InMemoryPersistence, MockPersistenceAdapter, StateMachineManager, TickScheduler, buildEmitsFromTraits, collectDeclaredConfigDefaults, collectDeclaredEntityDefaults, createInitialTraitState, createMockPersistence, createTestExecutor, createTickScheduler, createUnifiedLoader, findInitialState, findTransition, formatPayloadValidationError, getIsolatedCollectionName, getNamespacedEvent, isBrowser, isElectron, isNamespacedEvent, isNode, isValidDurationString, normalizeCallSiteConfigToValues, normalizeEventKey, parseDurationString, parseNamespacedEvent, preprocessSchema, processEvent, validateEventPayload, validatePayloadShapes } from './chunk-7CQLNJLN.js';
+import { EffectExecutor } from './chunk-MMVKKLAP.js';
+export { EffectExecutor, EventBus, HANDLER_MANIFEST, InMemoryPersistence, MockPersistenceAdapter, StateMachineManager, TickScheduler, buildEmitsFromTraits, collectDeclaredConfigDefaults, collectDeclaredEntityDefaults, createInitialTraitState, createMockPersistence, createTestExecutor, createTickScheduler, createUnifiedLoader, findInitialState, findTransition, formatPayloadValidationError, getIsolatedCollectionName, getNamespacedEvent, isBrowser, isElectron, isNamespacedEvent, isNode, isValidDurationString, normalizeCallSiteConfigToValues, normalizeEventKey, parseDurationString, parseNamespacedEvent, preprocessSchema, processEvent, validateEventPayload, validatePayloadShapes } from './chunk-MMVKKLAP.js';
 export { cronMatches, cronMinuteKey, isValidCronExpression, parseCron, parseCronField } from './chunk-OU3ITB5S.js';
 import { createContextFromBindings, applyRowAccess, checkMutationAccess, accessDeniedMessage } from './chunk-ZJ62H3ES.js';
 export { CALLSITE_PAYLOAD_PREFIX, applyRowAccess, checkMutationAccess, containsBindings, createContextFromBindings, createMinimalContext, deferEntityBindings, extractBindings, interpolateProps, interpolateValue, resolveCallSitePayloadCaptures } from './chunk-ZJ62H3ES.js';
@@ -40,6 +40,17 @@ function getOrOpenWs() {
   }
   return _ws;
 }
+function urlBase64ToArrayBuffer(base64Url) {
+  const padding = "=".repeat((4 - base64Url.length % 4) % 4);
+  const base64 = (base64Url + padding).replace(/-/g, "+").replace(/_/g, "/");
+  const raw = atob(base64);
+  const buffer = new ArrayBuffer(raw.length);
+  const view = new Uint8Array(buffer);
+  for (let i = 0; i < raw.length; i++) {
+    view[i] = raw.charCodeAt(i);
+  }
+  return buffer;
+}
 function sendServerEvent(orbital, event, payload) {
   const msg = JSON.stringify({
     type: "ORBITAL_EVENT",
@@ -57,7 +68,7 @@ function sendServerEvent(orbital, event, payload) {
   }
 }
 function createClientEffectHandlers(options) {
-  const { eventBus, slotSetter, navigate, notify, sendServer, orbitalName = "" } = options;
+  const { eventBus, slotSetter, navigate, navigateBack, notify, sendServer, orbitalName = "" } = options;
   return {
     emit: (event, payload) => {
       const prefixedEvent = event.startsWith("UI:") ? event : `UI:${event}`;
@@ -87,6 +98,9 @@ function createClientEffectHandlers(options) {
       }
       log.warn("navigate-no-handler", { path });
     }),
+    navigateBack: navigateBack ?? (() => {
+      log.warn("navigate-back-no-handler");
+    }),
     notify: notify ?? ((msg, type) => {
       log.debug("notify", { type: type ?? null, message: msg });
     }),
@@ -127,6 +141,29 @@ function createClientEffectHandlers(options) {
       await navigator.clipboard.writeText(text);
       return { text };
     },
+    browserPushSubscribe: async () => {
+      if (typeof navigator === "undefined" || !("serviceWorker" in navigator) || typeof window === "undefined" || !("PushManager" in window)) {
+        throw new Error("Push API is not available in this environment");
+      }
+      const keyResponse = await fetch("/api/push/vapid-public-key");
+      if (!keyResponse.ok) {
+        throw new Error("Push is not configured on this host (no VAPID public key)");
+      }
+      const { publicKey } = await keyResponse.json();
+      const registration = await navigator.serviceWorker.register("/almadar-push-sw.js");
+      const subscription = await registration.pushManager.subscribe({
+        userVisibleOnly: true,
+        applicationServerKey: urlBase64ToArrayBuffer(publicKey)
+      });
+      const json = subscription.toJSON();
+      const endpoint = json.endpoint ?? "";
+      const p256dh = json.keys?.p256dh ?? "";
+      const auth = json.keys?.auth ?? "";
+      if (!endpoint || !p256dh || !auth) {
+        throw new Error("Push subscription resolved without endpoint/keys");
+      }
+      return { endpoint, p256dh, auth };
+    },
     browserGeolocationCurrent: async (options2) => {
       if (typeof navigator === "undefined" || !navigator.geolocation) {
         throw new Error("Geolocation API is not available in this environment");

package/dist/{types-BOF75lWr.d.ts → types-D20NPs1X.d.ts}

@@ -188,10 +188,15 @@ interface EffectHandlers {
      * (relationsData) read from the persistence adapter before pushing —
      * the interpreter's mirror of codegen's build-time relationsData. */
     renderUI?: (slot: string, pattern: PatternConfig | null, props?: PatternProps, priority?: number) => void | Promise<void>;
-    /** Navigate to a route (client only) */
+    /** Navigate to a route (client only). `crumb` labels the navigation-stack
+     * entry the client pushes for the target page (from the effect's
+     * `{ crumb: … }` options). */
     navigate?: (path: string, params?: {
         [key: string]: string;
-    }) => void;
+    }, crumb?: string) => void;
+    /** Pop the orbital-scoped navigation stack and return to the previous
+     * entry (client only). */
+    navigateBack?: () => void;
     /** Show a notification (client: toast, server: log) */
     notify?: (message: string, type: 'success' | 'error' | 'warning' | 'info') => void;
     /** Log a message */
@@ -266,6 +271,12 @@ interface EffectHandlers {
     }>;
     /** browser/geolocation-current — resolves with the position inside `result` */
     browserGeolocationCurrent?: (options?: BrowserGeolocationOptions) => Promise<BrowserGeolocationPosition>;
+    /** browser/push-subscribe — resolves with the flat Web Push subscription credentials inside `result` */
+    browserPushSubscribe?: () => Promise<{
+        endpoint: string;
+        p256dh: string;
+        auth: string;
+    }>;
     /** compose/compose-all — compose multiple orbitals into one schema */
     substrateComposeAll?: (config: {
         appName: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@almadar/runtime",
-  "version": "6.55.0",
+  "version": "6.57.0",
   "description": "Interpreted runtime for Almadar orbital applications (OrbitalServerRuntime)",
   "type": "module",
   "main": "./dist/index.js",
@@ -57,11 +57,11 @@
     "access": "public"
   },
   "dependencies": {
-    "@almadar/core": "^10.62.0",
+    "@almadar/core": "^10.66.0",
     "@almadar/evaluator": "^2.41.0",
     "@almadar/logger": "^1.11.0",
-    "@almadar/server": "^2.34.0",
-    "@almadar/std": "^16.178.0"
+    "@almadar/server": "^2.36.0",
+    "@almadar/std": "^16.182.0"
   },
   "peerDependencies": {
     "express": "^5.0.0"