@hydranium/core 1.0.0-next.29 → 1.0.0-next.298

package/README.md

@@ -1,40 +1,19 @@
 # `@hydranium/core`
 
-The framework runtime of [hydranium](../../README.md): the shared Langium
-workspace an adopter's modeling-language server is built from, plus the LSP
-textual head folded in at the `/lsp` subpath. Every adopter server installs it,
-and so does every other head package (`@hydranium/data-server`,
-`@hydranium/glsp-server`).
+The runtime of [Hydranium](https://github.com/eclipse-emfcloud/hydranium): the
+shared Langium workspace your language server is built from, plus the LSP head.
+Every Hydranium server installs it, and `@hydranium/data-server` and
+`@hydranium/glsp-server` build on it.
 
 ## What it gives you
 
-- **A composable services tree.** `createServerSharedModule` and
-  `createServerLanguageModule` supply the shared- and language-tier DI slots;
-  `bootstrapLangium` registers a language on the shared `ServiceRegistry`,
-  asserts the core slots are bound, and eager-constructs the services that must
-  exist before the first build.
-- **Semantics layered onto the AST** that an adopter would otherwise rewrite per
-  language: tiered scoping (`HydraniumScopeProvider`,
-  `ReferenceCandidateProvider`), qualified naming (`NameProvider`), computed and
-  synthetic properties (`AstExtensionService`), AST-integrity rules
-  (`IntegrityRule`, `IntegrityRuleRegistry`), batch build passes
-  (`BuildPhasePassService`), and a CST-residency memory policy
-  (`CstResidencyService`).
-- **A build pipeline you can hook by phase.** `HydraniumDocumentBuilder` and
-  `BuildPipelineIntegration` dispatch work at Langium `DocumentState` phases,
-  while the project tier (`ProjectManager`) discovers and groups documents.
-- **Multi-client document coordination.** `AstDocumentManager`,
-  `HydraniumTextDocuments`, `WritableFileSystemProvider` and `SelfSaveRegistry`
-  generalise the LSP document lifecycle to several co-editing heads, so an edit
-  made on one surface is observable on the others without a head-to-head
-  synchronisation protocol.
-- **The projection the non-LSP heads build on:** `ModelService` (the in-process
-  workspace facade), `TransferEncoder` (AST → transfer model), and the
-  `Serializer` slot.
-- **The LSP head at `./lsp`:** `startLanguageServer`,
-  `createLspServerSharedModule` / `createLspServerLanguageModule`,
-  `HydraniumCompletionProvider`, `HydraniumDocumentUpdateHandler`, and
-  `AbstractHydraniumSemanticTokenProvider`.
+- One call, `createIntegrationServices`, that composes your language's services
+  with Langium's defaults and the framework's.
+- Scoping, naming, validation and build hooks you extend per language, rather
+  than rewrite.
+- One workspace every head works on: an edit made through one head is seen by
+  the others.
+- The LSP head, and launchers that serve another head over stdio or a socket.
 
 ## Install
 
@@ -42,59 +21,63 @@ and so does every other head package (`@hydranium/data-server`,
 npm install @hydranium/core
 ```
 
-Nothing is bundled for you — the peers must be present in the consuming project:
-
-- `@hydranium/protocol` (the wire contract) and `@hydranium/langium` (the pinned
-  Langium re-export). Import Langium through `@hydranium/langium` so the whole
-  workspace resolves one physical copy of it.
-- `vscode-jsonrpc`, `vscode-languageserver`, `vscode-languageserver-protocol`,
-  `vscode-languageserver-textdocument`, `vscode-languageserver-types`.
-- `@playwright/test` — optional, and needed only for `./testing/playwright`.
-
-The single bundled runtime dependency is `diff`. You also need a Langium grammar
-and its generated AST already in place; `hydranium-cli init` scaffolds both.
-
-## Exports
-
-| subpath               | holds                                                                                                                                                                                                       | platform        |
-| --------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------- |
-| `.`                   | The head-neutral framework core: DI modules, AST semantics, build pipeline, model coordination.                                                                                                              | browser-neutral |
-| `./lsp`               | The LSP textual head — `startLanguageServer`, its two DI modules, and the Langium-LSP overrides.                                                                                                             | browser-neutral |
-| `./node`              | Server-only: `DefaultFileSystemProvider` / `NodeFileSystem`, `startStdioServer`, `startSocketServer`, `publishPortOnLspConnection`, and the headless tools `validateWorkspace` / `reflectGrammar` / `lintGrammar`. | Node-only       |
-| `./testing`           | Langium-layer doubles plus `makeTestServices` and `makeFakeDocument`.                                                                                                                                        | browser-neutral |
-| `./testing/node`      | Test support that needs a real filesystem, a stream transport or a child process: scratch workspace, golden corpus, `makeLspHarness`, `startSpawnedServer`.                                                  | Node-only       |
-| `./testing/playwright`| Playwright fixtures for end-to-end profiling and server-log capture.                                                                                                                                        | Node-only       |
-
-The browser-neutral entries are gated in CI (`scripts/check-neutral-bundles.mjs`
-bundles them for the browser and fails on a `node:*` import, including a
-transitive one) — see [what "gated neutral" does and does not promise](../../docs/concepts/browser-hosting.md#a-note-on-what-gated-neutral-does-and-does-not-promise).
-Each subpath also has a `./lib/…` twin, so a consumer on
-`moduleResolution: "Node"` can reach it.
-
-Importing `./node` has two deliberate side effects at module load: it installs
-the `node:fs`-backed log-file sink and the `node:async_hooks`-backed write-lock
-reentrancy check, both of which the neutral tree can only declare.
-
-## Getting oriented
-
-A server composes one shared services tree per process and one language module
-per grammar, then hands that tree to whichever heads it wants to run. The
-worked, compiling version of that composition is in the
-[repository README](../../README.md#compose-a-server--minimal-example); the
-layering behind it is described in
-[`docs/concepts/architecture.md`](../../docs/concepts/architecture.md), and
-[`docs/concepts/head-module-maps.md`](../../docs/concepts/head-module-maps.md) is
-the module-by-module map of this package. The class-role naming, the `./node`
-boundary and the registration-contribution pattern the services follow are in
-[`docs/contributing/conventions.md`](../../docs/contributing/conventions.md).
+| Peer                                 | Range         |
+| ------------------------------------ | ------------- |
+| `@hydranium/langium`                 | `^1.0.0-next` |
+| `@hydranium/protocol`                | `^1.0.0-next` |
+| `@playwright/test`                   | `^1.40.0`     |
+| `vscode-jsonrpc`                     | `^9.0.0`      |
+| `vscode-languageserver`              | `~10.0.1`     |
+| `vscode-languageserver-protocol`     | `~3.18.1`     |
+| `vscode-languageserver-textdocument` | `^1.0.12`     |
+| `vscode-languageserver-types`        | `^3.17.5`     |
+
+Import Langium through `@hydranium/langium`, so your project uses the same copy
+as the framework. `@playwright/test` is optional; only `./testing/playwright`
+needs it.
+
+## Wiring
+
+`hydranium-cli init` scaffolds a starter grammar and all of this wiring.
+
+1. Compose the services with `createIntegrationServices`, passing
+   `createLspServerSharedModule` and `createLspServerLanguageModule` as the
+   extra modules. Your language module binds a `Serializer`.
+2. Create the LSP connection with `withHydraniumLspFeatures`, and start it with
+   `startLanguageServer` from `./lsp`, not Langium's: it fails the start when
+   the LSP shared module is missing.
+3. Start other heads on the same shared services, with `startSocketServer` and
+   `publishPortOnLspConnection` beside the LSP head, or `startStdioServer`
+   alone.
+
+See *Compose a server by hand* and *Add a validation check* in
+[Adopting Hydranium](https://github.com/eclipse-emfcloud/hydranium/blob/main/docs/ADOPTING.md).
+
+## Entry points
+
+| Subpath                | Use it for                                                                   | Runs in         |
+| ---------------------- | ---------------------------------------------------------------------------- | --------------- |
+| `.`                    | Composing services and extending the language's semantics                    | browser-neutral |
+| `./lsp`                | The LSP head and its modules                                                 | browser-neutral |
+| `./browser`            | The IndexedDB store behind a persistent filesystem in a web worker           | browser-only    |
+| `./node`               | The Node filesystem, the stdio and socket launchers, the headless tools      | Node-only       |
+| `./messages`           | Validation messages with stable codes, and the codes this package raises     | browser-neutral |
+| `./testing`            | Parsing and service doubles for unit tests                                   | browser-neutral |
+| `./testing/node`       | Scratch workspaces, the LSP harness, a spawned server                        | Node-only       |
+| `./testing/playwright` | Playwright fixtures that capture the server log                              | Node-only       |
+
+The subpaths need a TypeScript `moduleResolution` that reads `exports`
+(`NodeNext` or `Bundler`); see *Requirements* in
+[Adopting Hydranium](https://github.com/eclipse-emfcloud/hydranium/blob/main/docs/ADOPTING.md).
 
 ## Status
 
-Alpha — pre-v0, not yet published. The API is not stable and may change without a
-deprecation cycle. See the [repository README](../../README.md) for the current
-status and known limitations.
+Alpha: every release is a prerelease that may break the API, so pin an exact
+version. Guides and known limitations:
+[Adopting Hydranium](https://github.com/eclipse-emfcloud/hydranium/blob/main/docs/ADOPTING.md).
 
 ## License
 
-`MIT` — see this package's [`LICENSE`](./LICENSE). Third-party notices for the
-repository are recorded in [`NOTICE.md`](../../NOTICE.md).
+`MIT` — see this package's [`LICENSE`](./LICENSE), and the repository
+[`NOTICE.md`](https://github.com/eclipse-emfcloud/hydranium/blob/main/NOTICE.md)
+for third-party notices.

package/lib/browser/index.d.ts

@@ -0,0 +1,10 @@
+/********************************************************************************
+ * Copyright (c) 2026 CrossBreeze, EclipseSource and others.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the MIT License which is available in the project root.
+ *
+ * SPDX-License-Identifier: MIT
+ ********************************************************************************/
+export * from './indexeddb-file-system-store.js';
+//# sourceMappingURL=index.d.ts.map

package/lib/browser/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/browser/index.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAMlF,cAAc,kCAAkC,CAAC"}

package/lib/browser/index.js

@@ -0,0 +1,14 @@
+/********************************************************************************
+ * Copyright (c) 2026 CrossBreeze, EclipseSource and others.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the MIT License which is available in the project root.
+ *
+ * SPDX-License-Identifier: MIT
+ ********************************************************************************/
+// Worker-only entry (`@hydranium/core/browser`). Compiled as its own project
+// against `lib.webworker`, so a worker global such as `indexedDB` resolves here
+// and nowhere else in the package: the portable `.` barrel must stay free of
+// DOM and worker globals, since it also loads in a plain Node consumer.
+export * from './indexeddb-file-system-store.js';
+//# sourceMappingURL=index.js.map

package/lib/browser/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/browser/index.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,6EAA6E;AAC7E,gFAAgF;AAChF,6EAA6E;AAC7E,wEAAwE;AACxE,cAAc,kCAAkC,CAAC"}

package/lib/browser/indexeddb-file-system-store.d.ts

@@ -0,0 +1,82 @@
+/********************************************************************************
+ * Copyright (c) 2026 CrossBreeze, EclipseSource and others.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the MIT License which is available in the project root.
+ *
+ * SPDX-License-Identifier: MIT
+ ********************************************************************************/
+import type { FileSystemSeed } from '../langium/workspace/in-memory-file-system-provider.js';
+import type { FileSystemStore } from '../langium/workspace/persistent-file-system-provider.js';
+/**
+ * A {@link FileSystemStore} in `IndexedDB`, so an edit survives a reload.
+ *
+ * # Why IndexedDB and not OPFS
+ *
+ * OPFS is the tempting answer, because `createSyncAccessHandle` gives
+ * SYNCHRONOUS file reads in a worker, which is what Langium's
+ * `FileSystemProvider` needs. It buys nothing here: directory enumeration
+ * (`FileSystemDirectoryHandle.entries()`) is async-only, so a directory index
+ * still has to live in memory, and once it does the file reads are being served
+ * from memory too. IndexedDB is the smaller dependency for the same shape.
+ *
+ * # It holds the DELTA, not the workspace
+ *
+ * Only what has been written lands here, and `PersistentFileSystemProvider` lays
+ * it over the host's seed. So a fixture edited in the host's bundle still
+ * reaches a returning visitor, and this database stays a few kilobytes rather
+ * than a copy of the workspace.
+ *
+ * # A failure is loud, deliberately
+ *
+ * Nothing here degrades to non-persistent operation. A refused open, a blocked
+ * upgrade or an aborted transaction, which is what a quota overrun looks like,
+ * rejects the call, which fails the worker's bootstrap or the save that asked.
+ * The alternative, carrying on without a store, would report a saved workspace
+ * and lose it on the next load. An origin EVICTED between visits is not a
+ * failure this class can see: its database opens empty, which is a first visit,
+ * and the provider is correct in that state. Evicted mid-session, the next
+ * transaction rejects like any other failure.
+ *
+ * # The database is origin-scoped
+ *
+ * Every page on the origin shares a database of the same name, and the user
+ * agent may evict it. The name is the one per-app value and is REQUIRED for
+ * that reason: a default would let two apps on one origin overwrite each
+ * other's edits with nothing reporting it.
+ */
+export declare class IndexedDbFileSystemStore implements FileSystemStore {
+    protected readonly databaseName: string;
+    /**
+     * Opened once and shared, and NOT kept when it fails: a refused or blocked
+     * open rejects the call that needed it and the next call opens again, so a
+     * cause that has cleared, such as the other tab closing, does not fail every
+     * later save with the first error.
+     */
+    protected connection?: Promise<IDBDatabase>;
+    constructor(databaseName: string);
+    load(): Promise<FileSystemSeed>;
+    write(path: string, content: string): Promise<void>;
+    remove(path: string): Promise<void>;
+    /**
+     * Drop everything, returning the next load to the seed.
+     *
+     * The escape hatch a persistent host needs and a seeded one does not: a saved
+     * document that no longer parses is otherwise restored on every load, and
+     * clearing site data is the only other way out. Not on {@link FileSystemStore},
+     * which the provider never clears.
+     */
+    clear(): Promise<void>;
+    /**
+     * Run one write transaction and settle on its COMPLETION.
+     *
+     * Not on the request's `success`: a request can succeed inside a transaction
+     * that then aborts, which is exactly what a quota overrun looks like, so
+     * resolving early would report a save the database never kept.
+     */
+    protected mutate(operation: string, act: (files: IDBObjectStore) => void): Promise<void>;
+    protected open(): Promise<IDBDatabase>;
+    protected openDatabase(): Promise<IDBDatabase>;
+    protected failure(transaction: IDBTransaction, operation: string): Error;
+}
+//# sourceMappingURL=indexeddb-file-system-store.d.ts.map

package/lib/browser/indexeddb-file-system-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexeddb-file-system-store.d.ts","sourceRoot":"","sources":["../../src/browser/indexeddb-file-system-store.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wDAAwD,CAAC;AAC7F,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yDAAyD,CAAC;AAW/F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,qBAAa,wBAAyB,YAAW,eAAe;IASjD,SAAS,CAAC,QAAQ,CAAC,YAAY,EAAE,MAAM;IARnD;;;;;OAKG;IACH,SAAS,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IAE5C,YAA+B,YAAY,EAAE,MAAM,EAAI;IAEjD,IAAI,IAAI,OAAO,CAAC,cAAc,CAAC,CA2BpC;IAEK,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAExD;IAEK,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAExC;IAED;;;;;;;OAOG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAE3B;IAED;;;;;;OAMG;IACH,UAAgB,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAQ7F;IAED,SAAS,CAAC,IAAI,IAAI,OAAO,CAAC,WAAW,CAAC,CAMrC;IAED,SAAS,CAAC,YAAY,IAAI,OAAO,CAAC,WAAW,CAAC,CAwC7C;IAED,SAAS,CAAC,OAAO,CAAC,WAAW,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,GAAG,KAAK,CAKvE;CACH"}

package/lib/browser/indexeddb-file-system-store.js

@@ -0,0 +1,181 @@
+/********************************************************************************
+ * Copyright (c) 2026 CrossBreeze, EclipseSource and others.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the MIT License which is available in the project root.
+ *
+ * SPDX-License-Identifier: MIT
+ ********************************************************************************/
+/** Out-of-line keys, so a key is the store path and the value is the content. */
+const OBJECT_STORE_NAME = 'files';
+/**
+ * The schema version. A bump needs a migration in `onupgradeneeded`, or every
+ * returning visitor's rows are left in a store the new code never reads.
+ */
+const DATABASE_VERSION = 1;
+/**
+ * A {@link FileSystemStore} in `IndexedDB`, so an edit survives a reload.
+ *
+ * # Why IndexedDB and not OPFS
+ *
+ * OPFS is the tempting answer, because `createSyncAccessHandle` gives
+ * SYNCHRONOUS file reads in a worker, which is what Langium's
+ * `FileSystemProvider` needs. It buys nothing here: directory enumeration
+ * (`FileSystemDirectoryHandle.entries()`) is async-only, so a directory index
+ * still has to live in memory, and once it does the file reads are being served
+ * from memory too. IndexedDB is the smaller dependency for the same shape.
+ *
+ * # It holds the DELTA, not the workspace
+ *
+ * Only what has been written lands here, and `PersistentFileSystemProvider` lays
+ * it over the host's seed. So a fixture edited in the host's bundle still
+ * reaches a returning visitor, and this database stays a few kilobytes rather
+ * than a copy of the workspace.
+ *
+ * # A failure is loud, deliberately
+ *
+ * Nothing here degrades to non-persistent operation. A refused open, a blocked
+ * upgrade or an aborted transaction, which is what a quota overrun looks like,
+ * rejects the call, which fails the worker's bootstrap or the save that asked.
+ * The alternative, carrying on without a store, would report a saved workspace
+ * and lose it on the next load. An origin EVICTED between visits is not a
+ * failure this class can see: its database opens empty, which is a first visit,
+ * and the provider is correct in that state. Evicted mid-session, the next
+ * transaction rejects like any other failure.
+ *
+ * # The database is origin-scoped
+ *
+ * Every page on the origin shares a database of the same name, and the user
+ * agent may evict it. The name is the one per-app value and is REQUIRED for
+ * that reason: a default would let two apps on one origin overwrite each
+ * other's edits with nothing reporting it.
+ */
+export class IndexedDbFileSystemStore {
+    databaseName;
+    /**
+     * Opened once and shared, and NOT kept when it fails: a refused or blocked
+     * open rejects the call that needed it and the next call opens again, so a
+     * cause that has cleared, such as the other tab closing, does not fail every
+     * later save with the first error.
+     */
+    connection;
+    constructor(databaseName) {
+        this.databaseName = databaseName;
+    }
+    async load() {
+        const database = await this.open();
+        return new Promise((resolve, reject) => {
+            const transaction = database.transaction(OBJECT_STORE_NAME, 'readonly');
+            const files = transaction.objectStore(OBJECT_STORE_NAME);
+            const keyRequest = files.getAllKeys();
+            const valueRequest = files.getAll();
+            // Resolved on the TRANSACTION rather than on either request, which is
+            // what guarantees both have landed, and `getAllKeys` and `getAll`
+            // enumerate in the same key order, so they zip.
+            transaction.oncomplete = () => {
+                const keys = keyRequest.result;
+                const values = valueRequest.result;
+                const seed = {};
+                keys.forEach((key, index) => {
+                    const value = values[index];
+                    // Guarded rather than cast: this database outlives the code that
+                    // wrote it, so a row from an older shape must be skipped instead
+                    // of reaching the filesystem as non-string content.
+                    if (typeof key === 'string' && typeof value === 'string') {
+                        seed[key] = value;
+                    }
+                });
+                resolve(seed);
+            };
+            transaction.onabort = () => reject(this.failure(transaction, 'read the stored workspace'));
+        });
+    }
+    async write(path, content) {
+        await this.mutate('store', files => files.put(content, path));
+    }
+    async remove(path) {
+        await this.mutate('drop', files => files.delete(path));
+    }
+    /**
+     * Drop everything, returning the next load to the seed.
+     *
+     * The escape hatch a persistent host needs and a seeded one does not: a saved
+     * document that no longer parses is otherwise restored on every load, and
+     * clearing site data is the only other way out. Not on {@link FileSystemStore},
+     * which the provider never clears.
+     */
+    async clear() {
+        await this.mutate('clear', files => files.clear());
+    }
+    /**
+     * Run one write transaction and settle on its COMPLETION.
+     *
+     * Not on the request's `success`: a request can succeed inside a transaction
+     * that then aborts, which is exactly what a quota overrun looks like, so
+     * resolving early would report a save the database never kept.
+     */
+    async mutate(operation, act) {
+        const database = await this.open();
+        return new Promise((resolve, reject) => {
+            const transaction = database.transaction(OBJECT_STORE_NAME, 'readwrite');
+            transaction.oncomplete = () => resolve();
+            transaction.onabort = () => reject(this.failure(transaction, operation));
+            act(transaction.objectStore(OBJECT_STORE_NAME));
+        });
+    }
+    open() {
+        this.connection ??= this.openDatabase().catch((error) => {
+            this.connection = undefined;
+            throw error;
+        });
+        return this.connection;
+    }
+    openDatabase() {
+        return new Promise((resolve, reject) => {
+            const request = indexedDB.open(this.databaseName, DATABASE_VERSION);
+            let blocked = false;
+            request.onupgradeneeded = () => {
+                // Runs on a first visit and on a version bump. `createObjectStore`
+                // throws if it already exists, so the guard is not defensive: a page
+                // opened twice with the store created once gets here only when the
+                // version moved.
+                if (!request.result.objectStoreNames.contains(OBJECT_STORE_NAME)) {
+                    request.result.createObjectStore(OBJECT_STORE_NAME);
+                }
+            };
+            request.onsuccess = () => {
+                const database = request.result;
+                if (blocked) {
+                    // Went through once the other tab closed, after this call had
+                    // rejected. Nobody holds it, so it is closed rather than left
+                    // open to block the NEXT upgrade.
+                    database.close();
+                    return;
+                }
+                // A newer version opening in another tab asks this one to let go,
+                // and holding on would block that upgrade for as long as this tab
+                // lives. Dropped, so every later call here rejects, which is loud.
+                database.onversionchange = () => {
+                    database.close();
+                    this.connection = undefined;
+                };
+                resolve(database);
+            };
+            request.onerror = () => reject(request.error ?? new Error(`Cannot open ${this.databaseName}`));
+            // A tab at an older version that lacks the close above holds the
+            // upgrade indefinitely. Reported rather than waited on: the host can say
+            // so, where a hung open looks like a worker that never started.
+            request.onblocked = () => {
+                blocked = true;
+                reject(new Error(`${this.databaseName} is open in another tab at an older version`));
+            };
+        });
+    }
+    failure(transaction, operation) {
+        // `transaction.error` names the real cause (`QuotaExceededError` above
+        // all); an abort with no error is a caller-side abort, which nothing here
+        // does.
+        return transaction.error ?? new Error(`Failed to ${operation} in ${this.databaseName}`);
+    }
+}
+//# sourceMappingURL=indexeddb-file-system-store.js.map

package/lib/browser/indexeddb-file-system-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexeddb-file-system-store.js","sourceRoot":"","sources":["../../src/browser/indexeddb-file-system-store.ts"],"names":[],"mappings":"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"}