@rocicorp/zero 1.12.0-canary.6 → 1.12.0-canary.7

package/out/zero-cache/src/services/replicator/write-worker-client.d.ts

@@ -1,111 +0,0 @@
-import type { LogConfig } from '../../../../shared/src/logging.ts';
-import type { Database } from '../../../../zqlite/src/db.ts';
-import type { ChangeStreamData } from '../change-source/protocol/current/downstream.ts';
-import type { BackfillRequest } from '../change-source/protocol/current/upstream.ts';
-import type { ChangeProcessorMode, CommitResult } from './change-processor.ts';
-import type { SubscriptionState } from './schema/replication-state.ts';
-export type PragmaConfig = {
-    busyTimeout: number;
-    analysisLimit: number;
-    walAutocheckpoint?: number | undefined;
-};
-/**
- * Enables write-path checkpoint backpressure in the write worker. At each
- * commit boundary, if the WAL has grown to at least `checkpointThresholdPages`,
- * the worker forces an immediate litestream sync (sealing the WAL to LTX and
- * running litestream's checkpoint).
- *
- * The optional `walMaxPages` is an emergency break that pauses until the WAL drains,
- * rather than letting it exceed available disk space. This replaces litestream's
- * analogous `truncate-page-n` emergency break, which is more disruptive because of
- * https://github.com/benbjohnson/litestream/issues/1332. Note, however, this should
- * never been needed if non-initial snapshots are disabled (which is the default).
- *
- * Set only for the backup replicator when replicating with litestream v5; `null`
- * disables the feature entirely (no per-commit overhead).
- */
-export type ForceCheckpointConfig = {
-    checkpointThresholdPages: number;
-    maxWalPages?: number | undefined;
-};
-type ErrorHandler = (err: Error) => void;
-/**
- * Interface for a write worker that processes replication messages.
- */
-/**
- * The replica's {@link SubscriptionState}, along with its pending backfills,
- * read in the same snapshot.
- */
-export type SubscriptionStateWithBackfills = SubscriptionState & {
-    backfills: BackfillRequest[];
-};
-export interface WriteWorkerClient {
-    getSubscriptionState(): Promise<SubscriptionStateWithBackfills>;
-    processMessages(downstream: readonly ChangeStreamData[]): Promise<CommitResult | null>;
-    abort(): void;
-    stop(): Promise<void>;
-    onError(handler: ErrorHandler): void;
-}
-export type SerializedError = {
-    name: string;
-    message: string;
-    stack?: string | undefined;
-    cause?: SerializedError | string | undefined;
-    details?: Record<string, unknown> | undefined;
-};
-export declare function serializeError(err: unknown): SerializedError;
-export declare function deserializeError(serialized: SerializedError): Error;
-export type ArgsMap = {
-    init: [
-        string,
-        ChangeProcessorMode,
-        PragmaConfig,
-        LogConfig,
-        ForceCheckpointConfig | null
-    ];
-    getSubscriptionState: [];
-    processMessages: [readonly ChangeStreamData[]];
-    abort: [];
-    stop: [];
-};
-export type Method = keyof ArgsMap;
-export type Request<M extends Method = Method> = {
-    method: M;
-    args: ArgsMap[M];
-};
-export type ResultMap = {
-    init: void;
-    getSubscriptionState: SubscriptionStateWithBackfills;
-    processMessages: CommitResult | null;
-    abort: void;
-    stop: void;
-};
-export type Response<M extends Method = Method> = {
-    method: M;
-    result: ResultMap[M];
-    error?: undefined;
-} | {
-    method: M;
-    error: SerializedError;
-    result?: undefined;
-};
-export type WriteError = {
-    writeError: SerializedError;
-};
-export declare function applyPragmas(db: Database, pragmas: PragmaConfig): void;
-/**
- * Delegates SQLite writes to a worker_thread,
- * keeping the main event loop free for WebSocket heartbeats and IPC.
- */
-export declare class ThreadWriteWorkerClient implements WriteWorkerClient {
-    #private;
-    constructor();
-    init(dbPath: string, mode: ChangeProcessorMode, pragmas: PragmaConfig, logConfig: LogConfig, checkpoint?: ForceCheckpointConfig | null): Promise<void>;
-    getSubscriptionState(): Promise<SubscriptionStateWithBackfills>;
-    processMessages(downstream: readonly ChangeStreamData[]): Promise<CommitResult | null>;
-    abort(): void;
-    stop(): Promise<void>;
-    onError(handler: ErrorHandler): void;
-}
-export {};
-//# sourceMappingURL=write-worker-client.d.ts.map

