@dxos/echo-doc 0.0.0

package/LICENSE

@@ -0,0 +1,105 @@
+# Functional Source License, Version 1.1, ALv2 Future License
+
+## Abbreviation
+
+FSL-1.1-Apache-2.0
+
+## Notice
+
+Copyright 2026 DXOS
+
+## Terms and Conditions
+
+### Licensor ("We")
+
+The party offering the Software under these Terms and Conditions.
+
+### The Software
+
+The "Software" is each version of the software that we make available under
+these Terms and Conditions, as indicated by our inclusion of these Terms and
+Conditions with the Software.
+
+### License Grant
+
+Subject to your compliance with this License Grant and the Patents,
+Redistribution and Trademark clauses below, we hereby grant you the right to
+use, copy, modify, create derivative works, publicly perform, publicly display
+and redistribute the Software for any Permitted Purpose identified below.
+
+### Permitted Purpose
+
+A Permitted Purpose is any purpose other than a Competing Use. A Competing Use
+means making the Software available to others in a commercial product or
+service that:
+
+1. substitutes for the Software;
+
+2. substitutes for any other product or service we offer using the Software
+   that exists as of the date we make the Software available; or
+
+3. offers the same or substantially similar functionality as the Software.
+
+Permitted Purposes specifically include using the Software:
+
+1. for your internal use and access;
+
+2. for non-commercial education;
+
+3. for non-commercial research; and
+
+4. in connection with professional services that you provide to a licensee
+   using the Software in accordance with these Terms and Conditions.
+
+### Patents
+
+To the extent your use for a Permitted Purpose would necessarily infringe our
+patents, the license grant above includes a license under our patents. If you
+make a claim against any party that the Software infringes or contributes to
+the infringement of any patent, then your patent license to the Software ends
+immediately.
+
+### Redistribution
+
+The Terms and Conditions apply to all copies, modifications and derivatives of
+the Software.
+
+If you redistribute any copies, modifications or derivatives of the Software,
+you must include a copy of or a link to these Terms and Conditions and not
+remove any copyright notices provided in or with the Software.
+
+### Disclaimer
+
+THE SOFTWARE IS PROVIDED "AS IS" AND WITHOUT WARRANTIES OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING WITHOUT LIMITATION WARRANTIES OF FITNESS FOR A PARTICULAR
+PURPOSE, MERCHANTABILITY, TITLE OR NON-INFRINGEMENT.
+
+IN NO EVENT WILL WE HAVE ANY LIABILITY TO YOU ARISING OUT OF OR RELATED TO THE
+SOFTWARE, INCLUDING INDIRECT, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES,
+EVEN IF WE HAVE BEEN INFORMED OF THEIR POSSIBILITY IN ADVANCE.
+
+### Trademarks
+
+Except for displaying the License Details and identifying us as the origin of
+the Software, you have no right under these Terms and Conditions to use our
+trademarks, trade names, service marks or product names.
+
+## Grant of Future License
+
+We hereby irrevocably grant you an additional license to use the Software under
+the Apache License, Version 2.0 that is effective on the second anniversary of
+the date we make the Software available. On or after that date, you may use the
+Software under the Apache License, Version 2.0, in which case the following
+will apply:
+
+Licensed under the Apache License, Version 2.0 (the "License"); you may not use
+this file except in compliance with the License.
+
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software distributed
+under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
+CONDITIONS OF ANY KIND, either express or implied. See the License for the
+specific language governing permissions and limitations under the License.

package/README.md

@@ -0,0 +1,8 @@
+# @dxos/echo-doc
+
+Opinionated Automerge document wrapper for ECHO.
+
+Provides the `Doc.Accessor` abstraction — a value binding into an Automerge document at a key path —
+and the higher-level patterns built on top of it (text edits via the `Edit` schema and `applyEdits`,
+and `AbstractStoreAdapter` for syncing an id-keyed record map). The accessor is resolved via
+`Doc.createAccessor`, which works identically for in-memory and database-attached objects.

package/dist/lib/neutral/index.mjs

