@dalgoridim/headless-cms 0.1.0

package/dist/adapters/postgres/index.cjs

@@ -0,0 +1,299 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getOwnPropSymbols = Object.getOwnPropertySymbols;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __propIsEnum = Object.prototype.propertyIsEnumerable;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __spreadValues = (a, b) => {
+  for (var prop in b || (b = {}))
+    if (__hasOwnProp.call(b, prop))
+      __defNormalProp(a, prop, b[prop]);
+  if (__getOwnPropSymbols)
+    for (var prop of __getOwnPropSymbols(b)) {
+      if (__propIsEnum.call(b, prop))
+        __defNormalProp(a, prop, b[prop]);
+    }
+  return a;
+};
+var __objRest = (source, exclude) => {
+  var target = {};
+  for (var prop in source)
+    if (__hasOwnProp.call(source, prop) && exclude.indexOf(prop) < 0)
+      target[prop] = source[prop];
+  if (source != null && __getOwnPropSymbols)
+    for (var prop of __getOwnPropSymbols(source)) {
+      if (exclude.indexOf(prop) < 0 && __propIsEnum.call(source, prop))
+        target[prop] = source[prop];
+    }
+  return target;
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/adapters/postgres/index.ts
+var postgres_exports = {};
+__export(postgres_exports, {
+  PostgresDataAdapter: () => PostgresDataAdapter
+});
+module.exports = __toCommonJS(postgres_exports);
+var import_pg = require("pg");
+var import_node_crypto = require("crypto");
+var OP_MAP = {
+  eq: "=",
+  lt: "<",
+  lte: "<=",
+  gt: ">",
+  gte: ">=",
+  in: "= ANY"
+};
+var SQL_TYPE = {
+  text: "text",
+  int: "integer",
+  float: "double precision",
+  bool: "boolean",
+  date: "date",
+  timestamptz: "timestamptz",
+  jsonb: "jsonb"
+};
+var PostgresDataAdapter = class {
+  constructor(config = {}) {
+    var _a, _b;
+    if (config.pool) {
+      this.pool = config.pool;
+    } else if (config.connectionString) {
+      this.pool = new import_pg.Pool({ connectionString: config.connectionString });
+    } else {
+      throw new Error(
+        "PostgresDataAdapter requires either `pool` or `connectionString`."
+      );
+    }
+    this.collections = (_a = config.collections) != null ? _a : {};
+    this.documentsTable = (_b = config.documentsTable) != null ? _b : "documents";
+  }
+  cfg(collection) {
+    return this.collections[collection];
+  }
+  /** Create the documents table and every registered typed table if missing. */
+  async migrate() {
+    await this.pool.query(`
+      CREATE TABLE IF NOT EXISTS ${ident(this.documentsTable)} (
+        id          text NOT NULL,
+        collection  text NOT NULL,
+        data        jsonb NOT NULL,
+        created_at  timestamptz DEFAULT now(),
+        updated_at  timestamptz DEFAULT now(),
+        PRIMARY KEY (collection, id)
+      );
+    `);
+    await this.pool.query(
+      `CREATE INDEX IF NOT EXISTS ${ident(this.documentsTable + "_collection_created_idx")}
+         ON ${ident(this.documentsTable)} (collection, created_at DESC);`
+    );
+    for (const cfg of Object.values(this.collections)) {
+      const cols = Object.entries(cfg.columns).map(([name, type]) => `${ident(name)} ${SQL_TYPE[type]}`).join(",\n        ");
+      await this.pool.query(`
+        CREATE TABLE IF NOT EXISTS ${ident(cfg.table)} (
+          id          text PRIMARY KEY,
+          ${cols ? cols + "," : ""}
+          extra       jsonb NOT NULL DEFAULT '{}'::jsonb,
+          created_at  timestamptz DEFAULT now(),
+          updated_at  timestamptz DEFAULT now()
+        );
+      `);
+    }
+  }
+  // --- row <-> section mapping ------------------------------------------------
+  /** Split a section into typed columns + leftover `extra`. */
+  toTypedRow(cfg, data) {
+    const known = {};
+    const extra = {};
+    for (const [key, value] of Object.entries(data)) {
+      if (key === "id" || key === "collection") continue;
+      if (key in cfg.columns) known[key] = value;
+      else extra[key] = value;
+    }
+    return { known, extra };
+  }
+  fromTypedRow(collection, cfg, row) {
+    const _a = row, { id, extra, created_at, updated_at } = _a, rest = __objRest(_a, ["id", "extra", "created_at", "updated_at"]);
+    void created_at;
+    void updated_at;
+    return __spreadValues(__spreadValues({
+      id,
+      collection
+    }, rest), extra != null ? extra : {});
+  }
+  // --- reads -----------------------------------------------------------------
+  async fetchById(collection, id) {
+    const cfg = this.cfg(collection);
+    if (cfg) {
+      const { rows: rows2 } = await this.pool.query(
+        `SELECT * FROM ${ident(cfg.table)} WHERE id = $1`,
+        [id]
+      );
+      if (!rows2[0]) return null;
+      return this.fromTypedRow(collection, cfg, rows2[0]);
+    }
+    const { rows } = await this.pool.query(
+      `SELECT id, data FROM ${ident(this.documentsTable)} WHERE id = $1 AND collection = $2`,
+      [id, collection]
+    );
+    if (!rows[0]) return null;
+    return __spreadValues({ id: rows[0].id, collection }, rows[0].data);
+  }
+  async fetchCollection(collection, q) {
+    var _a, _b;
+    const cfg = this.cfg(collection);
+    const params = [];
+    const where = [];
+    const colExpr = (field) => {
+      if (cfg) {
+        return field in cfg.columns ? ident(field) : `extra->>${literal(field)}`;
+      }
+      return `data->>${literal(field)}`;
+    };
+    if (!cfg) {
+      params.push(collection);
+      where.push(`collection = $${params.length}`);
+    }
+    for (const f of (_a = q == null ? void 0 : q.filters) != null ? _a : []) {
+      params.push(f.value);
+      if (f.op === "in") {
+        where.push(`${colExpr(f.field)} = ANY($${params.length})`);
+      } else {
+        where.push(`${colExpr(f.field)} ${OP_MAP[f.op]} $${params.length}`);
+      }
+    }
+    const orderBy = ((_b = q == null ? void 0 : q.orderBy) != null ? _b : []).map((o) => `${colExpr(o.field)} ${o.direction === "asc" ? "ASC" : "DESC"}`).join(", ") || "created_at DESC";
+    const limit = (q == null ? void 0 : q.limit) != null ? ` LIMIT ${Number(q.limit)}` : "";
+    const whereSql = where.length ? ` WHERE ${where.join(" AND ")}` : "";
+    const table = cfg ? cfg.table : this.documentsTable;
+    const select = cfg ? "*" : "id, data";
+    const { rows } = await this.pool.query(
+      `SELECT ${select} FROM ${ident(table)}${whereSql} ORDER BY ${orderBy}${limit}`,
+      params
+    );
+    if (cfg) {
+      return rows.map((r) => this.fromTypedRow(collection, cfg, r));
+    }
+    return rows.map((r) => __spreadValues({ id: r.id, collection }, r.data));
+  }
+  // --- writes ----------------------------------------------------------------
+  async create(collection, data) {
+    return this.createWithId(collection, (0, import_node_crypto.randomUUID)(), data);
+  }
+  async createWithId(collection, id, data) {
+    const cfg = this.cfg(collection);
+    const record = data;
+    if (cfg) {
+      const { known, extra } = this.toTypedRow(cfg, record);
+      const cols = ["id", ...Object.keys(known), "extra"];
+      const vals = [id, ...Object.values(known), JSON.stringify(extra)];
+      const placeholders = cols.map((_, i) => `$${i + 1}`).join(", ");
+      await this.pool.query(
+        `INSERT INTO ${ident(cfg.table)} (${cols.map(ident).join(", ")})
+           VALUES (${placeholders})`,
+        vals
+      );
+    } else {
+      await this.pool.query(
+        `INSERT INTO ${ident(this.documentsTable)} (id, collection, data)
+           VALUES ($1, $2, $3)`,
+        [id, collection, JSON.stringify(record)]
+      );
+    }
+    return __spreadValues({ id }, data);
+  }
+  async update(collection, id, data) {
+    await this.write(collection, id, data, "update");
+  }
+  async upsert(collection, id, data) {
+    await this.write(collection, id, data, "upsert");
+  }
+  async write(collection, id, data, mode) {
+    const cfg = this.cfg(collection);
+    if (cfg) {
+      const { known, extra } = this.toTypedRow(cfg, data);
+      const setCols = Object.keys(known);
+      const setExpr = setCols.map((c, i) => `${ident(c)} = $${i + 2}`).join(", ");
+      const extraIdx = setCols.length + 2;
+      const sets = [
+        setExpr,
+        // Table-qualified: in ON CONFLICT DO UPDATE both the target table and the
+        // `excluded` pseudo-relation expose `extra`, so a bare ref is ambiguous.
+        `extra = ${ident(cfg.table)}.${ident("extra")} || $${extraIdx}::jsonb`,
+        `updated_at = now()`
+      ].filter(Boolean).join(", ");
+      const params = [id, ...Object.values(known), JSON.stringify(extra)];
+      if (mode === "upsert") {
+        const insertCols = ["id", ...setCols, "extra"];
+        const insertVals = params;
+        const placeholders = insertCols.map((_, i) => `$${i + 1}`).join(", ");
+        await this.pool.query(
+          `INSERT INTO ${ident(cfg.table)} (${insertCols.map(ident).join(", ")})
+             VALUES (${placeholders})
+             ON CONFLICT (id) DO UPDATE SET ${sets}`,
+          insertVals
+        );
+      } else {
+        await this.pool.query(
+          `UPDATE ${ident(cfg.table)} SET ${sets} WHERE id = $1`,
+          params
+        );
+      }
+      return;
+    }
+    if (mode === "upsert") {
+      await this.pool.query(
+        `INSERT INTO ${ident(this.documentsTable)} (id, collection, data)
+           VALUES ($1, $2, $3)
+           ON CONFLICT (collection, id) DO UPDATE
+             SET data = ${ident(this.documentsTable)}.data || $3::jsonb,
+                 updated_at = now()`,
+        [id, collection, JSON.stringify(data)]
+      );
+    } else {
+      await this.pool.query(
+        `UPDATE ${ident(this.documentsTable)}
+           SET data = data || $2::jsonb, updated_at = now()
+           WHERE id = $1 AND collection = $3`,
+        [id, JSON.stringify(data), collection]
+      );
+    }
+  }
+  async delete(collection, id) {
+    const cfg = this.cfg(collection);
+    if (cfg) {
+      await this.pool.query(`DELETE FROM ${ident(cfg.table)} WHERE id = $1`, [id]);
+    } else {
+      await this.pool.query(
+        `DELETE FROM ${ident(this.documentsTable)} WHERE id = $1 AND collection = $2`,
+        [id, collection]
+      );
+    }
+  }
+};
+function ident(name) {
+  return `"${name.replace(/"/g, '""')}"`;
+}
+function literal(value) {
+  return `'${value.replace(/'/g, "''")}'`;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  PostgresDataAdapter
+});
+//# sourceMappingURL=index.cjs.map