package/out/zero-cache/src/services/replicator/write-worker-client.d.ts.map

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

package/out/zero-cache/src/services/run-ast.d.ts

@@ -1,39 +0,0 @@
-import type { LogContext } from '@rocicorp/logger';
-import type { AnalyzeQueryResult } from '../../../zero-protocol/src/analyze-query-result.ts';
-import type { AST } from '../../../zero-protocol/src/ast.ts';
-import type { ClientSchema } from '../../../zero-protocol/src/client-schema.ts';
-import type { PermissionsConfig } from '../../../zero-schema/src/compiled-permissions.ts';
-import type { NameMapper } from '../../../zero-schema/src/name-mapper.ts';
-import { type BuilderDelegate } from '../../../zql/src/builder/builder.ts';
-import type { ConnectionCostModel } from '../../../zql/src/planner/planner-connection.ts';
-import type { PlanDebugger } from '../../../zql/src/planner/planner-debug.ts';
-import type { Database } from '../../../zqlite/src/db.ts';
-import type { JWTAuth } from '../auth/auth.ts';
-import type { LiteAndZqlSpec } from '../db/specs.ts';
-/**
- * Maximum number of synced rows returned per table, and read rows returned
- * per table/query, when analyzing a query in zero-cache. Rows past this are
- * still counted. Keeping every row can exhaust the heap when analyzing queries
- * over large tables.
- */
-export declare const MAX_ANALYZE_ROWS = 1000;
-export type RunAstOptions = {
-    applyPermissions?: boolean | undefined;
-    auth?: JWTAuth | undefined;
-    clientToServerMapper?: NameMapper | undefined;
-    costModel?: ConnectionCostModel | undefined;
-    db: Database;
-    host: BuilderDelegate;
-    /**
-     * Maximum number of synced rows returned per table. Rows past this are still
-     * counted. Defaults to no limit.
-     */
-    maxSyncedRowsPerTable?: number | undefined;
-    permissions?: PermissionsConfig | undefined;
-    planDebugger?: PlanDebugger | undefined;
-    syncedRows?: boolean | undefined;
-    tableSpecs: Map<string, LiteAndZqlSpec>;
-    vendedRows?: boolean | undefined;
-};
-export declare function runAst(lc: LogContext, clientSchema: ClientSchema, ast: AST, isTransformed: boolean, options: RunAstOptions, yieldProcess: () => Promise<void>): Promise<AnalyzeQueryResult>;
-//# sourceMappingURL=run-ast.d.ts.map

package/out/zero-cache/src/services/run-ast.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"run-ast.d.ts","sourceRoot":"","sources":["../../../../../zero-cache/src/services/run-ast.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,kBAAkB,CAAC;AAQjD,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,oDAAoD,CAAC;AAC3F,OAAO,KAAK,EAAC,GAAG,EAAe,MAAM,mCAAmC,CAAC;AAEzE,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,6CAA6C,CAAC;AAG9E,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,kDAAkD,CAAC;AACxF,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,yCAAyC,CAAC;AACxE,OAAO,EAEL,KAAK,eAAe,EACrB,MAAM,qCAAqC,CAAC;AAG7C,OAAO,KAAK,EAAC,mBAAmB,EAAC,MAAM,gDAAgD,CAAC;AACxF,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,2CAA2C,CAAC;AAC5E,OAAO,KAAK,EAAC,QAAQ,EAAC,MAAM,2BAA2B,CAAC;AAExD,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,iBAAiB,CAAC;AAG7C,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,gBAAgB,CAAC;AAOnD;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,OAAO,CAAC;AAErC,MAAM,MAAM,aAAa,GAAG;IAC1B,gBAAgB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACvC,IAAI,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC3B,oBAAoB,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;IAC9C,SAAS,CAAC,EAAE,mBAAmB,GAAG,SAAS,CAAC;IAC5C,EAAE,EAAE,QAAQ,CAAC;IACb,IAAI,EAAE,eAAe,CAAC;IACtB;;;OAGG;IACH,qBAAqB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3C,WAAW,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAC;IAC5C,YAAY,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC;IACxC,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACjC,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACxC,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAClC,CAAC;AAEF,wBAAsB,MAAM,CAC1B,EAAE,EAAE,UAAU,EACd,YAAY,EAAE,YAAY,EAC1B,GAAG,EAAE,GAAG,EACR,aAAa,EAAE,OAAO,EACtB,OAAO,EAAE,aAAa,EACtB,YAAY,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAChC,OAAO,CAAC,kBAAkB,CAAC,CAyL7B"}

