@dialecte/core 0.7.0 → 0.8.1

package/dist/document/transaction/main.d.ts

@@ -47,7 +47,9 @@ export declare class Transaction<GenericConfig extends AnyDialecteConfig> extend
      */
     protected get context(): Context<GenericConfig>;
     /**
-     * Add a child element to a parent.
+     * Add a child element to a parent. It always creates one; `ensureChild` reuses an existing child.
+     *
+     * @intent create a new element under a parent, insert a child with attributes, build new content in a transaction
      *
      * @param parentRefOrRecord - The parent element (ref, record, or relationship). `undefined` for root.
      * @param params - Child tagName, attributes and optional namespace, value, id.
@@ -65,28 +67,35 @@ export declare class Transaction<GenericConfig extends AnyDialecteConfig> extend
     /**
      * Get an existing child record or create it under the given parent.
      *
-     * Lookup strategy:
-     * - Singleton child (id absent in params): resolves by tagName.
-     * - Non-singleton child (id present in params): resolves by tagName + id.
-     * - Non-singleton child without id: no lookup, always creates.
+     * The lookup reads only the direct children of the parent with `params.tagName` (never the whole
+     * document), in this order:
+     * 1. Attributes with a non-empty value given: the first of those children whose attributes match them
+     *    (`params.id` is then not used for the lookup).
+     * 2. Otherwise, `params.id` given: the child with that id.
+     * 3. Otherwise: the first of those children.
+     * 4. No match: the child is created from `params`, as `addChild` would.
+     *
+     * @intent get or create a child, make sure a singleton container exists before adding under it, add a child without duplicating it
      *
      * @param parentRefOrRecord - The parent element (ref, record, or relationship). `undefined` for root.
      * @param params - Child tagName, attributes and optional namespace, value, id.
-     * @returns Ref to the existing or created child.
+     * @returns The record of the existing or created child.
      *
      * @example
      * ```ts
-     * const aRef = await tx.ensureChild(root, {
+     * const a = await tx.ensureChild(root, {
      *   tagName: 'A',
      *   attributes: {},
      * })
      * ```
-     * If A already exists under root, returns its ref. Otherwise, creates it and returns the new ref.
+     * If an A already exists under root, returns its record. Otherwise, creates it and returns the new record.
      */
     ensureChild<GenericElement extends ElementsOf<GenericConfig>, GenericChildElement extends ChildrenOf<GenericConfig, GenericElement>>(parentRefOrRecord: RefOrRecord<GenericConfig, GenericElement> | undefined, params: AddChildParams<GenericConfig, GenericElement, GenericChildElement>): Promise<RawRecord<GenericConfig, GenericChildElement>>;
     /**
      * Update attributes of an existing element.
      *
+     * @intent change attribute values, set or clear an attribute, rename an element through its name attribute, set an element's text value
+     *
      * @param refOrRecord - The element to update (ref, record, or relationship).
      * @param params - New attribute values.
      * @returns RawRecord of the updated element.
@@ -102,6 +111,8 @@ export declare class Transaction<GenericConfig extends AnyDialecteConfig> extend
     /**
      * Delete an element and its entire subtree.
      *
+     * @intent remove an element, delete a subtree, prune a child from its parent
+     *
      * @param refOrRecord - The element to delete (ref, record, or relationship).
      * @returns RawRecord of the deleted element's parent.
      *
@@ -114,34 +125,53 @@ export declare class Transaction<GenericConfig extends AnyDialecteConfig> extend
     /**
      * Deep-clone a subtree under a new parent.
      *
+     * @intent copy a subtree with fresh ids, duplicate an element under another parent, paste a tree read with getTree, map old ids to new ids
+     *
      * @param parentRefOrRecord - The target parent for the clone.
      * @param record - The tree record to clone (from `getTree`).
-     * @returns The cloned root raw record and an ID mapping from old to new.
+     * @returns `{ record, mappings }`: the cloned root raw record and, per cloned node, its source and
+     *   target refs.
      *
      * @example
      * ```ts
-     * const tree = await tx.getTree(aRecord)
-     * const { ref, idMap } = await tx.deepClone(substation, tree)
+     * const tree = await tx.getTree(aa1) // an AA_1 to copy
+     * const { record, mappings } = await tx.deepClone(a, tree) // under an A
      * ```
      */
     deepClone<GenericElement extends ElementsOf<GenericConfig>, GenericChildElement extends ChildrenOf<GenericConfig, GenericElement>>(parentRefOrRecord: RefOrRecord<GenericConfig, GenericElement> | undefined, record: TreeRecord<GenericConfig, GenericChildElement>): Promise<CloneResult<GenericConfig, GenericChildElement>>;
     /**
      * Run the `beforeCommit` hook once, when the transaction's work is done, and stage
-     * what it returns. Called by Document.transaction() / prepare() after the callback.
+     * what it returns. Called by Document.transaction() / prepare() after the callback; not meant for callers.
+     *
+     * @internal Used by Document.transaction and Document.prepare to run beforeCommit hooks.
      */
     finishStaging(): Promise<void>;