@@ -0,0 +1,320 @@
+var __defProp = Object.defineProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+
+// src/Doc.ts
+var Doc_exports = {};
+__export(Doc_exports, {
+  createAccessor: () => createAccessor,
+  getValue: () => getValue,
+  isKeyPath: () => isKeyPath,
+  updateText: () => updateText
+});
+import { next as A } from "@automerge/automerge";
+import { Doc, createObject, getObjectCore, isEchoObject } from "@dxos/echo-client";
+import { isProxy } from "@dxos/echo/internal";
+import { assertArgument } from "@dxos/invariant";
+var isKeyPath = Doc.isKeyPath;
+var getValue = Doc.getValue;
+var createAccessor = (obj, path) => {
+  const keyPath = Array.isArray(path) ? path : [
+    path
+  ];
+  assertArgument(isProxy(obj), "obj", "expect obj to be a LiveObject");
+  assertArgument(isKeyPath(keyPath), "path", "expect path to be a valid key path");
+  const live = isEchoObject(obj) ? obj : createObject(obj);
+  return getObjectCore(live).getDocAccessor(keyPath);
+};
+var updateText = (obj, path, newText) => {
+  const accessor = createAccessor(obj, path);
+  accessor.handle.change((doc) => {
+    A.updateText(doc, accessor.path.slice(), newText);
+  });
+  return obj;
+};
+
+// src/edits.ts
+import { next as A2 } from "@automerge/automerge";
+import * as Schema from "effect/Schema";
+var Edit = Schema.Struct({
+  oldString: Schema.String.annotations({
+    description: "The exact text to find and replace."
+  }),
+  newString: Schema.String.annotations({
+    description: "The text to replace it with."
+  }),
+  replaceAll: Schema.optional(Schema.Boolean).annotations({
+    description: "Replace all occurrences of oldString (default: replace the first occurrence)."
+  })
+});
+var applyEdits = (accessor, edits) => {
+  for (const edit of edits) {
+    if (edit.oldString.length === 0) {
+      throw new Error("Edit oldString must be non-empty.");
+    }
+    accessor.handle.change((doc) => {
+      const text = getValue(accessor);
+      if (edit.replaceAll) {
+        let idx = text.indexOf(edit.oldString);
+        while (idx !== -1) {
+          A2.splice(doc, accessor.path, idx, edit.oldString.length, edit.newString);
+          const updated = getValue(accessor);
+          idx = updated.indexOf(edit.oldString, idx + edit.newString.length);
+        }
+      } else {
+        const idx = text.indexOf(edit.oldString);
+        if (idx === -1) {
+          throw new Error(`Edit not found: ${JSON.stringify(edit.oldString)}`);
+        }
+        A2.splice(doc, accessor.path, idx, edit.oldString.length, edit.newString);
+      }
+    });
+  }
+  return getValue(accessor);
+};
+
+// src/store-adapter.ts
+import { next as A4 } from "@automerge/automerge";
+import { invariant } from "@dxos/invariant";
+import { log } from "@dxos/log";
+import { isNonNullable as isNonNullable2 } from "@dxos/util";
+
+// src/record.ts
+import { next as A3 } from "@automerge/automerge";
+import { isNonNullable } from "@dxos/util";
+var STRING_CRDT_LIMIT = 3e5;
+var encode = (value) => {
+  if (Array.isArray(value)) {
+    return value.map(encode);
+  }
+  if (value instanceof A3.RawString) {
+    throw new Error("Encode called on automerge data.");
+  }
+  if (typeof value === "object" && value !== null) {
+    return Object.fromEntries(Object.entries(value).map(([key, value2]) => {
+      const encoded = encode(value2);
+      if (encoded === void 0) {
+        return void 0;
+      }
+      return [
+        key,
+        encoded
+      ];
+    }).filter(isNonNullable));
+  }
+  if (typeof value === "string" && value.length > STRING_CRDT_LIMIT) {
+    return new A3.RawString(value);
+  }
+  return value;
+};
+var decode = (value) => {
+  if (Array.isArray(value)) {
+    return value.map(decode);
+  }
+  if (value instanceof A3.RawString) {
+    return value.toString();
+  }
+  if (typeof value === "object" && value !== null) {
+    return Object.fromEntries(Object.entries(value).map(([key, value2]) => [
+      key,
+      decode(value2)
+    ]));
+  }
+  return value;
+};
+var rebasePath = (path, base) => {
+  if (path.length < base.length) {
+    return void 0;
+  }
+  for (let i = 0; i < base.length; ++i) {
+    if (path[i] !== base[i]) {
+      return void 0;
+    }
+  }
+  return path.slice(base.length);
+};
+var getDeep = (obj, path, init = false) => {
+  let value = obj;
+  for (const key of path) {
+    if (init) {
+      value[key] ??= {};
+    }
+    value = value?.[key];
+  }
+  return value;
+};
+
+// src/store-adapter.ts
+var __dxlog_file = "/Users/jdw/Code/dxos/packages/core/echo/echo-doc/src/store-adapter.ts";
+var Modified = class {
+  added = /* @__PURE__ */ new Map();
+  updated = /* @__PURE__ */ new Map();
+  deleted = /* @__PURE__ */ new Set();
+  batch() {
+    return {
+      added: Array.from(this.added.values()),
+      updated: Array.from(this.updated.values()),
+      deleted: Array.from(this.deleted.values())
+    };
+  }
+  clear() {
+    this.added.clear();
+    this.updated.clear();
+    this.deleted.clear();
+  }
+};
+var AbstractStoreAdapter = class {
+  #accessor;
+  #lastHeads;
+  #cleanup;
+  #readonly;
+  #encode;
+  #decode;
+  constructor(options = {}) {
+    this.#readonly = options.readonly ?? false;
+    this.#encode = options.encode ?? encode;
+    this.#decode = options.decode ?? decode;
+  }
+  get isOpen() {
+    return !!this.#accessor;
+  }
+  get readonly() {
+    return this.#readonly;
+  }
+  /**
+  * Binds the adapter to the element map at `accessor.path`. Returns a dispose function; calling it
+  * (or {@link close}) tears down the subscription and any listeners registered in {@link onOpen}.
+  */
+  open(accessor) {
+    invariant(accessor.path.length, void 0, { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 56, S: this, A: ["accessor.path.length", ""] });
+    if (this.isOpen) {
+      this.close();
+    }
+    log("opening...", {
+      path: accessor.path
+    }, { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 60, S: this });
+    this.#accessor = accessor;
+    const onOpenCleanup = this.onOpen();
+    {
+      const map = getDeep(accessor.handle.doc(), accessor.path) ?? {};
+      const records = Object.values(map);
+      if (records.length === 0) {
+        accessor.handle.change((doc) => {
+          const map2 = getDeep(doc, accessor.path, true);
+          for (const record of this.getElements()) {
+            map2[record.id] = this.#encode(record);
+          }
+        });
+      } else {
+        this.onUpdate({
+          updated: records.map((record) => this.#decode(record))
+        });
+      }
+    }
+    this.#lastHeads = A4.getHeads(accessor.handle.doc());
+    const updateModel = () => {
+      const doc = accessor.handle.doc();
+      const map = getDeep(doc, accessor.path);
+      const updated = /* @__PURE__ */ new Set();
+      const deleted = /* @__PURE__ */ new Set();
+      const currentHeads = A4.getHeads(doc);
+      const diff = A4.equals(this.#lastHeads, currentHeads) ? [] : A4.diff(doc, this.#lastHeads ?? [], currentHeads);
+      diff.forEach((patch) => {
+        const relativePath = rebasePath(patch.path, accessor.path);
+        if (!relativePath) {
+          return;
+        }
+        if (relativePath.length === 0) {
+          for (const id of Object.keys(map)) {
+            updated.add(id);
+          }
+          return;
+        }
+        switch (patch.action) {
+          case "del": {
+            if (relativePath.length === 1) {
+              deleted.add(relativePath[0]);
+              break;
+            }
+          }
+          // eslint-disable-next-line no-fallthrough
+          case "put":
+          case "insert":
+          case "inc":
+          case "splice": {
+            updated.add(relativePath[0]);
+            break;
+          }
+          default:
+            log.warn("did not process patch", {
+              patch,
+              path: accessor.path
+            }, { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 122, S: this });
+        }
+      });
+      if (updated.size || deleted.size) {
+        this.onUpdate({
+          updated: Array.from(updated).map((id) => this.#decode(map[id])).filter(isNonNullable2),
+          deleted: Array.from(deleted)
+        });
+      }
+      this.#lastHeads = currentHeads;
+    };
+    accessor.handle.addListener("change", updateModel);
+    this.#cleanup = () => {
+      accessor.handle.removeListener("change", updateModel);
+      onOpenCleanup?.();
+    };
+    log("open", void 0, { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 141, S: this });
+    return () => this.close();
+  }
+  close() {
+    if (!this.isOpen) {
+      return;
+    }
+    log("closing...", void 0, { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 148, S: this });
+    this.onClose();
+    this.#cleanup?.();
+    this.#cleanup = void 0;
+    this.#accessor = void 0;
+    this.#lastHeads = void 0;
+    log("closed", void 0, { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 154, S: this });
+  }
+  /**
+  * Writes a batch of element changes to the document.
+  */
+  updateDatabase(batch) {
+    invariant(this.isOpen, void 0, { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 159, S: this, A: ["this.isOpen", ""] });
+    if (this.#readonly) {
+      log.warn("attempting to update read-only store", void 0, { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 161, S: this });
+      return;
+    }
+    const accessor = this.#accessor;
+    accessor.handle.change((doc) => {
+      const map = getDeep(doc, accessor.path, true);
+      this.#removeDeleted(batch, batch.added)?.forEach((element) => map[element.id] = this.#encode(element));
+      this.#removeDeleted(batch, batch.updated)?.forEach((element) => map[element.id] = this.#encode(element));
+      batch.deleted?.forEach((id) => delete map[id]);
+    });
+  }
+  #removeDeleted(batch, elements) {
+    return batch.deleted ? elements?.filter((element) => !batch.deleted.includes(element.id)) : elements;
+  }
+  /**
+  * Called when the adapter opens; return a cleanup function to run on close (e.g. to remove store listeners).
+  */
+  onOpen() {
+  }
+  onClose() {
+  }
+};
+export {
+  AbstractStoreAdapter,
+  Doc_exports as Doc,
+  Edit,
+  Modified,
+  applyEdits
+};
+//# sourceMappingURL=index.mjs.map

package/dist/lib/neutral/index.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/Doc.ts", "../../../src/edits.ts", "../../../src/store-adapter.ts", "../../../src/record.ts"],
+  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\n// @import-as-namespace\n\nimport { next as A } from '@automerge/automerge';\n\nimport { Doc, createObject, getObjectCore, isEchoObject } from '@dxos/echo-client';\nimport { type AnyProperties, isProxy } from '@dxos/echo/internal';\nimport { assertArgument } from '@dxos/invariant';\n\n// TODO(burdon): Reduce the dependency on @dxos/echo-client (e.g. move ObjectCore lower or invert).\n\nexport type KeyPath = Doc.KeyPath;\n\nexport const isKeyPath = Doc.isKeyPath;\n\nexport type Handle<T = any> = Doc.Handle<T>;\n\nexport type Accessor<T = any> = Doc.Accessor<T>;\n\nexport const getValue = Doc.getValue;\n\n/**\n * Resolves an {@link Accessor} for a value within an object, agnostic to whether the object is\n * in-memory or attached to a database. An `Obj.make` object has no `ObjectCore` until `db.add`,\n * so an in-memory core is materialized (via `createObject`) to let the accessor bind before\n * persistence; the object's edits then survive a later `db.add`.\n */\nexport const createAccessor = <T extends AnyProperties>(\n  obj: T,\n  path: KeyPath | Extract<keyof T, string | number>,\n): Accessor<T> => {\n  const keyPath: KeyPath = Array.isArray(path) ? path : [path];\n  assertArgument(isProxy(obj), 'obj', 'expect obj to be a LiveObject');\n  assertArgument(isKeyPath(keyPath), 'path', 'expect path to be a valid key path');\n\n  const live: AnyProperties = isEchoObject(obj) ? obj : createObject(obj);\n  return getObjectCore(live).getDocAccessor(keyPath);\n};\n\n/**\n * Sets the text value at the given path, applying the change as a minimal Automerge delta (via\n * `A.updateText`) rather than replacing the whole string. This preserves cursors/anchors and merges\n * cleanly with concurrent edits — use it to write an edited string back into a collaborative text field.\n */\nexport const updateText = <T extends AnyProperties>(\n  obj: T,\n  path: KeyPath | Extract<keyof T, string | number>,\n  newText: string,\n): T => {\n  const accessor = createAccessor(obj, path);\n  accessor.handle.change((doc) => {\n    A.updateText(doc, accessor.path.slice(), newText);\n  });\n  return obj;\n};\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport { next as A } from '@automerge/automerge';\nimport * as Schema from 'effect/Schema';\n\nimport * as Doc from './Doc';\n\n/**\n * A single find/replace edit applied to a text document. This is the structured form of the diff\n * protocol described in document skills' instructions.\n */\nexport const Edit = Schema.Struct({\n  oldString: Schema.String.annotations({\n    description: 'The exact text to find and replace.',\n  }),\n  newString: Schema.String.annotations({\n    description: 'The text to replace it with.',\n  }),\n  replaceAll: Schema.optional(Schema.Boolean).annotations({\n    description: 'Replace all occurrences of oldString (default: replace the first occurrence).',\n  }),\n});\n\nexport interface Edit extends Schema.Schema.Type<typeof Edit> {}\n\n/**\n * Applies a sequence of find/replace {@link Edit}s to the string value an accessor points at,\n * returning the resulting content. Throws if a non-`replaceAll` edit's `oldString` is not found.\n */\nexport const applyEdits = (accessor: Doc.Accessor, edits: readonly Edit[]): string => {\n  for (const edit of edits) {\n    // `''.indexOf('')` is 0 (never -1), so a `replaceAll` with an empty match would loop forever.\n    if (edit.oldString.length === 0) {\n      throw new Error('Edit oldString must be non-empty.');\n    }\n\n    accessor.handle.change((doc) => {\n      const text = Doc.getValue<string>(accessor);\n      // Automerge's `splice` types the path as mutable `Prop[]`; our `KeyPath` is readonly and is not mutated here.\n      if (edit.replaceAll) {\n        let idx = text.indexOf(edit.oldString);\n        while (idx !== -1) {\n          A.splice(doc, accessor.path as A.Prop[], idx, edit.oldString.length, edit.newString);\n          const updated = Doc.getValue<string>(accessor);\n          idx = updated.indexOf(edit.oldString, idx + edit.newString.length);\n        }\n      } else {\n        const idx = text.indexOf(edit.oldString);\n        if (idx === -1) {\n          throw new Error(`Edit not found: ${JSON.stringify(edit.oldString)}`);\n        }\n        A.splice(doc, accessor.path as A.Prop[], idx, edit.oldString.length, edit.newString);\n      }\n    });\n  }\n\n  return Doc.getValue<string>(accessor);\n};\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport { next as A } from '@automerge/automerge';\n\nimport { invariant } from '@dxos/invariant';\nimport { log } from '@dxos/log';\nimport { isNonNullable } from '@dxos/util';\n\nimport * as Doc from './Doc';\nimport { decode as defaultDecode, encode as defaultEncode, getDeep, rebasePath } from './record';\n\nexport type BaseElement = { id: string };\n\n/**\n * Batch of element changes.\n */\nexport type Batch<Element extends BaseElement> = {\n  added?: Element[];\n  updated?: Element[];\n  deleted?: Element['id'][];\n};\n\n/**\n * Accumulates pending local mutations.\n */\nexport class Modified<Element extends BaseElement> {\n  readonly added = new Map<Element['id'], Element>();\n  readonly updated = new Map<Element['id'], Element>();\n  readonly deleted = new Set<Element['id']>();\n\n  batch(): Batch<Element> {\n    return {\n      added: Array.from(this.added.values()),\n      updated: Array.from(this.updated.values()),\n      deleted: Array.from(this.deleted.values()),\n    };\n  }\n\n  clear(): void {\n    this.added.clear();\n    this.updated.clear();\n    this.deleted.clear();\n  }\n}\n\nexport type StoreAdapterOptions = {\n  readonly?: boolean;\n  /** Encode a model value to an Automerge record (defaults to a structural codec). */\n  encode?: (value: any) => any;\n  /** Decode an Automerge record to a model value. */\n  decode?: (value: any) => any;\n};\n\n/**\n * Two-way sync between an external store and an id-keyed `Record<string, Element>` held at an\n * accessor's path within an Automerge document. Subclasses bind a concrete store (e.g. tldraw,\n * excalidraw) by implementing {@link getElements} / {@link onUpdate} and registering store\n * listeners in {@link onOpen}.\n */\n// TODO(burdon): Make element id key configurable.\nexport abstract class AbstractStoreAdapter<Element extends BaseElement> {\n  #accessor?: Doc.Accessor<any>;\n  #lastHeads?: A.Heads;\n  #cleanup?: () => void;\n  readonly #readonly: boolean;\n  readonly #encode: (value: any) => any;\n  readonly #decode: (value: any) => any;\n\n  constructor(options: StoreAdapterOptions = {}) {\n    this.#readonly = options.readonly ?? false;\n    this.#encode = options.encode ?? defaultEncode;\n    this.#decode = options.decode ?? defaultDecode;\n  }\n\n  get isOpen(): boolean {\n    return !!this.#accessor;\n  }\n\n  get readonly(): boolean {\n    return this.#readonly;\n  }\n\n  /**\n   * Binds the adapter to the element map at `accessor.path`. Returns a dispose function; calling it\n   * (or {@link close}) tears down the subscription and any listeners registered in {@link onOpen}.\n   */\n  open(accessor: Doc.Accessor<any>): () => void {\n    invariant(accessor.path.length);\n    if (this.isOpen) {\n      this.close();\n    }\n\n    log('opening...', { path: accessor.path });\n    this.#accessor = accessor;\n    const onOpenCleanup = this.onOpen();\n\n    // Seed the document from the store, or hydrate the store from the document.\n    {\n      const map: Record<string, Element> = getDeep(accessor.handle.doc(), accessor.path) ?? {};\n      const records = Object.values(map);\n      if (records.length === 0) {\n        accessor.handle.change((doc) => {\n          const map: Record<string, Element> = getDeep(doc, accessor.path, true);\n          for (const record of this.getElements()) {\n            map[record.id] = this.#encode(record);\n          }\n        });\n      } else {\n        this.onUpdate({ updated: records.map((record) => this.#decode(record)) });\n      }\n    }\n\n    // Baseline heads after seeding so the first change diffs only post-open mutations (not full history).\n    this.#lastHeads = A.getHeads(accessor.handle.doc());\n\n    // Propagate document mutations (local and remote) into the store.\n    const updateModel = () => {\n      const doc = accessor.handle.doc();\n      const map: Record<string, Element> = getDeep(doc, accessor.path);\n\n      const updated = new Set<Element['id']>();\n      const deleted = new Set<Element['id']>();\n\n      const currentHeads = A.getHeads(doc);\n      const diff = A.equals(this.#lastHeads, currentHeads) ? [] : A.diff(doc, this.#lastHeads ?? [], currentHeads);\n      diff.forEach((patch) => {\n        const relativePath = rebasePath(patch.path, accessor.path);\n        if (!relativePath) {\n          return;\n        }\n\n        // A patch on the map root (e.g. initial assignment) touches every element.\n        if (relativePath.length === 0) {\n          for (const id of Object.keys(map)) {\n            updated.add(id as Element['id']);\n          }\n          return;\n        }\n\n        switch (patch.action) {\n          case 'del': {\n            if (relativePath.length === 1) {\n              deleted.add(relativePath[0] as Element['id']);\n              break;\n            }\n          }\n          // eslint-disable-next-line no-fallthrough\n          case 'put':\n          case 'insert':\n          case 'inc':\n          case 'splice': {\n            updated.add(relativePath[0] as Element['id']);\n            break;\n          }\n          default:\n            log.warn('did not process patch', { patch, path: accessor.path });\n        }\n      });\n\n      if (updated.size || deleted.size) {\n        this.onUpdate({\n          updated: Array.from(updated)\n            .map((id) => this.#decode(map[id]))\n            .filter(isNonNullable), // Elements modified then eventually removed.\n          deleted: Array.from(deleted),\n        });\n      }\n\n      this.#lastHeads = currentHeads;\n    };\n\n    accessor.handle.addListener('change', updateModel);\n    this.#cleanup = () => {\n      accessor.handle.removeListener('change', updateModel);\n      onOpenCleanup?.();\n    };\n\n    log('open');\n    return () => this.close();\n  }\n\n  close(): void {\n    if (!this.isOpen) {\n      return;\n    }\n\n    log('closing...');\n    this.onClose();\n    this.#cleanup?.();\n    this.#cleanup = undefined;\n    this.#accessor = undefined;\n    this.#lastHeads = undefined;\n    log('closed');\n  }\n\n  /**\n   * Writes a batch of element changes to the document.\n   */\n  protected updateDatabase(batch: Batch<Element>): void {\n    invariant(this.isOpen);\n    if (this.#readonly) {\n      log.warn('attempting to update read-only store');\n      return;\n    }\n\n    const accessor = this.#accessor!;\n    accessor.handle.change((doc) => {\n      const map: Record<string, Element> = getDeep(doc, accessor.path, true);\n      this.#removeDeleted(batch, batch.added)?.forEach((element) => (map[element.id] = this.#encode(element)));\n      this.#removeDeleted(batch, batch.updated)?.forEach((element) => (map[element.id] = this.#encode(element)));\n      batch.deleted?.forEach((id) => delete map[id]);\n    });\n  }\n\n  #removeDeleted(batch: Batch<Element>, elements?: Element[]): Element[] | undefined {\n    return batch.deleted ? elements?.filter((element) => !batch.deleted!.includes(element.id)) : elements;\n  }\n\n  /**\n   * Returns all elements currently in the store.\n   */\n  abstract getElements(): readonly Element[];\n\n  /**\n   * Applies document changes to the store.\n   */\n  protected abstract onUpdate(batch: Batch<Element>): void;\n\n  /**\n   * Called when the adapter opens; return a cleanup function to run on close (e.g. to remove store listeners).\n   */\n  protected onOpen(): (() => void) | void {}\n\n  protected onClose(): void {}\n}\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport { next as A } from '@automerge/automerge';\n\nimport { isNonNullable } from '@dxos/util';\n\nimport * as Doc from './Doc';\n\n// Strings longer than this have collaborative editing disabled for performance reasons.\nconst STRING_CRDT_LIMIT = 300_000;\n\n/**\n * Default codec: encode a model value to an Automerge record.\n */\nexport const encode = (value: any): any => {\n  if (Array.isArray(value)) {\n    return value.map(encode);\n  }\n  if (value instanceof A.RawString) {\n    throw new Error('Encode called on automerge data.');\n  }\n  if (typeof value === 'object' && value !== null) {\n    return Object.fromEntries(\n      Object.entries(value)\n        .map(([key, value]) => {\n          const encoded = encode(value);\n          if (encoded === undefined) {\n            return undefined;\n          }\n          return [key, encoded];\n        })\n        .filter(isNonNullable),\n    );\n  }\n  if (typeof value === 'string' && value.length > STRING_CRDT_LIMIT) {\n    return new A.RawString(value);\n  }\n\n  return value;\n};\n\n/**\n * Default codec: decode an Automerge record to a model value.\n */\nexport const decode = (value: any): any => {\n  if (Array.isArray(value)) {\n    return value.map(decode);\n  }\n  if (value instanceof A.RawString) {\n    return value.toString();\n  }\n  if (typeof value === 'object' && value !== null) {\n    return Object.fromEntries(Object.entries(value).map(([key, value]) => [key, decode(value)]));\n  }\n\n  return value;\n};\n\n/**\n * Relative path from `base`, or `undefined` if `path` is not under `base`. Used to filter mutations.\n */\nexport const rebasePath = (path: A.Prop[], base: Doc.KeyPath): A.Prop[] | undefined => {\n  if (path.length < base.length) {\n    return undefined;\n  }\n  for (let i = 0; i < base.length; ++i) {\n    if (path[i] !== base[i]) {\n      return undefined;\n    }\n  }\n\n  return path.slice(base.length);\n};\n\n/**\n * Read the value at `path`. When `init` is set, auto-vivifies intermediate records.\n */\nexport const getDeep = (obj: any, path: Doc.KeyPath, init = false): any => {\n  let value = obj;\n  for (const key of path) {\n    if (init) {\n      value[key] ??= {};\n    }\n    value = value?.[key];\n  }\n\n  return value;\n};\n"],
+  "mappings": "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",
+  "names": ["next", "A", "Doc", "createObject", "getObjectCore", "isEchoObject", "isProxy", "assertArgument", "isKeyPath", "getValue", "createAccessor", "obj", "path", "keyPath", "Array", "isArray", "live", "getDocAccessor", "updateText", "newText", "accessor", "handle", "change", "doc", "slice", "next", "A", "Schema", "Edit", "Struct", "oldString", "String", "annotations", "description", "newString", "replaceAll", "optional", "Boolean", "applyEdits", "accessor", "edits", "edit", "length", "Error", "handle", "change", "doc", "text", "getValue", "idx", "indexOf", "A", "splice", "path", "updated", "JSON", "stringify", "next", "A", "invariant", "log", "isNonNullable", "next", "A", "isNonNullable", "STRING_CRDT_LIMIT", "encode", "value", "Array", "isArray", "map", "RawString", "Error", "Object", "fromEntries", "entries", "key", "encoded", "undefined", "filter", "length", "decode", "toString", "rebasePath", "path", "base", "i", "slice", "getDeep", "obj", "init", "updated", "deleted", "Set", "batch", "added", "Array", "from", "values", "clear", "options", "decode", "defaultDecode", "isOpen", "readonly", "close", "accessor", "onOpenCleanup", "onOpen", "records", "length", "handle", "change", "doc", "getDeep", "record", "getElements", "map", "updateModel", "currentHeads", "getHeads", "diff", "equals", "forEach", "patch", "relativePath", "rebasePath", "path", "add", "id", "log", "isNonNullable", "addListener", "removeListener", "warn"]
+}

