@bobbykim/manguito-cms-api 0.4.3 → 0.6.0

package/dist/{chunk-4Y4G564P.mjs → chunk-JVP33FI2.mjs}

@@ -1,3 +1,97 @@
+// src/field-keys.ts
+function isColumnBacked(field) {
+  const col = field.db_column;
+  if (col === null) return false;
+  if (col.column_name === "") return false;
+  if (col.junction) return false;
+  return true;
+}
+function buildFieldKeyMap(pairs, allLabels, droppedKeys) {
+  const labelToColumn = /* @__PURE__ */ new Map();
+  const columnToLabel = /* @__PURE__ */ new Map();
+  for (const { label, column } of pairs) {
+    labelToColumn.set(label, column);
+    columnToLabel.set(column, label);
+  }
+  for (const { label, ownColumn } of allLabels) {
+    if (ownColumn === label) continue;
+    const columnOwner = columnToLabel.get(label);
+    if (columnOwner !== void 0 && columnOwner !== label) {
+      throw new Error(
+        `Fatal: field key map failed to build \u2014 field label "${label}" collides with the storage column of field "${columnOwner}". A field label may not reuse another field's column name. Rename the field, then run \`manguito validate\` to check your schema.`
+      );
+    }
+  }
+  for (const label of labelToColumn.keys()) {
+    if (droppedKeys.has(label)) labelToColumn.delete(label);
+  }
+  for (const column of columnToLabel.keys()) {
+    if (droppedKeys.has(column)) columnToLabel.delete(column);
+  }
+  const diverges = [...labelToColumn].some(([label, column]) => label !== column);
+  function remap(input, lookup) {
+    const out = {};
+    for (const key of Object.keys(input)) {
+      if (droppedKeys.has(key)) continue;
+      out[lookup.get(key) ?? key] = input[key];
+    }
+    return out;
+  }
+  return {
+    toStorage: (input) => remap(input, labelToColumn),
+    toLabels: (row) => remap(row, columnToLabel),
+    columnFor: (label) => labelToColumn.get(label),
+    labelFor: (column) => columnToLabel.get(column),
+    labels: [...labelToColumn.keys()],
+    diverges
+  };
+}
+function createFieldKeyMap(fields) {
+  const droppedKeys = /* @__PURE__ */ new Set();
+  const pairs = [];
+  for (const f of fields) {
+    if (!isColumnBacked(f)) continue;
+    pairs.push({ label: f.name, column: f.db_column.column_name });
+    if (f.removed === true) {
+      droppedKeys.add(f.name);
+      droppedKeys.add(f.db_column.column_name);
+    }
+  }
+  return buildFieldKeyMap(
+    pairs,
+    fields.map((f) => ({
+      label: f.name,
+      // Conditional spread, not a plain assignment — exactOptionalPropertyTypes
+      // forbids present-and-undefined.
+      ...isColumnBacked(f) && { ownColumn: f.db_column.column_name }
+    })),
+    droppedKeys
+  );
+}
+function createFieldKeyMapFromProjection(projectionType, allFields) {
+  const pairs = projectionType.fields.map((f) => ({ label: f.exposed_as, column: f.column_name }));
+  const projected = new Set(pairs.map((p) => p.label));
+  const dropped = /* @__PURE__ */ new Set();
+  for (const f of allFields) {
+    if (!isColumnBacked(f)) continue;
+    dropped.add(f.name);
+    dropped.add(f.db_column.column_name);
+  }
+  for (const p of pairs) dropped.delete(p.column);
+  for (const label of projected) dropped.delete(label);
+  return buildFieldKeyMap(
+    pairs,
+    allFields.map((f) => ({
+      label: f.name,
+      // See buildFieldKeyMap's collision check: this is what lets it tell a
+      // version exposing a field's own column under a new label (fine) from a
+      // label that reuses another field's column (not fine).
+      ...isColumnBacked(f) && { ownColumn: f.db_column.column_name }
+    })),
+    dropped
+  );
+}
+
 // src/relations.ts
 import crypto from "crypto";
 import { sql } from "drizzle-orm";
@@ -295,68 +389,15 @@ async function resolveRelationBareIds(db, rows, fieldName, rel) {
   }
 }
 
-// src/field-keys.ts
-function isColumnBacked(field) {
-  const col = field.db_column;
-  if (col === null) return false;
-  if (col.column_name === "") return false;
-  if (col.junction) return false;
-  return true;
-}
-function createFieldKeyMap(fields) {
-  const labelToColumn = /* @__PURE__ */ new Map();
-  const columnToLabel = /* @__PURE__ */ new Map();
-  const droppedKeys = /* @__PURE__ */ new Set();
-  for (const f of fields) {
-    if (!isColumnBacked(f)) continue;
-    columnToLabel.set(f.db_column.column_name, f.name);
-    if (f.removed === true) {
-      droppedKeys.add(f.name);
-      droppedKeys.add(f.db_column.column_name);
-      continue;
-    }
-    labelToColumn.set(f.name, f.db_column.column_name);
-  }
-  for (const f of fields) {
-    const columnOwner = columnToLabel.get(f.name);
-    if (columnOwner !== void 0 && columnOwner !== f.name) {
-      throw new Error(
-        `Fatal: field key map failed to build \u2014 field label "${f.name}" collides with the storage column of field "${columnOwner}". A field label may not reuse another field's column name. Rename the field, then run \`manguito validate\` to check your schema.`
-      );
-    }
-  }
-  for (const f of fields) {
-    if (isColumnBacked(f) && f.removed === true) {
-      columnToLabel.delete(f.db_column.column_name);
-    }
-  }
-  const diverges = [...labelToColumn].some(([label, column]) => label !== column);
-  function remap(input, lookup) {
-    const out = {};
-    for (const key of Object.keys(input)) {
-      if (droppedKeys.has(key)) continue;
-      out[lookup.get(key) ?? key] = input[key];
-    }
-    return out;
-  }
-  return {
-    toStorage: (input) => remap(input, labelToColumn),
-    toLabels: (row) => remap(row, columnToLabel),
-    columnFor: (label) => labelToColumn.get(label),
-    labelFor: (column) => columnToLabel.get(column),
-    labels: [...labelToColumn.keys()],
-    diverges
-  };
-}
-
 export {
+  isColumnBacked,
+  createFieldKeyMap,
+  createFieldKeyMapFromProjection,
   persistParagraphField,
   deleteParagraphField,
   persistJunctionField,
   buildRelationsMap,
   resolveRelationField,
-  resolveRelationBareIds,
-  isColumnBacked,
-  createFieldKeyMap
+  resolveRelationBareIds
 };
-//# sourceMappingURL=chunk-4Y4G564P.mjs.map
+//# sourceMappingURL=chunk-JVP33FI2.mjs.map

