@evolu/common 5.4.7 → 6.0.0

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

@@ -0,0 +1,18 @@
+/**
+ * 💾
+ *
+ * @module
+ */
+export { createEvolu } from "./Evolu.js";
+export type { Evolu, EvoluConfigWithInitialData, EvoluDeps, EvoluError, } from "./Evolu.js";
+export * from "./Owner.js";
+export { binaryIdToId, idToBinaryId } from "./Protocol.js";
+export type { BinaryId } from "./Protocol.js";
+export * as kysely from "./PublicKysely.js";
+export type { InferRow, Query, QueryRows, Row } from "./Query.js";
+export { formatValidMutationSizeError } from "./Schema.js";
+export type { EvoluSchema, ValidMutationSizeError } from "./Schema.js";
+export type { NetworkError, PaymentRequiredError, ServerError, SyncState, SyncStateInitial, SyncStateIsNotSynced, SyncStateIsSynced, SyncStateIsSyncing, } from "./Sync.js";
+export { binaryTimestampToTimestamp, Timestamp, timestampToBinaryTimestamp, } from "./Timestamp.js";
+export type { BinaryTimestamp, TimestampCounterOverflowError, TimestampDriftError, TimestampDuplicateNodeError, TimestampError, TimestampTimeOutOfRangeError, } from "./Timestamp.js";
+//# sourceMappingURL=Public.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Public.d.ts","sourceRoot":"","sources":["../../../src/Evolu/Public.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,YAAY,EACV,KAAK,EACL,0BAA0B,EAC1B,SAAS,EACT,UAAU,GACX,MAAM,YAAY,CAAC;AACpB,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC3D,YAAY,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,YAAY,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AAClE,OAAO,EAAE,4BAA4B,EAAE,MAAM,aAAa,CAAC;AAC3D,YAAY,EAAE,WAAW,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACvE,YAAY,EACV,YAAY,EACZ,oBAAoB,EACpB,WAAW,EACX,SAAS,EACT,gBAAgB,EAChB,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,0BAA0B,EAC1B,SAAS,EACT,0BAA0B,GAC3B,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACV,eAAe,EACf,6BAA6B,EAC7B,mBAAmB,EACnB,2BAA2B,EAC3B,cAAc,EACd,4BAA4B,GAC7B,MAAM,gBAAgB,CAAC"}

package/dist/src/Evolu/Public.js

@@ -0,0 +1,11 @@
+/**
+ * 💾
+ *
+ * @module
+ */
+export { createEvolu } from "./Evolu.js";
+export * from "./Owner.js";
+export { binaryIdToId, idToBinaryId } from "./Protocol.js";
+export * as kysely from "./PublicKysely.js";
+export { formatValidMutationSizeError } from "./Schema.js";
+export { binaryTimestampToTimestamp, Timestamp, timestampToBinaryTimestamp, } from "./Timestamp.js";

package/dist/src/Evolu/PublicKysely.d.ts

