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

package/out/zero-events/src/index.d.ts

@@ -1,27 +0,0 @@
-/**
- * All ZeroEvents are routed via CloudEvents frameworks. The `type`
- * and `time` fields of ZeroEvents are directly used for the corresponding
- * fields in the CloudEvent, while the entire ZeroEvent object is set as the
- * `data` field.
- *
- * The CloudEvent `type` field can thus be used to filter events and/or parse
- * their corresponding subtypes.
- */
-export interface ZeroEvent {
-    /**
-     * Identifies the event type across all components.
-     *
-     * When published as a CloudEvent, this values is also used for the "type"
-     * field of the outer event object.
-     */
-    type: string;
-    /**
-     * The time that the status event was emitted, in ISO 8601 format. Later
-     * statuses override earlier ones.
-     *
-     * When published as a CloudEvent, this value is also used for the "time"
-     * field of the outer event object.
-     */
-    time: string;
-}
-//# sourceMappingURL=index.d.ts.map

package/out/zero-events/src/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../zero-events/src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,WAAW,SAAS;IACxB;;;;;OAKG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;;;;OAMG;IACH,IAAI,EAAE,MAAM,CAAC;CACd"}

package/out/zero-events/src/json.d.ts

@@ -1,20 +0,0 @@
-/** The values that can be represented in JSON */
-export type JSONValue = null | string | boolean | number | Array<JSONValue> | JSONObject;
-/**
- * A JSON object. This is a map from strings to JSON values or `undefined`. We
- * allow `undefined` values as a convenience... but beware that the `undefined`
- * values do not round trip to the server. For example:
- *
- * ```
- * // Time t1
- * await tx.set('a', {a: undefined});
- *
- * // time passes, in a new transaction
- * const v = await tx.get('a');
- * console.log(v); // either {a: undefined} or {}
- * ```
- */
-export type JSONObject = {
-    [key: string]: JSONValue | undefined;
-};
-//# sourceMappingURL=json.d.ts.map

package/out/zero-events/src/json.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../../../../zero-events/src/json.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,MAAM,MAAM,SAAS,GACjB,IAAI,GACJ,MAAM,GACN,OAAO,GACP,MAAM,GACN,KAAK,CAAC,SAAS,CAAC,GAChB,UAAU,CAAC;AAEf;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,UAAU,GAAG;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAAA;CAAC,CAAC"}

package/out/zero-events/src/status.d.ts