-    /** Returns a read-only view of staged operations (for prepare/preview) */
+    /**
+     * Returns a read-only view of the staged operations (for prepare/preview). Called by Document, not meant for callers.
+     *
+     * @internal Used by Document.prepare to list pending operations.
+     */
     getStagedOperations(): ReadonlyArray<Operation<GenericConfig>>;
-    /** Free staged operations from memory */
+    /**
+     * Free staged operations from memory. Called by Document after commit or discard, not meant for callers.
+     *
+     * @internal Used by Document.transaction to release staged writes.
+     */
     clearStagedOperations(): void;
-    /** Free cached records from memory */
+    /**
+     * Free cached records from memory. Called by Document after commit or discard, not meant for callers.
+     *
+     * @internal Used by Document.transaction to release the record cache.
+     */
     clearRecordCache(): void;
     /**
      * Commit all staged operations to the store atomically.
-     * Called by Document.transaction() after user callback completes.
+     * Called by Document.transaction() after user callback completes; not meant for callers.
      *
      * Updates documentState (loading, progress, lastCommit).
      * Merges operations by ID to optimize database writes.
+     *
+     * @internal Used by Document.transaction to write staged operations to the store.
      */
     commit(): Promise<void>;
 }

package/dist/document/transaction/main.d.ts.map

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

