locality-idb 1.5.0 → 1.5.1

package/README.md

@@ -990,6 +990,25 @@ const db = new Locality({
 
 #### Properties
 
+##### `dbName: string` (getter)
+
+Gets the current database name.
+
+**Returns:** The database name
+
+**Example:**
+
+```typescript
+const db = new Locality({
+  dbName: 'my-database',
+  version: 1,
+  schema: mySchema,
+});
+
+await db.ready(); // (optional) for extra safety
+console.log(db.dbName); // 'my-database'
+```
+
 ##### `version: number` (getter)
 
 Gets the current database version.
@@ -1230,24 +1249,34 @@ await db.export({
 **Exported JSON Structure:**
 
 ```typescript
-{
-  metadata?: {  // Optional (when includeMetadata = true)
-    dbName: string;
-    version: number;
-    exportedAt: string;  // ISO 8601 timestamp
-    tables: string[];
-  };
-  data: {
-    [tableName: string]: Array<Record<string, any>>;
-  };
-}
+/** Exported table data structure */
+type ExportedTableData<T extends string, S extends SchemaDefinition> = {
+ [K in T]: InferSelectType<S[K]>[];
+};
+
+/** Exported database data structure */
+type ExportData<T extends string, S extends SchemaDefinition> = {
+ /** Optional metadata about the export */
+ metadata?: {
+  /** Database name */
+  dbName: string;
+  /** Database version */
+  version: number;
+  /** Export creation time */
+  exportedAt: Timestamp;
+  /** List of exported table names */
+  tables: T[];
+ };
+ /** Actual exported data, mapping table names to arrays of records */
+ data: ExportedTableData<T, S>;
+};
 ```
 
-#### `exportToObject(options?: ExportOptions): Promise<ExportData>`
+#### `exportToObject(options?: ExportObjectOptions): Promise<ExportData>`
 
 Exports database data as an object without triggering a download.
 
-**Parameters:** Same as `export()`, except `filename` and `pretty` are ignored.
+**Parameters:** Same as [`export()`](#exportoptions-exportoptions-promisevoid), except `filename` and `pretty` are omitted.
 
 **Returns:** Promise that resolves to an `ExportData` object.
 
@@ -1257,7 +1286,7 @@ Exports database data as an object without triggering a download.
 const exported = await db.exportToObject();
 ```
 
-#### `import(data: ExportData | Record<string, any[]>, options?: ImportOptions): Promise<void>`
+#### `import(data: ExportData | ExportedTableData, options?: ImportOptions): Promise<void>`
 
 Imports database data using merge, replace, or upsert modes.
 

package/dist/index.cjs

@@ -1372,6 +1372,10 @@ var Locality = class Locality {
 		const columns = this.#schema[table].columns;
 		return Object.entries(columns).find(([_, col]) => col[IsPrimaryKey])?.[0];
 	}
+	/** @instance Get the current database name. */
+	get dbName() {
+		return this.#name;
+	}
 	get version() {
 		return this.#db?.version ?? this.#version ?? this.#configVersion;
 	}
@@ -1605,7 +1609,7 @@ var Locality = class Locality {
 		await this.#readyPromise;
 		const { tables, includeMetadata = true } = options || {};
 		const tablesToExport = tables ?? Object.keys(this.#schema);
-		for (const table of tablesToExport) if (!(table in this.#schema)) throw new RangeError(`Table '${String(table)}' does not exist in schema.`);
+		for (const table of tablesToExport) if (!(table in this.#schema)) throw new RangeError(`Table '${table}' does not exist in schema.`);
 		if (tablesToExport.length === 0) return {
 			metadata: includeMetadata ? {
 				dbName: this.#name,
@@ -1620,21 +1624,22 @@ var Locality = class Locality {
 		return new Promise((resolve, reject) => {
 			transaction.onabort = () => _abortTransaction(transaction.error, reject);
 			transaction.onerror = () => reject(transaction.error);
-			const readPromises = tablesToExport.map((table) => new Promise((res, rej) => {
-				const request = transaction.objectStore(table).getAll();
-				request.onsuccess = () => {
-					exportData[table] = request.result;
-					res();
-				};
-				request.onerror = () => rej(request.error);
-			}));
+			const readPromises = tablesToExport.map((table) => {
+				return new Promise((res, rej) => {
+					const request = transaction.objectStore(table).getAll();
+					request.onsuccess = () => {
+						exportData[table] = request.result;
+						res();
+					};
+					request.onerror = () => rej(request.error);
+				});
+			});
 			Promise.all(readPromises).then(() => {
 				const exportObj = {};
-				const ts = getTimestamp();
 				if (includeMetadata) exportObj.metadata = {
 					dbName: this.#name,
 					version: this.version,
-					exportedAt: ts,
+					exportedAt: getTimestamp(),
 					tables: tablesToExport
 				};
 				exportObj.data = exportData;
@@ -1642,19 +1647,12 @@ var Locality = class Locality {
 			}).catch(reject);
 		});
 	}
-	/**
-	* @instance Import data into the database.
-	*
-	* @remarks
-	* - Accepts either raw table data or an {@link ExportData} object.
-	* - Supports merge, replace, and upsert modes.
-	*/
 	async import(data, options) {
 		await this.#readyPromise;
 		const { mode = "merge", tables } = options || {};
 		const dataMap = "data" in data ? data.data : data;
 		const tablesToImport = tables ?? Object.keys(dataMap);
-		for (const table of tablesToImport) if (!(table in this.#schema)) throw new RangeError(`Table '${String(table)}' does not exist in schema.`);
+		for (const table of tablesToImport) if (!(table in this.#schema)) throw new RangeError(`Table '${table}' does not exist in schema.`);
 		if (tablesToImport.length === 0) return;
 		const transaction = this.#db.transaction(tablesToImport, "readwrite");
 		return new Promise((resolve, reject) => {
@@ -1671,7 +1669,7 @@ var Locality = class Locality {
 				if (rows.length === 0) return;
 				const writePromises = rows.map((row) => {
 					return new Promise((res, rej) => {
-						const prepared = validateAndPrepareData(row, this.#schema[table].columns, this.#keyPaths[table], String(table));
+						const prepared = validateAndPrepareData(row, this.#schema[table].columns, this.#keyPaths[table], table);
 						const request = mode === "upsert" ? store.put(prepared) : store.add(prepared);
 						request.onsuccess = () => res();
 						request.onerror = () => rej(request.error);
@@ -1694,11 +1692,13 @@ var Locality = class Locality {
 		return new Promise((resolve, reject) => {
 			transaction.onabort = () => _abortTransaction(transaction.error, reject);
 			transaction.onerror = () => reject(transaction.error);
-			const clearPromises = tables.map((table) => new Promise((res, rej) => {
-				const request = transaction.objectStore(table).clear();
-				request.onsuccess = () => res();
-				request.onerror = () => rej(request.error);
-			}));
+			const clearPromises = tables.map((table) => {
+				return new Promise((res, rej) => {
+					const request = transaction.objectStore(table).clear();
+					request.onsuccess = () => res();
+					request.onerror = () => rej(request.error);
+				});
+			});
 			Promise.all(clearPromises).then(() => resolve()).catch((err) => {
 				transaction.abort();
 				reject(err);
@@ -1714,23 +1714,23 @@ var Locality = class Locality {
 	*/
 	async dropTable(table) {
 		await this.#readyPromise;
-		if (!(table in this.#schema)) throw new RangeError(`Table '${String(table)}' does not exist in schema.`);
+		if (!(table in this.#schema)) throw new RangeError(`Table '${table}' does not exist in schema.`);
 		const nextStores = this.#buildStoresConfig().filter((store) => store.name !== table);
 		const nextVersion = this.version + 1;
 		this.#db.close();
 		this.#readyPromise = openDBWithStores(this.#name, nextStores, nextVersion).then((db) => {
 			this.#db = db;
 			const keyPaths = this.#keyPaths;
-			delete keyPaths[String(table)];
+			delete keyPaths[table];
 		}).finally(() => {
 			this.#version = this.#db?.version;
 		});
 		await this.#readyPromise;
 	}
 	/** @static Get the list of existing `IndexedDB` databases. */
-	static getDatabaseList() {
+	static async getDatabaseList() {
 		_ensureIndexedDB();
-		return _getDBList();
+		return await _getDBList();
 	}
 	/** @static Delete an `IndexedDB` database by name. */
 	static async deleteDatabase(name) {

package/dist/index.d.cts

@@ -614,21 +614,24 @@ type ExportOptions<T extends string> = {
   pretty?: boolean; /** Optional flag to include export metadata (default: `true`) */
   includeMetadata?: boolean;
 };
+type ExportObjectOptions<T extends string> = Omit<ExportOptions<T>, 'filename' | 'pretty'>;
 /** Import options for database `import` method */
 type ImportOptions<T extends string> = {
   /** Optional array of table names to import (imports all tables (store) if not specified) */tables?: T[]; /** Import mode: `'replace'`, `'merge'`, or `'upsert'` (default: `'merge'`) */
   mode?: 'replace' | 'merge' | 'upsert';
 };
+/** Exported table data structure */
+type ExportedTableData<T extends string, S extends SchemaDefinition> = Prettify<{ [K in T]: InferSelectType<S[K]>[] }>;
 /** Exported database data structure */
-type ExportData = {
+type ExportData<T extends string, S extends SchemaDefinition> = Prettify<{
   /** Optional metadata about the export */metadata?: {
     /** Database name */dbName: string; /** Database version */
     version: number; /** Export creation time */
     exportedAt: Timestamp; /** List of exported table names */
-    tables: string[];
+    tables: T[];
   }; /** Actual exported data, mapping table names to arrays of records */
-  data: Record<string, GenericObject[]>;
-};
+  data: ExportedTableData<T, S>;
+}>;
 /** Transaction context type providing methods for database operations within a transaction */
 type TransactionContext<Schema extends SchemaDefinition, TName extends keyof Schema, Tables extends TName[]> = {
   /** Inserts a new record into the specified table */insert: <T extends Tables[number], Raw extends InferInsertType<Schema[T]>, Inserted extends Raw | Raw[], Data extends InferSelectType<Schema[T]>, Return extends (Inserted extends Array<infer _> ? Data[] : Data)>(table: T) => InsertQuery<Raw, Inserted, Data, Return>; /** Updates an existing record in the specified table */
@@ -681,7 +684,9 @@ type TransactionCallback<Schema extends SchemaDefinition, TName extends keyof Sc
 declare class Locality<DBName extends string = string, Version extends number = 1, Schema extends SchemaDefinition = SchemaDefinition, TName extends keyof Schema & string = keyof Schema & string> {
   #private;
   constructor(config: LocalityConfig<DBName, Version, Schema>);
-  get version(): Version;
+  /** @instance Get the current database name. */
+  get dbName(): DBName;
+  get version(): LooseLiteral<Version>;
   /** @instance Get all table (store) names in the current database. */
   get tableList(): LooseLiteral<TName>[];
   /** @instance Get the list of existing `IndexedDB` databases. */
@@ -836,15 +841,23 @@ declare class Locality<DBName extends string = string, Version extends number =
    * - Exports all tables by default, or only specified tables if provided.
    * - Returns a JSON-serializable object with schema metadata and table data.
    */
-  exportToObject(options?: ExportOptions<TName>): Promise<ExportData>;
+  exportToObject(options?: ExportObjectOptions<TName>): Promise<ExportData<TName, Schema>>;
+  /**
+   * @instance Import data into the database.
+   *
+   * @remarks
+   * - Accepts either an {@link ExportData} object or raw table data {@link ExportedTableData}.
+   * - Supports merge, replace, and upsert modes.
+   */
+  import(data: ExportData<TName, Schema>, options?: ImportOptions<TName>): Promise<void>;
   /**
    * @instance Import data into the database.
    *
    * @remarks
-   * - Accepts either raw table data or an {@link ExportData} object.
+   * - Accepts either raw table data {@link ExportedTableData} or an {@link ExportData} object.
    * - Supports merge, replace, and upsert modes.
    */
-  import(data: ExportData | Record<string, GenericObject[]>, options?: ImportOptions<TName>): Promise<void>;
+  import(data: ExportedTableData<TName, Schema>, options?: ImportOptions<TName>): Promise<void>;
   /** @instance Clear all records from all tables. */
   clearAll(): Promise<void>;
   /**
@@ -1403,4 +1416,4 @@ declare function isUUID(value: unknown): value is UUID<UUIDVersion>;
  */
 declare function validateColumnType<T extends TypeName>(type: T, value: unknown): string | null;
 //#endregion
-export { $InferAutoInc, $InferDefault, $InferIndex, $InferNullable, $InferOptional, $InferPrimaryKey, $InferRow, $InferTimestamp, $InferUUID, $InferUnique, $UUID, $UUIDVersion, $UnionToIntersection, $ValidateSinglePK, AdvancedTypes, ArrayToTuple, AsyncFunction, BasicPrimitive, Branded, type Column, ColumnDefinition, ColumnRecord, ColumnType, Constructor, CursorCallback, DateLike, DefaultValue, Email, ExportData, ExportOptions, FirstOverloadParams, ForcedAny, GenericFn, GenericObject, ImportOptions, IndexConfig, IndexKeyType, InferInsertType, InferSelectType, InferUpdateType, IsAutoInc, IsIndexed, IsNullable, IsOptional, IsPrimaryKey, IsUnique, List, Locality, LocalityConfig, LooseLiteral, MapObjectValues, Maybe, NestedPrimitiveKey, NormalPrimitive, Numeric, OnUpdate, type PKColumn, PageOptions, PageResult, Prettify, PrimaryKeyType, Primitive, RejectFn, SchemaDefinition, SchemaRecord, SelectFields, SortDirection, StoreConfig, type Table, Timestamp, TransactionCallback, TransactionContext, Tuple, TypeName, URLString, UUID, UUIDVersion, UniqueKeyType, UpdaterFn, ValidateFn, ValidatedColumnDefinition, ValidatorFn, VoidFn, WherePredicate, column, defineSchema, deleteDB, getTimestamp, isEmail, isTimestamp, isURL, isUUID, openDBWithStores, table, uuidV4, validateColumnType };
+export { $InferAutoInc, $InferDefault, $InferIndex, $InferNullable, $InferOptional, $InferPrimaryKey, $InferRow, $InferTimestamp, $InferUUID, $InferUnique, $UUID, $UUIDVersion, $UnionToIntersection, $ValidateSinglePK, AdvancedTypes, ArrayToTuple, AsyncFunction, BasicPrimitive, Branded, type Column, ColumnDefinition, ColumnRecord, ColumnType, Constructor, CursorCallback, DateLike, DefaultValue, Email, ExportData, ExportObjectOptions, ExportOptions, ExportedTableData, FirstOverloadParams, ForcedAny, GenericFn, GenericObject, ImportOptions, IndexConfig, IndexKeyType, InferInsertType, InferSelectType, InferUpdateType, IsAutoInc, IsIndexed, IsNullable, IsOptional, IsPrimaryKey, IsUnique, List, Locality, LocalityConfig, LooseLiteral, MapObjectValues, Maybe, NestedPrimitiveKey, NormalPrimitive, Numeric, OnUpdate, type PKColumn, PageOptions, PageResult, Prettify, PrimaryKeyType, Primitive, RejectFn, SchemaDefinition, SchemaRecord, SelectFields, SortDirection, StoreConfig, type Table, Timestamp, TransactionCallback, TransactionContext, Tuple, TypeName, URLString, UUID, UUIDVersion, UniqueKeyType, UpdaterFn, ValidateFn, ValidatedColumnDefinition, ValidatorFn, VoidFn, WherePredicate, column, defineSchema, deleteDB, getTimestamp, isEmail, isTimestamp, isURL, isUUID, openDBWithStores, table, uuidV4, validateColumnType };

package/dist/index.d.mts

@@ -614,21 +614,24 @@ type ExportOptions<T extends string> = {
   pretty?: boolean; /** Optional flag to include export metadata (default: `true`) */
   includeMetadata?: boolean;
 };
+type ExportObjectOptions<T extends string> = Omit<ExportOptions<T>, 'filename' | 'pretty'>;
 /** Import options for database `import` method */
 type ImportOptions<T extends string> = {
   /** Optional array of table names to import (imports all tables (store) if not specified) */tables?: T[]; /** Import mode: `'replace'`, `'merge'`, or `'upsert'` (default: `'merge'`) */
   mode?: 'replace' | 'merge' | 'upsert';
 };
+/** Exported table data structure */
+type ExportedTableData<T extends string, S extends SchemaDefinition> = Prettify<{ [K in T]: InferSelectType<S[K]>[] }>;
 /** Exported database data structure */
-type ExportData = {
+type ExportData<T extends string, S extends SchemaDefinition> = Prettify<{
   /** Optional metadata about the export */metadata?: {
     /** Database name */dbName: string; /** Database version */
     version: number; /** Export creation time */
     exportedAt: Timestamp; /** List of exported table names */
-    tables: string[];
+    tables: T[];
   }; /** Actual exported data, mapping table names to arrays of records */
-  data: Record<string, GenericObject[]>;
-};
+  data: ExportedTableData<T, S>;
+}>;
 /** Transaction context type providing methods for database operations within a transaction */
 type TransactionContext<Schema extends SchemaDefinition, TName extends keyof Schema, Tables extends TName[]> = {
   /** Inserts a new record into the specified table */insert: <T extends Tables[number], Raw extends InferInsertType<Schema[T]>, Inserted extends Raw | Raw[], Data extends InferSelectType<Schema[T]>, Return extends (Inserted extends Array<infer _> ? Data[] : Data)>(table: T) => InsertQuery<Raw, Inserted, Data, Return>; /** Updates an existing record in the specified table */
@@ -681,7 +684,9 @@ type TransactionCallback<Schema extends SchemaDefinition, TName extends keyof Sc
 declare class Locality<DBName extends string = string, Version extends number = 1, Schema extends SchemaDefinition = SchemaDefinition, TName extends keyof Schema & string = keyof Schema & string> {
   #private;
   constructor(config: LocalityConfig<DBName, Version, Schema>);
-  get version(): Version;
+  /** @instance Get the current database name. */
+  get dbName(): DBName;
+  get version(): LooseLiteral<Version>;
   /** @instance Get all table (store) names in the current database. */
   get tableList(): LooseLiteral<TName>[];
   /** @instance Get the list of existing `IndexedDB` databases. */
@@ -836,15 +841,23 @@ declare class Locality<DBName extends string = string, Version extends number =
    * - Exports all tables by default, or only specified tables if provided.
    * - Returns a JSON-serializable object with schema metadata and table data.
    */
-  exportToObject(options?: ExportOptions<TName>): Promise<ExportData>;
+  exportToObject(options?: ExportObjectOptions<TName>): Promise<ExportData<TName, Schema>>;
+  /**
+   * @instance Import data into the database.
+   *
+   * @remarks
+   * - Accepts either an {@link ExportData} object or raw table data {@link ExportedTableData}.
+   * - Supports merge, replace, and upsert modes.
+   */
+  import(data: ExportData<TName, Schema>, options?: ImportOptions<TName>): Promise<void>;
   /**
    * @instance Import data into the database.
    *
    * @remarks
-   * - Accepts either raw table data or an {@link ExportData} object.
+   * - Accepts either raw table data {@link ExportedTableData} or an {@link ExportData} object.
    * - Supports merge, replace, and upsert modes.
    */
-  import(data: ExportData | Record<string, GenericObject[]>, options?: ImportOptions<TName>): Promise<void>;
+  import(data: ExportedTableData<TName, Schema>, options?: ImportOptions<TName>): Promise<void>;
   /** @instance Clear all records from all tables. */
   clearAll(): Promise<void>;
   /**
@@ -1403,4 +1416,4 @@ declare function isUUID(value: unknown): value is UUID<UUIDVersion>;
  */
 declare function validateColumnType<T extends TypeName>(type: T, value: unknown): string | null;
 //#endregion
-export { $InferAutoInc, $InferDefault, $InferIndex, $InferNullable, $InferOptional, $InferPrimaryKey, $InferRow, $InferTimestamp, $InferUUID, $InferUnique, $UUID, $UUIDVersion, $UnionToIntersection, $ValidateSinglePK, AdvancedTypes, ArrayToTuple, AsyncFunction, BasicPrimitive, Branded, type Column, ColumnDefinition, ColumnRecord, ColumnType, Constructor, CursorCallback, DateLike, DefaultValue, Email, ExportData, ExportOptions, FirstOverloadParams, ForcedAny, GenericFn, GenericObject, ImportOptions, IndexConfig, IndexKeyType, InferInsertType, InferSelectType, InferUpdateType, IsAutoInc, IsIndexed, IsNullable, IsOptional, IsPrimaryKey, IsUnique, List, Locality, LocalityConfig, LooseLiteral, MapObjectValues, Maybe, NestedPrimitiveKey, NormalPrimitive, Numeric, OnUpdate, type PKColumn, PageOptions, PageResult, Prettify, PrimaryKeyType, Primitive, RejectFn, SchemaDefinition, SchemaRecord, SelectFields, SortDirection, StoreConfig, type Table, Timestamp, TransactionCallback, TransactionContext, Tuple, TypeName, URLString, UUID, UUIDVersion, UniqueKeyType, UpdaterFn, ValidateFn, ValidatedColumnDefinition, ValidatorFn, VoidFn, WherePredicate, column, defineSchema, deleteDB, getTimestamp, isEmail, isTimestamp, isURL, isUUID, openDBWithStores, table, uuidV4, validateColumnType };
+export { $InferAutoInc, $InferDefault, $InferIndex, $InferNullable, $InferOptional, $InferPrimaryKey, $InferRow, $InferTimestamp, $InferUUID, $InferUnique, $UUID, $UUIDVersion, $UnionToIntersection, $ValidateSinglePK, AdvancedTypes, ArrayToTuple, AsyncFunction, BasicPrimitive, Branded, type Column, ColumnDefinition, ColumnRecord, ColumnType, Constructor, CursorCallback, DateLike, DefaultValue, Email, ExportData, ExportObjectOptions, ExportOptions, ExportedTableData, FirstOverloadParams, ForcedAny, GenericFn, GenericObject, ImportOptions, IndexConfig, IndexKeyType, InferInsertType, InferSelectType, InferUpdateType, IsAutoInc, IsIndexed, IsNullable, IsOptional, IsPrimaryKey, IsUnique, List, Locality, LocalityConfig, LooseLiteral, MapObjectValues, Maybe, NestedPrimitiveKey, NormalPrimitive, Numeric, OnUpdate, type PKColumn, PageOptions, PageResult, Prettify, PrimaryKeyType, Primitive, RejectFn, SchemaDefinition, SchemaRecord, SelectFields, SortDirection, StoreConfig, type Table, Timestamp, TransactionCallback, TransactionContext, Tuple, TypeName, URLString, UUID, UUIDVersion, UniqueKeyType, UpdaterFn, ValidateFn, ValidatedColumnDefinition, ValidatorFn, VoidFn, WherePredicate, column, defineSchema, deleteDB, getTimestamp, isEmail, isTimestamp, isURL, isUUID, openDBWithStores, table, uuidV4, validateColumnType };

package/dist/index.iife.js

@@ -1374,6 +1374,10 @@ var LocalityIDB = (function(exports) {
 			const columns = this.#schema[table].columns;
 			return Object.entries(columns).find(([_, col]) => col[IsPrimaryKey])?.[0];
 		}
+		/** @instance Get the current database name. */
+		get dbName() {
+			return this.#name;
+		}
 		get version() {
 			return this.#db?.version ?? this.#version ?? this.#configVersion;
 		}
@@ -1607,7 +1611,7 @@ var LocalityIDB = (function(exports) {
 			await this.#readyPromise;
 			const { tables, includeMetadata = true } = options || {};
 			const tablesToExport = tables ?? Object.keys(this.#schema);
-			for (const table of tablesToExport) if (!(table in this.#schema)) throw new RangeError(`Table '${String(table)}' does not exist in schema.`);
+			for (const table of tablesToExport) if (!(table in this.#schema)) throw new RangeError(`Table '${table}' does not exist in schema.`);
 			if (tablesToExport.length === 0) return {
 				metadata: includeMetadata ? {
 					dbName: this.#name,
@@ -1622,21 +1626,22 @@ var LocalityIDB = (function(exports) {
 			return new Promise((resolve, reject) => {
 				transaction.onabort = () => _abortTransaction(transaction.error, reject);
 				transaction.onerror = () => reject(transaction.error);
-				const readPromises = tablesToExport.map((table) => new Promise((res, rej) => {
-					const request = transaction.objectStore(table).getAll();
-					request.onsuccess = () => {
-						exportData[table] = request.result;
-						res();
-					};
-					request.onerror = () => rej(request.error);
-				}));
+				const readPromises = tablesToExport.map((table) => {
+					return new Promise((res, rej) => {
+						const request = transaction.objectStore(table).getAll();
+						request.onsuccess = () => {
+							exportData[table] = request.result;
+							res();
+						};
+						request.onerror = () => rej(request.error);
+					});
+				});
 				Promise.all(readPromises).then(() => {
 					const exportObj = {};
-					const ts = getTimestamp();
 					if (includeMetadata) exportObj.metadata = {
 						dbName: this.#name,
 						version: this.version,
-						exportedAt: ts,
+						exportedAt: getTimestamp(),
 						tables: tablesToExport
 					};
 					exportObj.data = exportData;
@@ -1644,19 +1649,12 @@ var LocalityIDB = (function(exports) {
 				}).catch(reject);
 			});
 		}
-		/**
-		* @instance Import data into the database.
-		*
-		* @remarks
-		* - Accepts either raw table data or an {@link ExportData} object.
-		* - Supports merge, replace, and upsert modes.
-		*/
 		async import(data, options) {
 			await this.#readyPromise;
 			const { mode = "merge", tables } = options || {};
 			const dataMap = "data" in data ? data.data : data;
 			const tablesToImport = tables ?? Object.keys(dataMap);
-			for (const table of tablesToImport) if (!(table in this.#schema)) throw new RangeError(`Table '${String(table)}' does not exist in schema.`);
+			for (const table of tablesToImport) if (!(table in this.#schema)) throw new RangeError(`Table '${table}' does not exist in schema.`);
 			if (tablesToImport.length === 0) return;
 			const transaction = this.#db.transaction(tablesToImport, "readwrite");
 			return new Promise((resolve, reject) => {
@@ -1673,7 +1671,7 @@ var LocalityIDB = (function(exports) {
 					if (rows.length === 0) return;
 					const writePromises = rows.map((row) => {
 						return new Promise((res, rej) => {
-							const prepared = validateAndPrepareData(row, this.#schema[table].columns, this.#keyPaths[table], String(table));
+							const prepared = validateAndPrepareData(row, this.#schema[table].columns, this.#keyPaths[table], table);
 							const request = mode === "upsert" ? store.put(prepared) : store.add(prepared);
 							request.onsuccess = () => res();
 							request.onerror = () => rej(request.error);
@@ -1696,11 +1694,13 @@ var LocalityIDB = (function(exports) {
 			return new Promise((resolve, reject) => {
 				transaction.onabort = () => _abortTransaction(transaction.error, reject);
 				transaction.onerror = () => reject(transaction.error);
-				const clearPromises = tables.map((table) => new Promise((res, rej) => {
-					const request = transaction.objectStore(table).clear();
-					request.onsuccess = () => res();
-					request.onerror = () => rej(request.error);
-				}));
+				const clearPromises = tables.map((table) => {
+					return new Promise((res, rej) => {
+						const request = transaction.objectStore(table).clear();
+						request.onsuccess = () => res();
+						request.onerror = () => rej(request.error);
+					});
+				});
 				Promise.all(clearPromises).then(() => resolve()).catch((err) => {
 					transaction.abort();
 					reject(err);
@@ -1716,23 +1716,23 @@ var LocalityIDB = (function(exports) {
 		*/
 		async dropTable(table) {
 			await this.#readyPromise;
-			if (!(table in this.#schema)) throw new RangeError(`Table '${String(table)}' does not exist in schema.`);
+			if (!(table in this.#schema)) throw new RangeError(`Table '${table}' does not exist in schema.`);
 			const nextStores = this.#buildStoresConfig().filter((store) => store.name !== table);
 			const nextVersion = this.version + 1;
 			this.#db.close();
 			this.#readyPromise = openDBWithStores(this.#name, nextStores, nextVersion).then((db) => {
 				this.#db = db;
 				const keyPaths = this.#keyPaths;
-				delete keyPaths[String(table)];
+				delete keyPaths[table];
 			}).finally(() => {
 				this.#version = this.#db?.version;
 			});
 			await this.#readyPromise;
 		}
 		/** @static Get the list of existing `IndexedDB` databases. */
-		static getDatabaseList() {
+		static async getDatabaseList() {
 			_ensureIndexedDB();
-			return _getDBList();
+			return await _getDBList();
 		}
 		/** @static Delete an `IndexedDB` database by name. */
 		static async deleteDatabase(name) {

package/dist/index.mjs

@@ -1371,6 +1371,10 @@ var Locality = class Locality {
 		const columns = this.#schema[table].columns;
 		return Object.entries(columns).find(([_, col]) => col[IsPrimaryKey])?.[0];
 	}
+	/** @instance Get the current database name. */
+	get dbName() {
+		return this.#name;
+	}
 	get version() {
 		return this.#db?.version ?? this.#version ?? this.#configVersion;
 	}
@@ -1604,7 +1608,7 @@ var Locality = class Locality {
 		await this.#readyPromise;
 		const { tables, includeMetadata = true } = options || {};
 		const tablesToExport = tables ?? Object.keys(this.#schema);
-		for (const table of tablesToExport) if (!(table in this.#schema)) throw new RangeError(`Table '${String(table)}' does not exist in schema.`);
+		for (const table of tablesToExport) if (!(table in this.#schema)) throw new RangeError(`Table '${table}' does not exist in schema.`);
 		if (tablesToExport.length === 0) return {
 			metadata: includeMetadata ? {
 				dbName: this.#name,
@@ -1619,21 +1623,22 @@ var Locality = class Locality {
 		return new Promise((resolve, reject) => {
 			transaction.onabort = () => _abortTransaction(transaction.error, reject);
 			transaction.onerror = () => reject(transaction.error);
-			const readPromises = tablesToExport.map((table) => new Promise((res, rej) => {
-				const request = transaction.objectStore(table).getAll();
-				request.onsuccess = () => {
-					exportData[table] = request.result;
-					res();
-				};
-				request.onerror = () => rej(request.error);
-			}));
+			const readPromises = tablesToExport.map((table) => {
+				return new Promise((res, rej) => {
+					const request = transaction.objectStore(table).getAll();
+					request.onsuccess = () => {
+						exportData[table] = request.result;
+						res();
+					};
+					request.onerror = () => rej(request.error);
+				});
+			});
 			Promise.all(readPromises).then(() => {
 				const exportObj = {};
-				const ts = getTimestamp();
 				if (includeMetadata) exportObj.metadata = {
 					dbName: this.#name,
 					version: this.version,
-					exportedAt: ts,
+					exportedAt: getTimestamp(),
 					tables: tablesToExport
 				};
 				exportObj.data = exportData;
@@ -1641,19 +1646,12 @@ var Locality = class Locality {
 			}).catch(reject);
 		});
 	}
-	/**
-	* @instance Import data into the database.
-	*
-	* @remarks
-	* - Accepts either raw table data or an {@link ExportData} object.
-	* - Supports merge, replace, and upsert modes.
-	*/
 	async import(data, options) {
 		await this.#readyPromise;
 		const { mode = "merge", tables } = options || {};
 		const dataMap = "data" in data ? data.data : data;
 		const tablesToImport = tables ?? Object.keys(dataMap);
-		for (const table of tablesToImport) if (!(table in this.#schema)) throw new RangeError(`Table '${String(table)}' does not exist in schema.`);
+		for (const table of tablesToImport) if (!(table in this.#schema)) throw new RangeError(`Table '${table}' does not exist in schema.`);
 		if (tablesToImport.length === 0) return;
 		const transaction = this.#db.transaction(tablesToImport, "readwrite");
 		return new Promise((resolve, reject) => {
@@ -1670,7 +1668,7 @@ var Locality = class Locality {
 				if (rows.length === 0) return;
 				const writePromises = rows.map((row) => {
 					return new Promise((res, rej) => {
-						const prepared = validateAndPrepareData(row, this.#schema[table].columns, this.#keyPaths[table], String(table));
+						const prepared = validateAndPrepareData(row, this.#schema[table].columns, this.#keyPaths[table], table);
 						const request = mode === "upsert" ? store.put(prepared) : store.add(prepared);
 						request.onsuccess = () => res();
 						request.onerror = () => rej(request.error);
@@ -1693,11 +1691,13 @@ var Locality = class Locality {
 		return new Promise((resolve, reject) => {
 			transaction.onabort = () => _abortTransaction(transaction.error, reject);
 			transaction.onerror = () => reject(transaction.error);
-			const clearPromises = tables.map((table) => new Promise((res, rej) => {
-				const request = transaction.objectStore(table).clear();
-				request.onsuccess = () => res();
-				request.onerror = () => rej(request.error);
-			}));
+			const clearPromises = tables.map((table) => {
+				return new Promise((res, rej) => {
+					const request = transaction.objectStore(table).clear();
+					request.onsuccess = () => res();
+					request.onerror = () => rej(request.error);
+				});
+			});
 			Promise.all(clearPromises).then(() => resolve()).catch((err) => {
 				transaction.abort();
 				reject(err);
@@ -1713,23 +1713,23 @@ var Locality = class Locality {
 	*/
 	async dropTable(table) {
 		await this.#readyPromise;
-		if (!(table in this.#schema)) throw new RangeError(`Table '${String(table)}' does not exist in schema.`);
+		if (!(table in this.#schema)) throw new RangeError(`Table '${table}' does not exist in schema.`);
 		const nextStores = this.#buildStoresConfig().filter((store) => store.name !== table);
 		const nextVersion = this.version + 1;
 		this.#db.close();
 		this.#readyPromise = openDBWithStores(this.#name, nextStores, nextVersion).then((db) => {
 			this.#db = db;
 			const keyPaths = this.#keyPaths;
-			delete keyPaths[String(table)];
+			delete keyPaths[table];
 		}).finally(() => {
 			this.#version = this.#db?.version;
 		});
 		await this.#readyPromise;
 	}
 	/** @static Get the list of existing `IndexedDB` databases. */
-	static getDatabaseList() {
+	static async getDatabaseList() {
 		_ensureIndexedDB();
-		return _getDBList();
+		return await _getDBList();
 	}
 	/** @static Delete an `IndexedDB` database by name. */
 	static async deleteDatabase(name) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "locality-idb",
-  "version": "1.5.0",
+  "version": "1.5.1",
   "description": "SQL-like query builder for IndexedDB with Drizzle-style API",
   "type": "module",
   "sideEffects": false,