package/dist/adapters/postgres/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/adapters/postgres/index.ts"],"sourcesContent":["import { Pool } from \"pg\";\nimport { randomUUID } from \"node:crypto\";\nimport type { DataAdapter, Query, QueryFilterOp } from \"../../types\";\n\n/** Column type hints for a registered (typed) collection. */\nexport type ColumnType = \"text\" | \"int\" | \"float\" | \"bool\" | \"date\" | \"timestamptz\" | \"jsonb\";\n\nexport interface CollectionConfig {\n  /** Physical table name. */\n  table: string;\n  /** Map of section field → SQL column type. Unlisted fields fall into `extra`. */\n  columns: Record<string, ColumnType>;\n}\n\nexport interface PostgresAdapterConfig {\n  /** Provide a connection string… */\n  connectionString?: string;\n  /** …or an existing pg Pool. */\n  pool?: Pool;\n  /**\n   * Registry of typed collections. Anything not registered here is stored in\n   * the shared JSONB `documents` table.\n   */\n  collections?: Record<string, CollectionConfig>;\n  /** Name of the fallback JSONB table. Default `documents`. */\n  documentsTable?: string;\n}\n\nconst OP_MAP: Record<QueryFilterOp, string> = {\n  eq: \"=\",\n  lt: \"<\",\n  lte: \"<=\",\n  gt: \">\",\n  gte: \">=\",\n  in: \"= ANY\",\n};\n\nconst SQL_TYPE: Record<ColumnType, string> = {\n  text: \"text\",\n  int: \"integer\",\n  float: \"double precision\",\n  bool: \"boolean\",\n  date: \"date\",\n  timestamptz: \"timestamptz\",\n  jsonb: \"jsonb\",\n};\n\n/**\n * Hybrid Postgres adapter. Unregistered collections live in a shared JSONB\n * `documents` table; registered collections map flat section fields onto typed\n * columns, with a JSONB `extra` column so unmapped fields are never dropped.\n */\nexport class PostgresDataAdapter implements DataAdapter {\n  private readonly pool: Pool;\n  private readonly collections: Record<string, CollectionConfig>;\n  private readonly documentsTable: string;\n\n  constructor(config: PostgresAdapterConfig = {}) {\n    if (config.pool) {\n      this.pool = config.pool;\n    } else if (config.connectionString) {\n      this.pool = new Pool({ connectionString: config.connectionString });\n    } else {\n      throw new Error(\n        \"PostgresDataAdapter requires either `pool` or `connectionString`.\",\n      );\n    }\n    this.collections = config.collections ?? {};\n    this.documentsTable = config.documentsTable ?? \"documents\";\n  }\n\n  private cfg(collection: string): CollectionConfig | undefined {\n    return this.collections[collection];\n  }\n\n  /** Create the documents table and every registered typed table if missing. */\n  async migrate(): Promise<void> {\n    await this.pool.query(`\n      CREATE TABLE IF NOT EXISTS ${ident(this.documentsTable)} (\n        id          text NOT NULL,\n        collection  text NOT NULL,\n        data        jsonb NOT NULL,\n        created_at  timestamptz DEFAULT now(),\n        updated_at  timestamptz DEFAULT now(),\n        PRIMARY KEY (collection, id)\n      );\n    `);\n    await this.pool.query(\n      `CREATE INDEX IF NOT EXISTS ${ident(this.documentsTable + \"_collection_created_idx\")}\n         ON ${ident(this.documentsTable)} (collection, created_at DESC);`,\n    );\n\n    for (const cfg of Object.values(this.collections)) {\n      const cols = Object.entries(cfg.columns)\n        .map(([name, type]) => `${ident(name)} ${SQL_TYPE[type]}`)\n        .join(\",\\n        \");\n      await this.pool.query(`\n        CREATE TABLE IF NOT EXISTS ${ident(cfg.table)} (\n          id          text PRIMARY KEY,\n          ${cols ? cols + \",\" : \"\"}\n          extra       jsonb NOT NULL DEFAULT '{}'::jsonb,\n          created_at  timestamptz DEFAULT now(),\n          updated_at  timestamptz DEFAULT now()\n        );\n      `);\n    }\n  }\n\n  // --- row <-> section mapping ------------------------------------------------\n\n  /** Split a section into typed columns + leftover `extra`. */\n  private toTypedRow(cfg: CollectionConfig, data: Record<string, unknown>) {\n    const known: Record<string, unknown> = {};\n    const extra: Record<string, unknown> = {};\n    for (const [key, value] of Object.entries(data)) {\n      if (key === \"id\" || key === \"collection\") continue;\n      if (key in cfg.columns) known[key] = value;\n      else extra[key] = value;\n    }\n    return { known, extra };\n  }\n\n  private fromTypedRow(\n    collection: string,\n    cfg: CollectionConfig,\n    row: Record<string, unknown>,\n  ) {\n    const { id, extra, created_at, updated_at, ...rest } = row;\n    void created_at;\n    void updated_at;\n    return {\n      id: id as string,\n      collection,\n      ...(rest as Record<string, unknown>),\n      ...((extra as Record<string, unknown>) ?? {}),\n    };\n  }\n\n  // --- reads -----------------------------------------------------------------\n\n  async fetchById<T = Record<string, unknown>>(\n    collection: string,\n    id: string,\n  ): Promise<(T & { id: string }) | null> {\n    const cfg = this.cfg(collection);\n    if (cfg) {\n      const { rows } = await this.pool.query(\n        `SELECT * FROM ${ident(cfg.table)} WHERE id = $1`,\n        [id],\n      );\n      if (!rows[0]) return null;\n      return this.fromTypedRow(collection, cfg, rows[0]) as unknown as T & {\n        id: string;\n      };\n    }\n    const { rows } = await this.pool.query(\n      `SELECT id, data FROM ${ident(this.documentsTable)} WHERE id = $1 AND collection = $2`,\n      [id, collection],\n    );\n    if (!rows[0]) return null;\n    return { id: rows[0].id, collection, ...rows[0].data } as unknown as T & {\n      id: string;\n    };\n  }\n\n  async fetchCollection<T = Record<string, unknown>>(\n    collection: string,\n    q?: Query,\n  ): Promise<(T & { id: string })[]> {\n    const cfg = this.cfg(collection);\n    const params: unknown[] = [];\n    const where: string[] = [];\n\n    const colExpr = (field: string): string => {\n      if (cfg) {\n        return field in cfg.columns ? ident(field) : `extra->>${literal(field)}`;\n      }\n      return `data->>${literal(field)}`;\n    };\n\n    if (!cfg) {\n      params.push(collection);\n      where.push(`collection = $${params.length}`);\n    }\n\n    for (const f of q?.filters ?? []) {\n      params.push(f.value);\n      if (f.op === \"in\") {\n        where.push(`${colExpr(f.field)} = ANY($${params.length})`);\n      } else {\n        where.push(`${colExpr(f.field)} ${OP_MAP[f.op]} $${params.length}`);\n      }\n    }\n\n    const orderBy =\n      (q?.orderBy ?? []).map((o) => `${colExpr(o.field)} ${o.direction === \"asc\" ? \"ASC\" : \"DESC\"}`).join(\", \") ||\n      \"created_at DESC\";\n\n    const limit = q?.limit != null ? ` LIMIT ${Number(q.limit)}` : \"\";\n    const whereSql = where.length ? ` WHERE ${where.join(\" AND \")}` : \"\";\n    const table = cfg ? cfg.table : this.documentsTable;\n    const select = cfg ? \"*\" : \"id, data\";\n\n    const { rows } = await this.pool.query(\n      `SELECT ${select} FROM ${ident(table)}${whereSql} ORDER BY ${orderBy}${limit}`,\n      params,\n    );\n\n    if (cfg) {\n      return rows.map((r) => this.fromTypedRow(collection, cfg, r)) as unknown as (T & {\n        id: string;\n      })[];\n    }\n    return rows.map((r) => ({ id: r.id, collection, ...r.data })) as unknown as (T & {\n      id: string;\n    })[];\n  }\n\n  // --- writes ----------------------------------------------------------------\n\n  async create<T = Record<string, unknown>>(\n    collection: string,\n    data: T,\n  ): Promise<T & { id: string }> {\n    return this.createWithId(collection, randomUUID(), data);\n  }\n\n  async createWithId<T = Record<string, unknown>>(\n    collection: string,\n    id: string,\n    data: T,\n  ): Promise<T & { id: string }> {\n    const cfg = this.cfg(collection);\n    const record = data as Record<string, unknown>;\n\n    if (cfg) {\n      const { known, extra } = this.toTypedRow(cfg, record);\n      const cols = [\"id\", ...Object.keys(known), \"extra\"];\n      const vals = [id, ...Object.values(known), JSON.stringify(extra)];\n      const placeholders = cols.map((_, i) => `$${i + 1}`).join(\", \");\n      await this.pool.query(\n        `INSERT INTO ${ident(cfg.table)} (${cols.map(ident).join(\", \")})\n           VALUES (${placeholders})`,\n        vals,\n      );\n    } else {\n      await this.pool.query(\n        `INSERT INTO ${ident(this.documentsTable)} (id, collection, data)\n           VALUES ($1, $2, $3)`,\n        [id, collection, JSON.stringify(record)],\n      );\n    }\n    return { id, ...(data as T) };\n  }\n\n  async update<T = Record<string, unknown>>(\n    collection: string,\n    id: string,\n    data: Partial<T>,\n  ): Promise<void> {\n    await this.write(collection, id, data, \"update\");\n  }\n\n  async upsert<T = Record<string, unknown>>(\n    collection: string,\n    id: string,\n    data: Partial<T>,\n  ): Promise<void> {\n    await this.write(collection, id, data, \"upsert\");\n  }\n\n  private async write(\n    collection: string,\n    id: string,\n    data: Record<string, unknown>,\n    mode: \"update\" | \"upsert\",\n  ): Promise<void> {\n    const cfg = this.cfg(collection);\n\n    if (cfg) {\n      const { known, extra } = this.toTypedRow(cfg, data);\n      const setCols = Object.keys(known);\n      const setExpr = setCols\n        .map((c, i) => `${ident(c)} = $${i + 2}`)\n        .join(\", \");\n      // Merge into extra so unmapped fields aren't dropped.\n      const extraIdx = setCols.length + 2;\n      const sets = [\n        setExpr,\n        // Table-qualified: in ON CONFLICT DO UPDATE both the target table and the\n        // `excluded` pseudo-relation expose `extra`, so a bare ref is ambiguous.\n        `extra = ${ident(cfg.table)}.${ident(\"extra\")} || $${extraIdx}::jsonb`,\n        `updated_at = now()`,\n      ]\n        .filter(Boolean)\n        .join(\", \");\n      const params = [id, ...Object.values(known), JSON.stringify(extra)];\n\n      if (mode === \"upsert\") {\n        const insertCols = [\"id\", ...setCols, \"extra\"];\n        const insertVals = params;\n        const placeholders = insertCols.map((_, i) => `$${i + 1}`).join(\", \");\n        await this.pool.query(\n          `INSERT INTO ${ident(cfg.table)} (${insertCols.map(ident).join(\", \")})\n             VALUES (${placeholders})\n             ON CONFLICT (id) DO UPDATE SET ${sets}`,\n          insertVals,\n        );\n      } else {\n        await this.pool.query(\n          `UPDATE ${ident(cfg.table)} SET ${sets} WHERE id = $1`,\n          params,\n        );\n      }\n      return;\n    }\n\n    // JSONB documents table: shallow-merge the patch into `data`.\n    if (mode === \"upsert\") {\n      await this.pool.query(\n        `INSERT INTO ${ident(this.documentsTable)} (id, collection, data)\n           VALUES ($1, $2, $3)\n           ON CONFLICT (collection, id) DO UPDATE\n             SET data = ${ident(this.documentsTable)}.data || $3::jsonb,\n                 updated_at = now()`,\n        [id, collection, JSON.stringify(data)],\n      );\n    } else {\n      await this.pool.query(\n        `UPDATE ${ident(this.documentsTable)}\n           SET data = data || $2::jsonb, updated_at = now()\n           WHERE id = $1 AND collection = $3`,\n        [id, JSON.stringify(data), collection],\n      );\n    }\n  }\n\n  async delete(collection: string, id: string): Promise<void> {\n    const cfg = this.cfg(collection);\n    if (cfg) {\n      await this.pool.query(`DELETE FROM ${ident(cfg.table)} WHERE id = $1`, [id]);\n    } else {\n      await this.pool.query(\n        `DELETE FROM ${ident(this.documentsTable)} WHERE id = $1 AND collection = $2`,\n        [id, collection],\n      );\n    }\n  }\n}\n\n/** Quote a SQL identifier safely. */\nfunction ident(name: string): string {\n  return `\"${name.replace(/\"/g, '\"\"')}\"`;\n}\n\n/** Quote a SQL string literal (used for static jsonb keys, never user values). */\nfunction literal(value: string): string {\n  return `'${value.replace(/'/g, \"''\")}'`;\n}\n"],"mappings":"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","names":["rows"]}