package/out/zero-cache/src/services/runner.d.ts

@@ -1,19 +0,0 @@
-import type { LogContext } from '@rocicorp/logger';
-import type { Service } from './service.ts';
-/**
- * Manages the creation and lifecycle of objects that implement
- * {@link Service}.
- */
-export declare class ServiceRunner<S extends Service> {
-    #private;
-    constructor(lc: LogContext, factory: (id: string) => S, isValid?: (existing: S) => boolean, onStop?: ((id: string) => void) | undefined);
-    /**
-     * Creates and runs the Service with the given `id`, returning
-     * an existing one if it is still running a valid.
-     */
-    getService(id: string): S;
-    hasService(id: string): boolean;
-    get size(): number;
-    getServices(): Iterable<S>;
-}
-//# sourceMappingURL=runner.d.ts.map

package/out/zero-cache/src/services/runner.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../../../../zero-cache/src/services/runner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,cAAc,CAAC;AAE1C;;;GAGG;AACH,qBAAa,aAAa,CAAC,CAAC,SAAS,OAAO;;IAO1C,YACE,EAAE,EAAE,UAAU,EACd,OAAO,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,CAAC,EAC1B,OAAO,GAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,OAAoB,EAC9C,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,EAM5C;IAED;;;OAGG;IACH,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,CAAC,CA4BxB;IAED,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAE9B;IAED,IAAI,IAAI,WAEP;IAED,WAAW,IAAI,QAAQ,CAAC,CAAC,CAAC,CAEzB;CACF"}

package/out/zero-cache/src/services/view-syncer/active-users-gauge.d.ts

@@ -1,17 +0,0 @@
-import type { LogContext } from '@rocicorp/logger';
-import { setActiveUsersGetter } from '../../server/anonymous-otel-start.ts';
-import type { PostgresDB } from '../../types/pg.ts';
-import { type ShardID } from '../../types/shards.ts';
-import type { Service } from '../service.ts';
-type Options = {
-    updateIntervalMs?: number;
-};
-export declare class ActiveUsersGauge implements Service {
-    #private;
-    readonly id = "active-users-gauge";
-    constructor(lc: LogContext, db: PostgresDB, shard: ShardID, opts?: Options, setActiveUsersGetterFn?: typeof setActiveUsersGetter);
-    run(): Promise<void>;
-    stop(): Promise<void>;
-}
-export {};
-//# sourceMappingURL=active-users-gauge.d.ts.map

package/out/zero-cache/src/services/view-syncer/active-users-gauge.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"active-users-gauge.d.ts","sourceRoot":"","sources":["../../../../../../zero-cache/src/services/view-syncer/active-users-gauge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,kBAAkB,CAAC;AAGjD,OAAO,EACL,oBAAoB,EAErB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAY,KAAK,OAAO,EAAC,MAAM,uBAAuB,CAAC;AAE9D,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,eAAe,CAAC;AAK3C,KAAK,OAAO,GAAG;IACb,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF,qBAAa,gBAAiB,YAAW,OAAO;;IAC9C,QAAQ,CAAC,EAAE,wBAAwB;IAYnC,YACE,EAAE,EAAE,UAAU,EACd,EAAE,EAAE,UAAU,EACd,KAAK,EAAE,OAAO,EACd,IAAI,GAAE,OAAY,EAClB,sBAAsB,8BAAuB,EAO9C;IAEK,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CA4CzB;IAED,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAGpB;CACF"}

package/out/zero-cache/src/services/view-syncer/advancement-metrics.d.ts

@@ -1,26 +0,0 @@
-import type { ResetPipelinesReason } from './snapshotter.ts';
-export type AdvancementOutcome = {
-    readonly outcome: 'success' | 'error';
-} | {
-    readonly outcome: 'reset';
-    readonly reason: ResetPipelinesReason;
-};
-export type AdvancementTimings = {
-    /** Setup plus time between time-slice yields, including asynchronous I/O. */
-    readonly processingTimeMs: number;
-    /** Synchronous snapshot, change-count, CVR updater, and poke preparation. */
-    readonly setupTimeMs: number;
-    /** Elapsed wall time, including time-slice waits and output cleanup. */
-    readonly wallTimeMs: number;
-};
-/**
- * Counts and times every advancement attempt, including work abandoned by a
- * reset. The existing sync.advance-time histogram measures successes only.
- * Outcome and reset reason are bounded labels; client and query IDs are not
- * recorded here. Recording once per attempt adds no clocks to row processing.
- */
-export declare class AdvancementMetrics {
-    #private;
-    record({ processingTimeMs, setupTimeMs, wallTimeMs }: AdvancementTimings, outcome: AdvancementOutcome): void;
-}
-//# sourceMappingURL=advancement-metrics.d.ts.map

