@bitcobblers/wod-wiki-storage 0.43.2150 → 0.43.2152

package/dist/idb/index.d.cts

@@ -7,6 +7,35 @@ import '@bitcobblers/wod-wiki-core';
 import '@bitcobblers/wod-wiki-lang';
 import '@libsql/client';
 
+/**
+ * Local database catalog — enumerate/delete the browser-local IndexedDB
+ * databases behind the active-profile selector. The default app database is
+ * never created or destroyed here: the catalog only manages the auxiliary
+ * (restore/scratch) databases that the database switcher offers.
+ *
+ * This module deliberately does NOT import the storage adapter: the adapter
+ * lives in ./index, which re-exports this catalog, so an import back would
+ * close a module cycle. Creating a database (which needs the adapter's
+ * schema upgrade path) therefore lives beside the adapter in ./index.
+ */
+interface LocalDatabaseInfo {
+    name: string;
+    version: number | null;
+}
+/** Canonical app-database name ("wodwiki-db"). Defined HERE, not imported
+ *  from ./index, because the re-export cycle would read it before index.ts
+ *  initialized it (index.ts: export const IDB_DB_NAME = DEFAULT_LOCAL_DATABASE_NAME). */
+declare const DEFAULT_LOCAL_DATABASE_NAME: string;
+/** Same rule as the app-side isValidLocalDbName — one name vocabulary
+ *  everywhere (restore, catalog, settings persistence). */
+declare function isValidLocalDatabaseName(name: unknown): name is string;
+/** Native enumeration when the browser exposes it; [] otherwise (old
+ *  Safari/Firefox lack databases()) — never throws. */
+declare function listLocalDatabases(): Promise<LocalDatabaseInfo[]>;
+/** Delete one named database only; a blocked delete resolves (an open
+ *  connection elsewhere wins — the scratch data is disposable). */
+declare function deleteLocalDatabase(name: string): Promise<void>;
+
 /**
  * IndexedDB adapter — the browser data plane (moved verbatim from the
  * playground app; the shared user policy and the schema32 sync cutover live
@@ -20,7 +49,17 @@ import '@libsql/client';
  *    bootstrap runs (durable retry identities), all per backup target.
  */
 
-declare const IDB_DB_NAME = "wodwiki-db";
+declare const IDB_DB_NAME: string;
+
+/** Create a named database at the current schema (DB_VERSION) by opening it
+ *  through the regular adapter, then close. Refuses the default database —
+ *  the catalog never touches the live app profile.
+ *
+ *  Lives beside the adapter (not in ./catalog) because it needs the
+ *  adapter's schema upgrade path, and the adapter's module re-exports the
+ *  catalog — importing the adapter back from the catalog would close a
+ *  module cycle. */
+declare function createLocalDatabase(name: string): Promise<LocalDatabaseInfo>;
 type Mode = 'readonly' | 'readwrite';
 /** Native tx handle; write methods are guarded at runtime by `mutable`, so
  *  the handle is typed readwrite to keep put/delete/clear defined. */
