@evolu/common 7.2.1 → 7.2.2

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

@@ -19,7 +19,7 @@ export const createSync = (deps) => (config) => {
     const getSyncOwner = (ownerId) => {
         if (isDisposed)
             return null;
-        return transports.getConsumer(ownerId);
+        return resources.getConsumer(ownerId);
     };
     const storageResult = createClientStorage({
         ...deps,
@@ -28,21 +28,21 @@ export const createSync = (deps) => (config) => {
     if (!storageResult.ok)
         return storageResult;
     const storage = storageResult.value;
-    const createResource = (transportConfig) => {
-        const transportKey = createTransportKey(transportConfig);
+    const createResource = (transport) => {
+        const transportKey = createTransportKey(transport);
         deps.console.log("[sync]", "createWebSocket", {
             transportKey,
-            url: transportConfig.url,
+            url: transport.url,
         });
-        return deps.createWebSocket(transportConfig.url, {
+        return deps.createWebSocket(transport.url, {
             binaryType: "arraybuffer",
             onOpen: () => {
                 if (isDisposed)
                     return;
-                const webSocket = transports.getResource(transportKey);
+                const webSocket = resources.getResource(transportKey);
                 if (!webSocket)
                     return;
-                const ownerIds = transports.getConsumersForResource(transportKey);
+                const ownerIds = resources.getConsumersForResource(transportKey);
                 deps.console.log("[sync]", "onOpen", { transportKey, ownerIds });
                 for (const ownerId of ownerIds) {
                     const message = createProtocolMessageForSync({ storage })(ownerId, SubscriptionFlags.Subscribe);
@@ -67,7 +67,7 @@ export const createSync = (deps) => (config) => {
                 // Only handle ArrayBuffer data for sync messages
                 if (isDisposed || !(data instanceof ArrayBuffer))
                     return;
-                const webSocket = transports.getResource(transportKey);
+                const webSocket = resources.getResource(transportKey);
                 if (!webSocket)
                     return;
                 const input = new Uint8Array(data);
@@ -102,7 +102,7 @@ export const createSync = (deps) => (config) => {
             },
         });
     };
-    const transports = createResources({
+    const resources = createResources({
         createResource,
         getResourceKey: createTransportKey,
         getConsumerId: (owner) => owner.id,
@@ -135,15 +135,15 @@ export const createSync = (deps) => (config) => {
                 return;
             }
             deps.console.log("[sync]", "useOwner", { use, owner });
-            const transportsToUse = owner.transports ?? config.transports;
+            const transports = owner.transports ?? config.transports;
             if (use) {
-                transports.addConsumer(owner, transportsToUse);
+                resources.addConsumer(owner, transports);
             }
             else {
-                const result = transports.removeConsumer(owner, transportsToUse);
+                const result = resources.removeConsumer(owner, transports);
                 if (!result.ok) {
                     deps.console.warn("[sync]", "Failed to remove consumer", {
-                        transportsToUse,
+                        transports,
                         ownerId: owner.id,
                         error: result.error,
                     });
@@ -182,11 +182,11 @@ export const createSync = (deps) => (config) => {
                     encryptionKey: owner.encryptionKey,
                     writeKey: owner.writeKey,
                 }, messages);
-                const transportsToUse = owner.transports ?? config.transports;
+                const transports = owner.transports ?? config.transports;
                 // Send message to all transports for this owner
-                for (const transportConfig of transportsToUse) {
-                    const transportKey = createTransportKey(transportConfig);
-                    const webSocket = transports.getResource(transportKey);
+                for (const transport of transports) {
+                    const transportKey = createTransportKey(transport);
+                    const webSocket = resources.getResource(transportKey);
                     if (!webSocket)
                         continue;
                     if (webSocket.isOpen()) {
@@ -201,7 +201,7 @@ export const createSync = (deps) => (config) => {
             if (isDisposed)
                 return;
             isDisposed = true;
-            transports[Symbol.dispose]();
+            resources[Symbol.dispose]();
         },
     };
     return ok(sync);
@@ -341,9 +341,9 @@ const createClientStorage = (deps) => (config) => {
     };
     return ok(storage);
 };
-/** Creates a unique identifier for a transport configuration. */
-const createTransportKey = (transportConfig) => {
-    return `${transportConfig.type}:${transportConfig.url}`;
+/** Creates a unique identifier for a {@link OwnerTransport}. */
+const createTransportKey = (transport) => {
+    return `${transport.type}:${transport.url}`;
 };
 export const applyLocalOnlyChange = (deps) => (change) => {
     if (change.isDelete) {

package/package.json

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

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/Evolu.ts

@@ -423,32 +423,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

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

@@ -221,7 +221,7 @@ import {
 } from "../Type.js";
 import { Predicate } from "../Types.js";
 import {
-  BaseOwnerError,
+  OwnerError,
   Owner,
   OwnerId,
   OwnerIdBytes,
@@ -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";
 }
 

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";
 }
 

package/src/local-first/Sync.ts

@@ -42,16 +42,13 @@ import { CreateWebSocketDep, WebSocket } from "../WebSocket.js";
 import type { AppOwnerDep, PostMessageDep } from "./Db.js";
 import {
   AppOwner,
-  OwnerEncryptionKey,
+  Owner,
   OwnerId,
   OwnerIdBytes,
   ownerIdBytesToOwnerId,
   ownerIdToOwnerIdBytes,
   OwnerTransport,
-  OwnerWriteKey,
-  ShardOwner,
-  SharedOwner,
-  SharedReadonlyOwner,
+  ReadonlyOwner,
 } from "./Owner.js";
 import {
   applyProtocolMessageAsClient,
@@ -97,9 +94,9 @@ export interface Sync extends Disposable {
   /**
    * Assigns or removes an owner to/from transports with reference counting.
    *
-   * Owners are only "active" if assigned to at least one transport. Uses
-   * `owner.transports` or falls back to config transports. Multiple calls
-   * increment/decrement reference counts (useful for React Hooks).
+   * Owners are only synced if assigned to at least one transport. Uses
+   * `owner.transports` or falls back to {@link SyncConfig} transports. Multiple
+   * calls increment/decrement reference counts (useful for React Hooks).
    */
   readonly useOwner: (use: boolean, owner: SyncOwner) => void;
 
@@ -119,18 +116,13 @@ export interface SyncDep {
 }
 
 /**
- * Represents an owner for sync operations. This is a unified interface that
- * abstracts over the specific owner types ({@link ShardOwner},
- * {@link SharedOwner}, {@link SharedReadonlyOwner}) for the sync layer.
+ * Represents an owner for sync operations.
  *
- * The sync layer only needs the essential data for synchronization and doesn't
- * need to distinguish between different owner types.
+ * Includes readonly owner fields plus optional write key (for clients that
+ * write) and optional transports to override SyncConfig transports per owner.
  */
-export interface SyncOwner {
-  readonly id: OwnerId;
-  readonly encryptionKey: OwnerEncryptionKey;
-  /** Optional for read-only owners like {@link SharedReadonlyOwner}. */
-  readonly writeKey?: OwnerWriteKey;
+export interface SyncOwner extends ReadonlyOwner {
+  readonly writeKey?: Owner["writeKey"];
   readonly transports?: ReadonlyArray<OwnerTransport>;
 }
 
@@ -180,7 +172,7 @@ export const createSync =
     /** Returns owner data only if actively assigned to at least one transport. */
     const getSyncOwner = (ownerId: OwnerId): SyncOwner | null => {
       if (isDisposed) return null;
-      return transports.getConsumer(ownerId);
+      return resources.getConsumer(ownerId);
     };
 
     const storageResult = createClientStorage({
@@ -191,24 +183,24 @@ export const createSync =
     if (!storageResult.ok) return storageResult;
     const storage = storageResult.value;
 
-    const createResource = (transportConfig: OwnerTransport): WebSocket => {
-      const transportKey = createTransportKey(transportConfig);
+    const createResource = (transport: OwnerTransport): WebSocket => {
+      const transportKey = createTransportKey(transport);
 
       deps.console.log("[sync]", "createWebSocket", {
         transportKey,
-        url: transportConfig.url,
+        url: transport.url,
       });
 
-      return deps.createWebSocket(transportConfig.url, {
+      return deps.createWebSocket(transport.url, {
         binaryType: "arraybuffer",
 
         onOpen: () => {
           if (isDisposed) return;
 
-          const webSocket = transports.getResource(transportKey);
+          const webSocket = resources.getResource(transportKey);
           if (!webSocket) return;
 
-          const ownerIds = transports.getConsumersForResource(transportKey);
+          const ownerIds = resources.getConsumersForResource(transportKey);
           deps.console.log("[sync]", "onOpen", { transportKey, ownerIds });
 
           for (const ownerId of ownerIds) {
@@ -239,7 +231,7 @@ export const createSync =
           // Only handle ArrayBuffer data for sync messages
           if (isDisposed || !(data instanceof ArrayBuffer)) return;
 
-          const webSocket = transports.getResource(transportKey);
+          const webSocket = resources.getResource(transportKey);
           if (!webSocket) return;
 
           const input = new Uint8Array(data);
@@ -277,7 +269,7 @@ export const createSync =
       });
     };
 
-    const transports = createResources<
+    const resources = createResources<
       WebSocket,
       TransportKey,
       OwnerTransport,
@@ -327,16 +319,16 @@ export const createSync =
         }
 
         deps.console.log("[sync]", "useOwner", { use, owner });
-        const transportsToUse = owner.transports ?? config.transports;
+        const transports = owner.transports ?? config.transports;
 
         if (use) {
-          transports.addConsumer(owner, transportsToUse);
+          resources.addConsumer(owner, transports);
         } else {
-          const result = transports.removeConsumer(owner, transportsToUse);
+          const result = resources.removeConsumer(owner, transports);
 
           if (!result.ok) {
             deps.console.warn("[sync]", "Failed to remove consumer", {
-              transportsToUse,
+              transports,
               ownerId: owner.id,
               error: result.error,
             });
@@ -382,13 +374,13 @@ export const createSync =
             messages,
           );
 
-          const transportsToUse = owner.transports ?? config.transports;
+          const transports = owner.transports ?? config.transports;
 
           // Send message to all transports for this owner
-          for (const transportConfig of transportsToUse) {
-            const transportKey = createTransportKey(transportConfig);
+          for (const transport of transports) {
+            const transportKey = createTransportKey(transport);
 
-            const webSocket = transports.getResource(transportKey);
+            const webSocket = resources.getResource(transportKey);
             if (!webSocket) continue;
 
             if (webSocket.isOpen()) {
@@ -404,7 +396,7 @@ export const createSync =
       [Symbol.dispose]: () => {
         if (isDisposed) return;
         isDisposed = true;
-        transports[Symbol.dispose]();
+        resources[Symbol.dispose]();
       },
     };
 
@@ -646,9 +638,9 @@ const createClientStorage =
 
 type TransportKey = string & Brand<"TransportKey">;
 
-/** Creates a unique identifier for a transport configuration. */
-const createTransportKey = (transportConfig: OwnerTransport): TransportKey => {
-  return `${transportConfig.type}:${transportConfig.url}` as TransportKey;
+/** Creates a unique identifier for a {@link OwnerTransport}. */
+const createTransportKey = (transport: OwnerTransport): TransportKey => {
+  return `${transport.type}:${transport.url}` as TransportKey;
 };
 
 export const applyLocalOnlyChange =