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

package/out/zero-cache/src/services/change-streamer/change-log-initializer.d.ts

@@ -1,158 +0,0 @@
-/**
- * Where a stream connection's initialization parameters come from.
- *
- * A change-streamer starts a stream from three things read at one position: the
- * watermark to resume at, the {@link BackfillRequest}s to hand the change
- * source, and the cookie set those requests were derived from. Postgres has
- * always supplied all three (`Storer.getStartStreamInitializationParameters()`).
- * The point of this workstream is that a restored replica can supply them
- * instead, which is what lets the `cdc` schema be decommissioned.
- *
- * This is the two-source stage. Both are computed on every stream connection,
- * compared, and Postgres's is used — so the replica-derived path runs in
- * production, at full rate, before anything depends on it. The flip is
- * `initFromPgChangeLog: false`, not a rewrite.
- *
- * The shape is {@link UpstreamAcker}'s, deliberately: two stores, one output, a
- * flag per store, and the Postgres flag carrying the marker that retires it.
- * That class solved the identical problem for upstream ACKs earlier in this
- * workstream.
- *
- * ### Why the comparison is a fold and not an equality
- *
- * The replica is a subscriber downstream of the change-streamer's write loop,
- * so its state version trails the log's head by however long the replicator is
- * behind. A raw difference between the two cookie sets is therefore the normal
- * case and says nothing. What is checked instead is that the replica's set,
- * carried forward over exactly the schema changes the log holds in the interval,
- * equals Postgres's set at Postgres's watermark. The log holds precisely those
- * transactions, schema changes are rare, and the check is exact rather than
- * approximate — so it also happens to be the strongest available test of the
- * premise that three interpreters of one fold agree.
- */
-import type { LogContext } from '@rocicorp/logger';
-import { Database } from '../../../../zqlite/src/db.ts';
-import type { BackfillRequest } from '../change-source/protocol/current/upstream.ts';
-import { type CookieSet } from '../replicator/change-log-cookies.ts';
-import { type ChangeLogResumePoint } from '../replicator/change-log-db.ts';
-/** Everything one stream connection starts from, read at one position. */
-export type InitializationParameters = {
-    readonly lastWatermark: string;
-    readonly backfillRequests: BackfillRequest[];
-    readonly cookies: CookieSet;
-};
-/**
- * - `equal` — the two stores were at the same watermark and held the same
- *   cookies. Nothing had to be folded, which is the strongest of the four.
- * - `equal-after-fold` — the replica trailed, and carrying its set forward over
- *   the log's schema changes in the interval reproduced Postgres's exactly.
- *   The expected steady-state result.
- * - `divergent` — the two disagree at the same position. Alert; investigate
- *   individually.
- * - `inconclusive` — the log does not span the interval, so the fold cannot be
- *   performed. Routine on a cold log, and not a finding.
- * - `error` — the comparison itself failed: the replica could not be read, or
- *   the fold threw. Not one of the four classifications, because it is a
- *   statement about this process rather than about the two stores. Kept
- *   separate rather than folded into `inconclusive` so that a change-streamer
- *   that has silently stopped being able to read its replica is visible before
- *   that read becomes the only source.
- */
-export type InitComparisonResult = 'equal' | 'equal-after-fold' | 'divergent' | 'inconclusive' | 'error';
-export type ChangeLogInitializerSources = {
-    /** `Storer.getStartStreamInitializationParameters()`. */
-    readonly pgChangeLog: () => Promise<InitializationParameters>;
-    /** Typically {@link replicaInitializationSource}. */
-    readonly replica: () => InitializationParameters;
-    /**
-     * Reconciles the SQLite change log and returns its current resume point.
-     *
-     * When `resumeFrom` is present, it supplies the resume point. Otherwise, a
-     * valid log uses its own head. A new or invalid log uses `seed`.
-     *
-     * Returns `undefined` when the writer is disabled or unavailable.
-     */
-    readonly reconcileChangeLog: (resumeFrom: ChangeLogResumePoint | undefined, seed: () => ChangeLogResumePoint) => ChangeLogResumePoint | undefined;
-    /**
-     * The change log, for the fold. `undefined` before the stream loop's first
-     * reconcile has created it, and again once the writer has failed soft and
-     * deleted it — both of which make the comparison `inconclusive` rather than
-     * an error, since neither says anything about the two stores.
-     */
-    readonly changeLog: () => Database | undefined;
-    /**
-     * Re-initializes the Postgres change log from the replica's resume point
-     * (taking ownership of it) if it does not contain all of the replica's
-     * changes, re-checking under lock. Typically
-     * `Storer.reinitializeFromReplica()`.
-     *
-     * Supplied only when the change log's head is behind the position of the
-     * replication slot from which replication resumes, i.e. when it may be
-     * missing transactions that the slot will not stream. Otherwise, a replica
-     * that is ahead of the change log (as changes are forwarded before they are
-     * stored) is caught up by the change stream, which resumes from the change
-     * log's head.
-     */
-    readonly reinitializePgChangeLog?: ((params: {
-        watermark: string;
-        cookies: CookieSet;
-    }) => Promise<'reinitialized' | 'maintained'>) | undefined;
-};
-type Opts = {
-    /**
-     * When true, Postgres supplies the resume point and the cookies for a new
-     * change log.
-     *
-     * When false, a valid log resumes from its own head. The replica supplies the
-     * resume point for a new or invalid log.
-     */
-    readonly initFromPgChangeLog: boolean;
-    /**
-     * Derive the parameters from the replica. When Postgres is enabled, these
-     * parameters are used only for comparison.
-     *
-     * When Postgres is disabled, the replica supplies the seed and the fallback
-     * resume point.
-     */
-    readonly initFromReplica: boolean;
-};
-export declare class ChangeLogInitializer {
-    #private;
-    constructor(lc: LogContext, { initFromPgChangeLog, initFromReplica }: Opts, sources: ChangeLogInitializerSources);
-    /**
-     * Returns the comparison result from the most recent {@link initialize}
-     * call. Returns `undefined` when that call used only one source.
-     *
-     * Tests and metrics use this result. It does not affect initialization.
-     */
-    lastComparison(): InitComparisonResult | undefined;
-    /**
-     * Returns the initialization parameters for one stream connection after it
-     * reconciles the change log.
-     *
-     * The selected source determines how reconciliation works. Keeping both
-     * operations here hides that choice from the caller.
-     */
-    initialize(): Promise<InitializationParameters>;
-}
-/**
- * Reads the replica's initialization parameters in one snapshot, which is
- * invariant 15 on the replica side: the state version and the cookies are only
- * meaningful together.
- */
-export declare function readReplicaInitializationParameters(db: Database): InitializationParameters;
-/**
- * The replica source for {@link ChangeLogInitializer}, opening and closing the
- * file per stream connection rather than holding a handle on a database another
- * process owns.
- *
- * The handle is read-only, which is invariant 19 stated in the API: the
- * replica's cookie tables are written by the change-processor and by nothing
- * else. Note that a read-only SQLite connection still needs to attach the
- * WAL's `-shm`, so this can fail if it opens at a moment when no writer holds
- * the replica; that surfaces as the `error` classification, which is the point
- * of running the path under observation before anything depends on it.
- */
-export declare function replicaInitializationSource(lc: LogContext, replicaFile: string): () => InitializationParameters;
-export {};
-//# sourceMappingURL=change-log-initializer.d.ts.map

