@rocicorp/zero 0.26.1 → 0.26.2-canary.4

package/out/zero-client/src/client/query-manager.js.map

@@ -1 +1 @@
-{"version":3,"file":"query-manager.js","sources":["../../../../../zero-client/src/client/query-manager.ts"],"sourcesContent":["import type {LogContext} from '@rocicorp/logger';\nimport type {ReplicacheImpl} from '../../../replicache/src/replicache-impl.ts';\nimport type {ClientID} from '../../../replicache/src/sync/ids.ts';\nimport {assert} from '../../../shared/src/asserts.ts';\nimport type {ReadonlyJSONValue} from '../../../shared/src/json.ts';\nimport {must} from '../../../shared/src/must.ts';\nimport {difference} from '../../../shared/src/set-utils.ts';\nimport {TDigest} from '../../../shared/src/tdigest.ts';\nimport {\n  mapAST,\n  normalizeAST,\n  type AST,\n} from '../../../zero-protocol/src/ast.ts';\nimport type {ChangeDesiredQueriesMessage} from '../../../zero-protocol/src/change-desired-queries.ts';\nimport type {ErroredQuery} from '../../../zero-protocol/src/custom-queries.ts';\nimport {ErrorKind} from '../../../zero-protocol/src/error-kind.ts';\nimport {ErrorOrigin} from '../../../zero-protocol/src/error-origin.ts';\nimport {ErrorReason} from '../../../zero-protocol/src/error-reason.ts';\nimport {ProtocolError} from '../../../zero-protocol/src/error.ts';\nimport type {UpQueriesPatchOp} from '../../../zero-protocol/src/queries-patch.ts';\nimport {\n  hashOfAST,\n  hashOfNameAndArgs,\n} from '../../../zero-protocol/src/query-hash.ts';\nimport {\n  clientToServer,\n  serverToClient,\n  type NameMapper,\n} from '../../../zero-schema/src/name-mapper.ts';\nimport type {TableSchema} from '../../../zero-schema/src/table-schema.ts';\nimport type {ClientMetricMap} from '../../../zql/src/query/metrics-delegate.ts';\nimport type {CustomQueryID} from '../../../zql/src/query/named.ts';\nimport type {GotCallback} from '../../../zql/src/query/query-delegate.ts';\nimport {clampTTL, compareTTL, type TTL} from '../../../zql/src/query/ttl.ts';\nimport type {ClientErrorKind} from './client-error-kind.ts';\nimport type {ClientError} from './error.ts';\nimport {type ZeroError} from './error.ts';\nimport type {InspectorDelegate} from './inspector/inspector.ts';\nimport {desiredQueriesPrefixForClient, GOT_QUERIES_KEY_PREFIX} from './keys.ts';\nimport type {MutationTracker} from './mutation-tracker.ts';\nimport type {ReadTransaction} from './replicache-types.ts';\n\ntype QueryHash = string;\n\ntype Entry = {\n  // We keep track of the AST so we can use it in the inspector.\n  normalized: AST;\n  name: string | undefined;\n  args: readonly ReadonlyJSONValue[] | undefined;\n  count: number;\n  gotCallbacks: GotCallback[];\n  ttl: TTL;\n};\n\ntype ClientMetric = {\n  [K in keyof ClientMetricMap]: TDigest;\n};\n\n/**\n * Tracks what queries the client is currently subscribed to on the server.\n * Sends `changeDesiredQueries` message to server when this changes.\n * Deduplicates requests so that we only listen to a given unique query once.\n */\nexport class QueryManager implements InspectorDelegate {\n  readonly #clientID: ClientID;\n  readonly #clientToServer: NameMapper;\n  readonly #serverToClient: NameMapper;\n  readonly #send: (change: ChangeDesiredQueriesMessage) => void;\n  readonly #onFatalError: (error: ZeroError) => void;\n  readonly #queries: Map<QueryHash, Entry> = new Map();\n  readonly #recentQueriesMaxSize: number;\n  readonly #recentQueries: Set<string> = new Set();\n  readonly #gotQueries: Set<string> = new Set();\n  readonly #mutationTracker: MutationTracker;\n  readonly #pendingQueryChanges: UpQueriesPatchOp[] = [];\n  readonly #queryChangeThrottleMs: number;\n  #pendingRemovals: Array<() => void> = [];\n  #batchTimer: ReturnType<typeof setTimeout> | undefined;\n  readonly #lc: LogContext;\n  readonly #metrics: ClientMetric = newMetrics();\n  readonly #queryMetrics: Map<string, ClientMetric> = new Map();\n  readonly #slowMaterializeThreshold: number;\n  #closedError: ZeroError | undefined;\n\n  constructor(\n    lc: LogContext,\n    mutationTracker: MutationTracker,\n    clientID: ClientID,\n    tables: Record<string, TableSchema>,\n    send: (change: ChangeDesiredQueriesMessage) => void,\n    experimentalWatch: ReplicacheImpl['experimentalWatch'],\n    recentQueriesMaxSize: number,\n    queryChangeThrottleMs: number,\n    slowMaterializeThreshold: number,\n    onFatalError: (error: ZeroError) => void,\n  ) {\n    this.#lc = lc.withContext('QueryManager');\n    this.#clientID = clientID;\n    this.#clientToServer = clientToServer(tables);\n    this.#serverToClient = serverToClient(tables);\n    this.#recentQueriesMaxSize = recentQueriesMaxSize;\n    this.#send = send;\n    this.#mutationTracker = mutationTracker;\n    this.#queryChangeThrottleMs = queryChangeThrottleMs;\n    this.#slowMaterializeThreshold = slowMaterializeThreshold;\n    this.#onFatalError = onFatalError;\n    this.#mutationTracker.onAllMutationsApplied(() => {\n      if (this.#pendingRemovals.length === 0) {\n        return;\n      }\n      const pendingRemovals = this.#pendingRemovals;\n      this.#pendingRemovals = [];\n      for (const removal of pendingRemovals) {\n        removal();\n      }\n    });\n\n    experimentalWatch(\n      diff => {\n        for (const diffOp of diff) {\n          const queryHash = diffOp.key.substring(GOT_QUERIES_KEY_PREFIX.length);\n          switch (diffOp.op) {\n            case 'add':\n              this.#gotQueries.add(queryHash);\n              this.#fireGotCallbacks(queryHash, true);\n              break;\n            case 'del':\n              this.#gotQueries.delete(queryHash);\n              this.#fireGotCallbacks(queryHash, false);\n              break;\n          }\n        }\n      },\n      {\n        prefix: GOT_QUERIES_KEY_PREFIX,\n        initialValuesInFirstDiff: true,\n      },\n    );\n  }\n\n  getAST(queryID: string): AST | undefined {\n    const ast = this.#queries.get(queryID)?.normalized;\n    return ast && mapAST(ast, this.#serverToClient);\n  }\n\n  mapClientASTToServer(ast: AST): AST {\n    return mapAST(ast, this.#clientToServer);\n  }\n\n  #fireGotCallbacks(queryHash: string, got: boolean) {\n    const gotCallbacks = this.#queries.get(queryHash)?.gotCallbacks ?? [];\n    for (const gotCallback of gotCallbacks) {\n      gotCallback(got);\n    }\n  }\n\n  /**\n   * Get the queries that need to be registered with the server.\n   *\n   * An optional `lastPatch` can be provided. This is the last patch that was\n   * sent to the server and may not yet have been acked. If `lastPatch` is provided,\n   * this method will return a patch that does not include any events sent in `lastPatch`.\n   *\n   * This diffing of last patch and current patch is needed since we send\n   * a set of queries to the server when we first connect inside of the `sec-protocol` as\n   * the `initConnectionMessage`.\n   *\n   * While we're waiting for the `connected` response to come back from the server,\n   * the client may have registered more queries. We need to diff the `initConnectionMessage`\n   * queries with the current set of queries to understand what those were.\n   */\n  async getQueriesPatch(\n    tx: ReadTransaction,\n    lastPatch?: Map<string, UpQueriesPatchOp>,\n  ): Promise<Map<string, UpQueriesPatchOp>> {\n    const existingQueryHashes = new Set<string>();\n    const prefix = desiredQueriesPrefixForClient(this.#clientID);\n    for await (const key of tx.scan({prefix}).keys()) {\n      existingQueryHashes.add(key.substring(prefix.length, key.length));\n    }\n    const patch: Map<string, UpQueriesPatchOp> = new Map();\n    for (const hash of existingQueryHashes) {\n      if (!this.#queries.has(hash)) {\n        patch.set(hash, {op: 'del', hash});\n      }\n    }\n\n    for (const [hash, {normalized, ttl, name, args}] of this.#queries) {\n      if (!existingQueryHashes.has(hash)) {\n        patch.set(hash, {\n          op: 'put',\n          hash,\n          ast: name === undefined ? normalized : undefined,\n          name,\n          args,\n          // We get TTL out of the DagStore so it is possible that the TTL was written\n          // with a too high TTL.\n          ttl: clampTTL(ttl), // no lc here since no need to log here\n        });\n      }\n    }\n\n    if (lastPatch) {\n      // if there are any `puts` in `lastPatch` that are not in `patch` then we need to\n      // send a `del` event in `patch`.\n      for (const [hash, {op}] of lastPatch) {\n        if (op === 'put' && !patch.has(hash)) {\n          patch.set(hash, {op: 'del', hash});\n        }\n      }\n      // Remove everything from `patch` that was already sent in `lastPatch`.\n      for (const [hash, {op}] of patch) {\n        const lastPatchOp = lastPatch.get(hash);\n        if (lastPatchOp && lastPatchOp.op === op) {\n          patch.delete(hash);\n        }\n      }\n    }\n\n    return patch;\n  }\n\n  handleTransformErrors(errors: ErroredQuery[]) {\n    for (const error of errors) {\n      const queryId = error.id;\n      const entry = this.#queries.get(queryId);\n\n      // if we don't have the query registered, continue\n      if (!entry) {\n        continue;\n      }\n\n      if (error.error === 'app' || error.error === 'parse') {\n        entry.gotCallbacks.forEach(callback => callback(false, error));\n      }\n      // this code path is not possible technically since errors were never implemented in the legacy query transform error\n      // but is included for backwards compatibility and we have a test case for it\n      else {\n        this.#onFatalError(\n          new ProtocolError({\n            kind: ErrorKind.TransformFailed,\n            origin: ErrorOrigin.ZeroCache,\n            reason: ErrorReason.Internal,\n            message: `Unknown error transforming queries: ${JSON.stringify(error)}`,\n            queryIDs: [],\n          }),\n        );\n        // unreachable(error); TODO(0xcadams): this should eventually be unreachable\n      }\n    }\n  }\n\n  handleClosed(\n    reason: ClientError<{kind: ClientErrorKind.ClientClosed; message: string}>,\n  ) {\n    if (this.#closedError) {\n      return;\n    }\n    this.#closedError = reason;\n    for (const [queryId, entry] of this.#queries) {\n      const erroredQuery: ErroredQuery = {\n        error: 'app',\n        id: queryId,\n        name: entry.name ?? 'legacy',\n        message: reason.message,\n        details: {kind: reason.kind},\n      };\n      for (const gotCallback of entry.gotCallbacks) {\n        gotCallback(false, erroredQuery);\n      }\n    }\n  }\n\n  addCustom(\n    ast: AST,\n    {name, args}: CustomQueryID,\n    ttl: TTL,\n    gotCallback?: GotCallback,\n  ): () => void {\n    const normalized = normalizeAST(ast);\n    const queryId = hashOfNameAndArgs(name, args);\n    return this.#add(queryId, normalized, name, args, ttl, gotCallback);\n  }\n\n  addLegacy(ast: AST, ttl: TTL, gotCallback?: GotCallback): () => void {\n    const normalized = normalizeAST(ast);\n    const astHash = hashOfAST(normalized);\n    return this.#add(\n      astHash,\n      normalized,\n      undefined, // name is undefined for legacy queries\n      undefined, // args are undefined for legacy queries\n      ttl,\n      gotCallback,\n    );\n  }\n\n  #add(\n    queryId: string,\n    normalized: AST,\n    name: string | undefined,\n    args: readonly ReadonlyJSONValue[] | undefined,\n    ttl: TTL,\n    gotCallback?: GotCallback,\n  ) {\n    assert(\n      (name === undefined) === (args === undefined),\n      'If name is defined, args must be defined',\n    );\n    ttl = clampTTL(ttl, this.#lc);\n    let entry = this.#queries.get(queryId);\n    this.#recentQueries.delete(queryId);\n    if (!entry) {\n      normalized = mapAST(normalized, this.#clientToServer);\n\n      entry = {\n        normalized,\n        name,\n        args,\n        count: 1,\n        gotCallbacks: gotCallback ? [gotCallback] : [],\n        ttl,\n      };\n      this.#queries.set(queryId, entry);\n      this.#queueQueryChange({\n        op: 'put',\n        hash: queryId,\n        ast: name === undefined ? normalized : undefined,\n        name,\n        args,\n        ttl,\n      });\n    } else {\n      ++entry.count;\n      this.#updateEntry(entry, queryId, ttl);\n\n      if (gotCallback) {\n        entry.gotCallbacks.push(gotCallback);\n      }\n    }\n\n    if (gotCallback) {\n      gotCallback(this.#gotQueries.has(queryId));\n    }\n\n    let removed = false;\n    const cleanupCb = () => {\n      if (removed) {\n        return;\n      }\n      removed = true;\n\n      // We cannot remove queries while mutations are pending\n      // as that could take data out of scope that is needed in a rebase\n      if (this.#mutationTracker.size > 0) {\n        this.#pendingRemovals.push(() =>\n          this.#remove(entry, queryId, gotCallback),\n        );\n        return;\n      }\n\n      this.#remove(entry, queryId, gotCallback);\n    };\n    return cleanupCb;\n  }\n\n  updateCustom({name, args}: CustomQueryID, ttl: TTL) {\n    const queryID = hashOfNameAndArgs(name, args);\n    const entry = must(this.#queries.get(queryID));\n    this.#updateEntry(entry, queryID, ttl);\n  }\n\n  updateLegacy(ast: AST, ttl: TTL) {\n    const normalized = normalizeAST(ast);\n    const queryID = hashOfAST(normalized);\n    const entry = must(this.#queries.get(queryID));\n    this.#updateEntry(entry, queryID, ttl);\n  }\n\n  #updateEntry(entry: Entry, queryID: string, ttl: TTL): void {\n    // If the query already exists and the new ttl is larger than the old one\n    // we send a changeDesiredQueries message to the server to update the ttl.\n    ttl = clampTTL(ttl, this.#lc);\n    if (compareTTL(ttl, entry.ttl) > 0) {\n      entry.ttl = ttl;\n      this.#queueQueryChange({\n        op: 'put',\n        hash: queryID,\n        ast: entry.name === undefined ? entry.normalized : undefined,\n        name: entry.name,\n        args: entry.args,\n        ttl,\n      });\n    }\n  }\n\n  #queueQueryChange(op: UpQueriesPatchOp) {\n    this.#pendingQueryChanges.push(op);\n    this.#scheduleBatch();\n  }\n\n  #scheduleBatch() {\n    if (this.#batchTimer === undefined) {\n      this.#batchTimer = setTimeout(\n        () => this.flushBatch(),\n        this.#queryChangeThrottleMs,\n      );\n    }\n  }\n\n  flushBatch() {\n    if (this.#batchTimer !== undefined) {\n      clearTimeout(this.#batchTimer);\n      this.#batchTimer = undefined;\n    }\n    if (this.#pendingQueryChanges.length > 0) {\n      this.#send([\n        'changeDesiredQueries',\n        {\n          desiredQueriesPatch: [...this.#pendingQueryChanges],\n        },\n      ]);\n      this.#pendingQueryChanges.length = 0;\n    }\n  }\n\n  #remove(entry: Entry, astHash: string, gotCallback: GotCallback | undefined) {\n    if (gotCallback) {\n      const index = entry.gotCallbacks.indexOf(gotCallback);\n      entry.gotCallbacks.splice(index, 1);\n    }\n    --entry.count;\n    if (entry.count === 0) {\n      this.#recentQueries.add(astHash);\n      if (this.#recentQueries.size > this.#recentQueriesMaxSize) {\n        const lruQueryID = this.#recentQueries.values().next().value;\n        assert(lruQueryID, 'Expected LRU query ID to exist');\n        this.#queries.delete(lruQueryID);\n        this.#recentQueries.delete(lruQueryID);\n        this.#queryMetrics.delete(lruQueryID);\n        this.#queueQueryChange({op: 'del', hash: lruQueryID});\n      }\n    }\n  }\n\n  /**\n   * Gets the aggregated metrics for all queries managed by this QueryManager.\n   */\n  get metrics(): ClientMetric {\n    return this.#metrics;\n  }\n\n  addMetric<K extends keyof ClientMetricMap>(\n    metric: K,\n    value: number,\n    ...args: ClientMetricMap[K]\n  ): void {\n    // Only query metrics are tracked at this point.\n    // If this check fails then we need to add a runtime check.\n    metric satisfies `query-${string}`;\n\n    // We track all materializations of queries as well as per\n    // query materializations.\n    this.#metrics[metric].add(value);\n\n    const queryID = args[0];\n\n    // Handle slow query logging for end-to-end materialization\n    if (metric === 'query-materialization-end-to-end') {\n      const ast = args[1];\n\n      if (\n        this.#slowMaterializeThreshold !== undefined &&\n        value > this.#slowMaterializeThreshold\n      ) {\n        this.#lc.warn?.(\n          'Slow query materialization (including server/network)',\n          queryID,\n          ast,\n          value,\n        );\n      } else {\n        this.#lc.debug?.(\n          'Materialized query (including server/network)',\n          queryID,\n          ast,\n          value,\n        );\n      }\n    }\n\n    // The query manager manages metrics that are per query.\n    let existing = this.#queryMetrics.get(queryID);\n    if (!existing) {\n      existing = newMetrics();\n      this.#queryMetrics.set(queryID, existing);\n    }\n    existing[metric].add(value);\n  }\n\n  getQueryMetrics(queryID: string): ClientMetric | undefined {\n    return this.#queryMetrics.get(queryID);\n  }\n\n  /**\n   * For testing only: returns all query hashes currently registered.\n   */\n  getAllNonGotQueryHashes(): Iterable<string> {\n    return difference(this.#queries, this.#gotQueries);\n  }\n}\n\nfunction newMetrics(): ClientMetric {\n  return {\n    'query-materialization-client': new TDigest(),\n    'query-materialization-end-to-end': new TDigest(),\n    'query-update-client': new TDigest(),\n  };\n}\n"],"names":["ErrorKind.TransformFailed","ErrorOrigin.ZeroCache","ErrorReason.Internal"],"mappings":"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"}
+{"version":3,"file":"query-manager.js","names":["#clientID","#clientToServer","#serverToClient","#send","#onFatalError","#queries","#recentQueriesMaxSize","#recentQueries","#gotQueries","#mutationTracker","#pendingQueryChanges","#queryChangeThrottleMs","#lc","#metrics","#queryMetrics","#slowMaterializeThreshold","#pendingRemovals","#fireGotCallbacks","#closedError","#add","#queueQueryChange","#updateEntry","#remove","#scheduleBatch","#batchTimer"],"sources":["../../../../../zero-client/src/client/query-manager.ts"],"sourcesContent":["import type {LogContext} from '@rocicorp/logger';\nimport type {ReplicacheImpl} from '../../../replicache/src/replicache-impl.ts';\nimport type {ClientID} from '../../../replicache/src/sync/ids.ts';\nimport {assert} from '../../../shared/src/asserts.ts';\nimport type {ReadonlyJSONValue} from '../../../shared/src/json.ts';\nimport {must} from '../../../shared/src/must.ts';\nimport {difference} from '../../../shared/src/set-utils.ts';\nimport {TDigest} from '../../../shared/src/tdigest.ts';\nimport {\n  mapAST,\n  normalizeAST,\n  type AST,\n} from '../../../zero-protocol/src/ast.ts';\nimport type {ChangeDesiredQueriesMessage} from '../../../zero-protocol/src/change-desired-queries.ts';\nimport type {ErroredQuery} from '../../../zero-protocol/src/custom-queries.ts';\nimport {ErrorKind} from '../../../zero-protocol/src/error-kind.ts';\nimport {ErrorOrigin} from '../../../zero-protocol/src/error-origin.ts';\nimport {ErrorReason} from '../../../zero-protocol/src/error-reason.ts';\nimport {ProtocolError} from '../../../zero-protocol/src/error.ts';\nimport type {UpQueriesPatchOp} from '../../../zero-protocol/src/queries-patch.ts';\nimport {\n  hashOfAST,\n  hashOfNameAndArgs,\n} from '../../../zero-protocol/src/query-hash.ts';\nimport {\n  clientToServer,\n  serverToClient,\n  type NameMapper,\n} from '../../../zero-schema/src/name-mapper.ts';\nimport type {TableSchema} from '../../../zero-schema/src/table-schema.ts';\nimport type {ClientMetricMap} from '../../../zql/src/query/metrics-delegate.ts';\nimport type {CustomQueryID} from '../../../zql/src/query/named.ts';\nimport type {GotCallback} from '../../../zql/src/query/query-delegate.ts';\nimport {clampTTL, compareTTL, type TTL} from '../../../zql/src/query/ttl.ts';\nimport type {ClientErrorKind} from './client-error-kind.ts';\nimport type {ClientError} from './error.ts';\nimport {type ZeroError} from './error.ts';\nimport type {InspectorDelegate} from './inspector/inspector.ts';\nimport {desiredQueriesPrefixForClient, GOT_QUERIES_KEY_PREFIX} from './keys.ts';\nimport type {MutationTracker} from './mutation-tracker.ts';\nimport type {ReadTransaction} from './replicache-types.ts';\n\ntype QueryHash = string;\n\ntype Entry = {\n  // We keep track of the AST so we can use it in the inspector.\n  normalized: AST;\n  name: string | undefined;\n  args: readonly ReadonlyJSONValue[] | undefined;\n  count: number;\n  gotCallbacks: GotCallback[];\n  ttl: TTL;\n};\n\ntype ClientMetric = {\n  [K in keyof ClientMetricMap]: TDigest;\n};\n\n/**\n * Tracks what queries the client is currently subscribed to on the server.\n * Sends `changeDesiredQueries` message to server when this changes.\n * Deduplicates requests so that we only listen to a given unique query once.\n */\nexport class QueryManager implements InspectorDelegate {\n  readonly #clientID: ClientID;\n  readonly #clientToServer: NameMapper;\n  readonly #serverToClient: NameMapper;\n  readonly #send: (change: ChangeDesiredQueriesMessage) => void;\n  readonly #onFatalError: (error: ZeroError) => void;\n  readonly #queries: Map<QueryHash, Entry> = new Map();\n  readonly #recentQueriesMaxSize: number;\n  readonly #recentQueries: Set<string> = new Set();\n  readonly #gotQueries: Set<string> = new Set();\n  readonly #mutationTracker: MutationTracker;\n  readonly #pendingQueryChanges: UpQueriesPatchOp[] = [];\n  readonly #queryChangeThrottleMs: number;\n  #pendingRemovals: Array<() => void> = [];\n  #batchTimer: ReturnType<typeof setTimeout> | undefined;\n  readonly #lc: LogContext;\n  readonly #metrics: ClientMetric = newMetrics();\n  readonly #queryMetrics: Map<string, ClientMetric> = new Map();\n  readonly #slowMaterializeThreshold: number;\n  #closedError: ZeroError | undefined;\n\n  constructor(\n    lc: LogContext,\n    mutationTracker: MutationTracker,\n    clientID: ClientID,\n    tables: Record<string, TableSchema>,\n    send: (change: ChangeDesiredQueriesMessage) => void,\n    experimentalWatch: ReplicacheImpl['experimentalWatch'],\n    recentQueriesMaxSize: number,\n    queryChangeThrottleMs: number,\n    slowMaterializeThreshold: number,\n    onFatalError: (error: ZeroError) => void,\n  ) {\n    this.#lc = lc.withContext('QueryManager');\n    this.#clientID = clientID;\n    this.#clientToServer = clientToServer(tables);\n    this.#serverToClient = serverToClient(tables);\n    this.#recentQueriesMaxSize = recentQueriesMaxSize;\n    this.#send = send;\n    this.#mutationTracker = mutationTracker;\n    this.#queryChangeThrottleMs = queryChangeThrottleMs;\n    this.#slowMaterializeThreshold = slowMaterializeThreshold;\n    this.#onFatalError = onFatalError;\n    this.#mutationTracker.onAllMutationsApplied(() => {\n      if (this.#pendingRemovals.length === 0) {\n        return;\n      }\n      const pendingRemovals = this.#pendingRemovals;\n      this.#pendingRemovals = [];\n      for (const removal of pendingRemovals) {\n        removal();\n      }\n    });\n\n    experimentalWatch(\n      diff => {\n        for (const diffOp of diff) {\n          const queryHash = diffOp.key.substring(GOT_QUERIES_KEY_PREFIX.length);\n          switch (diffOp.op) {\n            case 'add':\n              this.#gotQueries.add(queryHash);\n              this.#fireGotCallbacks(queryHash, true);\n              break;\n            case 'del':\n              this.#gotQueries.delete(queryHash);\n              this.#fireGotCallbacks(queryHash, false);\n              break;\n          }\n        }\n      },\n      {\n        prefix: GOT_QUERIES_KEY_PREFIX,\n        initialValuesInFirstDiff: true,\n      },\n    );\n  }\n\n  getAST(queryID: string): AST | undefined {\n    const ast = this.#queries.get(queryID)?.normalized;\n    return ast && mapAST(ast, this.#serverToClient);\n  }\n\n  mapClientASTToServer(ast: AST): AST {\n    return mapAST(ast, this.#clientToServer);\n  }\n\n  #fireGotCallbacks(queryHash: string, got: boolean) {\n    const gotCallbacks = this.#queries.get(queryHash)?.gotCallbacks ?? [];\n    for (const gotCallback of gotCallbacks) {\n      gotCallback(got);\n    }\n  }\n\n  /**\n   * Get the queries that need to be registered with the server.\n   *\n   * An optional `lastPatch` can be provided. This is the last patch that was\n   * sent to the server and may not yet have been acked. If `lastPatch` is provided,\n   * this method will return a patch that does not include any events sent in `lastPatch`.\n   *\n   * This diffing of last patch and current patch is needed since we send\n   * a set of queries to the server when we first connect inside of the `sec-protocol` as\n   * the `initConnectionMessage`.\n   *\n   * While we're waiting for the `connected` response to come back from the server,\n   * the client may have registered more queries. We need to diff the `initConnectionMessage`\n   * queries with the current set of queries to understand what those were.\n   */\n  async getQueriesPatch(\n    tx: ReadTransaction,\n    lastPatch?: Map<string, UpQueriesPatchOp>,\n  ): Promise<Map<string, UpQueriesPatchOp>> {\n    const existingQueryHashes = new Set<string>();\n    const prefix = desiredQueriesPrefixForClient(this.#clientID);\n    for await (const key of tx.scan({prefix}).keys()) {\n      existingQueryHashes.add(key.substring(prefix.length, key.length));\n    }\n    const patch: Map<string, UpQueriesPatchOp> = new Map();\n    for (const hash of existingQueryHashes) {\n      if (!this.#queries.has(hash)) {\n        patch.set(hash, {op: 'del', hash});\n      }\n    }\n\n    for (const [hash, {normalized, ttl, name, args}] of this.#queries) {\n      if (!existingQueryHashes.has(hash)) {\n        patch.set(hash, {\n          op: 'put',\n          hash,\n          ast: name === undefined ? normalized : undefined,\n          name,\n          args,\n          // We get TTL out of the DagStore so it is possible that the TTL was written\n          // with a too high TTL.\n          ttl: clampTTL(ttl), // no lc here since no need to log here\n        });\n      }\n    }\n\n    if (lastPatch) {\n      // if there are any `puts` in `lastPatch` that are not in `patch` then we need to\n      // send a `del` event in `patch`.\n      for (const [hash, {op}] of lastPatch) {\n        if (op === 'put' && !patch.has(hash)) {\n          patch.set(hash, {op: 'del', hash});\n        }\n      }\n      // Remove everything from `patch` that was already sent in `lastPatch`.\n      for (const [hash, {op}] of patch) {\n        const lastPatchOp = lastPatch.get(hash);\n        if (lastPatchOp && lastPatchOp.op === op) {\n          patch.delete(hash);\n        }\n      }\n    }\n\n    return patch;\n  }\n\n  handleTransformErrors(errors: ErroredQuery[]) {\n    for (const error of errors) {\n      const queryId = error.id;\n      const entry = this.#queries.get(queryId);\n\n      // if we don't have the query registered, continue\n      if (!entry) {\n        continue;\n      }\n\n      if (error.error === 'app' || error.error === 'parse') {\n        entry.gotCallbacks.forEach(callback => callback(false, error));\n      }\n      // this code path is not possible technically since errors were never implemented in the legacy query transform error\n      // but is included for backwards compatibility and we have a test case for it\n      else {\n        this.#onFatalError(\n          new ProtocolError({\n            kind: ErrorKind.TransformFailed,\n            origin: ErrorOrigin.ZeroCache,\n            reason: ErrorReason.Internal,\n            message: `Unknown error transforming queries: ${JSON.stringify(error)}`,\n            queryIDs: [],\n          }),\n        );\n        // unreachable(error); TODO(0xcadams): this should eventually be unreachable\n      }\n    }\n  }\n\n  handleClosed(\n    reason: ClientError<{kind: ClientErrorKind.ClientClosed; message: string}>,\n  ) {\n    if (this.#closedError) {\n      return;\n    }\n    this.#closedError = reason;\n    for (const [queryId, entry] of this.#queries) {\n      const erroredQuery: ErroredQuery = {\n        error: 'app',\n        id: queryId,\n        name: entry.name ?? 'legacy',\n        message: reason.message,\n        details: {kind: reason.kind},\n      };\n      for (const gotCallback of entry.gotCallbacks) {\n        gotCallback(false, erroredQuery);\n      }\n    }\n  }\n\n  addCustom(\n    ast: AST,\n    {name, args}: CustomQueryID,\n    ttl: TTL,\n    gotCallback?: GotCallback,\n  ): () => void {\n    const normalized = normalizeAST(ast);\n    const queryId = hashOfNameAndArgs(name, args);\n    return this.#add(queryId, normalized, name, args, ttl, gotCallback);\n  }\n\n  addLegacy(ast: AST, ttl: TTL, gotCallback?: GotCallback): () => void {\n    const normalized = normalizeAST(ast);\n    const astHash = hashOfAST(normalized);\n    return this.#add(\n      astHash,\n      normalized,\n      undefined, // name is undefined for legacy queries\n      undefined, // args are undefined for legacy queries\n      ttl,\n      gotCallback,\n    );\n  }\n\n  #add(\n    queryId: string,\n    normalized: AST,\n    name: string | undefined,\n    args: readonly ReadonlyJSONValue[] | undefined,\n    ttl: TTL,\n    gotCallback?: GotCallback,\n  ) {\n    assert(\n      (name === undefined) === (args === undefined),\n      'If name is defined, args must be defined',\n    );\n    ttl = clampTTL(ttl, this.#lc);\n    let entry = this.#queries.get(queryId);\n    this.#recentQueries.delete(queryId);\n    if (!entry) {\n      normalized = mapAST(normalized, this.#clientToServer);\n\n      entry = {\n        normalized,\n        name,\n        args,\n        count: 1,\n        gotCallbacks: gotCallback ? [gotCallback] : [],\n        ttl,\n      };\n      this.#queries.set(queryId, entry);\n      this.#queueQueryChange({\n        op: 'put',\n        hash: queryId,\n        ast: name === undefined ? normalized : undefined,\n        name,\n        args,\n        ttl,\n      });\n    } else {\n      ++entry.count;\n      this.#updateEntry(entry, queryId, ttl);\n\n      if (gotCallback) {\n        entry.gotCallbacks.push(gotCallback);\n      }\n    }\n\n    if (gotCallback) {\n      gotCallback(this.#gotQueries.has(queryId));\n    }\n\n    let removed = false;\n    const cleanupCb = () => {\n      if (removed) {\n        return;\n      }\n      removed = true;\n\n      // We cannot remove queries while mutations are pending\n      // as that could take data out of scope that is needed in a rebase\n      if (this.#mutationTracker.size > 0) {\n        this.#pendingRemovals.push(() =>\n          this.#remove(entry, queryId, gotCallback),\n        );\n        return;\n      }\n\n      this.#remove(entry, queryId, gotCallback);\n    };\n    return cleanupCb;\n  }\n\n  updateCustom({name, args}: CustomQueryID, ttl: TTL) {\n    const queryID = hashOfNameAndArgs(name, args);\n    const entry = must(this.#queries.get(queryID));\n    this.#updateEntry(entry, queryID, ttl);\n  }\n\n  updateLegacy(ast: AST, ttl: TTL) {\n    const normalized = normalizeAST(ast);\n    const queryID = hashOfAST(normalized);\n    const entry = must(this.#queries.get(queryID));\n    this.#updateEntry(entry, queryID, ttl);\n  }\n\n  #updateEntry(entry: Entry, queryID: string, ttl: TTL): void {\n    // If the query already exists and the new ttl is larger than the old one\n    // we send a changeDesiredQueries message to the server to update the ttl.\n    ttl = clampTTL(ttl, this.#lc);\n    if (compareTTL(ttl, entry.ttl) > 0) {\n      entry.ttl = ttl;\n      this.#queueQueryChange({\n        op: 'put',\n        hash: queryID,\n        ast: entry.name === undefined ? entry.normalized : undefined,\n        name: entry.name,\n        args: entry.args,\n        ttl,\n      });\n    }\n  }\n\n  #queueQueryChange(op: UpQueriesPatchOp) {\n    this.#pendingQueryChanges.push(op);\n    this.#scheduleBatch();\n  }\n\n  #scheduleBatch() {\n    if (this.#batchTimer === undefined) {\n      this.#batchTimer = setTimeout(\n        () => this.flushBatch(),\n        this.#queryChangeThrottleMs,\n      );\n    }\n  }\n\n  flushBatch() {\n    if (this.#batchTimer !== undefined) {\n      clearTimeout(this.#batchTimer);\n      this.#batchTimer = undefined;\n    }\n    if (this.#pendingQueryChanges.length > 0) {\n      this.#send([\n        'changeDesiredQueries',\n        {\n          desiredQueriesPatch: [...this.#pendingQueryChanges],\n        },\n      ]);\n      this.#pendingQueryChanges.length = 0;\n    }\n  }\n\n  #remove(entry: Entry, astHash: string, gotCallback: GotCallback | undefined) {\n    if (gotCallback) {\n      const index = entry.gotCallbacks.indexOf(gotCallback);\n      entry.gotCallbacks.splice(index, 1);\n    }\n    --entry.count;\n    if (entry.count === 0) {\n      this.#recentQueries.add(astHash);\n      if (this.#recentQueries.size > this.#recentQueriesMaxSize) {\n        const lruQueryID = this.#recentQueries.values().next().value;\n        assert(lruQueryID, 'Expected LRU query ID to exist');\n        this.#queries.delete(lruQueryID);\n        this.#recentQueries.delete(lruQueryID);\n        this.#queryMetrics.delete(lruQueryID);\n        this.#queueQueryChange({op: 'del', hash: lruQueryID});\n      }\n    }\n  }\n\n  /**\n   * Gets the aggregated metrics for all queries managed by this QueryManager.\n   */\n  get metrics(): ClientMetric {\n    return this.#metrics;\n  }\n\n  addMetric<K extends keyof ClientMetricMap>(\n    metric: K,\n    value: number,\n    ...args: ClientMetricMap[K]\n  ): void {\n    // Only query metrics are tracked at this point.\n    // If this check fails then we need to add a runtime check.\n    metric satisfies `query-${string}`;\n\n    // We track all materializations of queries as well as per\n    // query materializations.\n    this.#metrics[metric].add(value);\n\n    const queryID = args[0];\n\n    // Handle slow query logging for end-to-end materialization\n    if (metric === 'query-materialization-end-to-end') {\n      const ast = args[1];\n\n      if (\n        this.#slowMaterializeThreshold !== undefined &&\n        value > this.#slowMaterializeThreshold\n      ) {\n        this.#lc.warn?.(\n          'Slow query materialization (including server/network)',\n          queryID,\n          ast,\n          value,\n        );\n      } else {\n        this.#lc.debug?.(\n          'Materialized query (including server/network)',\n          queryID,\n          ast,\n          value,\n        );\n      }\n    }\n\n    // The query manager manages metrics that are per query.\n    let existing = this.#queryMetrics.get(queryID);\n    if (!existing) {\n      existing = newMetrics();\n      this.#queryMetrics.set(queryID, existing);\n    }\n    existing[metric].add(value);\n  }\n\n  getQueryMetrics(queryID: string): ClientMetric | undefined {\n    return this.#queryMetrics.get(queryID);\n  }\n\n  /**\n   * For testing only: returns all query hashes currently registered.\n   */\n  getAllNonGotQueryHashes(): Iterable<string> {\n    return difference(this.#queries, this.#gotQueries);\n  }\n}\n\nfunction newMetrics(): ClientMetric {\n  return {\n    'query-materialization-client': new TDigest(),\n    'query-materialization-end-to-end': new TDigest(),\n    'query-update-client': new TDigest(),\n  };\n}\n"],"mappings":"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"}

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