package/dist/lib/neutral/meta.json

@@ -0,0 +1 @@
+{"inputs":{"src/Doc.ts":{"bytes":6027,"imports":[{"path":"@automerge/automerge","kind":"import-statement","external":true},{"path":"@dxos/echo-client","kind":"import-statement","external":true},{"path":"@dxos/echo/internal","kind":"import-statement","external":true},{"path":"@dxos/invariant","kind":"import-statement","external":true}],"format":"esm"},"src/edits.ts":{"bytes":7454,"imports":[{"path":"@automerge/automerge","kind":"import-statement","external":true},{"path":"effect/Schema","kind":"import-statement","external":true},{"path":"src/Doc.ts","kind":"import-statement","original":"./Doc"}],"format":"esm"},"src/record.ts":{"bytes":7830,"imports":[{"path":"@automerge/automerge","kind":"import-statement","external":true},{"path":"@dxos/util","kind":"import-statement","external":true}],"format":"esm"},"src/store-adapter.ts":{"bytes":24113,"imports":[{"path":"@automerge/automerge","kind":"import-statement","external":true},{"path":"@dxos/invariant","kind":"import-statement","external":true},{"path":"@dxos/log","kind":"import-statement","external":true},{"path":"@dxos/util","kind":"import-statement","external":true},{"path":"src/record.ts","kind":"import-statement","original":"./record"}],"format":"esm"},"src/index.ts":{"bytes":944,"imports":[{"path":"src/Doc.ts","kind":"import-statement","original":"./Doc"},{"path":"src/edits.ts","kind":"import-statement","original":"./edits"},{"path":"src/store-adapter.ts","kind":"import-statement","original":"./store-adapter"}],"format":"esm"}},"outputs":{"dist/lib/neutral/index.mjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":22165},"dist/lib/neutral/index.mjs":{"imports":[{"path":"@automerge/automerge","kind":"import-statement","external":true},{"path":"@dxos/echo-client","kind":"import-statement","external":true},{"path":"@dxos/echo/internal","kind":"import-statement","external":true},{"path":"@dxos/invariant","kind":"import-statement","external":true},{"path":"@automerge/automerge","kind":"import-statement","external":true},{"path":"effect/Schema","kind":"import-statement","external":true},{"path":"@automerge/automerge","kind":"import-statement","external":true},{"path":"@dxos/invariant","kind":"import-statement","external":true},{"path":"@dxos/log","kind":"import-statement","external":true},{"path":"@dxos/util","kind":"import-statement","external":true},{"path":"@automerge/automerge","kind":"import-statement","external":true},{"path":"@dxos/util","kind":"import-statement","external":true}],"exports":["AbstractStoreAdapter","Doc","Edit","Modified","applyEdits"],"entryPoint":"src/index.ts","inputs":{"src/Doc.ts":{"bytesInOutput":1047},"src/index.ts":{"bytesInOutput":0},"src/edits.ts":{"bytesInOutput":1375},"src/store-adapter.ts":{"bytesInOutput":5632},"src/record.ts":{"bytesInOutput":1541}},"bytes":9988}}}