package/out/zero-cache/src/services/change-streamer/change-log-initializer.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"change-log-initializer.d.ts","sourceRoot":"","sources":["../../../../../../zero-cache/src/services/change-streamer/change-log-initializer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,kBAAkB,CAAC;AAIjD,OAAO,EAAC,QAAQ,EAAC,MAAM,8BAA8B,CAAC;AAKtD,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,+CAA+C,CAAC;AACnF,OAAO,EAGL,KAAK,SAAS,EACf,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,gCAAgC,CAAC;AAQxC,0EAA0E;AAC1E,MAAM,MAAM,wBAAwB,GAAG;IACrC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,gBAAgB,EAAE,eAAe,EAAE,CAAC;IAC7C,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC;CAC7B,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,MAAM,oBAAoB,GAC5B,OAAO,GACP,kBAAkB,GAClB,WAAW,GACX,cAAc,GACd,OAAO,CAAC;AAEZ,MAAM,MAAM,2BAA2B,GAAG;IACxC,yDAAyD;IACzD,QAAQ,CAAC,WAAW,EAAE,MAAM,OAAO,CAAC,wBAAwB,CAAC,CAAC;IAC9D,qDAAqD;IACrD,QAAQ,CAAC,OAAO,EAAE,MAAM,wBAAwB,CAAC;IACjD;;;;;;;OAOG;IACH,QAAQ,CAAC,kBAAkB,EAAE,CAC3B,UAAU,EAAE,oBAAoB,GAAG,SAAS,EAC5C,IAAI,EAAE,MAAM,oBAAoB,KAC7B,oBAAoB,GAAG,SAAS,CAAC;IACtC;;;;;OAKG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,QAAQ,GAAG,SAAS,CAAC;IAC/C;;;;;;;;;;;;OAYG;IACH,QAAQ,CAAC,uBAAuB,CAAC,EAC7B,CAAC,CAAC,MAAM,EAAE;QACR,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,SAAS,CAAC;KACpB,KAAK,OAAO,CAAC,eAAe,GAAG,YAAY,CAAC,CAAC,GAC9C,SAAS,CAAC;CACf,CAAC;AAEF,KAAK,IAAI,GAAG;IACV;;;;;;OAMG;IAEH,QAAQ,CAAC,mBAAmB,EAAE,OAAO,CAAC;IACtC;;;;;;OAMG;IACH,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;CACnC,CAAC;AAcF,qBAAa,oBAAoB;;IAqB/B,YACE,EAAE,EAAE,UAAU,EACd,EAAC,mBAAmB,EAAE,eAAe,EAAC,EAAE,IAAI,EAC5C,OAAO,EAAE,2BAA2B,EAUrC;IAED;;;;;OAKG;IACH,cAAc,IAAI,oBAAoB,GAAG,SAAS,CAEjD;IAED;;;;;;OAMG;IACG,UAAU,IAAI,OAAO,CAAC,wBAAwB,CAAC,CAqCpD;CA2JF;AAUD;;;;GAIG;AACH,wBAAgB,mCAAmC,CACjD,EAAE,EAAE,QAAQ,GACX,wBAAwB,CAc1B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,2BAA2B,CACzC,EAAE,EAAE,UAAU,EACd,WAAW,EAAE,MAAM,GAClB,MAAM,wBAAwB,CAahC"}

