@dalgoridim/headless-cms 0.6.0 → 0.7.0

package/README.md

@@ -335,9 +335,16 @@ const data = new PostgresDataAdapter({
     projects: { table: "projects", columns: { title: "text", views: "int", date: "date" } },
   },
 });
-await data.migrate(); // creates documents + registered tables if missing
+await data.migrate(); // creates tables if missing, then adds any new columns
 ```
 
+`migrate()` is **additive and idempotent**: it creates missing tables and
+`ALTER TABLE ... ADD COLUMN IF NOT EXISTS` for every registered column, so adding
+a column (or a whole collection) to your config and re-running it evolves an
+existing database **without a destructive reset**. It never drops, renames, or
+retypes columns — those still need a hand-written migration. Safe to run on every
+boot/deploy.
+
 > **Caveat:** fields in the schemaless JSONB `documents` table are extracted as
 > **text**, so numeric ordering/comparison is lexicographic (`"10" < "5"`).
 > Register the collection with a typed `int`/`float` column for true numeric

package/dist/adapters/postgres/index.cjs

@@ -93,7 +93,17 @@ var PostgresDataAdapter = class {
   cfg(collection) {
     return this.collections[collection];
   }
-  /** Create the documents table and every registered typed table if missing. */
+  /**
+   * Create the documents table and every registered typed table if missing,
+   * then **additively** reconcile each table's columns: any registered column
+   * not yet present is added via `ALTER TABLE ... ADD COLUMN IF NOT EXISTS`.
+   *
+   * This makes `migrate()` idempotent *and* forward-compatible — adding a new
+   * column (or a whole new collection) to your config and re-running `migrate()`
+   * evolves an existing database without a destructive reset. It is additive
+   * only: it never drops, renames, or retypes columns (those need a real
+   * migration). Safe to run on every boot/deploy.
+   */
   async migrate() {
     await this.pool.query(`
       CREATE TABLE IF NOT EXISTS ${ident(this.documentsTable)} (
@@ -120,6 +130,11 @@ var PostgresDataAdapter = class {
           updated_at  timestamptz DEFAULT now()
         );
       `);
+      for (const [name, type] of Object.entries(cfg.columns)) {
+        await this.pool.query(
+          `ALTER TABLE ${ident(cfg.table)} ADD COLUMN IF NOT EXISTS ${ident(name)} ${SQL_TYPE[type]};`
+        );
+      }
     }
   }
   // --- row <-> section mapping ------------------------------------------------

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/adapters/postgres/index.ts","../../../src/types.ts"],"sourcesContent":["import { Pool } from \"pg\";\nimport { randomUUID } from \"node:crypto\";\nimport type {\n  DataAdapter,\n  Query,\n  QueryCondition,\n  QueryFilter,\n  QueryFilterOp,\n} from \"../../types\";\nimport { isFilterGroup } 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\n/** Binary ops that render as `col <op> $n`. */\nconst BINARY_OP: Partial<Record<QueryFilterOp, string>> = {\n  eq: \"=\",\n  ne: \"<>\",\n  lt: \"<\",\n  lte: \"<=\",\n  gt: \">\",\n  gte: \">=\",\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    /** Render one field condition to SQL, pushing its bound params. */\n    const renderFilter = (f: QueryFilter): string => {\n      const col = colExpr(f.field);\n      if (f.op === \"in\" || f.op === \"nin\") {\n        params.push(f.value);\n        const cmp = f.op === \"in\" ? \"= ANY\" : \"<> ALL\";\n        return `${col} ${cmp}($${params.length})`;\n      }\n      if (f.op === \"contains\") {\n        params.push(`%${String(f.value)}%`);\n        return `${col} ILIKE $${params.length}`;\n      }\n      const op = BINARY_OP[f.op];\n      if (!op) throw new Error(`Unsupported query op: ${f.op}`);\n      params.push(f.value);\n      return `${col} ${op} $${params.length}`;\n    };\n\n    /** Render an AND-level condition, expanding OR groups into `(a OR b)`. */\n    const renderCondition = (c: QueryCondition): string => {\n      if (isFilterGroup(c)) {\n        if (!c.or.length) return \"TRUE\";\n        return `(${c.or.map(renderFilter).join(\" OR \")})`;\n      }\n      return renderFilter(c);\n    };\n\n    if (!cfg) {\n      params.push(collection);\n      where.push(`collection = $${params.length}`);\n    }\n\n    for (const c of q?.filters ?? []) {\n      where.push(renderCondition(c));\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 offset = q?.offset != null ? ` OFFSET ${Number(q.offset)}` : \"\";\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}${offset}`,\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","/**\n * Shared, runtime-free types. Safe to import in any environment (client or\n * server) — this module pulls in zero runtime dependencies.\n */\n\n/* eslint-disable @typescript-eslint/no-explicit-any */\n\n/**\n * Engine addressing fields. The engine needs to know an entity's `id` and which\n * `collection` it lives in to route saves; everything else is the consumer's own\n * shape. Kept separate from the user's content type `T` so we never force these\n * onto domain models — use {@link Editable}<YourType> when you want both.\n */\nexport interface EntityAddress {\n  id: string;\n  collection: string;\n}\n\n/**\n * The user's content type `T` decorated with the engine's addressing fields.\n * `T` is completely unconstrained — bring any shape; the engine only adds `id`\n * and `collection`.\n */\nexport type Editable<T = Record<string, any>> = T & EntityAddress;\n\n/**\n * A single editable record. Schemaless by design. Equivalent to\n * `Editable<Record<string, any>>`; kept as a named alias for the common case and\n * for backwards compatibility.\n */\nexport type Section = Editable;\n\nexport type SectionMap = Record<string, Section>;\n\n/**\n * The shape the engine holds in memory:\n * `{ [collection]: { [sectionKey]: Section } }`.\n */\nexport type NestedSections = {\n  [collection: string]: {\n    [sectionKey: string]: Section;\n  };\n};\n\n/**\n * A single item in an editable collection list (e.g. a project or a tool). Just\n * a record with a stable `id`. Used by the client provider's collection ops\n * (create / delete / reorder) which manage *which* items exist and their order,\n * complementing {@link Section}s which manage a single item's editable fields.\n */\nexport type CollectionItem = Record<string, unknown> & { id: string };\n\n/**\n * An image edit queued in the provider. The actual upload is deferred until\n * save. `file` is null when the user pasted an external URL (`isExternal`).\n */\nexport interface PendingImage {\n  file: File | null;\n  localUrl: string;\n  sectionKey: string;\n  fieldKey: string;\n  collection: string;\n  docId: string;\n  isExternal?: boolean;\n}\n\n/**\n * Neutral query language. Keeps any backend's native query type (Firestore's\n * `Query`, SQL, etc.) from leaking through the engine.\n *\n * Op support is backend-dependent — see each adapter. `contains` is a\n * case-insensitive substring match; `in`/`nin` take an array value.\n */\nexport type QueryFilterOp =\n  | \"eq\"\n  | \"ne\"\n  | \"lt\"\n  | \"lte\"\n  | \"gt\"\n  | \"gte\"\n  | \"in\"\n  | \"nin\"\n  | \"contains\";\n\n/** A single field condition. */\nexport type QueryFilter = { field: string; op: QueryFilterOp; value: unknown };\n\n/**\n * A disjunction: the inner filters are combined with OR. Sits alongside plain\n * filters in `Query.filters`, which are combined with AND at the top level.\n */\nexport type QueryFilterGroup = { or: QueryFilter[] };\n\n/** Either a bare condition (AND-ed) or an OR group. */\nexport type QueryCondition = QueryFilter | QueryFilterGroup;\n\nexport type Query = {\n  /** Top-level conditions combined with AND. Use `{ or: [...] }` for disjunction. */\n  filters?: QueryCondition[];\n  orderBy?: { field: string; direction: \"asc\" | \"desc\" }[];\n  limit?: number;\n  /** Skip this many rows (offset pagination). */\n  offset?: number;\n  /**\n   * Fields holding references to other documents to inline-resolve after the\n   * primary fetch. Resolved by {@link resolveRelations}, never by the adapter.\n   */\n  populate?: string[];\n};\n\n/** Narrow a {@link QueryCondition} to an OR group. */\nexport function isFilterGroup(c: QueryCondition): c is QueryFilterGroup {\n  return typeof c === \"object\" && c !== null && \"or\" in c;\n}\n\n/**\n * A reference to another document. Either self-describing (`{ collection, id }`)\n * or a bare id string resolved via a {@link RelationConfig}.\n */\nexport type Ref = { collection: string; id: string };\n\n/**\n * Maps a reference field name → the collection it points to. Needed only when\n * refs are stored as bare id strings (self-describing `Ref` objects don't need\n * it). Used by {@link resolveRelations}.\n */\nexport type RelationConfig = Record<string, { collection: string }>;\n\n/**\n * Persistence contract. Every backend (Firestore, Postgres, …) implements this;\n * the engine and the route factory only ever speak to this interface.\n */\nexport interface DataAdapter {\n  fetchCollection<T = Record<string, any>>(\n    collection: string,\n    q?: Query,\n  ): Promise<(T & { id: string })[]>;\n  fetchById<T = Record<string, any>>(\n    collection: string,\n    id: string,\n  ): Promise<(T & { id: string }) | null>;\n  create<T = Record<string, any>>(\n    collection: string,\n    data: T,\n  ): Promise<T & { id: string }>;\n  createWithId<T = Record<string, any>>(\n    collection: string,\n    id: string,\n    data: T,\n  ): Promise<T & { id: string }>;\n  update<T = Record<string, any>>(\n    collection: string,\n    id: string,\n    data: Partial<T>,\n  ): Promise<void>;\n  upsert<T = Record<string, any>>(\n    collection: string,\n    id: string,\n    data: Partial<T>,\n  ): Promise<void>;\n  delete(collection: string, id: string): Promise<void>;\n}\n\n/**\n * The identity resolved from an incoming request by an {@link AuthAdapter}.\n * Minimal by design: only `isAdmin` is meaningful to the default gate. Carry any\n * additional claims (roles, scopes, tenant, …) as extra keys and authorize on\n * them with a custom `authorize` predicate. `userId`/`email` are conventional\n * but optional.\n */\nexport interface AuthIdentity {\n  isAdmin: boolean;\n  userId?: string;\n  email?: string;\n  [claim: string]: unknown;\n}\n\n/**\n * Decides whether a resolved identity may perform admin actions. Defaults to\n * `identity.isAdmin === true`; override to gate on roles/scopes/etc.\n */\nexport type AuthorizeFn = (\n  identity: AuthIdentity,\n  req: Request,\n) => boolean | Promise<boolean>;\n\n/**\n * Server-side auth contract. Gates every admin API route. Return `null` to\n * reject outright; otherwise the gate's `authorize` predicate decides.\n */\nexport interface AuthAdapter {\n  verifyRequest(req: Request): Promise<AuthIdentity | null>;\n}\n\n/**\n * Client half of storage: performs the browser-side upload and returns the\n * final URL. Has zero server dependencies, so it is safe to import in client\n * components. Built from e.g. `@dalgoridim/headless-cms/storage/cloudinary`.\n */\nexport interface ClientStorageAdapter {\n  upload(file: File): Promise<{ url: string }>;\n}\n\n/**\n * Server half of storage: issues a presign / signature (or, for local storage,\n * writes the file). Mounted by the route factory at `${apiBasePath}/sign`.\n * Pulls in server-only SDKs, so it lives in a `/server` subpath. Built from e.g.\n * `@dalgoridim/headless-cms/storage/cloudinary/server`.\n */\nexport interface ServerStorageAdapter {\n  sign(req: Request): Promise<unknown>;\n}\n\n/** Full two-sided contract (rarely needed; client and server halves are split). */\nexport interface StorageAdapter extends ClientStorageAdapter {\n  sign?(req: Request): Promise<unknown>;\n}\n\n/**\n * Minimal client-side auth state the edit primitives depend on. Any auth\n * implementation (Firebase, NextAuth, custom) provides this via a context;\n * `@dalgoridim/headless-cms/auth/firebase/client` ships the default.\n */\nexport interface CmsAuthState {\n  isAdmin: boolean;\n  isEditing: boolean;\n  toggleEdit: () => void;\n}\n"],"mappings":"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","names":["rows"]}
+{"version":3,"sources":["../../../src/adapters/postgres/index.ts","../../../src/types.ts"],"sourcesContent":["import { Pool } from \"pg\";\nimport { randomUUID } from \"node:crypto\";\nimport type {\n  DataAdapter,\n  Query,\n  QueryCondition,\n  QueryFilter,\n  QueryFilterOp,\n} from \"../../types\";\nimport { isFilterGroup } 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\n/** Binary ops that render as `col <op> $n`. */\nconst BINARY_OP: Partial<Record<QueryFilterOp, string>> = {\n  eq: \"=\",\n  ne: \"<>\",\n  lt: \"<\",\n  lte: \"<=\",\n  gt: \">\",\n  gte: \">=\",\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  /**\n   * Create the documents table and every registered typed table if missing,\n   * then **additively** reconcile each table's columns: any registered column\n   * not yet present is added via `ALTER TABLE ... ADD COLUMN IF NOT EXISTS`.\n   *\n   * This makes `migrate()` idempotent *and* forward-compatible — adding a new\n   * column (or a whole new collection) to your config and re-running `migrate()`\n   * evolves an existing database without a destructive reset. It is additive\n   * only: it never drops, renames, or retypes columns (those need a real\n   * migration). Safe to run on every boot/deploy.\n   */\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      // Reconcile columns added to the config after the table already existed.\n      for (const [name, type] of Object.entries(cfg.columns)) {\n        await this.pool.query(\n          `ALTER TABLE ${ident(cfg.table)} ADD COLUMN IF NOT EXISTS ${ident(name)} ${SQL_TYPE[type]};`,\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    /** Render one field condition to SQL, pushing its bound params. */\n    const renderFilter = (f: QueryFilter): string => {\n      const col = colExpr(f.field);\n      if (f.op === \"in\" || f.op === \"nin\") {\n        params.push(f.value);\n        const cmp = f.op === \"in\" ? \"= ANY\" : \"<> ALL\";\n        return `${col} ${cmp}($${params.length})`;\n      }\n      if (f.op === \"contains\") {\n        params.push(`%${String(f.value)}%`);\n        return `${col} ILIKE $${params.length}`;\n      }\n      const op = BINARY_OP[f.op];\n      if (!op) throw new Error(`Unsupported query op: ${f.op}`);\n      params.push(f.value);\n      return `${col} ${op} $${params.length}`;\n    };\n\n    /** Render an AND-level condition, expanding OR groups into `(a OR b)`. */\n    const renderCondition = (c: QueryCondition): string => {\n      if (isFilterGroup(c)) {\n        if (!c.or.length) return \"TRUE\";\n        return `(${c.or.map(renderFilter).join(\" OR \")})`;\n      }\n      return renderFilter(c);\n    };\n\n    if (!cfg) {\n      params.push(collection);\n      where.push(`collection = $${params.length}`);\n    }\n\n    for (const c of q?.filters ?? []) {\n      where.push(renderCondition(c));\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 offset = q?.offset != null ? ` OFFSET ${Number(q.offset)}` : \"\";\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}${offset}`,\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","/**\n * Shared, runtime-free types. Safe to import in any environment (client or\n * server) — this module pulls in zero runtime dependencies.\n */\n\n/* eslint-disable @typescript-eslint/no-explicit-any */\n\n/**\n * Engine addressing fields. The engine needs to know an entity's `id` and which\n * `collection` it lives in to route saves; everything else is the consumer's own\n * shape. Kept separate from the user's content type `T` so we never force these\n * onto domain models — use {@link Editable}<YourType> when you want both.\n */\nexport interface EntityAddress {\n  id: string;\n  collection: string;\n}\n\n/**\n * The user's content type `T` decorated with the engine's addressing fields.\n * `T` is completely unconstrained — bring any shape; the engine only adds `id`\n * and `collection`.\n */\nexport type Editable<T = Record<string, any>> = T & EntityAddress;\n\n/**\n * A single editable record. Schemaless by design. Equivalent to\n * `Editable<Record<string, any>>`; kept as a named alias for the common case and\n * for backwards compatibility.\n */\nexport type Section = Editable;\n\nexport type SectionMap = Record<string, Section>;\n\n/**\n * The shape the engine holds in memory:\n * `{ [collection]: { [sectionKey]: Section } }`.\n */\nexport type NestedSections = {\n  [collection: string]: {\n    [sectionKey: string]: Section;\n  };\n};\n\n/**\n * A single item in an editable collection list (e.g. a project or a tool). Just\n * a record with a stable `id`. Used by the client provider's collection ops\n * (create / delete / reorder) which manage *which* items exist and their order,\n * complementing {@link Section}s which manage a single item's editable fields.\n */\nexport type CollectionItem = Record<string, unknown> & { id: string };\n\n/**\n * An image edit queued in the provider. The actual upload is deferred until\n * save. `file` is null when the user pasted an external URL (`isExternal`).\n */\nexport interface PendingImage {\n  file: File | null;\n  localUrl: string;\n  sectionKey: string;\n  fieldKey: string;\n  collection: string;\n  docId: string;\n  isExternal?: boolean;\n}\n\n/**\n * Neutral query language. Keeps any backend's native query type (Firestore's\n * `Query`, SQL, etc.) from leaking through the engine.\n *\n * Op support is backend-dependent — see each adapter. `contains` is a\n * case-insensitive substring match; `in`/`nin` take an array value.\n */\nexport type QueryFilterOp =\n  | \"eq\"\n  | \"ne\"\n  | \"lt\"\n  | \"lte\"\n  | \"gt\"\n  | \"gte\"\n  | \"in\"\n  | \"nin\"\n  | \"contains\";\n\n/** A single field condition. */\nexport type QueryFilter = { field: string; op: QueryFilterOp; value: unknown };\n\n/**\n * A disjunction: the inner filters are combined with OR. Sits alongside plain\n * filters in `Query.filters`, which are combined with AND at the top level.\n */\nexport type QueryFilterGroup = { or: QueryFilter[] };\n\n/** Either a bare condition (AND-ed) or an OR group. */\nexport type QueryCondition = QueryFilter | QueryFilterGroup;\n\nexport type Query = {\n  /** Top-level conditions combined with AND. Use `{ or: [...] }` for disjunction. */\n  filters?: QueryCondition[];\n  orderBy?: { field: string; direction: \"asc\" | \"desc\" }[];\n  limit?: number;\n  /** Skip this many rows (offset pagination). */\n  offset?: number;\n  /**\n   * Fields holding references to other documents to inline-resolve after the\n   * primary fetch. Resolved by {@link resolveRelations}, never by the adapter.\n   */\n  populate?: string[];\n};\n\n/** Narrow a {@link QueryCondition} to an OR group. */\nexport function isFilterGroup(c: QueryCondition): c is QueryFilterGroup {\n  return typeof c === \"object\" && c !== null && \"or\" in c;\n}\n\n/**\n * A reference to another document. Either self-describing (`{ collection, id }`)\n * or a bare id string resolved via a {@link RelationConfig}.\n */\nexport type Ref = { collection: string; id: string };\n\n/**\n * Maps a reference field name → the collection it points to. Needed only when\n * refs are stored as bare id strings (self-describing `Ref` objects don't need\n * it). Used by {@link resolveRelations}.\n */\nexport type RelationConfig = Record<string, { collection: string }>;\n\n/**\n * Persistence contract. Every backend (Firestore, Postgres, …) implements this;\n * the engine and the route factory only ever speak to this interface.\n */\nexport interface DataAdapter {\n  fetchCollection<T = Record<string, any>>(\n    collection: string,\n    q?: Query,\n  ): Promise<(T & { id: string })[]>;\n  fetchById<T = Record<string, any>>(\n    collection: string,\n    id: string,\n  ): Promise<(T & { id: string }) | null>;\n  create<T = Record<string, any>>(\n    collection: string,\n    data: T,\n  ): Promise<T & { id: string }>;\n  createWithId<T = Record<string, any>>(\n    collection: string,\n    id: string,\n    data: T,\n  ): Promise<T & { id: string }>;\n  update<T = Record<string, any>>(\n    collection: string,\n    id: string,\n    data: Partial<T>,\n  ): Promise<void>;\n  upsert<T = Record<string, any>>(\n    collection: string,\n    id: string,\n    data: Partial<T>,\n  ): Promise<void>;\n  delete(collection: string, id: string): Promise<void>;\n}\n\n/**\n * The identity resolved from an incoming request by an {@link AuthAdapter}.\n * Minimal by design: only `isAdmin` is meaningful to the default gate. Carry any\n * additional claims (roles, scopes, tenant, …) as extra keys and authorize on\n * them with a custom `authorize` predicate. `userId`/`email` are conventional\n * but optional.\n */\nexport interface AuthIdentity {\n  isAdmin: boolean;\n  userId?: string;\n  email?: string;\n  [claim: string]: unknown;\n}\n\n/**\n * Decides whether a resolved identity may perform admin actions. Defaults to\n * `identity.isAdmin === true`; override to gate on roles/scopes/etc.\n */\nexport type AuthorizeFn = (\n  identity: AuthIdentity,\n  req: Request,\n) => boolean | Promise<boolean>;\n\n/**\n * Server-side auth contract. Gates every admin API route. Return `null` to\n * reject outright; otherwise the gate's `authorize` predicate decides.\n */\nexport interface AuthAdapter {\n  verifyRequest(req: Request): Promise<AuthIdentity | null>;\n}\n\n/**\n * Client half of storage: performs the browser-side upload and returns the\n * final URL. Has zero server dependencies, so it is safe to import in client\n * components. Built from e.g. `@dalgoridim/headless-cms/storage/cloudinary`.\n */\nexport interface ClientStorageAdapter {\n  upload(file: File): Promise<{ url: string }>;\n}\n\n/**\n * Server half of storage: issues a presign / signature (or, for local storage,\n * writes the file). Mounted by the route factory at `${apiBasePath}/sign`.\n * Pulls in server-only SDKs, so it lives in a `/server` subpath. Built from e.g.\n * `@dalgoridim/headless-cms/storage/cloudinary/server`.\n */\nexport interface ServerStorageAdapter {\n  sign(req: Request): Promise<unknown>;\n}\n\n/** Full two-sided contract (rarely needed; client and server halves are split). */\nexport interface StorageAdapter extends ClientStorageAdapter {\n  sign?(req: Request): Promise<unknown>;\n}\n\n/**\n * Minimal client-side auth state the edit primitives depend on. Any auth\n * implementation (Firebase, NextAuth, custom) provides this via a context;\n * `@dalgoridim/headless-cms/auth/firebase/client` ships the default.\n */\nexport interface CmsAuthState {\n  isAdmin: boolean;\n  isEditing: boolean;\n  toggleEdit: () => void;\n}\n"],"mappings":"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","names":["rows"]}

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

@@ -33,7 +33,17 @@ declare class PostgresDataAdapter implements DataAdapter {
     private readonly documentsTable;
     constructor(config?: PostgresAdapterConfig);
     private cfg;
-    /** Create the documents table and every registered typed table if missing. */
+    /**
+     * Create the documents table and every registered typed table if missing,
+     * then **additively** reconcile each table's columns: any registered column
+     * not yet present is added via `ALTER TABLE ... ADD COLUMN IF NOT EXISTS`.
+     *
+     * This makes `migrate()` idempotent *and* forward-compatible — adding a new
+     * column (or a whole new collection) to your config and re-running `migrate()`
+     * evolves an existing database without a destructive reset. It is additive
+     * only: it never drops, renames, or retypes columns (those need a real
+     * migration). Safe to run on every boot/deploy.
+     */
     migrate(): Promise<void>;
     /** Split a section into typed columns + leftover `extra`. */
     private toTypedRow;

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

@@ -33,7 +33,17 @@ declare class PostgresDataAdapter implements DataAdapter {
     private readonly documentsTable;
     constructor(config?: PostgresAdapterConfig);
     private cfg;
-    /** Create the documents table and every registered typed table if missing. */
+    /**
+     * Create the documents table and every registered typed table if missing,
+     * then **additively** reconcile each table's columns: any registered column
+     * not yet present is added via `ALTER TABLE ... ADD COLUMN IF NOT EXISTS`.
+     *
+     * This makes `migrate()` idempotent *and* forward-compatible — adding a new
+     * column (or a whole new collection) to your config and re-running `migrate()`
+     * evolves an existing database without a destructive reset. It is additive
+     * only: it never drops, renames, or retypes columns (those need a real
+     * migration). Safe to run on every boot/deploy.
+     */
     migrate(): Promise<void>;
     /** Split a section into typed columns + leftover `extra`. */
     private toTypedRow;

package/dist/adapters/postgres/index.js

@@ -72,7 +72,17 @@ var PostgresDataAdapter = class {
   cfg(collection) {
     return this.collections[collection];
   }
-  /** Create the documents table and every registered typed table if missing. */
+  /**
+   * Create the documents table and every registered typed table if missing,
+   * then **additively** reconcile each table's columns: any registered column
+   * not yet present is added via `ALTER TABLE ... ADD COLUMN IF NOT EXISTS`.
+   *
+   * This makes `migrate()` idempotent *and* forward-compatible — adding a new
+   * column (or a whole new collection) to your config and re-running `migrate()`
+   * evolves an existing database without a destructive reset. It is additive
+   * only: it never drops, renames, or retypes columns (those need a real
+   * migration). Safe to run on every boot/deploy.
+   */
   async migrate() {
     await this.pool.query(`
       CREATE TABLE IF NOT EXISTS ${ident(this.documentsTable)} (
@@ -99,6 +109,11 @@ var PostgresDataAdapter = class {
           updated_at  timestamptz DEFAULT now()
         );
       `);
+      for (const [name, type] of Object.entries(cfg.columns)) {
+        await this.pool.query(
+          `ALTER TABLE ${ident(cfg.table)} ADD COLUMN IF NOT EXISTS ${ident(name)} ${SQL_TYPE[type]};`
+        );
+      }
     }
   }
   // --- row <-> section mapping ------------------------------------------------

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/adapters/postgres/index.ts","../../../src/types.ts"],"sourcesContent":["import { Pool } from \"pg\";\nimport { randomUUID } from \"node:crypto\";\nimport type {\n  DataAdapter,\n  Query,\n  QueryCondition,\n  QueryFilter,\n  QueryFilterOp,\n} from \"../../types\";\nimport { isFilterGroup } 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\n/** Binary ops that render as `col <op> $n`. */\nconst BINARY_OP: Partial<Record<QueryFilterOp, string>> = {\n  eq: \"=\",\n  ne: \"<>\",\n  lt: \"<\",\n  lte: \"<=\",\n  gt: \">\",\n  gte: \">=\",\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    /** Render one field condition to SQL, pushing its bound params. */\n    const renderFilter = (f: QueryFilter): string => {\n      const col = colExpr(f.field);\n      if (f.op === \"in\" || f.op === \"nin\") {\n        params.push(f.value);\n        const cmp = f.op === \"in\" ? \"= ANY\" : \"<> ALL\";\n        return `${col} ${cmp}($${params.length})`;\n      }\n      if (f.op === \"contains\") {\n        params.push(`%${String(f.value)}%`);\n        return `${col} ILIKE $${params.length}`;\n      }\n      const op = BINARY_OP[f.op];\n      if (!op) throw new Error(`Unsupported query op: ${f.op}`);\n      params.push(f.value);\n      return `${col} ${op} $${params.length}`;\n    };\n\n    /** Render an AND-level condition, expanding OR groups into `(a OR b)`. */\n    const renderCondition = (c: QueryCondition): string => {\n      if (isFilterGroup(c)) {\n        if (!c.or.length) return \"TRUE\";\n        return `(${c.or.map(renderFilter).join(\" OR \")})`;\n      }\n      return renderFilter(c);\n    };\n\n    if (!cfg) {\n      params.push(collection);\n      where.push(`collection = $${params.length}`);\n    }\n\n    for (const c of q?.filters ?? []) {\n      where.push(renderCondition(c));\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 offset = q?.offset != null ? ` OFFSET ${Number(q.offset)}` : \"\";\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}${offset}`,\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","/**\n * Shared, runtime-free types. Safe to import in any environment (client or\n * server) — this module pulls in zero runtime dependencies.\n */\n\n/* eslint-disable @typescript-eslint/no-explicit-any */\n\n/**\n * Engine addressing fields. The engine needs to know an entity's `id` and which\n * `collection` it lives in to route saves; everything else is the consumer's own\n * shape. Kept separate from the user's content type `T` so we never force these\n * onto domain models — use {@link Editable}<YourType> when you want both.\n */\nexport interface EntityAddress {\n  id: string;\n  collection: string;\n}\n\n/**\n * The user's content type `T` decorated with the engine's addressing fields.\n * `T` is completely unconstrained — bring any shape; the engine only adds `id`\n * and `collection`.\n */\nexport type Editable<T = Record<string, any>> = T & EntityAddress;\n\n/**\n * A single editable record. Schemaless by design. Equivalent to\n * `Editable<Record<string, any>>`; kept as a named alias for the common case and\n * for backwards compatibility.\n */\nexport type Section = Editable;\n\nexport type SectionMap = Record<string, Section>;\n\n/**\n * The shape the engine holds in memory:\n * `{ [collection]: { [sectionKey]: Section } }`.\n */\nexport type NestedSections = {\n  [collection: string]: {\n    [sectionKey: string]: Section;\n  };\n};\n\n/**\n * A single item in an editable collection list (e.g. a project or a tool). Just\n * a record with a stable `id`. Used by the client provider's collection ops\n * (create / delete / reorder) which manage *which* items exist and their order,\n * complementing {@link Section}s which manage a single item's editable fields.\n */\nexport type CollectionItem = Record<string, unknown> & { id: string };\n\n/**\n * An image edit queued in the provider. The actual upload is deferred until\n * save. `file` is null when the user pasted an external URL (`isExternal`).\n */\nexport interface PendingImage {\n  file: File | null;\n  localUrl: string;\n  sectionKey: string;\n  fieldKey: string;\n  collection: string;\n  docId: string;\n  isExternal?: boolean;\n}\n\n/**\n * Neutral query language. Keeps any backend's native query type (Firestore's\n * `Query`, SQL, etc.) from leaking through the engine.\n *\n * Op support is backend-dependent — see each adapter. `contains` is a\n * case-insensitive substring match; `in`/`nin` take an array value.\n */\nexport type QueryFilterOp =\n  | \"eq\"\n  | \"ne\"\n  | \"lt\"\n  | \"lte\"\n  | \"gt\"\n  | \"gte\"\n  | \"in\"\n  | \"nin\"\n  | \"contains\";\n\n/** A single field condition. */\nexport type QueryFilter = { field: string; op: QueryFilterOp; value: unknown };\n\n/**\n * A disjunction: the inner filters are combined with OR. Sits alongside plain\n * filters in `Query.filters`, which are combined with AND at the top level.\n */\nexport type QueryFilterGroup = { or: QueryFilter[] };\n\n/** Either a bare condition (AND-ed) or an OR group. */\nexport type QueryCondition = QueryFilter | QueryFilterGroup;\n\nexport type Query = {\n  /** Top-level conditions combined with AND. Use `{ or: [...] }` for disjunction. */\n  filters?: QueryCondition[];\n  orderBy?: { field: string; direction: \"asc\" | \"desc\" }[];\n  limit?: number;\n  /** Skip this many rows (offset pagination). */\n  offset?: number;\n  /**\n   * Fields holding references to other documents to inline-resolve after the\n   * primary fetch. Resolved by {@link resolveRelations}, never by the adapter.\n   */\n  populate?: string[];\n};\n\n/** Narrow a {@link QueryCondition} to an OR group. */\nexport function isFilterGroup(c: QueryCondition): c is QueryFilterGroup {\n  return typeof c === \"object\" && c !== null && \"or\" in c;\n}\n\n/**\n * A reference to another document. Either self-describing (`{ collection, id }`)\n * or a bare id string resolved via a {@link RelationConfig}.\n */\nexport type Ref = { collection: string; id: string };\n\n/**\n * Maps a reference field name → the collection it points to. Needed only when\n * refs are stored as bare id strings (self-describing `Ref` objects don't need\n * it). Used by {@link resolveRelations}.\n */\nexport type RelationConfig = Record<string, { collection: string }>;\n\n/**\n * Persistence contract. Every backend (Firestore, Postgres, …) implements this;\n * the engine and the route factory only ever speak to this interface.\n */\nexport interface DataAdapter {\n  fetchCollection<T = Record<string, any>>(\n    collection: string,\n    q?: Query,\n  ): Promise<(T & { id: string })[]>;\n  fetchById<T = Record<string, any>>(\n    collection: string,\n    id: string,\n  ): Promise<(T & { id: string }) | null>;\n  create<T = Record<string, any>>(\n    collection: string,\n    data: T,\n  ): Promise<T & { id: string }>;\n  createWithId<T = Record<string, any>>(\n    collection: string,\n    id: string,\n    data: T,\n  ): Promise<T & { id: string }>;\n  update<T = Record<string, any>>(\n    collection: string,\n    id: string,\n    data: Partial<T>,\n  ): Promise<void>;\n  upsert<T = Record<string, any>>(\n    collection: string,\n    id: string,\n    data: Partial<T>,\n  ): Promise<void>;\n  delete(collection: string, id: string): Promise<void>;\n}\n\n/**\n * The identity resolved from an incoming request by an {@link AuthAdapter}.\n * Minimal by design: only `isAdmin` is meaningful to the default gate. Carry any\n * additional claims (roles, scopes, tenant, …) as extra keys and authorize on\n * them with a custom `authorize` predicate. `userId`/`email` are conventional\n * but optional.\n */\nexport interface AuthIdentity {\n  isAdmin: boolean;\n  userId?: string;\n  email?: string;\n  [claim: string]: unknown;\n}\n\n/**\n * Decides whether a resolved identity may perform admin actions. Defaults to\n * `identity.isAdmin === true`; override to gate on roles/scopes/etc.\n */\nexport type AuthorizeFn = (\n  identity: AuthIdentity,\n  req: Request,\n) => boolean | Promise<boolean>;\n\n/**\n * Server-side auth contract. Gates every admin API route. Return `null` to\n * reject outright; otherwise the gate's `authorize` predicate decides.\n */\nexport interface AuthAdapter {\n  verifyRequest(req: Request): Promise<AuthIdentity | null>;\n}\n\n/**\n * Client half of storage: performs the browser-side upload and returns the\n * final URL. Has zero server dependencies, so it is safe to import in client\n * components. Built from e.g. `@dalgoridim/headless-cms/storage/cloudinary`.\n */\nexport interface ClientStorageAdapter {\n  upload(file: File): Promise<{ url: string }>;\n}\n\n/**\n * Server half of storage: issues a presign / signature (or, for local storage,\n * writes the file). Mounted by the route factory at `${apiBasePath}/sign`.\n * Pulls in server-only SDKs, so it lives in a `/server` subpath. Built from e.g.\n * `@dalgoridim/headless-cms/storage/cloudinary/server`.\n */\nexport interface ServerStorageAdapter {\n  sign(req: Request): Promise<unknown>;\n}\n\n/** Full two-sided contract (rarely needed; client and server halves are split). */\nexport interface StorageAdapter extends ClientStorageAdapter {\n  sign?(req: Request): Promise<unknown>;\n}\n\n/**\n * Minimal client-side auth state the edit primitives depend on. Any auth\n * implementation (Firebase, NextAuth, custom) provides this via a context;\n * `@dalgoridim/headless-cms/auth/firebase/client` ships the default.\n */\nexport interface CmsAuthState {\n  isAdmin: boolean;\n  isEditing: boolean;\n  toggleEdit: () => void;\n}\n"],"mappings":"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","names":["rows"]}
+{"version":3,"sources":["../../../src/adapters/postgres/index.ts","../../../src/types.ts"],"sourcesContent":["import { Pool } from \"pg\";\nimport { randomUUID } from \"node:crypto\";\nimport type {\n  DataAdapter,\n  Query,\n  QueryCondition,\n  QueryFilter,\n  QueryFilterOp,\n} from \"../../types\";\nimport { isFilterGroup } 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\n/** Binary ops that render as `col <op> $n`. */\nconst BINARY_OP: Partial<Record<QueryFilterOp, string>> = {\n  eq: \"=\",\n  ne: \"<>\",\n  lt: \"<\",\n  lte: \"<=\",\n  gt: \">\",\n  gte: \">=\",\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  /**\n   * Create the documents table and every registered typed table if missing,\n   * then **additively** reconcile each table's columns: any registered column\n   * not yet present is added via `ALTER TABLE ... ADD COLUMN IF NOT EXISTS`.\n   *\n   * This makes `migrate()` idempotent *and* forward-compatible — adding a new\n   * column (or a whole new collection) to your config and re-running `migrate()`\n   * evolves an existing database without a destructive reset. It is additive\n   * only: it never drops, renames, or retypes columns (those need a real\n   * migration). Safe to run on every boot/deploy.\n   */\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      // Reconcile columns added to the config after the table already existed.\n      for (const [name, type] of Object.entries(cfg.columns)) {\n        await this.pool.query(\n          `ALTER TABLE ${ident(cfg.table)} ADD COLUMN IF NOT EXISTS ${ident(name)} ${SQL_TYPE[type]};`,\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    /** Render one field condition to SQL, pushing its bound params. */\n    const renderFilter = (f: QueryFilter): string => {\n      const col = colExpr(f.field);\n      if (f.op === \"in\" || f.op === \"nin\") {\n        params.push(f.value);\n        const cmp = f.op === \"in\" ? \"= ANY\" : \"<> ALL\";\n        return `${col} ${cmp}($${params.length})`;\n      }\n      if (f.op === \"contains\") {\n        params.push(`%${String(f.value)}%`);\n        return `${col} ILIKE $${params.length}`;\n      }\n      const op = BINARY_OP[f.op];\n      if (!op) throw new Error(`Unsupported query op: ${f.op}`);\n      params.push(f.value);\n      return `${col} ${op} $${params.length}`;\n    };\n\n    /** Render an AND-level condition, expanding OR groups into `(a OR b)`. */\n    const renderCondition = (c: QueryCondition): string => {\n      if (isFilterGroup(c)) {\n        if (!c.or.length) return \"TRUE\";\n        return `(${c.or.map(renderFilter).join(\" OR \")})`;\n      }\n      return renderFilter(c);\n    };\n\n    if (!cfg) {\n      params.push(collection);\n      where.push(`collection = $${params.length}`);\n    }\n\n    for (const c of q?.filters ?? []) {\n      where.push(renderCondition(c));\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 offset = q?.offset != null ? ` OFFSET ${Number(q.offset)}` : \"\";\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}${offset}`,\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","/**\n * Shared, runtime-free types. Safe to import in any environment (client or\n * server) — this module pulls in zero runtime dependencies.\n */\n\n/* eslint-disable @typescript-eslint/no-explicit-any */\n\n/**\n * Engine addressing fields. The engine needs to know an entity's `id` and which\n * `collection` it lives in to route saves; everything else is the consumer's own\n * shape. Kept separate from the user's content type `T` so we never force these\n * onto domain models — use {@link Editable}<YourType> when you want both.\n */\nexport interface EntityAddress {\n  id: string;\n  collection: string;\n}\n\n/**\n * The user's content type `T` decorated with the engine's addressing fields.\n * `T` is completely unconstrained — bring any shape; the engine only adds `id`\n * and `collection`.\n */\nexport type Editable<T = Record<string, any>> = T & EntityAddress;\n\n/**\n * A single editable record. Schemaless by design. Equivalent to\n * `Editable<Record<string, any>>`; kept as a named alias for the common case and\n * for backwards compatibility.\n */\nexport type Section = Editable;\n\nexport type SectionMap = Record<string, Section>;\n\n/**\n * The shape the engine holds in memory:\n * `{ [collection]: { [sectionKey]: Section } }`.\n */\nexport type NestedSections = {\n  [collection: string]: {\n    [sectionKey: string]: Section;\n  };\n};\n\n/**\n * A single item in an editable collection list (e.g. a project or a tool). Just\n * a record with a stable `id`. Used by the client provider's collection ops\n * (create / delete / reorder) which manage *which* items exist and their order,\n * complementing {@link Section}s which manage a single item's editable fields.\n */\nexport type CollectionItem = Record<string, unknown> & { id: string };\n\n/**\n * An image edit queued in the provider. The actual upload is deferred until\n * save. `file` is null when the user pasted an external URL (`isExternal`).\n */\nexport interface PendingImage {\n  file: File | null;\n  localUrl: string;\n  sectionKey: string;\n  fieldKey: string;\n  collection: string;\n  docId: string;\n  isExternal?: boolean;\n}\n\n/**\n * Neutral query language. Keeps any backend's native query type (Firestore's\n * `Query`, SQL, etc.) from leaking through the engine.\n *\n * Op support is backend-dependent — see each adapter. `contains` is a\n * case-insensitive substring match; `in`/`nin` take an array value.\n */\nexport type QueryFilterOp =\n  | \"eq\"\n  | \"ne\"\n  | \"lt\"\n  | \"lte\"\n  | \"gt\"\n  | \"gte\"\n  | \"in\"\n  | \"nin\"\n  | \"contains\";\n\n/** A single field condition. */\nexport type QueryFilter = { field: string; op: QueryFilterOp; value: unknown };\n\n/**\n * A disjunction: the inner filters are combined with OR. Sits alongside plain\n * filters in `Query.filters`, which are combined with AND at the top level.\n */\nexport type QueryFilterGroup = { or: QueryFilter[] };\n\n/** Either a bare condition (AND-ed) or an OR group. */\nexport type QueryCondition = QueryFilter | QueryFilterGroup;\n\nexport type Query = {\n  /** Top-level conditions combined with AND. Use `{ or: [...] }` for disjunction. */\n  filters?: QueryCondition[];\n  orderBy?: { field: string; direction: \"asc\" | \"desc\" }[];\n  limit?: number;\n  /** Skip this many rows (offset pagination). */\n  offset?: number;\n  /**\n   * Fields holding references to other documents to inline-resolve after the\n   * primary fetch. Resolved by {@link resolveRelations}, never by the adapter.\n   */\n  populate?: string[];\n};\n\n/** Narrow a {@link QueryCondition} to an OR group. */\nexport function isFilterGroup(c: QueryCondition): c is QueryFilterGroup {\n  return typeof c === \"object\" && c !== null && \"or\" in c;\n}\n\n/**\n * A reference to another document. Either self-describing (`{ collection, id }`)\n * or a bare id string resolved via a {@link RelationConfig}.\n */\nexport type Ref = { collection: string; id: string };\n\n/**\n * Maps a reference field name → the collection it points to. Needed only when\n * refs are stored as bare id strings (self-describing `Ref` objects don't need\n * it). Used by {@link resolveRelations}.\n */\nexport type RelationConfig = Record<string, { collection: string }>;\n\n/**\n * Persistence contract. Every backend (Firestore, Postgres, …) implements this;\n * the engine and the route factory only ever speak to this interface.\n */\nexport interface DataAdapter {\n  fetchCollection<T = Record<string, any>>(\n    collection: string,\n    q?: Query,\n  ): Promise<(T & { id: string })[]>;\n  fetchById<T = Record<string, any>>(\n    collection: string,\n    id: string,\n  ): Promise<(T & { id: string }) | null>;\n  create<T = Record<string, any>>(\n    collection: string,\n    data: T,\n  ): Promise<T & { id: string }>;\n  createWithId<T = Record<string, any>>(\n    collection: string,\n    id: string,\n    data: T,\n  ): Promise<T & { id: string }>;\n  update<T = Record<string, any>>(\n    collection: string,\n    id: string,\n    data: Partial<T>,\n  ): Promise<void>;\n  upsert<T = Record<string, any>>(\n    collection: string,\n    id: string,\n    data: Partial<T>,\n  ): Promise<void>;\n  delete(collection: string, id: string): Promise<void>;\n}\n\n/**\n * The identity resolved from an incoming request by an {@link AuthAdapter}.\n * Minimal by design: only `isAdmin` is meaningful to the default gate. Carry any\n * additional claims (roles, scopes, tenant, …) as extra keys and authorize on\n * them with a custom `authorize` predicate. `userId`/`email` are conventional\n * but optional.\n */\nexport interface AuthIdentity {\n  isAdmin: boolean;\n  userId?: string;\n  email?: string;\n  [claim: string]: unknown;\n}\n\n/**\n * Decides whether a resolved identity may perform admin actions. Defaults to\n * `identity.isAdmin === true`; override to gate on roles/scopes/etc.\n */\nexport type AuthorizeFn = (\n  identity: AuthIdentity,\n  req: Request,\n) => boolean | Promise<boolean>;\n\n/**\n * Server-side auth contract. Gates every admin API route. Return `null` to\n * reject outright; otherwise the gate's `authorize` predicate decides.\n */\nexport interface AuthAdapter {\n  verifyRequest(req: Request): Promise<AuthIdentity | null>;\n}\n\n/**\n * Client half of storage: performs the browser-side upload and returns the\n * final URL. Has zero server dependencies, so it is safe to import in client\n * components. Built from e.g. `@dalgoridim/headless-cms/storage/cloudinary`.\n */\nexport interface ClientStorageAdapter {\n  upload(file: File): Promise<{ url: string }>;\n}\n\n/**\n * Server half of storage: issues a presign / signature (or, for local storage,\n * writes the file). Mounted by the route factory at `${apiBasePath}/sign`.\n * Pulls in server-only SDKs, so it lives in a `/server` subpath. Built from e.g.\n * `@dalgoridim/headless-cms/storage/cloudinary/server`.\n */\nexport interface ServerStorageAdapter {\n  sign(req: Request): Promise<unknown>;\n}\n\n/** Full two-sided contract (rarely needed; client and server halves are split). */\nexport interface StorageAdapter extends ClientStorageAdapter {\n  sign?(req: Request): Promise<unknown>;\n}\n\n/**\n * Minimal client-side auth state the edit primitives depend on. Any auth\n * implementation (Firebase, NextAuth, custom) provides this via a context;\n * `@dalgoridim/headless-cms/auth/firebase/client` ships the default.\n */\nexport interface CmsAuthState {\n  isAdmin: boolean;\n  isEditing: boolean;\n  toggleEdit: () => void;\n}\n"],"mappings":"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","names":["rows"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dalgoridim/headless-cms",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "description": "Database-agnostic, inline-edit headless CMS engine for React / Next.js apps",
   "license": "UNLICENSED",
   "author": "dalgoridim",