@@ -1,144 +0,0 @@
-import type { ZeroEvent } from './index.ts';
-import type { JSONObject } from './json.ts';
-export type Status = 'OK' | 'ERROR';
-export declare const ZERO_STATUS_EVENT_PREFIX = "zero/events/status/";
-/**
- * A StatusEvent conveys the most current status of a given component,
- * with each event replacing any preceding status events (based on the
- * `time` field) for the same component.
- *
- * All StatusEvents have a `type` value that starts with `zero/events/status/`,
- * with common fields (e.g. `stage`, `description`, `errorDetails`) that can
- * be used to describe the state of any component even if the specific subtype
- * is not known. In this respect, an event consumer can subscribe to
- * "zero/events/status/*" and display general status information without
- * needing to understand subtype-specific fields.
- */
-export interface StatusEvent extends ZeroEvent {
-    type: `${typeof ZERO_STATUS_EVENT_PREFIX}${string}`;
-    /**
-     * The component of the zero-cache to which the event pertains,
-     * e.g. "replication".
-     */
-    component: string;
-    /** Whether the component is healthy. */
-    status: Status;
-    /**
-     * The stage describing the component's current state. This is meant to be
-     * both machine and human readable (e.g. a single work serving as a well-known
-     * constant).
-     */
-    stage: string;
-    /**
-     * An optional, human readable description.
-     */
-    description?: string | undefined;
-    /** Structured data describing the state of the component. */
-    state?: JSONObject | undefined;
-    /** Error details should be supplied for an 'ERROR' status message. */
-    errorDetails?: JSONObject | undefined;
-}
-export type ReplicatedColumn = {
-    column: string;
-    upstreamType: string;
-    clientType: string | null;
-};
-export type ReplicatedTable = {
-    table: string;
-    columns: ReplicatedColumn[];
-};
-export type IndexedColumn = {
-    column: string;
-    dir: 'ASC' | 'DESC';
-};
-export type ReplicatedIndex = {
-    /**
-     * The name of the index in the replica, which is that of the upstream
-     * index, qualified by its schema outside of `public`. Absent from the
-     * events of older versions of zero-cache.
-     */
-    name?: string | undefined;
-    table: string;
-    columns: IndexedColumn[];
-    unique: boolean;
-};
-export type DownloadStatus = {
-    table: string;
-    columns: string[];
-    totalRows: number;
-    totalBytes?: number | undefined;
-    rows: number;
-};
-/**
- * Progress of index creation, reported while an index is being built
- * (e.g. during initial sync, or when an index is created on an existing
- * table during replication).
- */
-export type IndexingStatus = {
-    /** The name of the index currently being created. */
-    name: string;
-    table: string;
-    columns: string[];
-    unique: boolean;
-    /** The 1-based position of the current index. */
-    index: number;
-    /**
-     * The total number of indexes to create. This is `undefined` when the
-     * total is not known in advance (e.g. during replication).
-     */
-    totalIndexes?: number | undefined;
-    /** Milliseconds spent so far creating the current index. */
-    elapsedMs: number;
-    /** Milliseconds spent creating the preceding (completed) indexes. */
-    completedMs: number;
-    /** Whether creation of the current index has completed. */
-    done: boolean;
-};
-export type ReplicationState = {
-    tables: ReplicatedTable[];
-    indexes: ReplicatedIndex[];
-    replicaSize?: number | undefined;
-    downloadStatus?: DownloadStatus[] | undefined;
-    indexingStatus?: IndexingStatus | undefined;
-};
-export type ReplicationStage = 'Initializing' | 'Indexing' | 'Replicating';
-export declare const REPLICATION_STATUS_EVENT_V1_TYPE = "zero/events/status/replication/v1";
-export interface ReplicationStatusEvent extends StatusEvent {
-    type: typeof REPLICATION_STATUS_EVENT_V1_TYPE;
-    component: 'replication';
-    stage: ReplicationStage;
-    state?: ReplicationState;
-}
-/**
- * Progress of a view-syncer restoring its replica from the
- * replication-manager's backup.
- */
-export type RestoreStatus = {
-    /** Bytes of the replica written so far. */
-    bytes: number;
-    /**
-     * The estimated size of the restored replica, taken from the size of the
-     * replication-manager's replica when it handed out the backup. This is
-     * `undefined` when the replication-manager does not report it.
-     */
-    totalBytes?: number | undefined;
-    /** Milliseconds spent so far restoring the replica. */
-    elapsedMs: number;
-};
-export type ViewSyncerState = {
-    restoreStatus?: RestoreStatus | undefined;
-};
-/**
- * - `Restoring`: the replica is being restored from the backup.
- * - `Restored`: the replica has been restored and the view-syncer is
- *   starting up.
- */
-export type ViewSyncerStage = 'Restoring' | 'Restored';
-export declare const VIEW_SYNCER_STATUS_EVENT_V1_TYPE = "zero/events/status/view-syncer/v1";
-export interface ViewSyncerStatusEvent extends StatusEvent {
-    type: typeof VIEW_SYNCER_STATUS_EVENT_V1_TYPE;
-    component: 'view-syncer';
-    stage: ViewSyncerStage;
-    state?: ViewSyncerState;
-}
-//# sourceMappingURL=status.d.ts.map

package/out/zero-events/src/status.d.ts.map

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

package/out/zqlite/src/database-storage.d.ts