package/dist/types/src/Doc.d.ts

@@ -0,0 +1,21 @@
+import { Doc } from '@dxos/echo-client';
+import { type AnyProperties } from '@dxos/echo/internal';
+export type KeyPath = Doc.KeyPath;
+export declare const isKeyPath: (value: unknown) => value is Doc.KeyPath;
+export type Handle<T = any> = Doc.Handle<T>;
+export type Accessor<T = any> = Doc.Accessor<T>;
+export declare const getValue: <V, T = any>(accessor: Doc.Accessor<T>) => V;
+/**
+ * Resolves an {@link Accessor} for a value within an object, agnostic to whether the object is
+ * in-memory or attached to a database. An `Obj.make` object has no `ObjectCore` until `db.add`,
+ * so an in-memory core is materialized (via `createObject`) to let the accessor bind before
+ * persistence; the object's edits then survive a later `db.add`.
+ */
+export declare const createAccessor: <T extends AnyProperties>(obj: T, path: KeyPath | Extract<keyof T, string | number>) => Accessor<T>;
+/**
+ * Sets the text value at the given path, applying the change as a minimal Automerge delta (via
+ * `A.updateText`) rather than replacing the whole string. This preserves cursors/anchors and merges
+ * cleanly with concurrent edits — use it to write an edited string back into a collaborative text field.
+ */
+export declare const updateText: <T extends AnyProperties>(obj: T, path: KeyPath | Extract<keyof T, string | number>, newText: string) => T;
+//# sourceMappingURL=Doc.d.ts.map

