@evolu/common 7.4.0 → 8.0.0-next.0

package/dist/src/Sqlite.d.ts.map

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

package/dist/src/Sqlite.js

@@ -1,112 +1,231 @@
-import { createLruCache } from "./Cache.js";
-import { eqArrayNumber } from "./Eq.js";
-import { createTransferableError } from "./Error.js";
-import { err, ok, tryAsync, trySync } from "./Result.js";
-import { Null, Number, PositiveInt, String, Uint8Array, union, } from "./Type.js";
 /**
- * A value that can be stored in Sqlite.
+ * SQLite database abstraction and query execution.
+ *
+ * @module
+ */
+var __addDisposableResource = (this && this.__addDisposableResource) || function (env, value, async) {
+    if (value !== null && value !== void 0) {
+        if (typeof value !== "object" && typeof value !== "function") throw new TypeError("Object expected.");
+        var dispose, inner;
+        if (async) {
+            if (!Symbol.asyncDispose) throw new TypeError("Symbol.asyncDispose is not defined.");
+            dispose = value[Symbol.asyncDispose];
+        }
+        if (dispose === void 0) {
+            if (!Symbol.dispose) throw new TypeError("Symbol.dispose is not defined.");
+            dispose = value[Symbol.dispose];
+            if (async) inner = dispose;
+        }
+        if (typeof dispose !== "function") throw new TypeError("Object not disposable.");
+        if (inner) dispose = function() { try { inner.call(this); } catch (e) { return Promise.reject(e); } };
+        env.stack.push({ value: value, dispose: dispose, async: async });
+    }
+    else if (async) {
+        env.stack.push({ async: true });
+    }
+    return value;
+};
+var __disposeResources = (this && this.__disposeResources) || (function (SuppressedError) {
+    return function (env) {
+        function fail(e) {
+            env.error = env.hasError ? new SuppressedError(e, env.error, "An error was suppressed during disposal.") : e;
+            env.hasError = true;
+        }
+        var r, s = 0;
+        function next() {
+            while (r = env.stack.pop()) {
+                try {
+                    if (!r.async && s === 1) return s = 0, env.stack.push(r), Promise.resolve().then(next);
+                    if (r.dispose) {
+                        var result = r.dispose.call(r.value);
+                        if (r.async) return s |= 2, Promise.resolve(result).then(next, function(e) { fail(e); return next(); });
+                    }
+                    else s |= 1;
+                }
+                catch (e) {
+                    fail(e);
+                }
+            }
+            if (s === 1) return env.hasError ? Promise.reject(env.error) : Promise.resolve();
+            if (env.hasError) throw env.error;
+        }
+        return next();
+    };
+})(typeof SuppressedError === "function" ? SuppressedError : function (error, suppressed, message) {
+    var e = new Error(message);
+    return e.name = "SuppressedError", e.error = error, e.suppressed = suppressed, e;
+});
+import { assertNotDisposed } from "./Assert.js";
+import { bytesToHex, hexToBytes } from "./Buffer.js";
+import { createEqObject, eqArrayNumber, eqString } from "./Eq.js";
+import { createRecord, objectToEntries } from "./Object.js";
+import { ok } from "./Result.js";
+import { testCreateRun } from "./Test.js";
+import { array, Null, Number, object, record, set, String, testName, Uint8Array, union, } from "./Type.js";
+/**
+ * A value that can be stored in {@link Sqlite}.
  *
  * Note that Evolu can't support Int64 because expo-sqlite (and some others) do
  * not support it.
  */
