sh3-core 0.20.1 → 0.20.3

package/dist/BrandSlot.svelte

@@ -13,7 +13,7 @@
   import { getLiveDispatcherState } from './actions/state.svelte';
   import { launchApp, returnToHome } from './apps/lifecycle';
   import { getBreadcrumbAppId, getRegisteredApp } from './apps/registry.svelte';
-  import { sessionState, setActiveProjectId } from './projects/session-state.svelte';
+  import { sessionState, switchProjectScope } from './projects/session-state.svelte';
   import { projectsState } from './projects-shard/projectsShard.svelte';
 
   const activeAppId = $derived(getLiveDispatcherState().activeAppId);
@@ -48,7 +48,7 @@
   }
 
   function exitProject() {
-    setActiveProjectId(null);
+    switchProjectScope(null);
   }
 
   function reenterProjectHome() {

package/dist/actions/ctx-actions.svelte.test.js

@@ -1,6 +1,6 @@
 import { describe, it, expect, beforeEach } from 'vitest';
 import { MemoryDocumentBackend } from '../documents/backends';
-import { __setDocumentBackend, __setTenantId } from '../documents/config';
+import { __setDocumentBackend, __setActiveScope } from '../documents/config';
 import { registerShard, activateShard, __resetShardRegistryForTest, } from '../shards/activate.svelte';
 import { __resetViewRegistryForTest } from '../shards/registry';
 import { __resetActionsRegistryForTest } from './registry';
@@ -14,7 +14,7 @@ describe('ShardContext.listActions / runAction (integration)', () => {
         __resetActionsRegistryForTest();
         __resetDispatcherStateForTest();
         __setDocumentBackend(new MemoryDocumentBackend());
-        __setTenantId('tenant-test');
+        __setActiveScope('tenant-test');
     });
     it('listActions enumerates actions registered by other shards', async () => {
         registerShard({

package/dist/artifact.d.ts

@@ -29,4 +29,6 @@ export interface ArtifactManifest {
         id: string;
         versionRange: string;
     }>;
+    /** Shard ids this app requires to be installed on the server. Written by sh3Artifact for app/combo bundles. */
+    requiredShards?: string[];
 }

package/dist/boot/satellitePayload.d.ts

@@ -8,10 +8,12 @@ export type SatellitePayload = {
         h: number;
     };
     activateShards: string[];
+    projectId?: string;
 } | {
     kind: 'app';
     appId: string;
     activateShards: string[];
+    projectId?: string;
 };
 export declare function encodePayload(payload: SatellitePayload): string;
 export declare function decodePayload(encoded: string): SatellitePayload;

package/dist/boot/satellitePayload.test.js

@@ -36,6 +36,25 @@ describe('satellite payload encode/decode', () => {
         const bad = btoa(JSON.stringify({ kind: 'mystery' }));
         expect(() => decodePayload(bad)).toThrow();
     });
+    it('round-trips a float payload with projectId', () => {
+        const payload = {
+            kind: 'float',
+            content: { type: 'slot', slotId: 's:1', viewId: 'foo:bar' },
+            size: { w: 800, h: 600 },
+            activateShards: ['foo'],
+            projectId: 'proj-abc',
+        };
+        expect(decodePayload(encodePayload(payload))).toEqual(payload);
+    });
+    it('round-trips an app payload with projectId', () => {
+        const payload = {
+            kind: 'app',
+            appId: 'sh3-store',
+            activateShards: ['sh3-core'],
+            projectId: 'proj-xyz',
+        };
+        expect(decodePayload(encodePayload(payload))).toEqual(payload);
+    });
     it('produces a URL-safe encoding (no + / =)', () => {
         // A long-ish payload increases the chance the underlying base64
         // would contain non-URL-safe characters from the standard alphabet.

package/dist/build.d.ts

@@ -70,10 +70,16 @@ export declare function composeArtifactVersion(pkgVersion: string, suffix: strin
  * After Vite's lib build completes, this plugin:
  *   1. Finds the entry chunk and renames it to client.js
  *   2. Optionally copies a pre-built server bundle as server.js
- *   3. Extracts manifest fields (id, label, type) from the source
+ *   3. Extracts manifest fields (id, label, type, requiredShards) from the source
  *   4. Reads `version` from `package.json.version` — the authoritative
  *      source per ADR-013. A literal `version:` in a source manifest is
  *      ignored; only `package.json.version` matters for the artifact.
  *   5. Writes manifest.json alongside the bundles
  */
+/**
+ * Extract the requiredShards array from a bundled source string.
+ * Finds the first `requiredShards: [...]` array literal and parses its string IDs.
+ * Exported for testing; used internally by sh3Artifact.
+ */
+export declare function extractRequiredShardsFromBundle(bundleSource: string): string[];
 export declare function sh3Artifact(options?: Sh3ArtifactOptions): Plugin;

package/dist/build.js

@@ -136,12 +136,28 @@ function resolveAutoBuildSuffix() {
  * After Vite's lib build completes, this plugin:
  *   1. Finds the entry chunk and renames it to client.js
  *   2. Optionally copies a pre-built server bundle as server.js
- *   3. Extracts manifest fields (id, label, type) from the source
+ *   3. Extracts manifest fields (id, label, type, requiredShards) from the source
  *   4. Reads `version` from `package.json.version` — the authoritative
  *      source per ADR-013. A literal `version:` in a source manifest is
  *      ignored; only `package.json.version` matters for the artifact.
  *   5. Writes manifest.json alongside the bundles
  */
+/**
+ * Extract the requiredShards array from a bundled source string.
+ * Finds the first `requiredShards: [...]` array literal and parses its string IDs.
+ * Exported for testing; used internally by sh3Artifact.
+ */
+export function extractRequiredShardsFromBundle(bundleSource) {
+    const arrayMatch = bundleSource.match(/\brequiredShards\s*:\s*\[([^\]]*)\]/);
+    if (!arrayMatch)
+        return [];
+    const ids = [];
+    const idRe = /["']([^"']+)["']/g;
+    let m;
+    while ((m = idRe.exec(arrayMatch[1])) !== null)
+        ids.push(m[1]);
+    return ids;
+}
 export function sh3Artifact(options = {}) {
     let outDir = '';
     let entryFileName = '';
@@ -238,14 +254,17 @@ export function sh3Artifact(options = {}) {
                     const m = block.match(pattern);
                     return m ? m[1] : '';
                 };
+                // Extract the requiredShards string-id array from the app manifest block.
+                const requiredShards = extractRequiredShardsFromBundle(block);
                 return {
                     id: get(/\bid\s*:\s*["']([^"']+)["']/),
                     label: get(/\blabel\s*:\s*["']([^"']+)["']/),
+                    requiredShards,
                 };
             }
             // App first, then Shard.
             const extracted = (_a = extractFromBlock(/\brequiredShards\s*:\s*\[/)) !== null && _a !== void 0 ? _a : extractFromBlock(/\bviews\s*:\s*\[/);
-            const { id, label } = extracted;
+            const { id, label, requiredShards } = extracted;
             // --- Optional server bundle ---
             let hasServer = false;
             if (options.serverEntry && existsSync(options.serverEntry)) {
@@ -292,7 +311,7 @@ export function sh3Artifact(options = {}) {
             if (!finalAuthor) {
                 throw new Error('[sh3-artifact] Missing "author". Add it to package.json or pass it via sh3Artifact({ manifest: { author } }).');
             }
-            const manifest = Object.assign(Object.assign(Object.assign({ id: id || 'unknown', type, label: label || id || 'unknown', version: artifactVersion, contractVersion: 1, client: 'client.js' }, (hasServer ? { server: 'server.js' } : {})), { description: finalDescription, author: finalAuthor }), overrides);
+            const manifest = Object.assign(Object.assign(Object.assign(Object.assign({ id: id || 'unknown', type, label: label || id || 'unknown', version: artifactVersion, contractVersion: 1, client: 'client.js' }, (hasServer ? { server: 'server.js' } : {})), { description: finalDescription, author: finalAuthor }), ((type === 'app' || type === 'combo') ? { requiredShards } : {})), overrides);
             writeFileSync(join(outDir, 'manifest.json'), JSON.stringify(manifest, null, 2) + '\n');
             // --- Log summary ---
             const files = ['manifest.json', 'client.js'];

package/dist/build.test.js

@@ -1,5 +1,5 @@
 import { describe, it, expect } from 'vitest';
-import { composeArtifactVersion } from './build';
+import { composeArtifactVersion, extractRequiredShardsFromBundle } from './build';
 describe('composeArtifactVersion', () => {
     it('returns pkgVersion unchanged when suffix is undefined', () => {
         expect(composeArtifactVersion('1.2.3', undefined)).toBe('1.2.3');
@@ -29,3 +29,29 @@ describe('composeArtifactVersion', () => {
         expect(() => composeArtifactVersion('1.2.3', '+42')).toThrow(/not a valid semver build-metadata identifier/);
     });
 });
+describe('extractRequiredShardsFromBundle', () => {
+    it('extracts a single shard id', () => {
+        const src = `const App = { manifest: { id: "my-app", requiredShards: ["guml.core"] } };`;
+        expect(extractRequiredShardsFromBundle(src)).toEqual(['guml.core']);
+    });
+    it('extracts multiple shard ids', () => {
+        const src = `requiredShards: ["guml.core", "sh3-file-explorer", "some-other"]`;
+        expect(extractRequiredShardsFromBundle(src)).toEqual(['guml.core', 'sh3-file-explorer', 'some-other']);
+    });
+    it('handles single-quoted ids', () => {
+        const src = `requiredShards: ['guml.core', 'sh3-files']`;
+        expect(extractRequiredShardsFromBundle(src)).toEqual(['guml.core', 'sh3-files']);
+    });
+    it('returns empty array when requiredShards is not present', () => {
+        const src = `const Shard = { manifest: { id: "my-shard", views: [] } };`;
+        expect(extractRequiredShardsFromBundle(src)).toEqual([]);
+    });
+    it('returns empty array when requiredShards is empty', () => {
+        const src = `requiredShards: []`;
+        expect(extractRequiredShardsFromBundle(src)).toEqual([]);
+    });
+    it('handles minified format without spaces', () => {
+        const src = `{id:"my-app",requiredShards:["guml.core","other-shard"]}`;
+        expect(extractRequiredShardsFromBundle(src)).toEqual(['guml.core', 'other-shard']);
+    });
+});

package/dist/createShell.js

@@ -22,11 +22,33 @@ import { registerLoadedBundle } from './registry/register';
 import { attachGlobalListeners } from './actions/listeners';
 import { detectSatelliteMode } from './boot/satelliteMode';
 import { MemoryBackend } from './state/backends';
-import { sessionState } from './projects/session-state.svelte';
+import { sessionState, readPendingScope, PENDING_SCOPE_KEY } from './projects/session-state.svelte';
 import SatelliteShell from './satellite/SatelliteShell.svelte';
 export async function createShell(config) {
     var _a, _b;
     const sUrl = (_a = config === null || config === void 0 ? void 0 : config.serverUrl) !== null && _a !== void 0 ? _a : '';
+    // 0. Restore pending project scope from a reload-triggered scope switch.
+    //    Written before the previous page reload by switchProjectScope(); must
+    //    be set before bootstrap() so shards activate with the correct scope.
+    const pendingProjectId = readPendingScope();
+    if (pendingProjectId !== null) {
+        sessionState.activeProjectId = pendingProjectId;
+    }
+    // Read ?project= injected by Tauri's --project CLI arg (or any deep-link URL).
+    // Guard against overriding an in-session scope switch that wrote to sessionStorage.
+    if (typeof window !== 'undefined' && pendingProjectId === null) {
+        const urlProject = new URLSearchParams(window.location.search).get('project');
+        if (urlProject) {
+            // Mirror switchProjectScope's sessionStorage write so subsequent reloads
+            // within this tab re-enter the same project (readPendingScope will pick it up).
+            sessionStorage.setItem(PENDING_SCOPE_KEY, JSON.stringify({ projectId: urlProject }));
+            sessionState.activeProjectId = urlProject;
+            // Strip the param so it doesn't linger in bookmarks or history.
+            const cleanUrl = new URL(window.location.href);
+            cleanUrl.searchParams.delete('project');
+            history.replaceState(null, '', cleanUrl.toString());
+        }
+    }
     // 1. Platform detection
     const platform = await resolvePlatform();
     if (platform.backends) {
@@ -60,6 +82,11 @@ export async function createShell(config) {
         // but pop-out is currently a Tauri-only POC so we don't fetch it.
         if (platform.localOwner)
             __setActiveScope('local');
+        // Inherit the host's active project scope so shard activation lands in the
+        // correct tenant (satellite opens in the same project context as the host).
+        if (satellite.payload.projectId) {
+            sessionState.activeProjectId = satellite.payload.projectId;
+        }
         __setScopeResolver(() => sessionState.activeProjectId);
         __setShardScopeResolver(() => sessionState.activeProjectId ? 'project' : 'tenant');
         if (config === null || config === void 0 ? void 0 : config.shards)
@@ -138,19 +165,17 @@ export async function createShell(config) {
         for (const app of config.apps)
             registerApp(app);
     }
-    // 7. Bootstrap
+    // 7. Wire scope resolvers before bootstrap so shards activate in the correct scope.
+    __setScopeResolver(() => sessionState.activeProjectId);
+    __setShardScopeResolver(() => sessionState.activeProjectId ? 'project' : 'tenant');
+    // 8. Bootstrap
     const bootstrapConfig = {};
     if (config === null || config === void 0 ? void 0 : config.excludeShards)
         bootstrapConfig.excludeShards = config.excludeShards;
     await bootstrap(bootstrapConfig);
-    // 7b. Wire the document zone's scope resolver to the active project.
-    // When the user enters a project, getActiveScopeId() returns the project
-    // id so all document operations use the project's virtual tenant.
-    __setScopeResolver(() => sessionState.activeProjectId);
-    __setShardScopeResolver(() => sessionState.activeProjectId ? 'project' : 'tenant');
-    // 8. Attach document-level keyboard / focus listeners
+    // 9. Attach document-level keyboard / focus listeners
     attachGlobalListeners();
-    // 9. Mount the sh3
+    // 10. Mount the sh3
     mount(Sh3, { target });
 }
 /**

package/dist/documents/backends.d.ts

@@ -13,6 +13,12 @@ export declare class MemoryDocumentBackend implements DocumentBackend {
         shardId: string;
     }>>;
     readMeta(tenantId: string, shardId: string, path: string): Promise<DocStatus | null>;
+    mkdir(tenantId: string, shardId: string, path: string): Promise<void>;
+    rmdir(tenantId: string, shardId: string, path: string, opts: {
+        recursive: boolean;
+    }): Promise<void>;
+    renameFolder(tenantId: string, shardId: string, oldPath: string, newPath: string): Promise<void>;
+    listFolders(tenantId: string, shardId: string, prefix: string): Promise<string[]>;
 }
 export declare class IndexedDBDocumentBackend implements DocumentBackend {
     #private;
@@ -26,4 +32,10 @@ export declare class IndexedDBDocumentBackend implements DocumentBackend {
     listAllDocuments(tenantId: string): Promise<Array<DocumentMeta & {
         shardId: string;
     }>>;
+    mkdir(tenantId: string, shardId: string, path: string): Promise<void>;
+    rmdir(tenantId: string, shardId: string, path: string, opts: {
+        recursive: boolean;
+    }): Promise<void>;
+    renameFolder(tenantId: string, shardId: string, oldPath: string, newPath: string): Promise<void>;
+    listFolders(tenantId: string, shardId: string, prefix: string): Promise<string[]>;
 }

package/dist/documents/backends.js

@@ -16,7 +16,7 @@ var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (
     if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
     return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
 };
-var _MemoryDocumentBackend_store, _IndexedDBDocumentBackend_instances, _IndexedDBDocumentBackend_dbPromise, _IndexedDBDocumentBackend_db, _IndexedDBDocumentBackend_tx;
+var _MemoryDocumentBackend_store, _MemoryDocumentBackend_folders, _IndexedDBDocumentBackend_instances, _IndexedDBDocumentBackend_dbPromise, _IndexedDBDocumentBackend_db, _IndexedDBDocumentBackend_tx, _IndexedDBDocumentBackend_txOn;
 // ---------------------------------------------------------------------------
 // Helpers
 // ---------------------------------------------------------------------------
@@ -29,6 +29,7 @@ function keyPrefix(tenantId, shardId) {
 export class MemoryDocumentBackend {
     constructor() {
         _MemoryDocumentBackend_store.set(this, new Map());
+        _MemoryDocumentBackend_folders.set(this, new Set()); // composite keys: `${tenant}/${shard}/${path}`
     }
     async read(tenantId, shardId, path) {
         const entry = __classPrivateFieldGet(this, _MemoryDocumentBackend_store, "f").get(compositeKey(tenantId, shardId, path));
@@ -111,14 +112,111 @@ export class MemoryDocumentBackend {
             return null;
         return { exists: true, version: 1, syncMode: 'sync', syncState: 'synced' };
     }
+    async mkdir(tenantId, shardId, path) {
+        if (__classPrivateFieldGet(this, _MemoryDocumentBackend_store, "f").has(compositeKey(tenantId, shardId, path))) {
+            throw new Error(`Cannot mkdir ${path}: a document occupies this path`);
+        }
+        __classPrivateFieldGet(this, _MemoryDocumentBackend_folders, "f").add(compositeKey(tenantId, shardId, path));
+    }
+    async rmdir(tenantId, shardId, path, opts) {
+        const folderKey = compositeKey(tenantId, shardId, path);
+        const docPrefix = folderKey + '/';
+        const docDescendants = [];
+        const folderDescendants = [];
+        for (const key of __classPrivateFieldGet(this, _MemoryDocumentBackend_store, "f").keys()) {
+            if (key.startsWith(docPrefix))
+                docDescendants.push(key);
+        }
+        for (const key of __classPrivateFieldGet(this, _MemoryDocumentBackend_folders, "f")) {
+            if (key === folderKey)
+                continue;
+            if (key.startsWith(docPrefix))
+                folderDescendants.push(key);
+        }
+        if (!opts.recursive && (docDescendants.length > 0 || folderDescendants.length > 0)) {
+            throw new Error(`Cannot rmdir ${path}: folder is not empty`);
+        }
+        for (const k of docDescendants)
+            __classPrivateFieldGet(this, _MemoryDocumentBackend_store, "f").delete(k);
+        for (const k of folderDescendants)
+            __classPrivateFieldGet(this, _MemoryDocumentBackend_folders, "f").delete(k);
+        __classPrivateFieldGet(this, _MemoryDocumentBackend_folders, "f").delete(folderKey);
+    }
+    async renameFolder(tenantId, shardId, oldPath, newPath) {
+        const oldFolderKey = compositeKey(tenantId, shardId, oldPath);
+        const newFolderKey = compositeKey(tenantId, shardId, newPath);
+        const oldDocPrefix = oldFolderKey + '/';
+        const oldHasExplicit = __classPrivateFieldGet(this, _MemoryDocumentBackend_folders, "f").has(oldFolderKey);
+        const oldHasImplicit = [...__classPrivateFieldGet(this, _MemoryDocumentBackend_store, "f").keys()].some((k) => k.startsWith(oldDocPrefix)) ||
+            [...__classPrivateFieldGet(this, _MemoryDocumentBackend_folders, "f")].some((k) => k.startsWith(oldDocPrefix));
+        if (!oldHasExplicit && !oldHasImplicit) {
+            throw new Error(`Cannot rename folder ${oldPath}: does not exist`);
+        }
+        const newDocPrefix = newFolderKey + '/';
+        const newHasExplicit = __classPrivateFieldGet(this, _MemoryDocumentBackend_folders, "f").has(newFolderKey);
+        const newHasImplicit = [...__classPrivateFieldGet(this, _MemoryDocumentBackend_store, "f").keys()].some((k) => k.startsWith(newDocPrefix)) ||
+            [...__classPrivateFieldGet(this, _MemoryDocumentBackend_folders, "f")].some((k) => k.startsWith(newDocPrefix));
+        if (newHasExplicit || newHasImplicit) {
+            throw new Error(`Cannot rename folder to ${newPath}: already exists`);
+        }
+        // Rewrite docs
+        const docMoves = [];
+        for (const [key, entry] of __classPrivateFieldGet(this, _MemoryDocumentBackend_store, "f")) {
+            if (key.startsWith(oldDocPrefix)) {
+                const rewritten = newFolderKey + '/' + key.slice(oldDocPrefix.length);
+                docMoves.push([key, rewritten, entry]);
+            }
+        }
+        for (const [oldKey, newKey, entry] of docMoves) {
+            __classPrivateFieldGet(this, _MemoryDocumentBackend_store, "f").delete(oldKey);
+            __classPrivateFieldGet(this, _MemoryDocumentBackend_store, "f").set(newKey, Object.assign(Object.assign({}, entry), { lastModified: Date.now() }));
+        }
+        // Rewrite folders
+        const folderMoves = [];
+        for (const key of __classPrivateFieldGet(this, _MemoryDocumentBackend_folders, "f")) {
+            if (key === oldFolderKey) {
+                folderMoves.push([key, newFolderKey]);
+            }
+            else if (key.startsWith(oldDocPrefix)) {
+                folderMoves.push([key, newFolderKey + '/' + key.slice(oldDocPrefix.length)]);
+            }
+        }
+        for (const [oldKey, newKey] of folderMoves) {
+            __classPrivateFieldGet(this, _MemoryDocumentBackend_folders, "f").delete(oldKey);
+            __classPrivateFieldGet(this, _MemoryDocumentBackend_folders, "f").add(newKey);
+        }
+    }
+    async listFolders(tenantId, shardId, prefix) {
+        const basePrefix = prefix
+            ? compositeKey(tenantId, shardId, prefix) + '/'
+            : keyPrefix(tenantId, shardId);
+        const out = new Set();
+        for (const key of __classPrivateFieldGet(this, _MemoryDocumentBackend_folders, "f")) {
+            if (!key.startsWith(basePrefix))
+                continue;
+            const rest = key.slice(basePrefix.length);
+            const slash = rest.indexOf('/');
+            out.add(slash >= 0 ? rest.slice(0, slash) : rest);
+        }
+        for (const key of __classPrivateFieldGet(this, _MemoryDocumentBackend_store, "f").keys()) {
+            if (!key.startsWith(basePrefix))
+                continue;
+            const rest = key.slice(basePrefix.length);
+            const slash = rest.indexOf('/');
+            if (slash >= 0)
+                out.add(rest.slice(0, slash));
+        }
+        return [...out].sort();
+    }
 }
-_MemoryDocumentBackend_store = new WeakMap();
+_MemoryDocumentBackend_store = new WeakMap(), _MemoryDocumentBackend_folders = new WeakMap();
 // ---------------------------------------------------------------------------
 // IndexedDBDocumentBackend
 // ---------------------------------------------------------------------------
 const IDB_NAME = 'sh3-documents';
 const IDB_STORE = 'docs';
-const IDB_VERSION = 2;
+const IDB_FOLDERS = 'folders';
+const IDB_VERSION = 3;
 export class IndexedDBDocumentBackend {
     constructor() {
         _IndexedDBDocumentBackend_instances.add(this);
@@ -274,6 +372,123 @@ export class IndexedDBDocumentBackend {
             req.onerror = () => reject(req.error);
         });
     }
+    async mkdir(tenantId, shardId, path) {
+        const docKey = compositeKey(tenantId, shardId, path);
+        const exists = await __classPrivateFieldGet(this, _IndexedDBDocumentBackend_instances, "m", _IndexedDBDocumentBackend_tx).call(this, 'readonly', (s) => s.getKey(docKey));
+        if (exists !== undefined) {
+            throw new Error(`Cannot mkdir ${path}: a document occupies this path`);
+        }
+        await __classPrivateFieldGet(this, _IndexedDBDocumentBackend_instances, "m", _IndexedDBDocumentBackend_txOn).call(this, IDB_FOLDERS, 'readwrite', (s) => s.put(1, docKey));
+    }
+    async rmdir(tenantId, shardId, path, opts) {
+        const folderKey = compositeKey(tenantId, shardId, path);
+        const docPrefix = folderKey + '/';
+        const upper = docPrefix + '￿';
+        const docKeys = await __classPrivateFieldGet(this, _IndexedDBDocumentBackend_instances, "m", _IndexedDBDocumentBackend_tx).call(this, 'readonly', (s) => s.getAllKeys(IDBKeyRange.bound(docPrefix, upper, false, false)));
+        const folderKeys = await __classPrivateFieldGet(this, _IndexedDBDocumentBackend_instances, "m", _IndexedDBDocumentBackend_txOn).call(this, IDB_FOLDERS, 'readonly', (s) => s.getAllKeys(IDBKeyRange.bound(docPrefix, upper, false, false)));
+        if (!opts.recursive && (docKeys.length > 0 || folderKeys.length > 0)) {
+            throw new Error(`Cannot rmdir ${path}: folder is not empty`);
+        }
+        const db = await __classPrivateFieldGet(this, _IndexedDBDocumentBackend_instances, "m", _IndexedDBDocumentBackend_db).call(this);
+        await new Promise((resolve, reject) => {
+            const tx = db.transaction([IDB_STORE, IDB_FOLDERS], 'readwrite');
+            const docStore = tx.objectStore(IDB_STORE);
+            const folderStore = tx.objectStore(IDB_FOLDERS);
+            for (const k of docKeys)
+                docStore.delete(k);
+            for (const k of folderKeys)
+                folderStore.delete(k);
+            folderStore.delete(folderKey);
+            tx.oncomplete = () => resolve();
+            tx.onerror = () => reject(tx.error);
+        });
+    }
+    async renameFolder(tenantId, shardId, oldPath, newPath) {
+        const oldFolderKey = compositeKey(tenantId, shardId, oldPath);
+        const newFolderKey = compositeKey(tenantId, shardId, newPath);
+        const oldPrefix = oldFolderKey + '/';
+        const newPrefix = newFolderKey + '/';
+        const upperOld = oldPrefix + '￿';
+        const upperNew = newPrefix + '￿';
+        const [oldDocs, oldFolders, oldExplicit, newDocs, newFolders, newExplicit] = await Promise.all([
+            __classPrivateFieldGet(this, _IndexedDBDocumentBackend_instances, "m", _IndexedDBDocumentBackend_tx).call(this, 'readonly', (s) => s.getAllKeys(IDBKeyRange.bound(oldPrefix, upperOld, false, false))),
+            __classPrivateFieldGet(this, _IndexedDBDocumentBackend_instances, "m", _IndexedDBDocumentBackend_txOn).call(this, IDB_FOLDERS, 'readonly', (s) => s.getAllKeys(IDBKeyRange.bound(oldPrefix, upperOld, false, false))),
+            __classPrivateFieldGet(this, _IndexedDBDocumentBackend_instances, "m", _IndexedDBDocumentBackend_txOn).call(this, IDB_FOLDERS, 'readonly', (s) => s.getKey(oldFolderKey)),
+            __classPrivateFieldGet(this, _IndexedDBDocumentBackend_instances, "m", _IndexedDBDocumentBackend_tx).call(this, 'readonly', (s) => s.getAllKeys(IDBKeyRange.bound(newPrefix, upperNew, false, false))),
+            __classPrivateFieldGet(this, _IndexedDBDocumentBackend_instances, "m", _IndexedDBDocumentBackend_txOn).call(this, IDB_FOLDERS, 'readonly', (s) => s.getAllKeys(IDBKeyRange.bound(newPrefix, upperNew, false, false))),
+            __classPrivateFieldGet(this, _IndexedDBDocumentBackend_instances, "m", _IndexedDBDocumentBackend_txOn).call(this, IDB_FOLDERS, 'readonly', (s) => s.getKey(newFolderKey)),
+        ]);
+        if (oldDocs.length === 0 && oldFolders.length === 0 && oldExplicit === undefined) {
+            throw new Error(`Cannot rename folder ${oldPath}: does not exist`);
+        }
+        if (newDocs.length > 0 || newFolders.length > 0 || newExplicit !== undefined) {
+            throw new Error(`Cannot rename folder to ${newPath}: already exists`);
+        }
+        // Read doc entries with values via cursor
+        const docEntries = await new Promise((resolve, reject) => {
+            __classPrivateFieldGet(this, _IndexedDBDocumentBackend_instances, "m", _IndexedDBDocumentBackend_db).call(this).then((db) => {
+                const tx = db.transaction(IDB_STORE, 'readonly');
+                const store = tx.objectStore(IDB_STORE);
+                const req = store.openCursor(IDBKeyRange.bound(oldPrefix, upperOld, false, false));
+                const acc = [];
+                req.onsuccess = () => {
+                    const cursor = req.result;
+                    if (cursor) {
+                        acc.push({ key: cursor.key, value: cursor.value });
+                        cursor.continue();
+                    }
+                    else {
+                        resolve(acc);
+                    }
+                };
+                req.onerror = () => reject(req.error);
+            });
+        });
+        const db = await __classPrivateFieldGet(this, _IndexedDBDocumentBackend_instances, "m", _IndexedDBDocumentBackend_db).call(this);
+        await new Promise((resolve, reject) => {
+            const tx = db.transaction([IDB_STORE, IDB_FOLDERS], 'readwrite');
+            const docStore = tx.objectStore(IDB_STORE);
+            const folderStore = tx.objectStore(IDB_FOLDERS);
+            for (const { key, value } of docEntries) {
+                const rewritten = newFolderKey + '/' + key.slice(oldPrefix.length);
+                docStore.delete(key);
+                docStore.put(Object.assign(Object.assign({}, value), { lastModified: Date.now() }), rewritten);
+            }
+            if (oldExplicit !== undefined) {
+                folderStore.delete(oldFolderKey);
+            }
+            folderStore.put(1, newFolderKey);
+            for (const k of oldFolders) {
+                const oldKeyStr = k;
+                const rewritten = newFolderKey + '/' + oldKeyStr.slice(oldPrefix.length);
+                folderStore.delete(k);
+                folderStore.put(1, rewritten);
+            }
+            tx.oncomplete = () => resolve();
+            tx.onerror = () => reject(tx.error);
+        });
+    }
+    async listFolders(tenantId, shardId, prefix) {
+        const basePrefix = prefix
+            ? compositeKey(tenantId, shardId, prefix) + '/'
+            : keyPrefix(tenantId, shardId);
+        const upper = basePrefix + '￿';
+        const out = new Set();
+        const folderKeys = await __classPrivateFieldGet(this, _IndexedDBDocumentBackend_instances, "m", _IndexedDBDocumentBackend_txOn).call(this, IDB_FOLDERS, 'readonly', (s) => s.getAllKeys(IDBKeyRange.bound(basePrefix, upper, false, false)));
+        for (const k of folderKeys) {
+            const rest = k.slice(basePrefix.length);
+            const slash = rest.indexOf('/');
+            out.add(slash >= 0 ? rest.slice(0, slash) : rest);
+        }
+        const docKeys = await __classPrivateFieldGet(this, _IndexedDBDocumentBackend_instances, "m", _IndexedDBDocumentBackend_tx).call(this, 'readonly', (s) => s.getAllKeys(IDBKeyRange.bound(basePrefix, upper, false, false)));
+        for (const k of docKeys) {
+            const rest = k.slice(basePrefix.length);
+            const slash = rest.indexOf('/');
+            if (slash >= 0)
+                out.add(rest.slice(0, slash));
+        }
+        return [...out].sort();
+    }
 }
 _IndexedDBDocumentBackend_dbPromise = new WeakMap(), _IndexedDBDocumentBackend_instances = new WeakSet(), _IndexedDBDocumentBackend_db = function _IndexedDBDocumentBackend_db() {
     if (!__classPrivateFieldGet(this, _IndexedDBDocumentBackend_dbPromise, "f")) {
@@ -284,6 +499,9 @@ _IndexedDBDocumentBackend_dbPromise = new WeakMap(), _IndexedDBDocumentBackend_i
                 if (!db.objectStoreNames.contains(IDB_STORE)) {
                     db.createObjectStore(IDB_STORE);
                 }
+                if (!db.objectStoreNames.contains(IDB_FOLDERS)) {
+                    db.createObjectStore(IDB_FOLDERS);
+                }
             };
             req.onsuccess = () => resolve(req.result);
             req.onerror = () => reject(req.error);
@@ -301,4 +519,13 @@ async function _IndexedDBDocumentBackend_tx(mode, fn) {
         req.onsuccess = () => resolve(req.result);
         req.onerror = () => reject(req.error);
     });
+}, _IndexedDBDocumentBackend_txOn = async function _IndexedDBDocumentBackend_txOn(storeName, mode, fn) {
+    const db = await __classPrivateFieldGet(this, _IndexedDBDocumentBackend_instances, "m", _IndexedDBDocumentBackend_db).call(this);
+    return new Promise((resolve, reject) => {
+        const tx = db.transaction(storeName, mode);
+        const store = tx.objectStore(storeName);
+        const req = fn(store);
+        req.onsuccess = () => resolve(req.result);
+        req.onerror = () => reject(req.error);
+    });
 };