@evolu/common 6.0.1-preview.3 → 6.0.1-preview.31

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

@@ -4,15 +4,13 @@
  * @module
  */
 export { createEvolu } from "./Evolu.js";
-export type { Evolu, EvoluConfigWithInitialData, EvoluDeps, EvoluError, } from "./Evolu.js";
+export type { Evolu, EvoluConfig, EvoluDeps, EvoluError } from "./Evolu.js";
 export * from "./Owner.js";
-export { binaryIdToId, idToBinaryId } from "./Protocol.js";
-export type { BinaryId } from "./Protocol.js";
+export * from "./LocalAuth.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";
+export type { EvoluSchema } from "./Schema.js";
+export type { NetworkError, PaymentRequiredError, ServerError, SyncOwner, SyncState, SyncStateInitial, SyncStateIsNotSynced, SyncStateIsSynced, SyncStateIsSyncing, } from "./Sync.js";
+export { Timestamp, timestampBytesToTimestamp, timestampToTimestampBytes, } from "./Timestamp.js";
+export type { TimestampBytes, TimestampCounterOverflowError, TimestampDriftError, TimestampError, TimestampTimeOutOfRangeError, } from "./Timestamp.js";
 //# sourceMappingURL=Public.d.ts.map

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

@@ -1 +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"}
+{"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,EAAE,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC5E,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,YAAY,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AAClE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,YAAY,EACV,YAAY,EACZ,oBAAoB,EACpB,WAAW,EACX,SAAS,EACT,SAAS,EACT,gBAAgB,EAChB,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,SAAS,EACT,yBAAyB,EACzB,yBAAyB,GAC1B,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACV,cAAc,EACd,6BAA6B,EAC7B,mBAAmB,EACnB,cAAc,EACd,4BAA4B,GAC7B,MAAM,gBAAgB,CAAC"}

package/dist/src/Evolu/Public.js

@@ -5,7 +5,6 @@
  */
 export { createEvolu } from "./Evolu.js";
 export * from "./Owner.js";
-export { binaryIdToId, idToBinaryId } from "./Protocol.js";
+export * from "./LocalAuth.js";
 export * as kysely from "./PublicKysely.js";
-export { formatValidMutationSizeError } from "./Schema.js";
-export { binaryTimestampToTimestamp, Timestamp, timestampToBinaryTimestamp, } from "./Timestamp.js";
+export { Timestamp, timestampBytesToTimestamp, timestampToTimestampBytes, } from "./Timestamp.js";

package/dist/src/Evolu/PublicKysely.js

@@ -48,7 +48,7 @@ export { sql } from "kysely";
  * from "person"
  * ```
  */
-// SQL formatting breaks generated SQL for some reason.
+// Kysely expects strict AST.
 // 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)`;