@@ -1,43 +0,0 @@
-import type { LogContext } from '@rocicorp/logger';
-import type { Storage } from '../../zql/src/ivm/operator.ts';
-import { Database } from './db.ts';
-export interface ClientGroupStorage {
-    /** Creates a {@link Storage} instance for a single operator. */
-    createStorage(): Storage;
-    /** Deletes all storage for the client group. */
-    destroy(): void;
-}
-export declare const CREATE_STORAGE_TABLE = "\n  CREATE TABLE storage (\n    clientGroupID TEXT,\n    op NUMBER,\n    key TEXT,\n    val TEXT,\n    PRIMARY KEY(clientGroupID, op, key)\n  )\n  ";
-export type DatabaseStorageOptions = {
-    commitInterval?: number | undefined;
-    compactionThresholdBytes?: number | undefined;
-    /**
-     * The most heap bytes, as estimated from {@link getSizeOfEntry}, that the
-     * operators of all client groups keep in memory before the least recently
-     * used ones spill to SQLite. 0, the default, keeps every operator's values
-     * in SQLite.
-     */
-    maxMemoryBytes?: number | undefined;
-};
-/**
- * Operator storage for the client groups of a sync worker.
- *
- * Each operator keeps its values in a `Map`, so reading a key that was never
- * written does not ask SQLite. When the values of all of the operators go
- * over `maxMemoryBytes`, the least recently used operators spill: their
- * values are written to SQLite, where they stay until the operator is
- * destroyed.
- *
- * Like `MemoryStorage`, `get` returns the stored value itself, which
- * operators do not mutate.
- */
-export declare class DatabaseStorage {
-    #private;
-    static create(lc: LogContext, path: string, options?: DatabaseStorageOptions): DatabaseStorage;
-    constructor(db: Database, options?: DatabaseStorageOptions);
-    close(): void;
-    /** The estimated size of the values that operators keep in memory. */
-    get memoryBytes(): number;
-    createClientGroupStorage(cgID: string): ClientGroupStorage;
-}
-//# sourceMappingURL=database-storage.d.ts.map

package/out/zqlite/src/database-storage.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"database-storage.d.ts","sourceRoot":"","sources":["../../../../zqlite/src/database-storage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,kBAAkB,CAAC;AAIjD,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,+BAA+B,CAAC;AAG3D,OAAO,EAAC,QAAQ,EAAC,MAAM,SAAS,CAAC;AAEjC,MAAM,WAAW,kBAAkB;IACjC,gEAAgE;IAChE,aAAa,IAAI,OAAO,CAAC;IAEzB,gDAAgD;IAChD,OAAO,IAAI,IAAI,CAAC;CACjB;AAcD,eAAO,MAAM,oBAAoB,wJAQ9B,CAAC;AAsBJ,MAAM,MAAM,sBAAsB,GAAG;IACnC,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,wBAAwB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9C;;;;;OAKG;IACH,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACrC,CAAC;AA4CF;;;;;;;;;;;GAWG;AACH,qBAAa,eAAe;;IAC1B,MAAM,CAAC,MAAM,CACX,EAAE,EAAE,UAAU,EACd,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,sBAA2B,GACnC,eAAe,CAiBjB;IAgBD,YAAY,EAAE,EAAE,QAAQ,EAAE,OAAO,GAAE,sBAA2B,EAgD7D;IAED,KAAK,SAGJ;IAED,sEAAsE;IACtE,IAAI,WAAW,IAAI,MAAM,CAExB;IA+KD,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,CAoCzD;CACF"}

package/out/zqlite/src/explain-queries.d.ts

@@ -1,4 +0,0 @@
-import type { RowCountsBySource } from '../../zero-protocol/src/analyze-query-result.ts';
-import type { Database } from './db.ts';
-export declare function explainQueries(counts: RowCountsBySource, db: Database): Record<string, string[]>;
-//# sourceMappingURL=explain-queries.d.ts.map

package/out/zqlite/src/explain-queries.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"explain-queries.d.ts","sourceRoot":"","sources":["../../../../zqlite/src/explain-queries.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,iDAAiD,CAAC;AACvF,OAAO,KAAK,EAAC,QAAQ,EAAC,MAAM,SAAS,CAAC;AAEtC,wBAAgB,cAAc,CAAC,MAAM,EAAE,iBAAiB,EAAE,EAAE,EAAE,QAAQ,4BAiBrE"}

package/out/zqlite/src/internal/sql-inline.d.ts

@@ -1,13 +0,0 @@
-import type { SQLQuery } from '@databases/sql';
-/**
- * Compiles a SQL query with values inlined directly into the SQL string.
- *
- * WARNING: This should ONLY be used for cost estimation in the query planner.
- * Never use this for user-facing queries - always use the standard `compile()`
- * function from sql.ts which uses parameterized queries.
- *
- * @param sql The SQL query to compile
- * @returns SQL string with values inlined
- */
-export declare function compileInline(sql: SQLQuery): string;
-//# sourceMappingURL=sql-inline.d.ts.map