package/dist/chunk-JVP33FI2.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/field-keys.ts","../src/relations.ts"],"sourcesContent":["import type { DbColumn, ParsedField } from '@bobbykim/manguito-cms-core'\n\n// ─── Label ↔ storage key mapping ──────────────────────────────────────────────\n//\n// A field has two names: its public LABEL (`field.name`, what API consumers and\n// the admin panel see) and its STORAGE key (`db_column.column_name`, the actual\n// Postgres column). They are identical today, but schema versioning makes a\n// rename change only the label — the column keeps its original name for the life\n// of the data. Every place that reads or writes a DB row must therefore use the\n// storage key, and every place that reads a request body or writes a response\n// must use the label.\n//\n// Only column-backed fields participate. Paragraph fields have no column\n// (their association lives on the paragraph table via parent_field) and\n// many-to-many references have no column either (the junction table owns the\n// association), so both keep the field name as their identity and are excluded.\n\n// A type predicate, not a plain boolean: narrowing `db_column` to non-null lets\n// the compiler enforce the invariant at every call site instead of each one\n// re-asserting it with `db_column!`.\nexport function isColumnBacked(field: ParsedField): field is ParsedField & { db_column: DbColumn } {\n  const col = field.db_column\n  if (col === null) return false\n  if (col.column_name === '') return false\n  if (col.junction) return false\n  return true\n}\n\nexport type FieldKeyMap = {\n  /** Request body (label-keyed) → storage-keyed. Unknown keys pass through. */\n  toStorage(input: Record<string, unknown>): Record<string, unknown>\n  /** DB row (storage-keyed) → label-keyed. Unknown keys pass through. */\n  toLabels(row: Record<string, unknown>): Record<string, unknown>\n  columnFor(label: string): string | undefined\n  labelFor(column: string): string | undefined\n  /** Labels of column-backed fields — the valid filter/sort surface. */\n  labels: string[]\n  /** False when every label equals its column, letting callers skip the copy. */\n  diverges: boolean\n}\n\n/**\n * One field's place in the label space: the label it is known by, plus the\n * storage column it owns. `ownColumn` is ABSENT — never present-and-undefined,\n * per exactOptionalPropertyTypes — for a field with no column of its own.\n */\ntype LabelEntry = { label: string; ownColumn?: string }\n\n/**\n * The shared core: given a label↔column mapping and the FULL label space to\n * check against, produce a FieldKeyMap. Both `createFieldKeyMap` and\n * `createFieldKeyMapFromProjection` are thin adapters over this — the\n * collision check, the `diverges` computation and `remap` live here exactly\n * once.\n *\n * `pairs` may include entries that must NOT survive into the final map —\n * `createFieldKeyMap` passes tombstoned columns in alongside live ones,\n * exactly as the original single-function implementation did, so that the\n * collision check below (which runs against the unfiltered map) still\n * catches a live field's label colliding with a TOMBSTONE's column. Any\n * pair whose label or column appears in `droppedKeys` is stripped from\n * `labelToColumn`/`columnToLabel` immediately after the check, before\n * `diverges` and `labels` are computed — so the caller does not need to\n * pre-filter `pairs` itself, only tell this function what to drop.\n *\n * `allLabels` is every field's label, including fields with no column of\n * their own. That is not tidiness: a paragraph, many-to-many or programmatic\n * field's label is written into the same key space as storage columns before\n * `toLabels` runs, so one named after another field's column would overwrite\n * that column's value and then be renamed onto the other field's label.\n * Both constructors must pass the complete set.\n *\n * Each entry carries `ownColumn` — the column that field itself is backed by,\n * absent for a paragraph, many-to-many or programmatic field. The collision\n * check below needs it: a label that equals a column is a collision only when\n * the column belongs to a DIFFERENT field, and strings alone cannot tell the\n * two apart.\n *\n * `droppedKeys` also drives `remap`: it must actively remove a key from a\n * mapped object rather than merely leave it unmapped, because `remap` passes\n * an unmapped key through unchanged — a retained-but-unexposed column would\n * otherwise reach the output under its raw name.\n */\nfunction buildFieldKeyMap(\n  pairs: Array<{ label: string; column: string }>,\n  allLabels: LabelEntry[],\n  droppedKeys: Set<string>\n): FieldKeyMap {\n  const labelToColumn = new Map<string, string>()\n  const columnToLabel = new Map<string, string>()\n  for (const { label, column } of pairs) {\n    labelToColumn.set(label, column)\n    columnToLabel.set(column, label)\n  }\n\n  // A label that is also some OTHER field's column name would make toLabels\n  // ambiguous: two source keys would map onto one destination key.\n  //\n  // Checked against EVERY label in `allLabels`, not just the ones with a\n  // pair of their own. Paragraph, many-to-many and programmatic fields have\n  // no column of their own, but their labels are written into the same key\n  // space as storage columns before toLabels runs (routes/admin/content.ts,\n  // relations.ts, programmatic/resolve.ts). A paragraph field named after\n  // another field's column would overwrite that column's value on the row\n  // and then be renamed onto the other field's label — serving the wrong\n  // value under the wrong key.\n  //\n  // Deliberately run BEFORE dropped pairs are stripped from `columnToLabel`\n  // below: a live field's label may collide with a TOMBSTONE's column (the\n  // column still physically exists on the row), and that must keep\n  // throwing. Stripping first would silently pass this configuration, and\n  // the exclusion step afterward would then delete the live field's column\n  // from every response instead of the tombstone's.\n  //\n  // Not detected: two fields declaring the SAME column name. A field can now\n  // declare its own `column`, so this is no longer structurally impossible —\n  // but core rejects it with `DUPLICATE_COLUMN` at parse time, so it is still\n  // unreachable here.\n  for (const { label, ownColumn } of allLabels) {\n    // The label is this field's OWN column, exposed by this version under a\n    // different name. That is not an ambiguity — it is one field seen twice,\n    // under current's name and under the label this version uses — and there\n    // is still exactly one column holding exactly one value. It happens when a\n    // field is renamed away and then renamed BACK onto its column's name while\n    // the intermediate version is still live. Without this skip the map refuses\n    // to build and createCmsApp throws at startup for every version at once.\n    //\n    // Only the SAME field is exempted: `ownColumn` is absent for a field with\n    // no column of its own (a paragraph, many-to-many or programmatic field's\n    // label named after some other field's column is precisely the ambiguity\n    // this check exists for), and differs from `label` when the name belongs to\n    // one field while the column belongs to another.\n    if (ownColumn === label) continue\n    const columnOwner = columnToLabel.get(label)\n    if (columnOwner !== undefined && columnOwner !== label) {\n      throw new Error(\n        `Fatal: field key map failed to build — field label \"${label}\" collides with the ` +\n          `storage column of field \"${columnOwner}\". A field label may not reuse another ` +\n          `field's column name. Rename the field, then run \\`manguito validate\\` to check your schema.`\n      )\n    }\n  }\n\n  // Only now strip dropped pairs — the collision check above has already run\n  // against the full map. A dropped pair is removed from BOTH maps: from\n  // `labelToColumn` by its label, from `columnToLabel` by its column.\n  for (const label of labelToColumn.keys()) {\n    if (droppedKeys.has(label)) labelToColumn.delete(label)\n  }\n  for (const column of columnToLabel.keys()) {\n    if (droppedKeys.has(column)) columnToLabel.delete(column)\n  }\n\n  const diverges = [...labelToColumn].some(([label, column]) => label !== column)\n\n  function remap(\n    input: Record<string, unknown>,\n    lookup: Map<string, string>\n  ): Record<string, unknown> {\n    // Always returns a NEW object, even when nothing diverges. Returning `input`\n    // unchanged would make aliasing depend on the schema, so a bug where a\n    // caller mutates a row after mapping would reproduce only on renamed\n    // fields. A shallow copy per row is not worth that class of bug.\n    //\n    // Unknown keys pass through unchanged — which is exactly why a dropped\n    // key must be checked and skipped explicitly here, rather than relying on\n    // its absence from `lookup`: absence alone would let it pass through under\n    // its raw key instead of being dropped.\n    const out: Record<string, unknown> = {}\n    for (const key of Object.keys(input)) {\n      if (droppedKeys.has(key)) continue\n      out[lookup.get(key) ?? key] = input[key]\n    }\n    return out\n  }\n\n  return {\n    toStorage: (input) => remap(input, labelToColumn),\n    toLabels: (row) => remap(row, columnToLabel),\n    columnFor: (label) => labelToColumn.get(label),\n    labelFor: (column) => columnToLabel.get(column),\n    labels: [...labelToColumn.keys()],\n    diverges,\n  }\n}\n\n/**\n * Built ONCE per content type at startup, not per request. Throws on a key\n * collision, matching how createCmsApp refuses to boot on a broken roles\n * registry: an ambiguous mapping would silently corrupt responses.\n *\n * Tombstones (`field.removed === true`) are column-backed — the parser keeps\n * their column alive for older live versions — but the CURRENT version must\n * never serve or accept them. Their pair is passed into the shared core\n * alongside the live ones (so the collision check below still sees them —\n * see `buildFieldKeyMap`'s doc comment), and then stripped from the returned\n * map via `droppedKeys` — which also drives `remap`: without that, an\n * unmapped retained column would pass through `remap` unchanged and reach\n * the response under its raw column name.\n */\nexport function createFieldKeyMap(fields: ParsedField[]): FieldKeyMap {\n  // Both the name and the column of every tombstone, so the shared core can\n  // strip a tombstone under either key. They differ when a field was renamed\n  // and THEN removed: it carries both `column` (the original, still-live\n  // column) and `removed`.\n  const droppedKeys = new Set<string>()\n  const pairs: Array<{ label: string; column: string }> = []\n\n  for (const f of fields) {\n    if (!isColumnBacked(f)) continue\n    // Keyed by `f.name` for every column-backed field, live or tombstoned, so\n    // buildFieldKeyMap's post-check stripping (which deletes from\n    // `labelToColumn` by the labels in `droppedKeys`) can find and remove a\n    // tombstone's own entry. That leans on field names being unique across\n    // live and tombstoned fields within one type — true today (core rejects\n    // a duplicate name at parse time) but only load-bearing here because this\n    // refactor now writes a tombstone's pair into the shared map at all; the\n    // original single-function implementation `continue`d past a tombstone\n    // before ever writing one, so the collision was structurally impossible.\n    pairs.push({ label: f.name, column: f.db_column.column_name })\n    if (f.removed === true) {\n      droppedKeys.add(f.name)\n      droppedKeys.add(f.db_column.column_name)\n    }\n  }\n\n  // `ownColumn` is a strict no-op on this path and is passed only so the two\n  // constructors share one core: here a label IS a field's name, so a field\n  // whose own column equals its name already maps that column back to itself\n  // (`columnOwner === label`) and never reached the throw. It matters only for\n  // a projection, which can expose a column under some other label.\n  return buildFieldKeyMap(\n    pairs,\n    fields.map((f) => ({\n      label: f.name,\n      // Conditional spread, not a plain assignment — exactOptionalPropertyTypes\n      // forbids present-and-undefined.\n      ...(isColumnBacked(f) && { ownColumn: f.db_column.column_name }),\n    })),\n    droppedKeys\n  )\n}\n\n/**\n * From a version's projection. The projection is already the label↔column\n * mapping and already excludes tombstones and non-column-backed fields, so\n * there is nothing to filter — but the collision check still needs every\n * field's label, which is why `allFields` is required.\n */\nexport function createFieldKeyMapFromProjection(\n  projectionType: { fields: Array<{ column_name: string; exposed_as: string; fallback?: unknown }> },\n  allFields: ParsedField[]\n): FieldKeyMap {\n  const pairs = projectionType.fields.map((f) => ({ label: f.exposed_as, column: f.column_name }))\n  const projected = new Set(pairs.map((p) => p.label))\n  // Every column-backed field this projection does NOT expose must be\n  // actively dropped — not just tombstones. A tombstone's column is one way\n  // a column can be absent from the projection, but it is not the only one:\n  // a field added to the CURRENT schema after this version was cut is live\n  // (`removed !== true`) and is just as absent from an older version's\n  // projection, and `remap` passes an unknown key through unchanged — so\n  // without this, a column added later would leak into every older live\n  // version's response straight off `SELECT *`. Building the drop-set from\n  // \"every column-backed field, then un-drop what this projection exposes\"\n  // subsumes the tombstone case instead of special-casing it.\n  const dropped = new Set<string>()\n  for (const f of allFields) {\n    if (!isColumnBacked(f)) continue\n    dropped.add(f.name)\n    dropped.add(f.db_column.column_name)\n  }\n  // A column this version DOES expose must not be dropped — protects both a\n  // retained tombstone column (the original case) and a column that is live\n  // in the current schema but simply predates this version (the general case\n  // above). Same for its label.\n  for (const p of pairs) dropped.delete(p.column)\n  for (const label of projected) dropped.delete(label)\n\n  return buildFieldKeyMap(\n    pairs,\n    allFields.map((f) => ({\n      label: f.name,\n      // See buildFieldKeyMap's collision check: this is what lets it tell a\n      // version exposing a field's own column under a new label (fine) from a\n      // label that reuses another field's column (not fine).\n      ...(isColumnBacked(f) && { ownColumn: f.db_column.column_name }),\n    })),\n    dropped\n  )\n}\n","import crypto from 'node:crypto'\nimport { sql } from 'drizzle-orm'\nimport type { ParsedField, ParsedParagraphType, SchemaRegistry } from '@bobbykim/manguito-cms-core'\nimport type { DrizzlePostgresInstance } from '@bobbykim/manguito-cms-db'\nimport type { MediaDelta } from './media-references.js'\n\n// ─── Relation persistence ─────────────────────────────────────────────────────\n//\n// Owns paragraph/junction/reference/media relation table SQL — both the write\n// side (persist/delete below) and the read side (descriptors + resolvers further\n// down). Each persist/delete returns the MediaDelta of media ids it gained and\n// lost (see media-references.ts), which the caller merges and reconciles once.\n// The repository's resolveRows() drives the read resolvers.\n\nfunction quoteIdent(name: string): string {\n  if (!/^[a-z][a-z0-9_-]*$/.test(name)) throw new Error(`Unsafe identifier: ${name}`)\n  return `\"${name}\"`\n}\n\n// Paragraph rows live on a child table with their own image/video/file columns\n// (e.g. a \"photo card\" block embeds an image) — these need the same reference-count\n// bookkeeping as top-level content fields, one level down.\nfunction paragraphMediaFieldNames(pType: ParsedParagraphType): Set<string> {\n  return new Set(\n    pType.fields\n      .filter((f) => f.field_type === 'image' || f.field_type === 'video' || f.field_type === 'file')\n      .map((f) => f.name)\n  )\n}\n\nasync function fetchParagraphMediaIds(\n  db: DrizzlePostgresInstance,\n  pType: ParsedParagraphType,\n  itemId: string,\n  fieldName: string\n): Promise<string[]> {\n  const mediaColumns = pType.fields\n    .filter((f) => f.field_type === 'image' || f.field_type === 'video' || f.field_type === 'file')\n    .map((f) => f.db_column!.column_name)\n  if (mediaColumns.length === 0) return []\n\n  const tbl = sql.raw(quoteIdent(pType.db.table_name))\n  const cols = sql.join(mediaColumns.map((c) => sql.raw(quoteIdent(c))), sql`, `)\n  const result = await db.execute(\n    sql`SELECT ${cols} FROM ${tbl} WHERE parent_id = ${itemId} AND parent_field = ${fieldName}`\n  )\n\n  const ids: string[] = []\n  for (const row of result.rows as Record<string, unknown>[]) {\n    for (const col of mediaColumns) {\n      const v = row[col]\n      if (typeof v === 'string' && v !== '') ids.push(v)\n    }\n  }\n  return ids\n}\n\n// A paragraph type's own paragraph fields — the one level of nesting ADR\n// core/0005 permits. Empty without a registry, which is how callers that have no\n// nesting to persist opt out.\nfunction nestedParagraphFields(\n  pType: ParsedParagraphType,\n  registry?: SchemaRegistry\n): Array<{ fieldName: string; nType: ParsedParagraphType }> {\n  if (!registry) return []\n  const out: Array<{ fieldName: string; nType: ParsedParagraphType }> = []\n  for (const f of pType.fields) {\n    if (f.db_column !== null) continue\n    const comp = f.ui_component as { component: string; ref?: string }\n    if (comp.component !== 'paragraph-embed' || !comp.ref) continue\n    const nType = registry.paragraph_types[comp.ref]\n    if (nType) out.push({ fieldName: f.name, nType })\n  }\n  return out\n}\n\n// Ids of the paragraph rows currently stored for one field of one parent.\nasync function fetchParagraphRowIds(\n  db: DrizzlePostgresInstance,\n  pType: ParsedParagraphType,\n  itemId: string,\n  fieldName: string\n): Promise<string[]> {\n  const tbl = sql.raw(quoteIdent(pType.db.table_name))\n  const result = await db.execute(\n    sql`SELECT id FROM ${tbl} WHERE parent_id = ${itemId} AND parent_field = ${fieldName}`\n  )\n  return (result.rows as Record<string, unknown>[])\n    .map((r) => r['id'])\n    .filter((id): id is string => typeof id === 'string')\n}\n\n// Replaces every paragraph row for one field of one parent (delete + reinsert),\n// returning the media ids removed (old rows) and added (new rows).\n//\n// `registry` enables one level of paragraph nesting (ADR core/0005): a nested\n// paragraph field has no column on its parent's table, so without this its items\n// were silently dropped on write. Nested rows hang off the *paragraph* row's id,\n// and are torn down with it so the delete+reinsert cannot orphan them.\nexport async function persistParagraphField(\n  db: DrizzlePostgresInstance,\n  itemId: string,\n  parentType: string,\n  fieldName: string,\n  pType: ParsedParagraphType,\n  items: unknown[],\n  registry?: SchemaRegistry\n): Promise<MediaDelta> {\n  const removed = await fetchParagraphMediaIds(db, pType, itemId, fieldName)\n  const nested = nestedParagraphFields(pType, registry)\n\n  // Tear down nested rows before their parents disappear, collecting the media\n  // they referenced so reference counts stay correct.\n  if (nested.length > 0) {\n    const staleIds = await fetchParagraphRowIds(db, pType, itemId, fieldName)\n    for (const rowId of staleIds) {\n      for (const n of nested) {\n        const d = await deleteParagraphField(db, rowId, n.fieldName, n.nType, registry)\n        removed.push(...d.removed)\n      }\n    }\n  }\n\n  const tbl = sql.raw(quoteIdent(pType.db.table_name))\n  await db.execute(sql`DELETE FROM ${tbl} WHERE parent_id = ${itemId} AND parent_field = ${fieldName}`)\n\n  const mediaFieldNames = paragraphMediaFieldNames(pType)\n  const added: string[] = []\n\n  for (let i = 0; i < items.length; i++) {\n    const pItem = items[i] as Record<string, unknown>\n    const rowId = crypto.randomUUID()\n    const data: Record<string, unknown> = {\n      id: rowId,\n      parent_id: itemId,\n      parent_type: parentType,\n      parent_field: fieldName,\n      order: i,\n      created_at: new Date(),\n      updated_at: new Date(),\n    }\n    for (const pf of pType.fields) {\n      if (!pf.db_column || pf.db_column.junction) continue\n      data[pf.db_column.column_name] = pItem[pf.name] ?? null\n    }\n    const cols = sql.join(Object.keys(data).map((k) => sql.raw(quoteIdent(k))), sql`, `)\n    const vals = sql.join(Object.values(data).map((v) => sql`${v}`), sql`, `)\n    await db.execute(sql`INSERT INTO ${tbl} (${cols}) VALUES (${vals})`)\n\n    for (const name of mediaFieldNames) {\n      const val = pItem[name]\n      if (typeof val === 'string' && val !== '') added.push(val)\n    }\n\n    // Persist this row's nested paragraph items against the row just inserted.\n    for (const n of nested) {\n      const nestedItems = Array.isArray(pItem[n.fieldName]) ? (pItem[n.fieldName] as unknown[]) : []\n      const d = await persistParagraphField(\n        db,\n        rowId,\n        pType.db.table_name,\n        n.fieldName,\n        n.nType,\n        nestedItems,\n        registry\n      )\n      added.push(...d.added)\n      removed.push(...d.removed)\n    }\n  }\n\n  return { added, removed }\n}\n\n// Deletes all paragraph rows for one field of one parent (used when the parent is\n// being deleted — paragraph rows have no FK/cascade back to their parent, so they'd\n// leak otherwise). Returns the media those rows referenced, all removed.\nexport async function deleteParagraphField(\n  db: DrizzlePostgresInstance,\n  itemId: string,\n  fieldName: string,\n  pType: ParsedParagraphType,\n  registry?: SchemaRegistry\n): Promise<MediaDelta> {\n  const removed = await fetchParagraphMediaIds(db, pType, itemId, fieldName)\n\n  // Cascade to nested paragraph rows, which hang off these rows' ids.\n  const nested = nestedParagraphFields(pType, registry)\n  if (nested.length > 0) {\n    const rowIds = await fetchParagraphRowIds(db, pType, itemId, fieldName)\n    for (const rowId of rowIds) {\n      for (const n of nested) {\n        const d = await deleteParagraphField(db, rowId, n.fieldName, n.nType, registry)\n        removed.push(...d.removed)\n      }\n    }\n  }\n\n  const tbl = sql.raw(quoteIdent(pType.db.table_name))\n  await db.execute(sql`DELETE FROM ${tbl} WHERE parent_id = ${itemId} AND parent_field = ${fieldName}`)\n  return { added: [], removed }\n}\n\n// Replaces every junction row for one many-to-many field of one parent.\nexport async function persistJunctionField(\n  db: DrizzlePostgresInstance,\n  itemId: string,\n  junction: { table_name: string; left_column: string; right_column: string },\n  relatedIds: string[]\n): Promise<void> {\n  const tbl = sql.raw(quoteIdent(junction.table_name))\n  const left = sql.raw(quoteIdent(junction.left_column))\n  const right = sql.raw(quoteIdent(junction.right_column))\n  await db.execute(sql`DELETE FROM ${tbl} WHERE ${left} = ${itemId}`)\n  for (const rid of relatedIds) {\n    await db.execute(sql`INSERT INTO ${tbl} (${left}, ${right}) VALUES (${itemId}, ${rid})`)\n  }\n}\n\n// ─── Relation descriptors and resolution (read side) ──────────────────────────\n//\n// Relation read resolution. These were lifted out of the repository so that all\n// paragraph/junction/reference/media table SQL lives in one module alongside the\n// write persistence above. The repository's resolveRows() calls into here.\n\nexport type ParagraphRelationDef = {\n  type: 'paragraph'\n  table: string\n}\n\nexport type ReferenceRelationDef = {\n  type: 'reference'\n  table: string\n  fk_column: string\n}\n\nexport type JunctionRelationDef = {\n  type: 'junction'\n  table: string\n  junction_table: string\n  left_column: string\n  right_column: string\n  // Only ordered junctions have an \"order\" column (db codegen emits it only when\n  // order_column is true) — the resolver must not ORDER BY it otherwise.\n  order_column: boolean\n}\n\nexport type MediaRelationDef = {\n  type: 'media'\n  fk_column: string\n}\n\nexport type RelationDef =\n  | ParagraphRelationDef\n  | ReferenceRelationDef\n  | JunctionRelationDef\n  | MediaRelationDef\n\n// Derives a content type's relations map from its parsed fields, so paragraph/\n// reference/media fields are actually resolved instead of silently dropped.\n// Junction and foreign_key info is already on each field's db_column; paragraph\n// fields store their target table on the paragraph type, hence the registry.\nexport function buildRelationsMap(\n  fields: ParsedField[],\n  registry: SchemaRegistry\n): Record<string, RelationDef> {\n  const relations: Record<string, RelationDef> = {}\n\n  for (const field of fields) {\n    if (field.field_type === 'image' || field.field_type === 'video' || field.field_type === 'file') {\n      if (!field.db_column) continue\n      relations[field.name] = { type: 'media', fk_column: field.db_column.column_name }\n    } else if (field.field_type === 'paragraph') {\n      const ref = (field.ui_component as { ref?: string }).ref\n      const pType = ref ? registry.paragraph_types[ref] : undefined\n      if (!pType) continue\n      relations[field.name] = { type: 'paragraph', table: pType.db.table_name }\n    } else if (field.field_type === 'reference') {\n      if (!field.db_column) continue\n      if (field.db_column.junction) {\n        const j = field.db_column.junction\n        relations[field.name] = {\n          type: 'junction',\n          table: j.right_table,\n          junction_table: j.table_name,\n          left_column: j.left_column,\n          right_column: j.right_column,\n          order_column: j.order_column,\n        }\n      } else if (field.db_column.foreign_key) {\n        relations[field.name] = {\n          type: 'reference',\n          table: field.db_column.foreign_key.table,\n          fk_column: field.db_column.column_name,\n        }\n      }\n    }\n  }\n\n  return relations\n}\n\nfunction groupBy<T extends Record<string, unknown>>(\n  items: T[],\n  key: string\n): Record<string, T[]> {\n  const result: Record<string, T[]> = {}\n  for (const item of items) {\n    const k = String(item[key])\n    if (!result[k]) result[k] = []\n    result[k]!.push(item)\n  }\n  return result\n}\n\n// A reference/media pass is DESTRUCTIVE: the resolved object replaces the raw FK\n// value, and when the field's label differs from its FK column (a renamed field)\n// the raw FK key is deleted outright — otherwise the response would carry both\n// the column name and the label.\n//\n// That makes a second pass over the same row object dangerous: the FK the first\n// pass consumed is gone, so the row would be nulled out. And the same object\n// really does recur — reference/junction targets are cached by `table:id`, so two\n// parents receive ONE shared object, and the GraphQL dataloaders deliberately do\n// not memoize by parent identity (\"rows are mutated and may recur across nesting\n// levels\", dataloaders.ts). So a row that already holds a resolved value is\n// skipped, which makes the pass idempotent.\nfunction needsFkResolution(\n  row: Record<string, unknown>,\n  fkColumn: string,\n  fieldName: string\n): boolean {\n  // Label diverges from the column: a missing FK key means it was already dropped.\n  if (fkColumn !== fieldName && !(fkColumn in row)) return false\n  // Label equals the column: the resolved object sits where the raw id was, so an\n  // object (never a bare id) means this row is already done.\n  const current = row[fieldName]\n  return !(typeof current === 'object' && current !== null)\n}\n\n// Fully resolves a relation field on a batch of rows: paragraph → ordered rows,\n// reference → the target row, junction → target rows, media → the media row.\n// The cache (keyed table:id) dedupes target lookups within a request.\n//\n// `publishedOnly` (default false, preserving prior behavior for admin callers)\n// adds `AND published = true` to the reference/junction target-row SELECTs.\n// Reference and junction targets are always content or taxonomy tables, which\n// always carry a `published` boolean system field — see CONTENT_SYSTEM_FIELDS /\n// TAXONOMY_SYSTEM_FIELDS in packages/core/src/parser/parseSchema.ts. Paragraph\n// and media targets are deliberately excluded: paragraph rows are owned by\n// their parent (no independent publish state) and media rows have no\n// `published` column at all.\nexport async function resolveRelationField(\n  db: DrizzlePostgresInstance,\n  rows: Record<string, unknown>[],\n  fieldName: string,\n  rel: RelationDef,\n  cache: Map<string, unknown>,\n  publishedOnly = false\n): Promise<void> {\n  if (rows.length === 0) return\n\n  // Deduped by object identity: one batch can hold the same row twice (see\n  // needsFkResolution above), and the destructive branches would then read an FK\n  // the first visit already consumed. The caller's array is left untouched — the\n  // GraphQL dataloader maps over it to build its results.\n  const batch = [...new Set(rows)]\n\n  if (rel.type === 'paragraph') {\n    const parentIds = batch.map((r) => r['id'] as string)\n    const inList = sql.join(parentIds.map((id) => sql`${id}`), sql`, `)\n    // Scoped by parent_field as well as parent_id: two paragraph fields of the\n    // same paragraph type share one table, so filtering on the parent alone\n    // hands each field the other's rows.\n    const result = await db.execute(\n      sql`SELECT * FROM ${sql.raw(quoteIdent(rel.table))} WHERE parent_id IN (${inList}) AND parent_field = ${fieldName} ORDER BY \"order\" ASC`\n    )\n    const byParent = groupBy(result.rows as Record<string, unknown>[], 'parent_id')\n    for (const row of batch) {\n      row[fieldName] = byParent[row['id'] as string] ?? []\n    }\n  } else if (rel.type === 'reference') {\n    const dropFk = rel.fk_column !== fieldName\n    const pending = batch.filter((r) => needsFkResolution(r, rel.fk_column, fieldName))\n    if (pending.length === 0) return\n\n    const fkValues = pending.map((r) => r[rel.fk_column] as string).filter(Boolean)\n    if (fkValues.length === 0) {\n      for (const row of pending) {\n        row[fieldName] = null\n        if (dropFk) delete row[rel.fk_column]\n      }\n      return\n    }\n    const unique = [...new Set(fkValues)]\n    const uncached = unique.filter((id) => !cache.has(`${rel.table}:${id}`))\n    if (uncached.length > 0) {\n      const inList = sql.join(uncached.map((id) => sql`${id}`), sql`, `)\n      const publishedCond = publishedOnly ? sql` AND published = true` : sql``\n      const result = await db.execute(\n        sql`SELECT * FROM ${sql.raw(quoteIdent(rel.table))} WHERE id IN (${inList})${publishedCond}`\n      )\n      for (const item of result.rows as Record<string, unknown>[]) {\n        cache.set(`${rel.table}:${item['id']}`, item)\n      }\n    }\n    for (const row of pending) {\n      const fkVal = row[rel.fk_column] as string\n      row[fieldName] = fkVal ? (cache.get(`${rel.table}:${fkVal}`) ?? null) : null\n      if (dropFk) delete row[rel.fk_column]\n    }\n  } else if (rel.type === 'junction') {\n    const parentIds = batch.map((r) => r['id'] as string)\n    const inList = sql.join(parentIds.map((id) => sql`${id}`), sql`, `)\n    const orderBy = rel.order_column ? sql` ORDER BY \"order\" ASC` : sql``\n    const junctionResult = await db.execute(\n      sql`SELECT * FROM ${sql.raw(quoteIdent(rel.junction_table))} WHERE ${sql.raw(quoteIdent(rel.left_column))} IN (${inList})${orderBy}`\n    )\n    const jRows = junctionResult.rows as Record<string, unknown>[]\n    const rightIds = [...new Set(jRows.map((r) => r[rel.right_column] as string))]\n    const uncached = rightIds.filter((id) => !cache.has(`${rel.table}:${id}`))\n    if (uncached.length > 0) {\n      const rightInList = sql.join(uncached.map((id) => sql`${id}`), sql`, `)\n      const publishedCond = publishedOnly ? sql` AND published = true` : sql``\n      const entitiesResult = await db.execute(\n        sql`SELECT * FROM ${sql.raw(quoteIdent(rel.table))} WHERE id IN (${rightInList})${publishedCond}`\n      )\n      for (const item of entitiesResult.rows as Record<string, unknown>[]) {\n        cache.set(`${rel.table}:${item['id']}`, item)\n      }\n    }\n    const byLeft = groupBy(jRows, rel.left_column)\n    for (const row of batch) {\n      const jEntries = byLeft[row['id'] as string] ?? []\n      row[fieldName] = jEntries\n        .map((jr) => cache.get(`${rel.table}:${jr[rel.right_column] as string}`))\n        .filter(Boolean)\n    }\n  } else if (rel.type === 'media') {\n    const dropFk = rel.fk_column !== fieldName\n    const pending = batch.filter((r) => needsFkResolution(r, rel.fk_column, fieldName))\n    if (pending.length === 0) return\n\n    const fkValues = pending.map((r) => r[rel.fk_column] as string).filter(Boolean)\n    if (fkValues.length === 0) {\n      for (const row of pending) {\n        row[fieldName] = null\n        if (dropFk) delete row[rel.fk_column]\n      }\n      return\n    }\n    const unique = [...new Set(fkValues)]\n    const uncached = unique.filter((id) => !cache.has(`media:${id}`))\n    if (uncached.length > 0) {\n      const inList = sql.join(uncached.map((id) => sql`${id}`), sql`, `)\n      const result = await db.execute(sql`SELECT * FROM \"media\" WHERE id IN (${inList})`)\n      for (const item of result.rows as Record<string, unknown>[]) {\n        cache.set(`media:${item['id']}`, item)\n      }\n    }\n    for (const row of pending) {\n      const fkVal = row[rel.fk_column] as string\n      row[fieldName] = fkVal ? (cache.get(`media:${fkVal}`) ?? null) : null\n      if (dropFk) delete row[rel.fk_column]\n    }\n  }\n}\n\n// Populates paragraph/junction fields with bare ID arrays when they are not\n// explicitly included — they have no column on the owning table, so without this\n// they'd be silently absent. Reference fields already carry their bare ID as a\n// real column from `SELECT *`, so they need no extra query.\nexport async function resolveRelationBareIds(\n  db: DrizzlePostgresInstance,\n  rows: Record<string, unknown>[],\n  fieldName: string,\n  rel: RelationDef\n): Promise<void> {\n  if (rows.length === 0) return\n\n  if (rel.type === 'paragraph') {\n    const parentIds = rows.map((r) => r['id'] as string)\n    const inList = sql.join(parentIds.map((id) => sql`${id}`), sql`, `)\n    const result = await db.execute(\n      sql`SELECT id, parent_id FROM ${sql.raw(quoteIdent(rel.table))} WHERE parent_id IN (${inList}) AND parent_field = ${fieldName} ORDER BY \"order\" ASC`\n    )\n    const byParent = groupBy(result.rows as Record<string, unknown>[], 'parent_id')\n    for (const row of rows) {\n      row[fieldName] = (byParent[row['id'] as string] ?? []).map((r) => r['id'])\n    }\n  } else if (rel.type === 'junction') {\n    const parentIds = rows.map((r) => r['id'] as string)\n    const inList = sql.join(parentIds.map((id) => sql`${id}`), sql`, `)\n    const result = await db.execute(\n      sql`SELECT ${sql.raw(quoteIdent(rel.left_column))} AS left_id, ${sql.raw(quoteIdent(rel.right_column))} AS right_id FROM ${sql.raw(quoteIdent(rel.junction_table))} WHERE ${sql.raw(quoteIdent(rel.left_column))} IN (${inList})`\n    )\n    const byLeft = groupBy(result.rows as Record<string, unknown>[], 'left_id')\n    for (const row of rows) {\n      row[fieldName] = (byLeft[row['id'] as string] ?? []).map((r) => r['right_id'])\n    }\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-HEYT5CH5.mjs → chunk-XNXM4W4K.mjs}