@@ -100,7 +100,7 @@ export function jsonArrayFrom(expr) {
  * from "person";
  * ```
  */
-// SQL formatting breaks generated SQL for some reason.
+// Kysely expects strict AST.
 // prettier-ignore
 export function jsonObjectFrom(expr) {
     return sql `(select ${sql.lit(kyselyJsonIdentifier)} || json_object(${sql.join(getSqliteJsonObjectArgs(expr.toOperationNode(), 'obj'))}) from ${expr} as obj)`;
@@ -145,7 +145,7 @@ export function jsonObjectFrom(expr) {
  * from "person"
  * ```
  */
-// SQL formatting breaks generated SQL for some reason.
+// Kysely expects strict AST.
 // 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]]))})`;

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

@@ -1,6 +1,7 @@
 import { SqliteQuery, SqliteRow, SqliteValue } from "../Sqlite.js";
 import { Store, StoreSubscribe } from "../Store.js";
-import { Brand, Simplify } from "../Types.js";
+import { Simplify } from "../Types.js";
+import { Brand } from "../Brand.js";
 /**
  * A type-safe SQL query.
  *

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

@@ -1 +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"}
+{"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,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEpC;;;;;;;;;;;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/Relay.d.ts

@@ -1,13 +1,98 @@
-import { ConsoleConfig } from "../Console.js";
+import { ConsoleConfig, ConsoleDep } from "../Console.js";
+import { TimingSafeEqualDep } from "../Crypto.js";
+import { LazyValue } from "../Function.js";
 import { Result } from "../Result.js";
-import { SqliteError } from "../Sqlite.js";
+import { SqliteDep, SqliteError } from "../Sqlite.js";
+import { MaybeAsync } from "../Task.js";
 import { SimpleName } from "../Type.js";
-import { Storage } from "./Protocol.js";
-import { CreateSqliteStorageBaseOptions, SqliteStorageDeps } from "./Storage.js";
+import { OwnerId } from "./Owner.js";
+import { ProtocolInvalidDataError } from "./Protocol.js";
+import { CreateBaseSqliteStorageConfig, SqliteStorageDeps, Storage, StorageConfig } from "./Storage.js";
+export interface RelayConfig extends ConsoleConfig, StorageConfig {
+    /**
+     * The relay name.
+     *
+     * Implementations can use this for identification purposes (e.g., database
+     * file name, logging).
+     */
+    readonly name?: SimpleName;
+    /**
+     * Optional callback to check if an {@link OwnerId} is allowed to access the
+     * relay. If this callback is not provided, all owners are allowed.
+     *
+     * The callback receives the {@link OwnerId} and returns a {@link MaybeAsync}
+     * boolean: `true` to allow access, or `false` to deny.
+     *
+     * The callback can be synchronous (for SQLite or in-memory checks) or
+     * asynchronous (for calling remote APIs).
+     *
+     * The callback returns a boolean rather than an error type because error
+     * handling and logging are the responsibility of the callback
+     * implementation.
+     *
+     * OwnerId is used rather than short-lived tokens because this only controls
+     * relay access, not write permissions. Since all data is encrypted on the
+     * relay, OwnerId exposure is safe.
+     *
+     * Owners specify which relays to connect to via {@link OwnerTransport}. In
+     * WebSocket-based implementations, this check occurs before accepting the
+     * connection, with the OwnerId typically extracted from the URL Path (e.g.,
+     * `ws://localhost:4000/<ownerId>`). The relay requires the URL to be in the
+     * correct format for OwnerId extraction.
+     *
+     * ### Example
+     *
+     * ```ts
+     * // Client
+     * const transport = createOwnerWebSocketTransport({
+     *   url: "wss://relay.evolu.dev",
+     *   ownerId: owner.id,
+     * });
+     *
+     * const evolu = createEvolu(deps)(Schema, {
+     *   transports: [transport],
+     * });
+     *
+     *
+     * // Relay
+     * isOwnerAllowed: (ownerId) =>
+     *   Promise.resolve(ownerId === "6jy_2F4RT5qqeLgJ14_dnQ"),
+     * ```
+     */
+    readonly isOwnerAllowed?: (ownerId: OwnerId) => MaybeAsync<boolean>;
+}
+/**
+ * A completely interchangeable server for syncing and backing up encrypted data
+ * between Evolu clients.
+ *
+ * Unlike traditional servers, relays are blind by design—they transmit
+ * encrypted data without understanding its shape or meaning. This enables true
+ * decentralization and infinite horizontal scalability with minimal
+ * infrastructure.
+ */
 export interface Relay extends Disposable {
 }
