@evolu/common 6.0.1-preview.8 → 7.0.0

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

@@ -26,8 +26,8 @@ export declare const makePatches: (previousRows: ReadonlyArray<Row> | undefined,
  * A unique identifier prepended to JSON-encoded strings. This allows safe
  * detection and parsing of only those columns that require JSON.parse.
  *
- * The identifier is generated using nanoid to ensure randomness and uniqueness,
- * preventing malicious actors from inserting fake data that could be
+ * The identifier is a cryptographically random Evolu Id, ensuring uniqueness
+ * and preventing malicious actors from inserting fake data that could be
  * misinterpreted as JSON by the application.
  *
  * Note: The same queries created by different browser tabs will have different
@@ -38,6 +38,6 @@ export declare const makePatches: (previousRows: ReadonlyArray<Row> | undefined,
  *
  * See: https://github.com/kysely-org/kysely/issues/1372#issuecomment-2702773948
  */
-export declare const kyselyJsonIdentifier: string;
+export declare const kyselyJsonIdentifier: string & import("../Brand.js").Brand<"Id">;
 export declare const parseSqliteJsonArray: <T>(arr: ReadonlyArray<T>) => ReadonlyArray<T>;
 //# sourceMappingURL=Diff.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Diff.d.ts","sourceRoot":"","sources":["../../../src/Evolu/Diff.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AAExC,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC;CACxC;AAED,MAAM,MAAM,KAAK,GAAG,eAAe,GAAG,cAAc,CAAC;AAErD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,EAAE,YAAY,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,EAAE,WAAW,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC;CACrB;AAED,eAAO,MAAM,YAAY,GACvB,SAAS,aAAa,CAAC,KAAK,CAAC,EAC7B,SAAS,aAAa,CAAC,GAAG,CAAC,KAC1B,aAAa,CAAC,GAAG,CAUP,CAAC;AAEd;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,GACtB,cAAc,aAAa,CAAC,GAAG,CAAC,GAAG,SAAS,EAC5C,UAAU,aAAa,CAAC,GAAG,CAAC,KAC3B,aAAa,CAAC,KAAK,CA6BrB,CAAC;AAUF;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,oBAAoB,QAAW,CAAC;AAE7C,eAAO,MAAM,oBAAoB,GAAI,CAAC,EACpC,KAAK,aAAa,CAAC,CAAC,CAAC,KACpB,aAAa,CAAC,CAAC,CAMjB,CAAC"}
+{"version":3,"file":"Diff.d.ts","sourceRoot":"","sources":["../../../src/Evolu/Diff.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AAExC,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC;CACxC;AAED,MAAM,MAAM,KAAK,GAAG,eAAe,GAAG,cAAc,CAAC;AAErD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,EAAE,YAAY,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,EAAE,WAAW,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC;CACrB;AAED,eAAO,MAAM,YAAY,GACvB,SAAS,aAAa,CAAC,KAAK,CAAC,EAC7B,SAAS,aAAa,CAAC,GAAG,CAAC,KAC1B,aAAa,CAAC,GAAG,CAUP,CAAC;AAEd;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,GACtB,cAAc,aAAa,CAAC,GAAG,CAAC,GAAG,SAAS,EAC5C,UAAU,aAAa,CAAC,GAAG,CAAC,KAC3B,aAAa,CAAC,KAAK,CA6BrB,CAAC;AAUF;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,oBAAoB,4CAE/B,CAAC;AAEH,eAAO,MAAM,oBAAoB,GAAI,CAAC,EACpC,KAAK,aAAa,CAAC,CAAC,CAAC,KACpB,aAAa,CAAC,CAAC,CAMjB,CAAC"}

package/dist/src/Evolu/Diff.js

@@ -1,7 +1,7 @@
-import { nanoid } from "nanoid";
+import { createRandomBytes } from "../Crypto.js";
 import { isPlainObject } from "../Object.js";
 import { orderUint8Array } from "../Order.js";
-import { String } from "../Type.js";
+import { createId, String } from "../Type.js";
 export const applyPatches = (patches, current) => patches.reduce((next, patch) => {
     switch (patch.op) {
         case "replaceAll":
@@ -54,8 +54,8 @@ const areEqual = (a, b) => {
  * A unique identifier prepended to JSON-encoded strings. This allows safe
  * detection and parsing of only those columns that require JSON.parse.
  *
- * The identifier is generated using nanoid to ensure randomness and uniqueness,
- * preventing malicious actors from inserting fake data that could be
+ * The identifier is a cryptographically random Evolu Id, ensuring uniqueness
+ * and preventing malicious actors from inserting fake data that could be
  * misinterpreted as JSON by the application.
  *
  * Note: The same queries created by different browser tabs will have different
@@ -66,7 +66,9 @@ const areEqual = (a, b) => {
  *
  * See: https://github.com/kysely-org/kysely/issues/1372#issuecomment-2702773948
  */
-export const kyselyJsonIdentifier = nanoid();
+export const kyselyJsonIdentifier = createId({
+    randomBytes: createRandomBytes(),
+});
 export const parseSqliteJsonArray = (arr) => {
     const result = new Array(arr.length);
     for (let i = 0; i < arr.length; ++i) {

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

@@ -1,21 +1,48 @@
 import { ConsoleDep } from "../Console.js";
-import { SymmetricCryptoDecryptError } from "../Crypto.js";
+import { RandomBytesDep, SymmetricCryptoDecryptError } from "../Crypto.js";
 import { TransferableError } from "../Error.js";
-import { NanoIdLibDep } from "../NanoId.js";
 import { SqliteError } from "../Sqlite.js";
 import { StoreSubscribe } from "../Store.js";
 import { TimeDep } from "../Time.js";
 import { Mnemonic } from "../Type.js";
-import { Config } from "./Config.js";
-import { CreateDbWorkerDep } from "./Db.js";
+import { CreateDbWorkerDep, DbConfig } from "./Db.js";
 import { AppOwner } from "./Owner.js";
-import { CreateAppStateDep, FlushSyncDep } from "./Platform.js";
-import { ProtocolError, ProtocolUnsupportedVersionError } from "./Protocol.js";
+import { FlushSyncDep, ReloadAppDep } from "./Platform.js";
+import { ProtocolError } from "./Protocol.js";
 import { Queries, QueriesToQueryRowsPromises, Query, QueryRows, Row } from "./Query.js";
-import { CreateQuery, EvoluSchema, Mutation, ValidateSchema } from "./Schema.js";
-import { SyncState } from "./Sync.js";
+import { CreateQuery, EvoluSchema, IndexesConfig, Mutation, ValidateSchema } from "./Schema.js";
+import { SyncOwner } from "./Sync.js";
 import { TimestampError } from "./Timestamp.js";
-export interface Evolu<S extends EvoluSchema = EvoluSchema> {
+export interface EvoluConfig extends Partial<DbConfig> {
+    /**
+     * Use the `indexes` option 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
+     *
+     * ```ts
+     * const evolu = createEvolu(evoluReactDeps)(Schema, {
+     *   indexes: (create) => [
+     *     create("todoCreatedAt").on("todo").column("createdAt"),
+     *     create("todoCategoryCreatedAt")
+     *       .on("todoCategory")
+     *       .column("createdAt"),
+     *   ],
+     * });
+     * ```
+     */
+    readonly indexes?: IndexesConfig;
+    /**
+     * URL to reload browser tabs after reset or restore.
+     *
+     * The default value is `/`.
+     */
+    readonly reloadUrl?: string;
+}
+export interface Evolu<S extends EvoluSchema = EvoluSchema> extends Disposable {
     /**
      * Subscribe to {@link EvoluError} changes.
      *
@@ -40,7 +67,8 @@ export interface Evolu<S extends EvoluSchema = EvoluSchema> {
      * All this function does is compile the Kysely query and serialize it into a
      * unique string. Both operations are fast and cheap.
      *
-     * For mutations, use {@link Evolu.insert} and {@link Evolu.update}.
+     * For mutations, use {@link Evolu#insert}, {@link Evolu#update}, or
+     * {@link Evolu#upsert}.
      *
      * ### Example
      *
@@ -59,43 +87,16 @@ export interface Evolu<S extends EvoluSchema = EvoluSchema> {
     /**
      * Load {@link Query} and return a promise with {@link QueryRows}.
      *
-     * A returned promise always resolves successfully because there is no reason
-     * why loading should fail. All data are local, and the query is typed. A
-     * serious unexpected Evolu error shall be handled with
-     * {@link Evolu.subscribeError}.
-     *
-     * Loading is batched, and returned promises are cached, so there is no need
-     * for an additional cache. Evolu's internal cache is invalidated on
-     * mutation.
-     *
-     * The returned promise is enriched with special status and value properties
-     * for the upcoming React `use` Hook, but other UI libraries can also leverage
-     * them. Speaking of React, there are two essential React Suspense-related
-     * patterns that every developer should be aware of—passing promises to
-     * children and caching over mutations.
-     *
-     * With promises passed to children, we can load a query as soon as possible,
-     * but we don't have to use the returned promise immediately. That's useful
-     * for prefetching, which is generally not necessary for local-first apps but
-     * can be if a query takes a long time to load.
-     *
-     * Caching over mutation is a pattern that every developer should know. As we
-     * said, Evolu caches promise until a mutation happens. A query loaded after
-     * that will return a new pending promise. That's okay for general usage but
-     * not for UI with React Suspense because a mutation would suspend rerendered
-     * queries on a page, and that's not a good UX.
-     *
-     * We call this pattern "caching over mutation" because it has no globally
-     * accepted name yet. React RFC for React Cache does not exist yet.
+     * The returned promise always resolves successfully because there is no
+     * reason why loading should fail. All data are local, and the query is typed.
+     * Unexpected errors are handled with {@link Evolu#subscribeError}.
      *
-     * For better UX, a query must be subscribed for updates. This way, instead of
-     * Suspense flashes, the user sees new data immediately because Evolu replaces
-     * cached promises with fresh, already resolved new ones.
+     * Loading is batched, and returned promises are cached until resolved to
+     * prevent redundant database queries and to support React Suspense (which
+     * requires stable promise references while pending).
      *
-     * If you are curious why Evolu does not do that for all queries by default,
-     * the answer is simple: performance. Tracking changes is costly and
-     * meaningful only for visible (hence subscribed) queries anyway. To subscribe
-     * to a query, use {@link Evolu.subscribeQuery}.
+     * To subscribe a query for automatic updates, use
+     * {@link Evolu#subscribeQuery}.
      *
      * ### Example
      *
@@ -103,7 +104,7 @@ export interface Evolu<S extends EvoluSchema = EvoluSchema> {
      * const allTodos = evolu.createQuery((db) =>
      *   db.selectFrom("todo").selectAll(),
      * );
-     * evolu.loadQuery(allTodos).then(({ rows }) => {
+     * evolu.loadQuery(allTodos).then((rows) => {
      *   console.log(rows);
      * });
      * ```
@@ -146,80 +147,165 @@ export interface Evolu<S extends EvoluSchema = EvoluSchema> {
      */
     readonly getQueryRows: <R extends Row>(query: Query<R>) => QueryRows<R>;
     /**
-     * Subscribe to {@link AppOwner} changes.
+     * Promise that resolves to {@link AppOwner} when available.
+     *
+     * Note: With web-only deps, this promise will not resolve during SSR because
+     * there is no AppOwner on the server.
      *
      * ### Example
      *
      * ```ts
-     * const unsubscribe = evolu.subscribeAppOwner(() => {
-     *   const owner = evolu.getAppOwner();
-     * });
+     * const owner = await evolu.appOwner;
      * ```
      */
-    readonly subscribeAppOwner: StoreSubscribe;
+    readonly appOwner: Promise<AppOwner>;
     /**
-     * Get {@link AppOwner}.
+     * Inserts a row into the database and returns a {@link Result} with the new
+     * {@link Id}.
      *
-     * ### Example
+     * The first argument is the table name, and the second is an object
+     * containing the row data. An optional third argument provides mutation
+     * options including an `onComplete` callback and `onlyValidate` flag.
      *
-     * ```ts
-     * const unsubscribe = evolu.subscribeAppOwner(() => {
-     *   const owner = evolu.getAppOwner();
-     * });
-     * ```
-     */
-    readonly getAppOwner: () => AppOwner | null;
-    /**
-     * Subscribe to {@link SyncState} changes.
+     * Returns a Result type - use `.ok` to check if the insertion succeeded, and
+     * `.value.id` to access the generated ID on success, or `.error` to handle
+     * validation errors.
+     *
+     * Evolu does not use SQL for mutations to ensure data can be safely and
+     * predictably merged without conflicts. Explicit mutations also allow Evolu
+     * to automatically update {@link SystemColumns}.
      *
      * ### Example
      *
      * ```ts
-     * const unsubscribe = evolu.subscribeSyncState(() => {
-     *   const syncState = evolu.getSyncState();
+     * const result = evolu.insert("todo", {
+     *   title: "Learn Evolu",
+     *   isCompleted: false,
      * });
+     *
+     * if (result.ok) {
+     *   console.log("Todo created with ID:", result.value.id);
+     * } else {
+     *   console.error("Validation error:", result.error);
+     * }
+     *
+     * // With onComplete callback
+     * evolu.insert(
+     *   "todo",
+     *   { title: "Another todo" },
+     *   {
+     *     onComplete: () => {
+     *       console.log("Insert completed");
+     *     },
+     *   },
+     * );
      * ```
      */
-    readonly subscribeSyncState: StoreSubscribe;
+    insert: Mutation<S, "insert">;
     /**
-     * Get {@link SyncState}.
+     * Updates a row in the database and returns a {@link Result} with the existing
+     * {@link Id}.
+     *
+     * The first argument is the table name, and the second is an object
+     * containing the row data including the required `id` field. An optional
+     * third argument provides mutation options including an `onComplete` callback
+     * and `onlyValidate` flag.
+     *
+     * Returns a Result type - use `.ok` to check if the update succeeded, and
+     * `.value.id` to access the ID on success, or `.error` to handle validation
+     * errors.
+     *
+     * Evolu does not use SQL for mutations to ensure data can be safely and
+     * predictably merged without conflicts. Explicit mutations also allow Evolu
+     * to automatically update {@link SystemColumns}.
      *
      * ### Example
      *
      * ```ts
-     * const unsubscribe = evolu.subscribeSyncState(() => {
-     *   const syncState = evolu.getSyncState();
+     * const result = evolu.update("todo", {
+     *   id: todoId,
+     *   title: "Updated title",
+     *   isCompleted: true,
      * });
+     *
+     * if (result.ok) {
+     *   console.log("Todo updated with ID:", result.value.id);
+     * } else {
+     *   console.error("Validation error:", result.error);
+     * }
+     *
+     * // To delete a row, set isDeleted to true
+     * evolu.update("todo", { id: todoId, isDeleted: true });
+     *
+     * // With onComplete callback
+     * evolu.update(
+     *   "todo",
+     *   { id: todoId, title: "New title" },
+     *   {
+     *     onComplete: () => {
+     *       console.log("Update completed");
+     *     },
+     *   },
+     * );
      * ```
      */
-    readonly getSyncState: () => SyncState;
+    update: Mutation<S, "update">;
     /**
-     * Inserts a row.
+     * Upserts a row in the database and returns a {@link Result} with the existing
+     * {@link Id}.
      *
-     * ### Example
+     * The first argument is the table name, and the second is an object
+     * containing the row data including the required `id` field. An optional
+     * third argument provides mutation options including an `onComplete` callback
+     * and `onlyValidate` flag.
      *
-     * ```ts
-     * // TODO:
-     * ```
-     */
-    insert: Mutation<S, "insert">;
-    /**
-     * Updates a row.
+     * This function allows you to use custom IDs and optionally set `createdAt`,
+     * which is useful for external systems, data migrations, or when the same row
+     * may already be created on a different device.
      *
-     * ### Example
+     * Returns a Result type - use `.ok` to check if the upsert succeeded, and
+     * `.value.id` to access the ID on success, or `.error` to handle validation
+     * errors.
      *
-     * ```ts
-     * // TODO:
-     * ```
-     */
-    update: Mutation<S, "update">;
-    /**
-     * Upserts a row.
+     * Evolu does not use SQL for mutations to ensure data can be safely and
+     * predictably merged without conflicts. Explicit mutations also allow Evolu
+     * to automatically update {@link SystemColumns}.
      *
      * ### Example
      *
      * ```ts
-     * // TODO:
+     * // Use deterministic ID for stable upserts across devices
+     * const stableId = createIdFromString("my-todo-1");
+     *
+     * const result = evolu.upsert("todo", {
+     *   id: stableId,
+     *   title: "Learn Evolu",
+     *   isCompleted: false,
+     * });
+     *
+     * if (result.ok) {
+     *   console.log("Todo upserted with ID:", result.value.id);
+     * } else {
+     *   console.error("Validation error:", result.error);
+     * }
+     *
+     * // Data migration with custom createdAt
+     * evolu.upsert("todo", {
+     *   id: externalId,
+     *   title: "Migrated todo",
+     *   createdAt: new Date("2023-01-01"), // Preserve original timestamp
+     * });
+     *
+     * // With onComplete callback
+     * evolu.upsert(
+     *   "todo",
+     *   { id: stableId, title: "Updated title" },
+     *   {
+     *     onComplete: () => {
+     *       console.log("Upsert completed");
+     *     },
+     *   },
+     * );
      * ```
      */
     upsert: Mutation<S, "upsert">;
@@ -237,7 +323,7 @@ export interface Evolu<S extends EvoluSchema = EvoluSchema> {
     }) => Promise<void>;
     /**
      * Restore {@link AppOwner} with all their synced data. It uses
-     * {@link Evolu.resetAppOwner}, so be careful.
+     * {@link Evolu#resetAppOwner}, so be careful.
      */
     readonly restoreAppOwner: (mnemonic: Mnemonic, options?: {
         readonly reload?: boolean;
@@ -247,59 +333,46 @@ export interface Evolu<S extends EvoluSchema = EvoluSchema> {
      * all tabs using Evolu. For native apps, it will restart the app.
      */
     readonly reloadApp: () => void;
-    /** Export SQLite database file as Uint8Array. */
-    readonly exportDatabase: () => Promise<Uint8Array>;
-}
-/** Represent errors that can occur in Evolu. */
-export type EvoluError = TimestampError | ProtocolError | TransferableError | SymmetricCryptoDecryptError | ProtocolUnsupportedVersionError | SqliteError;
-export type EvoluDeps = CreateDbWorkerDep & TimeDep & NanoIdLibDep & Partial<FlushSyncDep> & ConsoleDep & CreateAppStateDep;
-export interface EvoluConfigWithInitialData<S extends EvoluSchema = EvoluSchema> extends Config {
     /**
-     * Use this option to create initial data (fixtures).
+     * Export SQLite database file as Uint8Array.
+     *
+     * In the future, it will be possible to import a database and export/import
+     * history for 1:1 migrations across owners.
+     */
+    readonly exportDatabase: () => Promise<Uint8Array<ArrayBuffer>>;
+    /**
+     * Use an owner. Using an owner means syncing it and subscribing to
+     * broadcasted changes. Returns a function to stop using the owner.
+     *
+     * Transport connections are automatically deduplicated and reference-counted,
+     * so multiple owners using the same transport will share a single
+     * connection.
      *
      * ### Example
      *
      * ```ts
-     * const evolu = createEvolu(evoluReactWebDeps)(Schema, {
-     *   initialData: (evolu) => {
-     *     const todoCategory = evolu.insert("todoCategory", {
-     *       name: "Not Urgent",
-     *     });
-     *
-     *     // This is a developer error, which should be fixed immediately.
-     *     assert(todoCategory.ok, "invalid initial data");
-     *
-     *     evolu.insert("todo", {
-     *       title: "Try React Suspense",
-     *       categoryId: todoCategory.value.id,
-     *     });
-     *   },
-     * });
+     * // Use an owner (starts syncing and subscribing to changes).
+     * const unuse = evolu.useOwner(shardOwner);
+     *
+     * // Later, stop using the owner.
+     * unuse();
+     *
+     * // Bulk operations.
+     * const unuses = owners.map((owner) => evolu.useOwner(owner));
+     * // Later: unuses.forEach(unuse => unuse());
      * ```
+     *
+     * @experimental
      */
-    initialData?: (evolu: EvoluForInitialData<S>) => void;
-}
-export interface EvoluForInitialData<S extends EvoluSchema = EvoluSchema> {
-    insert: Mutation<S, "insert">;
+    readonly useOwner: (owner: SyncOwner) => () => void;
 }
+/** Represents errors that can occur in Evolu. */
+export type EvoluError = ProtocolError | SqliteError | SymmetricCryptoDecryptError | TimestampError | TransferableError;
+export type EvoluDeps = ConsoleDep & CreateDbWorkerDep & Partial<FlushSyncDep> & RandomBytesDep & ReloadAppDep & TimeDep;
 /**
- * Creates an {@link Evolu} instance configured with the specified
- * {@link EvoluSchema} and optional configuration.
- *
- * This function returns a configured Evolu instance, providing a typed
- * interface for querying, mutating, and syncing your application's data. The
- * returned instance includes:
- *
- * - Subscription methods for receiving updates on queries, the owner, errors, and
- *   sync state.
- * - Methods for creating, updating, or deleting rows in a type-safe manner.
- * - Methods for querying data using Evolu's typed SQL queries, leveraging Kysely
- *   under the hood.
- * - Built-in support for local-first and offline-first data with automatic sync
- *   and merging.
- * - Automatic schema evolution that updates the underlying database with new
- *   columns or tables.
- * - Managing owner data with resetAppOwner and restoreAppOwner.
+ * Creates an {@link Evolu} instance for a platform configured with the specified
+ * {@link EvoluSchema} and optional {@link EvoluConfig} providing a typed
+ * interface for querying, mutating, and syncing your application's data.
  *
  * ### Example
  *
@@ -328,7 +401,14 @@ export interface EvoluForInitialData<S extends EvoluSchema = EvoluSchema> {
  *
  * const evolu = createEvolu(evoluReactDeps)(Schema);
  * ```
+ *
+ * ### Instance Caching
+ *
+ * `createEvolu` caches instances using {@link Instances} by {@link EvoluConfig}
+ * name to enable hot reloading and prevent database corruption from multiple
+ * connections. For testing, use unique instance names to ensure proper
+ * isolation.
  */
-export declare const createEvolu: (deps: EvoluDeps) => <S extends EvoluSchema>(schema: ValidateSchema<S> extends never ? S : ValidateSchema<S>, partialConfig?: Partial<EvoluConfigWithInitialData<S>>) => Evolu<S>;
-export declare const createNamespaceName: (config: Config) => (name: string) => string;
+export declare const createEvolu: (deps: EvoluDeps) => <S extends EvoluSchema>(schema: ValidateSchema<S> extends never ? S : ValidateSchema<S>, config?: EvoluConfig) => Evolu<S>;
+export declare const createQuery: <R extends Row>(queryCallback: Parameters<CreateQuery<EvoluSchema>>[0], options?: Parameters<CreateQuery<EvoluSchema>>[1]) => Query<R>;
 //# sourceMappingURL=Evolu.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Evolu.d.ts","sourceRoot":"","sources":["../../../src/Evolu/Evolu.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,2BAA2B,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,OAAO,EAA0B,WAAW,EAAe,MAAM,cAAc,CAAC;AAChF,OAAO,EAAe,cAAc,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EAML,QAAQ,EAET,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,MAAM,EAAiB,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAG5C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAChE,OAAO,EAEL,aAAa,EACb,+BAA+B,EAChC,MAAM,eAAe,CAAC;AACvB,OAAO,EAGL,OAAO,EACP,0BAA0B,EAC1B,KAAK,EACL,SAAS,EAET,GAAG,EAGJ,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,WAAW,EACX,WAAW,EAGX,QAAQ,EAMR,cAAc,EAGf,MAAM,aAAa,CAAC;AACrB,OAAO,EAAoB,SAAS,EAAE,MAAM,WAAW,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD,MAAM,WAAW,KAAK,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW;IACxD;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IAExC,8BAA8B;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,UAAU,GAAG,IAAI,CAAC;IAE3C;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;IAErC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAmDG;IACH,QAAQ,CAAC,SAAS,EAAE,CAAC,CAAC,SAAS,GAAG,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;IAE9E;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC,SAAS,GAAG,EAAE,CAAC,SAAS,OAAO,CAAC,CAAC,CAAC,EACxD,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC,KACZ,CAAC,GAAG,0BAA0B,CAAC,CAAC,CAAC,CAAC,CAAC;IAExC;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,cAAc,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,cAAc,CAAC;IAE1D;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,YAAY,EAAE,CAAC,CAAC,SAAS,GAAG,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC;IAExE;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,iBAAiB,EAAE,cAAc,CAAC;IAE3C;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,QAAQ,GAAG,IAAI,CAAC;IAE5C;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,kBAAkB,EAAE,cAAc,CAAC;IAE5C;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,YAAY,EAAE,MAAM,SAAS,CAAC;IAEvC;;;;;;;;OAQG;IACH,MAAM,EAAE,QAAQ,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;IAE9B;;;;;;;;OAQG;IACH,MAAM,EAAE,QAAQ,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;IAE9B;;;;;;;;OAQG;IACH,MAAM,EAAE,QAAQ,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;IAE9B;;;;;;;;OAQG;IACH,QAAQ,CAAC,aAAa,EAAE,CAAC,OAAO,CAAC,EAAE;QACjC,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;KAC3B,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpB;;;OAGG;IACH,QAAQ,CAAC,eAAe,EAAE,CACxB,QAAQ,EAAE,QAAQ,EAClB,OAAO,CAAC,EAAE;QACR,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;KAC3B,KACE,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnB;;;OAGG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,IAAI,CAAC;IAE/B,iDAAiD;IACjD,QAAQ,CAAC,cAAc,EAAE,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC;CACpD;AAED,gDAAgD;AAChD,MAAM,MAAM,UAAU,GAClB,cAAc,GACd,aAAa,GACb,iBAAiB,GACjB,2BAA2B,GAC3B,+BAA+B,GAC/B,WAAW,CAAC;AAWhB,MAAM,MAAM,SAAS,GAAG,iBAAiB,GACvC,OAAO,GACP,YAAY,GACZ,OAAO,CAAC,YAAY,CAAC,GACrB,UAAU,GACV,iBAAiB,CAAC;AAEpB,MAAM,WAAW,0BAA0B,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,CAC7E,SAAQ,MAAM;IACd;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,mBAAmB,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;CACvD;AAED,MAAM,WAAW,mBAAmB,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW;IACtE,MAAM,EAAE,QAAQ,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;CAC/B;AAOD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,eAAO,MAAM,WAAW,GACrB,MAAM,SAAS,MACf,CAAC,SAAS,WAAW,EACpB,QAAQ,cAAc,CAAC,CAAC,CAAC,SAAS,KAAK,GAAG,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,EAC/D,gBAAe,OAAO,CAAC,0BAA0B,CAAC,CAAC,CAAC,CAAM,KACzD,KAAK,CAAC,CAAC,CAiBT,CAAC;AAgYJ,eAAO,MAAM,mBAAmB,GAC7B,QAAQ,MAAM,MACd,MAAM,MAAM,KAAG,MACgB,CAAC"}
+{"version":3,"file":"Evolu.d.ts","sourceRoot":"","sources":["../../../src/Evolu/Evolu.ts"],"names":[],"mappings":"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"}