@rocicorp/zero 0.25.0-canary.7 → 0.25.0-canary.8

package/out/zero-client/src/client/reload-error-handler.js

@@ -0,0 +1,114 @@
+import { parse } from "../../../shared/src/valita.js";
+import { errorKindSchema } from "../../../zero-protocol/src/error.js";
+import { updateNeededReasonTypeSchema } from "./options.js";
+import { tuple, union, string, object, number } from "@badrap/valita";
+const RELOAD_REASON_STORAGE_KEY = "_zeroReloadReason";
+const RELOAD_BACKOFF_STATE_KEY = "_zeroReloadBackoffState";
+const reloadReasonSchema = tuple([
+  union(updateNeededReasonTypeSchema, errorKindSchema),
+  string()
+]);
+const backoffStateSchema = object({
+  lastReloadTime: number().default(0),
+  nextIntervalMs: number().default(0)
+});
+const MIN_RELOAD_INTERVAL_MS = 500;
+const MAX_RELOAD_INTERVAL_MS = 6e4;
+const FALLBACK_RELOAD_INTERVAL_MS = 1e4;
+let reloadTimer = null;
+function reloadWithReason(lc, reload, reason, message) {
+  if (reloadTimer) {
+    lc.info?.("reload timer already scheduled");
+    return;
+  }
+  const now = Date.now();
+  const backoff = nextBackoff(lc, now);
+  if (typeof sessionStorage !== "undefined") {
+    sessionStorage.setItem(RELOAD_BACKOFF_STATE_KEY, JSON.stringify(backoff));
+    sessionStorage.setItem(
+      RELOAD_REASON_STORAGE_KEY,
+      JSON.stringify([reason, message])
+    );
+  }
+  const delay = backoff.lastReloadTime - now;
+  lc.error?.(
+    reason,
+    "\n",
+    "reloading",
+    delay > 0 ? `in ${delay / 1e3} seconds` : ""
+  );
+  reloadTimer = setTimeout(() => {
+    reloadTimer = null;
+    reload();
+  }, delay);
+}
+function reportReloadReason(lc) {
+  if (typeof sessionStorage !== "undefined") {
+    const value = sessionStorage.getItem(RELOAD_REASON_STORAGE_KEY);
+    if (value) {
+      sessionStorage.removeItem(RELOAD_REASON_STORAGE_KEY);
+      try {
+        const parsed = JSON.parse(value);
+        const [reasonType, message] = parse(parsed, reloadReasonSchema);
+        lc.error?.(reasonType, "Zero reloaded the page.", message);
+      } catch (e) {
+        lc.error?.("Zero reloaded the page.", e);
+        return;
+      }
+    }
+  }
+}
+function reloadScheduled() {
+  return reloadTimer !== null;
+}
+function resetBackoff() {
+  if (typeof sessionStorage !== "undefined") {
+    sessionStorage.removeItem(RELOAD_BACKOFF_STATE_KEY);
+  }
+}
+function nextBackoff(lc, now) {
+  if (typeof sessionStorage === "undefined") {
+    lc.warn?.(
+      `sessionStorage not supported. backing off in ${FALLBACK_RELOAD_INTERVAL_MS / 1e3} seconds`
+    );
+    return {
+      lastReloadTime: now + FALLBACK_RELOAD_INTERVAL_MS,
+      nextIntervalMs: MIN_RELOAD_INTERVAL_MS
+    };
+  }
+  const val = sessionStorage.getItem(RELOAD_BACKOFF_STATE_KEY);
+  if (!val) {
+    return { lastReloadTime: now, nextIntervalMs: MIN_RELOAD_INTERVAL_MS };
+  }
+  let parsed;
+  try {
+    parsed = parse(JSON.parse(val), backoffStateSchema, "passthrough");
+  } catch (e) {
+    lc.warn?.("ignoring unparsable backoff state", val, e);
+    return { lastReloadTime: now, nextIntervalMs: MIN_RELOAD_INTERVAL_MS };
+  }
+  const { lastReloadTime, nextIntervalMs } = parsed;
+  if (now - lastReloadTime > MAX_RELOAD_INTERVAL_MS * 2) {
+    return { lastReloadTime: now, nextIntervalMs: MIN_RELOAD_INTERVAL_MS };
+  }
+  if (now < lastReloadTime) {
+    return parsed;
+  }
+  const nextReloadTime = Math.max(now, lastReloadTime + nextIntervalMs);
+  return {
+    lastReloadTime: nextReloadTime,
+    nextIntervalMs: Math.min(nextIntervalMs * 2, MAX_RELOAD_INTERVAL_MS)
+  };
+}
+export {
+  FALLBACK_RELOAD_INTERVAL_MS,
+  MAX_RELOAD_INTERVAL_MS,
+  MIN_RELOAD_INTERVAL_MS,
+  RELOAD_BACKOFF_STATE_KEY,
+  RELOAD_REASON_STORAGE_KEY,
+  reloadScheduled,
+  reloadWithReason,
+  reportReloadReason,
+  resetBackoff
+};
+//# sourceMappingURL=reload-error-handler.js.map

