@rocicorp/zero 0.0.0-202410031711

package/out/zql/src/zql/query/query.d.ts.map

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

package/out/zql/src/zql/query/schema.d.ts

@@ -0,0 +1,53 @@
+import type { TableSchemaBase } from '../ivm/schema.js';
+export type TableSchema = TableSchemaBase & {
+    readonly relationships: {
+        readonly [name: string]: Relationship;
+    };
+};
+/**
+ * A schema might have a relationship to itself.
+ * Given we cannot reference a variable in the same statement we initialize
+ * the variable, we use a function to get around this.
+ */
+export type Lazy<T> = () => T;
+type Relationship = FieldRelationship<TableSchema, TableSchema> | JunctionRelationship<TableSchema, TableSchema, TableSchema>;
+/**
+ * A relationship between two entities where
+ * that relationship is defined via fields on both entities.
+ */
+type FieldRelationship<TSourceSchema extends TableSchema, TDestSchema extends TableSchema> = {
+    source: keyof TSourceSchema['columns'];
+    dest: {
+        field: keyof TDestSchema['columns'];
+        schema: TDestSchema | Lazy<TDestSchema>;
+    };
+};
+/**
+ * A relationship between two entities where
+ * that relationship is defined via a junction table.
+ */
+type JunctionRelationship<TSourceSchema extends TableSchema, TJunctionSchema extends TableSchema, TDestSchema extends TableSchema> = {
+    source: keyof TSourceSchema['columns'];
+    junction: {
+        sourceField: keyof TJunctionSchema['columns'];
+        destField: keyof TJunctionSchema['columns'];
+        schema: TDestSchema | Lazy<TJunctionSchema>;
+    };
+    dest: {
+        field: keyof TDestSchema['columns'];
+        schema: TDestSchema | Lazy<TJunctionSchema>;
+    };
+};
+export declare function isFieldRelationship(relationship: Relationship): relationship is FieldRelationship<TableSchema, TableSchema>;
+export declare function isJunctionRelationship(relationship: Relationship): relationship is JunctionRelationship<TableSchema, TableSchema, TableSchema>;
+/**
+ * Calling `related` on `Query` returns a new Query
+ * since `related` moves through the relationship. This function takes
+ * 1. A schema
+ * 2. A relationship name
+ * and returns the schema of the entity at the other end of the
+ * relationship.
+ */
+export type PullSchemaForRelationship<TSchema extends TableSchema, TRelationship extends keyof TSchema['relationships']> = TSchema['relationships'][TRelationship] extends FieldRelationship<TableSchema, infer TSchema> ? TSchema : TSchema['relationships'][TRelationship] extends JunctionRelationship<TableSchema, TableSchema, infer TSchema> ? TSchema : never;
+export {};
+//# sourceMappingURL=schema.d.ts.map

package/out/zql/src/zql/query/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../../../../zql/src/zql/query/schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,kBAAkB,CAAC;AAEtD,MAAM,MAAM,WAAW,GAAG,eAAe,GAAG;IAC1C,QAAQ,CAAC,aAAa,EAAE;QAAC,QAAQ,EAAE,IAAI,EAAE,MAAM,GAAG,YAAY,CAAA;KAAC,CAAC;CACjE,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,IAAI,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC;AAE9B,KAAK,YAAY,GACb,iBAAiB,CAAC,WAAW,EAAE,WAAW,CAAC,GAC3C,oBAAoB,CAAC,WAAW,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC;AAEhE;;;GAGG;AACH,KAAK,iBAAiB,CACpB,aAAa,SAAS,WAAW,EACjC,WAAW,SAAS,WAAW,IAC7B;IACF,MAAM,EAAE,MAAM,aAAa,CAAC,SAAS,CAAC,CAAC;IACvC,IAAI,EAAE;QACJ,KAAK,EAAE,MAAM,WAAW,CAAC,SAAS,CAAC,CAAC;QACpC,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC;KACzC,CAAC;CACH,CAAC;AAEF;;;GAGG;AACH,KAAK,oBAAoB,CACvB,aAAa,SAAS,WAAW,EACjC,eAAe,SAAS,WAAW,EACnC,WAAW,SAAS,WAAW,IAC7B;IACF,MAAM,EAAE,MAAM,aAAa,CAAC,SAAS,CAAC,CAAC;IACvC,QAAQ,EAAE;QACR,WAAW,EAAE,MAAM,eAAe,CAAC,SAAS,CAAC,CAAC;QAC9C,SAAS,EAAE,MAAM,eAAe,CAAC,SAAS,CAAC,CAAC;QAC5C,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC,eAAe,CAAC,CAAC;KAC7C,CAAC;IACF,IAAI,EAAE;QACJ,KAAK,EAAE,MAAM,WAAW,CAAC,SAAS,CAAC,CAAC;QACpC,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC,eAAe,CAAC,CAAC;KAC7C,CAAC;CACH,CAAC;AAEF,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,YAAY,GACzB,YAAY,IAAI,iBAAiB,CAAC,WAAW,EAAE,WAAW,CAAC,CAU7D;AAED,wBAAgB,sBAAsB,CACpC,YAAY,EAAE,YAAY,GACzB,YAAY,IAAI,oBAAoB,CAAC,WAAW,EAAE,WAAW,EAAE,WAAW,CAAC,CAE7E;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,yBAAyB,CACnC,OAAO,SAAS,WAAW,EAC3B,aAAa,SAAS,MAAM,OAAO,CAAC,eAAe,CAAC,IAClD,OAAO,CAAC,eAAe,CAAC,CAAC,aAAa,CAAC,SAAS,iBAAiB,CACnE,WAAW,EACX,MAAM,OAAO,CACd,GACG,OAAO,GACP,OAAO,CAAC,eAAe,CAAC,CAAC,aAAa,CAAC,SAAS,oBAAoB,CAClE,WAAW,EACX,WAAW,EACX,MAAM,OAAO,CACd,GACD,OAAO,GACP,KAAK,CAAC"}

