@automerge/automerge-repo 1.1.4 → 1.1.8

package/dist/Repo.d.ts

@@ -29,7 +29,7 @@ export declare class Repo extends EventEmitter<RepoEvents> {
     /** maps peer id to to persistence information (storageId, isEphemeral), access by collection synchronizer  */
     /** @hidden */
     peerMetadataByPeerId: Record<PeerId, PeerMetadata>;
-    constructor({ storage, network, peerId, sharePolicy, isEphemeral, enableRemoteHeadsGossiping, }: RepoConfig);
+    constructor({ storage, network, peerId, sharePolicy, isEphemeral, enableRemoteHeadsGossiping, }?: RepoConfig);
     /** Returns all the handles we have cached. */
     get handles(): Record<DocumentId, DocHandle<any>>;
     /** Returns a list of all connected peer ids */
@@ -82,6 +82,13 @@ export declare class Repo extends EventEmitter<RepoEvents> {
     import<T>(binary: Uint8Array): DocHandle<T>;
     subscribeToRemotes: (remotes: StorageId[]) => void;
     storageId: () => Promise<StorageId | undefined>;
+    /**
+     * Writes Documents to a disk.
+     * @hidden this API is experimental and may change.
+     * @param documents - if provided, only writes the specified documents.
+     * @returns Promise<void>
+     */
+    flush(documents?: DocumentId[]): Promise<void>;
 }
 export interface RepoConfig {
     /** Our unique identifier */
@@ -91,8 +98,8 @@ export interface RepoConfig {
     isEphemeral?: boolean;
     /** A storage adapter can be provided, or not */
     storage?: StorageAdapterInterface;
-    /** One or more network adapters must be provided */
-    network: NetworkAdapterInterface[];
+    /** A list of network adapters (more can be added at runtime). */
+    network?: NetworkAdapterInterface[];
     /**
      * Normal peers typically share generously with everyone (meaning we sync all our documents with
      * all peers). A server only syncs documents that a peer explicitly requests by ID.

package/dist/Repo.d.ts.map

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

package/dist/Repo.js

@@ -36,7 +36,7 @@ export class Repo extends EventEmitter {
     peerMetadataByPeerId = {};
     #remoteHeadsSubscriptions = new RemoteHeadsSubscriptions();
     #remoteHeadsGossipingEnabled = false;
-    constructor({ storage, network, peerId, sharePolicy, isEphemeral = storage === undefined, enableRemoteHeadsGossiping = false, }) {
+    constructor({ storage, network = [], peerId, sharePolicy, isEphemeral = storage === undefined, enableRemoteHeadsGossiping = false, } = {}) {
         super();
         this.#remoteHeadsGossipingEnabled = enableRemoteHeadsGossiping;
         this.#log = debug(`automerge-repo:repo`);
@@ -383,4 +383,25 @@ export class Repo extends EventEmitter {
             return this.storageSubsystem.id();
         }
     };
+    /**
+     * Writes Documents to a disk.
+     * @hidden this API is experimental and may change.
+     * @param documents - if provided, only writes the specified documents.
+     * @returns Promise<void>
+     */
+    async flush(documents) {
+        if (!this.storageSubsystem) {
+            return;
+        }
+        const handles = documents
+            ? documents.map(id => this.#handleCache[id])
+            : Object.values(this.#handleCache);
+        await Promise.all(handles.map(async (handle) => {
+            const doc = handle.docSync();
+            if (!doc) {
+                return;
+            }
+            return this.storageSubsystem.saveDoc(handle.documentId, doc);
+        }));
+    }
 }

package/dist/helpers/arraysAreEqual.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"arraysAreEqual.d.ts","sourceRoot":"","sources":["../../src/helpers/arraysAreEqual.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,cAAc,gCACiD,CAAA"}
+{"version":3,"file":"arraysAreEqual.d.ts","sourceRoot":"","sources":["../../src/helpers/arraysAreEqual.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,cAAc,SAAU,CAAC,EAAE,KAAK,CAAC,EAAE,YAC4B,CAAA"}

package/dist/helpers/debounce.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"debounce.d.ts","sourceRoot":"","sources":["../../src/helpers/debounce.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,eAAO,MAAM,QAAQ,qEAEb,MAAM,qCASb,CAAA"}
+{"version":3,"file":"debounce.d.ts","sourceRoot":"","sources":["../../src/helpers/debounce.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,eAAO,MAAM,QAAQ,4DACf,CAAC,QACC,MAAM,eAGc,WAAW,CAAC,CAAC,SAMxC,CAAA"}

package/dist/helpers/tests/network-adapter-tests.d.ts

@@ -11,7 +11,7 @@ import type { NetworkAdapterInterface } from "../../network/NetworkAdapterInterf
  * - `teardown`: An optional function that will be called after the tests have run. This can be used
  *   to clean up any resources that were created during the test.
  */
-export declare function runAdapterTests(_setup: SetupFn, title?: string): void;
+export declare function runNetworkAdapterTests(_setup: SetupFn, title?: string): void;
 type Network = NetworkAdapterInterface | NetworkAdapterInterface[];
 export type SetupFn = () => Promise<{
     adapters: [Network, Network, Network];

package/dist/helpers/tests/network-adapter-tests.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"network-adapter-tests.d.ts","sourceRoot":"","sources":["../../../src/helpers/tests/network-adapter-tests.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,0CAA0C,CAAA;AAIvF;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAuJrE;AAID,KAAK,OAAO,GAAG,uBAAuB,GAAG,uBAAuB,EAAE,CAAA;AAElE,MAAM,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC;IAClC,QAAQ,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAA;IACrC,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAA;CACtB,CAAC,CAAA"}
+{"version":3,"file":"network-adapter-tests.d.ts","sourceRoot":"","sources":["../../../src/helpers/tests/network-adapter-tests.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,0CAA0C,CAAA;AAIvF;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAyJ5E;AAID,KAAK,OAAO,GAAG,uBAAuB,GAAG,uBAAuB,EAAE,CAAA;AAElE,MAAM,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC;IAClC,QAAQ,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAA;IACrC,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAA;CACtB,CAAC,CAAA"}

package/dist/helpers/tests/network-adapter-tests.js

@@ -15,7 +15,7 @@ import { pause } from "../pause.js";
  * - `teardown`: An optional function that will be called after the tests have run. This can be used
  *   to clean up any resources that were created during the test.
  */
-export function runAdapterTests(_setup, title) {
+export function runNetworkAdapterTests(_setup, title) {
     // Wrap the provided setup function
     const setup = async () => {
         const { adapters, teardown = NO_OP } = await _setup();
@@ -23,7 +23,7 @@ export function runAdapterTests(_setup, title) {
         const [a, b, c] = adapters.map(toArray);
         return { adapters: [a, b, c], teardown };
     };
-    describe(`Adapter acceptance tests ${title ? `(${title})` : ""}`, () => {
+    describe(`Network adapter acceptance tests ${title ? `(${title})` : ""}`, () => {
         it("can sync 2 repos", async () => {
             const doTest = async (a, b) => {
                 const aliceRepo = new Repo({ network: a, peerId: alice });

package/dist/helpers/tests/storage-adapter-tests.d.ts

@@ -0,0 +1,7 @@
+import type { StorageAdapterInterface } from "../../storage/StorageAdapterInterface.js";
+export declare function runStorageAdapterTests(_setup: SetupFn, title?: string): void;
+export type SetupFn = () => Promise<{
+    adapter: StorageAdapterInterface;
+    teardown?: () => void;
+}>;
+//# sourceMappingURL=storage-adapter-tests.d.ts.map

package/dist/helpers/tests/storage-adapter-tests.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-adapter-tests.d.ts","sourceRoot":"","sources":["../../../src/helpers/tests/storage-adapter-tests.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,0CAA0C,CAAA;AAQvF,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CA+K5E;AAID,MAAM,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC;IAClC,OAAO,EAAE,uBAAuB,CAAA;IAChC,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAA;CACtB,CAAC,CAAA"}

package/dist/helpers/tests/storage-adapter-tests.js

@@ -0,0 +1,128 @@
+import { describe, expect, it } from "vitest";
+const PAYLOAD_A = () => new Uint8Array([0, 1, 127, 99, 154, 235]);
+const PAYLOAD_B = () => new Uint8Array([1, 76, 160, 53, 57, 10, 230]);
+const PAYLOAD_C = () => new Uint8Array([2, 111, 74, 131, 236, 96, 142, 193]);
+const LARGE_PAYLOAD = new Uint8Array(100000).map(() => Math.random() * 256);
+export function runStorageAdapterTests(_setup, title) {
+    const setup = async () => {
+        const { adapter, teardown = NO_OP } = await _setup();
+        return { adapter, teardown };
+    };
+    describe(`Storage adapter acceptance tests ${title ? `(${title})` : ""}`, () => {
+        describe("load", () => {
+            it("should return undefined if there is no data", async () => {
+                const { adapter, teardown } = await setup();
+                const actual = await adapter.load(["AAAAA", "sync-state", "xxxxx"]);
+                expect(actual).toBeUndefined();
+                teardown();
+            });
+        });
+        describe("save and load", () => {
+            it("should return data that was saved", async () => {
+                const { adapter, teardown } = await setup();
+                await adapter.save(["storage-adapter-id"], PAYLOAD_A());
+                const actual = await adapter.load(["storage-adapter-id"]);
+                expect(actual).toStrictEqual(PAYLOAD_A());
+                teardown();
+            });
+            it("should work with composite keys", async () => {
+                const { adapter, teardown } = await setup();
+                await adapter.save(["AAAAA", "sync-state", "xxxxx"], PAYLOAD_A());
+                const actual = await adapter.load(["AAAAA", "sync-state", "xxxxx"]);
+                expect(actual).toStrictEqual(PAYLOAD_A());
+                teardown();
+            });
+            it("should work with a large payload", async () => {
+                const { adapter, teardown } = await setup();
+                await adapter.save(["AAAAA", "sync-state", "xxxxx"], LARGE_PAYLOAD);
+                const actual = await adapter.load(["AAAAA", "sync-state", "xxxxx"]);
+                expect(actual).toStrictEqual(LARGE_PAYLOAD);
+                teardown();
+            });
+        });
+        describe("loadRange", () => {
+            it("should return an empty array if there is no data", async () => {
+                const { adapter, teardown } = await setup();
+                expect(await adapter.loadRange(["AAAAA"])).toStrictEqual([]);
+                teardown();
+            });
+        });
+        describe("save and loadRange", () => {
+            it("should return all the data that matches the key", async () => {
+                const { adapter, teardown } = await setup();
+                await adapter.save(["AAAAA", "sync-state", "xxxxx"], PAYLOAD_A());
+                await adapter.save(["AAAAA", "snapshot", "yyyyy"], PAYLOAD_B());
+                await adapter.save(["AAAAA", "sync-state", "zzzzz"], PAYLOAD_C());
+                expect(await adapter.loadRange(["AAAAA"])).toStrictEqual(expect.arrayContaining([
+                    { key: ["AAAAA", "sync-state", "xxxxx"], data: PAYLOAD_A() },
+                    { key: ["AAAAA", "snapshot", "yyyyy"], data: PAYLOAD_B() },
+                    { key: ["AAAAA", "sync-state", "zzzzz"], data: PAYLOAD_C() },
+                ]));
+                expect(await adapter.loadRange(["AAAAA", "sync-state"])).toStrictEqual(expect.arrayContaining([
+                    { key: ["AAAAA", "sync-state", "xxxxx"], data: PAYLOAD_A() },
+                    { key: ["AAAAA", "sync-state", "zzzzz"], data: PAYLOAD_C() },
+                ]));
+                teardown();
+            });
+            it("should only load values that match they key", async () => {
+                const { adapter, teardown } = await setup();
+                await adapter.save(["AAAAA", "sync-state", "xxxxx"], PAYLOAD_A());
+                await adapter.save(["BBBBB", "sync-state", "zzzzz"], PAYLOAD_C());
+                const actual = await adapter.loadRange(["AAAAA"]);
+                expect(actual).toStrictEqual(expect.arrayContaining([
+                    { key: ["AAAAA", "sync-state", "xxxxx"], data: PAYLOAD_A() },
+                ]));
+                expect(actual).toStrictEqual(expect.not.arrayContaining([
+                    { key: ["BBBBB", "sync-state", "zzzzz"], data: PAYLOAD_C() },
+                ]));
+                teardown();
+            });
+        });
+        describe("save and remove", () => {
+            it("after removing, should be empty", async () => {
+                const { adapter, teardown } = await setup();
+                await adapter.save(["AAAAA", "snapshot", "xxxxx"], PAYLOAD_A());
+                await adapter.remove(["AAAAA", "snapshot", "xxxxx"]);
+                expect(await adapter.loadRange(["AAAAA"])).toStrictEqual([]);
+                expect(await adapter.load(["AAAAA", "snapshot", "xxxxx"])).toBeUndefined();
+                teardown();
+            });
+        });
+        describe("save and save", () => {
+            it("should overwrite data saved with the same key", async () => {
+                const { adapter, teardown } = await setup();
+                await adapter.save(["AAAAA", "sync-state", "xxxxx"], PAYLOAD_A());
+                await adapter.save(["AAAAA", "sync-state", "xxxxx"], PAYLOAD_B());
+                expect(await adapter.loadRange(["AAAAA", "sync-state"])).toStrictEqual([
+                    { key: ["AAAAA", "sync-state", "xxxxx"], data: PAYLOAD_B() },
+                ]);
+                teardown();
+            });
+        });
+        describe("removeRange", () => {
+            it("should remove a range of records", async () => {
+                const { adapter, teardown } = await setup();
+                await adapter.save(["AAAAA", "sync-state", "xxxxx"], PAYLOAD_A());
+                await adapter.save(["AAAAA", "snapshot", "yyyyy"], PAYLOAD_B());
+                await adapter.save(["AAAAA", "sync-state", "zzzzz"], PAYLOAD_C());
+                await adapter.removeRange(["AAAAA", "sync-state"]);
+                expect(await adapter.loadRange(["AAAAA"])).toStrictEqual([
+                    { key: ["AAAAA", "snapshot", "yyyyy"], data: PAYLOAD_B() },
+                ]);
+                teardown();
+            });
+            it("should not remove records that don't match", async () => {
+                const { adapter, teardown } = await setup();
+                await adapter.save(["AAAAA", "sync-state", "xxxxx"], PAYLOAD_A());
+                await adapter.save(["BBBBB", "sync-state", "zzzzz"], PAYLOAD_B());
+                await adapter.removeRange(["AAAAA"]);
+                const actual = await adapter.loadRange(["BBBBB"]);
+                expect(actual).toStrictEqual([
+                    { key: ["BBBBB", "sync-state", "zzzzz"], data: PAYLOAD_B() },
+                ]);
+                teardown();
+            });
+        });
+    });
+}
+const NO_OP = () => { };

package/dist/helpers/throttle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"throttle.d.ts","sourceRoot":"","sources":["../../src/helpers/throttle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,eAAO,MAAM,QAAQ,sEAEZ,MAAM,qCAad,CAAA"}
+{"version":3,"file":"throttle.d.ts","sourceRoot":"","sources":["../../src/helpers/throttle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,eAAO,MAAM,QAAQ,4DACf,CAAC,SACE,MAAM,eAKa,WAAW,CAAC,CAAC,SAQxC,CAAA"}

package/dist/helpers/withTimeout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"withTimeout.d.ts","sourceRoot":"","sources":["../../src/helpers/withTimeout.ts"],"names":[],"mappings":"AACA;;;GAGG;AACH,eAAO,MAAM,WAAW,8BAEnB,MAAM,eAcV,CAAA;AAED,qBAAa,YAAa,SAAQ,KAAK;gBACzB,OAAO,EAAE,MAAM;CAI5B"}
+{"version":3,"file":"withTimeout.d.ts","sourceRoot":"","sources":["../../src/helpers/withTimeout.ts"],"names":[],"mappings":"AACA;;;GAGG;AACH,eAAO,MAAM,WAAW,eACb,QAAQ,CAAC,CAAC,KAChB,MAAM,KACR,QAAQ,CAAC,CAaX,CAAA;AAED,qBAAa,YAAa,SAAQ,KAAK;gBACzB,OAAO,EAAE,MAAM;CAI5B"}

package/dist/index.d.ts

@@ -41,4 +41,8 @@ export type { NetworkAdapterEvents, OpenPayload, PeerCandidatePayload, PeerDisco
 export type { DocumentUnavailableMessage, EphemeralMessage, Message, RepoMessage, RequestMessage, SyncMessage, } from "./network/messages.js";
 export type { Chunk, ChunkInfo, ChunkType, StorageKey, StorageId, } from "./storage/types.js";
 export * from "./types.js";
+export type { Counter, RawString, Cursor } from "@automerge/automerge/next";
+export type { Doc, Heads, Patch, PatchCallback, Prop, ActorId, Change, ChangeFn, Mark, MarkSet, MarkRange, MarkValue, } from "@automerge/automerge/next";
+export { getChanges, getAllChanges, applyChanges, view, getConflicts, } from "@automerge/automerge/next";
+export { getCursor, getCursorPosition, splice, updateText, insertAt, deleteAt, mark, unmark, } from "@automerge/automerge/next";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAA;AAC5D,YAAY,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAA;AACnF,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAA;AAC5D,YAAY,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAA;AAEnF,eAAe;AACf,OAAO,KAAK,IAAI,MAAM,mBAAmB,CAAA;AAIzC,YAAY,EACV,sBAAsB,EACtB,sBAAsB,EACtB,6BAA6B,EAC7B,gCAAgC,EAChC,2BAA2B,EAC3B,eAAe,EACf,gBAAgB,EAChB,wCAAwC,EACxC,WAAW,GACZ,MAAM,gBAAgB,CAAA;AAEvB,YAAY,EACV,qBAAqB,EACrB,eAAe,EACf,UAAU,EACV,UAAU,EACV,WAAW,GACZ,MAAM,WAAW,CAAA;AAElB,YAAY,EACV,oBAAoB,EACpB,WAAW,EACX,oBAAoB,EACpB,uBAAuB,EACvB,YAAY,GACb,MAAM,sCAAsC,CAAA;AAE7C,YAAY,EACV,0BAA0B,EAC1B,gBAAgB,EAChB,OAAO,EACP,WAAW,EACX,cAAc,EACd,WAAW,GACZ,MAAM,uBAAuB,CAAA;AAE9B,YAAY,EACV,KAAK,EACL,SAAS,EACT,SAAS,EACT,UAAU,EACV,SAAS,GACV,MAAM,oBAAoB,CAAA;AAE3B,cAAc,YAAY,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAA;AAC5D,YAAY,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAA;AACnF,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAA;AAC5D,YAAY,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAA;AAEnF,eAAe;AACf,OAAO,KAAK,IAAI,MAAM,mBAAmB,CAAA;AAIzC,YAAY,EACV,sBAAsB,EACtB,sBAAsB,EACtB,6BAA6B,EAC7B,gCAAgC,EAChC,2BAA2B,EAC3B,eAAe,EACf,gBAAgB,EAChB,wCAAwC,EACxC,WAAW,GACZ,MAAM,gBAAgB,CAAA;AAEvB,YAAY,EACV,qBAAqB,EACrB,eAAe,EACf,UAAU,EACV,UAAU,EACV,WAAW,GACZ,MAAM,WAAW,CAAA;AAElB,YAAY,EACV,oBAAoB,EACpB,WAAW,EACX,oBAAoB,EACpB,uBAAuB,EACvB,YAAY,GACb,MAAM,sCAAsC,CAAA;AAE7C,YAAY,EACV,0BAA0B,EAC1B,gBAAgB,EAChB,OAAO,EACP,WAAW,EACX,cAAc,EACd,WAAW,GACZ,MAAM,uBAAuB,CAAA;AAE9B,YAAY,EACV,KAAK,EACL,SAAS,EACT,SAAS,EACT,UAAU,EACV,SAAS,GACV,MAAM,oBAAoB,CAAA;AAE3B,cAAc,YAAY,CAAA;AAG1B,YAAY,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAA;AAG3E,YAAY,EACV,GAAG,EACH,KAAK,EACL,KAAK,EACL,aAAa,EACb,IAAI,EACJ,OAAO,EACP,MAAM,EACN,QAAQ,EACR,IAAI,EACJ,OAAO,EACP,SAAS,EACT,SAAS,GACV,MAAM,2BAA2B,CAAA;AAIlC,OAAO,EACL,UAAU,EACV,aAAa,EACb,YAAY,EACZ,IAAI,EACJ,YAAY,GACb,MAAM,2BAA2B,CAAA;AAKlC,OAAO,EACL,SAAS,EACT,iBAAiB,EACjB,MAAM,EACN,UAAU,EACV,QAAQ,EACR,QAAQ,EACR,IAAI,EACJ,MAAM,GACP,MAAM,2BAA2B,CAAA"}

package/dist/index.js

@@ -34,3 +34,10 @@ export { StorageAdapter } from "./storage/StorageAdapter.js";
 /** @hidden **/
 export * as cbor from "./helpers/cbor.js";
 export * from "./types.js";
+// export a few utility functions that aren't in automerge-repo
+// NB that these should probably all just be available via the dochandle
+export { getChanges, getAllChanges, applyChanges, view, getConflicts, } from "@automerge/automerge/next";
+// export type-specific utility functions
+// these mostly can't be on the data-type in question because
+// JS strings can't have methods added to them
+export { getCursor, getCursorPosition, splice, updateText, insertAt, deleteAt, mark, unmark, } from "@automerge/automerge/next";

package/dist/synchronizer/DocSynchronizer.js

@@ -152,7 +152,7 @@ export class DocSynchronizer extends Synchronizer {
         return this.#peers.includes(peerId);
     }
     beginSync(peerIds) {
-        const noPeersWithDocument = peerIds.every((peerId) => this.#peerDocumentStatuses[peerId] in ["unavailable", "wants"]);
+        const noPeersWithDocument = peerIds.every(peerId => this.#peerDocumentStatuses[peerId] in ["unavailable", "wants"]);
         // At this point if we don't have anything in our storage, we need to use an empty doc to sync
         // with; but we don't want to surface that state to the front end
         const docPromise = this.#handle

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@automerge/automerge-repo",
-  "version": "1.1.4",
+  "version": "1.1.8",
   "description": "A repository object to manage a collection of automerge documents",
   "repository": "https://github.com/automerge/automerge-repo/tree/master/packages/automerge-repo",
   "author": "Peter van Hardenberg <pvh@pvh.ca>",
@@ -23,7 +23,7 @@
     "vite": "^5.0.8"
   },
   "dependencies": {
-    "@automerge/automerge": "^2.1.9",
+    "@automerge/automerge": "^2.1.13",
     "bs58check": "^3.0.1",
     "cbor-x": "^1.3.0",
     "debug": "^4.3.4",
@@ -32,7 +32,7 @@
     "tiny-typed-emitter": "^2.1.0",
     "ts-node": "^10.9.1",
     "uuid": "^9.0.0",
-    "xstate": "^4.37.0"
+    "xstate": "^5.9.1"
   },
   "watch": {
     "build": {
@@ -55,5 +55,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "e819a7ed6302ce34f372b119ea3e8bab052e3af6"
+  "gitHead": "fa2e5c0309458f244a81e49501dc882c5074f8ad"
 }