package/dist/types/src/Doc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Doc.d.ts","sourceRoot":"","sources":["../../../src/Doc.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,GAAG,EAA6C,MAAM,mBAAmB,CAAC;AACnF,OAAO,EAAE,KAAK,aAAa,EAAW,MAAM,qBAAqB,CAAC;AAKlE,MAAM,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC;AAElC,eAAO,MAAM,SAAS,0CAAgB,CAAC;AAEvC,MAAM,MAAM,MAAM,CAAC,CAAC,GAAG,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;AAE5C,MAAM,MAAM,QAAQ,CAAC,CAAC,GAAG,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;AAEhD,eAAO,MAAM,QAAQ,8CAAe,CAAC;AAErC;;;;;GAKG;AACH,eAAO,MAAM,cAAc,GAAI,CAAC,SAAS,aAAa,OAC/C,CAAC,QACA,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,KAChD,QAAQ,CAAC,CAAC,CAOZ,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,UAAU,GAAI,CAAC,SAAS,aAAa,OAC3C,CAAC,QACA,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,WACxC,MAAM,KACd,CAMF,CAAC"}

package/dist/types/src/Doc.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=Doc.test.d.ts.map

package/dist/types/src/Doc.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Doc.test.d.ts","sourceRoot":"","sources":["../../../src/Doc.test.ts"],"names":[],"mappings":""}