-export const SqliteValue = union(Null, String, Number, Uint8Array);
-export const eqSqliteValue = (x, y) => {
-    if (x instanceof globalThis.Uint8Array &&
-        y instanceof globalThis.Uint8Array) {
-        return eqArrayNumber(x, y);
-    }
-    return x === y;
+export const SqliteValue = /*#__PURE__*/ union(Null, String, Number, Uint8Array);
+/** Equality comparison for {@link SqliteValue}. */
+export const eqSqliteValue = (x, y) => Uint8Array.is(x) && Uint8Array.is(y) ? eqArrayNumber(x, y) : x === y;
+/** Converts a {@link SqliteQuery} into a stable {@link SqliteQueryString}. */
+export const sqliteQueryToSqliteQueryString = (query) => {
+    const params = query.parameters.map((value) => value instanceof globalThis.Uint8Array
+        ? ["b", bytesToHex(value)]
+        : ["j", value]);
+    const options = query.options
+        ? objectToEntries(query.options).toSorted(([a], [b]) => a.localeCompare(b))
+        : [];
+    return JSON.stringify([query.sql, params, options]);
+};
+/** Converts a {@link SqliteQueryString} back into a {@link SqliteQuery}. */
+export const sqliteQueryStringToSqliteQuery = (query) => {
+    const [sql, paramsArr, optionsArr] = JSON.parse(query);
+    const parameters = paramsArr.map(([type, value]) => type === "b" ? hexToBytes(value) : value);
+    const options = optionsArr.length
+        ? Object.fromEntries(optionsArr)
+        : undefined;
+    return {
+        sql,
+        parameters,
+        ...(options !== undefined && { options }),
+    };
 };
 /**
- * Creates a fully featured {@link Sqlite} instance from a {@link SqliteDriver}
- * implementation.
+ * Creates a {@link Sqlite} instance backed by a platform-specific driver.
+ *
+ * The driver is created via {@link CreateSqliteDriver} and wrapped with logging,
+ * error handling, and transaction helpers.
  */
-export const createSqlite = (deps) => async (name, options) => tryAsync(async () => {
-    const driver = await deps.createSqliteDriver(name, options);
-    let isDisposed = false;
-    const doRollback = () => trySync(() => {
-        deps.console?.log("[sql] rollback");
-        driver.exec(sql `rollback;`, true);
-    }, createSqliteError);
-    const sqlite = {
-        exec: (query) => trySync(() => {
-            deps.console?.log("[sql]", { query });
-            const result = maybeLogSqliteQueryExecutionTime(query, () => driver.exec(query, isSqlMutation(query.sql)));
-            deps.console?.log("[sql]", { result });
-            return result;
-        }, (error) => ({
-            type: "SqliteError",
-            error: createTransferableError(error),
-        })),
-        transaction: (callback) => {
-            const transactionResult = trySync(() => {
-                deps.console?.log("[sql] begin");
-                driver.exec(sql `begin;`, true);
-                const result = callback();
-                if (!result.ok)
-                    return result;
-                deps.console?.log("[sql] commit");
-                driver.exec(sql `commit;`, true);
-                return result;
-            }, createSqliteError);
-            // There was an SqliteError during begin, callback, or commit
-            if (!transactionResult.ok) {
-                const rollback = doRollback();
-                if (!rollback.ok) {
-                    deps.console?.log("[sql] rollback failed", rollback.error);
-                    return err({
-                        type: "SqliteError",
-                        error: transactionResult.error.error,
-                        rollbackError: rollback.error.error,
+export const createSqlite = (name, options) => async (run) => {
+    const env_1 = { stack: [], error: void 0, hasError: false };
+    try {
+        const { createSqliteDriver } = run.deps;
+        const console = run.deps.console.child("sql");
+        const stack = __addDisposableResource(env_1, new AsyncDisposableStack(), true);
+        const driverResult = await run(createSqliteDriver(name, options));
+        if (!driverResult.ok)
+            return driverResult;
+        const driver = stack.use(driverResult.value);
+        console.debug("SQLite driver created");
+        const moved = stack.move();
+        const sqlite = {
+            exec: (query) => {
+                assertNotDisposed(moved);
+                console.debug({ query });
+                const label = query.options?.logQueryExecutionTime &&
+                    `SqliteQueryExecutionTime ${query.sql}`;
+                if (label)
+                    console.time(label);
+                const result = driver.exec(query);
+                if (label)
+                    console.timeEnd(label);
+                if (query.options?.logExplainQueryPlan) {
+                    const result = driver.exec({
+                        ...query,
+                        sql: `EXPLAIN QUERY PLAN ${query.sql}`,
                     });
+                    console.log("[logExplainQueryPlan]", query);
+                    console.log(drawSqliteQueryPlan(result.rows));
                 }
-                return transactionResult;
-            }
-            // Callback returned an error
-            if (!transactionResult.value.ok) {
-                const rollback = doRollback();
-                if (!rollback.ok) {
-                    deps.console?.log("[sql] rollback failed", rollback.error);
-                    return err({
-                        type: "SqliteError",
-                        error: createTransferableError(transactionResult.value.error),
-                        rollbackError: rollback.error.error,
-                    });
+                console.debug({ result });
+                return result;
+            },
+            transaction: ((callback) => {
+                const env_2 = { stack: [], error: void 0, hasError: false };
+                try {
+                    assertNotDisposed(moved);
+                    console.debug("begin");
+                    driver.exec(sql `begin;`);
+                    let shouldRollback = true;
+                    const _rollback = __addDisposableResource(env_2, {
+                        [Symbol.dispose]: () => {
+                            if (!shouldRollback)
+                                return;
+                            console.debug("rollback");
+                            driver.exec(sql `rollback;`);
+                        },
+                    }, false);
+                    const result = callback();
+                    if (result != null && !result.ok)
+                        return result;
+                    console.debug("commit");
+                    driver.exec(sql `commit;`);
+                    shouldRollback = false;
+                    return result;
                 }
-                return transactionResult.value;
-            }
-            return ok(transactionResult.value.value);
-        },
-        export: () => trySync(() => {
-            return driver.export();
-        }, (error) => ({
-            type: "SqliteError",
-            error: createTransferableError(error),
-        })),
-        [Symbol.dispose]: () => {
-            if (isDisposed)
-                return;
-            isDisposed = true;
-            driver[Symbol.dispose]();
-        },
-    };
-    return sqlite;
-}, createSqliteError);
-const createSqliteError = (error) => ({
-    type: "SqliteError",
-    error: createTransferableError(error),
-});
-const maybeLogSqliteQueryExecutionTime = (query, callback) => {
-    if (!query.options?.logQueryExecutionTime) {
-        return callback();
+                catch (e_2) {
+                    env_2.error = e_2;
+                    env_2.hasError = true;
+                }
+                finally {
+                    __disposeResources(env_2);
+                }
+            }),
+            export: () => {
+                assertNotDisposed(moved);
+                return driver.export();
+            },
+            [Symbol.asyncDispose]: () => moved.disposeAsync(),
+        };
+        return ok(sqlite);
+    }
+    catch (e_1) {
+        env_1.error = e_1;
+        env_1.hasError = true;
+    }
+    finally {
+        const result_1 = __disposeResources(env_1);
+        if (result_1)
+            await result_1;
+    }
+};
+/** Creates a test setup with a in-memory {@link Sqlite}. */
+export const testSetupSqlite = async (deps) => {
+    const env_3 = { stack: [], error: void 0, hasError: false };
+    try {
+        const stack = __addDisposableResource(env_3, new AsyncDisposableStack(), true);
+        const run = stack.use(testCreateRun(deps));
+        const sqlite = stack.use(await run.orThrow(createSqlite(testName, { mode: "memory" })));
+        const moved = stack.move();
+        return {
+            run: run.addDeps({ sqlite }),
+            sqlite,
+            [Symbol.asyncDispose]: () => moved.disposeAsync(),
+        };
+    }
+    catch (e_3) {
+        env_3.error = e_3;
+        env_3.hasError = true;
+    }
+    finally {
+        const result_2 = __disposeResources(env_3);
+        if (result_2)
+            await result_2;
     }
-    const start = performance.now();
-    const result = callback();
-    const elapsed = performance.now() - start;
-    // eslint-disable-next-line no-console
-    console.log(`SqliteQueryExecutionTime: ${elapsed.toString()}ms`, query);
-    return result;
 };
+const drawSqliteQueryPlan = (rows) => rows
+    .map((row) => {
+    let parentId = row.parent;
+    let indent = 0;
+    do {
+        const parent = rows.find((r) => r.id === parentId);
+        if (!parent)
+            break;
+        parentId = parent.parent;
+        indent++;
+        // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition, no-constant-condition
+    } while (true);
+    return `${"  ".repeat(indent)}${row.detail}`;
+})
+    .join("\n");
+/**
+ * Creates a {@link PreparedStatements} cache backed by the given factory and
+ * dispose function.
+ */
 export const createPreparedStatementsCache = (factory, disposeFn) => {
     let isDisposed = false;
     const cache = new Map();
@@ -162,7 +281,7 @@ export const createPreparedStatementsCache = (factory, disposeFn) => {
  * sqlite.exec(sql`select * from users order by ${sql.raw(orderBy)};`);
  * ```
  *
- * ### TIP
+ * ## TIP
  *
  * Use `prettier-plugin-sql-cst` for SQL formatting. Like Prettier for
  * JavaScript, this plugin formats SQL expressions differently depending on
@@ -184,7 +303,7 @@ export const sql = (strings, ...parameters) => {
             }
         }
     }
-    return { sql: sql, parameters: values };
+    return { sql: sql.trim(), parameters: values };
 };
 sql.identifier = (identifier) => ({
     type: "SqlIdentifier",
@@ -192,124 +311,105 @@ sql.identifier = (identifier) => ({
     sql: `"${identifier.replace(/"/g, '""')}"`,
 });
 /**
- * Insert any string.
+ * Insert any string verbatim.
  *
- * Sql.raw sometimes breaks auto-formatting because the parser does not consider
- * it valid SQL. A workaround is to remove it, format it, and put it back.
- *
- * **Warning**: This is not escaped.
+ * **Warning**: This is not escaped. Use only with trusted, constant SQL
+ * fragments to avoid SQL injection.
  */
 sql.raw = (raw) => ({ type: "RawSql", sql: raw });
+/** Tagged template that creates a {@link SqliteQuery} with `prepare: true`. */
 sql.prepared = (strings, ...parameters) => {
     const query = sql(strings, ...parameters);
     return { ...query, options: { prepare: true } };
 };
+/** Index metadata stored in `sqlite_master` for a {@link Sqlite} database. */
+export const SqliteIndex = /*#__PURE__*/ object({ name: String, sql: String });
+/** {@link Eq} instance for {@link SqliteIndex}. */
+export const eqSqliteIndex = /*#__PURE__*/ createEqObject({
+    name: eqString,
+    sql: eqString,
+});
 /**
- * Checks if a SQL string contains mutation keywords (insert, update, delete,
- * etc.). Results are cached for performance.
+ * Full schema metadata for a {@link Sqlite} database.
+ *
+ * Includes table-column mappings and user-visible indexes.
  */
-export const isSqlMutation = (sql) => {
-    /**
-     * Without cache, "insert 1_000_000" Storage test dropped from 57742
-     * inserts/sec to 34k. Regex we used was fast, but CodeQL flagged it as a
-     * potential ReDoS vulnerability, so manual comment removal was the only
-     * option. LRU cache restores performance.
-     */
-    const cached = isSqlMutationCache.get(sql);
-    if (cached !== undefined)
-        return cached;
-    const result = isSqlMutationRegEx.test(removeSqlComments(sql));
-    isSqlMutationCache.set(sql, result);
-    return result;
+export const SqliteSchema = /*#__PURE__*/ object({
+    tables: /*#__PURE__*/ record(String, /*#__PURE__*/ set(String)),
+    indexes: /*#__PURE__*/ array(SqliteIndex),
+});
+/** Get the current SQLite schema by reading SQLite metadata. */
+export const getSqliteSchema = (deps) => ({ excludeIndexNamePrefix, } = {}) => {
+    const tables = createRecord();
+    const tableAndColumnInfoRows = deps.sqlite.exec(sql `
+      select
+        sqlite_master.name as tableName,
+        table_info.name as columnName
+      from
+        sqlite_master
+        join pragma_table_info(sqlite_master.name) as table_info;
+    `);
+    tableAndColumnInfoRows.rows.forEach(({ tableName, columnName }) => {
+        (tables[tableName] ??= new Set()).add(columnName);
+    });
+    const indexNamePrefixFilter = excludeIndexNamePrefix != null
+        ? ` and name not like '${excludeIndexNamePrefix.replaceAll("'", "''")}%'`
+        : "";
+    const indexesRows = deps.sqlite.exec(sql `
+        select name, sql
+        from sqlite_master
+        where
+          type = 'index'
+          and name not like 'sqlite_%'
+          ${sql.raw(indexNamePrefixFilter)};
+      `);
+    const indexes = indexesRows.rows.map((row) => ({
+        name: row.name,
+        /**
+         * SQLite returns "CREATE INDEX" for "create index" for some reason.
+         * Other keywords remain unchanged. We have to normalize the casing for
+         * schema comparison manually.
+         */
+        sql: row.sql
+            .replace("CREATE INDEX", "create index")
+            .replace("CREATE UNIQUE INDEX", "create unique index"),
+    }));
+    return { tables, indexes };
 };
-const isSqlMutationCache = createLruCache(PositiveInt.orThrow(10_000));
-const isSqlMutationRegEx = new RegExp(`\\b(${[
-    "alter",
-    "create",
-    "delete",
-    "drop",
-    "insert",
-    "replace",
-    "update",
-    "begin",
-    "commit",
-    "rollback",
-    "pragma",
-    "vacuum",
-].join("|")})\\b`, "i");
 /**
- * Removes SQL line comments (--) from a SQL string without using regex to avoid
- * ReDoS vulnerabilities.
+ * Captures a full {@link SqliteSnapshot} for testing and diagnostics.
+ *
+ * The snapshot includes current {@link SqliteSchema} and all rows from every
+ * discovered table. Table order follows `schema.tables` iteration order.
  */
-const removeSqlComments = (sql) => {
-    // Fast path: if there are no comments, return the original string
-    if (!sql.includes("--"))
-        return sql;
-    let result = "";
-    let i = 0;
-    while (i < sql.length) {
-        // Check for comment start
-        if (i < sql.length - 1 && sql[i] === "-" && sql[i + 1] === "-") {
-            // Skip until end of line or end of string
-            i += 2;
-            while (i < sql.length && sql[i] !== "\n") {
-                i++;
-            }
-            // Keep the newline if present
-            if (i < sql.length && sql[i] === "\n") {
-                result += "\n";
-                i++;
-            }
-        }
-        else {
-            result += sql[i];
-            i++;
-        }
+export const getSqliteSnapshot = (deps) => {
+    const schema = getSqliteSchema(deps)();
+    const tables = [];
+    for (const tableName in schema.tables) {
+        const result = deps.sqlite.exec(sql `
+      select * from ${sql.identifier(tableName)};
+    `);
+        tables.push({
+            name: tableName,
+            rows: result.rows,
+        });
     }
-    return result;
+    return { schema, tables };
 };
-export const explainSqliteQueryPlan = (deps) => (query) => {
-    const result = deps.sqlite.exec({
-        ...query,
-        sql: `EXPLAIN QUERY PLAN ${query.sql}`,
-    });
-    if (!result.ok)
-        return result;
-    // eslint-disable-next-line no-console
-    console.log("[explainSqliteQueryPlan]", query);
-    // eslint-disable-next-line no-console
-    console.log(drawSqliteQueryPlan(result.value.rows));
-    return ok();
-};
-const drawSqliteQueryPlan = (rows) => rows
-    .map((row) => {
-    let parentId = row.parent;
-    let indent = 0;
-    do {
-        const parent = rows.find((r) => r.id === parentId);
-        if (!parent)
-            break;
-        parentId = parent.parent;
-        indent++;
-        // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition, no-constant-condition
-    } while (true);
-    return `${"  ".repeat(indent)}${row.detail}`;
-})
-    .join("\n");
 /**
  * SQLite represents boolean values using `0` (false) and `1` (true) instead of
  * a dedicated boolean type.
  *
  * See: https://www.sqlite.org/quirks.html#no_separate_boolean_datatype
  *
- * ### Tips
+ * ## Tips
  *
  * - Use {@link sqliteTrue} and {@link sqliteFalse} constants for better
  *   readability.
  * - Use {@link booleanToSqliteBoolean} and {@link sqliteBooleanToBoolean} for
  *   converting between JavaScript booleans and SQLite boolean values.
  */
-export const SqliteBoolean = union(0, 1);
+export const SqliteBoolean = /*#__PURE__*/ union(0, 1);
 /**
  * Represents the {@link SqliteBoolean} value for `true`.
  *

package/dist/src/Store.d.ts

@@ -1,42 +1,50 @@
-import { Eq } from "./Eq.js";
-import { Ref } from "./Ref.js";
 /**
- * A store for managing state with change notifications. Extends {@link Ref} with
- * subscriptions. Provides methods to get, set, and modify state, and to notify
- * listeners when the state changes.
+ * Observable state container with change notifications.
+ *
+ * @module
  */
-export interface Store<T> extends Ref<T> {
-    /**
-     * Registers a listener to be called on state changes and returns a function
-     * to unsubscribe.
-     */
-    readonly subscribe: StoreSubscribe;
+import type { Eq } from "./Eq.js";
+import type { Ref } from "./Ref.js";
+/**
+ * A store for managing state with change notifications. Like a {@link Ref} with
+ * subscriptions.
+ *
+ * Store is a valid dependency in Evolu's [Dependency
+ * Injection](https://evolu.dev/docs/dependency-injection) pattern—use it when
+ * functions need shared mutable state with subscriptions.
+ */
+export interface Store<T> extends ReadonlyStore<T>, Ref<T> {
+}
+/**
+ * A read-only view of a {@link Store} that provides state access and change
+ * notifications without allowing modifications.
+ *
+ * Use {@link ReadonlyStore} in public APIs where consumers should observe state
+ * but not modify it directly.
+ */
+export interface ReadonlyStore<T> extends Disposable {
     /** Returns the current state of the store. */
     readonly get: () => T;
     /**
-     * Updates the store's state and notifies all subscribed listeners if the new
-     * state differs from the current one.
-     */
-    readonly set: (state: T) => void;
-    /**
-     * Modifies the store's state by applying a callback function to the current
-     * state and notifies listeners if the state changes.
+     * Registers a listener to be called on state changes and returns a function
+     * to unsubscribe.
      */
-    readonly modify: (updater: (current: T) => T) => void;
+    readonly subscribe: (listener: Listener) => Unsubscribe;
 }
-/** Registers a listener for state changes, returning an unsubscribe function. */
-export type StoreSubscribe = (listener: StoreListener) => StoreUnsubscribe;
-/** A callback invoked whenever the store's state updates. */
-export type StoreListener = () => void;
-/** A function to remove a previously added listener. */
-export type StoreUnsubscribe = () => void;
+/** Callback used by {@link ReadonlyStore.subscribe} to observe changes. */
+export type Listener = () => void;
+/**
+ * Function returned by {@link ReadonlyStore.subscribe} to stop observing
+ * changes.
+ */
+export type Unsubscribe = () => void;
 /**
  * Creates a store with the given initial state. The store encapsulates its
- * state, which can be read with `get` and updated with `set` or `modify`. All
+ * state, which can be read with `get` and updated with `set` or `update`. All
  * changes are broadcast to subscribers.
  *
- * By default, state changes are detected using `===` (shallow equality). You
- * can provide a custom equality function as the second argument.
+ * By default, state changes are detected using strict equality (`===`). You can
+ * provide a custom equality function as the second argument.
  */
 export declare const createStore: <T>(initialState: T, eq?: Eq<T>) => Store<T>;
 //# sourceMappingURL=Store.d.ts.map