rastack 0.0.63 → 0.0.69

package/CHANGELOG.md

@@ -2,6 +2,38 @@
 
 All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
 
+### [0.0.69](https://github.com/theserverkid/reactapistack/compare/v0.0.64...v0.0.69) (2026-10-03)
+
+
+### Bug Fixes
+
+* indent hybrid build rules in openspec/config.yaml ([6fa81ae](https://github.com/theserverkid/reactapistack/commit/6fa81ae1a1c8724a4f4bb54f483619a36940e316))
+
+### [0.0.68](https://github.com/theserverkid/reactapistack/compare/v0.0.64...v0.0.68) (2026-09-26)
+
+
+### Bug Fixes
+
+* indent hybrid build rules in openspec/config.yaml ([6fa81ae](https://github.com/theserverkid/reactapistack/commit/6fa81ae1a1c8724a4f4bb54f483619a36940e316))
+
+### [0.0.67](https://github.com/theserverkid/reactapistack/compare/v0.0.64...v0.0.67) (2026-09-26)
+
+
+### Bug Fixes
+
+* indent hybrid build rules in openspec/config.yaml ([6fa81ae](https://github.com/theserverkid/reactapistack/commit/6fa81ae1a1c8724a4f4bb54f483619a36940e316))
+
+### [0.0.66](https://github.com/theserverkid/reactapistack/compare/v0.0.64...v0.0.66) (2026-09-26)
+
+### [0.0.65](https://github.com/theserverkid/reactapistack/compare/v0.0.64...v0.0.65) (2026-09-02)
+
+### [0.0.64](https://github.com/theserverkid/reactapistack/compare/v0.0.63...v0.0.64) (2026-07-20)
+
+
+### Features
+
+* **define,provider:** nullable FK relations + bundled-warehouse seed ([276f8c6](https://github.com/theserverkid/reactapistack/commit/276f8c6d6555a6dbcb8965926009f0ddd076ad96))
+
 ### [0.0.63](https://github.com/theserverkid/reactapistack/compare/v0.0.62...v0.0.63) (2026-07-20)
 
 

package/README.md

@@ -82,8 +82,8 @@ export const Terminal = resource("airports", "terminal", {
 
 ```bash
 # No compile step to run — it happens in-process. Author your resources, then:
-rastack dev                        # compiles + serves your app in-browser over the WASM engine
-rastack admin                      # Django-admin-style DB browser over the same engine
+rastack dev                        # compiles, starts native rastack-server, proxies /api
+rastack admin                      # Django-admin-style console served by that same binary
 ```
 
 ```tsx
@@ -101,8 +101,8 @@ straight from the field types — see
 resolve your types against the compiled manifest at runtime — see
 [docs/typed-hooks.md](docs/typed-hooks.md). Resources can declare **state
 transitions** (`scheduled → boarding → departed`), compiled into the manifest
-and enforced on every write surface — an illegal jump is a 400 from the form,
-the importer, the server, and the in-browser WASM engine alike.
+and enforced on every write by the native handler — an illegal jump is a 400
+from the form, the importer, and `rastack-server` (laptop and Lambda).
 
 ## Ship it — one command per stage
 
@@ -127,32 +127,27 @@ is fixed and CI only ships code: `rastack ci deploy` builds and runs
 is just `run: rastack ci deploy` (`rastack ci --plan deploy` prints every step).
 Full guide: **[docs/serverless-deploy.md](docs/serverless-deploy.md)**.
 
-## Run the whole API in the browser
+## The UI is in the browser. The API is native Rust.
 
-The Rust API is stateless compute over object storage, so it also compiles to
-**WebAssembly and runs entirely in the browser** — no server, no network. One
-setting on the React provider picks where the API runs; the hooks never
-change:
+A browser cannot execute `rastack-server`. `rastack dev` starts that binary
+and proxies `/api` to it. The page renders your app. The request logic
+(`rastack-api-core`), the Iceberg warehouse, and access control run in the
+native process — the same binary Lambda runs (`provided.al2023`,
+`cargo lambda build --arm64 --features lambda`). There is no in-browser engine:
+no `RastackApi`, no warehouse seeded into the page, no IndexedDB copy of the
+database. The warehouse is the server's directory under `data/warehouse`.
 
 ```tsx
-// Local-first dev: the entire API in the browser, over the data/ Iceberg files.
-<RAStackProvider mode="local" manifest={schema} warehouseBaseUrl="/data/warehouse/">
+// Local: this origin. rastack dev proxies /api to native rastack-server.
+<RAStackProvider mode="local" manifest={schema}>
   <App />
 </RAStackProvider>
 
-// Production: the same code on AWS Lambda + S3.
+// Production: the same hooks, over HTTP, to Lambda.
 <RAStackProvider mode="remote" baseURL="https://api.example.com">…</RAStackProvider>
-
-// Client-only, reading and writing S3 directly.
-<RAStackProvider mode="s3" manifest={schema} warehouseBaseUrl="https://bucket.s3.amazonaws.com/warehouse/">…</RAStackProvider>
 ```
 
-`local` and `s3` run the same `rastack-api-core` request logic (CRUD, foreign-key
-validation, DRF-shaped lists) that Lambda runs — and, because Arrow/Parquet
-compile to WebAssembly, the browser reads and writes the **same Parquet Iceberg
-files** the server does. The local database is just a committed directory of
-those files under `data/`. Full guide:
-**[docs/local-wasm-dev.md](docs/local-wasm-dev.md)**.
+Full guide: **[docs/local-wasm-dev.md](docs/local-wasm-dev.md)**.
 
 ## Why "on top of object storage"?
 
@@ -177,9 +172,9 @@ That gives you:
   `useData` / `useForm`, and state transitions as typesafe backend functions.
 - **[docs/architecture.md](docs/architecture.md)** — the full serverless,
   object-storage architecture and how the three surfaces compose.
-- **[docs/local-wasm-dev.md](docs/local-wasm-dev.md)** — running the whole API in
-  the browser via WebAssembly, and the `RAStackProvider` mode switch.
-- **[engine/](engine/)** — the Rust engine: `core/` (manifest, Iceberg storage, request brain) and `serve/` (axum API, server binary, wasm).
+- **[docs/local-wasm-dev.md](docs/local-wasm-dev.md)** — local dev: native
+  `rastack-server`, UI in the browser.
+- **[engine/](engine/)** — the Rust engine: `core/` (manifest, Iceberg storage, request brain) and `serve/` (axum API, native server binary).
 - **[examples/serverless/](examples/serverless/)** — Lambda + S3 + IaC.
 - **[CLAUDE.md](CLAUDE.md)** — codebase guide for contributors.
 - **Building with an LLM?** The documentation site is mirrored as plain Markdown

package/admin/AdminApp.tsx

@@ -10,7 +10,7 @@
  * Layout: models on the left (`<Sidebar>`), the changelist table in the main
  * area, a Linear-style filter bar on top (`<FilterBar>`), and add/change forms.
  */
-import React, { useEffect, useMemo, useState } from "react";
+import React, { useCallback, useEffect, useMemo, useState } from "react";
 import {
   AutoForm,
   Button,
@@ -28,9 +28,11 @@ import {
   mergeDiscovered,
 } from "./adapters";
 import {
+  RefreshContext,
   useDashboardStats,
   useDeleteRecord,
   useFilterModel,
+  useRefresh,
   useResourceForm,
   useResourceTable,
 } from "./useAdmin";
@@ -56,6 +58,7 @@ import {
   IconLayers,
   IconLink,
   IconPlus,
+  IconRefresh,
   IconTable,
   IconTrash,
 } from "./ui/icons";
@@ -100,7 +103,43 @@ interface Crumb {
   hash?: string;
 }
 
+/** Compact relative age, e.g. "just now", "3m ago", "2h ago". */
+function formatAgo(ts: number, now: number): string {
+  if (!ts) return "—";
+  const secs = Math.max(0, Math.round((now - ts) / 1000));
+  if (secs < 5) return "just now";
+  if (secs < 60) return `${secs}s ago`;
+  const mins = Math.round(secs / 60);
+  if (mins < 60) return `${mins}m ago`;
+  const hrs = Math.round(mins / 60);
+  if (hrs < 24) return `${hrs}h ago`;
+  return `${Math.round(hrs / 24)}d ago`;
+}
+
+/** The "Updated …" label — ticks over time and snaps fresh when data lands. */
+function LastUpdated(): React.JSX.Element {
+  const { lastUpdated } = useRefresh();
+  const [now, setNow] = useState(() => Date.now());
+  useEffect(() => {
+    const id = window.setInterval(() => setNow(Date.now()), 30_000);
+    return () => window.clearInterval(id);
+  }, []);
+  useEffect(() => setNow(Date.now()), [lastUpdated]);
+  return (
+    <span className="ras-updated" style={{ marginLeft: "auto" }}>
+      Updated {formatAgo(lastUpdated, now)}
+    </span>
+  );
+}
+
 function Topbar({ crumbs }: { crumbs: Crumb[] }): React.JSX.Element {
+  const { refresh } = useRefresh();
+  const [spinning, setSpinning] = useState(false);
+  const onReload = () => {
+    setSpinning(true);
+    refresh();
+    window.setTimeout(() => setSpinning(false), 500);
+  };
   return (
     <header className="ras-topbar">
       <nav className="ras-crumbs">
@@ -115,6 +154,16 @@ function Topbar({ crumbs }: { crumbs: Crumb[] }): React.JSX.Element {
           </React.Fragment>
         ))}
       </nav>
+      <LastUpdated />
+      <button
+        type="button"
+        className="ras-icon-btn"
+        onClick={onReload}
+        title="Reload data"
+        aria-label="Reload data"
+      >
+        <IconRefresh size={16} className={spinning ? "ras-spin" : undefined} />
+      </button>
     </header>
   );
 }
@@ -695,6 +744,10 @@ export function AdminApp(props: {
   const { engine } = props;
   const resources = useDiscoveredResources(engine, props.resources);
   const [collapsed, toggleCollapsed] = useSidebarCollapsed();
+  const [nonce, setNonce] = useState(0);
+  const [lastUpdated, setLastUpdated] = useState(0);
+  const refresh = useCallback(() => setNonce((n) => n + 1), []);
+  const markUpdated = useCallback(() => setLastUpdated(Date.now()), []);
 
   const activeKey =
     route.name === "index" ? undefined : `${route.app}.${route.model}`;
@@ -737,7 +790,7 @@ export function AdminApp(props: {
   }
 
   return (
-    <>
+    <RefreshContext.Provider value={{ nonce, refresh, lastUpdated, markUpdated }}>
       <AdminStyles />
       <div className={"ras-root" + (collapsed ? " is-collapsed" : "")}>
         <Sidebar
@@ -748,6 +801,6 @@ export function AdminApp(props: {
         />
         <main className="ras-main">{screen}</main>
       </div>
-    </>
+    </RefreshContext.Provider>
   );
 }

package/admin/httpEngine.ts

@@ -1,10 +1,7 @@
 /**
  * An HTTP-backed `RastackEngine` — the same `handle(method, path, query, body)`
- * seam the WASM engine exposes, implemented over `fetch` against a live
- * `rastack-server`. This is what lets the *identical* admin UI run two ways:
- * over WebAssembly in `rastack dev` (`client.engine`), or over the real Rust
- * API + Iceberg store in `rastack admin` (this adapter) — the components,
- * hooks and adapters above it never learn which.
+ * seam, implemented over `fetch` against the native `rastack-server`. The
+ * browser renders the console. The engine is that process.
  */
 
 import type { RastackEngine } from "../provider/types";
@@ -44,7 +41,9 @@ export function createHttpEngine(baseUrl = ""): RastackEngine {
   }
 
   const unavailable = (op: string) => async (): Promise<never> => {
-    throw new Error(`${op} is only available over the local WASM engine.`);
+    throw new Error(
+      `${op} is not available in the browser. The native rastack-server process owns the warehouse.`,
+    );
   };
 
   return {

package/admin/index.tsx

@@ -1,22 +1,14 @@
 /**
- * Entry point for the admin bundle (`dist/admin.js`). It runs two ways from the
- * *same* build, chosen by a `window.__RASTACK_ADMIN__` config the host page
- * injects (defaulting to local):
+ * Entry point for the admin bundle (`dist/admin.js`).
  *
- *  • `rastack dev`   → `mode: "local"`  — boots the WASM engine via
- *    `<RAStackProvider mode="local">`, seeding from the served `/data/warehouse/`.
- *  • `rastack admin` → `mode: "remote"` — talks to the live `rastack-server`
- *    over HTTP through an `httpEngine`, against the real Iceberg warehouse.
- *
- * Either way it fetches the compiled schema, themes everything with
- * `<ThemeProvider>` and the design tokens, and renders the manifest-driven
- * `<AdminApp>` — which never learns which engine it got.
+ * The native `rastack-server admin` process serves this bundle and injects
+ * `window.__RASTACK_ADMIN__` with `mode: "remote"`. The console calls `/api`
+ * on that same origin through `createHttpEngine`. The engine is the native
+ * process. This bundle does not load a module into the page.
  */
 
 import React, { useEffect, useMemo, useState } from "react";
 import { createRoot } from "react-dom/client";
-import { RAStackProvider, useRastackClient } from "../provider";
-import type { RastackWasmModule } from "../provider/types";
 import { ThemeProvider } from "../theme";
 import { defineTheme } from "../tokens";
 import { AdminApp } from "./AdminApp";
@@ -26,62 +18,23 @@ import { BootScreen } from "./ui/BootScreen";
 
 interface AdminConfig {
   mode: "local" | "remote";
-  /** Remote: base URL the `/api/...` paths are joined onto (default same origin). */
+  /** Base URL the `/api/...` paths are joined onto (default same origin). */
   apiBase?: string;
   /** Where to fetch the compiled `schema.rastack.json`. */
   schemaUrl?: string;
-  /** Local: base URL of the committed Iceberg warehouse to seed from. */
-  warehouseBaseUrl?: string;
 }
 
 const cfg: AdminConfig =
   (typeof window !== "undefined" && (window as any).__RASTACK_ADMIN__) || {
-    mode: "local",
+    mode: "remote",
     schemaUrl: "/schema.rastack.json",
-    warehouseBaseUrl: "/data/warehouse/",
   };
 
 // The framework's own design system paints the whole console.
 const theme = defineTheme({ brand: "#4F6BFF", radius: "rounded" });
 
-/** Load the WASM engine from the URL `rastack dev` serves it at (`/wasm/…`). */
-const loadEngine = async (): Promise<RastackWasmModule> => {
-  const runtimeImport = new Function("s", "return import(s)") as (
-    s: string,
-  ) => Promise<any>;
-  const mod: RastackWasmModule = await runtimeImport("/wasm/rastack_wasm.js");
-  const init = mod.default || mod.init;
-  if (typeof init === "function") await init();
-  return mod;
-};
-
-/** Local (WASM) admin: wait for the provider's engine, then render. */
-function LocalAdmin({ resources }: { resources: AdminResource[] }): React.JSX.Element {
-  const client = useRastackClient();
-  if (client.status === "error")
-    return (
-      <BootScreen
-        error
-        label="The WASM engine failed to start — check the console."
-      />
-    );
-  if (!client.engine || client.status !== "ready")
-    return (
-      <BootScreen
-        label={
-          client.status === "seeding"
-            ? "Seeding the local warehouse…"
-            : "Starting the WASM engine…"
-        }
-      />
-    );
-  return <AdminApp engine={client.engine} resources={resources} />;
-}
-
 function Boot(): React.JSX.Element {
   const [resources, setResources] = useState<AdminResource[] | null>(null);
-  const [manifest, setManifest] = useState<object | null>(null);
-  const [openapi, setOpenapi] = useState<object | undefined>();
   const [error, setError] = useState<string>();
   const httpEngine = useMemo(() => createHttpEngine(cfg.apiBase ?? ""), []);
 
@@ -91,16 +44,7 @@ function Boot(): React.JSX.Element {
       const res = await fetch(schemaUrl);
       if (!res.ok) throw new Error(`${schemaUrl} (${res.status})`);
       const doc = await res.json();
-      setManifest(doc);
       setResources(parseManifest(doc));
-      if (cfg.mode === "local") {
-        try {
-          const o = await fetch("/openapi.json");
-          if (o.ok) setOpenapi(await o.json());
-        } catch {
-          /* openapi is optional */
-        }
-      }
     })().catch((e) => setError(String(e)));
   }, []);
 
@@ -110,35 +54,17 @@ function Boot(): React.JSX.Element {
         <BootScreen error label={`Failed to load the schema: ${error}`} />
       </ThemeProvider>
     );
-  if (!resources || !manifest)
+  if (!resources)
     return (
       <ThemeProvider tokens={theme}>
         <BootScreen label="Loading the schema…" />
       </ThemeProvider>
     );
 
-  if (cfg.mode === "remote") {
-    return (
-      <ThemeProvider tokens={theme}>
-        <AdminApp engine={httpEngine} resources={resources} />
-      </ThemeProvider>
-    );
-  }
-
   return (
-    <RAStackProvider
-      mode="local"
-      manifest={manifest}
-      openapi={openapi}
-      loadEngine={loadEngine}
-      warehouseBaseUrl={cfg.warehouseBaseUrl ?? "/data/warehouse/"}
-      persist={false}
-      cache={false}
-    >
-      <ThemeProvider tokens={theme}>
-        <LocalAdmin resources={resources} />
-      </ThemeProvider>
-    </RAStackProvider>
+    <ThemeProvider tokens={theme}>
+      <AdminApp engine={httpEngine} resources={resources} />
+    </ThemeProvider>
   );
 }
 

package/admin/ui/icons.tsx

@@ -152,6 +152,15 @@ export const IconArrowUpRight = (p: SvgProps) => (
   </Svg>
 );
 
+export const IconRefresh = (p: SvgProps) => (
+  <Svg {...p}>
+    <path d="M3 12a9 9 0 0 1 15-6.7L21 8" />
+    <path d="M21 3v5h-5" />
+    <path d="M21 12a9 9 0 0 1-15 6.7L3 16" />
+    <path d="M3 21v-5h5" />
+  </Svg>
+);
+
 export const IconPanelLeft = (p: SvgProps) => (
   <Svg {...p}>
     <rect x="3.5" y="4.5" width="17" height="15" rx="2" />

package/admin/ui/styles.ts

@@ -192,6 +192,8 @@ a { color: inherit; text-decoration: none; }
   transition: background 0.14s, color 0.14s, border-color 0.14s;
 }
 .ras-icon-btn:hover { color: var(--color-text); border-color: color-mix(in srgb, var(--color-text) 22%, transparent); }
+@keyframes ras-spin { to { transform: rotate(360deg); } }
+.ras-spin { animation: ras-spin 0.5s linear; }
 
 /* ---- top bar ------------------------------------------------------------- */
 .ras-topbar {
@@ -212,6 +214,7 @@ a { color: inherit; text-decoration: none; }
 .ras-crumbs a:hover { color: var(--color-text); }
 .ras-crumb-sep { color: color-mix(in srgb, var(--color-text-muted) 55%, transparent); }
 .ras-crumb-current { color: var(--color-text); font-weight: 600; }
+.ras-updated { font-size: 12.5px; color: var(--color-text-muted); white-space: nowrap; }
 
 .ras-content { padding: 26px 28px 64px; max-width: 1240px; width: 100%; }
 

package/admin/useAdmin.ts

@@ -7,7 +7,14 @@
  * one admin serves any app.
  */
 
-import { useCallback, useEffect, useMemo, useState } from "react";
+import {
+  createContext,
+  useCallback,
+  useContext,
+  useEffect,
+  useMemo,
+  useState,
+} from "react";
 import type { RastackEngine } from "../provider/types";
 import type { AutoFormField, AutoFormLike, TableQuery } from "../components/types";
 import type {
@@ -45,6 +52,30 @@ interface EngineResult {
 }
 const ok = (r: EngineResult) => r.status >= 200 && r.status < 300;
 
+/**
+ * A global "reload" signal for the admin. The engine holds the live data (the
+ * WASM warehouse under `rastack dev`, the real `rastack-server` under
+ * `rastack admin`), so a manual reload just re-runs the read effects against it.
+ * `nonce` bumps on every {@link RefreshApi.refresh}; the data hooks include it in
+ * their fetch deps so they refetch **without** resetting filters/paging. The
+ * default value keeps the hooks usable with no provider (tests, embedding).
+ */
+export interface RefreshApi {
+  nonce: number;
+  refresh: () => void;
+  /** Epoch ms of the most recent successful load (0 before the first). */
+  lastUpdated: number;
+  /** Called by the data hooks when a fetch resolves, to stamp {@link lastUpdated}. */
+  markUpdated: () => void;
+}
+export const RefreshContext = createContext<RefreshApi>({
+  nonce: 0,
+  refresh: () => {},
+  lastUpdated: 0,
+  markUpdated: () => {},
+});
+export const useRefresh = (): RefreshApi => useContext(RefreshContext);
+
 /** What `useResourceTable` returns: a `TableQuery` plus changelist controls. */
 export interface ResourceTable {
   query: TableQuery;
@@ -75,6 +106,7 @@ export function useResourceTable(
   const [isLoading, setLoading] = useState(true);
   const [error, setError] = useState<unknown>(undefined);
   const [tick, setTick] = useState(0);
+  const { nonce, markUpdated } = useRefresh();
 
   // Reset paging/search/filters when the resource changes.
   useEffect(() => {
@@ -111,6 +143,7 @@ export function useResourceTable(
           setData([]);
         }
         setLoading(false);
+        markUpdated();
       })
       .catch((e: unknown) => {
         if (cancelled) return;
@@ -121,7 +154,7 @@ export function useResourceTable(
     return () => {
       cancelled = true;
     };
-  }, [engine, resource.key, resource.app, resource.model, page, search, filterKey, tick]);
+  }, [engine, resource.key, resource.app, resource.model, page, search, filterKey, tick, nonce]);
 
   const setSearch = (v: string | undefined) => {
     setSearchState(v && v.length ? v : undefined);
@@ -447,6 +480,7 @@ export function useDashboardStats(
 ): DashboardStats {
   const models = useMemo(() => adminResources(resources), [resources]);
   const [counts, setCounts] = useState<Record<string, number> | null>(null);
+  const { nonce, markUpdated } = useRefresh();
 
   useEffect(() => {
     let cancelled = false;
@@ -467,12 +501,15 @@ export function useDashboardStats(
           }
         }),
       );
-      if (!cancelled) setCounts(Object.fromEntries(entries));
+      if (!cancelled) {
+        setCounts(Object.fromEntries(entries));
+        markUpdated();
+      }
     })();
     return () => {
       cancelled = true;
     };
-  }, [engine, models]);
+  }, [engine, models, nonce]);
 
   return useMemo((): DashboardStats => {
     const loading = counts === null;