@@ -0,0 +1,148 @@
+import { AliasableExpression, Expression, RawBuilder, SelectQueryNode, Simplify } from "kysely";
+export { sql } from "kysely";
+export type { NotNull } from "kysely";
+/**
+ * A SQLite helper for aggregating a subquery into a JSON array.
+ *
+ * ### Examples
+ *
+ * ```ts
+ * import { kysely } from "@evolu/common";
+ *
+ * // TODO: Update for Evolu
+ * const result = await db
+ *   .selectFrom("person")
+ *   .select((eb) => [
+ *     "id",
+ *     kysely
+ *       .jsonArrayFrom(
+ *         eb
+ *           .selectFrom("pet")
+ *           .select(["pet.id as pet_id", "pet.name"])
+ *           .whereRef("pet.owner_id", "=", "person.id")
+ *           .orderBy("pet.name"),
+ *       )
+ *       .as("pets"),
+ *   ])
+ *   .execute();
+ *
+ * result[0]?.id;
+ * result[0]?.pets[0].pet_id;
+ * result[0]?.pets[0].name;
+ * ```
+ *
+ * The generated SQL (SQLite):
+ *
+ * ```sql
+ * select "id", (
+ *   select coalesce(json_group_array(json_object(
+ *     'pet_id', "agg"."pet_id",
+ *     'name', "agg"."name"
+ *   )), '[]') from (
+ *     select "pet"."id" as "pet_id", "pet"."name"
+ *     from "pet"
+ *     where "pet"."owner_id" = "person"."id"
+ *     order by "pet"."name"
+ *   ) as "agg"
+ * ) as "pets"
+ * from "person"
+ * ```
+ */
+export declare function jsonArrayFrom<O>(expr: SelectQueryBuilderExpression<O>): RawBuilder<Array<Simplify<O>>>;
+/**
+ * A SQLite helper for turning a subquery into a JSON object.
+ *
+ * The subquery must only return one row.
+ *
+ * ### Examples
+ *
+ * ```ts
+ * import { kysely } from "@evolu/common";
+ *
+ * // TODO: Update for Evolu
+ * const result = await db
+ *   .selectFrom("person")
+ *   .select((eb) => [
+ *     "id",
+ *     jsonObjectFrom(
+ *       eb
+ *         .selectFrom("pet")
+ *         .select(["pet.id as pet_id", "pet.name"])
+ *         .whereRef("pet.owner_id", "=", "person.id")
+ *         .where("pet.is_favorite", "=", true),
+ *     ).as("favorite_pet"),
+ *   ])
+ *   .execute();
+ *
+ * result[0]?.id;
+ * result[0]?.favorite_pet?.pet_id;
+ * result[0]?.favorite_pet?.name;
+ * ```
+ *
+ * The generated SQL (SQLite):
+ *
+ * ```sql
+ * select "id", (
+ *   select json_object(
+ *     'pet_id', "obj"."pet_id",
+ *     'name', "obj"."name"
+ *   ) from (
+ *     select "pet"."id" as "pet_id", "pet"."name"
+ *     from "pet"
+ *     where "pet"."owner_id" = "person"."id"
+ *     and "pet"."is_favorite" = ?
+ *   ) as obj
+ * ) as "favorite_pet"
+ * from "person";
+ * ```
+ */
+export declare function jsonObjectFrom<O>(expr: SelectQueryBuilderExpression<O>): RawBuilder<Simplify<O> | null>;
+/**
+ * The SQLite `json_object` function.
+ *
+ * ### Examples
+ *
+ * ```ts
+ * import { kysely } from "@evolu/common";
+ *
+ * // TODO: Update for Evolu
+ * const result = await db
+ *   .selectFrom("person")
+ *   .select((eb) => [
+ *     "id",
+ *     kysely
+ *       .jsonBuildObject({
+ *         first: eb.ref("first_name"),
+ *         last: eb.ref("last_name"),
+ *         full: kysely.sql<string>`first_name || ' ' || last_name`,
+ *       })
+ *       .as("name"),
+ *   ])
+ *   .execute();
+ *
+ * result[0]?.id;
+ * result[0]?.name.first;
+ * result[0]?.name.last;
+ * result[0]?.name.full;
+ * ```
+ *
+ * The generated SQL (SQLite):
+ *
+ * ```sql
+ * select "id", json_object(
+ *   'first', first_name,
+ *   'last', last_name,
+ *   'full', "first_name" || ' ' || "last_name"
+ * ) as "name"
+ * from "person"
+ * ```
+ */
+export declare function jsonBuildObject<O extends Record<string, Expression<unknown>>>(obj: O): RawBuilder<Simplify<{
+    [K in keyof O]: O[K] extends Expression<infer V> ? V : never;
+}>>;
+interface SelectQueryBuilderExpression<O> extends AliasableExpression<O> {
+    get isSelectQueryBuilder(): true;
+    toOperationNode(): SelectQueryNode;
+}
+export declare function getJsonObjectArgs(node: SelectQueryNode, table: string): Array<Expression<unknown> | string>;
+//# sourceMappingURL=PublicKysely.d.ts.map