@@ -1,114 +1,93 @@
-import { parse } from "../../../shared/src/valita.js";
+import { parse, valita_exports } 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)
+//#region ../zero-client/src/client/reload-error-handler.ts
+var RELOAD_REASON_STORAGE_KEY = "_zeroReloadReason";
+var RELOAD_BACKOFF_STATE_KEY = "_zeroReloadBackoffState";
+var reloadReasonSchema = valita_exports.tuple([valita_exports.union(updateNeededReasonTypeSchema, errorKindSchema), valita_exports.string()]);
+var backoffStateSchema = valita_exports.object({
+	lastReloadTime: valita_exports.number().default(0),
+	nextIntervalMs: valita_exports.number().default(0)
 });
-const MIN_RELOAD_INTERVAL_MS = 500;
-const MAX_RELOAD_INTERVAL_MS = 6e4;
-const FALLBACK_RELOAD_INTERVAL_MS = 1e4;
-let reloadTimer = null;
+var MAX_RELOAD_INTERVAL_MS = 6e4;
+var FALLBACK_RELOAD_INTERVAL_MS = 1e4;
+var 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);
+	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;
-      }
-    }
-  }
+	if (typeof sessionStorage !== "undefined") {
+		const value = sessionStorage.getItem(RELOAD_REASON_STORAGE_KEY);
+		if (value) {
+			sessionStorage.removeItem(RELOAD_REASON_STORAGE_KEY);
+			try {
+				const [reasonType, message] = parse(JSON.parse(value), reloadReasonSchema);
+				lc.error?.(reasonType, "Zero reloaded the page.", message);
+			} catch (e) {
+				lc.error?.("Zero reloaded the page.", e);
+				return;
+			}
+		}
+	}
 }
