@evolu/common 7.2.1 → 7.2.3

package/dist/src/local-first/Timestamp.d.ts.map

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

package/dist/src/local-first/Timestamp.js

@@ -218,7 +218,20 @@ export const timestampBytesToTimestamp = (timestamp) => {
     }
     return { millis: Number(millis), counter, nodeId };
 };
+/**
+ * An {@link Order} for {@link TimestampBytes}.
+ *
+ * This `Order` uses lexicographic byte order to compare serialized
+ * {@link TimestampBytes} produced by {@link timestampToTimestampBytes}. See
+ * {@link orderUint8Array} for the underlying implementation.
+ */
 export const orderTimestampBytes = orderUint8Array;
+/**
+ * Convert a {@link Timestamp} to an ISO 8601 {@link DateIso} string.
+ *
+ * The conversion uses the timestamp's `millis` (a {@link Millis} value) and
+ * `Date.prototype.toISOString()` to produce a `DateIso`.
+ */
 export const timestampToDateIso = (timestamp) => 
-// `as DateIso` is safe because the timestamp is always valid
+// `as DateIso` is safe because Timestamp guarantees a valid `millis`
 new Date(timestamp.millis).toISOString();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@evolu/common",
-  "version": "7.2.1",
+  "version": "7.2.3",
   "description": "TypeScript library and local-first platform",
   "keywords": [
     "evolu",

package/src/Object.ts

@@ -31,7 +31,7 @@ type StringKeyOf<T> = Extract<keyof T, string>;
  *
  * ```ts
  * type UserId = string & { readonly __brand: "UserId" };
- * const users: Record<UserId, string> = {};
+ * const users = createRecord<UserId, string>();
  * const entries = objectToEntries(users); // [UserId, string][]
  * ```
  */
@@ -70,3 +70,22 @@ export const excludeProp = <T extends object, K extends keyof T>(
   const { [prop]: _, ...rest } = obj;
   return rest;
 };
+
+/**
+ * Creates a prototype-less object typed as `Record<K, V>`.
+ *
+ * Use this function when you need a plain record without a prototype chain
+ * (e.g. when keys are controlled by external sources) to avoid prototype
+ * pollution and accidental collisions with properties like `__proto__`.
+ *
+ * Example:
+ *
+ * ```ts
+ * const values = createRecord<string, SqliteValue>();
+ * values["__proto__"] = someValue; // safe, no prototype pollution
+ * ```
+ */
+export const createRecord = <K extends string = string, V = unknown>(): Record<
+  K,
+  V
+> => Object.create(null) as Record<K, V>;

package/src/Order.ts

@@ -94,7 +94,8 @@ export const orderNumber = createOrder<number>((a, b) => a < b);
  */
 export const orderBigInt = createOrder<bigint>((a, b) => a < b);
 
-export const orderUint8Array: Order<globalThis.Uint8Array> = (a, b) => {
+/** An {@link Order} for Uint8Array. */
+export const orderUint8Array: Order<Uint8Array> = (a, b) => {
   if (a.byteLength > b.byteLength) return 1;
   if (a.byteLength < b.byteLength) return -1;
 

package/src/WebSocket.ts

@@ -171,7 +171,12 @@ export const createWebSocket: CreateWebSocket = (
     socket.onmessage = null;
     socket.onerror = null;
 
-    socket.close();
+    if (
+      socket.readyState !== socket.CLOSING &&
+      socket.readyState !== socket.CLOSED
+    ) {
+      socket.close();
+    }
     socket = null;
   };
 

package/src/local-first/Db.ts

@@ -336,9 +336,12 @@ export const createDbWorkerForPlatform = (
     DbWorkerInput,
     DbWorkerOutput,
     DbWorkerDeps
-  >({ init: createDbWorkerDeps(platformDeps), handlers });
+  >({
+    init: createInit(platformDeps),
+    handlers,
+  });
 
-const createDbWorkerDeps =
+const createInit =
   (platformDeps: DbWorkerPlatformDeps) =>
   async (
     initMessage: Extract<DbWorkerInput, { type: "init" }>,
@@ -376,16 +379,6 @@ const createDbWorkerDeps =
         }>(sql`select protocolVersion from evolu_version limit 1;`);
         if (!currentVersion.ok) return currentVersion;
 
-        // TODO: Handle version migrations here if needed
-        // const [{ protocolVersion }] = protocolVersionResult.value.rows;
-        // if (protocolVersion < currentProtocolVersion) {
-        //   const migrateResult = migrateDatabase({ sqlite })(
-        //     protocolVersion,
-        //     currentProtocolVersion
-        //   );
-        //   if (!migrateResult.ok) return migrateResult;
-        // }
-
         const configResult = sqlite.exec<{
           clock: TimestampBytes;
           appOwnerId: OwnerId;

package/src/local-first/Diff.ts

@@ -1,5 +1,5 @@
 import { createRandomBytes } from "../Crypto.js";
-import { isPlainObject, ReadonlyRecord } from "../Object.js";
+import { createRecord, isPlainObject, ReadonlyRecord } from "../Object.js";
 import { orderUint8Array } from "../Order.js";
 import { SqliteValue } from "../Sqlite.js";
 import { createId, String } from "../Type.js";
@@ -136,7 +136,7 @@ const parse = (obj: unknown): unknown => {
 const parseObject = (
   obj: ReadonlyRecord<string, unknown>,
 ): ReadonlyRecord<string, unknown> => {
-  const result = Object.create(null) as Record<string, unknown>;
+  const result = createRecord();
   for (const key in obj) {
     result[key] = parse(obj[key]);
   }

package/src/local-first/Evolu.ts

@@ -4,7 +4,7 @@ import {
   isNonEmptyArray,
   isNonEmptyReadonlyArray,
 } from "../Array.js";
-import { assertNonEmptyReadonlyArray } from "../Assert.js";
+import { assert, assertNonEmptyReadonlyArray } from "../Assert.js";
 import { createCallbacks } from "../Callbacks.js";
 import { ConsoleDep } from "../Console.js";
 import { RandomBytesDep, SymmetricCryptoDecryptError } from "../Crypto.js";
@@ -17,6 +17,7 @@ import {
   isSqlMutation,
   SafeSql,
   SqliteBoolean,
+  sqliteBooleanToBoolean,
   SqliteError,
   SqliteQuery,
 } from "../Sqlite.js";
@@ -423,32 +424,36 @@ export interface Evolu<S extends EvoluSchema = EvoluSchema> extends Disposable {
   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.
+   * Use a {@link SyncOwner}. Returns a {@link UnuseOwner}.
    *
-   * Transport connections are automatically deduplicated and reference-counted,
-   * so multiple owners using the same transport will share a single
-   * connection.
+   * Using an owner means syncing it with its transports, or the transports
+   * defined in Evolu config if the owner has no transports defined.
+   *
+   * Transport are automatically deduplicated and reference-counted, so multiple
+   * owners using the same transport will share a single connection.
    *
    * ### Example
    *
    * ```ts
-   * // Use an owner (starts syncing and subscribing to changes).
-   * const unuse = evolu.useOwner(shardOwner);
+   * // Use an owner (starts syncing).
+   * const unuseOwner = evolu.useOwner(shardOwner);
    *
    * // Later, stop using the owner.
-   * unuse();
+   * unuseOwner();
    *
    * // Bulk operations.
-   * const unuses = owners.map((owner) => evolu.useOwner(owner));
-   * // Later: unuses.forEach(unuse => unuse());
+   * const unuseOwners = owners.map((owner) => evolu.useOwner(owner));
+   * // Later: for (const unuse of unuseOwners) unuse();
    * ```
    *
    * @experimental
    */
-  readonly useOwner: (owner: SyncOwner) => () => void;
+  readonly useOwner: (owner: SyncOwner) => UnuseOwner;
 }
 
+/** Function returned by {@link Evolu#useOwner} to stop using an {@link SyncOwner}. */
+export type UnuseOwner = () => void;
+
 /** Represents errors that can occur in Evolu. */
 export type EvoluError =
   | ProtocolError
@@ -726,13 +731,20 @@ const createEvoluInstance =
           } else {
             const { id: _, isDeleted, ...values } = result.value;
 
-            const dbChange = DbChange.orThrow({
+            const dbChange = {
               table,
               id,
               values,
               isInsert: kind === "insert" || kind === "upsert",
-              isDelete: SqliteBoolean.is(isDeleted) ? Boolean(isDeleted) : null,
-            });
+              isDelete: SqliteBoolean.is(isDeleted)
+                ? sqliteBooleanToBoolean(isDeleted)
+                : null,
+            };
+
+            assert(
+              DbChange.is(dbChange),
+              `Invalid DbChange for table '${table}': Please check schema type errors.`,
+            );
 
             mutateMicrotaskQueue.push([
               { ...dbChange, ownerId: options?.ownerId },

package/src/local-first/Owner.ts

@@ -22,15 +22,23 @@ import type { EncryptedDbChange, Storage } from "./Storage.js";
 import { TimestampBytes } from "./Timestamp.js";
 
 /**
- * The Owner represents ownership of data in Evolu. Every database change is
- * assigned to an owner, enabling sync functionality and access control.
+ * {@link Owner} without a {@link OwnerWriteKey}.
  *
- * Owners enable **partial sync** - applications can choose which owners to
- * sync, allowing selective data synchronization based on specific needs.
+ * @see {@link createSharedReadonlyOwner}
+ */
+export interface ReadonlyOwner {
+  readonly id: OwnerId;
+  readonly encryptionKey: OwnerEncryptionKey;
+}
+
+/**
+ * The Owner represents ownership of data in Evolu. Every database change is
+ * assigned to an owner and encrypted with its {@link OwnerEncryptionKey}. Owners
+ * allow partial sync, only the {@link AppOwner} is synced by default.
  *
- * Owners also provide **real data deletion** - while individual changes in
- * local-first/distributed systems can only be marked as deleted, entire owners
- * can be completely deleted from both relays and devices (except for
+ * Owners can also provide real data deletion, while individual changes in
+ * local-first/distributed systems can only be soft deleted, entire owners can
+ * be completely deleted from both relays and devices (except for
  * {@link AppOwner}, which must be preserved for sync coordination).
  *
  * Evolu provides different owner types depending on their use case:
@@ -46,21 +54,19 @@ import { TimestampBytes } from "./Timestamp.js";
  * SLIP-21, ensuring secure and deterministic key generation:
  *
  * - {@link OwnerId}: Globally unique public identifier
- * - {@link EncryptionKey}: Symmetric encryption key for data protection
+ * - {@link OwnerEncryptionKey}: Symmetric encryption key for data protection
  * - {@link OwnerWriteKey}: Authentication token for write operations (rotatable)
  *
- * @see {@link createOwner}
+ * @see {@link createAppOwner}
+ * @see {@link createShardOwner}
+ * @see {@link createSharedOwner}
+ * @see {@link createSharedReadonlyOwner}
  */
-export interface Owner {
-  readonly id: OwnerId;
-  readonly encryptionKey: OwnerEncryptionKey;
+export interface Owner extends ReadonlyOwner {
   readonly writeKey: OwnerWriteKey;
 }
 
-/**
- * OwnerId is a branded {@link Id} that uniquely identifies an {@link Owner}.
- * Branded from {@link Id} to leverage existing helpers like {@link idToIdBytes}.
- */
+/** OwnerId is a branded {@link Id} that uniquely identifies an {@link Owner}. */
 export const OwnerId = brand("OwnerId", Id);
 export type OwnerId = typeof OwnerId.Type;
 
@@ -68,14 +74,17 @@ export type OwnerId = typeof OwnerId.Type;
 export const OwnerIdBytes = brand("OwnerIdBytes", IdBytes);
 export type OwnerIdBytes = typeof OwnerIdBytes.Type;
 
+/** Converts {@link OwnerId} to {@link OwnerIdBytes}. */
 export const ownerIdToOwnerIdBytes = (ownerId: OwnerId): OwnerIdBytes =>
   idToIdBytes(ownerId) as OwnerIdBytes;
 
+/** Converts {@link OwnerIdBytes} to {@link OwnerId}. */
 export const ownerIdBytesToOwnerId = (ownerIdBytes: OwnerIdBytes): OwnerId =>
   idBytesToId(ownerIdBytes as IdBytes) as OwnerId;
 
 export const ownerWriteKeyLength = NonNegativeInt.orThrow(16);
 
+/** Symmetric encryption key for {@link Owner} data protection. */
 export const OwnerEncryptionKey = brand("OwnerEncryptionKey", EncryptionKey);
 export type OwnerEncryptionKey = typeof OwnerEncryptionKey.Type;
 
@@ -86,6 +95,16 @@ export type OwnerEncryptionKey = typeof OwnerEncryptionKey.Type;
 export const OwnerWriteKey = brand("OwnerWriteKey", Entropy16);
 export type OwnerWriteKey = typeof OwnerWriteKey.Type;
 
+/**
+ * Creates a new random {@link OwnerWriteKey} for rotation.
+ *
+ * The initial OwnerWriteKey is deterministically derived from
+ * {@link OwnerSecret}. Use `createOwnerWriteKey` to rotate (replace) the write
+ * key without changing the owner identity.
+ */
+export const createOwnerWriteKey = (deps: RandomBytesDep): OwnerWriteKey =>
+  deps.randomBytes.create(16) as OwnerWriteKey;
+
 /**
  * 32 bytes of cryptographic entropy used to derive {@link Owner} keys.
  *
@@ -107,22 +126,11 @@ export const ownerSecretToMnemonic = (secret: OwnerSecret): Mnemonic =>
 export const mnemonicToOwnerSecret = (mnemonic: Mnemonic): OwnerSecret =>
   bip39.mnemonicToEntropy(mnemonic, wordlist) as OwnerSecret;
 
-/** Creates a randomly generated {@link OwnerWriteKey}. */
-export const createOwnerWriteKey = (deps: RandomBytesDep): OwnerWriteKey =>
-  deps.randomBytes.create(16) as OwnerWriteKey;
-
 /**
  * Creates an {@link Owner} from a {@link OwnerSecret} using SLIP-21 key
  * derivation.
- *
- * This is an internal helper function, use:
- *
- * - {@link createAppOwner}
- * - {@link createShardOwner}
- * - {@link createSharedOwner}
- * - {@link createSharedReadonlyOwner}
  */
-export const createOwner = (secret: OwnerSecret): Owner => ({
+const createOwner = (secret: OwnerSecret): Owner => ({
   id: ownerIdBytesToOwnerId(
     OwnerIdBytes.orThrow(
       createSlip21(secret, ["Evolu", "OwnerIdBytes"]).slice(0, 16),
@@ -182,9 +190,9 @@ export interface AppOwner extends Owner {
 
 /** Creates an {@link AppOwner} from an {@link OwnerSecret}. */
 export const createAppOwner = (secret: OwnerSecret): AppOwner => ({
+  ...createOwner(secret),
   type: "AppOwner",
   mnemonic: ownerSecretToMnemonic(secret),
-  ...createOwner(secret),
 });
 
 /**
@@ -200,18 +208,13 @@ export const createAppOwner = (secret: OwnerSecret): AppOwner => ({
  */
 export interface ShardOwner extends Owner {
   readonly type: "ShardOwner";
-  readonly transports?: ReadonlyArray<OwnerTransport>;
 }
 
 /** Creates a {@link ShardOwner} from an {@link OwnerSecret}. */
-export const createShardOwner = (
-  secret: OwnerSecret,
-  transports?: ReadonlyArray<OwnerTransport>,
-): ShardOwner => {
+export const createShardOwner = (secret: OwnerSecret): ShardOwner => {
   return {
-    type: "ShardOwner",
     ...createOwner(secret),
-    ...(transports && { transports }),
+    type: "ShardOwner",
   };
 };
 
@@ -236,21 +239,18 @@ export const createShardOwner = (
 export const deriveShardOwner = (
   owner: AppOwner,
   path: NonEmptyReadonlyArray<string | number>,
-  transports?: ReadonlyArray<OwnerTransport>,
 ): ShardOwner => {
   const secret = createSlip21(owner.encryptionKey, path) as OwnerSecret;
 
   return {
-    type: "ShardOwner",
     ...createOwner(secret),
-    ...(transports && { transports }),
+    type: "ShardOwner",
   };
 };
 
 /** An {@link Owner} for collaborative data with write access. */
 export interface SharedOwner extends Owner {
   readonly type: "SharedOwner";
-  readonly transports?: ReadonlyArray<OwnerTransport>;
 }
 
 /**
@@ -260,27 +260,18 @@ export interface SharedOwner extends Owner {
  * Use {@link createSharedReadonlyOwner} to create a read-only version for
  * sharing.
  */
-export const createSharedOwner = (
-  secret: OwnerSecret,
-  transports?: ReadonlyArray<OwnerTransport>,
-): SharedOwner => {
-  return {
-    type: "SharedOwner",
-    ...createOwner(secret),
-    ...(transports && { transports }),
-  };
-};
+export const createSharedOwner = (secret: OwnerSecret): SharedOwner => ({
+  ...createOwner(secret),
+  type: "SharedOwner",
+});
 
 /**
  * Read-only version of a {@link SharedOwner} for data sharing. Contains only the
  * {@link OwnerId} and {@link EncryptionKey} needed for others to read the shared
  * data without write access.
  */
-export interface SharedReadonlyOwner {
+export interface SharedReadonlyOwner extends ReadonlyOwner {
   readonly type: "SharedReadonlyOwner";
-  readonly id: OwnerId;
-  readonly encryptionKey: EncryptionKey;
-  readonly transports?: ReadonlyArray<OwnerTransport>;
 }
 
 /** Creates a {@link SharedReadonlyOwner} from a {@link SharedOwner}. */
@@ -290,7 +281,6 @@ export const createSharedReadonlyOwner = (
   type: "SharedReadonlyOwner",
   id: sharedOwner.id,
   encryptionKey: sharedOwner.encryptionKey,
-  ...(sharedOwner.transports && { transports: sharedOwner.transports }),
 });
 
 /**
@@ -383,8 +373,8 @@ export const parseOwnerIdFromOwnerWebSocketTransportUrl = (
   url: string,
 ): OwnerId | null => getOrNull(OwnerId.fromUnknown(url.split("=")[1]));
 
-/** Base interface for all owner errors. */
-export interface BaseOwnerError {
+/** Common interface implemented by all owner domain errors. */
+export interface OwnerError {
   readonly ownerId: OwnerId;
 }
 

package/src/local-first/Protocol.ts

@@ -198,7 +198,7 @@ import {
 } from "../Crypto.js";
 import { eqArrayNumber } from "../Eq.js";
 import { computeBalancedBuckets } from "../Number.js";
-import { objectToEntries } from "../Object.js";
+import { createRecord, objectToEntries } from "../Object.js";
 import { err, ok, Result } from "../Result.js";
 import { SqliteValue } from "../Sqlite.js";
 import {
@@ -221,8 +221,8 @@ import {
 } from "../Type.js";
 import { Predicate } from "../Types.js";
 import {
-  BaseOwnerError,
   Owner,
+  OwnerError,
   OwnerId,
   OwnerIdBytes,
   ownerIdToOwnerIdBytes,
@@ -382,7 +382,7 @@ export type ProtocolError =
  * Represents a version mismatch in the Evolu Protocol. Occurs when the
  * initiator and non-initiator are using incompatible protocol versions.
  */
-export interface ProtocolVersionError extends BaseOwnerError {
+export interface ProtocolVersionError extends OwnerError {
   readonly type: "ProtocolVersionError";
   readonly version: NonNegativeInt;
   /** Indicates which side is obsolete and should update. */
@@ -397,7 +397,7 @@ export interface ProtocolInvalidDataError {
 }
 
 /** Error when a {@link OwnerWriteKey} is invalid, missing, or fails validation. */
-export interface ProtocolWriteKeyError extends BaseOwnerError {
+export interface ProtocolWriteKeyError extends OwnerError {
   readonly type: "ProtocolWriteKeyError";
 }
 
@@ -405,7 +405,7 @@ export interface ProtocolWriteKeyError extends BaseOwnerError {
  * Error indicating a serious relay-side write failure. Clients should log this
  * error and show a generic sync error to the user.
  */
-export interface ProtocolWriteError extends BaseOwnerError {
+export interface ProtocolWriteError extends OwnerError {
   readonly type: "ProtocolWriteError";
 }
 
@@ -422,7 +422,7 @@ export interface ProtocolWriteError extends BaseOwnerError {
  * plan. Quota monitoring and management is the relay provider's
  * responsibility.
  */
-export interface ProtocolQuotaError extends BaseOwnerError {
+export interface ProtocolQuotaError extends OwnerError {
   readonly type: "ProtocolQuotaError";
 }
 
@@ -430,7 +430,7 @@ export interface ProtocolQuotaError extends BaseOwnerError {
  * Error indicating a serious relay-side synchronization failure. Clients should
  * log this error and show a generic sync error to the user.
  */
-export interface ProtocolSyncError extends BaseOwnerError {
+export interface ProtocolSyncError extends OwnerError {
   readonly type: "ProtocolSyncError";
 }
 
@@ -1816,7 +1816,7 @@ export const decryptAndDecodeDbChange =
       const id = decodeId(buffer);
 
       const length = decodeLength(buffer);
-      const values = Object.create(null) as Record<string, SqliteValue>;
+      const values = createRecord<string, SqliteValue>();
 
       for (let i = 0; i < length; i++) {
         const column = decodeString(buffer);

package/src/local-first/Public.ts

@@ -6,6 +6,7 @@
 
 export { createEvolu } from "./Evolu.js";
 export type { Evolu, EvoluConfig, EvoluDeps, EvoluError } from "./Evolu.js";
+export type { UnuseOwner } from "./Evolu.js";
 export * from "./LocalAuth.js";
 export * from "./Owner.js";
 export * as kysely from "./PublicKysely.js";

package/src/local-first/Storage.ts

@@ -26,7 +26,7 @@ import {
   TypeError,
 } from "../Type.js";
 import {
-  BaseOwnerError,
+  OwnerError,
   Owner,
   OwnerId,
   OwnerIdBytes,
@@ -172,12 +172,12 @@ export interface StorageDep {
 }
 
 /** Error indicating a serious write failure. */
-export interface StorageWriteError extends BaseOwnerError {
+export interface StorageWriteError extends OwnerError {
   readonly type: "StorageWriteError";
 }
 
 /** Error when storage or billing quota is exceeded. */
-export interface StorageQuotaError extends BaseOwnerError {
+export interface StorageQuotaError extends OwnerError {
   readonly type: "StorageQuotaError";
 }