package/dist/src/Evolu/PublicKysely.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PublicKysely.d.ts","sourceRoot":"","sources":["../../../src/Evolu/PublicKysely.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EAGnB,UAAU,EAGV,UAAU,EAEV,eAAe,EACf,QAAQ,EAIT,MAAM,QAAQ,CAAC;AAGhB,OAAO,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAC;AAC7B,YAAY,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAEtC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AAGH,wBAAgB,aAAa,CAAC,CAAC,EAC3B,IAAI,EAAE,4BAA4B,CAAC,CAAC,CAAC,GACpC,UAAU,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAIhC;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AAGH,wBAAgB,cAAc,CAAC,CAAC,EAC5B,IAAI,EAAE,4BAA4B,CAAC,CAAC,CAAC,GACpC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAIhC;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAGH,wBAAgB,eAAe,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC,EACzE,GAAG,EAAE,CAAC,GACL,UAAU,CACX,QAAQ,CAAC;KACN,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,UAAU,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK;CAC7D,CAAC,CACH,CAIA;AAEH,UAAU,4BAA4B,CAAC,CAAC,CAAE,SAAQ,mBAAmB,CAAC,CAAC,CAAC;IACtE,IAAI,oBAAoB,IAAI,IAAI,CAAC;IACjC,eAAe,IAAI,eAAe,CAAC;CACpC;AAeD,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,eAAe,EACrB,KAAK,EAAE,MAAM,GACZ,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,GAAG,MAAM,CAAC,CAoBrC"}

package/dist/src/Evolu/PublicKysely.js