package/out/zql/src/zql/query/typed-view.d.ts

@@ -0,0 +1,10 @@
+import type { Immutable } from '../../../../shared/src/immutable.js';
+export type Listener<T> = (data: Immutable<T>) => void;
+export type TypedView<T> = {
+    addListener(listener: Listener<T>): () => void;
+    destroy(): void;
+    hydrate(): void;
+    onCommit(): void;
+    readonly data: T;
+};
+//# sourceMappingURL=typed-view.d.ts.map

package/out/zql/src/zql/query/typed-view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typed-view.d.ts","sourceRoot":"","sources":["../../../../../../zql/src/zql/query/typed-view.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,yBAAyB,CAAC;AAEvD,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;AAEvD,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI;IACzB,WAAW,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,CAAC;IAC/C,OAAO,IAAI,IAAI,CAAC;IAChB,OAAO,IAAI,IAAI,CAAC;IAChB,QAAQ,IAAI,IAAI,CAAC;IACjB,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;CAClB,CAAC"}

package/out/zqlite/src/db.d.ts

@@ -0,0 +1,23 @@
+import type { LogContext } from '@rocicorp/logger';
+import SQLite3Database, { type RunResult, type Statement as SQLite3Statement } from 'better-sqlite3';
+export declare class Database {
+    #private;
+    constructor(lc: LogContext, path: string, options?: SQLite3Database.Options, slowQueryThreshold?: number);
+    prepare(sql: string): Statement;
+    exec(sql: string): void;
+    pragma(sql: string): unknown;
+    close(): void;
+    transaction<T>(fn: () => T): T;
+    get name(): string;
+    get inTransaction(): boolean;
+}
+export declare class Statement {
+    #private;
+    constructor(lc: LogContext, stmt: SQLite3Statement, threshold: number);
+    safeIntegers(useBigInt: boolean): this;
+    run(...params: unknown[]): RunResult;
+    get<T>(...params: unknown[]): T;
+    all<T>(...params: unknown[]): T[];
+    iterate<T>(...params: unknown[]): IterableIterator<T>;
+}
+//# sourceMappingURL=db.d.ts.map

package/out/zqlite/src/db.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"db.d.ts","sourceRoot":"","sources":["../../../../zqlite/src/db.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,kBAAkB,CAAC;AACjD,OAAO,eAAe,EAAE,EACtB,KAAK,SAAS,EACd,KAAK,SAAS,IAAI,gBAAgB,EACnC,MAAM,gBAAgB,CAAC;AAExB,qBAAa,QAAQ;;gBAMjB,EAAE,EAAE,UAAU,EACd,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,eAAe,CAAC,OAAO,EACjC,kBAAkB,SAAM;IAO1B,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS;IAQ/B,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAUvB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAI5B,KAAK,IAAI,IAAI;IAIb,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC;IAI9B,IAAI,IAAI,WAEP;IAED,IAAI,aAAa,YAEhB;CACF;AAED,qBAAa,SAAS;;gBAKR,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM;IAMrE,YAAY,CAAC,SAAS,EAAE,OAAO,GAAG,IAAI;IAKtC,GAAG,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,SAAS;IAWpC,GAAG,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,CAAC;IAW/B,GAAG,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE;IAWjC,OAAO,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,gBAAgB,CAAC,CAAC,CAAC;CAOtD"}

