on-zero 0.14.3 → 0.14.4

package/dist/esm/provideZero.eagerInstance.test.mjs

@@ -0,0 +1,197 @@
+import { createSchema, string, table } from "@rocicorp/zero";
+import { useZero } from "@rocicorp/zero/react";
+import { act, StrictMode } from "react";
+import { createRoot } from "react-dom/client";
+import { renderToString } from "react-dom/server";
+import { afterEach, beforeEach, expect, test, vi } from "vitest";
+import { createZeroClient } from "./createZeroClient.mjs";
+import { jsx } from "react/jsx-runtime";
+const fakeZero = vi.hoisted(() => {
+  const instances = [];
+  class FakeZero {
+    clientID;
+    context = {};
+    query = {};
+    connection = {
+      state: {
+        current: {
+          name: "connecting"
+        },
+        subscribe: () => () => {}
+      },
+      connect: vi.fn(async () => {})
+    };
+    close = vi.fn();
+    delete = vi.fn(async () => ({
+      errors: []
+    }));
+    run = vi.fn(async () => []);
+    constructor(options) {
+      instances.push(this);
+      this.clientID = `fake-${instances.length}-${options.userID ?? "anon"}`;
+    }
+  }
+  return {
+    FakeZero,
+    instances
+  };
+});
+vi.mock("@rocicorp/zero", async importOriginal => {
+  const actual = await importOriginal();
+  return {
+    ...actual,
+    Zero: fakeZero.FakeZero
+  };
+});
+globalThis.IS_REACT_ACT_ENVIRONMENT = true;
+const todoTable = table("todo").columns({
+  id: string(),
+  title: string()
+}).primaryKey("id");
+const schema = createSchema({
+  tables: [todoTable]
+});
+let clientCount = 0;
+const makeClient = () => createZeroClient({
+  schema,
+  models: {},
+  groupedQueries: {},
+  instanceName: `eager-instance-${++clientCount}`
+});
+let container;
+let root;
+beforeEach(() => {
+  fakeZero.instances.length = 0;
+  container = document.createElement("div");
+  root = null;
+});
+afterEach(() => {
+  if (root) act(() => root?.unmount());
+});
+test("a consumer reading zero in its first render gets a live instance, with no effects flushed", () => {
+  const client = makeClient();
+  const install = vi.fn();
+  const seen = {};
+  const Probe = () => {
+    seen.transportInstalled = install.mock.calls.length > 0;
+    seen.contextClientID = useZero().clientID;
+    try {
+      seen.facadeClientID = client.zero.clientID;
+    } catch (error) {
+      seen.error = error.message;
+    }
+    return null;
+  };
+  renderToString(/* @__PURE__ */jsx(client.ProvideZero, {
+    cacheURL: "http://127.0.0.1:7788/zero",
+    userID: "first-render",
+    transport: {
+      install
+    },
+    children: /* @__PURE__ */jsx(Probe, {})
+  }));
+  expect(seen.error).toBeUndefined();
+  expect(fakeZero.instances.length).toBe(1);
+  expect(seen.facadeClientID).toBe(fakeZero.instances[0].clientID);
+  expect(seen.contextClientID).toBe(fakeZero.instances[0].clientID);
+  expect(seen.transportInstalled).toBe(true);
+});
+test("the first committed render already carries the real instance", () => {
+  const client = makeClient();
+  const clientIDs = [];
+  const Probe = () => {
+    clientIDs.push(useZero().clientID);
+    return null;
+  };
+  root = createRoot(container);
+  act(() => {
+    root?.render(/* @__PURE__ */jsx(client.ProvideZero, {
+      cacheURL: "http://127.0.0.1:7788/zero",
+      userID: "committed",
+      children: /* @__PURE__ */jsx(Probe, {})
+    }));
+  });
+  expect(clientIDs.length).toBeGreaterThan(0);
+  expect(clientIDs).not.toContain("disabled");
+  expect(clientIDs[0]).toBe(fakeZero.instances[0].clientID);
+});
+test("StrictMode double-invoked render constructs exactly one instance", () => {
+  const client = makeClient();
+  root = createRoot(container);
+  act(() => {
+    root?.render(/* @__PURE__ */jsx(StrictMode, {
+      children: /* @__PURE__ */jsx(client.ProvideZero, {
+        cacheURL: "http://127.0.0.1:7788/zero",
+        userID: "strict",
+        children: /* @__PURE__ */jsx("span", {
+          children: "ok"
+        })
+      })
+    }));
+  });
+  expect(fakeZero.instances.length).toBe(1);
+  expect(fakeZero.instances[0].close).not.toHaveBeenCalled();
+});
+test("an identity change rotates the instance and closes the outgoing one", () => {
+  const client = makeClient();
+  root = createRoot(container);
+  const render = userID => act(() => {
+    root?.render(/* @__PURE__ */jsx(client.ProvideZero, {
+      cacheURL: "http://127.0.0.1:7788/zero",
+      userID,
+      children: /* @__PURE__ */jsx("span", {
+        children: "ok"
+      })
+    }));
+  });
+  render("one");
+  expect(fakeZero.instances.length).toBe(1);
+  render("two");
+  expect(fakeZero.instances.length).toBe(2);
+  expect(fakeZero.instances[0].close).toHaveBeenCalled();
+  expect(fakeZero.instances[1].close).not.toHaveBeenCalled();
+});
+test("a rotation that never commits is undone, not duplicated", () => {
+  const client = makeClient();
+  root = createRoot(container);
+  const mount = userID => act(() => {
+    root?.render(/* @__PURE__ */jsx(client.ProvideZero, {
+      cacheURL: "http://127.0.0.1:7788/zero",
+      userID,
+      children: /* @__PURE__ */jsx("span", {
+        children: "ok"
+      })
+    }));
+  });
+  mount("committed");
+  const first = fakeZero.instances[0];
+  renderToString(/* @__PURE__ */jsx(client.ProvideZero, {
+    cacheURL: "http://127.0.0.1:7788/zero",
+    userID: "abandoned",
+    children: /* @__PURE__ */jsx("span", {
+      children: "ok"
+    })
+  }));
+  expect(fakeZero.instances.length).toBe(2);
+  expect(first.close).not.toHaveBeenCalled();
+  mount("committed");
+  expect(fakeZero.instances.length).toBe(2);
+  expect(first.close).not.toHaveBeenCalled();
+  expect(fakeZero.instances[1].close).toHaveBeenCalled();
+});
+test("disable=true constructs nothing", () => {
+  const client = makeClient();
+  root = createRoot(container);
+  act(() => {
+    root?.render(/* @__PURE__ */jsx(client.ProvideZero, {
+      cacheURL: "http://127.0.0.1:7788/zero",
+      userID: "off",
+      disable: true,
+      children: /* @__PURE__ */jsx("span", {
+        children: "ok"
+      })
+    }));
+  });
+  expect(fakeZero.instances.length).toBe(0);
+});
+//# sourceMappingURL=provideZero.eagerInstance.test.mjs.map