package/out/zero-client/src/client/reload-error-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reload-error-handler.js","sources":["../../../../../zero-client/src/client/reload-error-handler.ts"],"sourcesContent":["import type {LogContext} from '@rocicorp/logger';\nimport * as v from '../../../shared/src/valita.ts';\nimport type {ErrorKind} from '../../../zero-protocol/src/error-kind.ts';\nimport {errorKindSchema} from '../../../zero-protocol/src/error.ts';\nimport {updateNeededReasonTypeSchema} from './options.ts';\nimport type {UpdateNeededReasonType} from './update-needed-reason-type.ts';\n\nexport const RELOAD_REASON_STORAGE_KEY = '_zeroReloadReason';\nexport const RELOAD_BACKOFF_STATE_KEY = '_zeroReloadBackoffState';\n\nconst reloadReasonSchema = v.tuple([\n  v.union(updateNeededReasonTypeSchema, errorKindSchema),\n  v.string(),\n]);\n\nconst backoffStateSchema = v.object({\n  lastReloadTime: v.number().default(0),\n  nextIntervalMs: v.number().default(0),\n});\n\nexport type BackoffState = v.Infer<typeof backoffStateSchema>;\n\nexport const MIN_RELOAD_INTERVAL_MS = 500;\nexport const MAX_RELOAD_INTERVAL_MS = 60_000;\n\n// For the fraction of browsers that do not support sessionStorage.\nexport const FALLBACK_RELOAD_INTERVAL_MS = 10_000;\n\nlet reloadTimer: ReturnType<typeof setTimeout> | null = null;\n\n// TODO: This should get pushed down into Replicache and used for reloads we\n// do there.\nexport function reloadWithReason(\n  lc: LogContext,\n  reload: () => void,\n  reason: UpdateNeededReasonType | ErrorKind,\n  message: string,\n) {\n  if (reloadTimer) {\n    lc.info?.('reload timer already scheduled');\n    return;\n  }\n  const now = Date.now();\n  const backoff = nextBackoff(lc, now);\n\n  // Record state immediately so that it persists if the user manually reloads first.\n  if (typeof sessionStorage !== 'undefined') {\n    sessionStorage.setItem(RELOAD_BACKOFF_STATE_KEY, JSON.stringify(backoff));\n    sessionStorage.setItem(\n      RELOAD_REASON_STORAGE_KEY,\n      JSON.stringify([reason, message]),\n    );\n  }\n\n  const delay = backoff.lastReloadTime - now;\n  lc.error?.(\n    reason,\n    '\\n',\n    'reloading',\n    delay > 0 ? `in ${delay / 1000} seconds` : '',\n  );\n  reloadTimer = setTimeout(() => {\n    reloadTimer = null;\n    reload();\n  }, delay);\n}\n\nexport function reportReloadReason(lc: LogContext) {\n  if (typeof sessionStorage !== 'undefined') {\n    const value = sessionStorage.getItem(RELOAD_REASON_STORAGE_KEY);\n    if (value) {\n      sessionStorage.removeItem(RELOAD_REASON_STORAGE_KEY);\n      try {\n        const parsed = JSON.parse(value);\n        const [reasonType, message] = v.parse(parsed, reloadReasonSchema);\n        lc.error?.(reasonType, 'Zero reloaded the page.', message);\n      } catch (e) {\n        lc.error?.('Zero reloaded the page.', e);\n        // ignore if not able to parse\n        return;\n      }\n    }\n  }\n}\n\n/** If a reload is scheduled, do not attempt to reconnect. */\nexport function reloadScheduled() {\n  return reloadTimer !== null;\n}\n\n/** Call upon a successful connection, indicating that backoff should be reset. */\nexport function resetBackoff() {\n  if (typeof sessionStorage !== 'undefined') {\n    sessionStorage.removeItem(RELOAD_BACKOFF_STATE_KEY);\n  }\n}\n\nfunction nextBackoff(lc: LogContext, now: number): BackoffState {\n  if (typeof sessionStorage === 'undefined') {\n    lc.warn?.(\n      `sessionStorage not supported. backing off in ${\n        FALLBACK_RELOAD_INTERVAL_MS / 1000\n      } seconds`,\n    );\n    return {\n      lastReloadTime: now + FALLBACK_RELOAD_INTERVAL_MS,\n      nextIntervalMs: MIN_RELOAD_INTERVAL_MS,\n    };\n  }\n  const val = sessionStorage.getItem(RELOAD_BACKOFF_STATE_KEY);\n  if (!val) {\n    return {lastReloadTime: now, nextIntervalMs: MIN_RELOAD_INTERVAL_MS};\n  }\n  let parsed: BackoffState;\n  try {\n    parsed = v.parse(JSON.parse(val), backoffStateSchema, 'passthrough');\n  } catch (e) {\n    lc.warn?.('ignoring unparsable backoff state', val, e);\n    return {lastReloadTime: now, nextIntervalMs: MIN_RELOAD_INTERVAL_MS};\n  }\n  const {lastReloadTime, nextIntervalMs} = parsed;\n\n  // Backoff state might not have been cleared. Reset for sufficiently old state.\n  if (now - lastReloadTime > MAX_RELOAD_INTERVAL_MS * 2) {\n    return {lastReloadTime: now, nextIntervalMs: MIN_RELOAD_INTERVAL_MS};\n  }\n  if (now < lastReloadTime) {\n    // If the user manually reloaded, stick to the existing schedule.\n    return parsed;\n  }\n  const nextReloadTime = Math.max(now, lastReloadTime + nextIntervalMs);\n  return {\n    lastReloadTime: nextReloadTime,\n    nextIntervalMs: Math.min(nextIntervalMs * 2, MAX_RELOAD_INTERVAL_MS),\n  };\n}\n"],"names":["v.tuple","v.union","v.string","v.object","v.number","v.parse"],"mappings":";;;;AAOO,MAAM,4BAA4B;AAClC,MAAM,2BAA2B;AAExC,MAAM,qBAAqBA,MAAQ;AAAA,EACjCC,MAAQ,8BAA8B,eAAe;AAAA,EACrDC,OAAE;AACJ,CAAC;AAED,MAAM,qBAAqBC,OAAS;AAAA,EAClC,gBAAgBC,OAAE,EAAS,QAAQ,CAAC;AAAA,EACpC,gBAAgBA,SAAW,QAAQ,CAAC;AACtC,CAAC;AAIM,MAAM,yBAAyB;AAC/B,MAAM,yBAAyB;AAG/B,MAAM,8BAA8B;AAE3C,IAAI,cAAoD;AAIjD,SAAS,iBACd,IACA,QACA,QACA,SACA;AACA,MAAI,aAAa;AACf,OAAG,OAAO,gCAAgC;AAC1C;AAAA,EACF;AACA,QAAM,MAAM,KAAK,IAAA;AACjB,QAAM,UAAU,YAAY,IAAI,GAAG;AAGnC,MAAI,OAAO,mBAAmB,aAAa;AACzC,mBAAe,QAAQ,0BAA0B,KAAK,UAAU,OAAO,CAAC;AACxE,mBAAe;AAAA,MACb;AAAA,MACA,KAAK,UAAU,CAAC,QAAQ,OAAO,CAAC;AAAA,IAAA;AAAA,EAEpC;AAEA,QAAM,QAAQ,QAAQ,iBAAiB;AACvC,KAAG;AAAA,IACD;AAAA,IACA;AAAA,IACA;AAAA,IACA,QAAQ,IAAI,MAAM,QAAQ,GAAI,aAAa;AAAA,EAAA;AAE7C,gBAAc,WAAW,MAAM;AAC7B,kBAAc;AACd,WAAA;AAAA,EACF,GAAG,KAAK;AACV;AAEO,SAAS,mBAAmB,IAAgB;AACjD,MAAI,OAAO,mBAAmB,aAAa;AACzC,UAAM,QAAQ,eAAe,QAAQ,yBAAyB;AAC9D,QAAI,OAAO;AACT,qBAAe,WAAW,yBAAyB;AACnD,UAAI;AACF,cAAM,SAAS,KAAK,MAAM,KAAK;AAC/B,cAAM,CAAC,YAAY,OAAO,IAAIC,MAAQ,QAAQ,kBAAkB;AAChE,WAAG,QAAQ,YAAY,2BAA2B,OAAO;AAAA,MAC3D,SAAS,GAAG;AACV,WAAG,QAAQ,2BAA2B,CAAC;AAEvC;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF;AAGO,SAAS,kBAAkB;AAChC,SAAO,gBAAgB;AACzB;AAGO,SAAS,eAAe;AAC7B,MAAI,OAAO,mBAAmB,aAAa;AACzC,mBAAe,WAAW,wBAAwB;AAAA,EACpD;AACF;AAEA,SAAS,YAAY,IAAgB,KAA2B;AAC9D,MAAI,OAAO,mBAAmB,aAAa;AACzC,OAAG;AAAA,MACD,gDACE,8BAA8B,GAChC;AAAA,IAAA;AAEF,WAAO;AAAA,MACL,gBAAgB,MAAM;AAAA,MACtB,gBAAgB;AAAA,IAAA;AAAA,EAEpB;AACA,QAAM,MAAM,eAAe,QAAQ,wBAAwB;AAC3D,MAAI,CAAC,KAAK;AACR,WAAO,EAAC,gBAAgB,KAAK,gBAAgB,uBAAA;AAAA,EAC/C;AACA,MAAI;AACJ,MAAI;AACF,aAASA,MAAQ,KAAK,MAAM,GAAG,GAAG,oBAAoB,aAAa;AAAA,EACrE,SAAS,GAAG;AACV,OAAG,OAAO,qCAAqC,KAAK,CAAC;AACrD,WAAO,EAAC,gBAAgB,KAAK,gBAAgB,uBAAA;AAAA,EAC/C;AACA,QAAM,EAAC,gBAAgB,eAAA,IAAkB;AAGzC,MAAI,MAAM,iBAAiB,yBAAyB,GAAG;AACrD,WAAO,EAAC,gBAAgB,KAAK,gBAAgB,uBAAA;AAAA,EAC/C;AACA,MAAI,MAAM,gBAAgB;AAExB,WAAO;AAAA,EACT;AACA,QAAM,iBAAiB,KAAK,IAAI,KAAK,iBAAiB,cAAc;AACpE,SAAO;AAAA,IACL,gBAAgB;AAAA,IAChB,gBAAgB,KAAK,IAAI,iBAAiB,GAAG,sBAAsB;AAAA,EAAA;AAEvE;"}