package/out/zero-cache/src/services/change-streamer/change-log-transaction-hash.d.ts

@@ -1,19 +0,0 @@
-export type ChangeLogHashRow = {
-    readonly watermark: string;
-    readonly pos: number;
-    readonly tag: string;
-    readonly change: string;
-    readonly precommit: string | null;
-};
-/**
- * Computes a stable digest over the fields shared by the Postgres and SQLite
- * change logs. Values are length-prefixed so different field boundaries cannot
- * produce the same byte stream.
- */
-export declare class ChangeLogTransactionHasher {
-    #private;
-    constructor();
-    add(row: ChangeLogHashRow): void;
-    digest(): string;
-}
-//# sourceMappingURL=change-log-transaction-hash.d.ts.map

package/out/zero-cache/src/services/change-streamer/change-log-transaction-hash.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"change-log-transaction-hash.d.ts","sourceRoot":"","sources":["../../../../../../zero-cache/src/services/change-streamer/change-log-transaction-hash.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC,CAAC;AAEF;;;;GAIG;AACH,qBAAa,0BAA0B;;IAGrC,cAGC;IAED,GAAG,CAAC,GAAG,EAAE,gBAAgB,GAAG,IAAI,CAW/B;IAED,MAAM,IAAI,MAAM,CAEf;CACF"}

package/out/zero-cache/src/services/change-streamer/change-streamer-http.d.ts