package/out/zqlite/src/db.js

@@ -0,0 +1,117 @@
+import SQLite3Database, {} from 'better-sqlite3';
+export class Database {
+    #db;
+    #lc;
+    #threshold;
+    constructor(lc, path, options, slowQueryThreshold = 300) {
+        this.#lc = lc.withContext('class', 'Database').withContext('path', path);
+        this.#db = new SQLite3Database(path, options);
+        this.#threshold = slowQueryThreshold;
+    }
+    prepare(sql) {
+        return new Statement(this.#lc.withContext('class', 'Statement').withContext('sql', sql), this.#db.prepare(sql), this.#threshold);
+    }
+    exec(sql) {
+        const start = performance.now();
+        this.#db.exec(sql);
+        logIfSlow(performance.now() - start, this.#lc.withContext('method', 'exec'), this.#threshold);
+    }
+    pragma(sql) {
+        return this.#db.pragma(sql);
+    }
+    close() {
+        this.#db.close();
+    }
+    transaction(fn) {
+        return this.#db.transaction(fn)();
+    }
+    get name() {
+        return this.#db.name;
+    }
+    get inTransaction() {
+        return this.#db.inTransaction;
+    }
+}
+export class Statement {
+    #stmt;
+    #lc;
+    #threshold;
+    constructor(lc, stmt, threshold) {
+        this.#lc = lc;
+        this.#stmt = stmt;
+        this.#threshold = threshold;
+    }
+    safeIntegers(useBigInt) {
+        this.#stmt.safeIntegers(useBigInt);
+        return this;
+    }
+    run(...params) {
+        const start = performance.now();
+        const ret = this.#stmt.run(...params);
+        logIfSlow(performance.now() - start, this.#lc.withContext('method', 'run'), this.#threshold);
+        return ret;
+    }
+    get(...params) {
+        const start = performance.now();
+        const ret = this.#stmt.get(...params);
+        logIfSlow(performance.now() - start, this.#lc.withContext('method', 'get'), this.#threshold);
+        return ret;
+    }
+    all(...params) {
+        const start = performance.now();
+        const ret = this.#stmt.all(...params);
+        logIfSlow(performance.now() - start, this.#lc.withContext('method', 'all'), this.#threshold);
+        return ret;
+    }
+    iterate(...params) {
+        return new LoggingIterableIterator(this.#lc.withContext('method', 'iterate'), this.#stmt.iterate(...params), this.#threshold);
+    }
+}
+class LoggingIterableIterator {
+    #lc;
+    #it;
+    #threshold;
+    #start;
+    #sqliteRowTimeSum;
+    constructor(lc, it, slowQueryThreshold) {
+        this.#lc = lc;
+        this.#it = it;
+        this.#start = NaN;
+        this.#threshold = slowQueryThreshold;
+        this.#sqliteRowTimeSum = 0;
+    }
+    next() {
+        const start = performance.now();
+        const ret = this.#it.next();
+        const elapsed = performance.now() - start;
+        this.#sqliteRowTimeSum += elapsed;
+        if (ret.done) {
+            this.#log();
+        }
+        return ret;
+    }
+    #log() {
+        logIfSlow(performance.now() - this.#start, this.#lc.withContext('type', 'total'), this.#threshold);
+        logIfSlow(this.#sqliteRowTimeSum, this.#lc.withContext('type', 'sqlite'), this.#threshold);
+    }
+    [Symbol.iterator]() {
+        this.#start = performance.now();
+        return this;
+    }
+    return() {
+        this.#log();
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        return this.#it.return?.();
+    }
+    throw(e) {
+        this.#log();
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        return this.#it.throw?.(e);
+    }
+}
+function logIfSlow(elapsed, lc, threshold) {
+    if (elapsed >= threshold) {
+        lc.error?.('Slow query', elapsed);
+    }
+}
+//# sourceMappingURL=db.js.map

package/out/zqlite/src/db.js.map

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

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

@@ -0,0 +1,9 @@
+import type { SQLQuery } from '@databases/sql';
+import baseSql from '@databases/sql';
+export declare function compile(sql: SQLQuery): string;
+export declare function format(sql: SQLQuery): {
+    text: string;
+    values: unknown[];
+};
+export declare const sql: baseSql.SQL;
+//# sourceMappingURL=sql.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sql.d.ts","sourceRoot":"","sources":["../../../../../zqlite/src/internal/sql.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,QAAQ,EAAe,MAAM,gBAAgB,CAAC;AAC3D,OAAO,OAAO,MAAM,gBAAgB,CAAC;AAQrC,wBAAgB,OAAO,CAAC,GAAG,EAAE,QAAQ,GAAG,MAAM,CAE7C;AAED,wBAAgB,MAAM,CAAC,GAAG,EAAE,QAAQ;;;EAEnC;AAED,eAAO,MAAM,GAAG,aAAkB,CAAC"}

package/out/zqlite/src/internal/sql.js

@@ -0,0 +1,14 @@
+import baseSql from '@databases/sql';
+import { escapeSQLiteIdentifier } from '@databases/escape-identifier';
+const sqliteFormat = {
+    escapeIdentifier: str => escapeSQLiteIdentifier(str),
+    formatValue: value => ({ placeholder: '?', value }),
+};
+export function compile(sql) {
+    return sql.format(sqliteFormat).text;
+}
+export function format(sql) {
+    return sql.format(sqliteFormat);
+}
+export const sql = baseSql.default;
+//# sourceMappingURL=sql.js.map

package/out/zqlite/src/internal/sql.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sql.js","sourceRoot":"","sources":["../../../../../zqlite/src/internal/sql.ts"],"names":[],"mappings":"AACA,OAAO,OAAO,MAAM,gBAAgB,CAAC;AACrC,OAAO,EAAC,sBAAsB,EAAC,MAAM,8BAA8B,CAAC;AAEpE,MAAM,YAAY,GAAiB;IACjC,gBAAgB,EAAE,GAAG,CAAC,EAAE,CAAC,sBAAsB,CAAC,GAAG,CAAC;IACpD,WAAW,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC,EAAC,WAAW,EAAE,GAAG,EAAE,KAAK,EAAC,CAAC;CAClD,CAAC;AAEF,MAAM,UAAU,OAAO,CAAC,GAAa;IACnC,OAAO,GAAG,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,GAAa;IAClC,OAAO,GAAG,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;AAClC,CAAC;AAED,MAAM,CAAC,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC"}

package/out/zqlite/src/internal/statement-cache.d.ts

@@ -0,0 +1,67 @@
+import type { Database, Statement } from '../db.js';
+export type CachedStatementMap = Map<string, Statement[]>;
+export type CachedStatement = {
+    sql: string;
+    statement: Statement;
+};
+/**
+ * SQLite statement preparation isn't cheap as it involves evaluating possible
+ * query plans and picking the best one (in addition to parsing the SQL).
+ *
+ * This statement cache prevents the need to re-prepare the same statement
+ * multiple times.
+ *
+ * One extra wrinkle is that a single statement cannot be used by multiple
+ * callers at the same time. As in, we can't `iterate` the same statement
+ * many times concurrently.
+ *
+ * Given that, statements are removed from the cache while in use.
+ * - `get` removes the statement from the cache
+ * - `return` adds it back.
+ *
+ * If a request for the same sql is made while a
+ * statement is gotten, a new statement will be prepared.
+ * Both statements can be returned to the cache even though they both
+ * serve the same SQL. Having both copies returned to the cache allows
+ * the cache to serve multiple callers concurrently in the future.
+ *
+ * It is not an error to fail to call `return` on a statement.
+ * Failing to call return will only prevent the statement from being reused
+ * by other callers. It will not cause a resource leak.
+ */
+export declare class StatementCache {
+    #private;
+    /**
+     * The db connection used to prepare the statement.
+     * It is an error to use a statement prepared on one connection with another connection.
+     * @param db
+     */
+    constructor(db: Database);
+    get size(): number;
+    drop(n: number): void;
+    /**
+     * Prepares a statement for the given sql unless one is already cached.
+     * If one is cached, it is removed from the cache and returned.
+     *
+     * Since `get` removes the item from the cache it is not an error to fail to call
+     * `return`. The gotten statement will be correctly garbage collected.
+     *
+     * When a gotten statement is not returned, future calls to
+     * `get` with the same `sql` will prepare a new statement.
+     *
+     * @param sql
+     * @returns
+     */
+    get(sql: string): CachedStatement;
+    /**
+     * Handles `get` and `return` for the caller by invoking them before
+     * and after the callback.
+     */
+    use<T>(sql: string, cb: (statement: CachedStatement) => T): T;
+    /**
+     * Add a statement back to the cache so someone else can use it later.
+     * @param statement
+     */
+    return(statement: CachedStatement): void;
+}
+//# sourceMappingURL=statement-cache.d.ts.map

package/out/zqlite/src/internal/statement-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"statement-cache.d.ts","sourceRoot":"","sources":["../../../../../zqlite/src/internal/statement-cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,QAAQ,EAAE,SAAS,EAAC,MAAM,UAAU,CAAC;AAGlD,MAAM,MAAM,kBAAkB,GAAG,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;AAC1D,MAAM,MAAM,eAAe,GAAG;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,SAAS,CAAC;CACtB,CAAC;AACF;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAAa,cAAc;;IAKzB;;;;OAIG;gBACS,EAAE,EAAE,QAAQ;IAKxB,IAAI,IAAI,WAEP;IAED,IAAI,CAAC,CAAC,EAAE,MAAM;IAkBd;;;;;;;;;;;;OAYG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe;IAejC;;;OAGG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,SAAS,EAAE,eAAe,KAAK,CAAC;IASzD;;;OAGG;IACH,MAAM,CAAC,SAAS,EAAE,eAAe;CAWlC"}

package/out/zqlite/src/internal/statement-cache.js

@@ -0,0 +1,119 @@
+import { assert } from '../../../shared/src/asserts.js';
+/**
+ * SQLite statement preparation isn't cheap as it involves evaluating possible
+ * query plans and picking the best one (in addition to parsing the SQL).
+ *
+ * This statement cache prevents the need to re-prepare the same statement
+ * multiple times.
+ *
+ * One extra wrinkle is that a single statement cannot be used by multiple
+ * callers at the same time. As in, we can't `iterate` the same statement
+ * many times concurrently.
+ *
+ * Given that, statements are removed from the cache while in use.
+ * - `get` removes the statement from the cache
+ * - `return` adds it back.
+ *
+ * If a request for the same sql is made while a
+ * statement is gotten, a new statement will be prepared.
+ * Both statements can be returned to the cache even though they both
+ * serve the same SQL. Having both copies returned to the cache allows
+ * the cache to serve multiple callers concurrently in the future.
+ *
+ * It is not an error to fail to call `return` on a statement.
+ * Failing to call return will only prevent the statement from being reused
+ * by other callers. It will not cause a resource leak.
+ */
+export class StatementCache {
+    #cache = new Map();
+    #db;
+    #size = 0;
+    /**
+     * The db connection used to prepare the statement.
+     * It is an error to use a statement prepared on one connection with another connection.
+     * @param db
+     */
+    constructor(db) {
+        this.#db = db;
+    }
+    // the number of statements in the cache
+    get size() {
+        return this.#size;
+    }
+    drop(n) {
+        assert(n >= 0, 'Cannot drop a negative number of items');
+        assert(n <= this.#size, 'Cannot drop more items than are in the cache');
+        let remaining = n;
+        for (const [sql, statements] of this.#cache.entries()) {
+            if (remaining >= statements.length) {
+                this.#cache.delete(sql);
+                remaining -= statements.length;
+                this.#size -= statements.length;
+            }
+            else {
+                statements.splice(0, remaining);
+                this.#size -= remaining;
+                break;
+            }
+        }
+    }
+    /**
+     * Prepares a statement for the given sql unless one is already cached.
+     * If one is cached, it is removed from the cache and returned.
+     *
+     * Since `get` removes the item from the cache it is not an error to fail to call
+     * `return`. The gotten statement will be correctly garbage collected.
+     *
+     * When a gotten statement is not returned, future calls to
+     * `get` with the same `sql` will prepare a new statement.
+     *
+     * @param sql
+     * @returns
+     */
+    get(sql) {
+        sql = normalizeWhitespace(sql);
+        const statements = this.#cache.get(sql);
+        if (statements && statements.length > 0) {
+            const statement = statements.pop();
+            this.#size--;
+            if (statements.length === 0) {
+                this.#cache.delete(sql);
+            }
+            return { sql, statement };
+        }
+        const statement = this.#db.prepare(sql);
+        return { sql, statement };
+    }
+    /**
+     * Handles `get` and `return` for the caller by invoking them before
+     * and after the callback.
+     */
+    use(sql, cb) {
+        const statement = this.get(sql);
+        try {
+            return cb(statement);
+        }
+        finally {
+            this.return(statement);
+        }
+    }
+    /**
+     * Add a statement back to the cache so someone else can use it later.
+     * @param statement
+     */
+    return(statement) {
+        const { sql } = statement;
+        if (!this.#cache.has(sql)) {
+            this.#cache.set(sql, []);
+        }
+        const statements = this.#cache.get(sql);
+        if (statements) {
+            statements.push(statement.statement);
+            this.#size++;
+        }
+    }
+}
+function normalizeWhitespace(sql) {
+    return sql.replaceAll(/\s+/g, ' ');
+}
+//# sourceMappingURL=statement-cache.js.map

package/out/zqlite/src/internal/statement-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"statement-cache.js","sourceRoot":"","sources":["../../../../../zqlite/src/internal/statement-cache.ts"],"names":[],"mappings":"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"}

package/out/zqlite/src/table-source.d.ts

@@ -0,0 +1,43 @@
+import type { Ordering, SimpleCondition } from '../../zql/src/zql/ast/ast.js';
+import { type Row } from '../../zql/src/zql/ivm/data.js';
+import type { SchemaValue } from '../../zql/src/zql/ivm/schema.js';
+import type { Source, SourceChange, SourceInput } from '../../zql/src/zql/ivm/source.js';
+import { Database } from '../../zqlite/src/db.js';
+/**
+ * A source that is backed by a SQLite table.
+ *
+ * Values are written to the backing table _after_ being vended by the source.
+ * An overlay index (not yet implemented) is used such that
+ * `fetches` made after a `push` will see the new values.
+ *
+ * This ordering of events is to ensure self joins function properly. That is,
+ * we can't reveal a value to an output before it has been pushed to that output.
+ *
+ * The code is fairly straightforward except for:
+ * 1. Dealing with a `fetch` that has a basis of `before`.
+ * 2. Dealing with compound orders that have differing directions (a ASC, b DESC, c ASC)
+ *
+ * See comments in relevant functions for more details.
+ */
+export declare class TableSource implements Source {
+    #private;
+    constructor(db: Database, tableName: string, columns: Record<string, SchemaValue>, primaryKey: readonly [string, ...string[]]);
+    /**
+     * Sets the db (snapshot) to use, to facilitate the Snapshotter leapfrog
+     * algorithm for concurrent traversal of historic timelines.
+     */
+    setDB(db: Database): void;
+    connect(sort: Ordering, optionalFilters?: SimpleCondition[] | undefined): SourceInput;
+    push(change: SourceChange): void;
+    /**
+     * Retrieves a row from the backing DB by its primary key, or `undefined` if such a
+     * row does not exist. This is not used in the IVM pipeline but is useful
+     * for retrieving data that is consistent with the state (and type
+     * semantics) of the pipeline.
+     */
+    getRow(pk: Row): Row | undefined;
+}
+export declare class UnsupportedValueError extends Error {
+    constructor(msg: string);
+}
+//# sourceMappingURL=table-source.d.ts.map

package/out/zqlite/src/table-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"table-source.d.ts","sourceRoot":"","sources":["../../../../zqlite/src/table-source.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAC,QAAQ,EAAE,eAAe,EAAC,MAAM,wBAAwB,CAAC;AAGtE,OAAO,EAIL,KAAK,GAAG,EAET,MAAM,yBAAyB,CAAC;AAYjC,OAAO,KAAK,EAGV,WAAW,EAEZ,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EACV,MAAM,EACN,YAAY,EACZ,WAAW,EACZ,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAAC,QAAQ,EAAY,MAAM,kBAAkB,CAAC;AAqBrD;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,WAAY,YAAW,MAAM;;gBAUtC,EAAE,EAAE,QAAQ,EACZ,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,EACpC,UAAU,EAAE,SAAS,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;IAQ5C;;;OAGG;IACH,KAAK,CAAC,EAAE,EAAE,QAAQ;IAqFlB,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,eAAe,CAAC,EAAE,eAAe,EAAE,GAAG,SAAS;IAuIvE,IAAI,CAAC,MAAM,EAAE,YAAY;IAmFzB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,EAAE,GAAG,GAAG,GAAG,GAAG,SAAS;CASjC;AA0MD,qBAAa,qBAAsB,SAAQ,KAAK;gBAClC,GAAG,EAAE,MAAM;CAGxB"}