package/dist/esm/provideZero.eagerInstance.test.mjs.map

@@ -0,0 +1 @@
+{"version":3,"names":["createSchema","string","table","useZero","act","StrictMode","createRoot","renderToString","afterEach","beforeEach","expect","test","vi","createZeroClient","jsx","fakeZero","hoisted","instances","FakeZero","clientID","context","query","connection","state","current","name","subscribe","connect","fn","close","delete","errors","run","constructor","options","push","length","userID","mock","importOriginal","actual","Zero","globalThis","IS_REACT_ACT_ENVIRONMENT","todoTable","columns","id","title","primaryKey","schema","tables","clientCount","makeClient","models","groupedQueries","instanceName","container","root","document","createElement","unmount","client","install","seen","Probe","transportInstalled","calls","contextClientID","facadeClientID","zero","error","message","ProvideZero","cacheURL","transport","children","toBeUndefined","toBe","clientIDs","render","toBeGreaterThan","not","toContain","toHaveBeenCalled","mount","first","disable"],"sources":["../../src/provideZero.eagerInstance.test.tsx"],"sourcesContent":[null],"mappings":"AAcA,SAASA,YAAA,EAAcC,MAAA,EAAQC,KAAA,QAAa;AAC5C,SAASC,OAAA,QAAe;AACxB,SAASC,GAAA,EAAKC,UAAA,QAAkB;AAChC,SAASC,UAAA,QAA6B;AACtC,SAASC,cAAA,QAAsB;AAC/B,SAASC,SAAA,EAAWC,UAAA,EAAYC,MAAA,EAAQC,IAAA,EAAMC,EAAA,QAAU;AA8BxD,SAASC,gBAAA,QAAwB;AAoE3B,SAAAC,GAAA;AA9FN,MAAMC,QAAA,GAAWH,EAAA,CAAGI,OAAA,CAAQ,MAAM;EAChC,MAAMC,SAAA,GAAmB,EAAC;EAC1B,MAAMC,QAAA,CAAS;IACJC,QAAA;IACAC,OAAA,GAAU,CAAC;IACXC,KAAA,GAAQ,CAAC;IACTC,UAAA,GAAa;MACpBC,KAAA,EAAO;QAAEC,OAAA,EAAS;UAAEC,IAAA,EAAM;QAAa;QAAGC,SAAA,EAAWA,CAAA,KAAM,MAAM,CAAC;MAAE;MACpEC,OAAA,EAASf,EAAA,CAAGgB,EAAA,CAAG,YAAY,CAAC,CAAC;IAC/B;IACSC,KAAA,GAAQjB,EAAA,CAAGgB,EAAA,CAAG;IACdE,MAAA,GAASlB,EAAA,CAAGgB,EAAA,CAAG,aAAa;MAAEG,MAAA,EAAQ;IAAG,EAAE;IAC3CC,GAAA,GAAMpB,EAAA,CAAGgB,EAAA,CAAG,YAAY,EAAE;IACnCK,YAAYC,OAAA,EAA8B;MACxCjB,SAAA,CAAUkB,IAAA,CAAK,IAAI;MACnB,KAAKhB,QAAA,GAAW,QAAQF,SAAA,CAAUmB,MAAM,IAAIF,OAAA,CAAQG,MAAA,IAAU,MAAM;IACtE;EACF;EACA,OAAO;IAAEnB,QAAA;IAAUD;EAAU;AAC/B,CAAC;AAEDL,EAAA,CAAG0B,IAAA,CAAK,kBAAkB,MAAOC,cAAA,IAAmB;EAClD,MAAMC,MAAA,GAAS,MAAMD,cAAA,CAAgD;EACrE,OAAO;IAAE,GAAGC,MAAA;IAAQC,IAAA,EAAM1B,QAAA,CAASG;EAAS;AAC9C,CAAC;AAQDwB,UAAA,CAAWC,wBAAA,GAA2B;AAEtC,MAAMC,SAAA,GAAY1C,KAAA,CAAM,MAAM,EAC3B2C,OAAA,CAAQ;EAAEC,EAAA,EAAI7C,MAAA,CAAO;EAAG8C,KAAA,EAAO9C,MAAA,CAAO;AAAE,CAAC,EACzC+C,UAAA,CAAW,IAAI;AAClB,MAAMC,MAAA,GAASjD,YAAA,CAAa;EAAEkD,MAAA,EAAQ,CAACN,SAAS;AAAE,CAAC;AAEnD,IAAIO,WAAA,GAAc;AAGlB,MAAMC,UAAA,GAAaA,CAAA,KACjBvC,gBAAA,CAAiB;EACfoC,MAAA;EACAI,MAAA,EAAQ,CAAC;EACTC,cAAA,EAAgB,CAAC;EACjBC,YAAA,EAAc,kBAAkB,EAAEJ,WAAW;AAC/C,CAAC;AAEH,IAAIK,SAAA;AACJ,IAAIC,IAAA;AAEJhD,UAAA,CAAW,MAAM;EACfM,QAAA,CAASE,SAAA,CAAUmB,MAAA,GAAS;EAC5BoB,SAAA,GAAYE,QAAA,CAASC,aAAA,CAAc,KAAK;EACxCF,IAAA,GAAO;AACT,CAAC;AAEDjD,SAAA,CAAU,MAAM;EACd,IAAIiD,IAAA,EAAMrD,GAAA,CAAI,MAAMqD,IAAA,EAAMG,OAAA,CAAQ,CAAC;AACrC,CAAC;AAEDjD,IAAA,CAAK,6FAA6F,MAAM;EACtG,MAAMkD,MAAA,GAAST,UAAA,CAAW;EAC1B,MAAMU,OAAA,GAAUlD,EAAA,CAAGgB,EAAA,CAAG;EACtB,MAAMmC,IAAA,GAKF,CAAC;EAEL,MAAMC,KAAA,GAAQA,CAAA,KAAM;IAGlBD,IAAA,CAAKE,kBAAA,GAAqBH,OAAA,CAAQxB,IAAA,CAAK4B,KAAA,CAAM9B,MAAA,GAAS;IACtD2B,IAAA,CAAKI,eAAA,GAAmBhE,OAAA,CAAQ,EAAsCgB,QAAA;IACtE,IAAI;MACF4C,IAAA,CAAKK,cAAA,GAAkBP,MAAA,CAAOQ,IAAA,CAAyClD,QAAA;IACzE,SAASmD,KAAA,EAAO;MACdP,IAAA,CAAKO,KAAA,GAASA,KAAA,CAAgBC,OAAA;IAChC;IACA,OAAO;EACT;EAIAhE,cAAA,CACE,eAAAO,GAAA,CAAC+C,MAAA,CAAOW,WAAA,EAAP;IACCC,QAAA,EAAS;IACTpC,MAAA,EAAO;IACPqC,SAAA,EAAW;MAAEZ;IAAQ;IAErBa,QAAA,iBAAA7D,GAAA,CAACkD,KAAA,IAAM;EAAA,CACT,CACF;EAEAtD,MAAA,CAAOqD,IAAA,CAAKO,KAAK,EAAEM,aAAA,CAAc;EACjClE,MAAA,CAAOK,QAAA,CAASE,SAAA,CAAUmB,MAAM,EAAEyC,IAAA,CAAK,CAAC;EACxCnE,MAAA,CAAOqD,IAAA,CAAKK,cAAc,EAAES,IAAA,CAAK9D,QAAA,CAASE,SAAA,CAAU,CAAC,EAAEE,QAAQ;EAC/DT,MAAA,CAAOqD,IAAA,CAAKI,eAAe,EAAEU,IAAA,CAAK9D,QAAA,CAASE,SAAA,CAAU,CAAC,EAAEE,QAAQ;EAChET,MAAA,CAAOqD,IAAA,CAAKE,kBAAkB,EAAEY,IAAA,CAAK,IAAI;AAC3C,CAAC;AAEDlE,IAAA,CAAK,gEAAgE,MAAM;EACzE,MAAMkD,MAAA,GAAST,UAAA,CAAW;EAC1B,MAAM0B,SAAA,GAAsB,EAAC;EAC7B,MAAMd,KAAA,GAAQA,CAAA,KAAM;IAClBc,SAAA,CAAU3C,IAAA,CAAMhC,OAAA,CAAQ,EAAsCgB,QAAQ;IACtE,OAAO;EACT;EAEAsC,IAAA,GAAOnD,UAAA,CAAWkD,SAAS;EAC3BpD,GAAA,CAAI,MAAM;IACRqD,IAAA,EAAMsB,MAAA,CACJ,eAAAjE,GAAA,CAAC+C,MAAA,CAAOW,WAAA,EAAP;MAAmBC,QAAA,EAAS;MAA6BpC,MAAA,EAAO;MAC/DsC,QAAA,iBAAA7D,GAAA,CAACkD,KAAA,IAAM;IAAA,CACT,CACF;EACF,CAAC;EAGDtD,MAAA,CAAOoE,SAAA,CAAU1C,MAAM,EAAE4C,eAAA,CAAgB,CAAC;EAC1CtE,MAAA,CAAOoE,SAAS,EAAEG,GAAA,CAAIC,SAAA,CAAU,UAAU;EAC1CxE,MAAA,CAAOoE,SAAA,CAAU,CAAC,CAAC,EAAED,IAAA,CAAK9D,QAAA,CAASE,SAAA,CAAU,CAAC,EAAEE,QAAQ;AAC1D,CAAC;AAEDR,IAAA,CAAK,oEAAoE,MAAM;EAC7E,MAAMkD,MAAA,GAAST,UAAA,CAAW;EAC1BK,IAAA,GAAOnD,UAAA,CAAWkD,SAAS;EAC3BpD,GAAA,CAAI,MAAM;IACRqD,IAAA,EAAMsB,MAAA,CACJ,eAAAjE,GAAA,CAACT,UAAA;MACCsE,QAAA,iBAAA7D,GAAA,CAAC+C,MAAA,CAAOW,WAAA,EAAP;QAAmBC,QAAA,EAAS;QAA6BpC,MAAA,EAAO;QAC/DsC,QAAA,iBAAA7D,GAAA,CAAC;UAAK6D,QAAA;QAAA,CAAE;MAAA,CACV;IAAA,CACF,CACF;EACF,CAAC;EAEDjE,MAAA,CAAOK,QAAA,CAASE,SAAA,CAAUmB,MAAM,EAAEyC,IAAA,CAAK,CAAC;EACxCnE,MAAA,CAAOK,QAAA,CAASE,SAAA,CAAU,CAAC,EAAEY,KAAK,EAAEoD,GAAA,CAAIE,gBAAA,CAAiB;AAC3D,CAAC;AAEDxE,IAAA,CAAK,uEAAuE,MAAM;EAChF,MAAMkD,MAAA,GAAST,UAAA,CAAW;EAC1BK,IAAA,GAAOnD,UAAA,CAAWkD,SAAS;EAC3B,MAAMuB,MAAA,GAAU1C,MAAA,IACdjC,GAAA,CAAI,MAAM;IACRqD,IAAA,EAAMsB,MAAA,CACJ,eAAAjE,GAAA,CAAC+C,MAAA,CAAOW,WAAA,EAAP;MAAmBC,QAAA,EAAS;MAA6BpC,MAAA;MACxDsC,QAAA,iBAAA7D,GAAA,CAAC;QAAK6D,QAAA;MAAA,CAAE;IAAA,CACV,CACF;EACF,CAAC;EAEHI,MAAA,CAAO,KAAK;EACZrE,MAAA,CAAOK,QAAA,CAASE,SAAA,CAAUmB,MAAM,EAAEyC,IAAA,CAAK,CAAC;EACxCE,MAAA,CAAO,KAAK;EACZrE,MAAA,CAAOK,QAAA,CAASE,SAAA,CAAUmB,MAAM,EAAEyC,IAAA,CAAK,CAAC;EACxCnE,MAAA,CAAOK,QAAA,CAASE,SAAA,CAAU,CAAC,EAAEY,KAAK,EAAEsD,gBAAA,CAAiB;EACrDzE,MAAA,CAAOK,QAAA,CAASE,SAAA,CAAU,CAAC,EAAEY,KAAK,EAAEoD,GAAA,CAAIE,gBAAA,CAAiB;AAC3D,CAAC;AAEDxE,IAAA,CAAK,2DAA2D,MAAM;EACpE,MAAMkD,MAAA,GAAST,UAAA,CAAW;EAC1BK,IAAA,GAAOnD,UAAA,CAAWkD,SAAS;EAC3B,MAAM4B,KAAA,GAAS/C,MAAA,IACbjC,GAAA,CAAI,MAAM;IACRqD,IAAA,EAAMsB,MAAA,CACJ,eAAAjE,GAAA,CAAC+C,MAAA,CAAOW,WAAA,EAAP;MAAmBC,QAAA,EAAS;MAA6BpC,MAAA;MACxDsC,QAAA,iBAAA7D,GAAA,CAAC;QAAK6D,QAAA;MAAA,CAAE;IAAA,CACV,CACF;EACF,CAAC;EAEHS,KAAA,CAAM,WAAW;EACjB,MAAMC,KAAA,GAAQtE,QAAA,CAASE,SAAA,CAAU,CAAC;EAIlCV,cAAA,CACE,eAAAO,GAAA,CAAC+C,MAAA,CAAOW,WAAA,EAAP;IAAmBC,QAAA,EAAS;IAA6BpC,MAAA,EAAO;IAC/DsC,QAAA,iBAAA7D,GAAA,CAAC;MAAK6D,QAAA;IAAA,CAAE;EAAA,CACV,CACF;EACAjE,MAAA,CAAOK,QAAA,CAASE,SAAA,CAAUmB,MAAM,EAAEyC,IAAA,CAAK,CAAC;EAExCnE,MAAA,CAAO2E,KAAA,CAAMxD,KAAK,EAAEoD,GAAA,CAAIE,gBAAA,CAAiB;EAIzCC,KAAA,CAAM,WAAW;EACjB1E,MAAA,CAAOK,QAAA,CAASE,SAAA,CAAUmB,MAAM,EAAEyC,IAAA,CAAK,CAAC;EACxCnE,MAAA,CAAO2E,KAAA,CAAMxD,KAAK,EAAEoD,GAAA,CAAIE,gBAAA,CAAiB;EACzCzE,MAAA,CAAOK,QAAA,CAASE,SAAA,CAAU,CAAC,EAAEY,KAAK,EAAEsD,gBAAA,CAAiB;AACvD,CAAC;AAEDxE,IAAA,CAAK,mCAAmC,MAAM;EAC5C,MAAMkD,MAAA,GAAST,UAAA,CAAW;EAC1BK,IAAA,GAAOnD,UAAA,CAAWkD,SAAS;EAC3BpD,GAAA,CAAI,MAAM;IACRqD,IAAA,EAAMsB,MAAA,CACJ,eAAAjE,GAAA,CAAC+C,MAAA,CAAOW,WAAA,EAAP;MAAmBC,QAAA,EAAS;MAA6BpC,MAAA,EAAO;MAAMiD,OAAA,EAAO;MAC5EX,QAAA,iBAAA7D,GAAA,CAAC;QAAK6D,QAAA;MAAA,CAAE;IAAA,CACV,CACF;EACF,CAAC;EAEDjE,MAAA,CAAOK,QAAA,CAASE,SAAA,CAAUmB,MAAM,EAAEyC,IAAA,CAAK,CAAC;AAC1C,CAAC","ignoreList":[]}