package/dist/adapters/postgres/index.d.cts

@@ -0,0 +1,59 @@
+import { Pool } from 'pg';
+import { DataAdapter, Query } from '../../index.cjs';
+
+/** Column type hints for a registered (typed) collection. */
+type ColumnType = "text" | "int" | "float" | "bool" | "date" | "timestamptz" | "jsonb";
+interface CollectionConfig {
+    /** Physical table name. */
+    table: string;
+    /** Map of section field → SQL column type. Unlisted fields fall into `extra`. */
+    columns: Record<string, ColumnType>;
+}
+interface PostgresAdapterConfig {
+    /** Provide a connection string… */
+    connectionString?: string;
+    /** …or an existing pg Pool. */
+    pool?: Pool;
+    /**
+     * Registry of typed collections. Anything not registered here is stored in
+     * the shared JSONB `documents` table.
+     */
+    collections?: Record<string, CollectionConfig>;
+    /** Name of the fallback JSONB table. Default `documents`. */
+    documentsTable?: string;
+}
+/**
+ * Hybrid Postgres adapter. Unregistered collections live in a shared JSONB
+ * `documents` table; registered collections map flat section fields onto typed
+ * columns, with a JSONB `extra` column so unmapped fields are never dropped.
+ */
+declare class PostgresDataAdapter implements DataAdapter {
+    private readonly pool;
+    private readonly collections;
+    private readonly documentsTable;
+    constructor(config?: PostgresAdapterConfig);
+    private cfg;
+    /** Create the documents table and every registered typed table if missing. */
+    migrate(): Promise<void>;
+    /** Split a section into typed columns + leftover `extra`. */
+    private toTypedRow;
+    private fromTypedRow;
+    fetchById<T = Record<string, unknown>>(collection: string, id: string): Promise<(T & {
+        id: string;
+    }) | null>;
+    fetchCollection<T = Record<string, unknown>>(collection: string, q?: Query): Promise<(T & {
+        id: string;
+    })[]>;
+    create<T = Record<string, unknown>>(collection: string, data: T): Promise<T & {
+        id: string;
+    }>;
+    createWithId<T = Record<string, unknown>>(collection: string, id: string, data: T): Promise<T & {
+        id: string;
+    }>;
+    update<T = Record<string, unknown>>(collection: string, id: string, data: Partial<T>): Promise<void>;
+    upsert<T = Record<string, unknown>>(collection: string, id: string, data: Partial<T>): Promise<void>;
+    private write;
+    delete(collection: string, id: string): Promise<void>;
+}
+
+export { type CollectionConfig, type ColumnType, type PostgresAdapterConfig, PostgresDataAdapter };