@@ -1,78 +0,0 @@
-import type { IncomingMessage } from 'node:http';
-import type { LogContext } from '@rocicorp/logger';
-import type { NormalizedZeroConfig } from '../../config/normalize.ts';
-import { type Worker } from '../../types/processes.ts';
-import { type ShardID } from '../../types/shards.ts';
-import { type Sized, type Source } from '../../types/streams.ts';
-import { Subscription } from '../../types/subscription.ts';
-import { HttpService, type Options as HttpOptions } from '../http-service.ts';
-import { type ChangeStreamer, type ChangeStreamerService, type SubscriberContext } from './change-streamer.ts';
-import { type LocalReplica, type SnapshotStatus, type SubscribeDownstream, type SubscribeUpstream } from './subscribe.ts';
-type Options = HttpOptions & {
-    startupDelayMs: number;
-    config?: Pick<NormalizedZeroConfig, 'adminPassword' | 'operatorPassword'> | undefined;
-    getProfileWorker?: (() => Promise<Worker>) | undefined;
-};
-export declare class ChangeStreamerHttpServer extends HttpService {
-    #private;
-    readonly id = "change-streamer-http-server";
-    constructor(lc: LogContext, opts: Options, parent: Worker, changeStreamer: ChangeStreamerService);
-    protected _onStart(): void;
-    /**
-     * Signals (drainable) subscribers to switch over to another
-     * replication-manager, resolving when they have disconnected. Subscribers
-     * continue to be served in the meantime, but new connections (e.g.
-     * switchover attempts, reconnects, and snapshot reservations) are refused,
-     * so that they are routed to another replication-manager.
-     */
-    drain(): Promise<void>;
-    protected _onStop(): Promise<void>;
-}
-export interface SnapshotReserver {
-    reserveSnapshot(taskID: string, localReplica?: LocalReplica | undefined): Promise<{
-        reserved: SnapshotStatus;
-        followup: ReservationFollowup;
-    }>;
-}
-export interface SubscriptionStarter {
-    subscribe(ctx: SubscriberContext): Promise<Source<Sized<SubscribeDownstream>>>;
-}
-export interface ReservationFollowup extends SubscriptionStarter {
-    /**
-     * A signal to indicate that the followup is no longer valid (i.e. the
-     * connection to the reserving task has been severed).
-     */
-    readonly signal: AbortSignal;
-    /**
-     * Abandons the reservation without subscribing, closing the connection that
-     * was held open to pin the change-log floor. Used when the caller cannot
-     * proceed to `subscribe()` (e.g. process shutdown while a restore is in
-     * progress) and must not leave the reservation's connection open forever.
-     */
-    cancel(reason?: Error): void;
-}
-export declare class ChangeStreamerHttpClient implements ChangeStreamer, SnapshotReserver, SubscriptionStarter {
-    #private;
-    constructor(lc: LogContext, shardID: ShardID, changeDB: string, changeStreamerURI: string | undefined);
-    reserveSnapshot(taskID: string, localReplica?: LocalReplica | undefined): Promise<{
-        reserved: SnapshotStatus;
-        followup: ReservationFollowup;
-    }>;
-    subscribe(ctx: SubscriberContext): Promise<Source<Sized<SubscribeDownstream>>>;
-    /**
-     * Opens a merged v7 `/subscribe` connection (see subscribe.ts). Returns the
-     * inbound change/reservation stream and an `outbound` sink into which the
-     * caller pushes the `reserve-snapshot` / `start-subscription` control
-     * messages that drive the connection's phases. The single connection spans
-     * the reservation, backup restore, and subscription, so the reserving
-     * replication-manager is the one that serves the subscription.
-     */
-    connect(taskID: string): Promise<{
-        instream: Source<Sized<SubscribeDownstream>>;
-        outbound: Subscription<SubscribeUpstream>;
-    }>;
-}
-type RequestHeaders = Pick<IncomingMessage, 'url' | 'headers'>;
-export declare function getSubscriberContext(req: RequestHeaders): SubscriberContext;
-export {};
-//# sourceMappingURL=change-streamer-http.d.ts.map

package/out/zero-cache/src/services/change-streamer/change-streamer-http.d.ts.map

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

package/out/zero-cache/src/services/change-streamer/change-streamer-service.d.ts