package/out/zero-client/src/client/server-option.js

@@ -0,0 +1,64 @@
+import { getBrowserGlobal } from "../../../shared/src/browser-env.js";
+function validateServerParam(paramName, server) {
+  const expectedProtocol = "http";
+  const forExample = (path = "") => ` For example: "${expectedProtocol}s://myapp-myteam.zero.ms/${path}".`;
+  if (!server.startsWith(`${expectedProtocol}://`) && !server.startsWith(`${expectedProtocol}s://`)) {
+    throw new Error(
+      `ZeroOptions.${paramName} must use the "${expectedProtocol}" or "${expectedProtocol}s" scheme.`
+    );
+  }
+  let url;
+  try {
+    url = new URL(server);
+  } catch {
+    throw new Error(
+      `ZeroOptions.${paramName} must be a valid URL.${forExample()}`
+    );
+  }
+  const urlString = url.toString();
+  const pathComponents = url.pathname.split("/");
+  if (pathComponents[0] === "") {
+    pathComponents.shift();
+  }
+  if (pathComponents[pathComponents.length - 1] === "") {
+    pathComponents.pop();
+  }
+  if (pathComponents.length > 1) {
+    throw new Error(
+      `ZeroOptions.${paramName} may have at most one path component.${forExample(
+        "zero"
+      )}`
+    );
+  }
+  for (const [property, invalidEndsWith] of [
+    ["search", "?"],
+    ["hash", "#"]
+  ]) {
+    if (url[property] || urlString.endsWith(invalidEndsWith)) {
+      throw new Error(
+        `ZeroOptions.${paramName} must not contain a ${property} component.${forExample()}`
+      );
+    }
+  }
+  return urlString;
+}
+function getServer(server) {
+  const WS = getBrowserGlobal("WebSocket");
+  if (!WS) {
+    console.warn(
+      "Zero started in an unsupported environment, no data will be synced."
+    );
+    return null;
+  }
+  if (server === void 0 || server === null) {
+    console.warn(
+      "Zero starting up with no server URL. No data will be synced."
+    );
+    return null;
+  }
+  return validateServerParam("server", server);
+}
+export {
+  getServer
+};
+//# sourceMappingURL=server-option.js.map