package/dist/adapters/postgres/index.d.ts

@@ -0,0 +1,59 @@
+import { Pool } from 'pg';
+import { DataAdapter, Query } from '../../index.js';
+
+/** Column type hints for a registered (typed) collection. */
+type ColumnType = "text" | "int" | "float" | "bool" | "date" | "timestamptz" | "jsonb";
+interface CollectionConfig {
+    /** Physical table name. */
+    table: string;
+    /** Map of section field → SQL column type. Unlisted fields fall into `extra`. */
+    columns: Record<string, ColumnType>;
+}
+interface PostgresAdapterConfig {
+    /** Provide a connection string… */
+    connectionString?: string;
+    /** …or an existing pg Pool. */
+    pool?: Pool;
+    /**
+     * Registry of typed collections. Anything not registered here is stored in
+     * the shared JSONB `documents` table.
+     */
+    collections?: Record<string, CollectionConfig>;
+    /** Name of the fallback JSONB table. Default `documents`. */
+    documentsTable?: string;
+}
+/**
+ * Hybrid Postgres adapter. Unregistered collections live in a shared JSONB
+ * `documents` table; registered collections map flat section fields onto typed
+ * columns, with a JSONB `extra` column so unmapped fields are never dropped.
+ */
+declare class PostgresDataAdapter implements DataAdapter {
+    private readonly pool;
+    private readonly collections;
+    private readonly documentsTable;
+    constructor(config?: PostgresAdapterConfig);
+    private cfg;
+    /** Create the documents table and every registered typed table if missing. */
+    migrate(): Promise<void>;
+    /** Split a section into typed columns + leftover `extra`. */
+    private toTypedRow;
+    private fromTypedRow;
+    fetchById<T = Record<string, unknown>>(collection: string, id: string): Promise<(T & {
+        id: string;
+    }) | null>;
+    fetchCollection<T = Record<string, unknown>>(collection: string, q?: Query): Promise<(T & {
+        id: string;
+    })[]>;
+    create<T = Record<string, unknown>>(collection: string, data: T): Promise<T & {
+        id: string;
+    }>;
+    createWithId<T = Record<string, unknown>>(collection: string, id: string, data: T): Promise<T & {
+        id: string;
+    }>;
+    update<T = Record<string, unknown>>(collection: string, id: string, data: Partial<T>): Promise<void>;
+    upsert<T = Record<string, unknown>>(collection: string, id: string, data: Partial<T>): Promise<void>;
+    private write;
+    delete(collection: string, id: string): Promise<void>;
+}
+
+export { type CollectionConfig, type ColumnType, type PostgresAdapterConfig, PostgresDataAdapter };