package/dist/document/transaction/stage-operations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stage-operations.d.ts","sourceRoot":"","sources":["../../../src/document/transaction/stage-operations.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AACzC,OAAO,KAAK,EAAE,iBAAiB,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAElF,wBAAgB,cAAc,CAAC,aAAa,SAAS,iBAAiB,EAAE,MAAM,EAAE;IAC/E,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;IAC/B,MAAM,EAAE,SAAS,CAAA;IACjB,MAAM,EAAE,SAAS,CAAC,aAAa,EAAE,UAAU,CAAC,aAAa,CAAC,CAAC,CAAA;CAC3D,GAAG,IAAI,CAAA;AACR,wBAAgB,cAAc,CAAC,aAAa,SAAS,iBAAiB,EAAE,MAAM,EAAE;IAC/E,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;IAC/B,MAAM,EAAE,SAAS,CAAA;IACjB,SAAS,EAAE,SAAS,CAAC,aAAa,EAAE,UAAU,CAAC,aAAa,CAAC,CAAC,CAAA;IAC9D,SAAS,EAAE,SAAS,CAAC,aAAa,EAAE,UAAU,CAAC,aAAa,CAAC,CAAC,CAAA;CAC9D,GAAG,IAAI,CAAA;AACR,wBAAgB,cAAc,CAAC,aAAa,SAAS,iBAAiB,EAAE,MAAM,EAAE;IAC/E,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;IAC/B,MAAM,EAAE,SAAS,CAAA;IACjB,MAAM,EAAE,SAAS,CAAC,aAAa,EAAE,UAAU,CAAC,aAAa,CAAC,CAAC,CAAA;CAC3D,GAAG,IAAI,CAAA;AAyDR,wBAAgB,eAAe,CAAC,aAAa,SAAS,iBAAiB,EAAE,MAAM,EAAE;IAChF,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;IAC/B,UAAU,EAAE,SAAS,CAAC,aAAa,CAAC,EAAE,CAAA;CACtC,QAoBA"}
+{"version":3,"file":"stage-operations.d.ts","sourceRoot":"","sources":["../../../src/document/transaction/stage-operations.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AACzC,OAAO,KAAK,EAAE,iBAAiB,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAElF,wBAAgB,cAAc,CAAC,aAAa,SAAS,iBAAiB,EAAE,MAAM,EAAE;IAC/E,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;IAC/B,MAAM,EAAE,SAAS,CAAA;IACjB,MAAM,EAAE,SAAS,CAAC,aAAa,EAAE,UAAU,CAAC,aAAa,CAAC,CAAC,CAAA;CAC3D,GAAG,IAAI,CAAA;AACR,wBAAgB,cAAc,CAAC,aAAa,SAAS,iBAAiB,EAAE,MAAM,EAAE;IAC/E,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;IAC/B,MAAM,EAAE,SAAS,CAAA;IACjB,SAAS,EAAE,SAAS,CAAC,aAAa,EAAE,UAAU,CAAC,aAAa,CAAC,CAAC,CAAA;IAC9D,SAAS,EAAE,SAAS,CAAC,aAAa,EAAE,UAAU,CAAC,aAAa,CAAC,CAAC,CAAA;CAC9D,GAAG,IAAI,CAAA;AACR,wBAAgB,cAAc,CAAC,aAAa,SAAS,iBAAiB,EAAE,MAAM,EAAE;IAC/E,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;IAC/B,MAAM,EAAE,SAAS,CAAA;IACjB,MAAM,EAAE,SAAS,CAAC,aAAa,EAAE,UAAU,CAAC,aAAa,CAAC,CAAC,CAAA;CAC3D,GAAG,IAAI,CAAA;AA2DR,wBAAgB,eAAe,CAAC,aAAa,SAAS,iBAAiB,EAAE,MAAM,EAAE;IAChF,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;IAC/B,UAAU,EAAE,SAAS,CAAC,aAAa,CAAC,EAAE,CAAA;CACtC,QAoBA"}

package/dist/document/transaction/update/update.d.ts

@@ -5,6 +5,8 @@ import { AnyDialecteConfig, ElementsOf, RawRecord, TransactionHooks } from '../.
  * Merges attribute/value changes onto an existing record.
  * Undefined/null attribute values are stripped (treated as removals).
  * Returns the same ref — the element does not move.
+ *
+ * @internal the staging step behind `tx.update`; callers use the transaction
  */
 export declare function stageUpdate<GenericConfig extends AnyDialecteConfig, GenericElement extends ElementsOf<GenericConfig>>(params: {
     dialecteConfig: GenericConfig;

package/dist/document/transaction/update/update.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../../../src/document/transaction/update/update.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAClD,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,YAAY,CAAA;AACrD,OAAO,KAAK,EACX,iBAAiB,EAGjB,UAAU,EACV,SAAS,EACT,gBAAgB,EAChB,MAAM,SAAS,CAAA;AAEhB;;;;GAIG;AACH,wBAAsB,WAAW,CAChC,aAAa,SAAS,iBAAiB,EACvC,cAAc,SAAS,UAAU,CAAC,aAAa,CAAC,EAC/C,MAAM,EAAE;IACT,cAAc,EAAE,aAAa,CAAA;IAC7B,KAAK,CAAC,EAAE,gBAAgB,CAAC,aAAa,CAAC,CAAA;IACvC,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;IAC/B,KAAK,EAAE,KAAK,CAAC,aAAa,CAAC,CAAA;IAC3B,GAAG,EAAE,GAAG,CAAC,aAAa,EAAE,cAAc,CAAC,CAAA;IACvC,MAAM,EAAE,YAAY,CAAC,aAAa,EAAE,cAAc,CAAC,CAAA;CACnD,GAAG,OAAO,CAAC,SAAS,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC,CAiFpD"}
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../../../src/document/transaction/update/update.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAClD,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,YAAY,CAAA;AACrD,OAAO,KAAK,EACX,iBAAiB,EAGjB,UAAU,EACV,SAAS,EACT,gBAAgB,EAChB,MAAM,SAAS,CAAA;AAEhB;;;;;;GAMG;AACH,wBAAsB,WAAW,CAChC,aAAa,SAAS,iBAAiB,EACvC,cAAc,SAAS,UAAU,CAAC,aAAa,CAAC,EAC/C,MAAM,EAAE;IACT,cAAc,EAAE,aAAa,CAAA;IAC7B,KAAK,CAAC,EAAE,gBAAgB,CAAC,aAAa,CAAC,CAAA;IACvC,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,CAAA;IAC/B,KAAK,EAAE,KAAK,CAAC,aAAa,CAAC,CAAA;IAC3B,GAAG,EAAE,GAAG,CAAC,aAAa,EAAE,cAAc,CAAC,CAAA;IACvC,MAAM,EAAE,YAAY,CAAC,aAAa,EAAE,cAAc,CAAC,CAAA;CACnD,GAAG,OAAO,CAAC,SAAS,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC,CAiFpD"}

package/dist/document/types.d.ts

@@ -1,6 +1,7 @@
 import { Document } from './document';
 import { ProgressReporter, DocumentProgress } from './progress/progress.types';
 import { Query } from './query';
+import { OperationsSummary } from './transaction/commit/summarize-operations.types';
 import { ExtensionsRegistry, QueryExtensions, ExtensionModules, MergedExtensions } from './types.extensions';
 import { DialecteError } from '../errors';
 import { Perf } from '../perf';
@@ -54,11 +55,8 @@ export type CachedContext<GenericConfig extends AnyDialecteConfig> = Context<Gen
 };
 export type PreparedTransaction<GenericConfig extends AnyDialecteConfig, GenericExtension extends ExtensionsRegistry = {}> = {
     readonly operations: ReadonlyArray<Operation<GenericConfig>>;
-    readonly summary: {
-        creates: number;
-        updates: number;
-        deletes: number;
-    };
+    /** One count per record, as the commit merges the operations: totals and per tag. */
+    readonly summary: OperationsSummary;
     /**
      * Read-only view of the in-progress transaction.
      *

package/dist/document/types.d.ts.map

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

package/dist/document/types.extensions.d.ts.map

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

package/dist/engine-store-CIEqgPUb.js

@@ -0,0 +1,348 @@
+import { i as e, r as t, t as n } from "./running-operations-vnijBvn7.js";
+import { M as r, P as i, a, b as o, v as s } from "./project-key-Ch34EtFa.js";
+import { G as c } from "./utils-USNkj4sT.js";
+// src/store/engine/wire/wire.constants.ts
+var l = {
+	registerDocument: { json: [{ argument: 0 }] },
+	getDocument: { read: !0 },
+	getDocuments: { read: !0 },
+	updateDocument: { json: [{ argument: 1 }] },
+	removeDocument: {},
+	get: { read: !0 },
+	getByDocumentId: { read: !0 },
+	count: { read: !0 },
+	getByTagNameInDocument: { read: !0 },
+	getMany: { read: !0 },
+	bulkWrite: { json: [{
+		argument: 1,
+		path: ["creates"]
+	}, {
+		argument: 1,
+		path: ["updates"]
+	}] },
+	getWriteOutcome: { read: !0 },
+	undo: {},
+	redo: {},
+	getHistoryStatus: { read: !0 },
+	getChangeLog: { read: !0 },
+	commit: {
+		json: [{
+			argument: 0,
+			path: ["creates"]
+		}, {
+			argument: 0,
+			path: ["updates"]
+		}],
+		listener: 1,
+		identified: !0
+	},
+	importFile: {
+		json: [{
+			argument: 0,
+			path: ["options"]
+		}],
+		listener: 1,
+		identified: !0
+	},
+	abortImport: {},
+	exportFile: {
+		listener: 1,
+		abortable: !0
+	},
+	abortExport: {},
+	addBlob: { json: [{ argument: 0 }] },
+	getBlob: { read: !0 },
+	getBlobsByDocument: { read: !0 },
+	getBlobsByRecord: { read: !0 },
+	getStandaloneBlobs: { read: !0 },
+	attachBlob: { json: [{ argument: 1 }] },
+	detachBlob: {},
+	removeBlob: {}
+}, u = e(), d = class {
+	constructor(e) {
+		this.closed = !1, this.closings = 0, this.linkReleased = Promise.resolve(), this.operations = n(), this.listeners = /* @__PURE__ */ new Set(), this.stopNotices = m, this.lostWrites = /* @__PURE__ */ new Set(), i({ project: e.name }), this.name = e.name, this.connector = e.connector;
+	}
+	async open() {
+		let e = this.closings;
+		for (await this.operations.whenIdle(); this.destroying;) await this.destroying.catch(t);
+		this.closings !== e && r({ storeName: this.name }), this.closed = !1, await this.tracked(async () => {
+			await this.currentEngine();
+		});
+	}
+	async close() {
+		if (this.closed = !0, this.closings += 1, this.operations.count === 0) return this.releaseLink();
+		let e = this.operations.whenIdle();
+		u.markClosing({
+			name: this.name,
+			until: e
+		}), await e, await this.linkReleased;
+	}
+	async destroy() {
+		for (; this.destroying;) await this.destroying.catch(t);
+		let e = this.destroyOnceIdle();
+		this.destroying = e;
+		try {
+			await e;
+		} finally {
+			this.destroying === e && (this.destroying = void 0);
+		}
+	}
+	async destroyOnceIdle() {
+		await this.operations.whenIdle(), await u.settled({ name: this.name });
+		let e = this.link && {
+			link: this.link,
+			letGo: this.releaseLink.bind(this)
+		};
+		await this.connector.destroy({ own: e }), this.releaseLink();
+	}
+	subscribe(e) {
+		return this.listeners.add(e), this.link && this.listenToLink({ link: this.link }), () => {
+			this.listeners.delete(e), this.listeners.size === 0 && this.stopListeningToLink();
+		};
+	}
+	listenToLink(e) {
+		let { link: t } = e;
+		this.listeners.size !== 0 && this.listenedLink !== t && (this.stopListeningToLink(), this.listenedLink = t, this.stopNotices = t.onNotice((e) => this.tellListeners({
+			notice: e,
+			link: t
+		})));
+	}
+	stopListeningToLink() {
+		this.stopNotices(), this.stopNotices = m, this.listenedLink = void 0;
+	}
+	async reconcile() {
+		return this.operation({
+			readRetried: !1,
+			run: async () => void 0
+		});
+	}
+	async isDocumentReadable(e) {
+		return await this.call("getDocument", e) !== void 0;
+	}
+	async registerDocument(e) {
+		return this.call("registerDocument", e);
+	}
+	async getDocument(e) {
+		return this.call("getDocument", e);
+	}
+	async getDocuments() {
+		return this.call("getDocuments");
+	}
+	async updateDocument(e, t) {
+		await this.call("updateDocument", e, t);
+	}
+	async removeDocument(e) {
+		await this.call("removeDocument", e);
+	}
+	async get(e, t) {
+		return this.call("get", e, t);
+	}
+	async getByDocumentId(e) {
+		return this.call("getByDocumentId", e);
+	}
+	async count(e) {
+		return this.call("count", e);
+	}
+	async getByTagNameInDocument(e, t) {
+		return this.call("getByTagNameInDocument", e, t);
+	}
+	async getMany(e, t) {
+		return this.call("getMany", e, t);
+	}
+	async importFile(e) {
+		let { file: t, options: n, writeId: r = crypto.randomUUID(), onProgress: i, signal: a } = e;
+		return this.operation({
+			readRetried: !1,
+			run: async (e) => {
+				let o = e.importFile({
+					file: t,
+					options: n,
+					writeId: r
+				}, i), s = f({
+					signal: a,
+					abort: function() {
+						return e.abortImport({ writeId: r });
+					}
+				});
+				try {
+					return await o;
+				} finally {
+					s();
+				}
+			}
+		});
+	}
+	async exportFile(e) {
+		let { documentId: t, options: n, onProgress: r, signal: i } = e, o = crypto.randomUUID();
+		return this.operation({
+			readRetried: !1,
+			run: async (e) => {
+				let s = e.exportFile({
+					documentId: t,
+					options: n,
+					exportId: o
+				}, r), c = f({
+					signal: i,
+					abort: function() {
+						return e.abortExport({ exportId: o });
+					}
+				});
+				try {
+					let e = await s;
+					return a({
+						signal: i,
+						documentId: t
+					}), e;
+				} finally {
+					c();
+				}
+			}
+		});
+	}
+	async getWriteOutcome(e) {
+		let t = await this.call("getWriteOutcome", e);
+		return t !== "running" && this.lostWrites.delete(e.writeId), t;
+	}
+	async bulkWrite(e, t) {
+		await this.call("bulkWrite", e, t);
+	}
+	async commit(e) {
+		let { documentId: t, writeId: n = crypto.randomUUID(), creates: r, updates: i, deletes: a, onProgress: o } = e;
+		return this.call("commit", {
+			documentId: t,
+			writeId: n,
+			creates: r,
+			updates: i,
+			deletes: a
+		}, o);
+	}
+	async undo(e) {
+		await this.call("undo", e);
+	}
+	async redo(e) {
+		await this.call("redo", e);
+	}
+	async getHistoryStatus(e) {
+		return this.call("getHistoryStatus", e);
+	}
+	async getChangeLog(e) {
+		return this.call("getChangeLog", e);
+	}
+	getDatabaseInstance() {
+		return null;
+	}
+	async addBlob(e, t) {
+		return this.call("addBlob", e, t);
+	}
+	async getBlob(e) {
+		return this.call("getBlob", e);
+	}
+	async getBlobsByDocument(e) {
+		return this.call("getBlobsByDocument", e);
+	}
+	async getBlobsByRecord(e, t) {
+		return this.call("getBlobsByRecord", e, t);
+	}
+	async getStandaloneBlobs() {
+		return this.call("getStandaloneBlobs");
+	}
+	async attachBlob(e, t) {
+		await this.call("attachBlob", e, t);
+	}
+	async detachBlob(e, t) {
+		await this.call("detachBlob", e, t);
+	}
+	async removeBlob(e) {
+		await this.call("removeBlob", e);
+	}
+	async call(e, ...t) {
+		let n = l[e];
+		return this.operation({
+			readRetried: n.read === !0,
+			run: function(n) {
+				return Reflect.apply(n[e], n, t);
+			}
+		});
+	}
+	async operation(e) {
+		let { readRetried: n, run: i } = e;
+		if (this.closed && r({ storeName: this.name }), this.destroying) {
+			for (; this.destroying;) await this.destroying.catch(t);
+			this.closed && r({ storeName: this.name });
+		}
+		return this.tracked(async () => {
+			let e = await this.currentEngine();
+			try {
+				return await i(e);
+			} catch (e) {
+				if (this.noteLostWrite({ thrown: e }), !n || !p({ thrown: e })) throw e;
+				let t = await this.currentEngine();
+				return i(t);
+			}
+		});
+	}
+	changeOf(e) {
+		let { signal: t, link: n } = e, { writeId: r } = t, i = r !== void 0 && this.lostWrites.delete(r);
+		return {
+			type: "change",
+			message: t.message,
+			own: t.connectionId === n.connectionId && !i
+		};
+	}
+	noteLostWrite(e) {
+		let t = c(e.thrown), n = t?.meta?.writeId;
+		t?.key === "STORE_ENGINE_LOST" && typeof n == "string" && this.lostWrites.add(n);
+	}
+	async tracked(e) {
+		this.operations.start();
+		try {
+			return await e();
+		} finally {
+			this.operations.count === 1 && this.closed && this.releaseLink(), this.operations.end();
+		}
+	}
+	async currentEngine() {
+		return this.connecting ??= this.connectOnce(), this.link = await this.connecting, this.link.engine();
+	}
+	async connectOnce() {
+		try {
+			let e = await this.connector.connect();
+			return this.listenToLink({ link: e }), e;
+		} catch (e) {
+			throw this.connecting = void 0, e;
+		}
+	}
+	tellListeners(e) {
+		let { notice: t, link: n } = e;
+		t.type === "resync" && this.lostWrites.clear();
+		let r = t.type === "resync" ? t : this.changeOf({
+			signal: t.signal,
+			link: n
+		});
+		o({
+			listeners: this.listeners,
+			value: r,
+			of: s({ name: this.name })
+		});
+	}
+	releaseLink() {
+		return this.stopListeningToLink(), this.lostWrites.clear(), this.link && (this.linkReleased = this.link.close()), this.link = void 0, this.connecting = void 0, this.linkReleased;
+	}
+};
+function f(e) {
+	let { signal: t, abort: n } = e;
+	if (!t) return m;
+	function r() {
+		n().catch(h);
+	}
+	return t.aborted ? (r(), m) : (t.addEventListener("abort", r, { once: !0 }), function() {
+		t.removeEventListener("abort", r);
+	});
+}
+function p(e) {
+	let t = c(e.thrown);
+	return t?.key === "STORE_ENGINE_LOST" && t.meta?.reason === "host-gone";
+}
+function m() {}
+function h() {}
+export { l as n, d as t };

package/dist/engine.constants-DBMjMmV9.js

@@ -0,0 +1,98 @@
+import { W as e } from "./utils-USNkj4sT.js";
+// src/store/engine/creation-refusal.ts
+function t(t) {
+	let { project: n, expectedCreationId: r, creationId: i } = t;
+	r !== void 0 && i !== r && e("PROJECT_DESTROYED_WHILE_AWAY", {
+		detail: `Project "${n}" was destroyed while this view was away${i === void 0 ? "" : ", and made again since"}: nothing of it was opened`,
+		meta: { project: n }
+	});
+}
+// src/store/sqlite/sqlite-wasm-url.ts
+var n = new URL(new URL("sqlite3.wasm", import.meta.url).href, "" + import.meta.url).href;
+function r() {
+	return typeof globalThis.process?.versions?.node == "string" ? void 0 : n;
+}
+// src/store/sqlite/engine/engine.constants.ts
+var i = {
+	cacheRule: {
+		mibPerGiB: 64,
+		floorMiB: 64,
+		ceilingMiB: 512
+	},
+	importWindowMs: 1e3,
+	reclaimSliceMs: 50,
+	reclaimPagesPerStatement: 256
+}, a = {
+	dialecteId: "dialecteId",
+	layoutVersion: "layoutVersion",
+	creationId: "creationId"
+}, o = {
+	offsetBasis: 2166136261,
+	prime: 16777619
+}, s = {
+	id: "TEXT NOT NULL UNIQUE",
+	name: "TEXT NOT NULL",
+	extension: "TEXT NOT NULL",
+	configKey: "TEXT NOT NULL",
+	createdAt: "INTEGER NOT NULL",
+	metadata: "TEXT",
+	status: "TEXT NOT NULL",
+	writeId: "TEXT",
+	path: "TEXT UNIQUE"
+}, c = {
+	id: "INTEGER PRIMARY KEY AUTOINCREMENT",
+	documentId: "TEXT NOT NULL",
+	sequenceNumber: "INTEGER",
+	timestamp: "INTEGER NOT NULL",
+	writeId: "TEXT NOT NULL",
+	state: "INTEGER NOT NULL"
+}, l = {
+	applied: 1,
+	undone: 0,
+	discarded: -1
+}, u = {
+	id: "TEXT PRIMARY KEY",
+	documentId: "TEXT NOT NULL",
+	entry: "TEXT NOT NULL"
+}, d = {
+	id: "TEXT PRIMARY KEY",
+	type: "TEXT NOT NULL",
+	bytes: "BLOB NOT NULL"
+}, f = {
+	id: "TEXT NOT NULL",
+	tagName: "TEXT NOT NULL",
+	nsPrefix: "TEXT",
+	nsUri: "TEXT",
+	value: "TEXT",
+	parentId: "TEXT",
+	parentTagName: "TEXT",
+	attributes: "TEXT",
+	children: "TEXT"
+}, p = {
+	id: {
+		column: "id",
+		unique: !0
+	},
+	tag: {
+		column: "tagName",
+		unique: !1
+	}
+}, m = {
+	create: 0,
+	before: 1,
+	after: 2,
+	delete: 3
+}, h = "xch_", g = "_blobData", _ = 1e3, v = ["attributes", "children"], y = Object.keys(f), b = y.join(", "), x = Object.keys(s).join(", "), S = Object.keys(f).map((e, t) => v.includes(e) ? `e.value->${t}` : `e.value->>${t}`), C = Object.keys(f).slice(1).map((e, t) => `${e} = u.c${t + 1}`).join(", "), w = S.map((e, t) => `${e} AS c${t}`).join(", "), T = 1048576, E = [
+	"registerDocument",
+	"updateDocument",
+	"removeDocument",
+	"bulkWrite",
+	"commit",
+	"undo",
+	"redo",
+	"addBlob",
+	"attachBlob",
+	"detachBlob",
+	"removeBlob"
+];
+export { n as C, h as S, t as T, C as _, i as a, S as b, E as c, T as d, a as f, p as g, y as h, c as i, l, b as m, u as n, s as o, f as p, d as r, x as s, o as t, m as u, _ as v, r as w, g as x, w as y };

package/dist/engine.d.ts

@@ -0,0 +1,9 @@
+/**
+ * `@dialecte/core/engine` - the entry of a dialecte's engine worker, never imported by the page: a
+ * dialecte package's worker file calls `serveDialecteEngine({ dialecte })`, and its bundle carries the
+ * project engine whole (today SQLite on the origin's private file system, with sqlite-wasm and comlink;
+ * the consumer's one wasm file is handed to it at open). The page reaches that engine through
+ * `@dialecte/core`, which keeps the database out of the page's bundle.
+ */
+export { serveDialecteEngine } from './store/sqlite/runtime/serve-dialecte-engine';
+//# sourceMappingURL=engine.d.ts.map