package/out/zero-client/src/client/server-option.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-option.js","sources":["../../../../../zero-client/src/client/server-option.ts"],"sourcesContent":["import {getBrowserGlobal} from '../../../shared/src/browser-env.ts';\nimport type {HTTPString} from './http-string.ts';\n\nfunction validateServerParam(paramName: string, server: string): HTTPString {\n  const expectedProtocol = 'http';\n  const forExample = (path: string = '') =>\n    ` For example: \"${expectedProtocol}s://myapp-myteam.zero.ms/${path}\".`;\n\n  if (\n    !server.startsWith(`${expectedProtocol}://`) &&\n    !server.startsWith(`${expectedProtocol}s://`)\n  ) {\n    throw new Error(\n      `ZeroOptions.${paramName} must use the \"${expectedProtocol}\" or \"${expectedProtocol}s\" scheme.`,\n    );\n  }\n  let url;\n  try {\n    url = new URL(server);\n  } catch {\n    throw new Error(\n      `ZeroOptions.${paramName} must be a valid URL.${forExample()}`,\n    );\n  }\n\n  const urlString = url.toString();\n\n  const pathComponents = url.pathname.split('/');\n  if (pathComponents[0] === '') {\n    pathComponents.shift();\n  }\n  if (pathComponents[pathComponents.length - 1] === '') {\n    pathComponents.pop();\n  }\n  if (pathComponents.length > 1) {\n    throw new Error(\n      `ZeroOptions.${paramName} may have at most one path component.${forExample(\n        'zero',\n      )}`,\n    );\n  }\n\n  for (const [property, invalidEndsWith] of [\n    ['search', '?'],\n    ['hash', '#'],\n  ] as const) {\n    if (url[property] || urlString.endsWith(invalidEndsWith)) {\n      throw new Error(\n        `ZeroOptions.${paramName} must not contain a ${property} component.${forExample()}`,\n      );\n    }\n  }\n\n  return urlString as HTTPString;\n}\n\nexport function getServer(\n  server: string | undefined | null,\n): HTTPString | null {\n  const WS = getBrowserGlobal('WebSocket');\n  if (!WS) {\n    // oxlint-disable-next-line no-console\n    console.warn(\n      'Zero started in an unsupported environment, no data will be synced.',\n    );\n    return null;\n  }\n  if (server === undefined || server === null) {\n    // oxlint-disable-next-line no-console\n    console.warn(\n      'Zero starting up with no server URL. No data will be synced.',\n    );\n    return null;\n  }\n  return validateServerParam('server', server);\n}\n"],"names":[],"mappings":";AAGA,SAAS,oBAAoB,WAAmB,QAA4B;AAC1E,QAAM,mBAAmB;AACzB,QAAM,aAAa,CAAC,OAAe,OACjC,kBAAkB,gBAAgB,4BAA4B,IAAI;AAEpE,MACE,CAAC,OAAO,WAAW,GAAG,gBAAgB,KAAK,KAC3C,CAAC,OAAO,WAAW,GAAG,gBAAgB,MAAM,GAC5C;AACA,UAAM,IAAI;AAAA,MACR,eAAe,SAAS,kBAAkB,gBAAgB,SAAS,gBAAgB;AAAA,IAAA;AAAA,EAEvF;AACA,MAAI;AACJ,MAAI;AACF,UAAM,IAAI,IAAI,MAAM;AAAA,EACtB,QAAQ;AACN,UAAM,IAAI;AAAA,MACR,eAAe,SAAS,wBAAwB,WAAA,CAAY;AAAA,IAAA;AAAA,EAEhE;AAEA,QAAM,YAAY,IAAI,SAAA;AAEtB,QAAM,iBAAiB,IAAI,SAAS,MAAM,GAAG;AAC7C,MAAI,eAAe,CAAC,MAAM,IAAI;AAC5B,mBAAe,MAAA;AAAA,EACjB;AACA,MAAI,eAAe,eAAe,SAAS,CAAC,MAAM,IAAI;AACpD,mBAAe,IAAA;AAAA,EACjB;AACA,MAAI,eAAe,SAAS,GAAG;AAC7B,UAAM,IAAI;AAAA,MACR,eAAe,SAAS,wCAAwC;AAAA,QAC9D;AAAA,MAAA,CACD;AAAA,IAAA;AAAA,EAEL;AAEA,aAAW,CAAC,UAAU,eAAe,KAAK;AAAA,IACxC,CAAC,UAAU,GAAG;AAAA,IACd,CAAC,QAAQ,GAAG;AAAA,EAAA,GACF;AACV,QAAI,IAAI,QAAQ,KAAK,UAAU,SAAS,eAAe,GAAG;AACxD,YAAM,IAAI;AAAA,QACR,eAAe,SAAS,uBAAuB,QAAQ,cAAc,YAAY;AAAA,MAAA;AAAA,IAErF;AAAA,EACF;AAEA,SAAO;AACT;AAEO,SAAS,UACd,QACmB;AACnB,QAAM,KAAK,iBAAiB,WAAW;AACvC,MAAI,CAAC,IAAI;AAEP,YAAQ;AAAA,MACN;AAAA,IAAA;AAEF,WAAO;AAAA,EACT;AACA,MAAI,WAAW,UAAa,WAAW,MAAM;AAE3C,YAAQ;AAAA,MACN;AAAA,IAAA;AAEF,WAAO;AAAA,EACT;AACA,SAAO,oBAAoB,UAAU,MAAM;AAC7C;"}

package/out/zero-client/src/client/update-needed-reason-type-enum.js

@@ -0,0 +1,9 @@
+const NewClientGroup = "NewClientGroup";
+const VersionNotSupported = "VersionNotSupported";
+const SchemaVersionNotSupported = "SchemaVersionNotSupported";
+export {
+  NewClientGroup,
+  SchemaVersionNotSupported,
+  VersionNotSupported
+};
+//# sourceMappingURL=update-needed-reason-type-enum.js.map

package/out/zero-client/src/client/update-needed-reason-type-enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-needed-reason-type-enum.js","sources":["../../../../../zero-client/src/client/update-needed-reason-type-enum.ts"],"sourcesContent":["/**\n * There is a new client group due to a another tab loading new code which\n * cannot sync locally with this tab until it updates to the new code. This tab\n * can still sync with the zero-cache.\n */\nexport const NewClientGroup = 'NewClientGroup';\nexport type NewClientGroup = typeof NewClientGroup;\n\n/**\n * This client was unable to connect to the zero-cache because it is using a\n * protocol version that the zero-cache does not support.\n */\nexport const VersionNotSupported = 'VersionNotSupported';\nexport type VersionNotSupported = typeof VersionNotSupported;\n\n/**\n * This client was unable to connect to the zero-cache because it is using a\n * schema version (see {@codelink Schema}) that the zero-cache does not support.\n */\nexport const SchemaVersionNotSupported = 'SchemaVersionNotSupported';\nexport type SchemaVersionNotSupported = typeof SchemaVersionNotSupported;\n"],"names":[],"mappings":"AAKO,MAAM,iBAAiB;AAOvB,MAAM,sBAAsB;AAO5B,MAAM,4BAA4B;"}

package/out/zero-client/src/client/version.js

@@ -0,0 +1,5 @@
+const version = "0.25.0-canary.8";
+export {
+  version
+};
+//# sourceMappingURL=version.js.map

package/out/zero-client/src/client/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sources":["../../../../../zero-client/src/client/version.ts"],"sourcesContent":["// The env value should be filled in by esbuild.\n\ndeclare const process: {\n  env: {\n    ['ZERO_VERSION']?: string;\n  };\n};\n\n/**\n * The current version of Zero.\n */\nexport const version = process.env.ZERO_VERSION ?? '0.0.0';\n"],"names":[],"mappings":"AAWO,MAAM,UAAU;"}

package/out/zero-client/src/client/zero-poke-handler.js

@@ -0,0 +1,303 @@
+import { Lock } from "@rocicorp/lock";
+import { unreachable } from "../../../shared/src/asserts.js";
+import { getBrowserGlobalMethod } from "../../../shared/src/browser-env.js";
+import { serverToClient } from "../../../zero-schema/src/name-mapper.js";
+import { toPrimaryKeyString, toMutationResponseKey, toDesiredQueriesKey, toGotQueriesKey } from "./keys.js";
+class PokeHandler {
+  #replicachePoke;
+  #onPokeError;
+  #clientID;
+  #lc;
+  #receivingPoke = void 0;
+  #pokeBuffer = [];
+  #pokePlaybackLoopRunning = false;
+  #lastRafPerfTimestamp = 0;
+  // Serializes calls to this.#replicachePoke otherwise we can cause out of
+  // order poke errors.
+  #pokeLock = new Lock();
+  #schema;
+  #serverToClient;
+  #mutationTracker;
+  #raf = getBrowserGlobalMethod("requestAnimationFrame") ?? rafFallback;
+  constructor(replicachePoke, onPokeError, clientID, schema, lc, mutationTracker) {
+    this.#replicachePoke = replicachePoke;
+    this.#onPokeError = onPokeError;
+    this.#clientID = clientID;
+    this.#schema = schema;
+    this.#serverToClient = serverToClient(schema.tables);
+    this.#lc = lc.withContext("PokeHandler");
+    this.#mutationTracker = mutationTracker;
+  }
+  handlePokeStart(pokeStart) {
+    if (this.#receivingPoke) {
+      this.#handlePokeError(
+        `pokeStart ${JSON.stringify(
+          pokeStart
+        )} while still receiving  ${JSON.stringify(
+          this.#receivingPoke.pokeStart
+        )} `
+      );
+      return;
+    }
+    this.#receivingPoke = {
+      pokeStart,
+      parts: []
+    };
+  }
+  handlePokePart(pokePart) {
+    if (pokePart.pokeID !== this.#receivingPoke?.pokeStart.pokeID) {
+      this.#handlePokeError(
+        `pokePart for ${pokePart.pokeID}, when receiving ${this.#receivingPoke?.pokeStart.pokeID}`
+      );
+      return;
+    }
+    this.#receivingPoke.parts.push(pokePart);
+    return pokePart.lastMutationIDChanges?.[this.#clientID];
+  }
+  handlePokeEnd(pokeEnd) {
+    if (pokeEnd.pokeID !== this.#receivingPoke?.pokeStart.pokeID) {
+      this.#handlePokeError(
+        `pokeEnd for ${pokeEnd.pokeID}, when receiving ${this.#receivingPoke?.pokeStart.pokeID}`
+      );
+      return;
+    }
+    if (pokeEnd.cancel) {
+      this.#receivingPoke = void 0;
+      return;
+    }
+    this.#pokeBuffer.push({ ...this.#receivingPoke, pokeEnd });
+    this.#receivingPoke = void 0;
+    if (!this.#pokePlaybackLoopRunning) {
+      this.#startPlaybackLoop();
+    }
+  }
+  handleDisconnect() {
+    this.#lc.debug?.("clearing due to disconnect");
+    this.#clear();
+  }
+  #startPlaybackLoop() {
+    this.#lc.debug?.("starting playback loop");
+    this.#pokePlaybackLoopRunning = true;
+    this.#raf(this.#rafCallback);
+  }
+  #rafCallback = async () => {
+    const rafLC = this.#lc.withContext("rafAt", Math.floor(performance.now()));
+    if (this.#pokeBuffer.length === 0) {
+      rafLC.debug?.("stopping playback loop");
+      this.#pokePlaybackLoopRunning = false;
+      return;
+    }
+    this.#raf(this.#rafCallback);
+    const start = performance.now();
+    rafLC.debug?.(
+      "raf fired, processing pokes.  Since last raf",
+      start - this.#lastRafPerfTimestamp
+    );
+    this.#lastRafPerfTimestamp = start;
+    await this.#processPokesForFrame(rafLC);
+    rafLC.debug?.("processing pokes took", performance.now() - start);
+  };
+  #processPokesForFrame(lc) {
+    return this.#pokeLock.withLock(async () => {
+      const now = Date.now();
+      lc.debug?.("got poke lock at", now);
+      lc.debug?.("merging", this.#pokeBuffer.length);
+      try {
+        const merged = mergePokes(
+          this.#pokeBuffer,
+          this.#schema,
+          this.#serverToClient
+        );
+        this.#pokeBuffer.length = 0;
+        if (merged === void 0) {
+          lc.debug?.("frame is empty");
+          return;
+        }
+        const start = performance.now();
+        lc.debug?.("poking replicache");
+        await this.#replicachePoke(merged);
+        lc.debug?.("poking replicache took", performance.now() - start);
+        if (!("error" in merged.pullResponse)) {
+          const lmid = merged.pullResponse.lastMutationIDChanges[this.#clientID];
+          if (lmid !== void 0) {
+            this.#mutationTracker.lmidAdvanced(lmid);
+          }
+        }
+      } catch (e) {
+        this.#handlePokeError(e);
+      }
+    });
+  }
+  #handlePokeError(e) {
+    if (String(e).includes("unexpected base cookie for poke")) {
+      this.#lc.debug?.("clearing due to", e);
+    } else {
+      this.#lc.error?.("clearing due to unexpected poke error", e);
+    }
+    this.#clear();
+    this.#onPokeError();
+  }
+  #clear() {
+    this.#receivingPoke = void 0;
+    this.#pokeBuffer.length = 0;
+  }
+}
+function mergePokes(pokeBuffer, schema, serverToClient2) {
+  if (pokeBuffer.length === 0) {
+    return void 0;
+  }
+  const { baseCookie } = pokeBuffer[0].pokeStart;
+  const lastPoke = pokeBuffer[pokeBuffer.length - 1];
+  const { cookie } = lastPoke.pokeEnd;
+  const mergedPatch = [];
+  const mergedLastMutationIDChanges = {};
+  const mutationResults = [];
+  let prevPokeEnd = void 0;
+  for (const pokeAccumulator of pokeBuffer) {
+    if (prevPokeEnd && pokeAccumulator.pokeStart.baseCookie && pokeAccumulator.pokeStart.baseCookie > prevPokeEnd.cookie) {
+      throw Error(
+        `unexpected cookie gap ${JSON.stringify(prevPokeEnd)} ${JSON.stringify(
+          pokeAccumulator.pokeStart
+        )}`
+      );
+    }
+    prevPokeEnd = pokeAccumulator.pokeEnd;
+    for (const pokePart of pokeAccumulator.parts) {
+      if (pokePart.lastMutationIDChanges) {
+        for (const [clientID, lastMutationID] of Object.entries(
+          pokePart.lastMutationIDChanges
+        )) {
+          mergedLastMutationIDChanges[clientID] = lastMutationID;
+        }
+      }
+      if (pokePart.desiredQueriesPatches) {
+        for (const [clientID, queriesPatch] of Object.entries(
+          pokePart.desiredQueriesPatches
+        )) {
+          for (const op of queriesPatch) {
+            mergedPatch.push(
+              queryPatchOpToReplicachePatchOp(
+                op,
+                (hash) => toDesiredQueriesKey(clientID, hash)
+              )
+            );
+          }
+        }
+      }
+      if (pokePart.gotQueriesPatch) {
+        for (const op of pokePart.gotQueriesPatch) {
+          mergedPatch.push(
+            queryPatchOpToReplicachePatchOp(op, toGotQueriesKey)
+          );
+        }
+      }
+      if (pokePart.rowsPatch) {
+        for (const p of pokePart.rowsPatch) {
+          mergedPatch.push(
+            rowsPatchOpToReplicachePatchOp(p, schema, serverToClient2)
+          );
+        }
+      }
+      if (pokePart.mutationsPatch) {
+        for (const op of pokePart.mutationsPatch) {
+          mergedPatch.push(mutationPatchOpToReplicachePatchOp(op));
+        }
+      }
+    }
+  }
+  const ret = {
+    baseCookie,
+    pullResponse: {
+      lastMutationIDChanges: mergedLastMutationIDChanges,
+      patch: mergedPatch,
+      cookie
+    }
+  };
+  if (mutationResults.length > 0) {
+    ret.mutationResults = mutationResults;
+  }
+  return ret;
+}
+function queryPatchOpToReplicachePatchOp(op, toKey) {
+  switch (op.op) {
+    case "clear":
+      return op;
+    case "del":
+      return {
+        op: "del",
+        key: toKey(op.hash)
+      };
+    case "put":
+      return {
+        op: "put",
+        key: toKey(op.hash),
+        value: null
+      };
+    default:
+      unreachable();
+  }
+}
+function mutationPatchOpToReplicachePatchOp(op) {
+  switch (op.op) {
+    case "put":
+      return {
+        op: "put",
+        key: toMutationResponseKey(op.mutation.id),
+        value: op.mutation.result
+      };
+    case "del":
+      return {
+        op: "del",
+        key: toMutationResponseKey(op.id)
+      };
+  }
+}
+function rowsPatchOpToReplicachePatchOp(op, schema, serverToClient2) {
+  if (op.op === "clear") {
+    return op;
+  }
+  const tableName = serverToClient2.tableName(op.tableName, op);
+  switch (op.op) {
+    case "del":
+      return {
+        op: "del",
+        key: toPrimaryKeyString(
+          tableName,
+          schema.tables[tableName].primaryKey,
+          serverToClient2.row(op.tableName, op.id)
+        )
+      };
+    case "put":
+      return {
+        op: "put",
+        key: toPrimaryKeyString(
+          tableName,
+          schema.tables[tableName].primaryKey,
+          serverToClient2.row(op.tableName, op.value)
+        ),
+        value: serverToClient2.row(op.tableName, op.value)
+      };
+    case "update":
+      return {
+        op: "update",
+        key: toPrimaryKeyString(
+          tableName,
+          schema.tables[tableName].primaryKey,
+          serverToClient2.row(op.tableName, op.id)
+        ),
+        merge: op.merge ? serverToClient2.row(op.tableName, op.merge) : void 0,
+        constrain: serverToClient2.columns(op.tableName, op.constrain)
+      };
+    default:
+      unreachable();
+  }
+}
+function rafFallback(callback) {
+  setTimeout(callback, 0);
+}
+export {
+  PokeHandler,
+  mergePokes,
+  mutationPatchOpToReplicachePatchOp
+};
+//# sourceMappingURL=zero-poke-handler.js.map

