@evolu/common 2.0.5 → 2.1.0

package/dist/src/Evolu.d.ts

@@ -15,14 +15,11 @@ export interface Evolu<T extends Schema = Schema> {
     /**
      * Subscribe to {@link EvoluError} changes.
      *
-     * ### Example
-     *
-     * ```ts
-     * const unsubscribe = evolu.subscribeError(() => {
-     *   const error = evolu.getError();
-     *   console.log(error);
-     * });
-     * ```
+     * @example
+     *   const unsubscribe = evolu.subscribeError(() => {
+     *     const error = evolu.getError();
+     *     console.log(error);
+     *   });
      */
     readonly subscribeError: Store<EvoluError | null>["subscribe"];
     /** Get {@link EvoluError}. */
@@ -35,18 +32,15 @@ export interface Evolu<T extends Schema = Schema> {
      *
      * For mutations, use {@link create} and {@link update}.
      *
-     * ### Example
-     *
-     * ```ts
-     * const allTodos = evolu.createQuery((db) =>
-     *   db.selectFrom("todo").selectAll(),
-     * );
-     *
-     * const todoById = (id: TodoId) =>
-     *   evolu.createQuery((db) =>
-     *     db.selectFrom("todo").selectAll().where("id", "=", id),
+     * @example
+     *   const allTodos = evolu.createQuery((db) =>
+     *     db.selectFrom("todo").selectAll(),
      *   );
-     * ```
+     *
+     *   const todoById = (id: TodoId) =>
+     *     evolu.createQuery((db) =>
+     *       db.selectFrom("todo").selectAll().where("id", "=", id),
+     *     );
      */
     readonly createQuery: CreateQuery<T>;
     /**
@@ -90,16 +84,13 @@ export interface Evolu<T extends Schema = Schema> {
      * meaningful only for visible (hence subscribed) queries anyway. To subscribe
      * to a query, use {@link subscribeQuery}.
      *
-     * ### Example
-     *
-     * ```ts
-     * const allTodos = evolu.createQuery((db) =>
-     *   db.selectFrom("todo").selectAll(),
-     * );
-     * evolu.loadQuery(allTodos).then(({ rows }) => {
-     *   console.log(rows);
-     * });
-     * ```
+     * @example
+     *   const allTodos = evolu.createQuery((db) =>
+     *     db.selectFrom("todo").selectAll(),
+     *   );
+     *   evolu.loadQuery(allTodos).then(({ rows }) => {
+     *     console.log(rows);
+     *   });
      */
     readonly loadQuery: LoadQuery;
     /**
@@ -107,88 +98,67 @@ export interface Evolu<T extends Schema = Schema> {
      * {@link QueryResult} promises. It's like `queries.map(loadQuery)` but with
      * proper types for returned promises.
      *
-     * ### Example
-     *
-     * ```ts
-     * evolu.loadQueries([allTodos, todoById(1)]);
-     * ```
+     * @example
+     *   evolu.loadQueries([allTodos, todoById(1)]);
      */
     readonly loadQueries: <R extends Row, Q extends Queries<R>>(queries: [...Q]) => [...QueryResultsPromisesFromQueries<Q>];
     /**
      * Subscribe to {@link Query} {@link QueryResult} changes.
      *
-     * ### Example
-     *
-     * ```ts
-     * const unsubscribe = evolu.subscribeQuery(allTodos)(() => {
-     *   const { rows } = evolu.getQuery(allTodos);
-     * });
-     * ```
+     * @example
+     *   const unsubscribe = evolu.subscribeQuery(allTodos)(() => {
+     *     const { rows } = evolu.getQuery(allTodos);
+     *   });
      */
     readonly subscribeQuery: SubscribedQueries["subscribeQuery"];
     /**
      * Get {@link Query} {@link QueryResult}.
      *
-     * ### Example
-     *
-     * ```ts
-     * const unsubscribe = evolu.subscribeQuery(allTodos)(() => {
-     *   const { rows } = evolu.getQuery(allTodos);
-     * });
-     * ```
+     * @example
+     *   const unsubscribe = evolu.subscribeQuery(allTodos)(() => {
+     *     const { rows } = evolu.getQuery(allTodos);
+     *   });
      */
     readonly getQuery: SubscribedQueries["getQuery"];
     /**
      * Subscribe to {@link Owner} changes.
      *
-     * ### Example
-     *
-     * ```ts
-     * const unsubscribe = evolu.subscribeOwner(() => {
-     *   const owner = evolu.getOwner();
-     * });
-     * ```
+     * @example
+     *   const unsubscribe = evolu.subscribeOwner(() => {
+     *     const owner = evolu.getOwner();
+     *   });
      */
     readonly subscribeOwner: Store<Owner | null>["subscribe"];
     /**
      * Get {@link Owner}.
      *
-     * ### Example
-     *
-     * ```ts
-     * const unsubscribe = evolu.subscribeOwner(() => {
-     *   const owner = evolu.getOwner();
-     * });
-     * ```
+     * @example
+     *   const unsubscribe = evolu.subscribeOwner(() => {
+     *     const owner = evolu.getOwner();
+     *   });
      */
     readonly getOwner: Store<Owner | null>["getState"];
     /**
      * Subscribe to {@link SyncState} changes.
      *
-     * ### Example
-     *
-     * ```ts
-     * const unsubscribe = evolu.subscribeSyncState(() => {
-     *   const syncState = evolu.getSyncState();
-     * });
-     * ```
+     * @example
+     *   const unsubscribe = evolu.subscribeSyncState(() => {
+     *     const syncState = evolu.getSyncState();
+     *   });
      */
     readonly subscribeSyncState: Store<SyncState>["subscribe"];
     /**
      * Get {@link SyncState}.
      *
-     * ### Example
-     *
-     * ```ts
-     * const unsubscribe = evolu.subscribeSyncState(() => {
-     *   const syncState = evolu.getSyncState();
-     * });
-     * ```
+     * @example
+     *   const unsubscribe = evolu.subscribeSyncState(() => {
+     *     const syncState = evolu.getSyncState();
+     *   });
      */
     readonly getSyncState: Store<SyncState>["getState"];
     /**
-     * The function creates a row in the database and returns a new ID. The first
-     * argument is the table name, and the second is an object.
+     * Create a row in the database and returns a new ID. The first argument is
+     * the table name, and the second is an object.
      *
      * The third optional argument, the onComplete callback, is generally
      * unnecessary because creating a row cannot fail. Still, UI libraries can use
@@ -202,23 +172,20 @@ export interface Evolu<T extends Schema = Schema> {
      * useful columns common to all tables. Those columns are: `createdAt`,
      * `updatedAt`, and `isDeleted`.
      *
-     * ### Example
-     *
-     * ```ts
-     * import * as S from "@effect/schema/Schema";
+     * @example
+     *   import * as S from "@effect/schema/Schema";
      *
-     * // Evolu uses the Schema to enforce domain model.
-     * const title = S.parseSync(Evolu.NonEmptyString1000)("A title");
+     *   // Evolu uses the Schema to enforce domain model.
+     *   const title = S.parseSync(Evolu.NonEmptyString1000)("A title");
      *
-     * const { id } = evolu.create("todo", { title }, () => {
-     *   // onComplete callback
-     * });
-     * ```
+     *   const { id } = evolu.create("todo", { title }, () => {
+     *     // onComplete callback
+     *   });
      */
-    create: Mutate<T, "create">;
+    create: Create<T>;
     /**
-     * The function updates a row in the database and returns the existing ID. The
-     * first argument is the table name, and the second is an object.
+     * Update a row in the database and returns the existing ID. The first
+     * argument is the table name, and the second is an object.
      *
      * The third optional argument, the onComplete callback, is generally
      * unnecessary because creating a row cannot fail. Still, UI libraries can use
@@ -232,20 +199,17 @@ export interface Evolu<T extends Schema = Schema> {
      * useful columns common to all tables. Those columns are: `createdAt`,
      * `updatedAt`, and `isDeleted`.
      *
-     * ### Example
-     *
-     * ```ts
-     * import * as S from "@effect/schema/Schema";
+     * @example
+     *   import * as S from "@effect/schema/Schema";
      *
-     * // Evolu uses the Schema to enforce domain model.
-     * const title = S.parseSync(Evolu.NonEmptyString1000)("A title");
-     * evolu.update("todo", { id, title });
+     *   // Evolu uses the Schema to enforce domain model.
+     *   const title = S.parseSync(Evolu.NonEmptyString1000)("A title");
+     *   evolu.update("todo", { id, title });
      *
-     * // To delete a row, set `isDeleted` to true.
-     * evolu.update("todo", { id, isDeleted: true });
-     * ```
+     *   // To delete a row, set `isDeleted` to true.
+     *   evolu.update("todo", { id, isDeleted: true });
      */
-    update: Mutate<T, "update">;
+    update: Update<T>;
     /**
      * Delete {@link Owner} and all their data from the current device. After the
      * deletion, Evolu will purge the application state. For browsers, this will
@@ -302,12 +266,14 @@ export interface SubscribedQueries {
 }
 export declare const SubscribedQueries: Context.Tag<SubscribedQueries, SubscribedQueries>;
 export declare const SubscribedQueriesLive: Layer.Layer<RowsStore, never, SubscribedQueries>;
-type Mutate<S extends Schema = Schema, Mode extends "create" | "update" = "update"> = <K extends keyof S>(table: K, values: Kysely.Simplify<Mode extends "create" ? PartialForNullable<Castable<Omit<S[K], "id">>> : Partial<Castable<Omit<S[K], "id"> & Pick<CommonColumns, "isDeleted">>> & {
+export type Create<S extends Schema = Schema> = Mutate<S, "create">;
+export type Update<S extends Schema = Schema> = Mutate<S, "update">;
+export type Mutate<S extends Schema = Schema, Mode extends "create" | "update" = "update"> = <K extends keyof S>(table: K, values: Kysely.Simplify<Mode extends "create" ? PartialForNullable<Castable<Omit<S[K], "id">>> : Partial<Castable<Omit<S[K], "id"> & Pick<CommonColumns, "isDeleted">>> & {
     readonly id: S[K]["id"];
 }>, onComplete?: () => void) => {
     readonly id: S[K]["id"];
 };
-declare const Mutate: Context.Tag<Mutate<Schema, "update">, Mutate<Schema, "update">>;
+export declare const Mutate: Context.Tag<Mutate<Schema, "update">, Mutate<Schema, "update">>;
 type PartialForNullable<T, NK extends keyof T = {
     [K in keyof T]: null extends T[K] ? K : never;
 }[keyof T], NP = Pick<T, Exclude<keyof T, NK>> & Partial<Pick<T, NK>>> = {
@@ -325,5 +291,6 @@ type Castable<T> = {
 };
 /** EvoluCommonLive has only platform independent side-effects. */
 export declare const EvoluCommonLive: Layer.Layer<Config | FlushSync | AppState | DbWorker, never, Evolu<Schema>>;
+export declare const makeCreateEvolu: (EvoluLive: Layer.Layer<Config, never, Evolu<Schema>>) => <From, To extends Schema>(schema: S.Schema<From, To>, config?: Partial<Config>) => Evolu<To>;
 export {};
 //# sourceMappingURL=Evolu.d.ts.map

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

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

package/dist/src/Evolu.js

@@ -1,6 +1,6 @@
-import { Context, Effect, Function, Layer, Match, Number, ReadonlyArray, pipe, } from "effect";
+import { Context, Effect, Function, GlobalValue, Layer, Match, Number, ReadonlyArray, pipe, } from "effect";
 import * as Kysely from "kysely";
-import { Config } from "./Config.js";
+import { Config, ConfigLive } from "./Config.js";
 import { Time, TimeLive } from "./Crdt.js";
 import { NanoId, NanoIdLive } from "./Crypto.js";
 import { RowsStore, RowsStoreLive, emptyRows, queryResultFromRows, schemaToTables, serializeQuery, } from "./Db.js";
@@ -145,7 +145,7 @@ export const SubscribedQueriesLive = Layer.effect(SubscribedQueries, Effect.gen(
         getSubscribedQueries: () => ReadonlyArray.fromIterable(subscribedQueries.keys()),
     });
 }));