@@ -0,0 +1,185 @@
+import { AliasNode, ColumnNode, ExpressionWrapper, IdentifierNode, ReferenceNode, sql, TableNode, ValueNode, } from "kysely";
+import { kyselyJsonIdentifier } from "./Diff.js";
+export { sql } from "kysely";
+/**
+ * A SQLite helper for aggregating a subquery into a JSON array.
+ *
+ * ### Examples
+ *
+ * ```ts
+ * import { kysely } from "@evolu/common";
+ *
+ * // TODO: Update for Evolu
+ * const result = await db
+ *   .selectFrom("person")
+ *   .select((eb) => [
+ *     "id",
+ *     kysely
+ *       .jsonArrayFrom(
+ *         eb
+ *           .selectFrom("pet")
+ *           .select(["pet.id as pet_id", "pet.name"])
+ *           .whereRef("pet.owner_id", "=", "person.id")
+ *           .orderBy("pet.name"),
+ *       )
+ *       .as("pets"),
+ *   ])
+ *   .execute();
+ *
+ * result[0]?.id;
+ * result[0]?.pets[0].pet_id;
+ * result[0]?.pets[0].name;
+ * ```
+ *
+ * The generated SQL (SQLite):
+ *
+ * ```sql
+ * select "id", (
+ *   select coalesce(json_group_array(json_object(
+ *     'pet_id', "agg"."pet_id",
+ *     'name', "agg"."name"
+ *   )), '[]') from (
+ *     select "pet"."id" as "pet_id", "pet"."name"
+ *     from "pet"
+ *     where "pet"."owner_id" = "person"."id"
+ *     order by "pet"."name"
+ *   ) as "agg"
+ * ) as "pets"
+ * from "person"
+ * ```
+ */
+// SQL formatting breaks generated SQL for some reason.
+// prettier-ignore
+export function jsonArrayFrom(expr) {
+    return sql `(select ${sql.lit(kyselyJsonIdentifier)} || coalesce(json_group_array(json_object(${sql.join(getSqliteJsonObjectArgs(expr.toOperationNode(), 'agg'))})), '[]') from ${expr} as agg)`;
+}
+/**
+ * A SQLite helper for turning a subquery into a JSON object.
+ *
+ * The subquery must only return one row.
+ *
+ * ### Examples
+ *
+ * ```ts
+ * import { kysely } from "@evolu/common";
+ *
+ * // TODO: Update for Evolu
+ * const result = await db
+ *   .selectFrom("person")
+ *   .select((eb) => [
+ *     "id",
+ *     jsonObjectFrom(
+ *       eb
+ *         .selectFrom("pet")
+ *         .select(["pet.id as pet_id", "pet.name"])
+ *         .whereRef("pet.owner_id", "=", "person.id")
+ *         .where("pet.is_favorite", "=", true),
+ *     ).as("favorite_pet"),
+ *   ])
+ *   .execute();
+ *
+ * result[0]?.id;
+ * result[0]?.favorite_pet?.pet_id;
+ * result[0]?.favorite_pet?.name;
+ * ```
+ *
+ * The generated SQL (SQLite):
+ *
+ * ```sql
+ * select "id", (
+ *   select json_object(
+ *     'pet_id', "obj"."pet_id",
+ *     'name', "obj"."name"
+ *   ) from (
+ *     select "pet"."id" as "pet_id", "pet"."name"
+ *     from "pet"
+ *     where "pet"."owner_id" = "person"."id"
+ *     and "pet"."is_favorite" = ?
+ *   ) as obj
+ * ) as "favorite_pet"
+ * from "person";
+ * ```
+ */
+// SQL formatting breaks generated SQL for some reason.
+// prettier-ignore
+export function jsonObjectFrom(expr) {
+    return sql `(select ${sql.lit(kyselyJsonIdentifier)} || json_object(${sql.join(getSqliteJsonObjectArgs(expr.toOperationNode(), 'obj'))}) from ${expr} as obj)`;
+}
+/**
+ * The SQLite `json_object` function.
+ *
+ * ### Examples
+ *
+ * ```ts
+ * import { kysely } from "@evolu/common";
+ *
+ * // TODO: Update for Evolu
+ * const result = await db
+ *   .selectFrom("person")
+ *   .select((eb) => [
+ *     "id",
+ *     kysely
+ *       .jsonBuildObject({
+ *         first: eb.ref("first_name"),
+ *         last: eb.ref("last_name"),
+ *         full: kysely.sql<string>`first_name || ' ' || last_name`,
+ *       })
+ *       .as("name"),
+ *   ])
+ *   .execute();
+ *
+ * result[0]?.id;
+ * result[0]?.name.first;
+ * result[0]?.name.last;
+ * result[0]?.name.full;
+ * ```
+ *
+ * The generated SQL (SQLite):
+ *
+ * ```sql
+ * select "id", json_object(
+ *   'first', first_name,
+ *   'last', last_name,
+ *   'full', "first_name" || ' ' || "last_name"
+ * ) as "name"
+ * from "person"
+ * ```
+ */
+// SQL formatting breaks generated SQL for some reason.
+// prettier-ignore
+export function jsonBuildObject(obj) {
+    return sql `${sql.lit(kyselyJsonIdentifier)} || json_object(${sql.join(Object.keys(obj).flatMap((k) => [sql.lit(k), obj[k]]))})`;
+}
+function getSqliteJsonObjectArgs(node, table) {
+    try {
+        return getJsonObjectArgs(node, table);
+    }
+    catch {
+        throw new Error("SQLite jsonArrayFrom and jsonObjectFrom functions can only handle explicit selections due to limitations of the json_object function. selectAll() is not allowed in the subquery.");
+    }
+}
+export function getJsonObjectArgs(node, table) {
+    const args = [];
+    args.push(kyselyJsonIdentifier, kyselyJsonIdentifier);
+    for (const { selection: s } of node.selections ?? []) {
+        if (ReferenceNode.is(s) && ColumnNode.is(s.column)) {
+            args.push(colName(s.column.column.name), colRef(table, s.column.column.name));
+        }
+        else if (ColumnNode.is(s)) {
+            args.push(colName(s.column.name), colRef(table, s.column.name));
+        }
+        else if (AliasNode.is(s) && IdentifierNode.is(s.alias)) {
+            args.push(colName(s.alias.name), colRef(table, s.alias.name));
+        }
+        else {
+            throw new Error(`can't extract column names from the select query node`);
+        }
+    }
+    return args;
+}
+function colName(col) {
+    return new ExpressionWrapper(ValueNode.createImmediate(col));
+}
+function colRef(table, col) {
+    return new ExpressionWrapper(ReferenceNode.create(ColumnNode.create(col), TableNode.create(table)));
+}

package/dist/src/Evolu/Query.d.ts