package/out/zero-cache/src/services/view-syncer/advancement-metrics.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"advancement-metrics.d.ts","sourceRoot":"","sources":["../../../../../../zero-cache/src/services/view-syncer/advancement-metrics.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,oBAAoB,EAAC,MAAM,kBAAkB,CAAC;AAE3D,MAAM,MAAM,kBAAkB,GAC1B;IAAC,QAAQ,CAAC,OAAO,EAAE,SAAS,GAAG,OAAO,CAAA;CAAC,GACvC;IAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAA;CAAC,CAAC;AAEvE,MAAM,MAAM,kBAAkB,GAAG;IAC/B,6EAA6E;IAC7E,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,6EAA6E;IAC7E,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,wEAAwE;IACxE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B,CAAC;AAEF;;;;;GAKG;AACH,qBAAa,kBAAkB;;IAqB7B,MAAM,CACJ,EAAC,gBAAgB,EAAE,WAAW,EAAE,UAAU,EAAC,EAAE,kBAAkB,EAC/D,OAAO,EAAE,kBAAkB,GAC1B,IAAI,CAQN;CACF"}

package/out/zero-cache/src/services/view-syncer/batch-pacer.d.ts

@@ -1,79 +0,0 @@
-import type { LogContext } from '@rocicorp/logger';
-export type BatchPacerOptions = {
-    /**
-     * The largest share of the worker's time that it may be busy before its
-     * client groups are paced.
-     */
-    readonly shareTarget: number;
-    /** The longest a client group waits between batches. */
-    readonly maxIntervalMs: number;
-    readonly now?: (() => number) | undefined;
-    /**
-     * The share of the time since the previous call that the worker was busy.
-     * By default, the utilization of the event loop.
-     */
-    readonly utilization?: (() => number) | undefined;
-    /** Where the worker says that it is pacing its client groups. */
-    readonly lc?: LogContext | undefined;
-};
-/**
- * Paces the batches (advancements, including the queries they hydrate
- * again) of the client groups of a sync worker, so that the worker is left
- * with time for new hydrations and connections, and gives the hydrations of
- * new queries priority over the batches.
- *
- * **Pacing.** After each batch, a client group waits {@link waitMs} before
- * it starts the next. The wait is a multiple of the batch's processing
- * time, so a client group that always has changes waiting is busy at most
- * `1 / (1 + k)` of the time, where `k` is the {@link multiplier}. Because
- * the wait is in proportion to a client group's own processing time, those
- * that cause the load are slowed the most, and cheap ones barely at all.
- *
- * The multiplier is shared by the client groups of the worker. Once per
- * second, it is scaled by how far the share of its time that the worker was
- * busy, smoothed over a few seconds, is from the target, and by more while
- * the worker has no time to spare. It never goes below 0, where no client
- * group waits. The share is the utilization of the worker's event loop, i.e. all
- * of what the worker does: what a batch costs is spread over the pipelines,
- * the CVR, the pokes and garbage collection, and is not measurable batch by
- * batch.
- *
- * **Priority of new hydrations.** The worker's time slices are handed out
- * by the pacer (see {@link yieldSlice}), and while the hydration of new
- * queries is waiting for one, most of them go to it rather than to batches.
- */
-export declare class BatchPacer {
-    #private;
-    constructor({ shareTarget, maxIntervalMs, now, utilization, lc, }: BatchPacerOptions);
-    /**
-     * How long a client group should wait before its next batch, after one
-     * that took `processingMs` to process. The multiplier changes while a
-     * client group waits, so a long wait should be taken in steps, asking
-     * again after each.
-     */
-    waitMs(processingMs: number): number;
-    /** `k`: a client group waits `k` times the processing time of a batch. */
-    get multiplier(): number;
-    /**
-     * The share of its time that the worker was busy, smoothed over the last
-     * few seconds, as of the last update of the multiplier.
-     */
-    get share(): number;
-    /**
-     * Yields the worker to the other work that is waiting for a time slice,
-     * and resolves when it is the caller's turn again. One piece of work runs
-     * per turn of the event loop, as when the work of a worker's client groups
-     * simply takes turns, except that the hydration of new queries goes first:
-     * while both kinds of work are waiting, `HYDRATION_PRIORITY` slices go to
-     * hydrations for each one that goes to a batch.
-     *
-     * Batches are never made to wait for anything but a slice. If no
-     * hydration is waiting for one (because none is running, or because those
-     * that are running are waiting for I/O), batches get every slice. And
-     * however many hydrations there are, batches keep a share of the slices,
-     * so they keep moving, and so do the snapshots of the replica that they
-     * hold.
-     */
-    yieldSlice(kind: 'hydration' | 'batch'): Promise<void>;
-}
-//# sourceMappingURL=batch-pacer.d.ts.map

