@spooky-sync/core 0.0.1-canary.340 → 0.0.1-canary.341

package/dist/index.d.ts

@@ -1236,6 +1236,8 @@ interface ServiceCalls {
   'auth.currentUser': () => Record<string, unknown> | null;
   'auth.consumeEndedImpersonation': () => string | null;
   'remote.connect': () => Promise<void>;
+  /** The platform reports no network at all (a browser's `navigator.onLine === false`). */
+  'net.offline': () => boolean;
   'remote.releaseViews': (ids: unknown[]) => void;
   'supervisor.start': () => void;
   'tabs.start': (bucketId: string) => Promise<'solo' | 'leader' | 'follower'>;

package/dist/index.js

@@ -2286,8 +2286,8 @@ function trimHistory(history, cap) {
 
 //#endregion
 //#region src/modules/devtools/index.ts
-const CORE_VERSION = "0.0.1-canary.340";
-const WASM_VERSION = "0.0.1-canary.340";
+const CORE_VERSION = "0.0.1-canary.341";
+const WASM_VERSION = "0.0.1-canary.341";
 const SURREAL_VERSION = "3.1.0";
 var DevToolsService = class DevToolsService {
 	version = CORE_VERSION;
@@ -6327,7 +6327,11 @@ var PreloadFailedError = class extends Error {
 * A session that cannot be sent membership (signed out, without anonymous
 * live queries) does not wait either: a view with rows would never settle,
 * and an app that gates its first paint on a preload showed its loading
-* screen forever, signed-out landing page included.
+* screen forever, signed-out landing page included. Nor does an offline
+* device: the membership it waits for cannot arrive before the network does,
+* and an app reloaded offline before its preload ever settled stayed on its
+* loading screen. It paints from what is local instead, and the query fills in
+* once the registration lands.
 */
 function* preload(env, input) {
 	const hash = yield* registerLocal(env, input);
@@ -6336,6 +6340,10 @@ function* preload(env, input) {
 		hash,
 		waited: false
 	};
+	if (yield fx.service("net.offline")) return {
+		hash,
+		waited: false
+	};
 	yield fx.state.wait((s) => settled(s, hash) || settleFailed(s, hash));
 	if (yield fx.state.read((s) => settleFailed(s, hash))) throw new PreloadFailedError(hash);
 	return {
@@ -15889,7 +15897,7 @@ function createTabsCoordinator(config, s, host) {
 	return new TabsCoordinator({
 		tabId: s.tabId,
 		fingerprint: computeTabsFingerprint({
-			coreVersion: "0.0.1-canary.340",
+			coreVersion: "0.0.1-canary.341",
 			schemaHash: hash53(config.schemaSurql),
 			endpoint: config.database.endpoint ?? "",
 			namespace: config.database.namespace,
@@ -16054,6 +16062,7 @@ function createAdapters(config, s, host, lateModules) {
 			if (sql) s.remote.beaconSql(sql);
 		},
 		"supervisor.start": () => s.connectionSupervisor.start(),
+		"net.offline": () => typeof navigator !== "undefined" && navigator.onLine === false,
 		"tabs.start": (bucketId) => {
 			if (!s.tabs) throw new Error("shared tabs unavailable");
 			return s.tabs.start(bucketId);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spooky-sync/core",
-  "version": "0.0.1-canary.340",
+  "version": "0.0.1-canary.341",
   "type": "module",
   "sideEffects": false,
   "main": "./dist/index.js",
@@ -75,8 +75,8 @@
     }
   },
   "dependencies": {
-    "@spooky-sync/query-builder": "0.0.1-canary.340",
-    "@spooky-sync/ssp-wasm": "0.0.1-canary.340",
+    "@spooky-sync/query-builder": "0.0.1-canary.341",
+    "@spooky-sync/ssp-wasm": "0.0.1-canary.341",
     "@sqlite.org/sqlite-wasm": "3.53.0-build1",
     "@surrealdb/wasm": "^3.1.0",
     "@surrealdb/wasm-native": "^3.3.4",

package/src/boot/preload.saga.test.ts

@@ -9,6 +9,11 @@ import { preload, PreloadFailedError } from './preload.saga';
 const env = defaultEnv({ tables: [{ name: 'thing', columns: {} }] } as any);
 const input = { tableName: 'thing', surql: 'SELECT * FROM thing', params: {}, ttl: '10m' as const };
 const sspOk = () => ({ localArray: [], timings: { parseMs: 0, planMs: 0, snapshotMs: 0, wallMs: 0 } });
+/** The `service` handler for an online device: `net.offline` answers false. */
+const online = (offline = false) => (e: any) => {
+  if (e.name === 'net.offline') return offline;
+  throw new Error(`unexpected service ${e.name}`);
+};
 
 describe('preload', () => {
   it('resolved before: returns without waiting and with no remote effect', async () => {
@@ -31,7 +36,7 @@ describe('preload', () => {
     };
     const out = await runPure(preload(env, input), {
       state: signedIn,
-      handlers: { 'local.getById': () => null, 'ssp.register': sspOk, 'state.wait': (_e, ctx) => settleIt(ctx) },
+      handlers: { 'local.getById': () => null, 'ssp.register': sspOk, service: online(), 'state.wait': (_e, ctx) => settleIt(ctx) },
     });
     expect(out.result).toEqual({ hash, waited: true });
     const failed = runPure(preload(env, input), {
@@ -39,13 +44,14 @@ describe('preload', () => {
       handlers: {
         'local.getById': () => null,
         'ssp.register': sspOk,
+        service: online(),
         'state.wait': (_e, ctx) => void (ctx.state = R.applyLifecycle(hash, { type: 'remote-failed' })(ctx.state)),
       },
     });
     await expect(failed).rejects.toBeInstanceOf(PreloadFailedError);
     const gone = runPure(preload(env, input), {
       state: signedIn,
-      handlers: { 'local.getById': () => null, 'ssp.register': sspOk, 'state.wait': (_e, ctx) => void (ctx.state = R.removeQuery(hash)(ctx.state)) },
+      handlers: { 'local.getById': () => null, 'ssp.register': sspOk, service: online(), 'state.wait': (_e, ctx) => void (ctx.state = R.removeQuery(hash)(ctx.state)) },
     });
     await expect(gone).rejects.toThrow(/could not settle/);
     const already = buildState([buildEntry({ def: { hash }, lifecycle: { phase: 'cached' } })]);
@@ -67,6 +73,7 @@ describe('preload', () => {
       handlers: {
         'local.getById': () => null,
         'ssp.register': sspOk,
+        service: online(),
         'state.wait': (_e, ctx) =>
           void (ctx.state = R.compose(
             R.commitMembership(hash, [['thing:1', 1]], true),
@@ -77,4 +84,13 @@ describe('preload', () => {
     });
     expect(anon.result).toEqual({ hash, waited: true });
   });
+  it('offline: registers but never waits, so a reload without a network paints from what is local', async () => {
+    const signedIn = buildState([], R.setIdentity({ userId: 'user:alice' }));
+    const out = await runPure(preload(env, input), {
+      state: signedIn,
+      handlers: { 'local.getById': () => null, 'ssp.register': sspOk, service: online(true) },
+    });
+    expect(out.result.waited).toBe(false);
+    expect(out.log.filter((e) => e.kind === 'state.wait')).toHaveLength(0);
+  });
 });

package/src/boot/preload.saga.ts

@@ -24,7 +24,11 @@ export class PreloadFailedError extends Error {
  * A session that cannot be sent membership (signed out, without anonymous
  * live queries) does not wait either: a view with rows would never settle,
  * and an app that gates its first paint on a preload showed its loading
- * screen forever, signed-out landing page included.
+ * screen forever, signed-out landing page included. Nor does an offline
+ * device: the membership it waits for cannot arrive before the network does,
+ * and an app reloaded offline before its preload ever settled stayed on its
+ * loading screen. It paints from what is local instead, and the query fills in
+ * once the registration lands.
  */
 export function* preload(env: SagaEnv, input: RegisterInput): Saga<{ hash: QueryHash; waited: boolean }> {
   const hash = yield* registerLocal(env, input);
@@ -33,6 +37,7 @@ export function* preload(env: SagaEnv, input: RegisterInput): Saga<{ hash: Query
     boolean,
   ];
   if (phase !== 'cold' || !reachable) return { hash, waited: false };
+  if ((yield fx.service('net.offline')) as boolean) return { hash, waited: false };
   yield fx.state.wait((s) => settled(s, hash) || settleFailed(s, hash));
   const failed = (yield fx.state.read((s) => settleFailed(s, hash))) as boolean;
   if (failed) throw new PreloadFailedError(hash);

package/src/client/services.ts

@@ -331,6 +331,7 @@ export function createAdapters<S extends SchemaStructure>(config: Sp00kyConfig<S
       if (sql) s.remote.beaconSql(sql);
     },
     'supervisor.start': () => s.connectionSupervisor.start(),
+    'net.offline': () => typeof navigator !== 'undefined' && navigator.onLine === false,
     'tabs.start': (bucketId) => {
       if (!s.tabs) throw new Error('shared tabs unavailable');
       return s.tabs.start(bucketId);

package/src/kernel/effects.ts

@@ -100,6 +100,8 @@ export interface ServiceCalls {
   'auth.currentUser': () => Record<string, unknown> | null;
   'auth.consumeEndedImpersonation': () => string | null;
   'remote.connect': () => Promise<void>;
+  /** The platform reports no network at all (a browser's `navigator.onLine === false`). */
+  'net.offline': () => boolean;
   'remote.releaseViews': (ids: unknown[]) => void;
   'supervisor.start': () => void;
   'tabs.start': (bucketId: string) => Promise<'solo' | 'leader' | 'follower'>;