@rocicorp/zero 1.3.0-canary.3 → 1.4.0-canary.0

package/out/zero-cache/src/services/litestream/commands.js.map

@@ -1 +1 @@
-{"version":3,"file":"commands.js","names":[],"sources":["../../../../../../zero-cache/src/services/litestream/commands.ts"],"sourcesContent":["import type {ChildProcess} from 'node:child_process';\nimport {spawn} from 'node:child_process';\nimport {existsSync} from 'node:fs';\nimport type {LogContext, LogLevel} from '@rocicorp/logger';\nimport {resolver} from '@rocicorp/resolver';\nimport {must} from '../../../../shared/src/must.ts';\nimport {sleep} from '../../../../shared/src/sleep.ts';\nimport {Database} from '../../../../zqlite/src/db.ts';\nimport {assertNormalized} from '../../config/normalize.ts';\nimport type {ZeroConfig} from '../../config/zero-config.ts';\nimport {deleteLiteDB} from '../../db/delete-lite-db.ts';\nimport {StatementRunner} from '../../db/statements.ts';\nimport {getShardConfig} from '../../types/shards.ts';\nimport type {Source} from '../../types/streams.ts';\nimport {ChangeStreamerHttpClient} from '../change-streamer/change-streamer-http.ts';\nimport type {\n  SnapshotMessage,\n  SnapshotStatus,\n} from '../change-streamer/snapshot.ts';\nimport {getSubscriptionState} from '../replicator/schema/replication-state.ts';\n\n// Retry for up to 3 minutes (60 times with 3 second delay).\n// Beyond that, let the container runner restart the task.\nconst MAX_RETRIES = 60;\nconst RETRY_INTERVAL_MS = 3000;\n\ntype ReplicaConstraints = {\n  replicaVersion: string;\n  minWatermark: string;\n};\n\nexport class BackupNotFoundException extends Error {\n  static readonly name = 'BackupNotFoundException';\n\n  constructor(backupURL: string | undefined) {\n    super(`backup not found at ${backupURL}`);\n  }\n}\n\n/**\n * @param replicaConstraints The constraints of the restored backup when\n *        restoring for the change-streamer (replication-manager). For the\n *        view-syncer, this should be unspecified so that the constraints are\n *        retrieved from the replication-manager via the snapshot protocol.\n */\nexport async function restoreReplica(\n  lc: LogContext,\n  config: ZeroConfig,\n  replicaConstraints: ReplicaConstraints | null,\n) {\n  for (let i = 0; i < MAX_RETRIES; i++) {\n    if (i > 0) {\n      lc.info?.(\n        `replica not found. retrying in ${RETRY_INTERVAL_MS / 1000} seconds`,\n      );\n      await sleep(RETRY_INTERVAL_MS);\n    }\n    const restored = await tryRestore(lc, config, replicaConstraints);\n    if (restored) {\n      return;\n    }\n    if (replicaConstraints) {\n      // This can happen if the litestream URL is purposefully changed to\n      // force a resync.\n      throw new BackupNotFoundException(config.litestream.backupURL);\n    }\n  }\n  throw new Error(`max attempts exceeded restoring replica`);\n}\n\nfunction getLitestream(\n  mode: 'restore' | 'replicate',\n  config: ZeroConfig,\n  logLevelOverride?: LogLevel,\n  backupURLOverride?: string,\n): {\n  litestream: string;\n  env: NodeJS.ProcessEnv;\n} {\n  const {\n    executable,\n    executableV5,\n    restoreUsingV5,\n    backupURL,\n    logLevel,\n    configPath,\n    endpoint,\n    port = config.port + 2,\n    checkpointThresholdMB,\n    minCheckpointPageCount = checkpointThresholdMB * 250, // SQLite page size is 4KB\n    maxCheckpointPageCount = minCheckpointPageCount * 10,\n    incrementalBackupIntervalMinutes,\n    snapshotBackupIntervalHours,\n    multipartConcurrency,\n    multipartSize,\n  } = config.litestream;\n\n  // Set the snapshot interval to something smaller than x hours so that\n  // the hourly check triggers on the hour, rather than the hour after.\n  const snapshotBackupIntervalMinutes = snapshotBackupIntervalHours * 60 - 5;\n\n  const litestream =\n    // The v0.5.8+ litestream executable can restore from either the new LTX\n    // format or the legacy WAL format, allowing forwards-compatibility /\n    // rollback safety with zero-cache versions that backup to LTX.\n    (mode === 'restore' && restoreUsingV5 ? executableV5 : executable) ??\n    must(executable, `Missing --litestream-executable`);\n  return {\n    litestream,\n    env: {\n      ...process.env,\n      ['ZERO_REPLICA_FILE']: config.replica.file,\n      ['ZERO_LITESTREAM_BACKUP_URL']: must(backupURLOverride ?? backupURL),\n      ['ZERO_LITESTREAM_MIN_CHECKPOINT_PAGE_COUNT']: String(\n        minCheckpointPageCount,\n      ),\n      ['ZERO_LITESTREAM_MAX_CHECKPOINT_PAGE_COUNT']: String(\n        maxCheckpointPageCount,\n      ),\n      ['ZERO_LITESTREAM_INCREMENTAL_BACKUP_INTERVAL_MINUTES']: String(\n        incrementalBackupIntervalMinutes,\n      ),\n      ['ZERO_LITESTREAM_LOG_LEVEL']: logLevelOverride ?? logLevel,\n      ['ZERO_LITESTREAM_SNAPSHOT_BACKUP_INTERVAL_MINUTES']: String(\n        snapshotBackupIntervalMinutes,\n      ),\n      ['ZERO_LITESTREAM_MULTIPART_CONCURRENCY']: String(multipartConcurrency),\n      ['ZERO_LITESTREAM_MULTIPART_SIZE']: String(multipartSize),\n      ['ZERO_LOG_FORMAT']: config.log.format,\n      ['LITESTREAM_CONFIG']: configPath,\n      ['LITESTREAM_PORT']: String(port),\n      ...(endpoint ? {['ZERO_LITESTREAM_ENDPOINT']: endpoint} : {}),\n    },\n  };\n}\n\nasync function tryRestore(\n  lc: LogContext,\n  config: ZeroConfig,\n  replicaConstraints: ReplicaConstraints | null,\n) {\n  let snapshotStatus: SnapshotStatus | undefined;\n  if (!replicaConstraints) {\n    // view-syncers fetch replica constraints from the replication-manager\n    // via the snapshot protocol.\n    snapshotStatus = await reserveAndGetSnapshotStatus(lc, config);\n    lc.info?.(`restoring backup from ${snapshotStatus.backupURL}`);\n    replicaConstraints = snapshotStatus;\n  }\n\n  const {litestream, env} = getLitestream(\n    'restore',\n    config,\n    'debug', // Include all output from `litestream restore`, as it's minimal.\n    snapshotStatus?.backupURL,\n  );\n  const {restoreParallelism: parallelism} = config.litestream;\n  const proc = spawn(\n    litestream,\n    [\n      'restore',\n      '-if-db-not-exists',\n      '-if-replica-exists',\n      '-parallelism',\n      String(parallelism),\n      config.replica.file,\n    ],\n    {env, stdio: 'inherit', windowsHide: true},\n  );\n  const {promise, resolve, reject} = resolver();\n  proc.on('error', reject);\n  proc.on('close', (code, signal) => {\n    if (signal) {\n      reject(`litestream killed with ${signal}`);\n    } else if (code !== 0) {\n      reject(`litestream exited with code ${code}`);\n    } else {\n      resolve();\n    }\n  });\n  await promise;\n  if (!existsSync(config.replica.file)) {\n    return false;\n  }\n  if (!replicaIsValid(lc, config.replica.file, replicaConstraints)) {\n    lc.info?.(`Deleting local replica and retrying restore`);\n    deleteLiteDB(config.replica.file);\n    return false;\n  }\n  return true;\n}\n\nfunction replicaIsValid(\n  lc: LogContext,\n  replica: string,\n  constraints: ReplicaConstraints,\n) {\n  const db = new Database(lc, replica);\n  try {\n    const {replicaVersion, watermark} = getSubscriptionState(\n      new StatementRunner(db),\n    );\n    if (replicaVersion !== constraints.replicaVersion) {\n      lc.warn?.(\n        `Local replica version ${replicaVersion} does not match expected replicaVersion ${constraints.replicaVersion}`,\n        constraints,\n      );\n      return false;\n    }\n    if (watermark < constraints.minWatermark) {\n      lc.warn?.(\n        `Local replica watermark ${watermark} is earlier than minWatermark ${constraints.minWatermark}`,\n      );\n      return false;\n    }\n    lc.info?.(\n      `Local replica at version ${replicaVersion} and watermark ${watermark} is compatible`,\n      constraints,\n    );\n    return true;\n  } catch (e) {\n    lc.error?.('Error while validating restored replica', e);\n    return false;\n  } finally {\n    db.close();\n  }\n}\n\nexport function startReplicaBackupProcess(\n  lc: LogContext,\n  config: ZeroConfig,\n): ChildProcess {\n  const {litestream, env} = getLitestream('replicate', config);\n  lc.info?.(`starting litestream backup to ${config.litestream.backupURL}`);\n  return spawn(litestream, ['replicate'], {\n    env,\n    stdio: 'inherit',\n    windowsHide: true,\n  });\n}\n\nfunction reserveAndGetSnapshotStatus(\n  lc: LogContext,\n  config: ZeroConfig,\n): Promise<SnapshotStatus> {\n  const {promise: status, resolve, reject} = resolver<SnapshotStatus>();\n\n  void (async function () {\n    const abort = new AbortController();\n    process.on('SIGINT', () => abort.abort());\n    process.on('SIGTERM', () => abort.abort());\n\n    for (let i = 0; ; i++) {\n      let err: unknown;\n      try {\n        let resolved = false;\n        const stream = await reserveSnapshot(lc, config);\n        for await (const msg of stream) {\n          // Capture the value of the status message that the change-streamer\n          // (i.e. BackupMonitor) returns, and hold the connection open to\n          // \"reserve\" the snapshot and prevent change log cleanup.\n          resolve(msg[1]);\n          resolved = true;\n        }\n        // The change-streamer itself closes the connection when the\n        // subscription is started (or the reservation retried).\n        if (resolved) {\n          break;\n        }\n      } catch (e) {\n        err = e;\n      }\n      // Retry in the view-syncer since it cannot proceed until it connects\n      // to a (compatible) replication-manager. In particular, a\n      // replication-manager that does not support the view-syncer's\n      // change-streamer protocol will close the stream with an error; this\n      // retry logic essentially delays the startup of a view-syncer until\n      // a compatible replication-manager has been rolled out, allowing\n      // replication-manager and view-syncer services to be updated in\n      // parallel.\n      lc.warn?.(\n        `Unable to reserve snapshot (attempt ${i + 1}). Retrying in 5 seconds.`,\n        String(err),\n      );\n      try {\n        await sleep(5000, abort.signal);\n      } catch (e) {\n        return reject(e);\n      }\n    }\n  })();\n\n  return status;\n}\n\nfunction reserveSnapshot(\n  lc: LogContext,\n  config: ZeroConfig,\n): Promise<Source<SnapshotMessage>> {\n  assertNormalized(config);\n  const {taskID, change, changeStreamer} = config;\n  const shardID = getShardConfig(config);\n\n  const changeStreamerClient = new ChangeStreamerHttpClient(\n    lc,\n    shardID,\n    change.db,\n    changeStreamer.uri,\n  );\n\n  return changeStreamerClient.reserveSnapshot(taskID);\n}\n"],"mappings":"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"}
+{"version":3,"file":"commands.js","names":[],"sources":["../../../../../../zero-cache/src/services/litestream/commands.ts"],"sourcesContent":["import type {ChildProcess} from 'node:child_process';\nimport {spawn} from 'node:child_process';\nimport {existsSync} from 'node:fs';\nimport type {LogContext, LogLevel} from '@rocicorp/logger';\nimport {resolver} from '@rocicorp/resolver';\nimport {must} from '../../../../shared/src/must.ts';\nimport {sleep} from '../../../../shared/src/sleep.ts';\nimport {Database} from '../../../../zqlite/src/db.ts';\nimport {assertNormalized} from '../../config/normalize.ts';\nimport type {ZeroConfig} from '../../config/zero-config.ts';\nimport {deleteLiteDB} from '../../db/delete-lite-db.ts';\nimport {StatementRunner} from '../../db/statements.ts';\nimport {getShardConfig} from '../../types/shards.ts';\nimport type {Source} from '../../types/streams.ts';\nimport {ChangeStreamerHttpClient} from '../change-streamer/change-streamer-http.ts';\nimport type {\n  SnapshotMessage,\n  SnapshotStatus,\n} from '../change-streamer/snapshot.ts';\nimport {getSubscriptionState} from '../replicator/schema/replication-state.ts';\n\n// Retry for up to 3 minutes (60 times with 3 second delay).\n// Beyond that, let the container runner restart the task.\nconst MAX_RETRIES = 60;\nconst RETRY_INTERVAL_MS = 3000;\n\ntype ReplicaConstraints = {\n  replicaVersion: string;\n  minWatermark: string;\n};\n\nexport class BackupNotFoundException extends Error {\n  static readonly name = 'BackupNotFoundException';\n\n  constructor(backupURL: string | undefined) {\n    super(`backup not found at ${backupURL}`);\n  }\n}\n\n/**\n * @param replicaConstraints The constraints of the restored backup when\n *        restoring for the change-streamer (replication-manager). For the\n *        view-syncer, this should be unspecified so that the constraints are\n *        retrieved from the replication-manager via the snapshot protocol.\n */\nexport async function restoreReplica(\n  lc: LogContext,\n  config: ZeroConfig,\n  replicaConstraints: ReplicaConstraints | null,\n) {\n  for (let i = 0; i < MAX_RETRIES; i++) {\n    try {\n      if (await tryRestore(lc, config, replicaConstraints)) {\n        return;\n      }\n    } catch (e) {\n      if (i === 0) {\n        // A restore will fail if the `replicate` process creates a new\n        // snapshot (and compacts old files) at the same time. Snapshots are\n        // infrequent (e.g. once every 12 hours), and the scenario is\n        // recoverable with a retry.\n        lc.warn?.(`initial restore attempt failed. retrying once`, e);\n        continue;\n      }\n      // If it fails again on the retry, though, bail.\n      throw e;\n    }\n    if (replicaConstraints) {\n      // This can happen if the litestream URL is purposefully changed to\n      // force a resync.\n      throw new BackupNotFoundException(config.litestream.backupURL);\n    }\n    lc.info?.(\n      `replica not found. retrying in ${RETRY_INTERVAL_MS / 1000} seconds`,\n    );\n    await sleep(RETRY_INTERVAL_MS);\n  }\n  throw new Error(`max attempts exceeded restoring replica`);\n}\n\nfunction getLitestream(\n  mode: 'restore' | 'replicate',\n  config: ZeroConfig,\n  logLevelOverride?: LogLevel,\n  backupURLOverride?: string,\n): {\n  litestream: string;\n  env: NodeJS.ProcessEnv;\n} {\n  const {\n    executable,\n    executableV5,\n    restoreUsingV5,\n    backupURL,\n    logLevel,\n    configPath,\n    endpoint,\n    port = config.port + 2,\n    checkpointThresholdMB,\n    minCheckpointPageCount = checkpointThresholdMB * 250, // SQLite page size is 4KB\n    maxCheckpointPageCount = minCheckpointPageCount * 10,\n    incrementalBackupIntervalMinutes,\n    snapshotBackupIntervalHours,\n    multipartConcurrency,\n    multipartSize,\n  } = config.litestream;\n\n  // Set the snapshot interval to something smaller than x hours so that\n  // the hourly check triggers on the hour, rather than the hour after.\n  const snapshotBackupIntervalMinutes = snapshotBackupIntervalHours * 60 - 5;\n\n  const litestream =\n    // The v0.5.8+ litestream executable can restore from either the new LTX\n    // format or the legacy WAL format, allowing forwards-compatibility /\n    // rollback safety with zero-cache versions that backup to LTX.\n    (mode === 'restore' && restoreUsingV5 ? executableV5 : executable) ??\n    must(executable, `Missing --litestream-executable`);\n  return {\n    litestream,\n    env: {\n      ...process.env,\n      ['ZERO_REPLICA_FILE']: config.replica.file,\n      ['ZERO_LITESTREAM_BACKUP_URL']: must(backupURLOverride ?? backupURL),\n      ['ZERO_LITESTREAM_MIN_CHECKPOINT_PAGE_COUNT']: String(\n        minCheckpointPageCount,\n      ),\n      ['ZERO_LITESTREAM_MAX_CHECKPOINT_PAGE_COUNT']: String(\n        maxCheckpointPageCount,\n      ),\n      ['ZERO_LITESTREAM_INCREMENTAL_BACKUP_INTERVAL_MINUTES']: String(\n        incrementalBackupIntervalMinutes,\n      ),\n      ['ZERO_LITESTREAM_LOG_LEVEL']: logLevelOverride ?? logLevel,\n      ['ZERO_LITESTREAM_SNAPSHOT_BACKUP_INTERVAL_MINUTES']: String(\n        snapshotBackupIntervalMinutes,\n      ),\n      ['ZERO_LITESTREAM_MULTIPART_CONCURRENCY']: String(multipartConcurrency),\n      ['ZERO_LITESTREAM_MULTIPART_SIZE']: String(multipartSize),\n      ['ZERO_LOG_FORMAT']: config.log.format,\n      ['LITESTREAM_CONFIG']: configPath,\n      ['LITESTREAM_PORT']: String(port),\n      ...(endpoint ? {['ZERO_LITESTREAM_ENDPOINT']: endpoint} : {}),\n    },\n  };\n}\n\nasync function tryRestore(\n  lc: LogContext,\n  config: ZeroConfig,\n  replicaConstraints: ReplicaConstraints | null,\n) {\n  let snapshotStatus: SnapshotStatus | undefined;\n  if (!replicaConstraints) {\n    // view-syncers fetch replica constraints from the replication-manager\n    // via the snapshot protocol.\n    snapshotStatus = await reserveAndGetSnapshotStatus(lc, config);\n    lc.info?.(`restoring backup from ${snapshotStatus.backupURL}`);\n    replicaConstraints = snapshotStatus;\n  }\n\n  const {litestream, env} = getLitestream(\n    'restore',\n    config,\n    'debug', // Include all output from `litestream restore`, as it's minimal.\n    snapshotStatus?.backupURL,\n  );\n  const {restoreParallelism: parallelism} = config.litestream;\n  const proc = spawn(\n    litestream,\n    [\n      'restore',\n      '-if-db-not-exists',\n      '-if-replica-exists',\n      '-parallelism',\n      String(parallelism),\n      config.replica.file,\n    ],\n    {env, stdio: 'inherit', windowsHide: true},\n  );\n  const {promise, resolve, reject} = resolver();\n  proc.on('error', reject);\n  proc.on('close', (code, signal) => {\n    if (signal) {\n      reject(`litestream killed with ${signal}`);\n    } else if (code !== 0) {\n      reject(`litestream exited with code ${code}`);\n    } else {\n      resolve();\n    }\n  });\n  await promise;\n  if (!existsSync(config.replica.file)) {\n    return false;\n  }\n  if (!replicaIsValid(lc, config.replica.file, replicaConstraints)) {\n    lc.info?.(`Deleting local replica and retrying restore`);\n    deleteLiteDB(config.replica.file);\n    return false;\n  }\n  return true;\n}\n\nfunction replicaIsValid(\n  lc: LogContext,\n  replica: string,\n  constraints: ReplicaConstraints,\n) {\n  const db = new Database(lc, replica);\n  try {\n    const {replicaVersion, watermark} = getSubscriptionState(\n      new StatementRunner(db),\n    );\n    if (replicaVersion !== constraints.replicaVersion) {\n      lc.warn?.(\n        `Local replica version ${replicaVersion} does not match expected replicaVersion ${constraints.replicaVersion}`,\n        constraints,\n      );\n      return false;\n    }\n    if (watermark < constraints.minWatermark) {\n      lc.warn?.(\n        `Local replica watermark ${watermark} is earlier than minWatermark ${constraints.minWatermark}`,\n      );\n      return false;\n    }\n    lc.info?.(\n      `Local replica at version ${replicaVersion} and watermark ${watermark} is compatible`,\n      constraints,\n    );\n    return true;\n  } catch (e) {\n    lc.error?.('Error while validating restored replica', e);\n    return false;\n  } finally {\n    db.close();\n  }\n}\n\nexport function startReplicaBackupProcess(\n  lc: LogContext,\n  config: ZeroConfig,\n): ChildProcess {\n  const {litestream, env} = getLitestream('replicate', config);\n  lc.info?.(`starting litestream backup to ${config.litestream.backupURL}`);\n  return spawn(litestream, ['replicate'], {\n    env,\n    stdio: 'inherit',\n    windowsHide: true,\n  });\n}\n\nfunction reserveAndGetSnapshotStatus(\n  lc: LogContext,\n  config: ZeroConfig,\n): Promise<SnapshotStatus> {\n  const {promise: status, resolve, reject} = resolver<SnapshotStatus>();\n\n  void (async function () {\n    const abort = new AbortController();\n    process.on('SIGINT', () => abort.abort());\n    process.on('SIGTERM', () => abort.abort());\n\n    for (let i = 0; ; i++) {\n      let err: unknown;\n      try {\n        let resolved = false;\n        const stream = await reserveSnapshot(lc, config);\n        for await (const msg of stream) {\n          // Capture the value of the status message that the change-streamer\n          // (i.e. BackupMonitor) returns, and hold the connection open to\n          // \"reserve\" the snapshot and prevent change log cleanup.\n          resolve(msg[1]);\n          resolved = true;\n        }\n        // The change-streamer itself closes the connection when the\n        // subscription is started (or the reservation retried).\n        if (resolved) {\n          break;\n        }\n      } catch (e) {\n        err = e;\n      }\n      // Retry in the view-syncer since it cannot proceed until it connects\n      // to a (compatible) replication-manager. In particular, a\n      // replication-manager that does not support the view-syncer's\n      // change-streamer protocol will close the stream with an error; this\n      // retry logic essentially delays the startup of a view-syncer until\n      // a compatible replication-manager has been rolled out, allowing\n      // replication-manager and view-syncer services to be updated in\n      // parallel.\n      lc.warn?.(\n        `Unable to reserve snapshot (attempt ${i + 1}). Retrying in 5 seconds.`,\n        String(err),\n      );\n      try {\n        await sleep(5000, abort.signal);\n      } catch (e) {\n        return reject(e);\n      }\n    }\n  })();\n\n  return status;\n}\n\nfunction reserveSnapshot(\n  lc: LogContext,\n  config: ZeroConfig,\n): Promise<Source<SnapshotMessage>> {\n  assertNormalized(config);\n  const {taskID, change, changeStreamer} = config;\n  const shardID = getShardConfig(config);\n\n  const changeStreamerClient = new ChangeStreamerHttpClient(\n    lc,\n    shardID,\n    change.db,\n    changeStreamer.uri,\n  );\n\n  return changeStreamerClient.reserveSnapshot(taskID);\n}\n"],"mappings":"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"}