@@ -153,4 +192,4 @@ declare class IndexedDBStorage implements IStorage {
  */
 declare function convertSyncSource(db: Database, fromVersion: number, legacy: boolean): Promise<SyncMutation[]>;
 
-export { IDB_DB_NAME, IndexedDBStorage, convertSyncSource, subscribeOutboxWrites };
+export { DEFAULT_LOCAL_DATABASE_NAME, IDB_DB_NAME, IndexedDBStorage, type LocalDatabaseInfo, convertSyncSource, createLocalDatabase, deleteLocalDatabase, isValidLocalDatabaseName, listLocalDatabases, subscribeOutboxWrites };

package/dist/idb/index.d.ts

@@ -7,6 +7,35 @@ import '@bitcobblers/wod-wiki-core';
 import '@bitcobblers/wod-wiki-lang';
 import '@libsql/client';
 
+/**
+ * Local database catalog — enumerate/delete the browser-local IndexedDB
+ * databases behind the active-profile selector. The default app database is
+ * never created or destroyed here: the catalog only manages the auxiliary
+ * (restore/scratch) databases that the database switcher offers.
+ *
+ * This module deliberately does NOT import the storage adapter: the adapter
+ * lives in ./index, which re-exports this catalog, so an import back would
+ * close a module cycle. Creating a database (which needs the adapter's
+ * schema upgrade path) therefore lives beside the adapter in ./index.
+ */
+interface LocalDatabaseInfo {
+    name: string;
+    version: number | null;
+}
+/** Canonical app-database name ("wodwiki-db"). Defined HERE, not imported
+ *  from ./index, because the re-export cycle would read it before index.ts
+ *  initialized it (index.ts: export const IDB_DB_NAME = DEFAULT_LOCAL_DATABASE_NAME). */
+declare const DEFAULT_LOCAL_DATABASE_NAME: string;
+/** Same rule as the app-side isValidLocalDbName — one name vocabulary
+ *  everywhere (restore, catalog, settings persistence). */
+declare function isValidLocalDatabaseName(name: unknown): name is string;
+/** Native enumeration when the browser exposes it; [] otherwise (old
+ *  Safari/Firefox lack databases()) — never throws. */
+declare function listLocalDatabases(): Promise<LocalDatabaseInfo[]>;
+/** Delete one named database only; a blocked delete resolves (an open
+ *  connection elsewhere wins — the scratch data is disposable). */
+declare function deleteLocalDatabase(name: string): Promise<void>;
+
 /**
  * IndexedDB adapter — the browser data plane (moved verbatim from the
  * playground app; the shared user policy and the schema32 sync cutover live
@@ -20,7 +49,17 @@ import '@libsql/client';
  *    bootstrap runs (durable retry identities), all per backup target.
  */
 
-declare const IDB_DB_NAME = "wodwiki-db";
+declare const IDB_DB_NAME: string;
+
+/** Create a named database at the current schema (DB_VERSION) by opening it
+ *  through the regular adapter, then close. Refuses the default database —
+ *  the catalog never touches the live app profile.
+ *
+ *  Lives beside the adapter (not in ./catalog) because it needs the
+ *  adapter's schema upgrade path, and the adapter's module re-exports the
+ *  catalog — importing the adapter back from the catalog would close a
+ *  module cycle. */
+declare function createLocalDatabase(name: string): Promise<LocalDatabaseInfo>;
 type Mode = 'readonly' | 'readwrite';
 /** Native tx handle; write methods are guarded at runtime by `mutable`, so
  *  the handle is typed readwrite to keep put/delete/clear defined. */
@@ -153,4 +192,4 @@ declare class IndexedDBStorage implements IStorage {
  */
 declare function convertSyncSource(db: Database, fromVersion: number, legacy: boolean): Promise<SyncMutation[]>;
 
-export { IDB_DB_NAME, IndexedDBStorage, convertSyncSource, subscribeOutboxWrites };
+export { DEFAULT_LOCAL_DATABASE_NAME, IDB_DB_NAME, IndexedDBStorage, type LocalDatabaseInfo, convertSyncSource, createLocalDatabase, deleteLocalDatabase, isValidLocalDatabaseName, listLocalDatabases, subscribeOutboxWrites };

package/dist/idb/index.mjs

@@ -6,7 +6,42 @@ import { openDB } from 'idb';
 import { parseDocumentSections, KNOWN_SECTION_WIDGETS, actionableSectionKind, matchDialectFence } from '@bitcobblers/wod-wiki-core';
 import { toEventRows, toSummaryEventRows } from '@bitcobblers/wod-wiki-wql';
 
-var IDB_DB_NAME = "wodwiki-db";
+// src/idb/catalog.ts
+var DEFAULT_LOCAL_DATABASE_NAME = "wodwiki-db";
+function isValidLocalDatabaseName(name) {
+  return typeof name === "string" && /^[A-Za-z0-9][A-Za-z0-9._-]{0,99}$/.test(name);
+}
+async function listLocalDatabases() {
+  const idb = globalThis.indexedDB;
+  if (!idb || typeof idb.databases !== "function") return [];
+  const entries = await idb.databases().catch(() => []);
+  return entries.flatMap(
+    (entry) => typeof entry.name === "string" ? [{ name: entry.name, version: typeof entry.version === "number" ? entry.version : null }] : []
+  );
+}
+async function deleteLocalDatabase(name) {
+  if (!isValidLocalDatabaseName(name)) throw new Error(`Invalid local database name "${String(name)}".`);
+  const idb = globalThis.indexedDB;
+  if (!idb) return;
+  await new Promise((resolve, reject) => {
+    const request = idb.deleteDatabase(name);
+    request.onsuccess = () => resolve();
+    request.onerror = () => reject(request.error ?? new Error(`Failed to delete local database "${name}".`));
+    request.onblocked = () => resolve();
+  });
+}
+var IDB_DB_NAME = DEFAULT_LOCAL_DATABASE_NAME;
+async function createLocalDatabase(name) {
+  if (!isValidLocalDatabaseName(name)) throw new Error(`Invalid local database name "${String(name)}".`);
+  if (name === DEFAULT_LOCAL_DATABASE_NAME) throw new Error("The default database cannot be created here.");
+  const storage = new IndexedDBStorage({ dbName: name });
+  try {
+    await storage.open();
+  } finally {
+    await storage.close().catch(() => void 0);
+  }
+  return { name, version: DB_VERSION };
+}
 var OUTBOX_STORE = "sync_outbox";
 var SYNC_STATE_STORE = "sync_state";
 var LOCAL_SYNC_STORES = [
@@ -1074,6 +1109,6 @@ async function migrateSegmentsToBlocks(db, tx) {
   db.deleteObjectStore("segments");
 }
 
-export { IDB_DB_NAME, IndexedDBStorage, convertSyncSource, subscribeOutboxWrites };
+export { DEFAULT_LOCAL_DATABASE_NAME, IDB_DB_NAME, IndexedDBStorage, convertSyncSource, createLocalDatabase, deleteLocalDatabase, isValidLocalDatabaseName, listLocalDatabases, subscribeOutboxWrites };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map