+/** If a reload is scheduled, do not attempt to reconnect. */
 function reloadScheduled() {
-  return reloadTimer !== null;
+	return reloadTimer !== null;
 }
+/** Call upon a successful connection, indicating that backoff should be reset. */
 function resetBackoff() {
-  if (typeof sessionStorage !== "undefined") {
-    sessionStorage.removeItem(RELOAD_BACKOFF_STATE_KEY);
-  }
+	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)
-  };
+	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: 500
+		};
+	}
+	const val = sessionStorage.getItem(RELOAD_BACKOFF_STATE_KEY);
+	if (!val) return {
+		lastReloadTime: now,
+		nextIntervalMs: 500
+	};
+	let parsed;
+	try {
+		parsed = parse(JSON.parse(val), backoffStateSchema, "passthrough");
+	} catch (e) {
+		lc.warn?.("ignoring unparsable backoff state", val, e);
+		return {
+			lastReloadTime: now,
+			nextIntervalMs: 500
+		};
+	}
+	const { lastReloadTime, nextIntervalMs } = parsed;
+	if (now - lastReloadTime > 6e4 * 2) return {
+		lastReloadTime: now,
+		nextIntervalMs: 500
+	};
+	if (now < lastReloadTime) return parsed;
+	return {
+		lastReloadTime: Math.max(now, lastReloadTime + nextIntervalMs),
+		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
+//#endregion
+export { reloadScheduled, reloadWithReason, reportReloadReason, resetBackoff };
+
+//# sourceMappingURL=reload-error-handler.js.map

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

@@ -1 +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;"}
+{"version":3,"file":"reload-error-handler.js","names":[],"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"],"mappings":";;;;AAOA,IAAa,4BAA4B;AACzC,IAAa,2BAA2B;AAExC,IAAM,qBAAqB,eAAE,MAAM,CACjC,eAAE,MAAM,8BAA8B,gBAAgB,EACtD,eAAE,QAAQ,CACX,CAAC;AAEF,IAAM,qBAAqB,eAAE,OAAO;CAClC,gBAAgB,eAAE,QAAQ,CAAC,QAAQ,EAAE;CACrC,gBAAgB,eAAE,QAAQ,CAAC,QAAQ,EAAE;CACtC,CAAC;AAKF,IAAa,yBAAyB;AAGtC,IAAa,8BAA8B;AAE3C,IAAI,cAAoD;AAIxD,SAAgB,iBACd,IACA,QACA,QACA,SACA;AACA,KAAI,aAAa;AACf,KAAG,OAAO,iCAAiC;AAC3C;;CAEF,MAAM,MAAM,KAAK,KAAK;CACtB,MAAM,UAAU,YAAY,IAAI,IAAI;AAGpC,KAAI,OAAO,mBAAmB,aAAa;AACzC,iBAAe,QAAQ,0BAA0B,KAAK,UAAU,QAAQ,CAAC;AACzE,iBAAe,QACb,2BACA,KAAK,UAAU,CAAC,QAAQ,QAAQ,CAAC,CAClC;;CAGH,MAAM,QAAQ,QAAQ,iBAAiB;AACvC,IAAG,QACD,QACA,MACA,aACA,QAAQ,IAAI,MAAM,QAAQ,IAAK,YAAY,GAC5C;AACD,eAAc,iBAAiB;AAC7B,gBAAc;AACd,UAAQ;IACP,MAAM;;AAGX,SAAgB,mBAAmB,IAAgB;AACjD,KAAI,OAAO,mBAAmB,aAAa;EACzC,MAAM,QAAQ,eAAe,QAAQ,0BAA0B;AAC/D,MAAI,OAAO;AACT,kBAAe,WAAW,0BAA0B;AACpD,OAAI;IAEF,MAAM,CAAC,YAAY,WAAW,MADf,KAAK,MAAM,MAAM,EACc,mBAAmB;AACjE,OAAG,QAAQ,YAAY,2BAA2B,QAAQ;YACnD,GAAG;AACV,OAAG,QAAQ,2BAA2B,EAAE;AAExC;;;;;;AAOR,SAAgB,kBAAkB;AAChC,QAAO,gBAAgB;;;AAIzB,SAAgB,eAAe;AAC7B,KAAI,OAAO,mBAAmB,YAC5B,gBAAe,WAAW,yBAAyB;;AAIvD,SAAS,YAAY,IAAgB,KAA2B;AAC9D,KAAI,OAAO,mBAAmB,aAAa;AACzC,KAAG,OACD,gDACE,8BAA8B,IAC/B,UACF;AACD,SAAO;GACL,gBAAgB,MAAM;GACtB,gBAAA;GACD;;CAEH,MAAM,MAAM,eAAe,QAAQ,yBAAyB;AAC5D,KAAI,CAAC,IACH,QAAO;EAAC,gBAAgB;EAAK,gBAAA;EAAuC;CAEtE,IAAI;AACJ,KAAI;AACF,WAAS,MAAQ,KAAK,MAAM,IAAI,EAAE,oBAAoB,cAAc;UAC7D,GAAG;AACV,KAAG,OAAO,qCAAqC,KAAK,EAAE;AACtD,SAAO;GAAC,gBAAgB;GAAK,gBAAA;GAAuC;;CAEtE,MAAM,EAAC,gBAAgB,mBAAkB;AAGzC,KAAI,MAAM,iBAAA,MAA0C,EAClD,QAAO;EAAC,gBAAgB;EAAK,gBAAA;EAAuC;AAEtE,KAAI,MAAM,eAER,QAAO;AAGT,QAAO;EACL,gBAFqB,KAAK,IAAI,KAAK,iBAAiB,eAAe;EAGnE,gBAAgB,KAAK,IAAI,iBAAiB,GAAG,uBAAuB;EACrE"}

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