package/out/zero-cache/src/services/view-syncer/batch-pacer.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"batch-pacer.d.ts","sourceRoot":"","sources":["../../../../../../zero-cache/src/services/view-syncer/batch-pacer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,kBAAkB,CAAC;AAyDjD,MAAM,MAAM,iBAAiB,GAAG;IAC9B;;;OAGG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,wDAAwD;IACxD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,MAAM,MAAM,CAAC,GAAG,SAAS,CAAC;IAC1C;;;OAGG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,MAAM,MAAM,CAAC,GAAG,SAAS,CAAC;IAClD,iEAAiE;IACjE,QAAQ,CAAC,EAAE,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;CACtC,CAAC;AAYF;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,qBAAa,UAAU;;IA8BrB,YAAY,EACV,WAAW,EACX,aAAa,EACb,GAAG,EACH,WAAW,EACX,EAAE,GACH,EAAE,iBAAiB,EAOnB;IAED;;;;;OAKG;IACH,MAAM,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CASnC;IAED,0EAA0E;IAC1E,IAAI,UAAU,IAAI,MAAM,CAGvB;IAED;;;OAGG;IACH,IAAI,KAAK,IAAI,MAAM,CAGlB;IA+FD;;;;;;;;;;;;;;OAcG;IACH,UAAU,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAQrD;CAuBF"}

package/out/zero-cache/src/services/view-syncer/client-handler.d.ts

@@ -1,97 +0,0 @@
-import type { LogContext } from '@rocicorp/logger';
-import type { JSONObject } from '../../../../shared/src/bigint-json.ts';
-import { type JSONObject as SafeJSONObject } from '../../../../shared/src/json.ts';
-import type { ErroredQuery } from '../../../../zero-protocol/src/custom-queries.ts';
-import { type TransformFailedBody } from '../../../../zero-protocol/src/error.ts';
-import type { InspectDownBody } from '../../../../zero-protocol/src/inspect-down.ts';
-import type { RowPatchOp } from '../../../../zero-protocol/src/row-patch.ts';
-import type { ViewSyncerDownstream } from '../../types/downstream.ts';
-import { type ShardID } from '../../types/shards.ts';
-import type { Subscription } from '../../types/subscription.ts';
-import { type CVRVersion, type DelQueryPatch, type NullableCVRVersion, type PutQueryPatch, type RowID } from './schema/types.ts';
-export type PutRowPatch = {
-    type: 'row';
-    op: 'put';
-    id: RowID;
-    contents: JSONObject;
-};
-export type DeleteRowPatch = {
-    type: 'row';
-    op: 'del';
-    id: RowID;
-};
-export type RowPatch = PutRowPatch | DeleteRowPatch;
-export type ConfigPatch = DelQueryPatch | PutQueryPatch;
-export type Patch = ConfigPatch | RowPatch;
-export type PatchToVersion = {
-    patch: Patch;
-    toVersion: CVRVersion;
-};
-export interface PokeHandler {
-    addPatch(patch: PatchToVersion): Promise<void>;
-    cancel(): Promise<void>;
-    end(finalVersion: CVRVersion): Promise<void>;
-}
-/**
- * A put/del row patch and its JSON serialization. Computed once per client
- * group and shared by all of the group's clients.
- */
-type SerializedRowPatch = {
-    readonly rowPatch: RowPatchOp;
-    readonly json: string;
-};
-/**
- * Lazily holds the {@link SerializedRowPatch} of one patch so that it is
- * computed at most once, by the first client that needs it.
- */
-type SharedRowPatch = {
-    serialized?: SerializedRowPatch | undefined;
-};
-/** A {@link PokeHandler} for a single client. */
-export interface ClientPokeHandler extends PokeHandler {
-    addPatch(patch: PatchToVersion, shared?: SharedRowPatch): Promise<void>;
-    /**
-     * Whether a patch has been sent to the client. Once one has, the poke can
-     * only be ended with a `finalVersion` that is ahead of the client's base
-     * version.
-     */
-    readonly patchesSent: boolean;
-}
-/**
- * A {@link PokeHandler} for multiple clients, as returned by
- * {@link startPoke}.
- */
-export interface MultiPokeHandler extends PokeHandler {
-    /** Whether a patch has been sent to any of the clients. */
-    readonly patchesSent: boolean;
-}
-/** Wraps PokeHandlers for multiple clients in a single PokeHandler. */
-export declare function startPoke(lc: LogContext, clients: ClientHandler[], tentativeVersion: CVRVersion): MultiPokeHandler;
-export declare const POKE_PART_FLUSH_THRESHOLD_CHARS: number;
-/**
- * Handles a single `ViewSyncer` connection.
- */
-export declare class ClientHandler {
-    #private;
-    readonly clientID: string;
-    readonly wsID: string;
-    constructor(lc: LogContext, clientGroupID: string, clientID: string, wsID: string, shard: ShardID, baseCookie: string | null, downstream: Subscription<ViewSyncerDownstream>);
-    version(): NullableCVRVersion;
-    fail(e: unknown): void;
-    close(reason: string): void;
-    startPoke(tentativeVersion: CVRVersion): ClientPokeHandler;
-    sendDeleteClients(lc: LogContext, deletedClientIDs: string[], deletedClientGroupIDs: string[]): Promise<void>;
-    sendQueryTransformApplicationErrors(errors: ErroredQuery[]): void;
-    sendQueryTransformFailedError(error: TransformFailedBody): void;
-    sendInspectResponse(lc: LogContext, response: InspectDownBody): void;
-}
-/**
- * Column values of type INT8 are returned as the `bigint` from the
- * Postgres library. These are converted to `number` if they are within
- * the safe Number range, allowing the protocol to support numbers larger
- * than 32-bits. Values outside of the safe number range (e.g. > 2^53) will
- * result in an Error.
- */
-export declare function ensureSafeJSON(row: JSONObject): SafeJSONObject;
-export {};
-//# sourceMappingURL=client-handler.d.ts.map