@@ -1,152 +0,0 @@
-import type { LogContext } from '@rocicorp/logger';
-import type { PostgresDB } from '../../types/pg.ts';
-import type { ShardID } from '../../types/shards.ts';
-import type { ChangeSource } from '../change-source/change-source.ts';
-import type { LitestreamVersion } from '../litestream/metrics.ts';
-import { type ReplicationStatusPublisher } from '../replicator/replication-status.ts';
-import type { SubscriptionState } from '../replicator/schema/replication-state.ts';
-import type { BackupSource } from './backup-monitor.ts';
-import { type ChangeStreamerService, type SubscriberContext } from './change-streamer.ts';
-import { type SQLiteChangeLogCleanupGuard } from './sqlite-change-log-catchup.ts';
-import { type SQLiteChangeLogCompareOptions } from './sqlite-change-log-comparator.ts';
-import { type SQLiteChangeLogPurgeSchedulerOptions } from './sqlite-change-log-purge-scheduler.ts';
-import { type SQLiteChangeLogCoverage } from './sqlite-change-log-read-router.ts';
-import { type SQLiteChangeLogWriterOptions } from './sqlite-change-log-writer.ts';
-import { type PurgeLock, type TuningOptions as StorerOptions } from './storer.ts';
-export type BackupConfig = {
-    backupURL: string;
-    litestreamVersion: LitestreamVersion;
-    /**
-     * The replica being backed up. Its size is sent to subscribers as an
-     * estimate of the size of their restored replica.
-     */
-    replicaFile?: string | undefined;
-};
-export type SQLiteCatchupOptions = {
-    /** The change-log database, i.e. `changeLogFileName(replicaFile)`. */
-    changeLogFile: string;
-    readBatchRows: number;
-    barrierTimeoutMs: number;
-    /**
-     * Backstop for the change-log writer's ACK, which is what normally releases
-     * the barrier. Defaults to the catchup coordinator's interval.
-     */
-    barrierPollIntervalMs?: number | undefined;
-    /**
-     * Optional policy hook used by focused tests. Production canary selection is
-     * supplied by `sqliteChangeLogServe` and is stable by shard plus task ID.
-     * Backup subscribers are rejected before either selector is invoked.
-     */
-    shouldUse?: ((ctx: SubscriberContext) => boolean) | undefined;
-    /**
-     * Overrides the purge scheduler's guard, for tests. When absent, the
-     * service supplies the scheduler's real writer-serialized guard, or the
-     * catchup's no-op default when purging is not configured.
-     */
-    cleanupGuard?: SQLiteChangeLogCleanupGuard | undefined;
-    /**
-     * How long the change log may be unavailable before declining to serve from
-     * it is reported as a warning rather than a debug line. Defaults to
-     * {@link DEFAULT_CHANGE_LOG_UNAVAILABLE_WARN_THRESHOLD_MS}.
-     */
-    notReadyWarnThresholdMs?: number | undefined;
-};
-export type SQLiteChangeLogServeOptions = {
-    /** Stable percentage of eligible serving tasks routed to SQLite. */
-    readPercent: number;
-    /**
-     * Stable percentage of eligible serving tasks routed to a log that has not
-     * yet aged through {@link retentionMs}. Zero keeps a reseeded log on PG for
-     * that whole window; above zero it serves that share of tasks, and a
-     * reservation it cannot cover is demoted rather than held pending.
-     * Defaults to zero.
-     */
-    coldReadPercent?: number | undefined;
-    /** The warm-up window a reseeded log ages through. */
-    retentionMs: number;
-    /** Injectable for deterministic breaker tests. */
-    failureCooldownMs?: number | undefined;
-    /** Injectable for deterministic warm-up and breaker tests. */
-    now?: (() => number) | undefined;
-    /** Injectable readiness inspection for service-level tests. */
-    inspect?: (() => SQLiteChangeLogCoverage | undefined) | undefined;
-};
-export type TuningOptions = StorerOptions & {
-    /**
-     * Whether the PG change log's head was behind the position of the
-     * replication slot from which replication resumes, in which case the
-     * change log is re-initialized from the (restored) replica if it does not
-     * contain all of the replica's changes (see `PgChangeLogPurgeLocker`).
-     *
-     * Required so that a caller cannot silently drop it: without it, the
-     * stream resumes from a head that the slot cannot stream from, skipping
-     * transactions.
-     */
-    pgChangeLogBehindSlot: boolean;
-    flowControlConsensusTimeoutProportion: number;
-    flowControlSlowSubscriberGracePeriodMs?: number | undefined;
-    /**
-     * The target number of subscribers that may be replacing their replica at
-     * the same time, which limits when subscribers switching over from an
-     * incompatible replication-manager are granted permission to restart (see
-     * {@link RestoreAdmission}). Defaults to 1. Only applicable when backups
-     * are configured.
-     */
-    maxConcurrentSwitchoverRestores?: number | undefined;
-    /**
-     * The time for which a replacing subscriber continues to count towards
-     * {@link maxConcurrentSwitchoverRestores} after it has caught up, to allow
-     * it to start serving (see {@link RestoreAdmission}).
-     */
-    switchoverRestoreReadinessGracePeriodMs?: number | undefined;
-    sqliteCatchup?: SQLiteCatchupOptions | undefined;
-    /**
-     * Supplied when `sqliteChangeLogMode != off`, i.e. this is the gate on the
-     * change-log writer. Absent, nothing writes the log.
-     */
-    sqliteChangeLogWriter?: Omit<SQLiteChangeLogWriterOptions, 'onCommit' | 'onDisabled' | 'onRebuilt'> | undefined;
-    /**
-     * Also supplied when `sqliteChangeLogMode != off`, and deliberately not
-     * gated on the read path: in `write` mode no reader ever opens, and this is
-     * the configuration the purge scheduler actually ships in. The scheduler
-     * runs on the writer's own connection, so with the writer absent (mode
-     * `off`) it is never constructed, and a leftover file on disk is left to
-     * the replicator's cleanup.
-     */
-    sqliteChangeLogPurge?: SQLiteChangeLogPurgeSchedulerOptions | undefined;
-    /**
-     * Supplied in `compare` mode and later modes.
-     * `replicaFile` enables the initialization comparison.
-     * The other fields configure sampled catchup comparisons.
-     * Both checks are advisory, and Postgres remains authoritative.
-     * The comparator also requires the writer and catchup options.
-     */
-    sqliteChangeLogCompare?: (SQLiteChangeLogCompareOptions & {
-        replicaFile: string;
-    }) | undefined;
-    /** Supplied only in `serve` mode. A zero percentage keeps every read on PG. */
-    sqliteChangeLogServe?: SQLiteChangeLogServeOptions | undefined;
-    /**
-     * The source of backed-up watermarks (i.e. the `BackupMonitor`), which the
-     * change-streamer tracks from construction, and from which it requests
-     * prompt backups when the change source asks for them (e.g. for a replica
-     * fork). Its lifecycle (e.g. the monitor's run() and stop()) is managed by
-     * the caller. Absent, no backups are tracked.
-     */
-    backupMonitor?: BackupSource | undefined;
-};
-/**
- * Performs initialization and schema migrations to initialize a ChangeStreamerImpl.
- */
-export declare function initializeStreamer(lc: LogContext, shard: ShardID, taskID: string, discoveryAddress: string, discoveryProtocol: string, 
-/**
- * The database of the legacy Postgres change log, or `null` if the PG
- * change log is disabled, in which case no connections are made to it.
- *
- * The PG change log keeps the legacy Postgres change log on the
- * initialization, persistence, catchup, purge, and ACK paths. Disable it
- * only after SQLite and the replica backup are authoritative for all of
- * those responsibilities.
- */
-changeDB: PostgresDB | null, changeSource: ChangeSource, replicationStatusPublisher: ReplicationStatusPublisher, subscriptionState: SubscriptionState, backupConfig: BackupConfig | null, purgeLock: PurgeLock | null, autoReset: boolean, opts: TuningOptions, setTimeoutFn?: typeof setTimeout): Promise<ChangeStreamerService>;
-//# sourceMappingURL=change-streamer-service.d.ts.map

package/out/zero-cache/src/services/change-streamer/change-streamer-service.d.ts.map

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