@ultimat3/db 19.4.0 → 20.1.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ultimat3/db",
-  "version": "19.4.0",
+  "version": "20.1.0",
   "description": "Postgres access, transactions, migrations and drift detection",
   "license": "MIT",
   "type": "module",
@@ -31,7 +31,7 @@
     "test": "bun test"
   },
   "dependencies": {
-    "@ultimat3/core": "19.4.0"
+    "@ultimat3/core": "20.1.0"
   },
   "peerDependencies": {
     "@electric-sql/pglite": ">=0.5.0"

package/src/index.ts

@@ -160,6 +160,8 @@ export {
   loadPgliteDriver,
   PGLITE_FIX,
   PGLITE_MEMORY,
+  PGLITE_MISSING,
+  PGLITE_PACKAGE,
   pgliteDataDir,
 } from './pglite';
 export type { PgliteBranchInfo, PgliteBranchOptions } from './pglite-branch';

package/src/pglite.ts

@@ -53,7 +53,20 @@ export const PGLITE_MEMORY = 'memory://';
 
 const PGLITE_URL = 'pglite://';
 
-const PGLITE_PACKAGE = '@electric-sql/pglite';
+/**
+ * The optional peer's specifier. Exported because `x doctor` asks whether it RESOLVES — a resolve,
+ * never an import, since loading it boots the WASM build and takes the single-writer lock — and a
+ * diagnostic that spelled the package name a second time is a diagnostic that can name the wrong
+ * one after a rename.
+ */
+export const PGLITE_PACKAGE = '@electric-sql/pglite';
+
+/**
+ * Why there is no embedded database when that specifier does not resolve. One sentence, shared:
+ * `x doctor` reports this condition BEFORE any query reaches this module, and two wordings for one
+ * cause are two answers to "what do I do".
+ */
+export const PGLITE_MISSING = `${PGLITE_PACKAGE} is not installed, so there is no embedded database`;
 
 /**
  * The specifier is held in a variable on purpose: a literal would make every consumer's `tsc`
@@ -90,7 +103,7 @@ export async function loadPgliteDriver(options: PgliteOptions = {}): Promise<Pgl
   try {
     loaded = await (options.load ?? importPglite)();
   } catch (error) {
-    throw missing(`${PGLITE_PACKAGE} is not installed, so there is no embedded database`, error);
+    throw missing(PGLITE_MISSING, error);
   }
   const PGlite = pgliteConstructor(loaded);
   try {