@@ -1,64 +1,35 @@
 import { getBrowserGlobal } from "../../../shared/src/browser-env.js";
+//#region ../zero-client/src/client/server-option.ts
 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;
+	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);
+	if (!getBrowserGlobal("WebSocket")) {
+		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
+//#endregion
+export { getServer };
+
+//# sourceMappingURL=server-option.js.map

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

@@ -1 +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;"}
+{"version":3,"file":"server-option.js","names":[],"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"],"mappings":";;AAGA,SAAS,oBAAoB,WAAmB,QAA4B;CAC1E,MAAM,mBAAmB;CACzB,MAAM,cAAc,OAAe,OACjC,kBAAkB,iBAAiB,2BAA2B,KAAK;AAErE,KACE,CAAC,OAAO,WAAW,GAAG,iBAAiB,KAAK,IAC5C,CAAC,OAAO,WAAW,GAAG,iBAAiB,MAAM,CAE7C,OAAM,IAAI,MACR,eAAe,UAAU,iBAAiB,iBAAiB,QAAQ,iBAAiB,YACrF;CAEH,IAAI;AACJ,KAAI;AACF,QAAM,IAAI,IAAI,OAAO;SACf;AACN,QAAM,IAAI,MACR,eAAe,UAAU,uBAAuB,YAAY,GAC7D;;CAGH,MAAM,YAAY,IAAI,UAAU;CAEhC,MAAM,iBAAiB,IAAI,SAAS,MAAM,IAAI;AAC9C,KAAI,eAAe,OAAO,GACxB,gBAAe,OAAO;AAExB,KAAI,eAAe,eAAe,SAAS,OAAO,GAChD,gBAAe,KAAK;AAEtB,KAAI,eAAe,SAAS,EAC1B,OAAM,IAAI,MACR,eAAe,UAAU,uCAAuC,WAC9D,OACD,GACF;AAGH,MAAK,MAAM,CAAC,UAAU,oBAAoB,CACxC,CAAC,UAAU,IAAI,EACf,CAAC,QAAQ,IAAI,CACd,CACC,KAAI,IAAI,aAAa,UAAU,SAAS,gBAAgB,CACtD,OAAM,IAAI,MACR,eAAe,UAAU,sBAAsB,SAAS,aAAa,YAAY,GAClF;AAIL,QAAO;;AAGT,SAAgB,UACd,QACmB;AAEnB,KAAI,CADO,iBAAiB,YAAY,EAC/B;AAEP,UAAQ,KACN,sEACD;AACD,SAAO;;AAET,KAAI,WAAW,KAAA,KAAa,WAAW,MAAM;AAE3C,UAAQ,KACN,+DACD;AACD,SAAO;;AAET,QAAO,oBAAoB,UAAU,OAAO"}

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