package/out/zero-cache/src/services/view-syncer/client-handler.d.ts.map

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

package/out/zero-cache/src/services/view-syncer/client-schema.d.ts

@@ -1,18 +0,0 @@
-import type { ClientSchema } from '../../../../zero-protocol/src/client-schema.ts';
-import type { LiteTableSpecWithReplicationStatus } from '../../db/lite-tables.ts';
-import type { LiteAndZqlSpec } from '../../db/specs.ts';
-import { type ShardID } from '../../types/shards.ts';
-/**
- * Throws a `SchemaVersionNotSupported` error if the client schema is not
- * compatible with the replica, or a `ServerOverloaded` error (which clients
- * retry with backoff) if the only incompatibilities are tables or columns
- * that are still being backfilled.
- *
- * @param tableSpecsWithBackfills the table specs computed with backfilling
- *     columns included. Permanent incompatibilities are checked against
- *     these, so that a table or column that will not be syncable after its
- *     backfill completes is not reported as retriable. Defaults to
- *     `tableSpecs`, for replicas with nothing being backfilled.
- */
-export declare function checkClientSchema(shardID: ShardID, clientSchema: ClientSchema, tableSpecs: Map<string, LiteAndZqlSpec>, fullTables: Map<string, LiteTableSpecWithReplicationStatus>, tableSpecsWithBackfills?: Map<string, LiteAndZqlSpec>): void;
-//# sourceMappingURL=client-schema.d.ts.map

package/out/zero-cache/src/services/view-syncer/client-schema.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"client-schema.d.ts","sourceRoot":"","sources":["../../../../../../zero-cache/src/services/view-syncer/client-schema.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,gDAAgD,CAAC;AAIjF,OAAO,KAAK,EAAC,kCAAkC,EAAC,MAAM,yBAAyB,CAAC;AAChF,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,mBAAmB,CAAC;AAEtD,OAAO,EAA4B,KAAK,OAAO,EAAC,MAAM,uBAAuB,CAAC;AAQ9E;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,OAAO,EAChB,YAAY,EAAE,YAAY,EAC1B,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,EACvC,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,kCAAkC,CAAC,EAC3D,uBAAuB,GAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAc,QAkClE"}

package/out/zero-cache/src/services/view-syncer/connection-context-manager.d.ts