package/out/zqlite/src/internal/sql-inline.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"sql-inline.d.ts","sourceRoot":"","sources":["../../../../../zqlite/src/internal/sql-inline.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAC,QAAQ,EAAC,MAAM,gBAAgB,CAAC;AAmE7C;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,QAAQ,GAAG,MAAM,CAEnD"}

package/out/zqlite/src/resolve-scalar-subqueries.d.ts

@@ -1,72 +0,0 @@
-import type { AST, Condition, LiteralValue, System } from '../../zero-protocol/src/ast.ts';
-import type { PrimaryKey } from '../../zero-protocol/src/primary-key.ts';
-type TableSpecWithUniqueKeys = {
-    tableSpec: {
-        uniqueKeys: PrimaryKey[];
-    };
-};
-export type CompanionSubquery = {
-    /** The original scalar subquery AST (the subquery table query). */
-    ast: AST;
-    /** The field in the subquery row whose value was resolved. */
-    childField: string;
-    /** The system that added the gate. */
-    system: System | undefined;
-    /** The resolved value, `null` if a row matched but the field was `NULL`,
-     * or `undefined` if no row matched. */
-    resolvedValue: LiteralValue | null | undefined;
-};
-/**
- * A `scalar` hint that could not be honored: the subquery was not provably
- * limited to one row, so the gate was left as a plain EXISTS.
- */
-export type IgnoredScalarHint = {
-    /** The subquery's table. */
-    table: string;
-    /** The unique keys that were available to pin it. */
-    uniqueKeys: readonly PrimaryKey[];
-};
-export type ResolveResult = {
-    ast: AST;
-    companions: CompanionSubquery[];
-    /**
-     * Hints the caller may want to surface: each one is a `{scalar: true}` the
-     * author asked for and did not get. See {@link IgnoredScalarHint}.
-     */
-    ignoredScalarHints: IgnoredScalarHint[];
-};
-/**
- * Callback that executes a scalar subquery and returns the value of
- * `childField` from the (at most one) matching row, or `undefined`
- * if no rows match.
- */
-export type ScalarExecutor = (subqueryAST: AST, childField: string) => LiteralValue | null | undefined;
-/**
- * Resolves "simple" scalar subqueries by calling the provided executor
- * and replacing them with literal conditions. A scalar subquery is simple
- * when all columns of at least one unique index on the subquery table are
- * equality-constrained by literal values in the subquery's WHERE clause
- * (using only AND conjunctions).
- *
- * Non-simple scalar subqueries are left untouched for the existing
- * EXISTS rewrite in buildPipelineInternal.
- *
- * Returns the resolved AST and a list of companion subquery ASTs whose
- * rows need to be synced to the client for the EXISTS rewrite to work.
- */
-export declare function resolveSimpleScalarSubqueries(ast: AST, tableSpecs: Map<string, TableSpecWithUniqueKeys>, execute: ScalarExecutor): ResolveResult;
-/**
- * Checks if the subquery is guaranteed to return at most one deterministic row.
- *
- * This is true when all columns of at least one unique index on the subquery
- * table are equality-constrained by literal values in the WHERE clause
- * (using only AND conjunctions).
- */
-export declare function isSimpleSubquery(subquery: AST, tableSpecs: Map<string, TableSpecWithUniqueKeys>): boolean;
-/**
- * Extracts column=literal equality constraints from a condition tree,
- * only following AND conjunctions (not OR).
- */
-export declare function extractLiteralEqualityConstraints(condition: Condition): Map<string, LiteralValue>;
-export {};
-//# sourceMappingURL=resolve-scalar-subqueries.d.ts.map

