@evolu/common 4.0.5 → 4.1.0

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

@@ -1 +1 @@
-{"version":3,"file":"Public.d.ts","sourceRoot":"","sources":["../../src/Public.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACtE,YAAY,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3D,YAAY,EAAE,oBAAoB,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAClE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAC1C,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACvD,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACnE,cAAc,YAAY,CAAC;AAC3B,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,YAAY,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"Public.d.ts","sourceRoot":"","sources":["../../src/Public.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAC;AAC7B,YAAY,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACtE,YAAY,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3D,YAAY,EAAE,oBAAoB,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAClE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAC1C,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACvD,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,cAAc,YAAY,CAAC;AAC3B,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,YAAY,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/src/Public.js

@@ -1,4 +1,6 @@
+export { sql } from "kysely";
 export { jsonArrayFrom, jsonObjectFrom } from "kysely/helpers/sqlite";
 export { database, table } from "./Db.js";
+export { createIndex } from "./Evolu.js";
 export * from "./Model.js";
 export { canUseDom } from "./Platform.js";

package/dist/src/Sql.d.ts

@@ -1,13 +1,12 @@
-export declare const selectOwner: string;
-export declare const createMessageTable: string;
-export declare const createMessageTableIndex: string;
-export declare const createOwnerTable: string;
-export declare const insertOwner: string;
-export declare const selectOwnerTimestampAndMerkleTree: string;
-export declare const selectLastTimestampForTableRowColumn: string;
-export declare const upsertValueIntoTableRowColumn: (table: string, column: string) => string;
-export declare const deleteTableRow: (table: string) => string;
-export declare const insertIntoMessagesIfNew: string;
-export declare const updateOwnerTimestampAndMerkleTree: string;
-export declare const selectMessagesToSync: string;
+import { SqliteQuery } from "./Sqlite.js";
+export declare const selectOwner: SqliteQuery;
+export declare const createMessageTable: SqliteQuery;
+export declare const createMessageTableIndex: SqliteQuery;
+export declare const createOwnerTable: SqliteQuery;
+export declare const insertOwner: SqliteQuery;
+export declare const selectOwnerTimestampAndMerkleTree: SqliteQuery;
+export declare const selectLastTimestampForTableRowColumn: SqliteQuery;
+export declare const insertIntoMessagesIfNew: SqliteQuery;
+export declare const updateOwnerTimestampAndMerkleTree: SqliteQuery;
+export declare const selectMessagesToSync: SqliteQuery;
 //# sourceMappingURL=Sql.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Sql.d.ts","sourceRoot":"","sources":["../../src/Sql.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,WAAW,QAOhB,CAAC;AAET,eAAO,MAAM,kBAAkB,QASvB,CAAC;AAET,eAAO,MAAM,uBAAuB,QAI5B,CAAC;AAET,eAAO,MAAM,gBAAgB,QASrB,CAAC;AAET,eAAO,MAAM,WAAW,QAWhB,CAAC;AAET,eAAO,MAAM,iCAAiC,QAMtC,CAAC;AAET,eAAO,MAAM,oCAAoC,QAazC,CAAC;AAET,eAAO,MAAM,6BAA6B,UACjC,MAAM,UACL,MAAM,KACb,MASK,CAAC;AAET,eAAO,MAAM,cAAc,UAAW,MAAM,KAAG,MAKvC,CAAC;AAET,eAAO,MAAM,uBAAuB,QAM5B,CAAC;AAET,eAAO,MAAM,iCAAiC,QAKtC,CAAC;AAET,eAAO,MAAM,oBAAoB,QASzB,CAAC"}
+{"version":3,"file":"Sql.d.ts","sourceRoot":"","sources":["../../src/Sql.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,eAAO,MAAM,WAAW,EAAE,WAEzB,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,WAEhC,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,WAErC,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,WAE9B,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,WAEzB,CAAC;AAEF,eAAO,MAAM,iCAAiC,EAAE,WAE/C,CAAC;AAEF,eAAO,MAAM,oCAAoC,EAAE,WAElD,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,WAErC,CAAC;AAEF,eAAO,MAAM,iCAAiC,EAAE,WAE/C,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,WAElC,CAAC"}

package/dist/src/Sql.js

@@ -1,106 +1,30 @@
-// TODO: This file should be generated from a script via Kysely.
-// The reason for not using Kysely directly is bundle size.
-// [Playground Link](https://kyse.link/?p=b&i=haFkpnNxbGl0ZaF2pjAuMjYuMKFz2gFoaW1wb3J0IHsgR2VuZXJhdGVkIH0gZnJvbSAna3lzZWx5JwoKZGVjbGFyZSBnbG9iYWwgewogIGludGVyZmFjZSBEQiB7CiAgICBldm9sdV9tZXNzYWdlOiB7CiAgICAgIHRpbWVzdGFtcDogc3RyaW5nLAogICAgICB0YWJsZTogc3RyaW5nLAogICAgICByb3c6IHN0cmluZywKICAgICAgY29sdW1uOiBzdHJpbmcsCiAgICAgIHZhbHVlOiB1bmtub3duCiAgICB9LAoKICAgIGV2b2x1X293bmVyOiB7CiAgICAgIGlkOiBzdHJpbmcKICAgICAgbW5lbW9uaWM6IHN0cmluZwogICAgICBlbmNyeXB0aW9uS2V5OiBVaW50OEFycmF5LAogICAgICB0aW1lc3RhbXA6IHN0cmluZywKICAgICAgbWVya2xlVHJlZTogc3RyaW5nCiAgICB9CiAgfQp9oXHaBnhhd2FpdCBreXNlbHkuc2VsZWN0RnJvbSgiZXZvbHVfb3duZXIiKQogIC5zZWxlY3QoWyJpZCIsICJtbmVtb25pYyIsICJlbmNyeXB0aW9uS2V5Il0pCiAgLmV4ZWN1dGUoKQoKYXdhaXQga3lzZWx5LnNjaGVtYQogIC5jcmVhdGVUYWJsZSgnZXZvbHVfbWVzc2FnZScpCiAgLmFkZENvbHVtbigndGltZXN0YW1wJywgJ2Jsb2InLCBjb2wgPT4gY29sLnByaW1hcnlLZXkoKSkKICAuYWRkQ29sdW1uKCd0YWJsZScsICdibG9iJykKICAuYWRkQ29sdW1uKCdyb3cnLCAnYmxvYicpCiAgLmFkZENvbHVtbignY29sdW1uJywgJ2Jsb2InKQogIC5hZGRDb2x1bW4oJ3ZhbHVlJywgJ2Jsb2InKQogIC5leGVjdXRlKCkKCmF3YWl0IGt5c2VseS5zY2hlbWEKICAuY3JlYXRlSW5kZXgoImluZGV4X2V2b2x1X21lc3NhZ2UiKQogIC5vbigiZXZvbHVfbWVzc2FnZSIpCiAgLmNvbHVtbnMoWyJ0YWJsZSIsICJyb3ciLCAiY29sdW1uIiwgInRpbWVzdGFtcCJdKQogIC5leGVjdXRlKCkKCmF3YWl0IGt5c2VseS5zY2hlbWEKICAuY3JlYXRlVGFibGUoJ2V2b2x1X19vd25lcicpCiAgLmFkZENvbHVtbignaWQnLCAnYmxvYicpCiAgLmFkZENvbHVtbignbW5lbW9uaWMnLCAnYmxvYicpCiAgLmFkZENvbHVtbignZW5jcnlwdGlvbktleScsICdibG9iJykKICAuYWRkQ29sdW1uKCd0aW1lc3RhbXAnLCAnYmxvYicpCiAgLmFkZENvbHVtbignbWVya2xlVHJlZScsICdibG9iJykKICAuZXhlY3V0ZSgpCgphd2FpdCBreXNlbHkuaW5zZXJ0SW50bygiZXZvbHVfb3duZXIiKQogIC52YWx1ZXMoewogICAgImlkIjogImIiLAogICAgIm1uZW1vbmljIjogImEiLAogICAgImVuY3J5cHRpb25LZXkiOiBuZXcgVWludDhBcnJheSgpLAogICAgInRpbWVzdGFtcCI6ICJhIiwKICAgICJtZXJrbGVUcmVlIjogImIiCiAgfSkKICAuZXhlY3V0ZSgpCgphd2FpdCBreXNlbHkuc2VsZWN0RnJvbSgiZXZvbHVfb3duZXIiKQogIC5zZWxlY3QoWyJ0aW1lc3RhbXAiLCAibWVya2xlVHJlZSJdKQogIC5leGVjdXRlKCkKCmF3YWl0IGt5c2VseS5zZWxlY3RGcm9tKCJldm9sdV9tZXNzYWdlIikKICAuc2VsZWN0KCJ0aW1lc3RhbXAiKQogIC53aGVyZSgndGFibGUnLCAnPScsICcxJykKICAud2hlcmUoJ3JvdycsICc9JywgJzInKQogIC53aGVyZSgnY29sdW1uJywgJz0nLCAnMycpCiAgLm9yZGVyQnkoInRpbWVzdGFtcCIsICJkZXNjIikKICAubGltaXQoMSkKICAuZXhlY3V0ZVRha2VGaXJzdCgpCgphd2FpdCBreXNlbHkuaW5zZXJ0SW50bygiZXZvbHVfbWVzc2FnZSIpCiAgLnZhbHVlcyh7CiAgICAidGltZXN0YW1wIjogJzEnLAogICAgInRhYmxlIjogJzInLAogICAgInJvdyI6ICczJywKICAgICJjb2x1bW4iOiAnNCcsCiAgICAidmFsdWUiOiAnNScsCiAgfSkKICAub25Db25mbGljdChvYyA9PiBvYy5kb05vdGhpbmcoKSkKICAuZXhlY3V0ZSgpCgphd2FpdCBreXNlbHkudXBkYXRlVGFibGUoImV2b2x1X293bmVyIikKICAuc2V0KHsKICAgICJtZXJrbGVUcmVlIjogJzEnLAogICAgInRpbWVzdGFtcCI6ICIyIgogIH0pCiAgLmV4ZWN1dGUoKQoKYXdhaXQga3lzZWx5LnNlbGVjdEZyb20oImV2b2x1X21lc3NhZ2UiKQogIC5zZWxlY3RBbGwoKQogIC53aGVyZSgidGltZXN0YW1wIiwgIj49IiwgJzEnKQogIC5vcmRlckJ5KCJ0aW1lc3RhbXAiKQogIC5leGVjdXRlKCmhY8M=)
-export const selectOwner = `
-select
-  "id",
-  "mnemonic",
-  "encryptionKey"
-from
-  "evolu_owner"
-`.trim();
-export const createMessageTable = `
-create table
-  "evolu_message" (
-    "timestamp" blob primary key,
-    "table" blob,
-    "row" blob,
-    "column" blob,
-    "value" blob
-  );
-`.trim();
-export const createMessageTableIndex = `
-create index "index_evolu_message" on "evolu_message" (
-  "table", "row", "column", "timestamp"
-);
-`.trim();
-export const createOwnerTable = `
-create table
-  "evolu_owner" (
-    "id" blob,
-    "mnemonic" blob,
-    "encryptionKey" blob,
-    "timestamp" blob,
-    "merkleTree" blob
-  );
-`.trim();
-export const insertOwner = `
-insert into
-  "evolu_owner" (
-    "id",
-    "mnemonic",
-    "encryptionKey",
-    "timestamp",
-    "merkleTree"
-  )
-values
-  (?, ?, ?, ?, ?);
-`.trim();
-export const selectOwnerTimestampAndMerkleTree = `
-select
-  "timestamp",
-  "merkleTree"
-from
-  "evolu_owner"
-`.trim();
-export const selectLastTimestampForTableRowColumn = `
-select
-  "timestamp"
-from
-  "evolu_message"
-where
-  "table" = ?
-  and "row" = ?
-  and "column" = ?
-order by
-  "timestamp" desc
-limit
-  1
-`.trim();
-export const upsertValueIntoTableRowColumn = (table, column) => `
-insert into
-  "${table}" ("id", "${column}", "createdAt", "updatedAt")
-values
-  (?, ?, ?, ?)
-on conflict do update set
-  "${column}" = ?,
-  "updatedAt" = ?
-`.trim();
-export const deleteTableRow = (table) => `
-delete from "${table}"
-where
-  "id" = ?;
-`.trim();
-export const insertIntoMessagesIfNew = `
-insert into
-  "evolu_message" ("timestamp", "table", "row", "column", "value")
-values
-  (?, ?, ?, ?, ?)
-on conflict do nothing
-`.trim();
-export const updateOwnerTimestampAndMerkleTree = `
-update "evolu_owner"
-set
-  "timestamp" = ?,
-  "merkleTree" = ?
-`.trim();
-export const selectMessagesToSync = `
-select
-  *
-from
-  "evolu_message"
-where
-  "timestamp" >= ?
-order by
-  "timestamp"
-`.trim();
+export const selectOwner = {
+    sql: `select "id", "mnemonic", "encryptionKey" from "evolu_owner"`,
+};
+export const createMessageTable = {
+    sql: `create table "evolu_message" ("timestamp" blob primary key, "table" blob, "row" blob, "column" blob, "value" blob)`,
+};
+export const createMessageTableIndex = {
+    sql: `create index "index_evolu_message" on "evolu_message" ("table", "row", "column", "timestamp" desc)`,
+};
+export const createOwnerTable = {
+    sql: `create table "evolu_owner" ("id" blob, "mnemonic" blob, "encryptionKey" blob, "timestamp" blob, "merkleTree" blob)`,
+};
+export const insertOwner = {
+    sql: `insert into "evolu_owner" ("id", "mnemonic", "encryptionKey", "timestamp", "merkleTree") values (?, ?, ?, ?, ?)`,
+};
+export const selectOwnerTimestampAndMerkleTree = {
+    sql: `select "timestamp", "merkleTree" from "evolu_owner"`,
+};
+export const selectLastTimestampForTableRowColumn = {
+    sql: `select "timestamp" from "evolu_message" where "table" = ? and "row" = ? and "column" = ? order by "timestamp" desc limit ?`,
+};
+export const insertIntoMessagesIfNew = {
+    sql: `insert into "evolu_message" ("timestamp", "table", "row", "column", "value") values (?, ?, ?, ?, ?) on conflict do nothing`,
+};
+export const updateOwnerTimestampAndMerkleTree = {
+    sql: `update "evolu_owner" set "merkleTree" = ?, "timestamp" = ?`,
+};
+export const selectMessagesToSync = {
+    sql: `select * from "evolu_message" where "timestamp" >= ? order by "timestamp"`,
+};

package/dist/src/Sqlite.d.ts

@@ -1,13 +1,20 @@
 import * as Context from "effect/Context";
 import * as Effect from "effect/Effect";
+import { Equivalence } from "effect/Equivalence";
 import * as Predicate from "effect/Predicate";
 export interface Sqlite {
-    readonly exec: (arg: string | SqliteQuery) => Effect.Effect<SqliteExecResult>;
+    readonly exec: (query: SqliteQuery) => Effect.Effect<SqliteExecResult>;
 }
 export declare const Sqlite: Context.Tag<Sqlite, Sqlite>;
 export interface SqliteQuery {
     readonly sql: string;
-    readonly parameters: Value[];
+    readonly parameters?: Value[];
+    readonly options?: SqliteQueryOptions;
+}
+export interface SqliteQueryOptions {
+    readonly logQueryExecutionTime?: boolean;
+    /** https://www.sqlite.org/eqp.html */
+    readonly logExplainQueryPlan?: boolean;
 }
 export type Value = SqliteValue | JsonObjectOrArray;
 export type SqliteValue = null | string | number | Uint8Array;
@@ -25,9 +32,28 @@ export interface SqliteExecResult {
 export type SqliteRow = Record<string, SqliteValue>;
 export declare const isJsonObjectOrArray: Predicate.Refinement<Value, JsonObjectOrArray>;
 export declare const valuesToSqliteValues: (values: ReadonlyArray<Value>) => SqliteValue[];
-export declare const ensureSqliteQuery: (arg: string | SqliteQuery) => SqliteQuery;
 export declare const maybeParseJson: (rows: SqliteRow[]) => SqliteRow[];
 export declare const maybeJson: Predicate.Predicate<string>;
 export declare const isSqlMutation: (sql: string) => boolean;
+export declare const maybeLogSqliteQueryExecutionTime: (query: SqliteQuery) => <A, E, R>(effect: Effect.Effect<A, E, R>) => Effect.Effect<A, E, R>;
+export type SqliteQueryPlanRow = {
+    id: number;
+    parent: number;
+    detail: string;
+};
+export declare const drawSqliteQueryPlan: (rows: SqliteQueryPlanRow[]) => string;
+export interface SqliteSchema {
+    readonly tables: ReadonlyArray<Table>;
+    readonly indexes: ReadonlyArray<Index>;
+}
+export interface Table {
+    readonly name: string;
+    readonly columns: ReadonlyArray<string>;
+}
+export interface Index {
+    readonly name: string;
+    readonly sql: string;
+}
+export declare const indexEquivalence: Equivalence<Index>;
 export {};
 //# sourceMappingURL=Sqlite.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Sqlite.d.ts","sourceRoot":"","sources":["../../src/Sqlite.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAC;AAC1C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,SAAS,MAAM,kBAAkB,CAAC;AAE9C,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,KAAK,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;CAC/E;AAED,eAAO,MAAM,MAAM,6BAAiD,CAAC;AAErE,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,UAAU,EAAE,KAAK,EAAE,CAAC;CAC9B;AAED,MAAM,MAAM,KAAK,GAAG,WAAW,GAAG,iBAAiB,CAAC;AACpD,MAAM,MAAM,WAAW,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,CAAC;AAC9D,MAAM,MAAM,iBAAiB,GAAG,UAAU,GAAG,SAAS,CAAC;AACvD,KAAK,UAAU,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC;AAC1C,KAAK,SAAS,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;AACrC,KAAK,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;AACtD,KAAK,IAAI,GAAG,aAAa,GAAG,UAAU,GAAG,SAAS,CAAC;AAEnD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AAEpD,eAAO,MAAM,mBAAmB,EAAE,SAAS,CAAC,UAAU,CACpD,KAAK,EACL,iBAAiB,CAE4D,CAAC;AAEhF,eAAO,MAAM,oBAAoB,WACvB,cAAc,KAAK,CAAC,KAC3B,WAAW,EAGX,CAAC;AAEJ,eAAO,MAAM,iBAAiB,QAAS,MAAM,GAAG,WAAW,KAAG,WAG7D,CAAC;AAEF,eAAO,MAAM,cAAc,SAAU,SAAS,EAAE,KAAG,SAAS,EAC1C,CAAC;AA0BnB,eAAO,MAAM,SAAS,EAAE,SAAS,CAAC,SAAS,CAAC,MAAM,CACpB,CAAC;AAoB/B,eAAO,MAAM,aAAa,QAAS,MAAM,KAAG,OACd,CAAC"}
+{"version":3,"file":"Sqlite.d.ts","sourceRoot":"","sources":["../../src/Sqlite.ts"],"names":[],"mappings":"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"}

package/dist/src/Sqlite.js

@@ -1,13 +1,9 @@
 import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
 import * as Predicate from "effect/Predicate";
 export const Sqlite = Context.GenericTag("@services/Sqlite");
 export const isJsonObjectOrArray = (value) => value !== null && typeof value === "object" && !Predicate.isUint8Array(value);
 export const valuesToSqliteValues = (values) => values.map((value) => isJsonObjectOrArray(value) ? JSON.stringify(value) : value);
-export const ensureSqliteQuery = (arg) => {
-    if (typeof arg !== "string")
-        return arg;
-    return { sql: arg, parameters: [] };
-};
 export const maybeParseJson = (rows) => parseArray(rows);
 const parseArray = (a) => {
     for (let i = 0; i < a.length; ++i)
@@ -51,3 +47,27 @@ const isSqlMutationRegEx = new RegExp(`\\b(${[
     "update",
 ].join("|")})\\b`);
 export const isSqlMutation = (sql) => isSqlMutationRegEx.test(sql);
+export const maybeLogSqliteQueryExecutionTime = (query) => (effect) => {
+    if (!query.options?.logQueryExecutionTime)
+        return effect;
+    return effect.pipe(Effect.tap(() => Effect.log("QueryExecutionTime")), 
+    // Not using Effect.log because of formating
+    // eslint-disable-next-line no-console
+    Effect.tap(() => console.log(query.sql)), Effect.withLogSpan("duration"));
+};
+export 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 no-constant-condition
+    } while (true);
+    return `${"  ".repeat(indent)}${row.detail}`;
+})
+    .join("\n");
+export const indexEquivalence = (self, that) => self.name === that.name && self.sql === that.sql;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@evolu/common",
-  "version": "4.0.5",
+  "version": "4.1.0",
   "description": "Local-first platform designed for privacy, ease of use, and no vendor lock-in to sync and backup people's lifetime data",
   "keywords": [
     "evolu",
@@ -52,20 +52,20 @@
     "nanoid": "^5.0.6"
   },
   "devDependencies": {
-    "@effect/schema": "^0.64.5",
+    "@effect/schema": "^0.64.9",
     "@protobuf-ts/plugin": "^2.9.4",
     "@protobuf-ts/protoc": "^2.9.4",
     "array-shuffle": "^3.0.0",
-    "effect": "2.4.7",
+    "effect": "2.4.9",
     "eslint": "^8.57.0",
-    "typescript": "^5.4.2",
+    "typescript": "^5.4.3",
     "vitest": "^1.4.0",
     "@evolu/tsconfig": "0.0.2",
     "eslint-config-evolu": "1.0.0"
   },
   "peerDependencies": {
-    "@effect/schema": "^0.64.5",
-    "effect": "2.4.7"
+    "@effect/schema": "^0.64.9",
+    "effect": "2.4.9"
   },
   "publishConfig": {
     "access": "public"

package/src/Config.ts

@@ -1,5 +1,6 @@
 import * as Context from "effect/Context";
 import * as Layer from "effect/Layer";
+import { CreateIndexBuilder } from "kysely";
 
 export interface Config {
   /** Alternate URL to Evolu sync and backup server. */
@@ -23,6 +24,24 @@ export interface Config {
    * default value is: "Evolu".
    */
   readonly name: string;
+
+  /**
+   * Use the `indexes` property to define SQLite indexes.
+   *
+   * Table and column names are not typed because Kysely doesn't support it.
+   *
+   * https://medium.com/@JasonWyatt/squeezing-performance-from-sqlite-indexes-indexes-c4e175f3c346
+   *
+   * @example
+   *   const indexes = [
+   *     createIndex("indexTodoCreatedAt").on("todo").column("createdAt"),
+   *
+   *     createIndex("indexTodoCategoryCreatedAt")
+   *       .on("todoCategory")
+   *       .column("createdAt"),
+   *   ];
+   */
+  readonly indexes: ReadonlyArray<CreateIndexBuilder<any>>;
 }
 
 export const Config = Context.GenericTag<Config>("@services/Config");
@@ -35,6 +54,7 @@ export const ConfigLive = (config?: Partial<Config>): Layer.Layer<Config> =>
       maxDrift: 5 * 60 * 1000,
       reloadUrl: "/",
       name: "Evolu",
+      indexes: [],
       ...config,
     }),
   );