@@ -1,9 +1,27 @@
-const NewClientGroup = "NewClientGroup";
-const VersionNotSupported = "VersionNotSupported";
-const SchemaVersionNotSupported = "SchemaVersionNotSupported";
-export {
-  NewClientGroup,
-  SchemaVersionNotSupported,
-  VersionNotSupported
-};
-//# sourceMappingURL=update-needed-reason-type-enum.js.map
+import { __exportAll } from "../../../_virtual/_rolldown/runtime.js";
+//#region ../zero-client/src/client/update-needed-reason-type-enum.ts
+var update_needed_reason_type_enum_exports = /* @__PURE__ */ __exportAll({
+	NewClientGroup: () => NewClientGroup,
+	SchemaVersionNotSupported: () => SchemaVersionNotSupported,
+	VersionNotSupported: () => VersionNotSupported
+});
+/**
+* There is a new client group due to a another tab loading new code which
+* cannot sync locally with this tab until it updates to the new code. This tab
+* can still sync with the zero-cache.
+*/
+var NewClientGroup = "NewClientGroup";
+/**
+* This client was unable to connect to the zero-cache because it is using a
+* protocol version that the zero-cache does not support.
+*/
+var VersionNotSupported = "VersionNotSupported";
+/**
+* This client was unable to connect to the zero-cache because it is using a
+* schema version (see {@codelink Schema}) that the zero-cache does not support.
+*/
+var SchemaVersionNotSupported = "SchemaVersionNotSupported";
+//#endregion
+export { NewClientGroup, SchemaVersionNotSupported, VersionNotSupported, update_needed_reason_type_enum_exports };
+
+//# sourceMappingURL=update-needed-reason-type-enum.js.map

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