-export interface RelayConfig extends ConsoleConfig {
-    readonly name?: SimpleName;
+export declare const createRelaySqliteStorage: (deps: SqliteStorageDeps & TimingSafeEqualDep) => (config: CreateBaseSqliteStorageConfig) => Storage;
+export declare const createRelayStorageTables: (deps: SqliteDep) => Result<void, SqliteError>;
+export interface RelayLogger {
+    readonly started: (enableLogging: boolean, port: number) => void;
+    readonly storageError: (error: unknown) => void;
+    readonly upgradeSocketError: (error: Error) => void;
+    readonly invalidOrMissingOwnerIdInUrl: (url: string | undefined) => void;
+    readonly unauthorizedOwner: (ownerId: OwnerId) => void;
+    readonly connectionEstablished: (totalConnectionCount: number) => void;
+    readonly connectionWebSocketError: (error: Error) => void;
+    readonly relayOptionSubscribe: (ownerId: OwnerId, getSubscriberCount: LazyValue<number>) => void;
+    readonly relayOptionUnsubscribe: (ownerId: OwnerId, getSubscriberCount: LazyValue<number>) => void;
+    readonly relayOptionBroadcast: (ownerId: OwnerId, broadcastCount: number, subscriberCount: number) => void;
+    readonly messageLength: (messageLength: number) => void;
+    readonly applyProtocolMessageAsRelayError: (error: ProtocolInvalidDataError) => void;
+    readonly responseLength: (responseLength: number) => void;
+    readonly applyProtocolMessageAsRelayUnknownError: (error: unknown) => void;
+    readonly connectionClosed: (totalConnectionCount: number) => void;
+    readonly shuttingDown: () => void;
+    readonly webSocketServerDisposed: () => void;
+    readonly httpServerDisposed: () => void;
 }
-export declare const createRelayStorage: (deps: SqliteStorageDeps) => (options: CreateSqliteStorageBaseOptions) => Result<Storage, SqliteError>;
+export declare const createRelayLogger: (deps: ConsoleDep) => RelayLogger;
 //# sourceMappingURL=Relay.d.ts.map

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

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

package/dist/src/Evolu/Relay.js

@@ -1,40 +1,26 @@
-import { isNonEmptyReadonlyArray } from "../Array.js";
-import { eqArrayNumber } from "../Eq.js";
-import { ok } from "../Result.js";
+import { filterArray, firstInArray, isNonEmptyReadonlyArray, mapArray, } from "../Array.js";
+import { createInstances } from "../Instances.js";
+import { err, 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,
+import { createMutex, isAsync } from "../Task.js";
+import { PositiveInt } from "../Type.js";
+import { ownerIdBytesToOwnerId, } from "./Owner.js";
+import { createBaseSqliteStorage, getOwnerUsage, getTimestampInsertStrategy, updateOwnerUsage, } from "./Storage.js";
+import { timestampToTimestampBytes } from "./Timestamp.js";
+export const createRelaySqliteStorage = (deps) => (config) => {
+    const sqliteStorageBase = createBaseSqliteStorage(deps)(config);
+    /**
+     * Mutex instances are cached per OwnerId to prevent concurrent writes for
+     * the same owner. Instances are never evicted, causing a memory leak
+     * proportional to unique owner count. However, per-instance overhead should
+     * be small. Monitor production memory usage to determine if
+     * eviction/cleanup is needed.
+     */
+    const ownerMutexes = createInstances();
+    return {
+        ...sqliteStorageBase,
         /**
-         * Lazily authorizes the initiator's {@link WriteKey} for the given
+         * Lazily authorizes the initiator's {@link OwnerWriteKey} for the given
          * {@link OwnerId}.
          *
          * - If the {@link OwnerId} does not exist, it is created and associated with
@@ -44,55 +30,106 @@ export const createRelayStorage = (deps) => (options) => {
          */
         validateWriteKey: (ownerId, writeKey) => {
             const selectWriteKey = deps.sqlite.exec(sql `
-          select writeKey
-          from evolu_writeKey
-          where ownerId = ${ownerId};
-        `);
+            select writeKey
+            from evolu_writeKey
+            where ownerId = ${ownerId};
+          `);
             if (!selectWriteKey.ok) {
-                options.onStorageError(selectWriteKey.error);
+                config.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;
+            if (isNonEmptyReadonlyArray(rows)) {
+                return deps.timingSafeEqual(rows[0].writeKey, writeKey);
             }
-            return eqArrayNumber(rows[0].writeKey, writeKey);
+            const insertWriteKey = deps.sqlite.exec(sql `
+          insert into evolu_writeKey (ownerId, writeKey)
+          values (${ownerId}, ${writeKey});
+        `);
+            if (!insertWriteKey.ok) {
+                config.onStorageError(insertWriteKey.error);
+                return false;
+            }
+            return true;
         },
-        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);
+        setWriteKey: (ownerId, writeKey) => {
+            const upsertWriteKey = deps.sqlite.exec(sql `
+          insert into evolu_writeKey (ownerId, writeKey)
+          values (${ownerId}, ${writeKey})
+          on conflict (ownerId) do update
+            set writeKey = excluded.writeKey;
+        `);
+            if (!upsertWriteKey.ok) {
+                config.onStorageError(upsertWriteKey.error);
                 return false;
             }
             return true;
         },
+        writeMessages: async (ownerIdBytes, messages) => {
+            const ownerId = ownerIdBytesToOwnerId(ownerIdBytes);
+            const messagesWithTimestampBytes = mapArray(messages, (m) => ({
+                timestamp: timestampToTimestampBytes(m.timestamp),
+                change: m.change,
+            }));
+            const result = await ownerMutexes
+                .ensure(ownerId, createMutex)
+                .withLock(async () => {
+                const existingTimestampsResult = sqliteStorageBase.getExistingTimestamps(ownerIdBytes, mapArray(messagesWithTimestampBytes, (m) => m.timestamp));
+                if (!existingTimestampsResult.ok)
+                    return existingTimestampsResult;
+                const existingTimestampsSet = new Set(existingTimestampsResult.value.map((t) => t.toString()));
+                const newMessages = filterArray(messagesWithTimestampBytes, (m) => !existingTimestampsSet.has(m.timestamp.toString()));
+                // Nothing to write
+                if (!isNonEmptyReadonlyArray(newMessages)) {
+                    return ok();
+                }
+                const usage = getOwnerUsage(deps)(ownerIdBytes, firstInArray(newMessages).timestamp);
+                if (!usage.ok)
+                    return usage;
+                const { storedBytes } = usage.value;
+                const incomingBytes = newMessages.reduce((sum, m) => sum + m.change.length, 0);
+                const newStoredBytes = PositiveInt.orThrow((storedBytes ?? 0) + incomingBytes);
+                const withinQuotaResult = config.isOwnerWithinQuota(ownerId, newStoredBytes);
+                const isWithinQuota = isAsync(withinQuotaResult)
+                    ? await withinQuotaResult
+                    : withinQuotaResult;
+                if (!isWithinQuota) {
+                    return err({ type: "StorageQuotaError", ownerId });
+                }
+                let { firstTimestamp, lastTimestamp } = usage.value;
+                return deps.sqlite.transaction(() => {
+                    for (const { timestamp, change } of newMessages) {
+                        let strategy;
+                        [strategy, firstTimestamp, lastTimestamp] =
+                            getTimestampInsertStrategy(timestamp, firstTimestamp, lastTimestamp);
+                        const insertTimestampResult = sqliteStorageBase.insertTimestamp(ownerIdBytes, timestamp, strategy);
+                        if (!insertTimestampResult.ok)
+                            return insertTimestampResult;
+                        const insertMessage = deps.sqlite.exec(sql `
+                  insert into evolu_message ("ownerId", "timestamp", "change")
+                  values (${ownerIdBytes}, ${timestamp}, ${change})
+                  on conflict do nothing;
+                `);
+                        if (!insertMessage.ok)
+                            return insertMessage;
+                    }
+                    const updateUsage = updateOwnerUsage(deps)(ownerIdBytes, newStoredBytes, firstTimestamp, lastTimestamp);
+                    if (!updateUsage.ok)
+                        return updateUsage;
+                    return ok();
+                });
+            })();
+            if (!result.ok && result.error.type !== "AbortError") {
+                switch (result.error.type) {
+                    case "SqliteError":
+                        config.onStorageError(result.error);
+                        return err({ type: "StorageWriteError", ownerId });
+                    case "StorageQuotaError":
+                        return err({ type: "StorageQuotaError", ownerId });
+                }
+            }
+            return ok();
+        },
         readDbChange: (ownerId, timestamp) => {
             const result = deps.sqlite.exec(sql `
           select "change"
@@ -100,10 +137,135 @@ export const createRelayStorage = (deps) => (options) => {
           where "ownerId" = ${ownerId} and "timestamp" = ${timestamp};
         `);
             if (!result.ok) {
-                options.onStorageError(result.error);
+                config.onStorageError(result.error);
                 return null;
             }
             return result.value.rows[0]?.change;
         },
-    });
+        deleteOwner: (ownerId) => {
+            const transactionResult = deps.sqlite.transaction(() => {
+                const deleteWriteKey = deps.sqlite.exec(sql `
+            delete from evolu_writeKey where ownerId = ${ownerId};
+          `);
+                if (!deleteWriteKey.ok)
+                    return deleteWriteKey;
+                const deleteMessages = deps.sqlite.exec(sql `
+            delete from evolu_message where ownerId = ${ownerId};
+          `);
+                if (!deleteMessages.ok)
+                    return deleteMessages;
+                const deleteUsage = deps.sqlite.exec(sql `
+            delete from evolu_usage where ownerId = ${ownerId};
+          `);
+                if (!deleteUsage.ok)
+                    return deleteUsage;
+                const deleteBaseOwner = sqliteStorageBase.deleteOwner(ownerId);
+                if (!deleteBaseOwner)
+                    return err(null);
+                return ok();
+            });
+            if (!transactionResult.ok) {
+                if (transactionResult.error)
+                    config.onStorageError(transactionResult.error);
+                return false;
+            }
+            return true;
+        },
+    };
 };
+export const createRelayStorageTables = (deps) => {
+    for (const query of [
+        sql `
+      create table evolu_writeKey (
+        "ownerId" blob not null,
+        "writeKey" blob not null,
+        primary key ("ownerId")
+      )
+      strict;
+    `,
+        sql `
+      create table 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();
+};
+export const createRelayLogger = (deps) => ({
+    started: (enableLogging, port) => {
+        deps.console.enabled = true;
+        deps.console.log(`Evolu Relay started on port ${port}`);
+        deps.console.enabled = enableLogging;
+    },
+    storageError: (error) => {
+        deps.console.error("[relay]", "storage", error);
+    },
+    upgradeSocketError: (error) => {
+        deps.console.warn("[relay]", "socket error", { error });
+    },
+    invalidOrMissingOwnerIdInUrl: (url) => {
+        deps.console.warn("[relay]", "invalid or missing ownerId in URL", { url });
+    },
+    unauthorizedOwner: (ownerId) => {
+        deps.console.warn("[relay]", "unauthorized owner", { ownerId });
+    },
+    connectionEstablished: (totalConnectionCount) => {
+        deps.console.log("[relay]", "connection", { totalConnectionCount });
+    },
+    connectionWebSocketError: (error) => {
+        deps.console.error("[relay]", "error", { error });
+    },
+    relayOptionSubscribe: (ownerId, getSubscriberCount) => {
+        if (deps.console.enabled)
+            deps.console.log("[relay]", "subscribe", {
+                ownerId,
+                subscriberCount: getSubscriberCount(),
+            });
+    },
+    relayOptionUnsubscribe: (ownerId, getSubscriberCount) => {
+        if (deps.console.enabled)
+            deps.console.log("[relay]", "unsubscribe", {
+                ownerId,
+                subscriberCount: getSubscriberCount(),
+            });
+    },
+    relayOptionBroadcast: (ownerId, broadcastCount, totalSubscribers) => {
+        deps.console.log("[relay]", "broadcast", {
+            ownerId,
+            broadcastCount,
+            totalSubscribers,
+        });
+    },
+    messageLength: (messageLength) => {
+        deps.console.log("[relay]", "on message", { messageLength });
+    },
+    applyProtocolMessageAsRelayError: (error) => {
+        deps.console.error("[relay]", "applyProtocolMessageAsRelay", error);
+    },
+    responseLength: (responseLength) => {
+        deps.console.log("[relay]", "responseLength", { responseLength });
+    },
+    applyProtocolMessageAsRelayUnknownError: (error) => {
+        deps.console.error("[relay]", "applyProtocolMessageAsRelayUnknownError", error);
+    },
+    connectionClosed: (totalConnectionCount) => {
+        deps.console.log("[relay]", "close", { totalConnectionCount });
+    },
+    shuttingDown: () => {
+        deps.console.log("Shutting down Evolu Relay...");
+    },
+    webSocketServerDisposed: () => {
+        deps.console.log("Evolu Relay WebSocketServer disposed");
+    },
+    httpServerDisposed: () => {
+        deps.console.log("Evolu Relay HTTP server disposed");
+    },
+});