package/out/zqlite/src/resolve-scalar-subqueries.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"resolve-scalar-subqueries.d.ts","sourceRoot":"","sources":["../../../../zqlite/src/resolve-scalar-subqueries.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,GAAG,EACH,SAAS,EAET,YAAY,EAEZ,MAAM,EACP,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,wCAAwC,CAAC;AAEvE,KAAK,uBAAuB,GAAG;IAC7B,SAAS,EAAE;QACT,UAAU,EAAE,UAAU,EAAE,CAAC;KAC1B,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,mEAAmE;IACnE,GAAG,EAAE,GAAG,CAAC;IACT,8DAA8D;IAC9D,UAAU,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B;2CACuC;IACvC,aAAa,EAAE,YAAY,GAAG,IAAI,GAAG,SAAS,CAAC;CAChD,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,qDAAqD;IACrD,UAAU,EAAE,SAAS,UAAU,EAAE,CAAC;CACnC,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,GAAG,EAAE,GAAG,CAAC;IACT,UAAU,EAAE,iBAAiB,EAAE,CAAC;IAChC;;;OAGG;IACH,kBAAkB,EAAE,iBAAiB,EAAE,CAAC;CACzC,CAAC;AAQF;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,CAC3B,WAAW,EAAE,GAAG,EAChB,UAAU,EAAE,MAAM,KACf,YAAY,GAAG,IAAI,GAAG,SAAS,CAAC;AAErC;;;;;;;;;;;;GAYG;AACH,wBAAgB,6BAA6B,CAC3C,GAAG,EAAE,GAAG,EACR,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,uBAAuB,CAAC,EAChD,OAAO,EAAE,cAAc,GACtB,aAAa,CAIf;AAgJD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,GAAG,EACb,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,uBAAuB,CAAC,GAC/C,OAAO,CAiBT;AAED;;;GAGG;AACH,wBAAgB,iCAAiC,CAC/C,SAAS,EAAE,SAAS,GACnB,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAI3B"}

package/out/zqlite/src/sqlite-cost-model.d.ts

@@ -1,17 +0,0 @@
-import type { SchemaValue } from '../../zero-types/src/schema-value.ts';
-import type { ConnectionCostModel } from '../../zql/src/planner/planner-connection.ts';
-import type { Database } from './db.ts';
-/**
- * Creates a SQLite-based cost model for query planning.
- * Uses SQLite's scanstatus API to estimate query costs based on the actual
- * SQLite query planner's analysis.
- *
- * @param db Database instance for preparing statements
- * @param tableSpecs Map of table names to their table specs with ZQL schemas
- * @returns ConnectionCostModel function for use with the planner
- */
-export declare function createSQLiteCostModel(db: Database, tableSpecs: Map<string, {
-    zqlSpec: Record<string, SchemaValue>;
-}>): ConnectionCostModel;
-export declare function btreeCost(rows: number): number;
-//# sourceMappingURL=sqlite-cost-model.d.ts.map

package/out/zqlite/src/sqlite-cost-model.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"sqlite-cost-model.d.ts","sourceRoot":"","sources":["../../../../zqlite/src/sqlite-cost-model.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,sCAAsC,CAAC;AAEtE,OAAO,KAAK,EAEV,mBAAmB,EAEpB,MAAM,6CAA6C,CAAC;AAErD,OAAO,KAAK,EAAC,QAAQ,EAAY,MAAM,SAAS,CAAC;AAmBjD;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CACnC,EAAE,EAAE,QAAQ,EACZ,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE;IAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAA;CAAC,CAAC,GAC9D,mBAAmB,CAgErB;AA8JD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAK9C"}

package/out/zqlite/src/sqlite-stat-fanout.d.ts