@@ -1,184 +0,0 @@
-import type { LogContext } from '@rocicorp/logger';
-import type { InitConnectionBody } from '../../../../zero-protocol/src/connect.ts';
-import type { UpdateAuthBody } from '../../../../zero-protocol/src/update-auth.ts';
-import { type Auth, type ValidateLegacyJWT } from '../../auth/auth.ts';
-import type { ZeroConfig } from '../../config/zero-config.ts';
-import type { ConnectParams } from '../../workers/connect-params.ts';
-export type ConnectionState = 'provisional' | 'validated';
-/**
- * Normalized user identity shared by live connection state and group auth state.
- * `id: null` means logged out.
- */
-export type UserState = {
-    readonly id: string | null;
-};
-/**
- * Delineates the two paths for validating a connection: either server can validate
- * the user's identity and return a definitive userID to trust, or we fall back to
- * trusting the one provided by the client in the incoming query params.
- */
-export type ConnectionValidation = {
-    kind: 'client-fallback';
-} | {
-    kind: 'server-validated';
-    validatedUserID: string | null;
-};
-/**
- * Identifies one live websocket for a client slot.
- */
-export type ConnectionSelector = {
-    readonly clientID: string;
-    readonly wsID: string;
-};
-type FetchConfig = ZeroConfig['query'];
-export type HeaderOptions = {
-    readonly apiKey?: string | undefined;
-    /** Allowlisted headers provided in the client options. */
-    readonly customHeaders?: Readonly<Record<string, string>> | undefined;
-    /** Allowlisted headers from the incoming HTTP request. */
-    readonly requestHeaders?: Readonly<Record<string, string>> | undefined;
-    readonly cookie?: string | undefined;
-    readonly origin?: string | undefined;
-};
-export type ConnectionFetchContext = {
-    readonly url: string | undefined;
-    readonly allowedUrlPatterns: readonly URLPattern[] | undefined;
-    readonly headerOptions: HeaderOptions;
-};
-/**
- * A snapshot of one live connection tracked by the manager.
- *
- * `revalidateAt` is only populated while the connection is `validated`.
- */
-export type ConnectionContext = {
-    readonly state: ConnectionState;
-    readonly clientID: string;
-    readonly wsID: string;
-    readonly user: UserState;
-    readonly auth: Auth | undefined;
-    readonly profileID: string | null;
-    readonly baseCookie: string | null;
-    readonly protocolVersion: number;
-    readonly revision: number;
-    readonly revalidateAt: number | undefined;
-    readonly insertionOrder: number;
-    readonly queryContext: ConnectionFetchContext;
-    readonly mutateContext: ConnectionFetchContext;
-};
-/**
- * Group-scoped auth state shared across the live connections.
- *
- * The background connection is the validated connection currently used for
- * shared background work. Retransform happens on a group level, and uses
- * the background connection's credential to refetch the latest queries.
- */
-export type GroupAuthState = {
-    readonly pinnedUser: UserState | undefined;
-    readonly backgroundConnection: ConnectionSelector | undefined;
-    readonly retransformAt: number | undefined;
-    readonly maintenanceNotBeforeAt: number | undefined;
-};
-export type ConnectionContextManager = {
-    registerConnection(selector: ConnectionSelector, connectParams: ConnectParams, auth?: Auth): Readonly<ConnectionContext>;
-    initConnection(selector: ConnectionSelector, body: InitConnectionBody): Readonly<ConnectionContext>;
-    updateAuth(selector: ConnectionSelector, body: UpdateAuthBody): Promise<Readonly<ConnectionContext>>;
-    validateConnection(selector: ConnectionSelector, revision: number, validation: ConnectionValidation): Readonly<{
-        connection: ConnectionContext;
-        group: GroupAuthState;
-    }> | undefined;
-    failConnection(selector: ConnectionSelector, revision: number): Readonly<ConnectionContext> | undefined;
-    closeConnection(selector: ConnectionSelector): Readonly<ConnectionContext> | undefined;
-    markBackgroundRetransformSuccess(selector: ConnectionSelector, revision: number): void;
-    setSharedRetransformReady(ready: boolean): void;
-    deferMaintenance(kind: 'revalidate' | 'retransform'): void;
-    getConnectionContext(selector: ConnectionSelector): Readonly<ConnectionContext> | undefined;
-    mustGetConnectionContext(selector: ConnectionSelector): Readonly<ConnectionContext>;
-    getBackgroundConnectionContext(): Readonly<ConnectionContext> | undefined;
-    mustGetBackgroundConnectionContext(): Readonly<ConnectionContext>;
-    getGroupState(): Readonly<GroupAuthState>;
-    planMaintenance(): {
-        dueRevalidations: Readonly<ConnectionContext>[];
-        dueRetransform: boolean;
-        earliestDeadlineAt: number | undefined;
-    };
-};
-/**
- * State machine for the auth state of a single `ViewSyncerService`.
- *
- * Connections are registered as `provisional`, optionally backfilled with
- * `initConnection` metadata, and then promoted to `validated` once their
- * effective `userID` is confirmed as valid. The manager also tracks which
- * validated connection currently serves as the group's background connection.
- */
-export declare class ConnectionContextManagerImpl implements ConnectionContextManager {
-    #private;
-    constructor(lc: LogContext, revalidateIntervalSeconds?: number, retransformIntervalSeconds?: number, queryConfig?: FetchConfig, pushConfig?: FetchConfig, validateLegacyJWT?: ValidateLegacyJWT, now?: () => number);
-    /**
-     * Creates or replaces the live record for a websocket connection.
-     *
-     * Re-registering the same `clientID` drops the old socket record and starts
-     * the replacement back in `provisional` state.
-     */
-    registerConnection(selector: ConnectionSelector, connectParams: ConnectParams, auth?: Auth): Readonly<ConnectionContext>;
-    /**
-     * Backfills `initConnection` data for sockets that were registered before the
-     * client could send its full init payload.
-     *
-     * This updates metadata only; it does not validate the connection.
-     */
-    initConnection(selector: ConnectionSelector, body: InitConnectionBody): Readonly<ConnectionContext>;
-    /**
-     * A material auth change demotes the connection back to provisional until it
-     * is validated again.
-     */
-    updateAuth(selector: ConnectionSelector, body: UpdateAuthBody): Promise<Readonly<ConnectionContext>>;
-    /**
-     * Validates one connection against the group's pinned `userID`.
-     *
-     * The first successful validation binds the group `userID`. Later
-     * validations must match it. Validation also refreshes the connection's
-     * revalidation deadline and may pick the connection as the group
-     * background connection if none is currently available. If the websocket is
-     * gone by the time async validation finishes, this becomes a no-op.
-     */
-    validateConnection(selector: ConnectionSelector, revision: number, validation: ConnectionValidation): Readonly<{
-        connection: ConnectionContext;
-        group: GroupAuthState;
-    }> | undefined;
-    /** Removes one connection due to failed auth and updates all derived background/deadline state. */
-    failConnection(selector: ConnectionSelector, revision: number): ConnectionContext | undefined;
-    /** Removes one disconnected connection and updates all derived background/deadline state. */
-    closeConnection(selector: ConnectionSelector): ConnectionContext | undefined;
-    /**
-     * Records a successful background retransform. This starts a fresh interval
-     * from the manager clock when shared retransform is schedulable, or
-     * clears the deadline if it is not.
-     */
-    markBackgroundRetransformSuccess(selector: ConnectionSelector, revision: number): void;
-    setSharedRetransformReady(ready: boolean): void;
-    deferMaintenance(kind: 'revalidate' | 'retransform'): void;
-    /** Returns the current live record for a client slot, if any. */
-    getConnectionContext(selector: ConnectionSelector): Readonly<ConnectionContext> | undefined;
-    /** Returns the live record for one websocket or throws if it is unavailable. */
-    mustGetConnectionContext(selector: ConnectionSelector): Readonly<ConnectionContext>;
-    /** Returns the current background connection, if one exists. */
-    getBackgroundConnectionContext(): Readonly<ConnectionContext> | undefined;
-    mustGetBackgroundConnectionContext(): Readonly<ConnectionContext>;
-    /** Returns the shared group auth state. */
-    getGroupState(): Readonly<GroupAuthState>;
-    /**
-     * Reports which maintenance work is currently due.
-     *
-     * The result is a pure snapshot: callers decide which actions to run and
-     * when to wake up next. `earliestDeadlineAt` is the earliest outstanding
-     * maintenance deadline, including overdue work, unless a transient failure
-     * has deferred all scheduled maintenance until `maintenanceNotBeforeAt`.
-     */
-    planMaintenance(): {
-        dueRevalidations: Readonly<ConnectionContext>[];
-        dueRetransform: boolean;
-        earliestDeadlineAt: number | undefined;
-    };
-}
-export {};
-//# sourceMappingURL=connection-context-manager.d.ts.map