@evolu/common 7.2.0 → 7.2.2

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

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

package/dist/src/{Evolu → local-first}/Sync.d.ts

@@ -9,7 +9,7 @@ import { TimeDep } from "../Time.js";
 import { DateIso } from "../Type.js";
 import { CreateWebSocketDep } from "../WebSocket.js";
 import type { AppOwnerDep, PostMessageDep } from "./Db.js";
-import { AppOwner, OwnerEncryptionKey, OwnerId, OwnerIdBytes, OwnerTransport, OwnerWriteKey } from "./Owner.js";
+import { AppOwner, Owner, OwnerIdBytes, OwnerTransport, ReadonlyOwner } from "./Owner.js";
 import { ProtocolError, ProtocolInvalidDataError, ProtocolTimestampMismatchError } from "./Protocol.js";
 import { MutationChange } from "./Schema.js";
 import { BaseSqliteStorage, CrdtMessage, Storage, StorageInsertTimestampStrategy } from "./Storage.js";
@@ -18,9 +18,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;
     readonly applyChanges: (changes: NonEmptyReadonlyArray<MutationChange>) => Result<void, SqliteError | TimestampCounterOverflowError | TimestampDriftError | TimestampTimeOutOfRangeError>;
@@ -29,18 +29,13 @@ export interface SyncDep {
     readonly sync: Sync;
 }
 /**
- * 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>;
 }
 export interface SyncConfig {

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

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

package/dist/src/{Evolu → 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/dist/src/local-first/Timestamp.d.ts.map

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

package/dist/src/{Evolu/Internal.js → local-first/index.d.ts}

@@ -1,11 +1,5 @@
 /**
- * Internal Evolu
- *
- * ### Example
- *
- * ```ts
- * import { createTimestamp } from "@evolu/common/evolu";
- * ```
+ * Local-first code to be imported from "@evolu/common/local-first"
  *
  * @module
  */
@@ -21,3 +15,4 @@ export * from "./Schema.js";
 export * from "./Storage.js";
 export * from "./Sync.js";
 export * from "./Timestamp.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/local-first/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC"}

package/dist/src/{Evolu/Internal.d.ts → local-first/index.js}

@@ -1,11 +1,5 @@
 /**
- * Internal Evolu
- *
- * ### Example
- *
- * ```ts
- * import { createTimestamp } from "@evolu/common/evolu";
- * ```
+ * Local-first code to be imported from "@evolu/common/local-first"
  *
  * @module
  */
@@ -21,4 +15,3 @@ export * from "./Schema.js";
 export * from "./Storage.js";
 export * from "./Sync.js";
 export * from "./Timestamp.js";
-//# sourceMappingURL=Internal.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@evolu/common",
-  "version": "7.2.0",
+  "version": "7.2.2",
   "description": "TypeScript library and local-first platform",
   "keywords": [
     "evolu",
@@ -25,14 +25,15 @@
       "browser": "./dist/src/index.js",
       "react-native": "./dist/src/index.js"
     },
-    "./evolu": {
-      "import": "./dist/src/Evolu/Internal.js"
+    "./local-first": {
+      "types": "./dist/src/local-first/index.d.ts",
+      "import": "./dist/src/local-first/index.js"
     }
   },
   "typesVersions": {
     "*": {
-      "evolu": [
-        "./dist/src/Evolu/Internal.d.ts"
+      "local-first": [
+        "./dist/src/local-first/index.d.ts"
       ]
     }
   },

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

@@ -9,10 +9,10 @@ export * from "./Console.js";
 export * from "./Crypto.js";
 export * from "./Eq.js";
 export * from "./Error.js";
-export * from "./Evolu/Public.js";
 export * from "./Function.js";
 export * from "./Identicon.js";
 export * from "./Instances.js";
+export * from "./local-first/Public.js";
 export * from "./Number.js";
 export * from "./Object.js";
 export * from "./Order.js";

package/src/{Evolu → 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/{Evolu → 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/{Evolu → 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/{Evolu → local-first}/Public.ts

@@ -1,13 +1,14 @@
 /**
- * Public Evolu
+ * Local-first code to be imported from "@evolu/common"
  *
  * @module
  */
 
 export { createEvolu } from "./Evolu.js";
 export type { Evolu, EvoluConfig, EvoluDeps, EvoluError } from "./Evolu.js";
-export * from "./Owner.js";
+export type { UnuseOwner } from "./Evolu.js";
 export * from "./LocalAuth.js";
+export * from "./Owner.js";
 export * as kysely from "./PublicKysely.js";
 export type { InferRow, Query, QueryRows, Row } from "./Query.js";
 export type { EvoluSchema } from "./Schema.js";

package/src/{Evolu → 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";
 }