package/dist/esm/provideZero.eagerInstance.test.native.js

@@ -0,0 +1,227 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createSchema, string, table } from "@rocicorp/zero";
+import { useZero } from "@rocicorp/zero/react";
+import { act, StrictMode } from "react";
+import { createRoot } from "react-dom/client";
+import { renderToString } from "react-dom/server";
+import { afterEach, beforeEach, expect, test, vi } from "vitest";
+import { createZeroClient } from "./createZeroClient.native.js";
+function _class_call_check(instance, Constructor) {
+  if (!(instance instanceof Constructor)) throw new TypeError("Cannot call a class as a function");
+}
+function _define_property(obj, key, value) {
+  if (key in obj) {
+    Object.defineProperty(obj, key, {
+      value,
+      enumerable: true,
+      configurable: true,
+      writable: true
+    });
+  } else obj[key] = value;
+  return obj;
+}
+var fakeZero = vi.hoisted(function () {
+  var instances = [];
+  var FakeZero = function FakeZero2(options) {
+    "use strict";
+
+    _class_call_check(this, FakeZero2);
+    var _options_userID;
+    _define_property(this, "clientID", void 0);
+    _define_property(this, "context", {});
+    _define_property(this, "query", {});
+    _define_property(this, "connection", {
+      state: {
+        current: {
+          name: "connecting"
+        },
+        subscribe: function subscribe() {
+          return function () {};
+        }
+      },
+      connect: vi.fn(async function () {})
+    });
+    _define_property(this, "close", vi.fn());
+    _define_property(this, "delete", vi.fn(async function () {
+      return {
+        errors: []
+      };
+    }));
+    _define_property(this, "run", vi.fn(async function () {
+      return [];
+    }));
+    instances.push(this);
+    this.clientID = `fake-${instances.length}-${(_options_userID = options.userID) !== null && _options_userID !== void 0 ? _options_userID : "anon"}`;
+  };
+  return {
+    FakeZero,
+    instances
+  };
+});
+vi.mock("@rocicorp/zero", async function (importOriginal) {
+  var actual = await importOriginal();
+  return {
+    ...actual,
+    Zero: fakeZero.FakeZero
+  };
+});
+globalThis.IS_REACT_ACT_ENVIRONMENT = true;
+var todoTable = table("todo").columns({
+  id: string(),
+  title: string()
+}).primaryKey("id");
+var schema = createSchema({
+  tables: [todoTable]
+});
+var clientCount = 0;
+var makeClient = function makeClient2() {
+  return createZeroClient({
+    schema,
+    models: {},
+    groupedQueries: {},
+    instanceName: `eager-instance-${++clientCount}`
+  });
+};
+var container;
+var root;
+beforeEach(function () {
+  fakeZero.instances.length = 0;
+  container = document.createElement("div");
+  root = null;
+});
+afterEach(function () {
+  if (root) act(function () {
+    return root === null || root === void 0 ? void 0 : root.unmount();
+  });
+});
+test("a consumer reading zero in its first render gets a live instance, with no effects flushed", function () {
+  var client = makeClient();
+  var install = vi.fn();
+  var seen = {};
+  var Probe = function Probe2() {
+    seen.transportInstalled = install.mock.calls.length > 0;
+    seen.contextClientID = useZero().clientID;
+    try {
+      seen.facadeClientID = client.zero.clientID;
+    } catch (error) {
+      seen.error = error.message;
+    }
+    return null;
+  };
+  renderToString(/* @__PURE__ */_jsx(client.ProvideZero, {
+    cacheURL: "http://127.0.0.1:7788/zero",
+    userID: "first-render",
+    transport: {
+      install
+    },
+    children: /* @__PURE__ */_jsx(Probe, {})
+  }));
+  expect(seen.error).toBeUndefined();
+  expect(fakeZero.instances.length).toBe(1);
+  expect(seen.facadeClientID).toBe(fakeZero.instances[0].clientID);
+  expect(seen.contextClientID).toBe(fakeZero.instances[0].clientID);
+  expect(seen.transportInstalled).toBe(true);
+});
+test("the first committed render already carries the real instance", function () {
+  var client = makeClient();
+  var clientIDs = [];
+  var Probe = function Probe2() {
+    clientIDs.push(useZero().clientID);
+    return null;
+  };
+  root = createRoot(container);
+  act(function () {
+    root === null || root === void 0 ? void 0 : root.render(/* @__PURE__ */_jsx(client.ProvideZero, {
+      cacheURL: "http://127.0.0.1:7788/zero",
+      userID: "committed",
+      children: /* @__PURE__ */_jsx(Probe, {})
+    }));
+  });
+  expect(clientIDs.length).toBeGreaterThan(0);
+  expect(clientIDs).not.toContain("disabled");
+  expect(clientIDs[0]).toBe(fakeZero.instances[0].clientID);
+});
+test("StrictMode double-invoked render constructs exactly one instance", function () {
+  var client = makeClient();
+  root = createRoot(container);
+  act(function () {
+    root === null || root === void 0 ? void 0 : root.render(/* @__PURE__ */_jsx(StrictMode, {
+      children: /* @__PURE__ */_jsx(client.ProvideZero, {
+        cacheURL: "http://127.0.0.1:7788/zero",
+        userID: "strict",
+        children: /* @__PURE__ */_jsx("span", {
+          children: "ok"
+        })
+      })
+    }));
+  });
+  expect(fakeZero.instances.length).toBe(1);
+  expect(fakeZero.instances[0].close).not.toHaveBeenCalled();
+});
+test("an identity change rotates the instance and closes the outgoing one", function () {
+  var client = makeClient();
+  root = createRoot(container);
+  var render = function render2(userID) {
+    return act(function () {
+      root === null || root === void 0 ? void 0 : root.render(/* @__PURE__ */_jsx(client.ProvideZero, {
+        cacheURL: "http://127.0.0.1:7788/zero",
+        userID,
+        children: /* @__PURE__ */_jsx("span", {
+          children: "ok"
+        })
+      }));
+    });
+  };
+  render("one");
+  expect(fakeZero.instances.length).toBe(1);
+  render("two");
+  expect(fakeZero.instances.length).toBe(2);
+  expect(fakeZero.instances[0].close).toHaveBeenCalled();
+  expect(fakeZero.instances[1].close).not.toHaveBeenCalled();
+});
+test("a rotation that never commits is undone, not duplicated", function () {
+  var client = makeClient();
+  root = createRoot(container);
+  var mount = function mount2(userID) {
+    return act(function () {
+      root === null || root === void 0 ? void 0 : root.render(/* @__PURE__ */_jsx(client.ProvideZero, {
+        cacheURL: "http://127.0.0.1:7788/zero",
+        userID,
+        children: /* @__PURE__ */_jsx("span", {
+          children: "ok"
+        })
+      }));
+    });
+  };
+  mount("committed");
+  var first = fakeZero.instances[0];
+  renderToString(/* @__PURE__ */_jsx(client.ProvideZero, {
+    cacheURL: "http://127.0.0.1:7788/zero",
+    userID: "abandoned",
+    children: /* @__PURE__ */_jsx("span", {
+      children: "ok"
+    })
+  }));
+  expect(fakeZero.instances.length).toBe(2);
+  expect(first.close).not.toHaveBeenCalled();
+  mount("committed");
+  expect(fakeZero.instances.length).toBe(2);
+  expect(first.close).not.toHaveBeenCalled();
+  expect(fakeZero.instances[1].close).toHaveBeenCalled();
+});
+test("disable=true constructs nothing", function () {
+  var client = makeClient();
+  root = createRoot(container);
+  act(function () {
+    root === null || root === void 0 ? void 0 : root.render(/* @__PURE__ */_jsx(client.ProvideZero, {
+      cacheURL: "http://127.0.0.1:7788/zero",
+      userID: "off",
+      disable: true,
+      children: /* @__PURE__ */_jsx("span", {
+        children: "ok"
+      })
+    }));
+  });
+  expect(fakeZero.instances.length).toBe(0);
+});
+//# sourceMappingURL=provideZero.eagerInstance.test.native.js.map