package/out/zero-cache/src/services/mutagen/mutagen.js

@@ -6,10 +6,10 @@ import { ProtocolError, isProtocolError } from "../../../../zero-protocol/src/er
 import { CRUD } from "../../../../zero-protocol/src/mutation-type-enum.js";
 import { primaryKeyValueSchema } from "../../../../zero-protocol/src/primary-key.js";
 import "../../../../zero-protocol/src/push.js";
-import { MutationAlreadyProcessedError } from "./error.js";
-import { Database } from "../../../../zqlite/src/db.js";
 import { upstreamSchema } from "../../types/shards.js";
 import "../../config/zero-config.js";
+import { MutationAlreadyProcessedError } from "./error.js";
+import { Database } from "../../../../zqlite/src/db.js";
 import { getOrCreateCounter } from "../../observability/metrics.js";
 import { SERIALIZABLE } from "../../db/mode-enum.js";
 import { runTx } from "../../db/run-transaction.js";

package/out/zero-cache/src/services/statz.js

@@ -1,7 +1,7 @@
 import { BigIntJSON } from "../../../shared/src/bigint-json.js";
-import { Database } from "../../../zqlite/src/db.js";
 import { getShardID, upstreamSchema } from "../types/shards.js";
 import { isAdminPasswordValid } from "../config/zero-config.js";