package/dist/types/src/edits.d.ts

@@ -0,0 +1,19 @@
+import * as Schema from 'effect/Schema';
+import * as Doc from './Doc';
+/**
+ * A single find/replace edit applied to a text document. This is the structured form of the diff
+ * protocol described in document skills' instructions.
+ */
+export declare const Edit: Schema.Struct<{
+    oldString: Schema.SchemaClass<string, string, never>;
+    newString: Schema.SchemaClass<string, string, never>;
+    replaceAll: Schema.optional<typeof Schema.Boolean>;
+}>;
+export interface Edit extends Schema.Schema.Type<typeof Edit> {
+}
+/**
+ * Applies a sequence of find/replace {@link Edit}s to the string value an accessor points at,
+ * returning the resulting content. Throws if a non-`replaceAll` edit's `oldString` is not found.
+ */
+export declare const applyEdits: (accessor: Doc.Accessor, edits: readonly Edit[]) => string;
+//# sourceMappingURL=edits.d.ts.map

package/dist/types/src/edits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"edits.d.ts","sourceRoot":"","sources":["../../../src/edits.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,KAAK,GAAG,MAAM,OAAO,CAAC;AAE7B;;;GAGG;AACH,eAAO,MAAM,IAAI;;;;EAUf,CAAC;AAEH,MAAM,WAAW,IAAK,SAAQ,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC;CAAG;AAEhE;;;GAGG;AACH,eAAO,MAAM,UAAU,aAAc,GAAG,CAAC,QAAQ,SAAS,SAAS,IAAI,EAAE,KAAG,MA4B3E,CAAC"}

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

