@easy-cms/db-postgres 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Kanawoot K.
+
+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,25 @@
+# @easy-cms/db-postgres
+
+PostgreSQL adapter for [Easy CMS](https://github.com/maritonx/easy-crm).
+
+```ts
+import { postgres } from '@easy-cms/db-postgres'
+
+export default defineConfig({
+  db: process.env.DATABASE_URL
+    ? postgres({ url: process.env.DATABASE_URL }) // a Postgres server, via postgres.js
+    : postgres({ pglite: '.pglite' }), // Postgres in WebAssembly for local development
+  // ...
+})
+```
+
+| Option | Default | |
+|---|---|---|
+| `url` | — | Connection string |
+| `max` | `10` | Pool size |
+| `pglite` | — | Data directory (relative to the project), `memory://`, or a `PGlite` instance. Needs `@electric-sql/pglite`. |
+| `tablePrefix` | `ecms_` | Prefix of every table Easy CMS creates |
+| `migrationDir` | `easy-cms/migrations` | Where migration files are written |
+
+Migration files record the database they were made for; files created for SQLite are refused.
+Text sorting follows the database collation (server defaults like `en_US.UTF-8` sort case-insensitively).

package/dist/index.d.ts

@@ -0,0 +1,22 @@
+import { DatabaseAdapter } from '@easy-cms/core';
+import { DrizzleAdapterOptions, Dialect } from '@easy-cms/drizzle';
+export { DEFAULT_MIGRATION_DIR, DEFAULT_TABLE_PREFIX } from '@easy-cms/drizzle';
+import { PGlite } from '@electric-sql/pglite';
+
+interface PostgresAdapterOptions extends DrizzleAdapterOptions {
+    /** Connection string, e.g. `postgres://user:pass@host:5432/db`. Uses postgres.js. */
+    readonly url?: string;
+    /** Maximum connections in the pool. Default 10. */
+    readonly max?: number;
+    /**
+     * Use PGlite (Postgres in WebAssembly) instead of a server: a data directory
+     * (relative to the project root), `memory://`, or a PGlite instance you manage.
+     * Handy for local development and tests. Requires `@electric-sql/pglite`.
+     */
+    readonly pglite?: string | PGlite;
+}
+declare const postgresDialect: Dialect;
+/** PostgreSQL database adapter (postgres.js, or PGlite for local use). */
+declare function postgres(options: PostgresAdapterOptions): DatabaseAdapter;
+
+export { type PostgresAdapterOptions, postgres, postgresDialect };

package/dist/index.js

@@ -0,0 +1,105 @@
+// src/index.ts
+import { isAbsolute, resolve } from "path";
+import {
+  connectDatabase
+} from "@easy-cms/drizzle";
+import { sql } from "drizzle-orm";
+import {
+  boolean,
+  doublePrecision,
+  index,
+  integer,
+  jsonb,
+  pgTable,
+  serial,
+  text,
+  uniqueIndex
+} from "drizzle-orm/pg-core";
+import { drizzle as drizzlePostgresJs } from "drizzle-orm/postgres-js";
+import postgresJs from "postgres";
+import { DEFAULT_MIGRATION_DIR, DEFAULT_TABLE_PREFIX } from "@easy-cms/drizzle";
+var kit = () => import("drizzle-kit/api");
+var postgresDialect = {
+  name: "postgres",
+  table: (name, columns, indexes) => pgTable(name, columns, indexes),
+  index: (name) => index(name),
+  uniqueIndex: (name) => uniqueIndex(name),
+  serial: (name) => serial(name).primaryKey(),
+  text: (name) => text(name),
+  integer: (name) => integer(name),
+  number: (name) => doublePrecision(name),
+  boolean: (name) => boolean(name),
+  json: (name) => jsonb(name),
+  like: (column, pattern) => sql`${column} ILIKE ${pattern} ESCAPE '\\'`,
+  param: (n) => `$${n}`,
+  migrationsTableSQL: (name) => `CREATE TABLE IF NOT EXISTS "${name}" (
+      "id" serial PRIMARY KEY NOT NULL,
+      "name" text NOT NULL UNIQUE,
+      "hash" text,
+      "snapshot" text,
+      "applied_at" text NOT NULL
+    )`,
+  snapshot: async (tables) => (await kit()).generateDrizzleJson({ ...tables }),
+  migration: async (prev, cur) => (await kit()).generateMigration(prev, cur)
+};
+function postgres(options) {
+  if (!options.url && !options.pglite) {
+    throw new Error("@easy-cms/db-postgres: pass `url` (a connection string) or `pglite`");
+  }
+  return {
+    name: "postgres",
+    init: async (args) => {
+      const connection = options.pglite ? await pgliteConnection(options.pglite, args.cwd) : postgresJsConnection(options.url, options.max ?? 10);
+      return connectDatabase(postgresDialect, connection, args, options);
+    }
+  };
+}
+function postgresJsConnection(url, max) {
+  const client = postgresJs(url, { max, onnotice: () => {
+  } });
+  const runner = {
+    async query(text2, params = []) {
+      return [...await client.unsafe(text2, [...params])];
+    },
+    async transaction(statements) {
+      await client.begin(async (tx) => {
+        for (const s of statements) await tx.unsafe(s.sql, [...s.params ?? []]);
+      });
+    }
+  };
+  return { db: drizzlePostgresJs(client), runner, close: () => client.end({ timeout: 5 }) };
+}
+async function pgliteConnection(source, cwd) {
+  const owned = typeof source === "string";
+  let pg;
+  if (typeof source === "string") {
+    const { PGlite } = await import("@electric-sql/pglite");
+    const dataDir = source.includes("://") || isAbsolute(source) ? source : resolve(cwd, source);
+    pg = new PGlite(dataDir);
+  } else {
+    pg = source;
+  }
+  await pg.waitReady;
+  const { drizzle } = await import("drizzle-orm/pglite");
+  const runner = {
+    async query(text2, params = []) {
+      return (await pg.query(text2, [...params])).rows;
+    },
+    async transaction(statements) {
+      await pg.transaction(async (tx) => {
+        for (const s of statements) await tx.query(s.sql, [...s.params ?? []]);
+      });
+    }
+  };
+  return {
+    db: drizzle({ client: pg }),
+    runner,
+    close: async () => owned ? pg.close() : void 0
+  };
+}
+export {
+  DEFAULT_MIGRATION_DIR,
+  DEFAULT_TABLE_PREFIX,
+  postgres,
+  postgresDialect
+};

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@easy-cms/db-postgres",
+  "version": "0.1.0",
+  "description": "PostgreSQL database adapter for Easy CMS",
+  "license": "MIT",
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=22.12"
+  },
+  "dependencies": {
+    "drizzle-kit": "0.31.11",
+    "drizzle-orm": "0.45.3",
+    "postgres": "^3.4.9",
+    "@easy-cms/drizzle": "^0.1.0"
+  },
+  "peerDependencies": {
+    "@electric-sql/pglite": ">=0.3.0",
+    "@easy-cms/core": "^0.1.0"
+  },
+  "peerDependenciesMeta": {
+    "@electric-sql/pglite": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@electric-sql/pglite": "^0.5.8",
+    "@easy-cms/core": "^0.1.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/maritonx/easy-crm.git",
+    "directory": "packages/db-postgres"
+  },
+  "keywords": [
+    "easy-cms",
+    "postgres",
+    "postgresql",
+    "pglite",
+    "drizzle"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  }
+}