@evolu/common 8.10.0 → 8.11.0

package/dist/src/Worker.d.ts

@@ -8,6 +8,7 @@ import type { ConsoleDep, ConsoleStoreOutputEntryDep } from "./Console.ts";
 /**
  * Typed, disposable Worker.
  *
+ * @group Core
  * @see https://developer.mozilla.org/en-US/docs/Web/API/Worker
  */
 export interface Worker<Input, Output = never> extends MessagePort<Input, Output> {
@@ -18,6 +19,7 @@ export interface Worker<Input, Output = never> extends MessagePort<Input, Output
  * A shared worker is shared across multiple clients (tabs, windows, iframes)
  * and provides a port for bidirectional communication with each client.
  *
+ * @group Core
  * @see https://developer.mozilla.org/en-US/docs/Web/API/SharedWorker
  */
 export interface SharedWorker<Input, Output = never> extends Disposable {
@@ -33,6 +35,7 @@ export interface SharedWorker<Input, Output = never> extends Disposable {
  * end periodically sends "alive" messages and stale ports are pruned after a
  * timeout.
  *
+ * @group Core
  * @see https://developer.mozilla.org/en-US/docs/Web/API/MessagePort
  */
 export interface MessagePort<Input, Output = never> extends Disposable {
@@ -78,6 +81,8 @@ export interface MessagePort<Input, Output = never> extends Disposable {
  * Intentionally scoped to types Evolu uses. The web platform defines additional
  * transferable types (`ImageBitmap`, `OffscreenCanvas`, `ReadableStream`, etc.)
  * that can be added here if needed.
+ *
+ * @group Core
  */
 export type Transferable = NativeMessagePort<any, any> | ArrayBuffer;
 /**
@@ -86,6 +91,8 @@ export type Transferable = NativeMessagePort<any, any> | ArrayBuffer;
  * Exists because `postMessage` transfer requires the native object itself, not
  * a wrapper. Ensures type-safe wiring between {@link MessagePort.native} and
  * {@link CreateMessagePort} without exposing platform details.
+ *
+ * @group Core
  */
 export type NativeMessagePort<Input = unknown, Output = never> = Brand<"NativeMessagePort"> & {
     readonly [nativeMessagePortInput]?: Input;
@@ -93,12 +100,25 @@ export type NativeMessagePort<Input = unknown, Output = never> = Brand<"NativeMe
 };
 declare const nativeMessagePortInput: unique symbol;
 declare const nativeMessagePortOutput: unique symbol;
-/** Factory function to create a {@link MessagePort} from a native port. */
+/**
+ * Factory function to create a {@link MessagePort} from a native port.
+ *
+ * @group Construction
+ */
 export type CreateMessagePort = <Input, Output = never>(nativePort: NativeMessagePort<Input, Output>) => MessagePort<Input, Output>;
+/**
+ * Dependency wrapper for {@link CreateMessagePort}.
+ *
+ * @group Construction
+ */
 export interface CreateMessagePortDep {
     readonly createMessagePort: CreateMessagePort;
 }
-/** Common dependencies for worker entry points. */
+/**
+ * Common dependencies for worker entry points.
+ *
+ * @group Core
+ */
 export type WorkerDeps = ConsoleDep & ConsoleStoreOutputEntryDep & CreateMessagePortDep;
 /**
  * Typed, disposable MessageChannel.
@@ -194,6 +214,7 @@ export type WorkerDeps = ConsoleDep & ConsoleStoreOutputEntryDep & CreateMessage
  * ]);
  * ```
  *
+ * @group Core
  * @see https://developer.mozilla.org/en-US/docs/Web/API/MessageChannel
  */
 export interface MessageChannel<Input, Output = never> extends Disposable {
@@ -202,8 +223,17 @@ export interface MessageChannel<Input, Output = never> extends Disposable {
     /** The second port of the channel. */
     readonly port2: MessagePort<Output, Input>;
 }
-/** Factory function to create a {@link MessageChannel}. */
+/**
+ * Factory function to create a {@link MessageChannel}.
+ *
+ * @group Construction
+ */
 export type CreateMessageChannel = <Input, Output = never>() => MessageChannel<Input, Output>;
+/**
+ * Dependency wrapper for {@link CreateMessageChannel}.
+ *
+ * @group Construction
+ */
 export interface CreateMessageChannelDep {
     readonly createMessageChannel: CreateMessageChannel;
 }
@@ -213,6 +243,7 @@ export interface CreateMessageChannelDep {
  * Broadcast channels deliver messages to other channels opened with the same
  * name. The sending channel does not receive its own messages.
  *
+ * @group Core
  * @see https://developer.mozilla.org/en-US/docs/Web/API/BroadcastChannel
  */
 export interface BroadcastChannel<Input, Output = Input> extends Disposable {
@@ -221,8 +252,17 @@ export interface BroadcastChannel<Input, Output = Input> extends Disposable {
     /** Handler for incoming broadcast messages. */
     onMessage: ((message: Output) => void) | null;
 }
-/** Factory function to create a {@link BroadcastChannel}. */
+/**
+ * Factory function to create a {@link BroadcastChannel}.
+ *
+ * @group Construction
+ */
 export type CreateBroadcastChannel = <Input, Output = Input>(name: string) => BroadcastChannel<Input, Output>;
+/**
+ * Dependency wrapper for {@link CreateBroadcastChannel}.
+ *
+ * @group Construction
+ */
 export interface CreateBroadcastChannelDep {
     readonly createBroadcastChannel: CreateBroadcastChannel;
 }
@@ -231,6 +271,8 @@ export interface CreateBroadcastChannelDep {
  *
  * This is the worker-side counterpart to {@link Worker} — a typed
  * {@link MessagePort} that wraps `self` inside the worker.
+ *
+ * @group Core
  */
 export interface WorkerSelf<Input, Output = never> extends MessagePort<Output, Input> {
 }
@@ -239,6 +281,8 @@ export interface WorkerSelf<Input, Output = never> extends MessagePort<Output, I
  *
  * This is the worker-side counterpart to {@link SharedWorker}. It wraps `self`
  * inside the shared worker, providing typed `onConnect` callbacks.
+ *
+ * @group Core
  */
 export interface SharedWorkerSelf<Input, Output = never> extends Disposable {
     onConnect: ((port: MessagePort<Output, Input>) => void) | null;
@@ -248,6 +292,8 @@ export interface SharedWorkerSelf<Input, Output = never> extends Disposable {
  *
  * This is a memory-only fallback for platforms without native worker support.
  * Message delivery is asynchronous in-process.
+ *
+ * @group Construction
  */
 export declare const createWorker: <Input, Output = never>(initWorker: (self: WorkerSelf<Input, Output>) => void) => Worker<Input, Output>;
 /**
@@ -258,6 +304,8 @@ export declare const createWorker: <Input, Output = never>(initWorker: (self: Wo
  * in-process.
  *
  * Intended usage is one shared worker instance per process/app runtime.
+ *
+ * @group Construction
  */
 export declare const createSharedWorker: <Input, Output = never>(initWorker: (self: SharedWorkerSelf<Input, Output>) => void) => SharedWorker<Input, Output>;
 /**
@@ -265,6 +313,8 @@ export declare const createSharedWorker: <Input, Output = never>(initWorker: (se
  *
  * This is a memory-only fallback for platforms without native MessageChannel
  * support. Message delivery is asynchronous in-process.
+ *
+ * @group Construction
  */
 export declare const createMessageChannel: CreateMessageChannel;
 /**
@@ -272,6 +322,8 @@ export declare const createMessageChannel: CreateMessageChannel;
  *
  * This is a memory-only fallback for platforms without native MessagePort
  * support. Message delivery through returned ports is asynchronous in-process.
+ *
+ * @group Construction
  */
 export declare const createMessagePort: CreateMessagePort;
 /**
@@ -279,12 +331,16 @@ export declare const createMessagePort: CreateMessagePort;
  *
  * This is a memory-only fallback for platforms without native BroadcastChannel
  * support. Message delivery is asynchronous in-process.
+ *
+ * @group Construction
  */
 export declare const createBroadcastChannel: CreateBroadcastChannel;
 /**
  * Test {@link Worker} with access to its paired worker-side `self`.
  *
  * Use `self` to simulate messages and behavior from inside the worker.
+ *
+ * @group Testing
  */
 export interface TestWorker<Input, Output = never> extends Worker<Input, Output> {
     /** Typed `self` counterpart for worker-side testing assertions. */
@@ -295,16 +351,26 @@ export interface TestWorker<Input, Output = never> extends Worker<Input, Output>
  *
  * Call `connect()` to simulate a client connection and trigger
  * `self.onConnect`.
+ *
+ * @group Testing
  */
 export interface TestSharedWorker<Input, Output = never> extends SharedWorker<Input, Output> {
     readonly self: SharedWorkerSelf<Input, Output>;
     readonly connect: () => void;
 }
-/** {@link MessageChannel} with disposal tracking for testing. */
+/**
+ * {@link MessageChannel} with disposal tracking for testing.
+ *
+ * @group Testing
+ */
 export interface TestMessageChannel<Input, Output = never> extends MessageChannel<Input, Output> {
     readonly isDisposed: () => boolean;
 }
-/** {@link BroadcastChannel} with disposal tracking for testing. */
+/**
+ * {@link BroadcastChannel} with disposal tracking for testing.
+ *
+ * @group Testing
+ */
 export interface TestBroadcastChannel<Input, Output = Input> extends BroadcastChannel<Input, Output> {
     readonly isDisposed: () => boolean;
 }
@@ -313,6 +379,8 @@ export interface TestBroadcastChannel<Input, Output = Input> extends BroadcastCh
  *
  * The returned worker includes its typed {@link TestWorker.self} counterpart, so
  * tests can exercise dedicated worker communication without a real thread.
+ *
+ * @group Testing
  */
 export declare const testCreateWorker: <Input, Output = never>() => TestWorker<Input, Output>;
 /**
@@ -320,6 +388,8 @@ export declare const testCreateWorker: <Input, Output = never>() => TestWorker<I
  *
  * The returned worker includes `self` and `connect` so tests can exercise the
  * full worker ↔ client pipeline without a real worker thread.
+ *
+ * @group Testing
  */
 export declare const testCreateSharedWorker: <Input, Output = never>() => TestSharedWorker<Input, Output>;
 /**
@@ -330,11 +400,21 @@ export declare const testCreateSharedWorker: <Input, Output = never>() => TestSh
  *
  * Both ports are registered in the native port registry so
  * {@link testCreateMessagePort} can look them up by their native token.
+ *
+ * @group Testing
  */
 export declare const testCreateMessageChannel: <Input, Output = never>() => TestMessageChannel<Input, Output>;
-/** Creates an in-memory {@link CreateMessagePort} for testing. */
+/**
+ * Creates an in-memory {@link CreateMessagePort} for testing.
+ *
+ * @group Testing
+ */
 export declare const testCreateMessagePort: CreateMessagePort;
-/** Creates an in-memory {@link BroadcastChannel} for testing. */
+/**
+ * Creates an in-memory {@link BroadcastChannel} for testing.
+ *
+ * @group Testing
+ */
 export declare const testCreateBroadcastChannel: <Input, Output = Input>(name: string) => TestBroadcastChannel<Input, Output>;
 /**
  * Waits until scheduled in-memory worker message delivery becomes idle.
@@ -342,6 +422,8 @@ export declare const testCreateBroadcastChannel: <Input, Output = Input>(name: s
  * This observes actual transport tasks instead of waiting for an arbitrary
  * duration. It also waits through message handlers that schedule more worker
  * tasks before the current microtask checkpoint completes.
+ *
+ * @group Testing
  */
 export declare const testWaitForWorkerMessage: () => Promise<void>;
 export {};

package/dist/src/Worker.d.ts.map

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

package/dist/src/Worker.js

@@ -62,6 +62,8 @@ import { disposable } from "./Function.js";
  *
  * This is a memory-only fallback for platforms without native worker support.
  * Message delivery is asynchronous in-process.
+ *
+ * @group Construction
  */
 export const createWorker = (initWorker) => {
     const { worker, self } = createMemoryWorkerPair();
@@ -76,6 +78,8 @@ export const createWorker = (initWorker) => {
  * in-process.
  *
  * Intended usage is one shared worker instance per process/app runtime.
+ *
+ * @group Construction
  */
 export const createSharedWorker = (initWorker) => {
     const { worker, self, connect } = createMemorySharedWorkerPair();
@@ -88,6 +92,8 @@ export const createSharedWorker = (initWorker) => {
  *
  * This is a memory-only fallback for platforms without native MessageChannel
  * support. Message delivery is asynchronous in-process.
+ *
+ * @group Construction
  */
 export const createMessageChannel = () => {
     const env_1 = { stack: [], error: void 0, hasError: false };
@@ -145,6 +151,8 @@ export const createMessageChannel = () => {
  *
  * This is a memory-only fallback for platforms without native MessagePort
  * support. Message delivery through returned ports is asynchronous in-process.
+ *
+ * @group Construction
  */
 export const createMessagePort = (nativePort) => {
     const registration = nativePortRegistry.get(nativePort);
@@ -156,6 +164,8 @@ export const createMessagePort = (nativePort) => {
  *
  * This is a memory-only fallback for platforms without native BroadcastChannel
  * support. Message delivery is asynchronous in-process.
+ *
+ * @group Construction
  */
 export const createBroadcastChannel = (name) => {
     const env_2 = { stack: [], error: void 0, hasError: false };
@@ -217,6 +227,8 @@ const broadcastChannelDispatchesByName = new Map();
  *
  * The returned worker includes its typed {@link TestWorker.self} counterpart, so
  * tests can exercise dedicated worker communication without a real thread.
+ *
+ * @group Testing
  */
 export const testCreateWorker = () => {
     let self;
@@ -230,6 +242,8 @@ export const testCreateWorker = () => {
  *
  * The returned worker includes `self` and `connect` so tests can exercise the
  * full worker ↔ client pipeline without a real worker thread.
+ *
+ * @group Testing
  */
 export const testCreateSharedWorker = () => {
     const { worker, self, connect } = createMemorySharedWorkerPair();
@@ -246,6 +260,8 @@ export const testCreateSharedWorker = () => {
  *
  * Both ports are registered in the native port registry so
  * {@link testCreateMessagePort} can look them up by their native token.
+ *
+ * @group Testing
  */
 export const testCreateMessageChannel = () => {
     const env_3 = { stack: [], error: void 0, hasError: false };
@@ -268,9 +284,17 @@ export const testCreateMessageChannel = () => {
         __disposeResources(env_3);
     }
 };
-/** Creates an in-memory {@link CreateMessagePort} for testing. */
+/**
+ * Creates an in-memory {@link CreateMessagePort} for testing.
+ *
+ * @group Testing
+ */
 export const testCreateMessagePort = (nativePort) => createMessagePort(nativePort);
-/** Creates an in-memory {@link BroadcastChannel} for testing. */
+/**
+ * Creates an in-memory {@link BroadcastChannel} for testing.
+ *
+ * @group Testing
+ */
 export const testCreateBroadcastChannel = (name) => {
     const env_4 = { stack: [], error: void 0, hasError: false };
     try {
@@ -303,6 +327,8 @@ export const testCreateBroadcastChannel = (name) => {
  * This observes actual transport tasks instead of waiting for an arbitrary
  * duration. It also waits through message handlers that schedule more worker
  * tasks before the current microtask checkpoint completes.
+ *
+ * @group Testing
  */
 export const testWaitForWorkerMessage = () => new Promise((resolve) => {
     workerTaskIdleWaiters.add(resolve);

package/dist/src/index.d.ts

@@ -48,16 +48,15 @@ export * from "./Type.ts";
 export * from "./Types.ts";
 export * from "./WebSocket.ts";
 export * from "./Worker.ts";
-export type { EvoluError } from "./local-first/Error.ts";
-export { AppName, createEvolu } from "./local-first/Evolu.ts";
-export type { AppNameError, Evolu, EvoluConfig, EvoluDeps, UnuseOwner, } from "./local-first/Evolu.ts";
-export * from "./local-first/LocalAuth.ts";
+export type { UnsupportedDbVersionError } from "./local-first/Db.ts";
+export { AppName, createEvolu, testAppName } from "./local-first/Evolu.ts";
+export type { AppNameError, Evolu, EvoluConfig, EvoluDeps, EvoluError, UnuseOwner, } from "./local-first/Evolu.ts";
 export * from "./local-first/Owner.ts";
 export type { SyncOwner } from "./local-first/Owner.ts";
 export { evoluJsonArrayFrom, evoluJsonBuildObject, evoluJsonObjectFrom, getJsonObjectArgs, kyselySql, type InferRow, type KyselyNotNull, type Query, type QueryRows, type Row, } from "./local-first/Query.ts";
-export { createQueryBuilder } from "./local-first/Schema.ts";
-export type { AnyStandardSchemaV1, EvoluSchema, InsertValues, Mutation, MutationKind, MutationOptions, MutationValues, NullableColumnsToOptional, OptionalColumnKeys, RequiredColumnKeys, TableSchema, UpdateValues, UpsertValues, } from "./local-first/Schema.ts";
+export { createQueryBuilder, QuarantineOrigin, QuarantineReason, testEvoluSchema, testLocalOnlyEvoluSchema, TestProjectId, testProjectId, TestTodoId, testTodoId, } from "./local-first/Schema.ts";
+export type { AnyStandardSchemaV1, EvoluSchema, InsertValues, Mutation, MutationKind, MutationOptions, MutationValues, NullableColumnsToOptional, OptionalColumnKeys, RequiredColumnKeys, TableSchema, TestEvoluSchema, UpdateValues, UpsertValues, } from "./local-first/Schema.ts";
 export type { SyncState, } from "./local-first/Shared.ts";
 export { Timestamp, timestampBytesToTimestamp, timestampToTimestampBytes, } from "./local-first/Timestamp.ts";
-export type { TimestampBytes, TimestampCounterOverflowError, TimestampDriftError, TimestampError, TimestampTimeOutOfRangeError, } from "./local-first/Timestamp.ts";
+export type { TimestampBytes, TimestampDriftError, TimestampError, } from "./local-first/Timestamp.ts";
 //# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,YAAY,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAG5B,YAAY,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC9D,YAAY,EACV,YAAY,EACZ,KAAK,EACL,WAAW,EACX,SAAS,EACT,UAAU,GACX,MAAM,wBAAwB,CAAC;AAChC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wBAAwB,CAAC;AACvC,YAAY,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,EACjB,SAAS,EACT,KAAK,QAAQ,EACb,KAAK,aAAa,EAClB,KAAK,KAAK,EACV,KAAK,SAAS,EACd,KAAK,GAAG,GACT,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,YAAY,EACV,mBAAmB,EACnB,WAAW,EACX,YAAY,EACZ,QAAQ,EACR,YAAY,EACZ,eAAe,EACf,cAAc,EACd,yBAAyB,EACzB,kBAAkB,EAClB,kBAAkB,EAClB,WAAW,EACX,YAAY,EACZ,YAAY,GACb,MAAM,yBAAyB,CAAC;AACjC,YAAY,EAIV,SAAS,GACV,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,SAAS,EACT,yBAAyB,EACzB,yBAAyB,GAC1B,MAAM,4BAA4B,CAAC;AACpC,YAAY,EACV,cAAc,EACd,6BAA6B,EAC7B,mBAAmB,EACnB,cAAc,EACd,4BAA4B,GAC7B,MAAM,4BAA4B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,YAAY,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAG5B,YAAY,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AACrE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC3E,YAAY,EACV,YAAY,EACZ,KAAK,EACL,WAAW,EACX,SAAS,EACT,UAAU,EACV,UAAU,GACX,MAAM,wBAAwB,CAAC;AAChC,cAAc,wBAAwB,CAAC;AACvC,YAAY,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,EACjB,SAAS,EACT,KAAK,QAAQ,EACb,KAAK,aAAa,EAClB,KAAK,KAAK,EACV,KAAK,SAAS,EACd,KAAK,GAAG,GACT,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,wBAAwB,EACxB,aAAa,EACb,aAAa,EACb,UAAU,EACV,UAAU,GACX,MAAM,yBAAyB,CAAC;AACjC,YAAY,EACV,mBAAmB,EACnB,WAAW,EACX,YAAY,EACZ,QAAQ,EACR,YAAY,EACZ,eAAe,EACf,cAAc,EACd,yBAAyB,EACzB,kBAAkB,EAClB,kBAAkB,EAClB,WAAW,EACX,eAAe,EACf,YAAY,EACZ,YAAY,GACb,MAAM,yBAAyB,CAAC;AACjC,YAAY,EAIV,SAAS,GACV,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,SAAS,EACT,yBAAyB,EACzB,yBAAyB,GAC1B,MAAM,4BAA4B,CAAC;AACpC,YAAY,EACV,cAAc,EACd,mBAAmB,EACnB,cAAc,GACf,MAAM,4BAA4B,CAAC"}

package/dist/src/index.js

@@ -47,9 +47,8 @@ export * from "./Type.js";
 export * from "./Types.js";
 export * from "./WebSocket.js";
 export * from "./Worker.js";
-export { AppName, createEvolu } from "./local-first/Evolu.js";
-export * from "./local-first/LocalAuth.js";
+export { AppName, createEvolu, testAppName } from "./local-first/Evolu.js";
 export * from "./local-first/Owner.js";
 export { evoluJsonArrayFrom, evoluJsonBuildObject, evoluJsonObjectFrom, getJsonObjectArgs, kyselySql, } from "./local-first/Query.js";
-export { createQueryBuilder } from "./local-first/Schema.js";
+export { createQueryBuilder, QuarantineOrigin, QuarantineReason, testEvoluSchema, testLocalOnlyEvoluSchema, TestProjectId, testProjectId, TestTodoId, testTodoId, } from "./local-first/Schema.js";
 export { Timestamp, timestampBytesToTimestamp, timestampToTimestampBytes, } from "./local-first/Timestamp.js";

package/dist/src/local-first/Db.d.ts

@@ -1,6 +1,39 @@
 /**
  * Platform-agnostic Evolu DbWorker.
  *
+ * ### Database version
+ *
+ * Every database records `dbVersion` in `evolu_version`. The version describes
+ * Evolu's internal persisted format: the layout of its system tables and the
+ * meaning of the data stored in them. It is independent of the application
+ * schema, which evolves append-only through {@link ensureSqliteSchema}, and of
+ * the network protocol version, which is checked per message. Many Evolu
+ * releases can share one database version.
+ *
+ * Bump `dbVersion` for any change that older code would misread, not only for
+ * changed SQL. A new quarantine reason, for example, changes what startup may
+ * replay even when its columns are additive. Each bump ships with a migration
+ * from the previous version; fresh databases are created at the latest layout
+ * directly.
+ *
+ * Startup holds the database leader lock, then checks the stored version record
+ * before it reads the clock, ensures the application schema, or replays
+ * quarantine. Databases written before the version record existed hold one
+ * `protocolVersion` row instead; that known legacy layout is converted to
+ * version 1. A newer stored version refuses startup with
+ * {@link UnsupportedDbVersionError}. The refusal returns from the startup
+ * transaction before anything is written and is posted to the SharedWorker; the
+ * worker then exits and releases its resources. The single version row is
+ * created in the same transaction as the other system tables.
+ *
+ * Code released before the version record existed never reads it. It recognizes
+ * an initialized database by the `evolu_version` table alone, so it opens a
+ * newer database and replays all quarantine regardless of reason, applying
+ * drift quarantine at once without advancing the clock. Renaming the table
+ * would make such code fail at startup instead. That was declined: the replay
+ * needs drift quarantine and an earlier release on the same device at once, and
+ * failing would break a rollback to an earlier release outright.
+ *
  * @module
  */
 import type { ConsoleLevel } from "../Console.ts";
@@ -8,7 +41,7 @@ import { EncryptionKey } from "../Crypto.ts";
 import type { LockManagerDep } from "../LockManager.ts";
 import type { CreateSqliteDriverDep, SqliteSchema } from "../Sqlite.ts";
 import { type Task } from "../Task.ts";
-import { type Name } from "../Type.ts";
+import { PositiveInt, type Name, type Typed } from "../Type.ts";
 import type { CreateBroadcastChannelDep, NativeMessagePort, Worker, WorkerDeps, WorkerSelf } from "../Worker.ts";
 import type { DbWorkerInput, DbWorkerOutput } from "./Shared.ts";
 export type DbWorker = Worker<DbWorkerInit>;
@@ -27,8 +60,24 @@ export interface CreateDbWorkerDep {
 }
 export type DbWorkerDeps = WorkerDeps & CreateBroadcastChannelDep & LockManagerDep & CreateSqliteDriverDep;
 /**
- * Starts the platform-agnostic Evolu DbWorker and owns its resources until the
- * worker receives a dispose message or its {@link Run} is aborted.
+ * The stored database version is newer than this code supports. Newer code
+ * created or migrated the database, which is left unchanged. This happens when
+ * older code opens a database a newer build migrated, for example an older
+ * build loaded from a cache, or when the app was downgraded after a newer
+ * version migrated the local data. On the web, a refused tab reloads once for
+ * each stored version, so it loads the build the server now serves, and the
+ * error is reported when that build refuses too. Then close all tabs of the
+ * app, which lets a service worker replace a cached older build, or update the
+ * app to a version that supports `storedVersion`.
+ */
+export interface UnsupportedDbVersionError extends Typed<"UnsupportedDbVersionError"> {
+    readonly storedVersion: PositiveInt;
+    readonly supportedVersion: PositiveInt;
+}
+/**
+ * Starts the platform-agnostic Evolu DbWorker and owns its resources until
+ * startup is refused, the worker receives a dispose message, or its {@link Run}
+ * is aborted.
  */
 export declare const startDbWorker: (self: WorkerSelf<DbWorkerInit>) => Task<void, never, DbWorkerDeps>;
 //# sourceMappingURL=Db.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Db.d.ts","sourceRoot":"","sources":["../../../src/local-first/Db.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAaH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EACL,aAAa,EAGd,MAAM,cAAc,CAAC;AAEtB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAIxD,OAAO,KAAK,EACV,qBAAqB,EAGrB,YAAY,EACb,MAAM,cAAc,CAAC;AAUtB,OAAO,EAAsB,KAAK,IAAI,EAAE,MAAM,YAAY,CAAC;AAE3D,OAAO,EASL,KAAK,IAAI,EACV,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EACV,yBAAyB,EACzB,iBAAiB,EACjB,MAAM,EACN,UAAU,EACV,UAAU,EACX,MAAM,cAAc,CAAC;AAqBtB,OAAO,KAAK,EAEV,aAAa,EACb,cAAc,EAGf,MAAM,aAAa,CAAC;AA+BrB,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC;AAE5C,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IACtC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC,cAAc,EAAE,aAAa,CAAC,CAAC;CACjE;AAED,MAAM,MAAM,cAAc,GAAG,MAAM,QAAQ,CAAC;AAE5C,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;CACzC;AAED,MAAM,MAAM,YAAY,GAAG,UAAU,GACnC,yBAAyB,GACzB,cAAc,GACd,qBAAqB,CAAC;AAExB;;;GAGG;AACH,eAAO,MAAM,aAAa,SACjB,UAAU,CAAC,YAAY,CAAC,KAAG,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,YAAY,CAwM/D,CAAC"}
+{"version":3,"file":"Db.d.ts","sourceRoot":"","sources":["../../../src/local-first/Db.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAcH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,aAAa,EAAuB,MAAM,cAAc,CAAC;AAElE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAIxD,OAAO,KAAK,EACV,qBAAqB,EAGrB,YAAY,EACb,MAAM,cAAc,CAAC;AAUtB,OAAO,EAAsB,KAAK,IAAI,EAAE,MAAM,YAAY,CAAC;AAO3D,OAAO,EASL,WAAW,EAEX,KAAK,IAAI,EACT,KAAK,KAAK,EACX,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EACV,yBAAyB,EACzB,iBAAiB,EACjB,MAAM,EACN,UAAU,EACV,UAAU,EACX,MAAM,cAAc,CAAC;AAoBtB,OAAO,KAAK,EAEV,aAAa,EACb,cAAc,EAGf,MAAM,aAAa,CAAC;AA6BrB,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC;AAE5C,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IACtC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC,cAAc,EAAE,aAAa,CAAC,CAAC;CACjE;AAED,MAAM,MAAM,cAAc,GAAG,MAAM,QAAQ,CAAC;AAE5C,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;CACzC;AAED,MAAM,MAAM,YAAY,GAAG,UAAU,GACnC,yBAAyB,GACzB,cAAc,GACd,qBAAqB,CAAC;AAKxB;;;;;;;;;;GAUG;AACH,MAAM,WAAW,yBAA0B,SAAQ,KAAK,CAAC,2BAA2B,CAAC;IACnF,QAAQ,CAAC,aAAa,EAAE,WAAW,CAAC;IACpC,QAAQ,CAAC,gBAAgB,EAAE,WAAW,CAAC;CACxC;AAED;;;;GAIG;AACH,eAAO,MAAM,aAAa,SACjB,UAAU,CAAC,YAAY,CAAC,KAAG,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,YAAY,CAuP/D,CAAC"}