-const Mutate = Context.Tag();
+export const Mutate = Context.Tag();
 const MutateLive = Layer.effect(Mutate, Effect.gen(function* (_) {
     const nanoid = yield* _(NanoId);
     const onCompletes = yield* _(OnCompletes);
@@ -247,3 +247,9 @@ const EvoluCommon = Layer.effect(Evolu, Effect.gen(function* (_) {
 })).pipe(Layer.provide(Layer.mergeAll(LoadQueryLive, OnQueryLive, MutateLive)), Layer.provide(LoadingPromiseLive), Layer.provide(SubscribedQueriesLive), Layer.provide(Layer.merge(RowsStoreLive, OnCompletesLive)));
 /** EvoluCommonLive has only platform independent side-effects. */
 export const EvoluCommonLive = EvoluCommon.pipe(Layer.provide(Layer.merge(TimeLive, NanoIdLive)));
+export const makeCreateEvolu = (EvoluLive) => (schema, config) => {
+    // For https://nextjs.org/docs/architecture/fast-refresh etc.
+    const evolu = GlobalValue.globalValue("@evolu/common", () => Evolu.pipe(Effect.provide(EvoluLive), Effect.provide(ConfigLive(config)), Effect.runSync));
+    evolu.ensureSchema(schema);
+    return evolu;
+};

package/dist/src/Model.d.ts

@@ -9,15 +9,12 @@ export type Id = S.Schema.To<typeof Id>;
 /**
  * A factory function to create {@link Id} Schema for a specific table.
  *
- * ### Example
+ * @example
+ *   import * as S from "@effect/schema/Schema";
+ *   import { id } from "@evolu/react";
  *
- * ```ts
- * import * as S from "@effect/schema/Schema";
- * import * as Evolu from "@evolu/react";
- *
- * const TodoId = Evolu.id("Todo");
- * type TodoId = S.Schema.To<typeof TodoId>;
- * ```
+ *   const TodoId = id("Todo");
+ *   type TodoId = S.Schema.To<typeof TodoId>;
  */
 export declare const id: <T extends string>(table: T) => S.BrandSchema<string, string & Brand.Brand<"Id"> & Brand.Brand<T>>;
 /**
@@ -39,17 +36,14 @@ export type SqliteBoolean = S.Schema.To<typeof SqliteBoolean>;
  * Date nor Boolean types, so Evolu emulates them with {@link SqliteBoolean} and
  * {@link SqliteDate}.
  *
- * ### Example
- *
- * ```ts
- * const allTodosNotDeleted = evolu.createQuery((db) =>
- *   db
- *     .selectFrom("todo")
- *     .selectAll()
- *     // isDeleted is SqliteBoolean
- *     .where("isDeleted", "is not", Evolu.cast(true)),
- * );
- * ```
+ * @example
+ *   const allTodosNotDeleted = evolu.createQuery((db) =>
+ *     db
+ *       .selectFrom("todo")
+ *       .selectAll()
+ *       // isDeleted is SqliteBoolean
+ *       .where("isDeleted", "is not", Evolu.cast(true)),
+ *   );
  */
 export declare function cast(value: boolean): SqliteBoolean;
 export declare function cast(value: SqliteBoolean): boolean;
@@ -66,42 +60,33 @@ export type String = S.Schema.To<typeof String>;
 /**
  * A string with a maximum length of 1000 characters.
  *
- * ### Example
- *
- * ```ts
- * import * as S from "@effect/schema/Schema";
- * import * as Evolu from "@evolu/react";
+ * @example
+ *   import * as S from "@effect/schema/Schema";
+ *   import { String1000 } from "@evolu/react";
  *
- * S.parse(Evolu.String1000)(value);
- * ```
+ *   S.parse(String1000)(value);
  */
 export declare const String1000: S.BrandSchema<string, string & Brand.Brand<"String"> & Brand.Brand<"String1000">>;
 export type String1000 = S.Schema.To<typeof String1000>;
 /**
  * A nonempty string with a maximum length of 1000 characters.
  *
- * ### Example
+ * @example
+ *   import * as S from "@effect/schema/Schema";
+ *   import { NonEmptyString1000 } from "@evolu/react";
  *
- * ```ts
- * import * as S from "@effect/schema/Schema";
- * import * as Evolu from "@evolu/react";
- *
- * S.parse(Evolu.NonEmptyString1000)(value);
- * ```
+ *   S.parse(NonEmptyString1000)(value);
  */
 export declare const NonEmptyString1000: S.BrandSchema<string, string & Brand.Brand<"String"> & Brand.Brand<"NonEmptyString1000">>;
 export type NonEmptyString1000 = S.Schema.To<typeof NonEmptyString1000>;
 /**
  * A positive integer.
  *
- * ### Example
- *
- * ```ts
- * import * as S from "@effect/schema/Schema";
- * import * as Evolu from "@evolu/react";
+ * @example
+ *   import * as S from "@effect/schema/Schema";
+ *   import { PositiveInt } from "@evolu/react";
  *
- * S.parse(Evolu.PositiveInt)(value);
- * ```
+ *   S.parse(PositiveInt)(value);
  */
 export declare const PositiveInt: S.BrandSchema<number, number & Brand.Brand<"PositiveInt">>;
 export type PositiveInt = S.Schema.To<typeof PositiveInt>;

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

@@ -1 +1 @@
-{"version":3,"file":"Model.d.ts","sourceRoot":"","sources":["../../src/Model.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,uBAAuB,CAAC;AAC3C,OAAO,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAG/B;;;GAGG;AACH,eAAO,MAAM,EAAE,mDAAyD,CAAC;AACzE,MAAM,MAAM,EAAE,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;AAExC;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,EAAE,oGAGU,CAAC;AAE1B;;;;GAIG;AACH,eAAO,MAAM,UAAU,2DAGtB,CAAC;AACF,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,UAAU,CAAC,CAAC;AAExD;;;;GAIG;AACH,eAAO,MAAM,aAAa,8DAIzB,CAAC;AACF,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,aAAa,CAAC,CAAC;AAE9D;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,IAAI,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa,CAAC;AACpD,wBAAgB,IAAI,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC;AACpD,wBAAgB,IAAI,CAAC,KAAK,EAAE,IAAI,GAAG,UAAU,CAAC;AAC9C,wBAAgB,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;AAW9C;;;;;GAKG;AACH,eAAO,MAAM,MAAM,uDAclB,CAAC;AACF,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,MAAM,CAAC,CAAC;AAEhD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,UAAU,mFAAwD,CAAC;AAChF,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,UAAU,CAAC,CAAC;AAExD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,kBAAkB,2FAI9B,CAAC;AACF,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAExE;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,WAAW,4DAIvB,CAAC;AACF,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,WAAW,CAAC,CAAC"}
+{"version":3,"file":"Model.d.ts","sourceRoot":"","sources":["../../src/Model.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,uBAAuB,CAAC;AAC3C,OAAO,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAG/B;;;GAGG;AACH,eAAO,MAAM,EAAE,mDAAyD,CAAC;AACzE,MAAM,MAAM,EAAE,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;AAExC;;;;;;;;;GASG;AACH,eAAO,MAAM,EAAE,oGAGU,CAAC;AAE1B;;;;GAIG;AACH,eAAO,MAAM,UAAU,2DAGtB,CAAC;AACF,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,UAAU,CAAC,CAAC;AAExD;;;;GAIG;AACH,eAAO,MAAM,aAAa,8DAIzB,CAAC;AACF,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,aAAa,CAAC,CAAC;AAE9D;;;;;;;;;;;;;GAaG;AACH,wBAAgB,IAAI,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa,CAAC;AACpD,wBAAgB,IAAI,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC;AACpD,wBAAgB,IAAI,CAAC,KAAK,EAAE,IAAI,GAAG,UAAU,CAAC;AAC9C,wBAAgB,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;AAW9C;;;;;GAKG;AACH,eAAO,MAAM,MAAM,uDAclB,CAAC;AACF,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,MAAM,CAAC,CAAC;AAEhD;;;;;;;;GAQG;AACH,eAAO,MAAM,UAAU,mFAAwD,CAAC;AAChF,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,UAAU,CAAC,CAAC;AAExD;;;;;;;;GAQG;AACH,eAAO,MAAM,kBAAkB,2FAI9B,CAAC;AACF,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAExE;;;;;;;;GAQG;AACH,eAAO,MAAM,WAAW,4DAIvB,CAAC;AACF,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,WAAW,CAAC,CAAC"}

package/dist/src/Model.js

@@ -8,15 +8,12 @@ export const Id = S.string.pipe(S.pattern(/^[\w-]{21}$/), S.brand("Id"));
 /**
  * A factory function to create {@link Id} Schema for a specific table.
  *
- * ### Example
+ * @example
+ *   import * as S from "@effect/schema/Schema";
+ *   import { id } from "@evolu/react";
  *
- * ```ts
- * import * as S from "@effect/schema/Schema";
- * import * as Evolu from "@evolu/react";
- *
- * const TodoId = Evolu.id("Todo");
- * type TodoId = S.Schema.To<typeof TodoId>;
- * ```
+ *   const TodoId = id("Todo");
+ *   type TodoId = S.Schema.To<typeof TodoId>;
  */
 export const id = (table) => Id.pipe(S.brand(table));
 /**
@@ -60,39 +57,30 @@ export const String = S.string.pipe(S.filter((s) => {
 /**
  * A string with a maximum length of 1000 characters.
  *
- * ### Example
- *
- * ```ts
- * import * as S from "@effect/schema/Schema";
- * import * as Evolu from "@evolu/react";
+ * @example
+ *   import * as S from "@effect/schema/Schema";
+ *   import { String1000 } from "@evolu/react";
  *
- * S.parse(Evolu.String1000)(value);
- * ```
+ *   S.parse(String1000)(value);
  */
 export const String1000 = String.pipe(S.maxLength(1000), S.brand("String1000"));
 /**
  * A nonempty string with a maximum length of 1000 characters.
  *
- * ### Example
+ * @example
+ *   import * as S from "@effect/schema/Schema";
+ *   import { NonEmptyString1000 } from "@evolu/react";
  *
- * ```ts
- * import * as S from "@effect/schema/Schema";
- * import * as Evolu from "@evolu/react";
- *
- * S.parse(Evolu.NonEmptyString1000)(value);
- * ```
+ *   S.parse(NonEmptyString1000)(value);
  */
 export const NonEmptyString1000 = String.pipe(S.minLength(1), S.maxLength(1000), S.brand("NonEmptyString1000"));
 /**
  * A positive integer.
  *
- * ### Example
- *
- * ```ts
- * import * as S from "@effect/schema/Schema";
- * import * as Evolu from "@evolu/react";
+ * @example
+ *   import * as S from "@effect/schema/Schema";
+ *   import { PositiveInt } from "@evolu/react";
  *
- * S.parse(Evolu.PositiveInt)(value);
- * ```
+ *   S.parse(PositiveInt)(value);
  */
 export const PositiveInt = S.number.pipe(S.int(), S.positive(), S.brand("PositiveInt"));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@evolu/common",
-  "version": "2.0.5",
+  "version": "2.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",
@@ -49,14 +49,13 @@
     "@protobuf-ts/runtime": "^2.9.1",
     "@scure/bip39": "^1.2.1",
     "kysely": "^0.26.3",
-    "nanoid": "^5.0.3"
+    "nanoid": "^5.0.4"
   },
   "devDependencies": {
-    "@effect/schema": "0.51.1",
+    "@effect/schema": "0.51.3",
     "@protobuf-ts/plugin": "^2.9.1",
     "@protobuf-ts/protoc": "^2.9.1",
     "array-shuffle": "^3.0.0",
-    "better-sqlite3": "^9.1.1",
     "effect": "2.0.0-next.58",
     "eslint": "^8.54.0",
     "typescript": "^5.3.2",
@@ -65,7 +64,7 @@
     "eslint-config-evolu": "1.0.0"
   },
   "peerDependencies": {
-    "@effect/schema": "0.51.1",
+    "@effect/schema": "0.51.3",
     "effect": "2.0.0-next.58"
   },
   "publishConfig": {

package/src/Evolu.ts

@@ -3,6 +3,7 @@ import {
   Context,
   Effect,
   Function,
+  GlobalValue,
   Layer,
   Match,
   Number,
@@ -10,7 +11,7 @@ import {
   pipe,
 } from "effect";
 import * as Kysely from "kysely";
-import { Config } from "./Config.js";
+import { Config, ConfigLive } from "./Config.js";
 import { Time, TimeLive } from "./Crdt.js";
 import { Mnemonic, NanoId, NanoIdLive } from "./Crypto.js";
 import {
@@ -42,14 +43,11 @@ export interface Evolu<T extends Schema = Schema> {
   /**
    * Subscribe to {@link EvoluError} changes.
    *
-   * ### Example
-   *
-   * ```ts
-   * const unsubscribe = evolu.subscribeError(() => {
-   *   const error = evolu.getError();
-   *   console.log(error);
-   * });
-   * ```
+   * @example
+   *   const unsubscribe = evolu.subscribeError(() => {
+   *     const error = evolu.getError();
+   *     console.log(error);
+   *   });
    */
   readonly subscribeError: Store<EvoluError | null>["subscribe"];
 
@@ -64,18 +62,15 @@ export interface Evolu<T extends Schema = Schema> {
    *
    * For mutations, use {@link create} and {@link update}.
    *
-   * ### Example
-   *
-   * ```ts
-   * const allTodos = evolu.createQuery((db) =>
-   *   db.selectFrom("todo").selectAll(),
-   * );
-   *
-   * const todoById = (id: TodoId) =>
-   *   evolu.createQuery((db) =>
-   *     db.selectFrom("todo").selectAll().where("id", "=", id),
+   * @example
+   *   const allTodos = evolu.createQuery((db) =>
+   *     db.selectFrom("todo").selectAll(),
    *   );
-   * ```
+   *
+   *   const todoById = (id: TodoId) =>
+   *     evolu.createQuery((db) =>
+   *       db.selectFrom("todo").selectAll().where("id", "=", id),
+   *     );
    */
   readonly createQuery: CreateQuery<T>;
 
@@ -120,16 +115,13 @@ export interface Evolu<T extends Schema = Schema> {
    * meaningful only for visible (hence subscribed) queries anyway. To subscribe
    * to a query, use {@link subscribeQuery}.
    *
-   * ### Example
-   *
-   * ```ts
-   * const allTodos = evolu.createQuery((db) =>
-   *   db.selectFrom("todo").selectAll(),
-   * );
-   * evolu.loadQuery(allTodos).then(({ rows }) => {
-   *   console.log(rows);
-   * });
-   * ```
+   * @example
+   *   const allTodos = evolu.createQuery((db) =>
+   *     db.selectFrom("todo").selectAll(),
+   *   );
+   *   evolu.loadQuery(allTodos).then(({ rows }) => {
+   *     console.log(rows);
+   *   });
    */
   readonly loadQuery: LoadQuery;
 
@@ -138,11 +130,8 @@ export interface Evolu<T extends Schema = Schema> {
    * {@link QueryResult} promises. It's like `queries.map(loadQuery)` but with
    * proper types for returned promises.
    *
-   * ### Example
-   *
-   * ```ts
-   * evolu.loadQueries([allTodos, todoById(1)]);
-   * ```
+   * @example
+   *   evolu.loadQueries([allTodos, todoById(1)]);
    */
   readonly loadQueries: <R extends Row, Q extends Queries<R>>(
     queries: [...Q],
@@ -151,84 +140,66 @@ export interface Evolu<T extends Schema = Schema> {
   /**
    * Subscribe to {@link Query} {@link QueryResult} changes.
    *
-   * ### Example
-   *
-   * ```ts
-   * const unsubscribe = evolu.subscribeQuery(allTodos)(() => {
-   *   const { rows } = evolu.getQuery(allTodos);
-   * });
-   * ```
+   * @example
+   *   const unsubscribe = evolu.subscribeQuery(allTodos)(() => {
+   *     const { rows } = evolu.getQuery(allTodos);
+   *   });
    */
   readonly subscribeQuery: SubscribedQueries["subscribeQuery"];
 
   /**
    * Get {@link Query} {@link QueryResult}.
    *
-   * ### Example
-   *
-   * ```ts
-   * const unsubscribe = evolu.subscribeQuery(allTodos)(() => {
-   *   const { rows } = evolu.getQuery(allTodos);
-   * });
-   * ```
+   * @example
+   *   const unsubscribe = evolu.subscribeQuery(allTodos)(() => {
+   *     const { rows } = evolu.getQuery(allTodos);
+   *   });
    */
   readonly getQuery: SubscribedQueries["getQuery"];
 
   /**
    * Subscribe to {@link Owner} changes.
    *
-   * ### Example
-   *
-   * ```ts
-   * const unsubscribe = evolu.subscribeOwner(() => {
-   *   const owner = evolu.getOwner();
-   * });
-   * ```
+   * @example
+   *   const unsubscribe = evolu.subscribeOwner(() => {
+   *     const owner = evolu.getOwner();
+   *   });
    */
   readonly subscribeOwner: Store<Owner | null>["subscribe"];
 
   /**
    * Get {@link Owner}.
    *
-   * ### Example
-   *
-   * ```ts
-   * const unsubscribe = evolu.subscribeOwner(() => {
-   *   const owner = evolu.getOwner();
-   * });
-   * ```
+   * @example
+   *   const unsubscribe = evolu.subscribeOwner(() => {
+   *     const owner = evolu.getOwner();
+   *   });
    */
   readonly getOwner: Store<Owner | null>["getState"];
 
   /**
    * Subscribe to {@link SyncState} changes.
    *
-   * ### Example
-   *
-   * ```ts
-   * const unsubscribe = evolu.subscribeSyncState(() => {
-   *   const syncState = evolu.getSyncState();
-   * });
-   * ```
+   * @example
+   *   const unsubscribe = evolu.subscribeSyncState(() => {
+   *     const syncState = evolu.getSyncState();
+   *   });
    */
   readonly subscribeSyncState: Store<SyncState>["subscribe"];
 
   /**
    * Get {@link SyncState}.
    *
-   * ### Example
-   *
-   * ```ts
-   * const unsubscribe = evolu.subscribeSyncState(() => {
-   *   const syncState = evolu.getSyncState();
-   * });
-   * ```
+   * @example
+   *   const unsubscribe = evolu.subscribeSyncState(() => {
+   *     const syncState = evolu.getSyncState();
+   *   });
    */
   readonly getSyncState: Store<SyncState>["getState"];
 
   /**
-   * The function creates a row in the database and returns a new ID. The first
-   * argument is the table name, and the second is an object.
+   * Create a row in the database and returns a new ID. The first argument is
+   * the table name, and the second is an object.
    *
    * The third optional argument, the onComplete callback, is generally
    * unnecessary because creating a row cannot fail. Still, UI libraries can use
@@ -242,24 +213,21 @@ export interface Evolu<T extends Schema = Schema> {
    * useful columns common to all tables. Those columns are: `createdAt`,
    * `updatedAt`, and `isDeleted`.
    *
-   * ### Example
-   *
-   * ```ts
-   * import * as S from "@effect/schema/Schema";
+   * @example
+   *   import * as S from "@effect/schema/Schema";
    *
-   * // Evolu uses the Schema to enforce domain model.
-   * const title = S.parseSync(Evolu.NonEmptyString1000)("A title");
+   *   // Evolu uses the Schema to enforce domain model.
+   *   const title = S.parseSync(Evolu.NonEmptyString1000)("A title");
    *
-   * const { id } = evolu.create("todo", { title }, () => {
-   *   // onComplete callback
-   * });
-   * ```
+   *   const { id } = evolu.create("todo", { title }, () => {
+   *     // onComplete callback
+   *   });
    */
-  create: Mutate<T, "create">;
+  create: Create<T>;
 
   /**
-   * The function updates a row in the database and returns the existing ID. The
-   * first argument is the table name, and the second is an object.
+   * Update a row in the database and returns the existing ID. The first
+   * argument is the table name, and the second is an object.
    *
    * The third optional argument, the onComplete callback, is generally
    * unnecessary because creating a row cannot fail. Still, UI libraries can use
@@ -273,20 +241,17 @@ export interface Evolu<T extends Schema = Schema> {
    * useful columns common to all tables. Those columns are: `createdAt`,
    * `updatedAt`, and `isDeleted`.
    *
-   * ### Example
-   *
-   * ```ts
-   * import * as S from "@effect/schema/Schema";
+   * @example
+   *   import * as S from "@effect/schema/Schema";
    *
-   * // Evolu uses the Schema to enforce domain model.
-   * const title = S.parseSync(Evolu.NonEmptyString1000)("A title");
-   * evolu.update("todo", { id, title });
+   *   // Evolu uses the Schema to enforce domain model.
+   *   const title = S.parseSync(Evolu.NonEmptyString1000)("A title");
+   *   evolu.update("todo", { id, title });
    *
-   * // To delete a row, set `isDeleted` to true.
-   * evolu.update("todo", { id, isDeleted: true });
-   * ```
+   *   // To delete a row, set `isDeleted` to true.
+   *   evolu.update("todo", { id, isDeleted: true });
    */
-  update: Mutate<T, "update">;
+  update: Update<T>;
 
   /**
    * Delete {@link Owner} and all their data from the current device. After the
@@ -574,7 +539,11 @@ export const SubscribedQueriesLive = Layer.effect(
   }),
 );
 
-type Mutate<
+export type Create<S extends Schema = Schema> = Mutate<S, "create">;
+
+export type Update<S extends Schema = Schema> = Mutate<S, "update">;
+
+export type Mutate<
   S extends Schema = Schema,
   Mode extends "create" | "update" = "update",
 > = <K extends keyof S>(
@@ -591,7 +560,7 @@ type Mutate<
   readonly id: S[K]["id"];
 };
 
-const Mutate = Context.Tag<Mutate>();
+export const Mutate = Context.Tag<Mutate>();
 
 // https://stackoverflow.com/a/54713648/233902
 type PartialForNullable<
@@ -765,3 +734,21 @@ const EvoluCommon = Layer.effect(
 export const EvoluCommonLive = EvoluCommon.pipe(
   Layer.provide(Layer.merge(TimeLive, NanoIdLive)),
 );
+
+export const makeCreateEvolu =
+  (EvoluLive: Layer.Layer<Config, never, Evolu<Schema>>) =>
+  <From, To extends Schema>(
+    schema: S.Schema<From, To>,
+    config?: Partial<Config>,
+  ): Evolu<To> => {
+    // For https://nextjs.org/docs/architecture/fast-refresh etc.
+    const evolu = GlobalValue.globalValue("@evolu/common", () =>
+      Evolu.pipe(
+        Effect.provide(EvoluLive),
+        Effect.provide(ConfigLive(config)),
+        Effect.runSync,
+      ),
+    );
+    evolu.ensureSchema(schema);
+    return evolu as Evolu<To>;
+  };

package/src/Model.ts

@@ -12,15 +12,12 @@ export type Id = S.Schema.To<typeof Id>;
 /**
  * A factory function to create {@link Id} Schema for a specific table.
  *
- * ### Example
+ * @example
+ *   import * as S from "@effect/schema/Schema";
+ *   import { id } from "@evolu/react";
  *
- * ```ts
- * import * as S from "@effect/schema/Schema";
- * import * as Evolu from "@evolu/react";
- *
- * const TodoId = Evolu.id("Todo");
- * type TodoId = S.Schema.To<typeof TodoId>;
- * ```
+ *   const TodoId = id("Todo");
+ *   type TodoId = S.Schema.To<typeof TodoId>;
  */
 export const id = <T extends string>(
   table: T,
@@ -55,17 +52,14 @@ export type SqliteBoolean = S.Schema.To<typeof SqliteBoolean>;
  * Date nor Boolean types, so Evolu emulates them with {@link SqliteBoolean} and
  * {@link SqliteDate}.
  *
- * ### Example
- *
- * ```ts
- * const allTodosNotDeleted = evolu.createQuery((db) =>
- *   db
- *     .selectFrom("todo")
- *     .selectAll()
- *     // isDeleted is SqliteBoolean
- *     .where("isDeleted", "is not", Evolu.cast(true)),
- * );
- * ```
+ * @example
+ *   const allTodosNotDeleted = evolu.createQuery((db) =>
+ *     db
+ *       .selectFrom("todo")
+ *       .selectAll()
+ *       // isDeleted is SqliteBoolean
+ *       .where("isDeleted", "is not", Evolu.cast(true)),
+ *   );
  */
 export function cast(value: boolean): SqliteBoolean;
 export function cast(value: SqliteBoolean): boolean;
@@ -107,14 +101,11 @@ export type String = S.Schema.To<typeof String>;
 /**
  * A string with a maximum length of 1000 characters.
  *
- * ### Example
- *
- * ```ts
- * import * as S from "@effect/schema/Schema";
- * import * as Evolu from "@evolu/react";
+ * @example
+ *   import * as S from "@effect/schema/Schema";
+ *   import { String1000 } from "@evolu/react";
  *
- * S.parse(Evolu.String1000)(value);
- * ```
+ *   S.parse(String1000)(value);
  */
 export const String1000 = String.pipe(S.maxLength(1000), S.brand("String1000"));
 export type String1000 = S.Schema.To<typeof String1000>;
@@ -122,14 +113,11 @@ export type String1000 = S.Schema.To<typeof String1000>;
 /**
  * A nonempty string with a maximum length of 1000 characters.
  *
- * ### Example
+ * @example
+ *   import * as S from "@effect/schema/Schema";
+ *   import { NonEmptyString1000 } from "@evolu/react";
  *
- * ```ts
- * import * as S from "@effect/schema/Schema";
- * import * as Evolu from "@evolu/react";
- *
- * S.parse(Evolu.NonEmptyString1000)(value);
- * ```
+ *   S.parse(NonEmptyString1000)(value);
  */
 export const NonEmptyString1000 = String.pipe(
   S.minLength(1),
@@ -141,14 +129,11 @@ export type NonEmptyString1000 = S.Schema.To<typeof NonEmptyString1000>;
 /**
  * A positive integer.
  *
- * ### Example
- *
- * ```ts
- * import * as S from "@effect/schema/Schema";
- * import * as Evolu from "@evolu/react";
+ * @example
+ *   import * as S from "@effect/schema/Schema";
+ *   import { PositiveInt } from "@evolu/react";
  *
- * S.parse(Evolu.PositiveInt)(value);
- * ```
+ *   S.parse(PositiveInt)(value);
  */
 export const PositiveInt = S.number.pipe(
   S.int(),