package/dist/esm/provideZero.eagerInstance.test.native.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["jsx","_jsx","createSchema","string","table","useZero","act","StrictMode","createRoot","renderToString","afterEach","beforeEach","expect","test","vi","createZeroClient","_class_call_check","instance","Constructor","TypeError","_define_property","obj","key","value","Object","defineProperty","enumerable","configurable","writable","fakeZero","hoisted","instances","FakeZero","FakeZero2","options","_options_userID","state","current","name","subscribe","connect","fn","errors","push","clientID","length","userID","mock","importOriginal","actual","Zero","globalThis","IS_REACT_ACT_ENVIRONMENT","todoTable","columns","id","title","primaryKey","schema","tables","clientCount","makeClient","makeClient2","models","groupedQueries","instanceName","container","root","document","createElement","unmount","client","install","seen","Probe","Probe2","transportInstalled","calls","contextClientID","facadeClientID","zero","error","message","ProvideZero","cacheURL","transport","children","toBeUndefined","toBe","clientIDs","render","toBeGreaterThan","not","toContain"],"sources":["../../src/provideZero.eagerInstance.test.tsx"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

package/dist/esm/provideZero.ssr.test.mjs

@@ -0,0 +1,61 @@
+import { createSchema, string, table } from "@rocicorp/zero";
+import { useZero } from "@rocicorp/zero/react";
+import { renderToString } from "react-dom/server";
+import { expect, test, vi } from "vitest";
+import { createZeroClient } from "./createZeroClient.mjs";
+import { IS_SERVER_RUNTIME } from "./helpers/platform.mjs";
+import { jsx } from "react/jsx-runtime";
+const fakeZero = vi.hoisted(() => {
+  const instances = [];
+  class FakeZero {
+    constructor() {
+      instances.push(this);
+    }
+  }
+  return {
+    FakeZero,
+    instances
+  };
+});
+vi.mock("@rocicorp/zero", async importOriginal => {
+  const actual = await importOriginal();
+  return {
+    ...actual,
+    Zero: fakeZero.FakeZero
+  };
+});
+if (typeof window !== "undefined") {
+  throw new Error("provideZero.ssr.test.tsx must run with @vitest-environment node");
+}
+const todoTable = table("todo").columns({
+  id: string(),
+  title: string()
+}).primaryKey("id");
+const schema = createSchema({
+  tables: [todoTable]
+});
+const client = createZeroClient({
+  schema,
+  models: {},
+  groupedQueries: {},
+  instanceName: "ssr-eager-test"
+});
+test("the server runtime is what this file exercises", () => {
+  expect(IS_SERVER_RUNTIME).toBe(true);
+});
+test("rendering ProvideZero on the server constructs no client", () => {
+  let contextClientID;
+  const Probe = () => {
+    contextClientID = useZero().clientID;
+    return null;
+  };
+  renderToString(/* @__PURE__ */jsx(client.ProvideZero, {
+    cacheURL: "http://127.0.0.1:7788/zero",
+    userID: "ssr",
+    children: /* @__PURE__ */jsx(Probe, {})
+  }));
+  expect(fakeZero.instances.length).toBe(0);
+  expect(contextClientID).toBe("disabled");
+  expect(() => client.zero.clientID).toThrow(/Zero instance not initialized/);
+});
+//# sourceMappingURL=provideZero.ssr.test.mjs.map

package/dist/esm/provideZero.ssr.test.mjs.map

@@ -0,0 +1 @@
+{"version":3,"names":["createSchema","string","table","useZero","renderToString","expect","test","vi","createZeroClient","IS_SERVER_RUNTIME","jsx","fakeZero","hoisted","instances","FakeZero","constructor","push","mock","importOriginal","actual","Zero","window","Error","todoTable","columns","id","title","primaryKey","schema","tables","client","models","groupedQueries","instanceName","toBe","contextClientID","Probe","clientID","ProvideZero","cacheURL","userID","children","length","zero","toThrow"],"sources":["../../src/provideZero.ssr.test.tsx"],"sourcesContent":[null],"mappings":"AAOA,SAASA,YAAA,EAAcC,MAAA,EAAQC,KAAA,QAAa;AAC5C,SAASC,OAAA,QAAe;AACxB,SAASC,cAAA,QAAsB;AAC/B,SAASC,MAAA,EAAQC,IAAA,EAAMC,EAAA,QAAU;AAiBjC,SAASC,gBAAA,QAAwB;AACjC,SAASC,iBAAA,QAAyB;AA+B5B,SAAAC,GAAA;AA/CN,MAAMC,QAAA,GAAWJ,EAAA,CAAGK,OAAA,CAAQ,MAAM;EAChC,MAAMC,SAAA,GAAuB,EAAC;EAC9B,MAAMC,QAAA,CAAS;IACbC,YAAA,EAAc;MACZF,SAAA,CAAUG,IAAA,CAAK,IAAI;IACrB;EACF;EACA,OAAO;IAAEF,QAAA;IAAUD;EAAU;AAC/B,CAAC;AAEDN,EAAA,CAAGU,IAAA,CAAK,kBAAkB,MAAOC,cAAA,IAAmB;EAClD,MAAMC,MAAA,GAAS,MAAMD,cAAA,CAAgD;EACrE,OAAO;IAAE,GAAGC,MAAA;IAAQC,IAAA,EAAMT,QAAA,CAASG;EAAS;AAC9C,CAAC;AAKD,IAAI,OAAOO,MAAA,KAAW,aAAa;EACjC,MAAM,IAAIC,KAAA,CAAM,iEAAiE;AACnF;AAEA,MAAMC,SAAA,GAAYrB,KAAA,CAAM,MAAM,EAC3BsB,OAAA,CAAQ;EAAEC,EAAA,EAAIxB,MAAA,CAAO;EAAGyB,KAAA,EAAOzB,MAAA,CAAO;AAAE,CAAC,EACzC0B,UAAA,CAAW,IAAI;AAClB,MAAMC,MAAA,GAAS5B,YAAA,CAAa;EAAE6B,MAAA,EAAQ,CAACN,SAAS;AAAE,CAAC;AAEnD,MAAMO,MAAA,GAAStB,gBAAA,CAAiB;EAC9BoB,MAAA;EACAG,MAAA,EAAQ,CAAC;EACTC,cAAA,EAAgB,CAAC;EACjBC,YAAA,EAAc;AAChB,CAAC;AAED3B,IAAA,CAAK,kDAAkD,MAAM;EAC3DD,MAAA,CAAOI,iBAAiB,EAAEyB,IAAA,CAAK,IAAI;AACrC,CAAC;AAED5B,IAAA,CAAK,4DAA4D,MAAM;EACrE,IAAI6B,eAAA;EACJ,MAAMC,KAAA,GAAQA,CAAA,KAAM;IAClBD,eAAA,GAAmBhC,OAAA,CAAQ,EAAsCkC,QAAA;IACjE,OAAO;EACT;EAEAjC,cAAA,CACE,eAAAM,GAAA,CAACoB,MAAA,CAAOQ,WAAA,EAAP;IAAmBC,QAAA,EAAS;IAA6BC,MAAA,EAAO;IAC/DC,QAAA,iBAAA/B,GAAA,CAAC0B,KAAA,IAAM;EAAA,CACT,CACF;EAEA/B,MAAA,CAAOM,QAAA,CAASE,SAAA,CAAU6B,MAAM,EAAER,IAAA,CAAK,CAAC;EACxC7B,MAAA,CAAO8B,eAAe,EAAED,IAAA,CAAK,UAAU;EACvC7B,MAAA,CAAO,MAAOyB,MAAA,CAAOa,IAAA,CAAyCN,QAAQ,EAAEO,OAAA,CACtE,+BACF;AACF,CAAC","ignoreList":[]}

package/dist/esm/provideZero.ssr.test.native.js

@@ -0,0 +1,67 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createSchema, string, table } from "@rocicorp/zero";
+import { useZero } from "@rocicorp/zero/react";
+import { renderToString } from "react-dom/server";
+import { expect, test, vi } from "vitest";
+import { createZeroClient } from "./createZeroClient.native.js";
+import { IS_SERVER_RUNTIME } from "./helpers/platform.native.js";
+function _class_call_check(instance, Constructor) {
+  if (!(instance instanceof Constructor)) throw new TypeError("Cannot call a class as a function");
+}
+var fakeZero = vi.hoisted(function () {
+  var instances = [];
+  var FakeZero = function FakeZero2() {
+    "use strict";
+
+    _class_call_check(this, FakeZero2);
+    instances.push(this);
+  };
+  return {
+    FakeZero,
+    instances
+  };
+});
+vi.mock("@rocicorp/zero", async function (importOriginal) {
+  var actual = await importOriginal();
+  return {
+    ...actual,
+    Zero: fakeZero.FakeZero
+  };
+});
+if (typeof window !== "undefined") {
+  throw new Error("provideZero.ssr.test.tsx must run with @vitest-environment node");
+}
+var todoTable = table("todo").columns({
+  id: string(),
+  title: string()
+}).primaryKey("id");
+var schema = createSchema({
+  tables: [todoTable]
+});
+var client = createZeroClient({
+  schema,
+  models: {},
+  groupedQueries: {},
+  instanceName: "ssr-eager-test"
+});
+test("the server runtime is what this file exercises", function () {
+  expect(IS_SERVER_RUNTIME).toBe(true);
+});
+test("rendering ProvideZero on the server constructs no client", function () {
+  var contextClientID;
+  var Probe = function Probe2() {
+    contextClientID = useZero().clientID;
+    return null;
+  };
+  renderToString(/* @__PURE__ */_jsx(client.ProvideZero, {
+    cacheURL: "http://127.0.0.1:7788/zero",
+    userID: "ssr",
+    children: /* @__PURE__ */_jsx(Probe, {})
+  }));
+  expect(fakeZero.instances.length).toBe(0);
+  expect(contextClientID).toBe("disabled");
+  expect(function () {
+    return client.zero.clientID;
+  }).toThrow(/Zero instance not initialized/);
+});
+//# sourceMappingURL=provideZero.ssr.test.native.js.map

