@porulle/adapter-pglite 0.9.0

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@porulle/adapter-pglite",
+  "version": "0.9.0",
+  "license": "MIT",
+  "type": "module",
+  "exports": {
+    ".": {
+      "bun": "./src/index.ts",
+      "import": "./dist/index.js",
+      "types": "./src/index.ts"
+    }
+  },
+  "dependencies": {
+    "@electric-sql/pglite": "^0.3.15",
+    "drizzle-kit": "^0.31.9",
+    "drizzle-orm": "^0.45.1",
+    "@porulle/core": "0.9.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.5.2",
+    "eslint": "^9.39.1",
+    "typescript": "5.9.2",
+    "vitest": "^3.2.4",
+    "@porulle/eslint-config": "0.1.0",
+    "@porulle/typescript-config": "0.1.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "src",
+    "dist",
+    "README.md"
+  ],
+  "description": "Zero-infrastructure PGlite (embedded WASM PostgreSQL) DatabaseAdapter for @porulle/core. No server, no connection string, no migration step — construct it and the store runs. Ideal for dev, demos, tests, and CI.",
+  "homepage": "https://porulle.asyncdot.com",
+  "bugs": {
+    "url": "https://github.com/asyncdotengineering/porulle/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/asyncdotengineering/porulle.git",
+    "directory": "packages/adapters/adapter-pglite"
+  },
+  "author": "Porulle contributors",
+  "scripts": {
+    "build": "rm -rf dist tsconfig.build.tsbuildinfo && tsc -p tsconfig.build.json",
+    "check-types": "tsc --noEmit",
+    "lint": "eslint . --max-warnings 1000",
+    "test": "vitest run"
+  }
+}

package/src/index.ts

@@ -0,0 +1,75 @@
+import { PGlite } from "@electric-sql/pglite";
+import { drizzle } from "drizzle-orm/pglite";
+import { ensureDefaultOrg, pushSchema, type DatabaseAdapter } from "@porulle/core";
+import * as schema from "@porulle/core/schema";
+
+export interface PgliteAdapterOptions {
+  /**
+   * Filesystem path to persist the database (e.g. `"./.data/pgdata"`). Omit for
+   * an ephemeral in-memory instance that is discarded on exit.
+   */
+  path?: string;
+  /**
+   * Push the core Drizzle schema on init (create tables if they don't exist),
+   * so there is no separate migration step. Default: `true`. Set `false` if you
+   * manage schema yourself.
+   */
+  migrate?: boolean;
+  /**
+   * Insert the default organization row after migrating, so single-tenant /
+   * B2C stores work out of the box. Default: `true`.
+   */
+  seedDefaultOrg?: boolean;
+}
+
+/**
+ * A zero-infrastructure `DatabaseAdapter` backed by PGlite — real PostgreSQL
+ * compiled to WASM, running in-process. No database server to install, no
+ * connection string, no migration command: construct it and the store runs.
+ *
+ * Ideal for local dev, demos, tests, and CI. For production, swap to
+ * `@porulle/adapter-postgres` (same `DatabaseAdapter` contract).
+ *
+ * ```ts
+ * // commerce.config.ts
+ * import { defineConfig } from "@porulle/core";
+ * import { pgliteAdapter } from "@porulle/adapter-pglite";
+ *
+ * export default defineConfig({
+ *   databaseAdapter: await pgliteAdapter({ path: "./.data/pgdata" }),
+ *   // ...
+ * });
+ * ```
+ *
+ * Requires `drizzle-kit` (used for the programmatic schema push) — it ships as a
+ * dependency of this package.
+ */
+export async function pgliteAdapter(
+  options: PgliteAdapterOptions = {},
+): Promise<DatabaseAdapter> {
+  const pg = options.path ? new PGlite(options.path) : new PGlite();
+  const db = drizzle(pg, { schema });
+
+  if (options.migrate !== false) {
+    await pushSchema(db);
+  }
+  if (options.seedDefaultOrg !== false) {
+    await ensureDefaultOrg(db);
+  }
+
+  // PGlite's Drizzle `transaction()` can deadlock under some drivers; manual
+  // BEGIN/COMMIT/ROLLBACK on the raw instance is reliable.
+  async function transaction<T>(fn: (tx: unknown) => Promise<T>): Promise<T> {
+    await pg.exec("BEGIN");
+    try {
+      const result = await fn(db);
+      await pg.exec("COMMIT");
+      return result;
+    } catch (error) {
+      await pg.exec("ROLLBACK");
+      throw error;
+    }
+  }
+
+  return { provider: "postgresql", db, transaction };
+}