hassanzohdy/atom/stores

// app/users/page.tsx (Next.js server component)
const userAtom = createAtom({ key: "auth.user", default: { name: "Anon" } });
// During Request A
userAtom.update({ name: "Alice" });
// During Request B (concurrent), reading userAtom.value sees "Alice".
// That's a cross-request leak — the bug that AtomStore exists to fix.

import { AtomStore, createAtomStore } from "@mongez/atom";
const store = createAtomStore();   // or new AtomStore()
// Lazily clones the original atom on first access.
const scopedUser = store.use(userAtom);
scopedUser.update({ name: "Alice" });    // only this store sees it
userAtom.value;                          // still { name: "Anon" }

class AtomStore {
  use<V, A>(template: Atom<V, A>): Atom<V, A>;
  get<V>(key: string): Atom<V> | undefined;
  has(key: string): boolean;
  list(): Atom<any>[];
  hydrate(snapshot: Record<string, unknown>): void;
  snapshot(): Record<string, unknown>;
  destroy(): void;
}

// Server (Express, Fastify, or any framework middleware)
import { createAtomStore } from "@mongez/atom";
app.get("/users", async (req, res) => {
  const store = createAtomStore();
  store.hydrate({ "auth.user": req.user });   // pre-seed from cookies/headers
  try {
    // Render with `store` made available via React context.
    const html = renderToString(<AppShell store={store} />);
    const payload = JSON.stringify(store.snapshot());
    res.send(/* HTML + embedded payload */);
  } finally {
    store.destroy();
  }
});