@evolu/common 6.0.1-preview.2 → 6.0.1-preview.21

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,81 @@
-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 { 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 { CreateSqliteStorageBaseOptions, SqliteStorageDeps, Storage } from "./Storage.js";
 export interface Relay extends Disposable {
 }
 export interface RelayConfig extends ConsoleConfig {
+    /**
+     * The relay name.
+     *
+     * Implementations can use this for identification purposes (e.g., database
+     * file name, logging).
+     */
     readonly name?: SimpleName;
+    /**
+     * Optional callback to authenticate an {@link OwnerId} with the relay.
+     *
+     * If this callback is not provided, all owners are allowed.
+     *
+     * If provided, the callback receives the OwnerId and should return a promise
+     * that resolves to `true` to allow access, or `false` to deny.
+     *
+     * The callback returns a boolean rather than an error type because error
+     * handling and logging are the responsibility of the callback implementation,
+     * not the relay. This prevents leaking authentication implementation details
+     * into the generic relay interface.
+     *
+     * OwnerId is used for authentication 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 TransportConfig}. 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>`).
+     *
+     * ### Example
+     *
+     * ```ts
+     * const relay = await createNodeJsRelay(deps)({
+     *   authenticateOwner: async (ownerId) => {
+     *     const isRegistered = await db.checkOwner(ownerId);
+     *     if (!isRegistered) {
+     *       logger.warn("Unauthorized access attempt", { ownerId });
+     *     }
+     *     return isRegistered;
+     *   },
+     * });
+     * ```
+     */
+    readonly authenticateOwner?: (ownerId: OwnerId) => Promise<boolean>;
 }
-export declare const createRelayStorage: (deps: SqliteStorageDeps) => (options: CreateSqliteStorageBaseOptions) => Result<Storage, SqliteError>;
+export declare const createRelaySqliteStorage: (deps: SqliteStorageDeps & TimingSafeEqualDep) => (options: CreateSqliteStorageBaseOptions) => Result<Storage, 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 authenticateOwnerError: (error: unknown) => 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 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,10 +1,9 @@
 import { isNonEmptyReadonlyArray } from "../Array.js";
-import { eqArrayNumber } from "../Eq.js";
-import { ok } from "../Result.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) => {
+import { timestampToTimestampBytes } from "./Timestamp.js";
+export const createRelaySqliteStorage = (deps) => (options) => {
     const sqliteStorageBase = createSqliteStorageBase(deps)(options);
     if (!sqliteStorageBase.ok)
         return sqliteStorageBase;
@@ -34,7 +33,7 @@ export const createRelayStorage = (deps) => (options) => {
     return ok({
         ...sqliteStorageBase.value,
         /**
-         * 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,10 +43,10 @@ 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);
                 return false;
@@ -64,12 +63,27 @@ export const createRelayStorage = (deps) => (options) => {
                 }
                 return true;
             }
-            return eqArrayNumber(rows[0].writeKey, writeKey);
+            return deps.timingSafeEqual(rows[0].writeKey, writeKey);
+        },
+        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) {
+                options.onStorageError(upsertWriteKey.error);
+                return false;
+            }
+            return true;
         },
-        writeMessages: (ownerId, messages) => {
+        // https://eslint.org/docs/latest/rules/require-await#when-not-to-use-it
+        // eslint-disable-next-line @typescript-eslint/require-await
+        writeMessages: async (ownerId, messages) => {
             const result = deps.sqlite.transaction(() => {
                 for (const message of messages) {
-                    const insertTimestampResult = sqliteStorageBase.value.insertTimestamp(ownerId, timestampToBinaryTimestamp(message.timestamp));
+                    const insertTimestampResult = sqliteStorageBase.value.insertTimestamp(ownerId, timestampToTimestampBytes(message.timestamp));
                     if (!insertTimestampResult.ok)
                         return insertTimestampResult;
                     const insertMessage = deps.sqlite.exec(sql `
@@ -77,7 +91,7 @@ export const createRelayStorage = (deps) => (options) => {
               values
                 (
                   ${ownerId},
-                  ${timestampToBinaryTimestamp(message.timestamp)},
+                  ${timestampToTimestampBytes(message.timestamp)},
                   ${message.change}
                 )
               on conflict do nothing;
@@ -105,5 +119,102 @@ export const createRelayStorage = (deps) => (options) => {
             }
             return result.value.rows[0]?.change;
         },
+        deleteOwner: (ownerId) => {
+            const result = deps.sqlite.transaction(() => {
+                const del1 = deps.sqlite.exec(sql `
+            delete from evolu_writeKey where ownerId = ${ownerId};
+          `);
+                if (!del1.ok)
+                    return del1;
+                const del2 = deps.sqlite.exec(sql `
+            delete from evolu_message where ownerId = ${ownerId};
+          `);
+                if (!del2.ok)
+                    return del2;
+                const del3 = sqliteStorageBase.value.deleteOwner(ownerId);
+                if (!del3)
+                    return err(null);
+                return ok();
+            });
+            if (!result.ok) {
+                if (result.error)
+                    options.onStorageError(result.error);
+                return false;
+            }
+            return true;
+        },
     });
 };
+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 });
+    },
+    authenticateOwnerError: (error) => {
+        deps.console.error("[relay]", "authenticateOwner error", error);
+    },
+    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");
+    },
+});