package/out/zero-client/src/client/zero-poke-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zero-poke-handler.js","sources":["../../../../../zero-client/src/client/zero-poke-handler.ts"],"sourcesContent":["import {Lock} from '@rocicorp/lock';\nimport type {LogContext} from '@rocicorp/logger';\nimport type {\n  PatchOperationInternal,\n  PokeInternal,\n} from '../../../replicache/src/impl.ts';\nimport type {PatchOperation} from '../../../replicache/src/patch-operation.ts';\nimport type {ClientID} from '../../../replicache/src/sync/ids.ts';\nimport {unreachable} from '../../../shared/src/asserts.ts';\nimport {getBrowserGlobalMethod} from '../../../shared/src/browser-env.ts';\nimport type {JSONValue} from '../../../shared/src/json.ts';\nimport type {MutationPatch} from '../../../zero-protocol/src/mutations-patch.ts';\nimport type {\n  PokeEndBody,\n  PokePartBody,\n  PokeStartBody,\n} from '../../../zero-protocol/src/poke.ts';\nimport type {QueriesPatchOp} from '../../../zero-protocol/src/queries-patch.ts';\nimport type {RowPatchOp} from '../../../zero-protocol/src/row-patch.ts';\nimport {\n  serverToClient,\n  type NameMapper,\n} from '../../../zero-schema/src/name-mapper.ts';\nimport type {Schema} from '../../../zero-types/src/schema.ts';\nimport {\n  toDesiredQueriesKey,\n  toGotQueriesKey,\n  toMutationResponseKey,\n  toPrimaryKeyString,\n} from './keys.ts';\nimport type {MutationTracker} from './mutation-tracker.ts';\n\ntype PokeAccumulator = {\n  readonly pokeStart: PokeStartBody;\n  readonly parts: PokePartBody[];\n  readonly pokeEnd: PokeEndBody;\n};\n\n/**\n * Handles the multi-part format of zero pokes.\n * As an optimization it also debounces pokes, only poking Replicache with a\n * merged poke at most once per frame (as determined by requestAnimationFrame).\n * The client cannot control how fast the server sends pokes, and it can only\n * update the UI once per frame. This debouncing avoids wastefully\n * computing separate diffs and IVM updates for intermediate states that will\n * never been displayed to the UI.\n */\nexport class PokeHandler {\n  readonly #replicachePoke: (poke: PokeInternal) => Promise<void>;\n  readonly #onPokeError: () => void;\n  readonly #clientID: ClientID;\n  readonly #lc: LogContext;\n  #receivingPoke: Omit<PokeAccumulator, 'pokeEnd'> | undefined = undefined;\n  readonly #pokeBuffer: PokeAccumulator[] = [];\n  #pokePlaybackLoopRunning = false;\n  #lastRafPerfTimestamp = 0;\n  // Serializes calls to this.#replicachePoke otherwise we can cause out of\n  // order poke errors.\n  readonly #pokeLock = new Lock();\n  readonly #schema: Schema;\n  readonly #serverToClient: NameMapper;\n  readonly #mutationTracker: MutationTracker;\n\n  readonly #raf =\n    getBrowserGlobalMethod('requestAnimationFrame') ?? rafFallback;\n\n  constructor(\n    replicachePoke: (poke: PokeInternal) => Promise<void>,\n    onPokeError: () => void,\n    clientID: ClientID,\n    schema: Schema,\n    lc: LogContext,\n    mutationTracker: MutationTracker,\n  ) {\n    this.#replicachePoke = replicachePoke;\n    this.#onPokeError = onPokeError;\n    this.#clientID = clientID;\n    this.#schema = schema;\n    this.#serverToClient = serverToClient(schema.tables);\n    this.#lc = lc.withContext('PokeHandler');\n    this.#mutationTracker = mutationTracker;\n  }\n\n  handlePokeStart(pokeStart: PokeStartBody) {\n    if (this.#receivingPoke) {\n      this.#handlePokeError(\n        `pokeStart ${JSON.stringify(\n          pokeStart,\n        )} while still receiving  ${JSON.stringify(\n          this.#receivingPoke.pokeStart,\n        )} `,\n      );\n      return;\n    }\n    this.#receivingPoke = {\n      pokeStart,\n      parts: [],\n    };\n  }\n\n  handlePokePart(pokePart: PokePartBody): number | undefined {\n    if (pokePart.pokeID !== this.#receivingPoke?.pokeStart.pokeID) {\n      this.#handlePokeError(\n        `pokePart for ${pokePart.pokeID}, when receiving ${\n          this.#receivingPoke?.pokeStart.pokeID\n        }`,\n      );\n      return;\n    }\n    this.#receivingPoke.parts.push(pokePart);\n    return pokePart.lastMutationIDChanges?.[this.#clientID];\n  }\n\n  handlePokeEnd(pokeEnd: PokeEndBody): void {\n    if (pokeEnd.pokeID !== this.#receivingPoke?.pokeStart.pokeID) {\n      this.#handlePokeError(\n        `pokeEnd for ${pokeEnd.pokeID}, when receiving ${\n          this.#receivingPoke?.pokeStart.pokeID\n        }`,\n      );\n      return;\n    }\n    if (pokeEnd.cancel) {\n      this.#receivingPoke = undefined;\n      return;\n    }\n    this.#pokeBuffer.push({...this.#receivingPoke, pokeEnd});\n    this.#receivingPoke = undefined;\n    if (!this.#pokePlaybackLoopRunning) {\n      this.#startPlaybackLoop();\n    }\n  }\n\n  handleDisconnect(): void {\n    this.#lc.debug?.('clearing due to disconnect');\n    this.#clear();\n  }\n\n  #startPlaybackLoop() {\n    this.#lc.debug?.('starting playback loop');\n    this.#pokePlaybackLoopRunning = true;\n    this.#raf(this.#rafCallback);\n  }\n\n  #rafCallback = async () => {\n    const rafLC = this.#lc.withContext('rafAt', Math.floor(performance.now()));\n    if (this.#pokeBuffer.length === 0) {\n      rafLC.debug?.('stopping playback loop');\n      this.#pokePlaybackLoopRunning = false;\n      return;\n    }\n    this.#raf(this.#rafCallback);\n    const start = performance.now();\n    rafLC.debug?.(\n      'raf fired, processing pokes.  Since last raf',\n      start - this.#lastRafPerfTimestamp,\n    );\n    this.#lastRafPerfTimestamp = start;\n    await this.#processPokesForFrame(rafLC);\n    rafLC.debug?.('processing pokes took', performance.now() - start);\n  };\n\n  #processPokesForFrame(lc: LogContext): Promise<void> {\n    return this.#pokeLock.withLock(async () => {\n      const now = Date.now();\n      lc.debug?.('got poke lock at', now);\n      lc.debug?.('merging', this.#pokeBuffer.length);\n      try {\n        const merged = mergePokes(\n          this.#pokeBuffer,\n          this.#schema,\n          this.#serverToClient,\n        );\n        this.#pokeBuffer.length = 0;\n        if (merged === undefined) {\n          lc.debug?.('frame is empty');\n          return;\n        }\n        const start = performance.now();\n        lc.debug?.('poking replicache');\n        await this.#replicachePoke(merged);\n        lc.debug?.('poking replicache took', performance.now() - start);\n\n        if (!('error' in merged.pullResponse)) {\n          const lmid =\n            merged.pullResponse.lastMutationIDChanges[this.#clientID];\n          if (lmid !== undefined) {\n            this.#mutationTracker.lmidAdvanced(lmid);\n          }\n        }\n      } catch (e) {\n        this.#handlePokeError(e);\n      }\n    });\n  }\n\n  #handlePokeError(e: unknown) {\n    if (String(e).includes('unexpected base cookie for poke')) {\n      // This can happen if cookie changes due to refresh from idb due\n      // to an update arriving to different tabs in the same\n      // client group at very different times.  Unusual but possible.\n      this.#lc.debug?.('clearing due to', e);\n    } else {\n      this.#lc.error?.('clearing due to unexpected poke error', e);\n    }\n    this.#clear();\n    this.#onPokeError();\n  }\n\n  #clear() {\n    this.#receivingPoke = undefined;\n    this.#pokeBuffer.length = 0;\n  }\n}\n\nexport function mergePokes(\n  pokeBuffer: PokeAccumulator[],\n  schema: Schema,\n  serverToClient: NameMapper,\n):\n  | (PokeInternal & {mutationResults?: MutationPatch[] | undefined})\n  | undefined {\n  if (pokeBuffer.length === 0) {\n    return undefined;\n  }\n  const {baseCookie} = pokeBuffer[0].pokeStart;\n  const lastPoke = pokeBuffer[pokeBuffer.length - 1];\n  const {cookie} = lastPoke.pokeEnd;\n  const mergedPatch: PatchOperationInternal[] = [];\n  const mergedLastMutationIDChanges: Record<string, number> = {};\n  const mutationResults: MutationPatch[] = [];\n\n  let prevPokeEnd = undefined;\n  for (const pokeAccumulator of pokeBuffer) {\n    if (\n      prevPokeEnd &&\n      pokeAccumulator.pokeStart.baseCookie &&\n      pokeAccumulator.pokeStart.baseCookie > prevPokeEnd.cookie\n    ) {\n      throw Error(\n        `unexpected cookie gap ${JSON.stringify(prevPokeEnd)} ${JSON.stringify(\n          pokeAccumulator.pokeStart,\n        )}`,\n      );\n    }\n    prevPokeEnd = pokeAccumulator.pokeEnd;\n    for (const pokePart of pokeAccumulator.parts) {\n      if (pokePart.lastMutationIDChanges) {\n        for (const [clientID, lastMutationID] of Object.entries(\n          pokePart.lastMutationIDChanges,\n        )) {\n          mergedLastMutationIDChanges[clientID] = lastMutationID;\n        }\n      }\n      if (pokePart.desiredQueriesPatches) {\n        for (const [clientID, queriesPatch] of Object.entries(\n          pokePart.desiredQueriesPatches,\n        )) {\n          for (const op of queriesPatch) {\n            mergedPatch.push(\n              queryPatchOpToReplicachePatchOp(op, hash =>\n                toDesiredQueriesKey(clientID, hash),\n              ),\n            );\n          }\n        }\n      }\n      if (pokePart.gotQueriesPatch) {\n        for (const op of pokePart.gotQueriesPatch) {\n          mergedPatch.push(\n            queryPatchOpToReplicachePatchOp(op, toGotQueriesKey),\n          );\n        }\n      }\n      if (pokePart.rowsPatch) {\n        for (const p of pokePart.rowsPatch) {\n          mergedPatch.push(\n            rowsPatchOpToReplicachePatchOp(p, schema, serverToClient),\n          );\n        }\n      }\n      if (pokePart.mutationsPatch) {\n        for (const op of pokePart.mutationsPatch) {\n          mergedPatch.push(mutationPatchOpToReplicachePatchOp(op));\n        }\n      }\n    }\n  }\n  const ret: PokeInternal & {mutationResults?: MutationPatch[] | undefined} = {\n    baseCookie,\n    pullResponse: {\n      lastMutationIDChanges: mergedLastMutationIDChanges,\n      patch: mergedPatch,\n      cookie,\n    },\n  };\n\n  // For backwards compatibility. Because we're strict on our validation,\n  // zero-client must be able to parse pokes with this field before we introduce it.\n  // So users can update their clients and then start using custom mutators that write responses to the db.\n  if (mutationResults.length > 0) {\n    ret.mutationResults = mutationResults;\n  }\n  return ret;\n}\n\nfunction queryPatchOpToReplicachePatchOp(\n  op: QueriesPatchOp,\n  toKey: (hash: string) => string,\n): PatchOperation {\n  switch (op.op) {\n    case 'clear':\n      return op;\n    case 'del':\n      return {\n        op: 'del',\n        key: toKey(op.hash),\n      };\n    case 'put':\n      return {\n        op: 'put',\n        key: toKey(op.hash),\n        value: null,\n      };\n    default:\n      unreachable(op);\n  }\n}\n\nexport function mutationPatchOpToReplicachePatchOp(\n  op: MutationPatch,\n): PatchOperationInternal {\n  switch (op.op) {\n    case 'put':\n      return {\n        op: 'put',\n        key: toMutationResponseKey(op.mutation.id),\n        value: op.mutation.result,\n      };\n    case 'del':\n      return {\n        op: 'del',\n        key: toMutationResponseKey(op.id),\n      };\n  }\n}\n\nfunction rowsPatchOpToReplicachePatchOp(\n  op: RowPatchOp,\n  schema: Schema,\n  serverToClient: NameMapper,\n): PatchOperationInternal {\n  if (op.op === 'clear') {\n    return op;\n  }\n  const tableName = serverToClient.tableName(op.tableName, op as JSONValue);\n  switch (op.op) {\n    case 'del':\n      return {\n        op: 'del',\n        key: toPrimaryKeyString(\n          tableName,\n          schema.tables[tableName].primaryKey,\n          serverToClient.row(op.tableName, op.id),\n        ),\n      };\n    case 'put':\n      return {\n        op: 'put',\n        key: toPrimaryKeyString(\n          tableName,\n          schema.tables[tableName].primaryKey,\n          serverToClient.row(op.tableName, op.value),\n        ),\n        value: serverToClient.row(op.tableName, op.value),\n      };\n    case 'update':\n      return {\n        op: 'update',\n        key: toPrimaryKeyString(\n          tableName,\n          schema.tables[tableName].primaryKey,\n          serverToClient.row(op.tableName, op.id),\n        ),\n        merge: op.merge\n          ? serverToClient.row(op.tableName, op.merge)\n          : undefined,\n        constrain: serverToClient.columns(op.tableName, op.constrain),\n      };\n    default:\n      unreachable(op);\n  }\n}\n\n/**\n * Some environments we run in don't have `requestAnimationFrame` (such as\n * Node, Cloudflare Workers).\n */\nfunction rafFallback(callback: () => void): void {\n  setTimeout(callback, 0);\n}\n"],"names":["serverToClient"],"mappings":"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"}

package/out/zero-client/src/client/zero-rep.d.ts

@@ -12,9 +12,9 @@ type TxData = {
     token: string | undefined;
     context: unknown;
 };
-export declare class ZeroRep<TContext> implements ZeroOption {
+export declare class ZeroRep implements ZeroOption {
     #private;
-    constructor(context: ZeroContext<TContext>, ivmMain: IVMSourceBranch, customMutatorsEnabled: boolean, mutationTracker: MutationTracker);
+    constructor(context: ZeroContext, ivmMain: IVMSourceBranch, customMutatorsEnabled: boolean, mutationTracker: MutationTracker);
     set auth(auth: string);
     init(hash: Hash, store: LazyStore): Promise<void>;
     getTxData: (desiredHead: Hash, readOptions?: ZeroReadOptions) => Promise<TxData> | undefined;

package/out/zero-client/src/client/zero-rep.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"zero-rep.d.ts","sourceRoot":"","sources":["../../../../../zero-client/src/client/zero-rep.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EAEb,MAAM,uCAAuC,CAAC;AAC/C,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,2CAA2C,CAAC;AAGzE,OAAO,KAAK,EAAC,IAAI,EAAC,MAAM,iCAAiC,CAAC;AAC1D,OAAO,KAAK,EACV,WAAW,EACX,oBAAoB,EACpB,UAAU,EACV,eAAe,EAChB,MAAM,+CAA+C,CAAC;AAGvD,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,iBAAiB,CAAC;AAErD,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,uBAAuB,CAAC;AAK3D,eAAO,MAAM,qBAAqB,GAChC,MAAM,MAAM,GAAG,SAAS,GAAG,IAAI,KAC9B,MAA0C,CAAC;AAE9C,eAAO,MAAM,uBAAuB,GAAI,MAAM,MAAM,KAAG,MAAM,GAAG,SACtC,CAAC;AAE3B,KAAK,MAAM,GAAG;IACZ,UAAU,EAAE,eAAe,CAAC;IAC5B,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,qBAAa,OAAO,CAAC,QAAQ,CAAE,YAAW,UAAU;;gBAUhD,OAAO,EAAE,WAAW,CAAC,QAAQ,CAAC,EAC9B,OAAO,EAAE,eAAe,EACxB,qBAAqB,EAAE,OAAO,EAC9B,eAAe,EAAE,eAAe;IAQlC,IAAI,IAAI,CAAC,IAAI,EAAE,MAAM,EAEpB;IAEK,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS;IAoBvC,SAAS,GACP,aAAa,IAAI,EACjB,cAAc,eAAe,KAC5B,OAAO,CAAC,MAAM,CAAC,GAAG,SAAS,CAe5B;IAEF,OAAO,GAAI,cAAc,IAAI,EAAE,SAAS,IAAI,EAAE,OAAO,YAAY,KAAG,IAAI,CAEtE;IAEF,aAAa,IAAI,oBAAoB;IAGrC,kBAAkB,CAAC,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAGtE,cAAc,CAAC,WAAW,EAAE,WAAW,EAAE,EAAE,EAAE,OAAO,GAAG,IAAI;CAG5D"}
+{"version":3,"file":"zero-rep.d.ts","sourceRoot":"","sources":["../../../../../zero-client/src/client/zero-rep.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EAEb,MAAM,uCAAuC,CAAC;AAC/C,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,2CAA2C,CAAC;AAGzE,OAAO,KAAK,EAAC,IAAI,EAAC,MAAM,iCAAiC,CAAC;AAC1D,OAAO,KAAK,EACV,WAAW,EACX,oBAAoB,EACpB,UAAU,EACV,eAAe,EAChB,MAAM,+CAA+C,CAAC;AAGvD,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,iBAAiB,CAAC;AAErD,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,uBAAuB,CAAC;AAK3D,eAAO,MAAM,qBAAqB,GAChC,MAAM,MAAM,GAAG,SAAS,GAAG,IAAI,KAC9B,MAA0C,CAAC;AAE9C,eAAO,MAAM,uBAAuB,GAAI,MAAM,MAAM,KAAG,MAAM,GAAG,SACtC,CAAC;AAE3B,KAAK,MAAM,GAAG;IACZ,UAAU,EAAE,eAAe,CAAC;IAC5B,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,qBAAa,OAAQ,YAAW,UAAU;;gBAUtC,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,eAAe,EACxB,qBAAqB,EAAE,OAAO,EAC9B,eAAe,EAAE,eAAe;IAQlC,IAAI,IAAI,CAAC,IAAI,EAAE,MAAM,EAEpB;IAEK,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS;IAoBvC,SAAS,GACP,aAAa,IAAI,EACjB,cAAc,eAAe,KAC5B,OAAO,CAAC,MAAM,CAAC,GAAG,SAAS,CAe5B;IAEF,OAAO,GAAI,cAAc,IAAI,EAAE,SAAS,IAAI,EAAE,OAAO,YAAY,KAAG,IAAI,CAEtE;IAEF,aAAa,IAAI,oBAAoB;IAGrC,kBAAkB,CAAC,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAGtE,cAAc,CAAC,WAAW,EAAE,WAAW,EAAE,EAAE,EAAE,OAAO,GAAG,IAAI;CAG5D"}

package/out/zero-client/src/client/zero-rep.js

@@ -0,0 +1,72 @@
+import { readFromHash } from "../../../replicache/src/db/read.js";
+import { Latest } from "../../../replicache/src/format-version-enum.js";
+import { withRead } from "../../../replicache/src/with-transactions.js";
+import { must } from "../../../shared/src/must.js";
+import { ENTITIES_KEY_PREFIX } from "./keys.js";
+const REPLICACHE_NO_AUTH_TOKEN = "";
+const toReplicacheAuthToken = (auth) => auth ?? REPLICACHE_NO_AUTH_TOKEN;
+const fromReplicacheAuthToken = (auth) => !auth ? void 0 : auth;
+class ZeroRep {
+  #context;
+  #ivmMain;
+  #customMutatorsEnabled;
+  #mutationTracker;
+  #store;
+  // matches replicache's auth token type
+  #auth = REPLICACHE_NO_AUTH_TOKEN;
+  constructor(context, ivmMain, customMutatorsEnabled, mutationTracker) {
+    this.#context = context;
+    this.#ivmMain = ivmMain;
+    this.#customMutatorsEnabled = customMutatorsEnabled;
+    this.#mutationTracker = mutationTracker;
+  }
+  set auth(auth) {
+    this.#auth = auth;
+  }
+  async init(hash, store) {
+    const diffs = [];
+    await withRead(store, async (dagRead) => {
+      const read = await readFromHash(hash, dagRead, Latest);
+      for await (const entry of read.map.scan(ENTITIES_KEY_PREFIX)) {
+        if (!entry[0].startsWith(ENTITIES_KEY_PREFIX)) {
+          break;
+        }
+        diffs.push({
+          op: "add",
+          key: entry[0],
+          newValue: entry[1]
+        });
+      }
+    });
+    this.#store = store;
+    this.#context.processChanges(void 0, hash, diffs);
+  }
+  getTxData = (desiredHead, readOptions) => {
+    if (!this.#customMutatorsEnabled) {
+      return;
+    }
+    return this.#ivmMain.forkToHead(must(this.#store), desiredHead, readOptions).then((branch) => ({
+      ivmSources: branch,
+      token: fromReplicacheAuthToken(this.#auth),
+      context: this.#context
+    }));
+  };
+  advance = (expectedHash, newHash, diffs) => {
+    this.#context.processChanges(expectedHash, newHash, diffs);
+  };
+  trackMutation() {
+    return this.#mutationTracker.trackMutation();
+  }
+  mutationIDAssigned(ephemeralID, mutationID) {
+    this.#mutationTracker.mutationIDAssigned(ephemeralID, mutationID);
+  }
+  rejectMutation(ephemeralID, ex) {
+    this.#mutationTracker.rejectMutation(ephemeralID, ex);
+  }
+}
+export {
+  ZeroRep,
+  fromReplicacheAuthToken,
+  toReplicacheAuthToken
+};
+//# sourceMappingURL=zero-rep.js.map