+import { Database } from "../../../zqlite/src/db.js";
 import { getReplicationState } from "./replicator/schema/replication-state.js";
 import { StatementRunner } from "../db/statements.js";
 import { pgClient } from "../types/pg.js";

package/out/zero-cache/src/services/view-syncer/cvr-store.js

@@ -7,9 +7,9 @@ import { ClientNotFound, Internal, Rehome, SchemaVersionNotSupported } from "../
 import { ZeroCache } from "../../../../zero-protocol/src/error-origin-enum.js";
 import { clientSchemaSchema } from "../../../../zero-protocol/src/client-schema.js";
 import { DEFAULT_TTL_MS, clampTTL } from "../../../../zql/src/query/ttl.js";
+import { cvrSchema } from "../../types/shards.js";
 import { startAsyncSpan } from "../../../../otel/src/span.js";
 import { version } from "../../../../otel/src/version.js";
-import { cvrSchema } from "../../types/shards.js";
 import { rowIDString } from "../../types/row-key.js";
 import { READONLY, READ_COMMITTED } from "../../db/mode-enum.js";
 import { runTx } from "../../db/run-transaction.js";

package/out/zero-cache/src/services/view-syncer/cvr.js

@@ -8,8 +8,8 @@ import { ProtocolError } from "../../../../zero-protocol/src/error.js";
 import { DEFAULT_TTL_MS, clampTTL, compareTTL } from "../../../../zql/src/query/ttl.js";
 import { difference, intersection, union } from "../../../../shared/src/set-utils.js";
 import "../../../../shared/src/bigint-json.js";
-import { startAsyncSpan, startSpan } from "../../../../otel/src/span.js";
 import { upstreamSchema } from "../../types/shards.js";
+import { startAsyncSpan, startSpan } from "../../../../otel/src/span.js";
 import { rowIDString } from "../../types/row-key.js";
 import { CustomKeyMap } from "../../../../shared/src/custom-key-map.js";
 import { recordQuery } from "../../server/anonymous-otel-start.js";

package/out/zero-cache/src/services/view-syncer/inspect-handler.js

@@ -1,7 +1,7 @@
 import { unreachable } from "../../../../shared/src/asserts.js";
 import { must } from "../../../../shared/src/must.js";
-import { Database } from "../../../../zqlite/src/db.js";
 import { getServerVersion, isAdminPasswordValid } from "../../config/zero-config.js";
+import { Database } from "../../../../zqlite/src/db.js";
 import { loadPermissions } from "../../auth/load-permissions.js";
 import { StatementRunner } from "../../db/statements.js";
 import { _usingCtx } from "../../../../_virtual/_@oxc-project_runtime@0.122.0/helpers/usingCtx.js";

package/out/zero-cache/src/services/view-syncer/pipeline-driver.js

@@ -5,8 +5,8 @@ import { skipYields } from "../../../../zql/src/ivm/operator.js";
 import { MeasurePushOperator } from "../../../../zql/src/query/measure-push-operator.js";
 import { buildPipeline } from "../../../../zql/src/builder/builder.js";
 import { makeSourceChangeAdd, makeSourceChangeEdit, makeSourceChangeRemove } from "../../../../zql/src/ivm/source.js";
-import { TableSource } from "../../../../zqlite/src/table-source.js";
 import { Debug, runtimeDebugFlags } from "../../../../zql/src/builder/debug-delegate.js";
+import { TableSource } from "../../../../zqlite/src/table-source.js";
 import { ZERO_VERSION_COLUMN_NAME } from "../replicator/schema/constants.js";
 import { computeZqlSpecs, mustGetTableSpec } from "../../db/lite-tables.js";
 import { resolveSimpleScalarSubqueries } from "../../../../zqlite/src/resolve-scalar-subqueries.js";

package/out/zero-cache/src/services/view-syncer/row-record-cache.js

@@ -1,7 +1,7 @@
 import { promiseVoid } from "../../../../shared/src/resolved-promises.js";
 import { must } from "../../../../shared/src/must.js";
-import { startAsyncSpan } from "../../../../otel/src/span.js";
 import { cvrSchema } from "../../types/shards.js";
+import { startAsyncSpan } from "../../../../otel/src/span.js";
 import { getOrCreateCounter, getOrCreateHistogram } from "../../observability/metrics.js";
 import { rowIDString } from "../../types/row-key.js";
 import "../../types/pg.js";

package/out/zero-cache/src/types/websocket-handoff.js

@@ -2,8 +2,8 @@ import { assert } from "../../../shared/src/asserts.js";
 import "./processes.js";
 import { serializableSubset } from "./http.js";
 import { PROTOCOL_ERROR, closeWithError } from "./ws.js";
-import { Server } from "node:http";
 import { WebSocketServer } from "ws";
+import { Server } from "node:http";
 //#region ../zero-cache/src/types/websocket-handoff.ts
 /**
 * Installs websocket handoff logic from either an http.Server

package/out/zero-cache/src/workers/syncer.js

@@ -14,8 +14,8 @@ import { DrainCoordinator } from "../services/view-syncer/drain-coordinator.js";
 import { Connection, sendError } from "./connection.js";
 import { SyncerWsMessageHandler } from "./syncer-ws-message-handler.js";
 import { resolver } from "@rocicorp/resolver";
-import { pid } from "node:process";
 import { WebSocketServer } from "ws";
+import { pid } from "node:process";
 //#region ../zero-cache/src/workers/syncer.ts
 function getWebSocketServerOptions(config) {
 	const options = {

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

@@ -1,4 +1,6 @@
+import type { ReadonlyJSONValue } from '../../../../shared/src/json.ts';
 import type { AnalyzeQueryResult, PlanDebugEventJSON } from '../../../../zero-protocol/src/analyze-query-result.ts';
+import type { AST } from '../../../../zero-protocol/src/ast.ts';
 import type { AnalyzeQueryOptions } from '../../../../zero-protocol/src/inspect-up.ts';
 import type { QueryDelegate } from '../../../../zql/src/query/query-delegate.ts';
 import type { AnyQuery } from '../../../../zql/src/query/query.ts';
@@ -17,6 +19,28 @@ export declare class Inspector {
     clientsWithQueries(): Promise<Client[]>;
     serverVersion(): Promise<string>;
     analyzeQuery(query: AnyQuery, options?: AnalyzeQueryOptions): Promise<AnalyzeQueryResult>;
+    /**
+     * Analyze a query specified by a server-side AST. Unlike {@link analyzeQuery}
+     * the AST is sent to the server verbatim with no client-to-server name
+     * mapping; callers should provide an AST already in the server shape.
+     */
+    analyzeServerAST(ast: AST, options?: AnalyzeQueryOptions): Promise<AnalyzeQueryResult>;
+    /**
+     * Analyze a server-registered named (custom) query. The server resolves
+     * the name and args to an AST using its registered custom-query handler.
+     */
+    analyzeNamedQuery(name: string, args: ReadonlyArray<ReadonlyJSONValue>, options?: AnalyzeQueryOptions): Promise<AnalyzeQueryResult>;
+    /**
+     * Authenticate with the server's admin password. Other inspector RPCs
+     * (e.g. {@link analyzeQuery}) fall back to an interactive HTML password
+     * prompt when authentication is needed, which is unavailable in non-DOM
+     * environments. Call this first from Node contexts to establish the
+     * session.
+     *
+     * Returns `true` if the password is accepted (or the server runs in a
+     * development mode that bypasses the check), `false` otherwise.
+     */
+    authenticate(password: string): Promise<boolean>;
     /**
      * Format planner debug events as a human-readable string.
      */

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