@@ -2,7 +2,7 @@ import {
   buildRelationsMap,
   isColumnBacked,
   resolveRelationField
-} from "./chunk-4Y4G564P.mjs";
+} from "./chunk-JVP33FI2.mjs";
 
 // src/graphql/handler.ts
 import { createYoga, maskError } from "graphql-yoga";
@@ -142,10 +142,13 @@ var SORTABLE = [
   { gql: "createdAt", value: "created_at" },
   { gql: "updatedAt", value: "updated_at" }
 ];
-function buildSortFieldEnum(typeName) {
+function buildSortFieldEnum(typeName, fieldKeys) {
+  const resolvable = SORTABLE.filter(
+    (s) => s.gql === "createdAt" || s.gql === "updatedAt" || fieldKeys === void 0 || fieldKeys.columnFor(s.value) !== void 0
+  );
   return new GraphQLEnumType({
     name: `${typeName}SortField`,
-    values: Object.fromEntries(SORTABLE.map((s) => [s.gql, { value: s.value }]))
+    values: Object.fromEntries(resolvable.map((s) => [s.gql, { value: s.value }]))
   });
 }
 function comparableFilterInput(name, scalar) {
@@ -189,18 +192,19 @@ function filterInputForField(fieldType) {
   if (scalar === null) return null;
   return StringFilter;
 }
-function buildFilterInputType(type) {
+function buildFilterInputType(type, viewFields) {
   const fields = {};
   fields["id"] = { type: IDFilter };
   fields["published"] = { type: BooleanFilter };
   fields["createdAt"] = { type: DateTimeFilter };
   fields["updatedAt"] = { type: DateTimeFilter };
   if (type.schema_type === "content-type") fields["slug"] = { type: StringFilter };
-  for (const f of type.fields) {
+  const entries = viewFields !== void 0 ? viewFields.map((v) => ({ field: v.field, exposedAs: v.exposedAs })) : type.fields.filter((f) => f.removed !== true).map((f) => ({ field: f, exposedAs: f.name }));
+  for (const { field: f, exposedAs } of entries) {
     if (f.field_type === "programmatic" || f.field_type === "paragraph") continue;
     if (f.field_type === "image" || f.field_type === "video" || f.field_type === "file") continue;
     const input = filterInputForField(f.field_type);
-    if (input) fields[buildFieldNameMap([f.name]).toGraphql(f.name)] = { type: input };
+    if (input) fields[buildFieldNameMap([exposedAs]).toGraphql(exposedAs)] = { type: input };
   }
   if (Object.keys(fields).length === 0) return null;
   return new GraphQLInputObjectType({ name: `${graphqlTypeName(type.name)}Filter`, fields });
@@ -236,32 +240,41 @@ function codeError(code, message) {
 function isPublished(item) {
   return !!item && item["published"] === true;
 }
-function resolveFieldValue(field, row) {
+function resolveFieldValue(field, row, fallback) {
   const key = isColumnBacked(field) ? field.db_column.column_name : field.name;
-  return row[key] ?? null;
+  const value = row[key];
+  if ((value === null || value === void 0) && fallback !== void 0) return fallback;
+  return value ?? null;
 }
-function scalarFieldResolver(field) {
-  return (parent) => resolveFieldValue(field, parent);
+function scalarFieldResolver(field, fallback) {
+  return (parent) => resolveFieldValue(field, parent, fallback);
 }
 function relationFieldResolver(typeName, schemaFieldName) {
   return (parent, _args, ctx) => ctx.loaders.load(typeName, schemaFieldName, parent);
 }
-function programmaticFieldResolver(typeName, schemaFieldName, mediaFieldNames = [], fieldKeys) {
+function programmaticFieldResolver(typeName, schemaFieldName, mediaFields = [], fieldKeys) {
   return async (parent, _args, ctx) => {
     let p = ctx.programmaticMemo.get(parent);
     if (!p) {
-      p = resolveProgrammaticRow(typeName, parent, ctx, mediaFieldNames, fieldKeys);
+      p = resolveProgrammaticRow(typeName, parent, ctx, mediaFields, fieldKeys);
       ctx.programmaticMemo.set(parent, p);
     }
     return (await p)[schemaFieldName];
   };
 }
-async function resolveProgrammaticRow(typeName, parent, ctx, mediaFieldNames, fieldKeys) {
+async function resolveProgrammaticRow(typeName, parent, ctx, mediaFields, fieldKeys) {
   const toLabels = (row) => fieldKeys ? fieldKeys.toLabels(row) : row;
-  if (mediaFieldNames.length === 0) return ctx.resolver.resolveItem(typeName, toLabels(parent));
+  if (mediaFields.length === 0) return ctx.resolver.resolveItem(typeName, toLabels(parent));
   const enriched = { ...parent };
-  await Promise.all(mediaFieldNames.map((name) => ctx.loaders.load(typeName, name, enriched)));
-  return ctx.resolver.resolveItem(typeName, toLabels(enriched));
+  await Promise.all(mediaFields.map((m) => ctx.loaders.load(typeName, m.name, enriched)));
+  return ctx.resolver.resolveItem(typeName, relabelMedia(toLabels(enriched), enriched, mediaFields));
+}
+function relabelMedia(record, enriched, mediaFields) {
+  for (const { name, exposedAs } of mediaFields) {
+    if (!(name in enriched)) continue;
+    record[exposedAs] = enriched[name];
+  }
+  return record;
 }
 function collectionResolver(typeName, nameMap, fieldKeys) {
   return async (_root, args, ctx) => {
@@ -335,7 +348,7 @@ var MEDIA = new GraphQLObjectType({
     duration: { type: GraphQLInt3, resolve: (m) => m.duration }
   }
 });
-function buildGraphQLSchema(registry, fieldKeyMaps = {}) {
+function buildGraphQLSchema(registry, fieldKeyMaps = {}, view) {
   const objectTypes = /* @__PURE__ */ new Map();
   const enumTypes = /* @__PURE__ */ new Map();
   for (const [name, enumType] of Object.entries(registry.enum_types)) {
@@ -354,14 +367,14 @@ function buildGraphQLSchema(registry, fieldKeyMaps = {}) {
       );
     }
   }
-  function outputTypeForField(field) {
+  function outputTypeForField(field, required) {
     const scalar = scalarOutputType(field.field_type);
-    if (scalar) return field.required ? new GraphQLNonNull2(scalar) : scalar;
+    if (scalar) return required ? new GraphQLNonNull2(scalar) : scalar;
     if (field.field_type === "enum") {
       const ref = field.ui_component.component === "select" ? field.ui_component.enum_ref : void 0;
       const et = ref ? enumTypes.get(ref) : void 0;
       const t = et ?? GraphQLString3;
-      return field.required ? new GraphQLNonNull2(t) : t;
+      return required ? new GraphQLNonNull2(t) : t;
     }
     if (field.field_type === "image" || field.field_type === "video" || field.field_type === "file") {
       return MEDIA;
@@ -391,8 +404,17 @@ function buildGraphQLSchema(registry, fieldKeyMaps = {}) {
     }
     return GraphQLString3;
   }
+  function exposedFields(type) {
+    return type.fields.filter((f) => f.removed !== true);
+  }
+  function viewFieldsFor(machineName, type) {
+    return view?.[machineName]?.fields ?? exposedFields(type).map((f) => ({ field: f, exposedAs: f.name, required: f.required }));
+  }
   function buildObjectType(machineName, type) {
-    const mediaFieldNames = type.fields.filter((f) => f.field_type === "image" || f.field_type === "video" || f.field_type === "file").map((f) => f.name);
+    const visible = viewFieldsFor(machineName, type);
+    const mediaFields = visible.filter(
+      (v) => v.field.field_type === "image" || v.field.field_type === "video" || v.field.field_type === "file"
+    ).map((v) => ({ name: v.field.name, exposedAs: v.exposedAs }));
     return new GraphQLObjectType({
       name: graphqlTypeName(machineName),
       fields: () => {
@@ -406,23 +428,25 @@ function buildGraphQLSchema(registry, fieldKeyMaps = {}) {
         }
         fields["createdAt"] = { type: new GraphQLNonNull2(DateTimeScalar), resolve: (p) => p["created_at"] };
         fields["updatedAt"] = { type: new GraphQLNonNull2(DateTimeScalar), resolve: (p) => p["updated_at"] };
-        for (const field of type.fields) {
-          const gqlName = toCamelCase(field.name);
-          const outType = outputTypeForField(field);
+        for (const vf of visible) {
+          const field = vf.field;
+          const gqlName = toCamelCase(vf.exposedAs);
+          const outType = outputTypeForField(field, vf.required);
           let resolve;
           if (field.field_type === "programmatic") {
-            resolve = programmaticFieldResolver(
-              machineName,
-              field.name,
-              mediaFieldNames,
-              fieldKeyMaps[machineName]
-            );
+            resolve = programmaticFieldResolver(machineName, field.name, mediaFields, fieldKeyMaps[machineName]);
           } else if (field.field_type === "reference" || field.field_type === "paragraph" || field.field_type === "image" || field.field_type === "video" || field.field_type === "file") {
             resolve = relationFieldResolver(machineName, field.name);
           } else {
-            resolve = scalarFieldResolver(field);
+            resolve = scalarFieldResolver(field, vf.fallback);
           }
-          fields[gqlName] = { type: outType, resolve };
+          fields[gqlName] = {
+            type: outType,
+            resolve,
+            // Conditional spread, not `deprecationReason: vf.deprecationReason`
+            // — exactOptionalPropertyTypes forbids present-and-undefined.
+            ...vf.deprecationReason !== void 0 && { deprecationReason: vf.deprecationReason }
+          };
         }
         return fields;
       }
@@ -454,7 +478,8 @@ function buildGraphQLSchema(registry, fieldKeyMaps = {}) {
   const queryFields = {};
   for (const [name, ct] of Object.entries(registry.content_types)) {
     const objType = objectTypes.get(name);
-    const nameMap = buildFieldNameMap(ct.fields.map((f) => f.name));
+    const visible = viewFieldsFor(name, ct);
+    const nameMap = buildFieldNameMap(visible.map((v) => v.exposedAs));
     if (ct.only_one) {
       queryFields[singleQueryName(name)] = { type: objType, resolve: singletonResolver(name) };
       continue;
@@ -466,13 +491,13 @@ function buildGraphQLSchema(registry, fieldKeyMaps = {}) {
         meta: { type: new GraphQLNonNull2(PAGE_META), resolve: (r) => r.meta }
       }
     });
-    const filterType = buildFilterInputType(ct);
+    const filterType = buildFilterInputType(ct, visible);
     queryFields[collectionQueryName(name)] = {
       type: new GraphQLNonNull2(listType),
       args: {
         page: { type: GraphQLInt3 },
         perPage: { type: GraphQLInt3 },
-        sortBy: { type: buildSortFieldEnum(graphqlTypeName(name)) },
+        sortBy: { type: buildSortFieldEnum(graphqlTypeName(name), fieldKeyMaps[name]) },
         sortOrder: { type: SortOrderEnum },
         ...filterType ? { filter: { type: filterType } } : {}
       },
@@ -496,7 +521,11 @@ function buildGraphQLSchema(registry, fieldKeyMaps = {}) {
     queryFields[collectionQueryName(name)] = {
       type: new GraphQLNonNull2(listType),
       args: { page: { type: GraphQLInt3 }, perPage: { type: GraphQLInt3 } },
-      resolve: collectionResolver(name, buildFieldNameMap(tt.fields.map((f) => f.name)), fieldKeyMaps[name])
+      resolve: collectionResolver(
+        name,
+        buildFieldNameMap(viewFieldsFor(name, tt).map((v) => v.exposedAs)),
+        fieldKeyMaps[name]
+      )
     };
     queryFields[singleQueryName(name)] = {
       type: objType,
@@ -509,6 +538,70 @@ function buildGraphQLSchema(registry, fieldKeyMaps = {}) {
   });
 }
 
+// src/graphql/version-view.ts
+function byColumn(fields) {
+  const out = /* @__PURE__ */ new Map();
+  for (const f of fields) {
+    if (!isColumnBacked(f)) continue;
+    out.set(f.db_column.column_name, f);
+  }
+  return out;
+}
+function deprecationFor(field, currentLabels, currentVersion) {
+  const currentLabel = currentLabels.get(field.column_name);
+  if (currentLabel === void 0) {
+    return `Removed in ${currentVersion}; column retained while this version is live.`;
+  }
+  if (currentLabel !== field.exposed_as) {
+    return `Renamed to '${currentLabel}' in ${currentVersion}.`;
+  }
+  return void 0;
+}
+function buildVersionView(input) {
+  const { registry, projection, currentProjection, currentVersion } = input;
+  const out = {};
+  const sources = [
+    registry.content_types,
+    registry.taxonomy_types,
+    registry.paragraph_types
+  ];
+  for (const source of sources) {
+    for (const [typeName, type] of Object.entries(source)) {
+      const projectionType = projection?.types[typeName];
+      if (projectionType === void 0) {
+        out[typeName] = {
+          fields: type.fields.filter((f) => f.removed !== true).map((f) => ({ field: f, exposedAs: f.name, required: f.required }))
+        };
+        continue;
+      }
+      const columns = byColumn(type.fields);
+      const currentLabels = /* @__PURE__ */ new Map();
+      for (const f of currentProjection?.types[typeName]?.fields ?? []) {
+        currentLabels.set(f.column_name, f.exposed_as);
+      }
+      const fields = [];
+      for (const pf of projectionType.fields) {
+        const field = columns.get(pf.column_name);
+        if (field === void 0) continue;
+        const reason = deprecationFor(pf, currentLabels, currentVersion);
+        fields.push({
+          field,
+          exposedAs: pf.exposed_as,
+          required: pf.required,
+          ...pf.fallback !== void 0 && { fallback: pf.fallback },
+          ...reason !== void 0 && { deprecationReason: reason }
+        });
+      }
+      for (const f of type.fields) {
+        if (isColumnBacked(f) || f.removed === true) continue;
+        fields.push({ field: f, exposedAs: f.name, required: f.required });
+      }
+      out[typeName] = { fields };
+    }
+  }
+  return out;
+}
+
 // src/graphql/dataloaders.ts
 import DataLoader from "dataloader";
 function createRelationLoaders(db, registry) {
@@ -584,15 +677,29 @@ function isClientSafeGraphQLError(error) {
   }
   return false;
 }
-function createGraphQLHandler(registry, repos, fieldKeyMaps, resolver, db, options) {
-  const schema = buildGraphQLSchema(registry, fieldKeyMaps);
+function createGraphQLHandler(registry, repos, fieldKeyMaps, resolver, db, options, versioning = {}) {
+  let view;
+  if (versioning.projection !== void 0) {
+    if (versioning.currentVersion === void 0) {
+      throw new Error(
+        'createGraphQLHandler: currentVersion is required when a projection is supplied \u2014 deprecation reasons name it, and an empty one ships "Removed in ." into published SDL.'
+      );
+    }
+    view = buildVersionView({
+      registry,
+      projection: versioning.projection,
+      currentProjection: versioning.currentProjection,
+      currentVersion: versioning.currentVersion
+    });
+  }
+  const schema = buildGraphQLSchema(registry, fieldKeyMaps, view);
   const { plugins } = buildArmorPlugin({
     maxDepth: options.maxDepth,
     maxComplexity: options.maxComplexity
   });
   const yoga = createYoga({
     schema,
-    graphqlEndpoint: "/graphql",
+    graphqlEndpoint: versioning.endpoint ?? "/graphql",
     graphiql: options.graphiql,
     landingPage: false,
     maskedErrors: {
@@ -618,4 +725,4 @@ function createGraphQLHandler(registry, repos, fieldKeyMaps, resolver, db, optio
 export {
   createGraphQLHandler
 };
-//# sourceMappingURL=chunk-HEYT5CH5.mjs.map
+//# sourceMappingURL=chunk-XNXM4W4K.mjs.map