package/dist/esm/provideZero.ssr.test.native.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["jsx","_jsx","createSchema","string","table","useZero","renderToString","expect","test","vi","createZeroClient","IS_SERVER_RUNTIME","_class_call_check","instance","Constructor","TypeError","fakeZero","hoisted","instances","FakeZero","FakeZero2","push","mock","importOriginal","actual","Zero","window","Error","todoTable","columns","id","title","primaryKey","schema","tables","client","models","groupedQueries","instanceName","toBe"],"sources":["../../src/provideZero.ssr.test.tsx"],"sourcesContent":[null],"mappings":"AAOA,SAASA,GAAA,IAAAC,IAAA,QAAc,mBAAqB;AAC5C,SAASC,YAAA,EAAAC,MAAe,EAAAC,KAAA;AACxB,SAASC,OAAA,8BAAsB;AAC/B,SAASC,cAAc,0BAAU;AAiBjC,SAASC,MAAA,EAAAC,IAAA,EAAAC,EAAA,QAAwB;AACjC,SAASC,gBAAA,sCAAyB;AA+B5B,SAAAC,iBAAA;AA/CN,SAAMC,iBAAcA,CAAAC,QAAc,EAAAC,WAAA;EAChC,MAAMD,QAAA,YAAwBC,WAAA,aAAAC,SAAA;AAAA;AACf,IACbC,QAAA,GAAAP,EAAA,CAAcQ,OAAA;EACZ,IAAAC,SAAA,GAAU;EAAS,IACrBC,QAAA,YAAAC,UAAA;IACF;;IACAR,iBAAmB,OAAAQ,SAAU;IAC9BF,SAAA,CAAAG,IAAA;EAED,CAAG;EACD,OAAM;IACNF,QAAS;IACVD;EAKD;AACE;AACFT,EAAA,CAAAa,IAAA,mCAAAC,cAAA;EAEA,IAAMC,MAAA,SAAYD,cACf;EAEH,OAAM;IAEN,GAAMC,MAAA;IACJC,IAAA,EAAAT,QAAA,CAAAG;EACA;AAAS,EACT;AAAiB,IACjB,OAAAO,MAAc;EACf,UAAAC,KAAA;AAED;AACE,IAAAC,SAAO,GAAAxB,KAAA,OAAmB,EAAAyB,OAAS;EACpCC,EAAA,EAAA3B,MAAA;EAED4B,KAAK,EAAA5B,MAAA;AACH,GAAA6B,UAAI;AACJ,IAAAC,MAAM,GAAA/B,YAAc;EAClBgC,MAAA,GACAN,SAAO;AAGT;AAAA,IACEO,MAAA,GAAAzB,gBAAC;EAGHuB,MAAA;EAEAG,MAAA,EAAO;EACPC,cAAO;EACPC,YAAO,EAAO;AAA0D;AACtE9B,IACF;EACDD,MAAA,CAAAI,iBAAA,EAAA4B,IAAA","ignoreList":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "on-zero",
-  "version": "0.14.3",
+  "version": "0.14.4",
   "description": "A typed layer over @rocicorp/zero with queries, mutations, and permissions",
   "sideEffects": false,
   "files": [
@@ -105,7 +105,7 @@
     "chokidar": "^4.0.3",
     "citty": "^0.1.6",
     "dequal": "^2.0.3",
-    "orez-lite": "0.14.3",
+    "orez-lite": "0.14.4",
     "valibot": "^1.1.0"
   },
   "peerDependencies": {

package/src/createUseQueryDirect.tsx

@@ -279,7 +279,10 @@ export function createUseQueryDirect<Schema extends ZeroSchema>({
     const disableMode = useContext(DisabledContext)
     const [fn, paramsOrOptions, optionsArg] = args
 
-    const version = useEmitterValue(zeroVersion)
+    // subscribe so a swap re-renders this hook even when it has no provider
+    // above it re-rendering the subtree (connectHeadless publishes with no
+    // react tree at all). the instance identity below decides what changes.
+    useEmitterValue(zeroVersion)
     const { params, options } = parseUseQueryArgs(paramsOrOptions, optionsArg)
 
     let enabled = true
@@ -306,26 +309,28 @@ export function createUseQueryDirect<Schema extends ZeroSchema>({
     const emptyForQuery = useMemo(() => emptyResponseFor(queryRequest), [queryRequest])
     const lastRef = useRef<any>(emptyForQuery)
 
+    // the published instance is the memo's dependency, so a swap re-keys the
+    // view and nothing else does. keying on `version` instead left the memo
+    // holding a null view through every render between the emitter's bump and
+    // the instance actually appearing, and made a redundant bump tear down and
+    // rebuild a view that was already pointed at the right client.
+    const zeroInstance = getZero()
     const view = useMemo((): DirectView | null => {
-      const zero = getZero()
-      if (!zero) return null
-      // when ProvideZero renders with disable=true (or pre-instance), the
-      // ZeroContext.value is the inert stub which has no `.materialize` —
-      // calling it throws "this[#zero].materialize is not a function". detect
-      // the stub and short-circuit to the disabled snapshot via enabled=false
-      // (mirroring the wrapper-useQuery path at createUseQuery.tsx).
-      // DisabledContext is not a reliable signal here: it flips 'empty' →
-      // false within one render once the active instance is created, which
-      // would re-key the useMemo and re-materialize the view — that breaks
-      // the "subscribers share one materialized view" invariant.
+      if (!zeroInstance) return null
+      // when ProvideZero renders with disable=true, the ZeroContext.value is
+      // the inert stub which has no `.materialize` — calling it throws
+      // "this[#zero].materialize is not a function". detect the stub and
+      // short-circuit to the disabled snapshot via enabled=false (mirroring
+      // the wrapper-useQuery path at createUseQuery.tsx). DisabledContext is
+      // not a reliable signal here: it flips 'empty' → false as the provider
+      // enables, which would re-key the useMemo and re-materialize the view —
+      // that breaks the "subscribers share one materialized view" invariant.
       const effectiveEnabled =
-        typeof (zero as { materialize?: unknown }).materialize === 'function'
+        typeof (zeroInstance as { materialize?: unknown }).materialize === 'function'
           ? enabled
           : false
-      return directViewStore.getView(zero, queryRequest, effectiveEnabled, ttl)
-      // version re-materializes on a new zero
-      // eslint-disable-next-line react-hooks/exhaustive-deps
-    }, [queryRequest, enabled, ttl, version])
+      return directViewStore.getView(zeroInstance, queryRequest, effectiveEnabled, ttl)
+    }, [queryRequest, enabled, ttl, zeroInstance])
 
     const getEmpty = () => emptyForQuery as DirectSnapshot
     const out = useSyncExternalStore(