@@ -0,0 +1,4 @@
+export * as Doc from './Doc';
+export { Edit, applyEdits } from './edits';
+export { AbstractStoreAdapter, type BaseElement, type Batch, Modified, type StoreAdapterOptions, } from './store-adapter';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,GAAG,MAAM,OAAO,CAAC;AAC7B,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,EACL,oBAAoB,EACpB,KAAK,WAAW,EAChB,KAAK,KAAK,EACV,QAAQ,EACR,KAAK,mBAAmB,GACzB,MAAM,iBAAiB,CAAC"}

package/dist/types/src/record.d.ts

@@ -0,0 +1,19 @@
+import { next as A } from '@automerge/automerge';
+import * as Doc from './Doc';
+/**
+ * Default codec: encode a model value to an Automerge record.
+ */
+export declare const encode: (value: any) => any;
+/**
+ * Default codec: decode an Automerge record to a model value.
+ */
+export declare const decode: (value: any) => any;
+/**
+ * Relative path from `base`, or `undefined` if `path` is not under `base`. Used to filter mutations.
+ */
+export declare const rebasePath: (path: A.Prop[], base: Doc.KeyPath) => A.Prop[] | undefined;
+/**
+ * Read the value at `path`. When `init` is set, auto-vivifies intermediate records.
+ */
+export declare const getDeep: (obj: any, path: Doc.KeyPath, init?: boolean) => any;
+//# sourceMappingURL=record.d.ts.map