@@ -1 +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;"}
+{"version":3,"file":"update-needed-reason-type-enum.js","names":[],"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"],"mappings":";;;;;;;;;;;;AAKA,IAAa,iBAAiB;;;;;AAO9B,IAAa,sBAAsB;;;;;AAOnC,IAAa,4BAA4B"}

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

@@ -1,5 +1,9 @@
-const version = "0.26.1";
-export {
-  version
-};
-//# sourceMappingURL=version.js.map
+//#region ../zero-client/src/client/version.ts
+/**
+* The current version of Zero.
+*/
+var version = "0.26.2-canary.4";
+//#endregion
+export { version };
+
+//# sourceMappingURL=version.js.map

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

@@ -1 +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;"}
+{"version":3,"file":"version.js","names":[],"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"],"mappings":";;;;AAWA,IAAa,UAAA"}

package/out/zero-client/src/client/zero-poke-handler.d.ts

@@ -22,7 +22,7 @@ type PokeAccumulator = {
  */
 export declare class PokeHandler {
     #private;
-    constructor(replicachePoke: (poke: PokeInternal) => Promise<void>, onPokeError: () => void, clientID: ClientID, schema: Schema, lc: LogContext, mutationTracker: MutationTracker);
+    constructor(replicachePoke: (poke: PokeInternal) => Promise<void>, onPokeError: (error: unknown) => void, clientID: ClientID, schema: Schema, lc: LogContext, mutationTracker: MutationTracker);
     handlePokeStart(pokeStart: PokeStartBody): void;
     handlePokePart(pokePart: PokePartBody): number | undefined;
     handlePokeEnd(pokeEnd: PokeEndBody): void;

package/out/zero-client/src/client/zero-poke-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"zero-poke-handler.d.ts","sourceRoot":"","sources":["../../../../../zero-client/src/client/zero-poke-handler.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,EACV,sBAAsB,EACtB,YAAY,EACb,MAAM,iCAAiC,CAAC;AAEzC,OAAO,KAAK,EAAC,QAAQ,EAAC,MAAM,qCAAqC,CAAC;AAGlE,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,+CAA+C,CAAC;AACjF,OAAO,KAAK,EACV,WAAW,EACX,YAAY,EACZ,aAAa,EACd,MAAM,oCAAoC,CAAC;AAG5C,OAAO,EAEL,KAAK,UAAU,EAChB,MAAM,yCAAyC,CAAC;AACjD,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,mCAAmC,CAAC;AAO9D,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,uBAAuB,CAAC;AAE3D,KAAK,eAAe,GAAG;IACrB,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,YAAY,EAAE,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;CAC/B,CAAC;AAEF;;;;;;;;GAQG;AACH,qBAAa,WAAW;;gBAiBpB,cAAc,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,EACrD,WAAW,EAAE,MAAM,IAAI,EACvB,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,MAAM,EACd,EAAE,EAAE,UAAU,EACd,eAAe,EAAE,eAAe;IAWlC,eAAe,CAAC,SAAS,EAAE,aAAa;IAiBxC,cAAc,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,GAAG,SAAS;IAa1D,aAAa,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IAoBzC,gBAAgB,IAAI,IAAI;CAmFzB;AAED,wBAAgB,UAAU,CACxB,UAAU,EAAE,eAAe,EAAE,EAC7B,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,UAAU,GAExB,CAAC,YAAY,GAAG;IAAC,eAAe,CAAC,EAAE,aAAa,EAAE,GAAG,SAAS,CAAA;CAAC,CAAC,GAChE,SAAS,CAmFZ;AAyBD,wBAAgB,kCAAkC,CAChD,EAAE,EAAE,aAAa,GAChB,sBAAsB,CAcxB"}
+{"version":3,"file":"zero-poke-handler.d.ts","sourceRoot":"","sources":["../../../../../zero-client/src/client/zero-poke-handler.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,EACV,sBAAsB,EACtB,YAAY,EACb,MAAM,iCAAiC,CAAC;AAEzC,OAAO,KAAK,EAAC,QAAQ,EAAC,MAAM,qCAAqC,CAAC;AAGlE,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,+CAA+C,CAAC;AACjF,OAAO,KAAK,EACV,WAAW,EACX,YAAY,EACZ,aAAa,EACd,MAAM,oCAAoC,CAAC;AAG5C,OAAO,EAEL,KAAK,UAAU,EAChB,MAAM,yCAAyC,CAAC;AACjD,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,mCAAmC,CAAC;AAO9D,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,uBAAuB,CAAC;AAE3D,KAAK,eAAe,GAAG;IACrB,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,YAAY,EAAE,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;CAC/B,CAAC;AAEF;;;;;;;;GAQG;AACH,qBAAa,WAAW;;gBAiBpB,cAAc,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,EACrD,WAAW,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,EACrC,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,MAAM,EACd,EAAE,EAAE,UAAU,EACd,eAAe,EAAE,eAAe;IAWlC,eAAe,CAAC,SAAS,EAAE,aAAa;IAiBxC,cAAc,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,GAAG,SAAS;IAa1D,aAAa,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IAoBzC,gBAAgB,IAAI,IAAI;CAmFzB;AAED,wBAAgB,UAAU,CACxB,UAAU,EAAE,eAAe,EAAE,EAC7B,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,UAAU,GAExB,CAAC,YAAY,GAAG;IAAC,eAAe,CAAC,EAAE,aAAa,EAAE,GAAG,SAAS,CAAA;CAAC,CAAC,GAChE,SAAS,CAmFZ;AAyBD,wBAAgB,kCAAkC,CAChD,EAAE,EAAE,aAAa,GAChB,sBAAsB,CAcxB"}