@@ -0,0 +1,63 @@
+import { SqliteQuery, SqliteRow, SqliteValue } from "../Sqlite.js";
+import { Store, StoreSubscribe } from "../Store.js";
+import { Brand, Simplify } from "../Types.js";
+/**
+ * A type-safe SQL query.
+ *
+ * ### Example
+ *
+ * ```ts
+ * const allTodos = evolu.createQuery((db) =>
+ *   db.selectFrom("todo").selectAll(),
+ * );
+ * type AllTodosRow = typeof allTodos.Row;
+ * ```
+ */
+export type Query<R extends Row = Row> = string & Brand<"Query"> & {
+    /**
+     * A shorthand for {@link InferRow}.
+     *
+     * ### Example
+     *
+     * ```ts
+     * const allTodos = evolu.createQuery((db) =>
+     *   db.selectFrom("todo").selectAll(),
+     * );
+     * type AllTodosRow = typeof allTodos.Row;
+     * ```
+     */
+    Row: R;
+};
+/**
+ * Evolu serializes {@link SqliteQuery} into a string to be easily used as a key
+ * and for comparison.
+ */
+export declare const serializeQuery: <R extends Row>(query: SqliteQuery) => Query<R>;
+export declare const deserializeQuery: <R extends Row>(query: Query<R>) => SqliteQuery;
+export type InferRow<T extends Query> = T extends Query<infer R> ? R : never;
+export interface Row {
+    readonly [key: string]: SqliteValue | Row | ReadonlyArray<Row>;
+}
+export declare const emptyRows: ReadonlyArray<Row>;
+/** Rows returned by a query. */
+export type QueryRows<R extends Row = Row> = ReadonlyArray<Readonly<Simplify<R>>>;
+export type Queries<R extends Row = Row> = ReadonlyArray<Query<R>>;
+export type QueriesToQueryRows<Q extends Queries> = {
+    [P in keyof Q]: Q[P] extends Query<infer R> ? QueryRows<R> : never;
+};
+export type QueriesToQueryRowsPromises<Q extends Queries> = {
+    [P in keyof Q]: Q[P] extends Query<infer R> ? Promise<QueryRows<R>> : never;
+};
+export type QueryRowsMap = ReadonlyMap<Query, ReadonlyArray<Row>>;
+export interface QueryRowsCache {
+    readonly set: (queriesRows: ReadonlyArray<readonly [Query, ReadonlyArray<SqliteRow>]>) => void;
+    readonly get: () => QueryRowsMap;
+}
+export declare const createQueryRowsCache: () => QueryRowsCache;
+export interface SubscribedQueries {
+    subscribe: (query: Query) => StoreSubscribe;
+    has: (query: Query) => boolean;
+    get: () => ReadonlyArray<Query>;
+}
+export declare const createSubscribedQueries: (rowsStore: Store<QueryRowsMap>) => SubscribedQueries;
+//# sourceMappingURL=Query.d.ts.map

package/dist/src/Evolu/Query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Query.d.ts","sourceRoot":"","sources":["../../../src/Evolu/Query.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,WAAW,EAEX,SAAS,EACT,WAAW,EACZ,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE9C;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,KAAK,CAAC,CAAC,SAAS,GAAG,GAAG,GAAG,IAAI,MAAM,GAC7C,KAAK,CAAC,OAAO,CAAC,GAAG;IACf;;;;;;;;;;;OAWG;IACH,GAAG,EAAE,CAAC,CAAC;CACR,CAAC;AAEJ;;;GAGG;AACH,eAAO,MAAM,cAAc,GAAI,CAAC,SAAS,GAAG,EAAE,OAAO,WAAW,KAAG,KAAK,CAAC,CAAC,CAYzE,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAI,CAAC,SAAS,GAAG,EAC5C,OAAO,KAAK,CAAC,CAAC,CAAC,KACd,WAoBF,CAAC;AAEF,MAAM,MAAM,QAAQ,CAAC,CAAC,SAAS,KAAK,IAAI,CAAC,SAAS,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;AAE7E,MAAM,WAAW,GAAG;IAClB,QAAQ,EAAE,GAAG,EAAE,MAAM,GACjB,WAAW,GACX,GAAG,GACH,aAAa,CAAC,GAAG,CAAC,CAAC;CACxB;AAGD,eAAO,MAAM,SAAS,EAAE,aAAa,CAAC,GAAG,CAAM,CAAC;AAEhD,gCAAgC;AAChC,MAAM,MAAM,SAAS,CAAC,CAAC,SAAS,GAAG,GAAG,GAAG,IAAI,aAAa,CACxD,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CACtB,CAAC;AAEF,MAAM,MAAM,OAAO,CAAC,CAAC,SAAS,GAAG,GAAG,GAAG,IAAI,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AAEnE,MAAM,MAAM,kBAAkB,CAAC,CAAC,SAAS,OAAO,IAAI;KACjD,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,GAAG,KAAK;CACnE,CAAC;AAEF,MAAM,MAAM,0BAA0B,CAAC,CAAC,SAAS,OAAO,IAAI;KACzD,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK;CAC5E,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,WAAW,CAAC,KAAK,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC;AAElE,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,GAAG,EAAE,CACZ,WAAW,EAAE,aAAa,CAAC,SAAS,CAAC,KAAK,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC,CAAC,KACnE,IAAI,CAAC;IACV,QAAQ,CAAC,GAAG,EAAE,MAAM,YAAY,CAAC;CAClC;AAED,eAAO,MAAM,oBAAoB,QAAO,cAWvC,CAAC;AAEF,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,cAAc,CAAC;IAE5C,GAAG,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC;IAE/B,GAAG,EAAE,MAAM,aAAa,CAAC,KAAK,CAAC,CAAC;CACjC;AAED,eAAO,MAAM,uBAAuB,GAClC,WAAW,KAAK,CAAC,YAAY,CAAC,KAC7B,iBAwBF,CAAC"}