package/dist/types/src/record.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"record.d.ts","sourceRoot":"","sources":["../../../src/record.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,IAAI,IAAI,CAAC,EAAE,MAAM,sBAAsB,CAAC;AAIjD,OAAO,KAAK,GAAG,MAAM,OAAO,CAAC;AAK7B;;GAEG;AACH,eAAO,MAAM,MAAM,UAAW,GAAG,KAAG,GAyBnC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,MAAM,UAAW,GAAG,KAAG,GAYnC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,UAAU,SAAU,CAAC,CAAC,IAAI,EAAE,QAAQ,GAAG,CAAC,OAAO,KAAG,CAAC,CAAC,IAAI,EAAE,GAAG,SAWzE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,OAAO,QAAS,GAAG,QAAQ,GAAG,CAAC,OAAO,qBAAiB,GAUnE,CAAC"}

package/dist/types/src/store-adapter.d.ts

@@ -0,0 +1,65 @@
+import * as Doc from './Doc';
+export type BaseElement = {
+    id: string;
+};
+/**
+ * Batch of element changes.
+ */
+export type Batch<Element extends BaseElement> = {
+    added?: Element[];
+    updated?: Element[];
+    deleted?: Element['id'][];
+};
+/**
+ * Accumulates pending local mutations.
+ */
+export declare class Modified<Element extends BaseElement> {
+    readonly added: Map<Element["id"], Element>;
+    readonly updated: Map<Element["id"], Element>;
+    readonly deleted: Set<Element["id"]>;
+    batch(): Batch<Element>;
+    clear(): void;
+}
+export type StoreAdapterOptions = {
+    readonly?: boolean;
+    /** Encode a model value to an Automerge record (defaults to a structural codec). */
+    encode?: (value: any) => any;
+    /** Decode an Automerge record to a model value. */
+    decode?: (value: any) => any;
+};
+/**
+ * Two-way sync between an external store and an id-keyed `Record<string, Element>` held at an
+ * accessor's path within an Automerge document. Subclasses bind a concrete store (e.g. tldraw,
+ * excalidraw) by implementing {@link getElements} / {@link onUpdate} and registering store
+ * listeners in {@link onOpen}.
+ */
+export declare abstract class AbstractStoreAdapter<Element extends BaseElement> {
+    #private;
+    constructor(options?: StoreAdapterOptions);
+    get isOpen(): boolean;
+    get readonly(): boolean;
+    /**
+     * Binds the adapter to the element map at `accessor.path`. Returns a dispose function; calling it
+     * (or {@link close}) tears down the subscription and any listeners registered in {@link onOpen}.
+     */
+    open(accessor: Doc.Accessor<any>): () => void;
+    close(): void;
+    /**
+     * Writes a batch of element changes to the document.
+     */
+    protected updateDatabase(batch: Batch<Element>): void;
+    /**
+     * Returns all elements currently in the store.
+     */
+    abstract getElements(): readonly Element[];
+    /**
+     * Applies document changes to the store.
+     */
+    protected abstract onUpdate(batch: Batch<Element>): void;
+    /**
+     * Called when the adapter opens; return a cleanup function to run on close (e.g. to remove store listeners).
+     */
+    protected onOpen(): (() => void) | void;
+    protected onClose(): void;
+}
+//# sourceMappingURL=store-adapter.d.ts.map