@@ -1,121 +0,0 @@
-import type { Database } from './db.ts';
-/**
- * Result of fanout calculation from SQLite statistics.
- */
-export interface FanoutResult {
-    /**
-     * The fanout value (average rows per distinct value of the join column).
-     * For non-NULL joins, this represents how many child rows exist per parent key.
-     */
-    fanout: number;
-    confidence: 'high' | 'med' | 'none';
-    /**
-     * Source of the fanout calculation.
-     * - 'stat4': From sqlite_stat4 histogram (most accurate, excludes NULLs)
-     * - 'stat1': From sqlite_stat1 average (includes NULLs, may overestimate)
-     * - 'default': Fallback constant when statistics unavailable
-     */
-    source: 'stat4' | 'stat1' | 'default';
-}
-/**
- * Computes join fanout factors from SQLite statistics tables.
- *
- * Fanout is the average number of child rows per distinct parent key value,
- * used to estimate join cardinality in query planning.
- *
- * ## Problem
- *
- * sqlite_stat1 includes NULL rows in its calculation, which can significantly
- * overestimate fanout for sparse foreign keys:
- *
- * ```
- * Example: 100 tasks, 20 with project_id, 80 with NULL
- * - stat1 reports: "100 17" → fanout = 17 (WRONG - includes NULLs)
- * - stat4 shows: NULL samples with fanout=80, non-NULL samples with fanout=4
- * - True fanout: 4 (CORRECT)
- * ```
- *
- * ## Solution
- *
- * This class uses sqlite_stat4 histogram to separate NULL and non-NULL samples,
- * providing accurate fanout for non-NULL joins.
- *
- * ## Usage
- *
- * ```typescript
- * const calculator = new SQLiteStatFanout(db);
- *
- * // Get fanout for posts.userId → users.id join
- * const result = calculator.getFanout('posts', 'userId');
- *
- * if (result.source === 'stat4') {
- *   // Accurate: excludes NULLs, samples actual distribution
- *   console.log(`Fanout: ${result.fanout} (from stat4)`);
- * } else if (result.source === 'stat1') {
- *   // Conservative: includes NULLs, may overestimate
- *   console.log(`Fanout: ${result.fanout} (from stat1, includes NULLs)`);
- * } else {
- *   // Fallback: no statistics available
- *   console.log(`Fanout: ${result.fanout} (default estimate)`);
- * }
- * ```
- *
- * ## Requirements
- *
- * - SQLite compiled with ENABLE_STAT4 (most builds include this)
- * - `ANALYZE` command run on the database
- * - Index exists on the join column
- *
- * @see https://sqlite.org/fileformat2.html#stat4tab
- * @see packages/zql/src/planner/SELECTIVITY_PLAN.md
- */
-export declare class SQLiteStatFanout {
-    #private;
-    /**
-     * Creates a new fanout calculator.
-     *
-     * @param db Database instance
-     * @param defaultFanout Default fanout when statistics unavailable (default: 3)
-     *                      - 1: Conservative (assumes FK relationships)
-     *                      - 3: Moderate (recommended, safe middle ground)
-     *                      - 10: SQLite's default (optimistic)
-     */
-    constructor(db: Database, defaultFanout?: number);
-    /**
-     * Gets the fanout factor for join column(s).
-     *
-     * Fanout = average number of child rows per distinct parent key value(s).
-     *
-     * ## Strategy
-     *
-     * 1. Try sqlite_stat4 (best): Histogram with separate NULL/non-NULL samples
-     * 2. Fallback to sqlite_stat1: Average across all rows (includes NULLs)
-     * 3. Fallback to default: When no statistics available
-     *
-     * ## Compound Indexes
-     *
-     * For multi-column joins, finds indexes where ALL columns appear as an
-     * exact prefix. Uses the appropriate depth in stat1/stat4.
-     *
-     * Example:
-     * - Columns: `['customerId', 'storeId']`
-     * - Matches index: `(customerId, storeId, date)` at depth 2
-     * - Uses stat1 parts[2] or stat4 neq[1] for accurate fanout
-     *
-     * ## Caching
-     *
-     * Results are cached per (table, columns) combination. Clear the cache if
-     * you run ANALYZE to update statistics.
-     *
-     * @param tableName Table containing the join column(s)
-     * @param columns Array of column names (one or more columns)
-     * @returns Fanout result with value and source
-     */
-    getFanout(tableName: string, columns: string[]): FanoutResult;
-    /**
-     * Clears the fanout cache.
-     * Call this after running ANALYZE to pick up updated statistics.
-     */
-    clearCache(): void;
-}
-//# sourceMappingURL=sqlite-stat-fanout.d.ts.map

package/out/zqlite/src/sqlite-stat-fanout.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"sqlite-stat-fanout.d.ts","sourceRoot":"","sources":["../../../../zqlite/src/sqlite-stat-fanout.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAC,QAAQ,EAAC,MAAM,SAAS,CAAC;AAGtC;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,GAAG,KAAK,GAAG,MAAM,CAAC;IAEpC;;;;;OAKG;IACH,MAAM,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS,CAAC;CACvC;AAgBD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AACH,qBAAa,gBAAgB;;IAkB3B;;;;;;;;OAQG;IACH,YAAY,EAAE,EAAE,QAAQ,EAAE,aAAa,SAAI,EAyB1C;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACH,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,YAAY,CAgC5D;IAED;;;OAGG;IACH,UAAU,IAAI,IAAI,CAEjB;CA0NF"}