@@ -1 +1 @@
-{"version":3,"file":"inspector.d.ts","sourceRoot":"","sources":["../../../../../../zero-client/src/client/inspector/inspector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,kBAAkB,EACnB,MAAM,uDAAuD,CAAC;AAC/D,OAAO,KAAK,EAAC,mBAAmB,EAAC,MAAM,6CAA6C,CAAC;AAErF,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,6CAA6C,CAAC;AAC/E,OAAO,KAAK,EAAC,QAAQ,EAAC,MAAM,oCAAoC,CAAC;AACjE,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAC,MAAM,EAAC,MAAM,aAAa,CAAC;AACnC,OAAO,KAAK,EAEV,iBAAiB,EACjB,OAAO,EACP,GAAG,EACJ,MAAM,qBAAqB,CAAC;AAE7B,YAAY,EAAC,iBAAiB,EAAC,CAAC;AAGhC,MAAM,MAAM,IAAI,GAAG,cAAc,qBAAqB,CAAC,CAAC;AAExD,qBAAa,SAAS;;IAEpB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;gBAGhC,GAAG,EAAE,GAAG,EACR,iBAAiB,EAAE,iBAAiB,EACpC,aAAa,EAAE,aAAa,EAC5B,SAAS,EAAE,MAAM,OAAO,CAAC,SAAS,CAAC;IAqB/B,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC;IAI3B,OAAO,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAI5B,kBAAkB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAMvC,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC;IAIhC,YAAY,CAChB,KAAK,EAAE,QAAQ,EACf,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,kBAAkB,CAAC;IAQ9B;;OAEG;IACH,mBAAmB,CAAC,MAAM,EAAE,kBAAkB,EAAE,GAAG,MAAM;CAG1D"}
+{"version":3,"file":"inspector.d.ts","sourceRoot":"","sources":["../../../../../../zero-client/src/client/inspector/inspector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,gCAAgC,CAAC;AACtE,OAAO,KAAK,EACV,kBAAkB,EAClB,kBAAkB,EACnB,MAAM,uDAAuD,CAAC;AAC/D,OAAO,KAAK,EAAC,GAAG,EAAC,MAAM,sCAAsC,CAAC;AAC9D,OAAO,KAAK,EAAC,mBAAmB,EAAC,MAAM,6CAA6C,CAAC;AAErF,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,6CAA6C,CAAC;AAC/E,OAAO,KAAK,EAAC,QAAQ,EAAC,MAAM,oCAAoC,CAAC;AACjE,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAC,MAAM,EAAC,MAAM,aAAa,CAAC;AACnC,OAAO,KAAK,EAEV,iBAAiB,EACjB,OAAO,EACP,GAAG,EACJ,MAAM,qBAAqB,CAAC;AAE7B,YAAY,EAAC,iBAAiB,EAAC,CAAC;AAGhC,MAAM,MAAM,IAAI,GAAG,cAAc,qBAAqB,CAAC,CAAC;AAExD,qBAAa,SAAS;;IAEpB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;gBAGhC,GAAG,EAAE,GAAG,EACR,iBAAiB,EAAE,iBAAiB,EACpC,aAAa,EAAE,aAAa,EAC5B,SAAS,EAAE,MAAM,OAAO,CAAC,SAAS,CAAC;IAqB/B,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC;IAI3B,OAAO,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAI5B,kBAAkB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAMvC,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC;IAIhC,YAAY,CAChB,KAAK,EAAE,QAAQ,EACf,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,kBAAkB,CAAC;IAQ9B;;;;OAIG;IACG,gBAAgB,CACpB,GAAG,EAAE,GAAG,EACR,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,kBAAkB,CAAC;IAQ9B;;;OAGG;IACG,iBAAiB,CACrB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,aAAa,CAAC,iBAAiB,CAAC,EACtC,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,kBAAkB,CAAC;IAS9B;;;;;;;;;OASG;IACG,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAItD;;OAEG;IACH,mBAAmB,CAAC,MAAM,EAAE,kBAAkB,EAAE,GAAG,MAAM;CAG1D"}

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

@@ -37,6 +37,34 @@ var Inspector = class {
 		return (await this.#delegate.lazy).analyzeQuery(this.#delegate, query, options);
 	}
 	/**
+	* Analyze a query specified by a server-side AST. Unlike {@link analyzeQuery}
+	* the AST is sent to the server verbatim with no client-to-server name
+	* mapping; callers should provide an AST already in the server shape.
+	*/
+	async analyzeServerAST(ast, options) {
+		return (await this.#delegate.lazy).analyzeServerAST(this.#delegate, ast, options);
+	}
+	/**
+	* Analyze a server-registered named (custom) query. The server resolves
+	* the name and args to an AST using its registered custom-query handler.
+	*/
+	async analyzeNamedQuery(name, args, options) {
+		return (await this.#delegate.lazy).analyzeNamedQuery(this.#delegate, name, args, options);
+	}
+	/**
+	* Authenticate with the server's admin password. Other inspector RPCs
+	* (e.g. {@link analyzeQuery}) fall back to an interactive HTML password
+	* prompt when authentication is needed, which is unavailable in non-DOM
+	* environments. Call this first from Node contexts to establish the
+	* session.
+	*
+	* Returns `true` if the password is accepted (or the server runs in a
+	* development mode that bypasses the check), `false` otherwise.
+	*/
+	async authenticate(password) {
+		return (await this.#delegate.lazy).authenticate(this.#delegate, password);
+	}
+	/**
 	* Format planner debug events as a human-readable string.
 	*/
 	formatPlannerEvents(events) {

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

@@ -1 +1 @@
-{"version":3,"file":"inspector.js","names":["#delegate"],"sources":["../../../../../../zero-client/src/client/inspector/inspector.ts"],"sourcesContent":["import type {\n  AnalyzeQueryResult,\n  PlanDebugEventJSON,\n} from '../../../../zero-protocol/src/analyze-query-result.ts';\nimport type {AnalyzeQueryOptions} from '../../../../zero-protocol/src/inspect-up.ts';\nimport {formatPlannerEvents} from '../../../../zql/src/planner/planner-debug.ts';\nimport type {QueryDelegate} from '../../../../zql/src/query/query-delegate.ts';\nimport type {AnyQuery} from '../../../../zql/src/query/query.ts';\nimport type {ClientGroup} from './client-group.ts';\nimport {Client} from './client.ts';\nimport type {\n  ExtendedInspectorDelegate,\n  InspectorDelegate,\n  Metrics,\n  Rep,\n} from './lazy-inspector.ts';\n\nexport type {InspectorDelegate};\n\n// oxlint-disable-next-line consistent-type-imports\nexport type Lazy = typeof import('./lazy-inspector.ts');\n\nexport class Inspector {\n  readonly #delegate: ExtendedInspectorDelegate;\n  readonly client: Client;\n  readonly clientGroup: ClientGroup;\n\n  constructor(\n    rep: Rep,\n    inspectorDelegate: InspectorDelegate,\n    queryDelegate: QueryDelegate,\n    getSocket: () => Promise<WebSocket>,\n  ) {\n    this.#delegate = {\n      getQueryMetrics:\n        inspectorDelegate.getQueryMetrics.bind(inspectorDelegate),\n      getAST: inspectorDelegate.getAST.bind(inspectorDelegate),\n      mapClientASTToServer:\n        inspectorDelegate.mapClientASTToServer.bind(inspectorDelegate),\n      get metrics() {\n        return inspectorDelegate.metrics;\n      },\n      queryDelegate,\n      rep,\n      getSocket,\n      lazy: import('./lazy-inspector.ts'),\n    };\n\n    this.client = new Client(this.#delegate, rep.clientID, rep.clientGroupID);\n    this.clientGroup = this.client.clientGroup;\n  }\n\n  async metrics(): Promise<Metrics> {\n    return (await this.#delegate.lazy).inspectorMetrics(this.#delegate);\n  }\n\n  async clients(): Promise<Client[]> {\n    return (await this.#delegate.lazy).inspectorClients(this.#delegate);\n  }\n\n  async clientsWithQueries(): Promise<Client[]> {\n    return (await this.#delegate.lazy).inspectorClientsWithQueries(\n      this.#delegate,\n    );\n  }\n\n  async serverVersion(): Promise<string> {\n    return (await this.#delegate.lazy).serverVersion(this.#delegate);\n  }\n\n  async analyzeQuery(\n    query: AnyQuery,\n    options?: AnalyzeQueryOptions,\n  ): Promise<AnalyzeQueryResult> {\n    return (await this.#delegate.lazy).analyzeQuery(\n      this.#delegate,\n      query,\n      options,\n    );\n  }\n\n  /**\n   * Format planner debug events as a human-readable string.\n   */\n  formatPlannerEvents(events: PlanDebugEventJSON[]): string {\n    return formatPlannerEvents(events);\n  }\n}\n"],"mappings":";;;AAsBA,IAAa,YAAb,MAAuB;CACrB;CACA;CACA;CAEA,YACE,KACA,mBACA,eACA,WACA;AACA,QAAA,WAAiB;GACf,iBACE,kBAAkB,gBAAgB,KAAK,kBAAkB;GAC3D,QAAQ,kBAAkB,OAAO,KAAK,kBAAkB;GACxD,sBACE,kBAAkB,qBAAqB,KAAK,kBAAkB;GAChE,IAAI,UAAU;AACZ,WAAO,kBAAkB;;GAE3B;GACA;GACA;GACA,MAAM,OAAO;GACd;AAED,OAAK,SAAS,IAAI,OAAO,MAAA,UAAgB,IAAI,UAAU,IAAI,cAAc;AACzE,OAAK,cAAc,KAAK,OAAO;;CAGjC,MAAM,UAA4B;AAChC,UAAQ,MAAM,MAAA,SAAe,MAAM,iBAAiB,MAAA,SAAe;;CAGrE,MAAM,UAA6B;AACjC,UAAQ,MAAM,MAAA,SAAe,MAAM,iBAAiB,MAAA,SAAe;;CAGrE,MAAM,qBAAwC;AAC5C,UAAQ,MAAM,MAAA,SAAe,MAAM,4BACjC,MAAA,SACD;;CAGH,MAAM,gBAAiC;AACrC,UAAQ,MAAM,MAAA,SAAe,MAAM,cAAc,MAAA,SAAe;;CAGlE,MAAM,aACJ,OACA,SAC6B;AAC7B,UAAQ,MAAM,MAAA,SAAe,MAAM,aACjC,MAAA,UACA,OACA,QACD;;;;;CAMH,oBAAoB,QAAsC;AACxD,SAAO,oBAAoB,OAAO"}
+{"version":3,"file":"inspector.js","names":["#delegate"],"sources":["../../../../../../zero-client/src/client/inspector/inspector.ts"],"sourcesContent":["import type {ReadonlyJSONValue} from '../../../../shared/src/json.ts';\nimport type {\n  AnalyzeQueryResult,\n  PlanDebugEventJSON,\n} from '../../../../zero-protocol/src/analyze-query-result.ts';\nimport type {AST} from '../../../../zero-protocol/src/ast.ts';\nimport type {AnalyzeQueryOptions} from '../../../../zero-protocol/src/inspect-up.ts';\nimport {formatPlannerEvents} from '../../../../zql/src/planner/planner-debug.ts';\nimport type {QueryDelegate} from '../../../../zql/src/query/query-delegate.ts';\nimport type {AnyQuery} from '../../../../zql/src/query/query.ts';\nimport type {ClientGroup} from './client-group.ts';\nimport {Client} from './client.ts';\nimport type {\n  ExtendedInspectorDelegate,\n  InspectorDelegate,\n  Metrics,\n  Rep,\n} from './lazy-inspector.ts';\n\nexport type {InspectorDelegate};\n\n// oxlint-disable-next-line consistent-type-imports\nexport type Lazy = typeof import('./lazy-inspector.ts');\n\nexport class Inspector {\n  readonly #delegate: ExtendedInspectorDelegate;\n  readonly client: Client;\n  readonly clientGroup: ClientGroup;\n\n  constructor(\n    rep: Rep,\n    inspectorDelegate: InspectorDelegate,\n    queryDelegate: QueryDelegate,\n    getSocket: () => Promise<WebSocket>,\n  ) {\n    this.#delegate = {\n      getQueryMetrics:\n        inspectorDelegate.getQueryMetrics.bind(inspectorDelegate),\n      getAST: inspectorDelegate.getAST.bind(inspectorDelegate),\n      mapClientASTToServer:\n        inspectorDelegate.mapClientASTToServer.bind(inspectorDelegate),\n      get metrics() {\n        return inspectorDelegate.metrics;\n      },\n      queryDelegate,\n      rep,\n      getSocket,\n      lazy: import('./lazy-inspector.ts'),\n    };\n\n    this.client = new Client(this.#delegate, rep.clientID, rep.clientGroupID);\n    this.clientGroup = this.client.clientGroup;\n  }\n\n  async metrics(): Promise<Metrics> {\n    return (await this.#delegate.lazy).inspectorMetrics(this.#delegate);\n  }\n\n  async clients(): Promise<Client[]> {\n    return (await this.#delegate.lazy).inspectorClients(this.#delegate);\n  }\n\n  async clientsWithQueries(): Promise<Client[]> {\n    return (await this.#delegate.lazy).inspectorClientsWithQueries(\n      this.#delegate,\n    );\n  }\n\n  async serverVersion(): Promise<string> {\n    return (await this.#delegate.lazy).serverVersion(this.#delegate);\n  }\n\n  async analyzeQuery(\n    query: AnyQuery,\n    options?: AnalyzeQueryOptions,\n  ): Promise<AnalyzeQueryResult> {\n    return (await this.#delegate.lazy).analyzeQuery(\n      this.#delegate,\n      query,\n      options,\n    );\n  }\n\n  /**\n   * Analyze a query specified by a server-side AST. Unlike {@link analyzeQuery}\n   * the AST is sent to the server verbatim with no client-to-server name\n   * mapping; callers should provide an AST already in the server shape.\n   */\n  async analyzeServerAST(\n    ast: AST,\n    options?: AnalyzeQueryOptions,\n  ): Promise<AnalyzeQueryResult> {\n    return (await this.#delegate.lazy).analyzeServerAST(\n      this.#delegate,\n      ast,\n      options,\n    );\n  }\n\n  /**\n   * Analyze a server-registered named (custom) query. The server resolves\n   * the name and args to an AST using its registered custom-query handler.\n   */\n  async analyzeNamedQuery(\n    name: string,\n    args: ReadonlyArray<ReadonlyJSONValue>,\n    options?: AnalyzeQueryOptions,\n  ): Promise<AnalyzeQueryResult> {\n    return (await this.#delegate.lazy).analyzeNamedQuery(\n      this.#delegate,\n      name,\n      args,\n      options,\n    );\n  }\n\n  /**\n   * Authenticate with the server's admin password. Other inspector RPCs\n   * (e.g. {@link analyzeQuery}) fall back to an interactive HTML password\n   * prompt when authentication is needed, which is unavailable in non-DOM\n   * environments. Call this first from Node contexts to establish the\n   * session.\n   *\n   * Returns `true` if the password is accepted (or the server runs in a\n   * development mode that bypasses the check), `false` otherwise.\n   */\n  async authenticate(password: string): Promise<boolean> {\n    return (await this.#delegate.lazy).authenticate(this.#delegate, password);\n  }\n\n  /**\n   * Format planner debug events as a human-readable string.\n   */\n  formatPlannerEvents(events: PlanDebugEventJSON[]): string {\n    return formatPlannerEvents(events);\n  }\n}\n"],"mappings":";;;AAwBA,IAAa,YAAb,MAAuB;CACrB;CACA;CACA;CAEA,YACE,KACA,mBACA,eACA,WACA;AACA,QAAA,WAAiB;GACf,iBACE,kBAAkB,gBAAgB,KAAK,kBAAkB;GAC3D,QAAQ,kBAAkB,OAAO,KAAK,kBAAkB;GACxD,sBACE,kBAAkB,qBAAqB,KAAK,kBAAkB;GAChE,IAAI,UAAU;AACZ,WAAO,kBAAkB;;GAE3B;GACA;GACA;GACA,MAAM,OAAO;GACd;AAED,OAAK,SAAS,IAAI,OAAO,MAAA,UAAgB,IAAI,UAAU,IAAI,cAAc;AACzE,OAAK,cAAc,KAAK,OAAO;;CAGjC,MAAM,UAA4B;AAChC,UAAQ,MAAM,MAAA,SAAe,MAAM,iBAAiB,MAAA,SAAe;;CAGrE,MAAM,UAA6B;AACjC,UAAQ,MAAM,MAAA,SAAe,MAAM,iBAAiB,MAAA,SAAe;;CAGrE,MAAM,qBAAwC;AAC5C,UAAQ,MAAM,MAAA,SAAe,MAAM,4BACjC,MAAA,SACD;;CAGH,MAAM,gBAAiC;AACrC,UAAQ,MAAM,MAAA,SAAe,MAAM,cAAc,MAAA,SAAe;;CAGlE,MAAM,aACJ,OACA,SAC6B;AAC7B,UAAQ,MAAM,MAAA,SAAe,MAAM,aACjC,MAAA,UACA,OACA,QACD;;;;;;;CAQH,MAAM,iBACJ,KACA,SAC6B;AAC7B,UAAQ,MAAM,MAAA,SAAe,MAAM,iBACjC,MAAA,UACA,KACA,QACD;;;;;;CAOH,MAAM,kBACJ,MACA,MACA,SAC6B;AAC7B,UAAQ,MAAM,MAAA,SAAe,MAAM,kBACjC,MAAA,UACA,MACA,MACA,QACD;;;;;;;;;;;;CAaH,MAAM,aAAa,UAAoC;AACrD,UAAQ,MAAM,MAAA,SAAe,MAAM,aAAa,MAAA,UAAgB,SAAS;;;;;CAM3E,oBAAoB,QAAsC;AACxD,SAAO,oBAAoB,OAAO"}

package/out/zero-client/src/client/inspector/lazy-inspector.d.ts

@@ -32,6 +32,15 @@ export declare function clientRows(delegate: ExtendedInspectorDelegate, clientID
 export declare function serverVersion(delegate: ExtendedInspectorDelegate): Promise<string>;
 export declare function clientQueries(delegate: ExtendedInspectorDelegate, clientID: string): Promise<Query[]>;
 export declare function analyzeQuery(delegate: ExtendedInspectorDelegate, query: AnyQuery, options?: AnalyzeQueryOptions): Promise<AnalyzeQueryResult>;
+export declare function analyzeServerAST(delegate: ExtendedInspectorDelegate, ast: AST, options?: AnalyzeQueryOptions): Promise<AnalyzeQueryResult>;
+export declare function analyzeNamedQuery(delegate: ExtendedInspectorDelegate, name: string, args: ReadonlyArray<ReadonlyJSONValue>, options?: AnalyzeQueryOptions): Promise<AnalyzeQueryResult>;
+/**
+ * Sends an `authenticate` op to the server. Returns `true` if the password
+ * is accepted (or the server is in a development mode that bypasses the
+ * check). Use this from Node contexts where the default interactive HTML
+ * prompt used by other inspector RPCs is not available.
+ */
+export declare function authenticate(delegate: ExtendedInspectorDelegate, password: string): Promise<boolean>;
 export interface InspectorDelegate {
     getQueryMetrics(hash: string): ClientMetrics | undefined;
     getAST(queryID: string): AST | undefined;

package/out/zero-client/src/client/inspector/lazy-inspector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lazy-inspector.d.ts","sourceRoot":"","sources":["../../../../../../zero-client/src/client/inspector/lazy-inspector.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"lazy-inspector.d.ts","sourceRoot":"","sources":["../../../../../../zero-client/src/client/inspector/lazy-inspector.ts"],"names":[],"mappings":"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"}

package/out/zero-client/src/client/inspector/lazy-inspector.js

@@ -176,8 +176,35 @@ async function analyzeQuery(delegate, query, options) {
 		options
 	}, inspectAnalyzeQueryDownSchema);
 }
+async function analyzeServerAST(delegate, ast, options) {
+	return rpc(await delegate.getSocket(), {
+		op: "analyze-query",
+		ast,
+		options
+	}, inspectAnalyzeQueryDownSchema);
+}
+async function analyzeNamedQuery(delegate, name, args, options) {
+	return rpc(await delegate.getSocket(), {
+		op: "analyze-query",
+		name,
+		args,
+		options
+	}, inspectAnalyzeQueryDownSchema);
+}
+/**
+* Sends an `authenticate` op to the server. Returns `true` if the password
+* is accepted (or the server is in a development mode that bypasses the
+* check). Use this from Node contexts where the default interactive HTML
+* prompt used by other inspector RPCs is not available.
+*/
+async function authenticate(delegate, password) {
+	return rpc(await delegate.getSocket(), {
+		op: "authenticate",
+		value: password
+	}, inspectAuthenticatedDownSchema);
+}
 var UnauthenticatedError = class extends Error {};
 //#endregion
-export { analyzeQuery, clientGroupClients, clientGroupClientsWithQueries, clientGroupQueries, clientMap, clientQueries, clientRows, inspectorClients, inspectorClientsWithQueries, inspectorMetrics, mergeMetrics, rpc, serverVersion };
+export { analyzeNamedQuery, analyzeQuery, analyzeServerAST, authenticate, clientGroupClients, clientGroupClientsWithQueries, clientGroupQueries, clientMap, clientQueries, clientRows, inspectorClients, inspectorClientsWithQueries, inspectorMetrics, mergeMetrics, rpc, serverVersion };
 
 //# sourceMappingURL=lazy-inspector.js.map

package/out/zero-client/src/client/inspector/lazy-inspector.js.map

@@ -1 +1 @@
-{"version":3,"file":"lazy-inspector.js","names":[],"sources":["../../../../../../zero-client/src/client/inspector/lazy-inspector.ts"],"sourcesContent":["import type {BTreeRead} from '../../../../replicache/src/btree/read.ts';\nimport type {Read} from '../../../../replicache/src/dag/store.ts';\nimport {readFromHash} from '../../../../replicache/src/db/read.ts';\nimport * as FormatVersion from '../../../../replicache/src/format-version-enum.ts';\nimport {getClientGroup} from '../../../../replicache/src/persist/client-groups.ts';\nimport {\n  getClient,\n  getClients,\n  type ClientMap,\n} from '../../../../replicache/src/persist/clients.ts';\nimport type {ReplicacheImpl} from '../../../../replicache/src/replicache-impl.ts';\nimport {withRead} from '../../../../replicache/src/with-transactions.ts';\nimport {assert} from '../../../../shared/src/asserts.ts';\nimport type {ReadonlyJSONValue} from '../../../../shared/src/json.ts';\nimport {mapValues} from '../../../../shared/src/objects.ts';\nimport {TDigest, type ReadonlyTDigest} from '../../../../shared/src/tdigest.ts';\nimport * as valita from '../../../../shared/src/valita.ts';\nimport type {AnalyzeQueryResult} from '../../../../zero-protocol/src/analyze-query-result.ts';\nimport type {AST} from '../../../../zero-protocol/src/ast.ts';\nimport type {Row} from '../../../../zero-protocol/src/data.ts';\nimport {\n  inspectAnalyzeQueryDownSchema,\n  inspectAuthenticatedDownSchema,\n  inspectMetricsDownSchema,\n  inspectQueriesDownSchema,\n  inspectVersionDownSchema,\n  type InspectDownBody,\n  type InspectQueryRow,\n  type ServerMetrics as ServerMetricsJSON,\n} from '../../../../zero-protocol/src/inspect-down.ts';\nimport type {\n  AnalyzeQueryOptions,\n  InspectUpBody,\n} from '../../../../zero-protocol/src/inspect-up.ts';\nimport type {\n  ClientMetricMap,\n  ServerMetricMap,\n} from '../../../../zql/src/query/metrics-delegate.ts';\nimport type {QueryDelegate} from '../../../../zql/src/query/query-delegate.ts';\nimport {asQueryInternals} from '../../../../zql/src/query/query-internals.ts';\nimport type {AnyQuery} from '../../../../zql/src/query/query.ts';\nimport {nanoid} from '../../util/nanoid.ts';\nimport {ENTITIES_KEY_PREFIX} from '../keys.ts';\nimport type {MutatorDefs} from '../replicache-types.ts';\nimport {Client} from './client.ts';\nimport {createHTMLPasswordPrompt} from './html-dialog-prompt.ts';\nimport {type Lazy} from './inspector.ts';\nimport {Query} from './query.ts';\n\nexport type GetWebSocket = () => Promise<WebSocket>;\n\nexport type Metrics = {\n  readonly [K in keyof (ClientMetricMap & ServerMetricMap)]: ReadonlyTDigest;\n};\n\ntype DistributiveOmit<T, K extends string> = T extends object\n  ? Omit<T, K>\n  : never;\n\nexport async function rpc<T extends InspectDownBody>(\n  socket: WebSocket,\n  arg: DistributiveOmit<InspectUpBody, 'id'>,\n  downSchema: valita.Type<T>,\n): Promise<T['value']> {\n  try {\n    return await rpcNoAuthTry(socket, arg, downSchema);\n  } catch (e) {\n    if (e instanceof UnauthenticatedError) {\n      const password = await createHTMLPasswordPrompt('Enter password:');\n      if (password) {\n        // Do authenticate rpc\n        const authRes = await rpcNoAuthTry(\n          socket,\n          {op: 'authenticate', value: password},\n          inspectAuthenticatedDownSchema,\n        );\n        if (authRes) {\n          // If authentication is successful, retry the original RPC\n          return rpcNoAuthTry(socket, arg, downSchema);\n        }\n      }\n      throw new Error('Authentication failed');\n    }\n    throw e;\n  }\n}\n\nfunction rpcNoAuthTry<T extends InspectDownBody>(\n  socket: WebSocket,\n  arg: DistributiveOmit<InspectUpBody, 'id'>,\n  downSchema: valita.Type<T>,\n): Promise<T['value']> {\n  return new Promise((resolve, reject) => {\n    const id = nanoid();\n    const f = (ev: MessageEvent) => {\n      const msg = JSON.parse(ev.data);\n      if (msg[0] === 'inspect') {\n        const body = msg[1];\n        if (body.id !== id) {\n          return;\n        }\n        const res = valita.test(body, downSchema);\n        if (res.ok) {\n          if (res.value.op === 'error') {\n            reject(new Error(res.value.value));\n          } else {\n            resolve(res.value.value);\n          }\n        } else {\n          // Check if we got un authenticated/false response\n          const authRes = valita.test(body, inspectAuthenticatedDownSchema);\n          if (authRes.ok) {\n            // Handle authenticated response\n            assert(\n              authRes.value.value === false,\n              'Expected unauthenticated response',\n            );\n            reject(new UnauthenticatedError());\n          }\n\n          reject(res.error);\n        }\n        socket.removeEventListener('message', f);\n      }\n    };\n    socket.addEventListener('message', f);\n    socket.send(JSON.stringify(['inspect', {...arg, id}]));\n  });\n} // T extends forces T to be resolved\n\nexport function mergeMetrics(\n  clientMetrics: ClientMetrics | undefined,\n  serverMetrics: ServerMetricsJSON | null | undefined,\n): ClientMetrics & ServerMetrics {\n  return {\n    ...(clientMetrics ?? newClientMetrics()),\n    ...(serverMetrics\n      ? convertServerMetrics(serverMetrics)\n      : newServerMetrics()),\n  };\n}\n\nfunction newClientMetrics(): ClientMetrics {\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\nfunction newServerMetrics(): ServerMetrics {\n  return {\n    'query-materialization-server': new TDigest(),\n    'query-update-server': new TDigest(),\n  };\n}\n\nfunction convertServerMetrics(metrics: ServerMetricsJSON): ServerMetrics {\n  return mapValues(metrics, v => TDigest.fromJSON(v));\n}\n\nexport async function inspectorMetrics(\n  delegate: ExtendedInspectorDelegate,\n): Promise<Metrics> {\n  const clientMetrics = delegate.metrics;\n  const serverMetricsJSON = await rpc(\n    await delegate.getSocket(),\n    {op: 'metrics'},\n    inspectMetricsDownSchema,\n  );\n  return mergeMetrics(clientMetrics, serverMetricsJSON);\n}\n\nexport function inspectorClients(\n  delegate: ExtendedInspectorDelegate,\n): Promise<Client[]> {\n  return withDagRead(delegate, dagRead => clients(delegate, dagRead));\n}\n\nexport function inspectorClientsWithQueries(\n  delegate: ExtendedInspectorDelegate,\n): Promise<Client[]> {\n  return withDagRead(delegate, dagRead =>\n    clientsWithQueries(delegate, dagRead),\n  );\n}\n\nasync function withDagRead<T>(\n  delegate: ExtendedInspectorDelegate,\n  f: (dagRead: Read) => Promise<T>,\n): Promise<T> {\n  const {rep} = delegate;\n  await rep.refresh();\n  await rep.persist();\n  return withRead(rep.perdag, f);\n}\n\nasync function getBTree(dagRead: Read, clientID: string): Promise<BTreeRead> {\n  const client = await getClient(clientID, dagRead);\n  assert(client, `Client not found: ${clientID}`);\n  const {clientGroupID} = client;\n  const clientGroup = await getClientGroup(clientGroupID, dagRead);\n  assert(clientGroup, `Client group not found: ${clientGroupID}`);\n  const dbRead = await readFromHash(\n    clientGroup.headHash,\n    dagRead,\n    FormatVersion.Latest,\n  );\n  return dbRead.map;\n}\n\n// oxlint-disable-next-line @typescript-eslint/no-explicit-any\ntype MapEntry<T extends ReadonlyMap<any, any>> =\n  T extends ReadonlyMap<infer K, infer V> ? readonly [K, V] : never;\n\nasync function clients(\n  delegate: ExtendedInspectorDelegate,\n  dagRead: Read,\n  predicate: (entry: MapEntry<ClientMap>) => boolean = () => true,\n): Promise<Client[]> {\n  const clients = await getClients(dagRead);\n  return [...clients.entries()]\n    .filter(predicate)\n    .map(\n      ([clientID, {clientGroupID}]) =>\n        new Client(delegate, clientID, clientGroupID),\n    );\n}\n\nasync function clientsWithQueries(\n  delegate: ExtendedInspectorDelegate,\n  dagRead: Read,\n  predicate: (entry: MapEntry<ClientMap>) => boolean = () => true,\n): Promise<Client[]> {\n  const allClients = await clients(delegate, dagRead, predicate);\n  const clientsWithQueries: Client[] = [];\n  await Promise.all(\n    allClients.map(async client => {\n      const queries = await client.queries();\n      if (queries.length > 0) {\n        clientsWithQueries.push(client);\n      }\n    }),\n  );\n  return clientsWithQueries;\n}\n\nexport async function clientGroupClients(\n  delegate: ExtendedInspectorDelegate,\n  clientGroupID: Promise<string> | string,\n): Promise<Client[]> {\n  const id = await clientGroupID;\n  return withDagRead(delegate, dagRead =>\n    clients(delegate, dagRead, ([_, v]) => v.clientGroupID === id),\n  );\n}\n\nexport async function clientGroupClientsWithQueries(\n  delegate: ExtendedInspectorDelegate,\n  clientGroupID: Promise<string> | string,\n): Promise<Client[]> {\n  const id = await clientGroupID;\n  return withDagRead(delegate, dagRead =>\n    clientsWithQueries(delegate, dagRead, ([_, v]) => v.clientGroupID === id),\n  );\n}\n\nexport function clientGroupQueries(\n  delegate: ExtendedInspectorDelegate,\n): Promise<Query[]> {\n  return queries(delegate, {op: 'queries'});\n}\nexport function clientMap(\n  delegate: ExtendedInspectorDelegate,\n  clientID: string,\n): Promise<Map<string, ReadonlyJSONValue>> {\n  return withDagRead(delegate, async dagRead => {\n    const tree = await getBTree(dagRead, clientID);\n    const map = new Map<string, ReadonlyJSONValue>();\n    for await (const [key, value] of tree.scan('')) {\n      map.set(key, value);\n    }\n    return map;\n  });\n}\n\nexport function clientRows(\n  delegate: ExtendedInspectorDelegate,\n  clientID: string,\n  tableName: string,\n): Promise<Row[]> {\n  return withDagRead(delegate, async dagRead => {\n    const prefix = ENTITIES_KEY_PREFIX + tableName + '/';\n    const tree = await getBTree(dagRead, clientID);\n    const rows: Row[] = [];\n    for await (const [key, value] of tree.scan(prefix)) {\n      if (!key.startsWith(prefix)) {\n        break;\n      }\n      rows.push(value as Row);\n    }\n    return rows;\n  });\n}\n\nexport async function serverVersion(\n  delegate: ExtendedInspectorDelegate,\n): Promise<string> {\n  return rpc(\n    await delegate.getSocket(),\n    {op: 'version'},\n    inspectVersionDownSchema,\n  );\n}\n\nexport function clientQueries(\n  delegate: ExtendedInspectorDelegate,\n  clientID: string,\n): Promise<Query[]> {\n  return queries(delegate, {op: 'queries', clientID});\n}\n\nasync function queries(\n  delegate: ExtendedInspectorDelegate,\n  arg: {op: 'queries'; clientID?: string},\n): Promise<Query[]> {\n  const rows: InspectQueryRow[] = await rpc(\n    await delegate.getSocket(),\n    arg,\n    inspectQueriesDownSchema,\n  );\n  const queries = rows.map(row => new Query(row, delegate, delegate.getSocket));\n  queries.sort((a, b) => (b.hydrateServer ?? 0) - (a.hydrateServer ?? 0));\n  return queries;\n}\n\nexport async function analyzeQuery(\n  delegate: ExtendedInspectorDelegate,\n  query: AnyQuery,\n  options?: AnalyzeQueryOptions,\n): Promise<AnalyzeQueryResult> {\n  const qi = asQueryInternals(query);\n  const {customQueryID} = qi;\n  const queryParameters = customQueryID\n    ? {name: customQueryID.name, args: customQueryID.args}\n    : {ast: delegate.mapClientASTToServer(qi.ast)};\n\n  return rpc(\n    await delegate.getSocket(),\n    {\n      op: 'analyze-query',\n      ...queryParameters,\n      options,\n    },\n    inspectAnalyzeQueryDownSchema,\n  );\n}\n\nclass UnauthenticatedError extends Error {}\n\nexport interface InspectorDelegate {\n  getQueryMetrics(hash: string): ClientMetrics | undefined;\n  getAST(queryID: string): AST | undefined;\n  readonly metrics: ClientMetrics;\n  mapClientASTToServer(ast: AST): AST;\n}\n\nexport interface ExtendedInspectorDelegate extends InspectorDelegate {\n  readonly rep: Rep;\n  readonly getSocket: () => Promise<WebSocket>;\n  readonly queryDelegate: QueryDelegate;\n  lazy: Promise<Lazy>;\n}\n\nexport type Rep = ReplicacheImpl<MutatorDefs>;\n\nexport type ClientMetrics = {\n  readonly [K in keyof ClientMetricMap]: ReadonlyTDigest;\n};\n\nexport type ServerMetrics = {\n  readonly [K in keyof ServerMetricMap]: ReadonlyTDigest;\n};\n"],"mappings":"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"}
+{"version":3,"file":"lazy-inspector.js","names":[],"sources":["../../../../../../zero-client/src/client/inspector/lazy-inspector.ts"],"sourcesContent":["import type {BTreeRead} from '../../../../replicache/src/btree/read.ts';\nimport type {Read} from '../../../../replicache/src/dag/store.ts';\nimport {readFromHash} from '../../../../replicache/src/db/read.ts';\nimport * as FormatVersion from '../../../../replicache/src/format-version-enum.ts';\nimport {getClientGroup} from '../../../../replicache/src/persist/client-groups.ts';\nimport {\n  getClient,\n  getClients,\n  type ClientMap,\n} from '../../../../replicache/src/persist/clients.ts';\nimport type {ReplicacheImpl} from '../../../../replicache/src/replicache-impl.ts';\nimport {withRead} from '../../../../replicache/src/with-transactions.ts';\nimport {assert} from '../../../../shared/src/asserts.ts';\nimport type {ReadonlyJSONValue} from '../../../../shared/src/json.ts';\nimport {mapValues} from '../../../../shared/src/objects.ts';\nimport {TDigest, type ReadonlyTDigest} from '../../../../shared/src/tdigest.ts';\nimport * as valita from '../../../../shared/src/valita.ts';\nimport type {AnalyzeQueryResult} from '../../../../zero-protocol/src/analyze-query-result.ts';\nimport type {AST} from '../../../../zero-protocol/src/ast.ts';\nimport type {Row} from '../../../../zero-protocol/src/data.ts';\nimport {\n  inspectAnalyzeQueryDownSchema,\n  inspectAuthenticatedDownSchema,\n  inspectMetricsDownSchema,\n  inspectQueriesDownSchema,\n  inspectVersionDownSchema,\n  type InspectDownBody,\n  type InspectQueryRow,\n  type ServerMetrics as ServerMetricsJSON,\n} from '../../../../zero-protocol/src/inspect-down.ts';\nimport type {\n  AnalyzeQueryOptions,\n  InspectUpBody,\n} from '../../../../zero-protocol/src/inspect-up.ts';\nimport type {\n  ClientMetricMap,\n  ServerMetricMap,\n} from '../../../../zql/src/query/metrics-delegate.ts';\nimport type {QueryDelegate} from '../../../../zql/src/query/query-delegate.ts';\nimport {asQueryInternals} from '../../../../zql/src/query/query-internals.ts';\nimport type {AnyQuery} from '../../../../zql/src/query/query.ts';\nimport {nanoid} from '../../util/nanoid.ts';\nimport {ENTITIES_KEY_PREFIX} from '../keys.ts';\nimport type {MutatorDefs} from '../replicache-types.ts';\nimport {Client} from './client.ts';\nimport {createHTMLPasswordPrompt} from './html-dialog-prompt.ts';\nimport {type Lazy} from './inspector.ts';\nimport {Query} from './query.ts';\n\nexport type GetWebSocket = () => Promise<WebSocket>;\n\nexport type Metrics = {\n  readonly [K in keyof (ClientMetricMap & ServerMetricMap)]: ReadonlyTDigest;\n};\n\ntype DistributiveOmit<T, K extends string> = T extends object\n  ? Omit<T, K>\n  : never;\n\nexport async function rpc<T extends InspectDownBody>(\n  socket: WebSocket,\n  arg: DistributiveOmit<InspectUpBody, 'id'>,\n  downSchema: valita.Type<T>,\n): Promise<T['value']> {\n  try {\n    return await rpcNoAuthTry(socket, arg, downSchema);\n  } catch (e) {\n    if (e instanceof UnauthenticatedError) {\n      const password = await createHTMLPasswordPrompt('Enter password:');\n      if (password) {\n        // Do authenticate rpc\n        const authRes = await rpcNoAuthTry(\n          socket,\n          {op: 'authenticate', value: password},\n          inspectAuthenticatedDownSchema,\n        );\n        if (authRes) {\n          // If authentication is successful, retry the original RPC\n          return rpcNoAuthTry(socket, arg, downSchema);\n        }\n      }\n      throw new Error('Authentication failed');\n    }\n    throw e;\n  }\n}\n\nfunction rpcNoAuthTry<T extends InspectDownBody>(\n  socket: WebSocket,\n  arg: DistributiveOmit<InspectUpBody, 'id'>,\n  downSchema: valita.Type<T>,\n): Promise<T['value']> {\n  return new Promise((resolve, reject) => {\n    const id = nanoid();\n    const f = (ev: MessageEvent) => {\n      const msg = JSON.parse(ev.data);\n      if (msg[0] === 'inspect') {\n        const body = msg[1];\n        if (body.id !== id) {\n          return;\n        }\n        const res = valita.test(body, downSchema);\n        if (res.ok) {\n          if (res.value.op === 'error') {\n            reject(new Error(res.value.value));\n          } else {\n            resolve(res.value.value);\n          }\n        } else {\n          // Check if we got un authenticated/false response\n          const authRes = valita.test(body, inspectAuthenticatedDownSchema);\n          if (authRes.ok) {\n            // Handle authenticated response\n            assert(\n              authRes.value.value === false,\n              'Expected unauthenticated response',\n            );\n            reject(new UnauthenticatedError());\n          }\n\n          reject(res.error);\n        }\n        socket.removeEventListener('message', f);\n      }\n    };\n    socket.addEventListener('message', f);\n    socket.send(JSON.stringify(['inspect', {...arg, id}]));\n  });\n} // T extends forces T to be resolved\n\nexport function mergeMetrics(\n  clientMetrics: ClientMetrics | undefined,\n  serverMetrics: ServerMetricsJSON | null | undefined,\n): ClientMetrics & ServerMetrics {\n  return {\n    ...(clientMetrics ?? newClientMetrics()),\n    ...(serverMetrics\n      ? convertServerMetrics(serverMetrics)\n      : newServerMetrics()),\n  };\n}\n\nfunction newClientMetrics(): ClientMetrics {\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\nfunction newServerMetrics(): ServerMetrics {\n  return {\n    'query-materialization-server': new TDigest(),\n    'query-update-server': new TDigest(),\n  };\n}\n\nfunction convertServerMetrics(metrics: ServerMetricsJSON): ServerMetrics {\n  return mapValues(metrics, v => TDigest.fromJSON(v));\n}\n\nexport async function inspectorMetrics(\n  delegate: ExtendedInspectorDelegate,\n): Promise<Metrics> {\n  const clientMetrics = delegate.metrics;\n  const serverMetricsJSON = await rpc(\n    await delegate.getSocket(),\n    {op: 'metrics'},\n    inspectMetricsDownSchema,\n  );\n  return mergeMetrics(clientMetrics, serverMetricsJSON);\n}\n\nexport function inspectorClients(\n  delegate: ExtendedInspectorDelegate,\n): Promise<Client[]> {\n  return withDagRead(delegate, dagRead => clients(delegate, dagRead));\n}\n\nexport function inspectorClientsWithQueries(\n  delegate: ExtendedInspectorDelegate,\n): Promise<Client[]> {\n  return withDagRead(delegate, dagRead =>\n    clientsWithQueries(delegate, dagRead),\n  );\n}\n\nasync function withDagRead<T>(\n  delegate: ExtendedInspectorDelegate,\n  f: (dagRead: Read) => Promise<T>,\n): Promise<T> {\n  const {rep} = delegate;\n  await rep.refresh();\n  await rep.persist();\n  return withRead(rep.perdag, f);\n}\n\nasync function getBTree(dagRead: Read, clientID: string): Promise<BTreeRead> {\n  const client = await getClient(clientID, dagRead);\n  assert(client, `Client not found: ${clientID}`);\n  const {clientGroupID} = client;\n  const clientGroup = await getClientGroup(clientGroupID, dagRead);\n  assert(clientGroup, `Client group not found: ${clientGroupID}`);\n  const dbRead = await readFromHash(\n    clientGroup.headHash,\n    dagRead,\n    FormatVersion.Latest,\n  );\n  return dbRead.map;\n}\n\n// oxlint-disable-next-line @typescript-eslint/no-explicit-any\ntype MapEntry<T extends ReadonlyMap<any, any>> =\n  T extends ReadonlyMap<infer K, infer V> ? readonly [K, V] : never;\n\nasync function clients(\n  delegate: ExtendedInspectorDelegate,\n  dagRead: Read,\n  predicate: (entry: MapEntry<ClientMap>) => boolean = () => true,\n): Promise<Client[]> {\n  const clients = await getClients(dagRead);\n  return [...clients.entries()]\n    .filter(predicate)\n    .map(\n      ([clientID, {clientGroupID}]) =>\n        new Client(delegate, clientID, clientGroupID),\n    );\n}\n\nasync function clientsWithQueries(\n  delegate: ExtendedInspectorDelegate,\n  dagRead: Read,\n  predicate: (entry: MapEntry<ClientMap>) => boolean = () => true,\n): Promise<Client[]> {\n  const allClients = await clients(delegate, dagRead, predicate);\n  const clientsWithQueries: Client[] = [];\n  await Promise.all(\n    allClients.map(async client => {\n      const queries = await client.queries();\n      if (queries.length > 0) {\n        clientsWithQueries.push(client);\n      }\n    }),\n  );\n  return clientsWithQueries;\n}\n\nexport async function clientGroupClients(\n  delegate: ExtendedInspectorDelegate,\n  clientGroupID: Promise<string> | string,\n): Promise<Client[]> {\n  const id = await clientGroupID;\n  return withDagRead(delegate, dagRead =>\n    clients(delegate, dagRead, ([_, v]) => v.clientGroupID === id),\n  );\n}\n\nexport async function clientGroupClientsWithQueries(\n  delegate: ExtendedInspectorDelegate,\n  clientGroupID: Promise<string> | string,\n): Promise<Client[]> {\n  const id = await clientGroupID;\n  return withDagRead(delegate, dagRead =>\n    clientsWithQueries(delegate, dagRead, ([_, v]) => v.clientGroupID === id),\n  );\n}\n\nexport function clientGroupQueries(\n  delegate: ExtendedInspectorDelegate,\n): Promise<Query[]> {\n  return queries(delegate, {op: 'queries'});\n}\nexport function clientMap(\n  delegate: ExtendedInspectorDelegate,\n  clientID: string,\n): Promise<Map<string, ReadonlyJSONValue>> {\n  return withDagRead(delegate, async dagRead => {\n    const tree = await getBTree(dagRead, clientID);\n    const map = new Map<string, ReadonlyJSONValue>();\n    for await (const [key, value] of tree.scan('')) {\n      map.set(key, value);\n    }\n    return map;\n  });\n}\n\nexport function clientRows(\n  delegate: ExtendedInspectorDelegate,\n  clientID: string,\n  tableName: string,\n): Promise<Row[]> {\n  return withDagRead(delegate, async dagRead => {\n    const prefix = ENTITIES_KEY_PREFIX + tableName + '/';\n    const tree = await getBTree(dagRead, clientID);\n    const rows: Row[] = [];\n    for await (const [key, value] of tree.scan(prefix)) {\n      if (!key.startsWith(prefix)) {\n        break;\n      }\n      rows.push(value as Row);\n    }\n    return rows;\n  });\n}\n\nexport async function serverVersion(\n  delegate: ExtendedInspectorDelegate,\n): Promise<string> {\n  return rpc(\n    await delegate.getSocket(),\n    {op: 'version'},\n    inspectVersionDownSchema,\n  );\n}\n\nexport function clientQueries(\n  delegate: ExtendedInspectorDelegate,\n  clientID: string,\n): Promise<Query[]> {\n  return queries(delegate, {op: 'queries', clientID});\n}\n\nasync function queries(\n  delegate: ExtendedInspectorDelegate,\n  arg: {op: 'queries'; clientID?: string},\n): Promise<Query[]> {\n  const rows: InspectQueryRow[] = await rpc(\n    await delegate.getSocket(),\n    arg,\n    inspectQueriesDownSchema,\n  );\n  const queries = rows.map(row => new Query(row, delegate, delegate.getSocket));\n  queries.sort((a, b) => (b.hydrateServer ?? 0) - (a.hydrateServer ?? 0));\n  return queries;\n}\n\nexport async function analyzeQuery(\n  delegate: ExtendedInspectorDelegate,\n  query: AnyQuery,\n  options?: AnalyzeQueryOptions,\n): Promise<AnalyzeQueryResult> {\n  const qi = asQueryInternals(query);\n  const {customQueryID} = qi;\n  const queryParameters = customQueryID\n    ? {name: customQueryID.name, args: customQueryID.args}\n    : {ast: delegate.mapClientASTToServer(qi.ast)};\n\n  return rpc(\n    await delegate.getSocket(),\n    {\n      op: 'analyze-query',\n      ...queryParameters,\n      options,\n    },\n    inspectAnalyzeQueryDownSchema,\n  );\n}\n\nexport async function analyzeServerAST(\n  delegate: ExtendedInspectorDelegate,\n  ast: AST,\n  options?: AnalyzeQueryOptions,\n): Promise<AnalyzeQueryResult> {\n  return rpc(\n    await delegate.getSocket(),\n    {op: 'analyze-query', ast, options},\n    inspectAnalyzeQueryDownSchema,\n  );\n}\n\nexport async function analyzeNamedQuery(\n  delegate: ExtendedInspectorDelegate,\n  name: string,\n  args: ReadonlyArray<ReadonlyJSONValue>,\n  options?: AnalyzeQueryOptions,\n): Promise<AnalyzeQueryResult> {\n  return rpc(\n    await delegate.getSocket(),\n    {op: 'analyze-query', name, args, options},\n    inspectAnalyzeQueryDownSchema,\n  );\n}\n\n/**\n * Sends an `authenticate` op to the server. Returns `true` if the password\n * is accepted (or the server is in a development mode that bypasses the\n * check). Use this from Node contexts where the default interactive HTML\n * prompt used by other inspector RPCs is not available.\n */\nexport async function authenticate(\n  delegate: ExtendedInspectorDelegate,\n  password: string,\n): Promise<boolean> {\n  return rpc(\n    await delegate.getSocket(),\n    {op: 'authenticate', value: password},\n    inspectAuthenticatedDownSchema,\n  );\n}\n\nclass UnauthenticatedError extends Error {}\n\nexport interface InspectorDelegate {\n  getQueryMetrics(hash: string): ClientMetrics | undefined;\n  getAST(queryID: string): AST | undefined;\n  readonly metrics: ClientMetrics;\n  mapClientASTToServer(ast: AST): AST;\n}\n\nexport interface ExtendedInspectorDelegate extends InspectorDelegate {\n  readonly rep: Rep;\n  readonly getSocket: () => Promise<WebSocket>;\n  readonly queryDelegate: QueryDelegate;\n  lazy: Promise<Lazy>;\n}\n\nexport type Rep = ReplicacheImpl<MutatorDefs>;\n\nexport type ClientMetrics = {\n  readonly [K in keyof ClientMetricMap]: ReadonlyTDigest;\n};\n\nexport type ServerMetrics = {\n  readonly [K in keyof ServerMetricMap]: ReadonlyTDigest;\n};\n"],"mappings":";;;;;;;;;;;;;;;;;AA2DA,eAAsB,IACpB,QACA,KACA,YACqB;AACrB,KAAI;AACF,SAAO,MAAM,aAAa,QAAQ,KAAK,WAAW;UAC3C,GAAG;AACV,MAAI,aAAa,sBAAsB;GACrC,MAAM,WAAW,MAAM,yBAAyB,kBAAkB;AAClE,OAAI;QAEc,MAAM,aACpB,QACA;KAAC,IAAI;KAAgB,OAAO;KAAS,EACrC,+BACD,CAGC,QAAO,aAAa,QAAQ,KAAK,WAAW;;AAGhD,SAAM,IAAI,MAAM,wBAAwB;;AAE1C,QAAM;;;AAIV,SAAS,aACP,QACA,KACA,YACqB;AACrB,QAAO,IAAI,SAAS,SAAS,WAAW;EACtC,MAAM,KAAK,QAAQ;EACnB,MAAM,KAAK,OAAqB;GAC9B,MAAM,MAAM,KAAK,MAAM,GAAG,KAAK;AAC/B,OAAI,IAAI,OAAO,WAAW;IACxB,MAAM,OAAO,IAAI;AACjB,QAAI,KAAK,OAAO,GACd;IAEF,MAAM,MAAM,KAAY,MAAM,WAAW;AACzC,QAAI,IAAI,GACN,KAAI,IAAI,MAAM,OAAO,QACnB,QAAO,IAAI,MAAM,IAAI,MAAM,MAAM,CAAC;QAElC,SAAQ,IAAI,MAAM,MAAM;SAErB;KAEL,MAAM,UAAU,KAAY,MAAM,+BAA+B;AACjE,SAAI,QAAQ,IAAI;AAEd,aACE,QAAQ,MAAM,UAAU,OACxB,oCACD;AACD,aAAO,IAAI,sBAAsB,CAAC;;AAGpC,YAAO,IAAI,MAAM;;AAEnB,WAAO,oBAAoB,WAAW,EAAE;;;AAG5C,SAAO,iBAAiB,WAAW,EAAE;AACrC,SAAO,KAAK,KAAK,UAAU,CAAC,WAAW;GAAC,GAAG;GAAK;GAAG,CAAC,CAAC,CAAC;GACtD;;AAGJ,SAAgB,aACd,eACA,eAC+B;AAC/B,QAAO;EACL,GAAI,iBAAiB,kBAAkB;EACvC,GAAI,gBACA,qBAAqB,cAAc,GACnC,kBAAkB;EACvB;;AAGH,SAAS,mBAAkC;AACzC,QAAO;EACL,gCAAgC,IAAI,SAAS;EAC7C,oCAAoC,IAAI,SAAS;EACjD,uBAAuB,IAAI,SAAS;EACrC;;AAGH,SAAS,mBAAkC;AACzC,QAAO;EACL,gCAAgC,IAAI,SAAS;EAC7C,uBAAuB,IAAI,SAAS;EACrC;;AAGH,SAAS,qBAAqB,SAA2C;AACvE,QAAO,UAAU,UAAS,MAAK,QAAQ,SAAS,EAAE,CAAC;;AAGrD,eAAsB,iBACpB,UACkB;CAClB,MAAM,gBAAgB,SAAS;AAM/B,QAAO,aAAa,eALM,MAAM,IAC9B,MAAM,SAAS,WAAW,EAC1B,EAAC,IAAI,WAAU,EACf,yBACD,CACoD;;AAGvD,SAAgB,iBACd,UACmB;AACnB,QAAO,YAAY,WAAU,YAAW,QAAQ,UAAU,QAAQ,CAAC;;AAGrE,SAAgB,4BACd,UACmB;AACnB,QAAO,YAAY,WAAU,YAC3B,mBAAmB,UAAU,QAAQ,CACtC;;AAGH,eAAe,YACb,UACA,GACY;CACZ,MAAM,EAAC,QAAO;AACd,OAAM,IAAI,SAAS;AACnB,OAAM,IAAI,SAAS;AACnB,QAAO,SAAS,IAAI,QAAQ,EAAE;;AAGhC,eAAe,SAAS,SAAe,UAAsC;CAC3E,MAAM,SAAS,MAAM,UAAU,UAAU,QAAQ;AACjD,QAAO,QAAQ,qBAAqB,WAAW;CAC/C,MAAM,EAAC,kBAAiB;CACxB,MAAM,cAAc,MAAM,eAAe,eAAe,QAAQ;AAChE,QAAO,aAAa,2BAA2B,gBAAgB;AAM/D,SALe,MAAM,aACnB,YAAY,UACZ,SACA,EACD,EACa;;AAOhB,eAAe,QACb,UACA,SACA,kBAA2D,MACxC;AAEnB,QAAO,CAAC,IADQ,MAAM,WAAW,QAAQ,EACtB,SAAS,CAAC,CAC1B,OAAO,UAAU,CACjB,KACE,CAAC,UAAU,EAAC,qBACX,IAAI,OAAO,UAAU,UAAU,cAAc,CAChD;;AAGL,eAAe,mBACb,UACA,SACA,kBAA2D,MACxC;CACnB,MAAM,aAAa,MAAM,QAAQ,UAAU,SAAS,UAAU;CAC9D,MAAM,qBAA+B,EAAE;AACvC,OAAM,QAAQ,IACZ,WAAW,IAAI,OAAM,WAAU;AAE7B,OADgB,MAAM,OAAO,SAAS,EAC1B,SAAS,EACnB,oBAAmB,KAAK,OAAO;GAEjC,CACH;AACD,QAAO;;AAGT,eAAsB,mBACpB,UACA,eACmB;CACnB,MAAM,KAAK,MAAM;AACjB,QAAO,YAAY,WAAU,YAC3B,QAAQ,UAAU,UAAU,CAAC,GAAG,OAAO,EAAE,kBAAkB,GAAG,CAC/D;;AAGH,eAAsB,8BACpB,UACA,eACmB;CACnB,MAAM,KAAK,MAAM;AACjB,QAAO,YAAY,WAAU,YAC3B,mBAAmB,UAAU,UAAU,CAAC,GAAG,OAAO,EAAE,kBAAkB,GAAG,CAC1E;;AAGH,SAAgB,mBACd,UACkB;AAClB,QAAO,QAAQ,UAAU,EAAC,IAAI,WAAU,CAAC;;AAE3C,SAAgB,UACd,UACA,UACyC;AACzC,QAAO,YAAY,UAAU,OAAM,YAAW;EAC5C,MAAM,OAAO,MAAM,SAAS,SAAS,SAAS;EAC9C,MAAM,sBAAM,IAAI,KAAgC;AAChD,aAAW,MAAM,CAAC,KAAK,UAAU,KAAK,KAAK,GAAG,CAC5C,KAAI,IAAI,KAAK,MAAM;AAErB,SAAO;GACP;;AAGJ,SAAgB,WACd,UACA,UACA,WACgB;AAChB,QAAO,YAAY,UAAU,OAAM,YAAW;EAC5C,MAAM,SAAA,OAA+B,YAAY;EACjD,MAAM,OAAO,MAAM,SAAS,SAAS,SAAS;EAC9C,MAAM,OAAc,EAAE;AACtB,aAAW,MAAM,CAAC,KAAK,UAAU,KAAK,KAAK,OAAO,EAAE;AAClD,OAAI,CAAC,IAAI,WAAW,OAAO,CACzB;AAEF,QAAK,KAAK,MAAa;;AAEzB,SAAO;GACP;;AAGJ,eAAsB,cACpB,UACiB;AACjB,QAAO,IACL,MAAM,SAAS,WAAW,EAC1B,EAAC,IAAI,WAAU,EACf,yBACD;;AAGH,SAAgB,cACd,UACA,UACkB;AAClB,QAAO,QAAQ,UAAU;EAAC,IAAI;EAAW;EAAS,CAAC;;AAGrD,eAAe,QACb,UACA,KACkB;CAMlB,MAAM,WAL0B,MAAM,IACpC,MAAM,SAAS,WAAW,EAC1B,KACA,yBACD,EACoB,KAAI,QAAO,IAAI,MAAM,KAAK,UAAU,SAAS,UAAU,CAAC;AAC7E,SAAQ,MAAM,GAAG,OAAO,EAAE,iBAAiB,MAAM,EAAE,iBAAiB,GAAG;AACvE,QAAO;;AAGT,eAAsB,aACpB,UACA,OACA,SAC6B;CAC7B,MAAM,KAAK,iBAAiB,MAAM;CAClC,MAAM,EAAC,kBAAiB;CACxB,MAAM,kBAAkB,gBACpB;EAAC,MAAM,cAAc;EAAM,MAAM,cAAc;EAAK,GACpD,EAAC,KAAK,SAAS,qBAAqB,GAAG,IAAI,EAAC;AAEhD,QAAO,IACL,MAAM,SAAS,WAAW,EAC1B;EACE,IAAI;EACJ,GAAG;EACH;EACD,EACD,8BACD;;AAGH,eAAsB,iBACpB,UACA,KACA,SAC6B;AAC7B,QAAO,IACL,MAAM,SAAS,WAAW,EAC1B;EAAC,IAAI;EAAiB;EAAK;EAAQ,EACnC,8BACD;;AAGH,eAAsB,kBACpB,UACA,MACA,MACA,SAC6B;AAC7B,QAAO,IACL,MAAM,SAAS,WAAW,EAC1B;EAAC,IAAI;EAAiB;EAAM;EAAM;EAAQ,EAC1C,8BACD;;;;;;;;AASH,eAAsB,aACpB,UACA,UACkB;AAClB,QAAO,IACL,MAAM,SAAS,WAAW,EAC1B;EAAC,IAAI;EAAgB,OAAO;EAAS,EACrC,+BACD;;AAGH,IAAM,uBAAN,cAAmC,MAAM"}

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

@@ -2,7 +2,7 @@
 /**
 * The current version of Zero.
 */
-var version = "1.3.0-canary.3";
+var version = "1.4.0-canary.0";
 //#endregion
 export { version };
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rocicorp/zero",
-  "version": "1.3.0-canary.3",
+  "version": "1.4.0-canary.0",
   "description": "Zero is a web framework for serverless web development.",
   "homepage": "https://zero.rocicorp.dev",
   "bugs": {
@@ -36,6 +36,10 @@
       "types": "./out/zero/src/zero.d.ts",
       "default": "./out/zero/src/zero.js"
     },
+    "./analyze": {
+      "types": "./out/zero/src/analyze.d.ts",
+      "default": "./out/zero/src/analyze.js"
+    },
     "./bindings": {
       "types": "./out/zero/src/bindings.d.ts",
       "default": "./out/zero/src/bindings.js"