@porulle/adapter-pglite 0.9.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 unified-commerce-engine contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,44 @@
+# @porulle/adapter-pglite
+
+A **zero-infrastructure** `DatabaseAdapter` for [`@porulle/core`](https://porulle.asyncdot.com), backed by [PGlite](https://pglite.dev) — 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 — locally, in CI, in a demo, anywhere Node runs.
+
+```ts
+// commerce.config.ts
+import { defineConfig } from "@porulle/core";
+import { pgliteAdapter } from "@porulle/adapter-pglite";
+
+export default defineConfig({
+  databaseAdapter: await pgliteAdapter({ path: "./.data/pgdata" }),
+  // ...rest of your config
+});
+```
+
+That's it — `pnpm dev` and the REST API is live on a real Postgres.
+
+## Options
+
+| Option | Type | Default | Meaning |
+|---|---|---|---|
+| `path` | `string` | in-memory | Persist the DB to disk (e.g. `"./.data/pgdata"`). Omit for an ephemeral instance discarded on exit. |
+| `migrate` | `boolean` | `true` | Push the core schema on init (create tables if missing) — no separate migration step. |
+| `seedDefaultOrg` | `boolean` | `true` | Insert the default organization row so single-tenant / B2C stores work immediately. |
+
+## When to use it
+
+- **Local dev & demos** — the fastest path from `install` to a running store.
+- **Tests & CI** — real Postgres semantics without provisioning a database.
+- **Prototypes** — ship the 80% before you own any infrastructure.
+
+## Going to production
+
+PGlite is single-connection and in-process — perfect for dev, not for production scale. When you're ready, swap one line to [`@porulle/adapter-postgres`](https://porulle.asyncdot.com) — the same `DatabaseAdapter` contract, backed by a real Postgres server:
+
+```ts
+import { postgresAdapter } from "@porulle/adapter-postgres";
+
+databaseAdapter: postgresAdapter({ connectionString: process.env.DATABASE_URL! }),
+```
+
+Your data model, queries, and code are unchanged — it's the same PostgreSQL.

package/dist/index.d.ts

@@ -0,0 +1,43 @@
+import { type DatabaseAdapter } from "@porulle/core";
+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 declare function pgliteAdapter(options?: PgliteAdapterOptions): Promise<DatabaseAdapter>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAgC,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC;AAGnF,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,aAAa,CACjC,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,eAAe,CAAC,CA0B1B"}

package/dist/index.js

@@ -0,0 +1,51 @@
+import { PGlite } from "@electric-sql/pglite";
+import { drizzle } from "drizzle-orm/pglite";
+import { ensureDefaultOrg, pushSchema } from "@porulle/core";
+import * as schema from "@porulle/core/schema";
+/**
+ * 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 = {}) {
+    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(fn) {
+        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 };
+}