package/dist/src/Evolu/Query.js

@@ -0,0 +1,61 @@
+import { bytesToHex, hexToBytes } from "../Buffer.js";
+import { objectToEntries } from "../Object.js";
+/**
+ * Evolu serializes {@link SqliteQuery} into a string to be easily used as a key
+ * and for comparison.
+ */
+export const serializeQuery = (query) => {
+    const params = query.parameters.map((v) => v instanceof Uint8Array
+        ? ["b", bytesToHex(v)]
+        : ["j", v]);
+    const options = query.options
+        ? objectToEntries(query.options).sort(([a], [b]) => a.localeCompare(b))
+        : [];
+    return JSON.stringify([query.sql, params, options]);
+};
+export const deserializeQuery = (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 }),
+    };
+};
+// To preserve identity.
+export const emptyRows = [];
+export const createQueryRowsCache = () => {
+    let queryRowsCache = new Map();
+    const cache = {
+        set: (queriesRows) => {
+            queryRowsCache = new Map([...queryRowsCache, ...queriesRows]);
+        },
+        get: () => queryRowsCache,
+    };
+    return cache;
+};
+export const createSubscribedQueries = (rowsStore) => {
+    const subscribedQueryMap = new Map();
+    const subscribedQueries = {
+        subscribe: (query) => (listener) => {
+            subscribedQueryMap.set(query, (subscribedQueryMap.get(query) ?? 0) + 1);
+            const unsubscribe = rowsStore.subscribe(listener);
+            return () => {
+                const count = subscribedQueryMap.get(query);
+                if (count != null && count > 1) {
+                    subscribedQueryMap.set(query, count - 1);
+                }
+                else {
+                    subscribedQueryMap.delete(query);
+                }
+                unsubscribe();
+            };
+        },
+        get: () => [...subscribedQueryMap.keys()],
+        has: (query) => subscribedQueryMap.has(query),
+    };
+    return subscribedQueries;
+};

package/dist/src/Evolu/Relay.d.ts

@@ -0,0 +1,13 @@
+import { ConsoleConfig } from "../Console.js";
+import { Result } from "../Result.js";
+import { SqliteError } from "../Sqlite.js";
+import { SimpleName } from "../Type.js";
+import { Storage } from "./Protocol.js";
+import { CreateSqliteStorageBaseOptions, SqliteStorageDeps } from "./Storage.js";
+export interface Relay extends Disposable {
+}
+export interface RelayConfig extends ConsoleConfig {
+    readonly name?: SimpleName;
+}
+export declare const createRelayStorage: (deps: SqliteStorageDeps) => (options: CreateSqliteStorageBaseOptions) => Result<Storage, SqliteError>;
+//# sourceMappingURL=Relay.d.ts.map

package/dist/src/Evolu/Relay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Relay.d.ts","sourceRoot":"","sources":["../../../src/Evolu/Relay.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE9C,OAAO,EAAM,MAAM,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAO,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,OAAO,EAAqB,OAAO,EAAE,MAAM,eAAe,CAAC;AAC3D,OAAO,EAEL,8BAA8B,EAC9B,iBAAiB,EAClB,MAAM,cAAc,CAAC;AAGtB,MAAM,WAAW,KAAM,SAAQ,UAAU;CAAG;AAE5C,MAAM,WAAW,WAAY,SAAQ,aAAa;IAChD,QAAQ,CAAC,IAAI,CAAC,EAAE,UAAU,CAAC;CAC5B;AAED,eAAO,MAAM,kBAAkB,GAC5B,MAAM,iBAAiB,MACvB,SAAS,8BAA8B,KAAG,MAAM,CAAC,OAAO,EAAE,WAAW,CAsHrE,CAAC"}

