@ashley-shrok/viewmodel-shell 0.3.3 → 0.3.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ashley-shrok/viewmodel-shell",
-  "version": "0.3.3",
+  "version": "0.3.5",
   "description": "A server-driven UI framework where the wire format is structured enough that agents can build full-stack apps without ever opening a browser and all UI tests are pure unit tests with no browser runtime. Server returns a JSON tree of typed nodes; a thin TypeScript adapter renders it to DOM. Backend-agnostic — a .NET reference backend ships with the repo, but any language can produce the JSON contract.",
   "type": "module",
   "license": "MIT",

package/src/index.ts

@@ -190,11 +190,24 @@ export interface ShellOptions {
   onLoading?: (loading: boolean) => void;
   /** Called before each dispatch — merge the returned headers into every POST request. */
   getRequestHeaders?: () => Record<string, string> | Promise<Record<string, string>>;
+  /** Called when the server responds with a redirect URL. Defaults to window.location.href = url. */
+  onRedirect?: (url: string) => void;
+}
+
+export interface ShellSideEffect {
+  /** "set-local-storage" | "set-session-storage" — unknown types are silently ignored. */
+  type: string;
+  key?: string;
+  value?: string;
 }
 
 export interface ShellResponse {
   vm: ViewNode;
   state: unknown;
+  /** When set, the shell navigates to this URL instead of re-rendering. */
+  redirect?: string;
+  /** Applied in order before redirect or re-render. */
+  sideEffects?: ShellSideEffect[];
 }
 
 export class ViewModelShell {
@@ -254,6 +267,22 @@ export class ViewModelShell {
       });
       if (!res.ok) throw new Error(`Action '${action.name}' failed: ${res.status}`);
       const body = (await res.json()) as ShellResponse;
+      for (const effect of body.sideEffects ?? []) {
+        if (effect.type === "set-local-storage" && effect.key != null) {
+          localStorage.setItem(effect.key, effect.value ?? "");
+        } else if (effect.type === "set-session-storage" && effect.key != null) {
+          sessionStorage.setItem(effect.key, effect.value ?? "");
+        }
+        // unknown types silently ignored — forward-compatible
+      }
+      if (body.redirect) {
+        if (this.options.onRedirect) {
+          this.options.onRedirect(body.redirect);
+        } else {
+          window.location.href = body.redirect;
+        }
+        return;
+      }
       this.currentVm = body.vm;
       this.currentState = body.state;
       adapter.render(body.vm, (a) => this.dispatch(a));