package/dist/src/Evolu/Relay.js

@@ -0,0 +1,109 @@
+import { isNonEmptyReadonlyArray } from "../Array.js";
+import { eqArrayNumber } from "../Eq.js";
+import { ok } from "../Result.js";
+import { sql } from "../Sqlite.js";
+import { createSqliteStorageBase, } from "./Storage.js";
+import { timestampToBinaryTimestamp } from "./Timestamp.js";
+export const createRelayStorage = (deps) => (options) => {
+    const sqliteStorageBase = createSqliteStorageBase(deps)(options);
+    if (!sqliteStorageBase.ok)
+        return sqliteStorageBase;
+    for (const query of [
+        sql `
+        create table if not exists evolu_writeKey (
+          "ownerId" blob not null,
+          "writeKey" blob not null,
+          primary key ("ownerId")
+        )
+        strict;
+      `,
+        sql `
+        create table if not exists evolu_message (
+          "ownerId" blob not null,
+          "timestamp" blob not null,
+          "change" blob not null,
+          primary key ("ownerId", "timestamp")
+        )
+        strict;
+      `,
+    ]) {
+        const result = deps.sqlite.exec(query);
+        if (!result.ok)
+            return result;
+    }
+    return ok({
+        ...sqliteStorageBase.value,
+        /**
+         * Lazily authorizes the initiator's {@link WriteKey} for the given
+         * {@link OwnerId}.
+         *
+         * - If the {@link OwnerId} does not exist, it is created and associated with
+         *   the provided write key.
+         * - If the {@link OwnerId} exists, the provided write key is compared to the
+         *   stored key.
+         */
+        validateWriteKey: (ownerId, writeKey) => {
+            const selectWriteKey = deps.sqlite.exec(sql `
+          select writeKey
+          from evolu_writeKey
+          where ownerId = ${ownerId};
+        `);
+            if (!selectWriteKey.ok) {
+                options.onStorageError(selectWriteKey.error);
+                return false;
+            }
+            const { rows } = selectWriteKey.value;
+            if (!isNonEmptyReadonlyArray(rows)) {
+                const insertWriteKey = deps.sqlite.exec(sql `
+            insert into evolu_writeKey (ownerId, writeKey)
+            values (${ownerId}, ${writeKey});
+          `);
+                if (!insertWriteKey.ok) {
+                    options.onStorageError(insertWriteKey.error);
+                    return false;
+                }
+                return true;
+            }
+            return eqArrayNumber(rows[0].writeKey, writeKey);
+        },
+        writeMessages: (ownerId, messages) => {
+            const result = deps.sqlite.transaction(() => {
+                for (const message of messages) {
+                    const insertTimestampResult = sqliteStorageBase.value.insertTimestamp(ownerId, timestampToBinaryTimestamp(message.timestamp));
+                    if (!insertTimestampResult.ok)
+                        return insertTimestampResult;
+                    const insertMessage = deps.sqlite.exec(sql `
+              insert into evolu_message ("ownerId", "timestamp", "change")
+              values
+                (
+                  ${ownerId},
+                  ${timestampToBinaryTimestamp(message.timestamp)},
+                  ${message.change}
+                )
+              on conflict do nothing;
+            `);
+                    if (!insertMessage.ok)
+                        return insertMessage;
+                }
+                return ok();
+            });
+            if (!result.ok) {
+                options.onStorageError(result.error);
+                return false;
+            }
+            return true;
+        },
+        readDbChange: (ownerId, timestamp) => {
+            const result = deps.sqlite.exec(sql `
+          select "change"
+          from evolu_message
+          where "ownerId" = ${ownerId} and "timestamp" = ${timestamp};
+        `);
+            if (!result.ok) {
+                options.onStorageError(result.error);
+                return null;
+            }
+            return result.value.rows[0]?.change;
+        },
+    });
+};