@bobbykim/manguito-cms-cli 0.4.3 → 0.4.4

package/dist/{chunk-OAUBUE7N.js → chunk-UNBMPHIT.js}

@@ -49,7 +49,7 @@ var init_esm_shims = __esm({
   }
 });
 
-// ../api/dist/chunk-TK4DNRFF.mjs
+// ../api/dist/chunk-4F2CRXPG.mjs
 init_esm_shims();
 import crypto from "crypto";
 
@@ -1212,7 +1212,7 @@ Subquery.prototype.getSQL = function() {
   return new SQL([this]);
 };
 
-// ../api/dist/chunk-TK4DNRFF.mjs
+// ../api/dist/chunk-4F2CRXPG.mjs
 function quoteIdent(name) {
   if (!/^[a-z][a-z0-9_-]*$/.test(name)) throw new Error(`Unsafe identifier: ${name}`);
   return `"${name}"`;
@@ -1382,22 +1382,34 @@ function groupBy(items, key) {
   }
   return result;
 }
+function needsFkResolution(row, fkColumn, fieldName) {
+  if (fkColumn !== fieldName && !(fkColumn in row)) return false;
+  const current = row[fieldName];
+  return !(typeof current === "object" && current !== null);
+}
 async function resolveRelationField(db, rows, fieldName, rel, cache, publishedOnly = false) {
   if (rows.length === 0) return;
+  const batch = [...new Set(rows)];
   if (rel.type === "paragraph") {
-    const parentIds = rows.map((r) => r["id"]);
+    const parentIds = batch.map((r) => r["id"]);
     const inList = sql.join(parentIds.map((id) => sql`${id}`), sql`, `);
     const result = await db.execute(
       sql`SELECT * FROM ${sql.raw(quoteIdent(rel.table))} WHERE parent_id IN (${inList}) AND parent_field = ${fieldName} ORDER BY "order" ASC`
     );
     const byParent = groupBy(result.rows, "parent_id");
-    for (const row of rows) {
+    for (const row of batch) {
       row[fieldName] = byParent[row["id"]] ?? [];
     }
   } else if (rel.type === "reference") {
-    const fkValues = rows.map((r) => r[rel.fk_column]).filter(Boolean);
+    const dropFk = rel.fk_column !== fieldName;
+    const pending = batch.filter((r) => needsFkResolution(r, rel.fk_column, fieldName));
+    if (pending.length === 0) return;
+    const fkValues = pending.map((r) => r[rel.fk_column]).filter(Boolean);
     if (fkValues.length === 0) {
-      for (const row of rows) row[fieldName] = null;
+      for (const row of pending) {
+        row[fieldName] = null;
+        if (dropFk) delete row[rel.fk_column];
+      }
       return;
     }
     const unique = [...new Set(fkValues)];
@@ -1412,12 +1424,13 @@ async function resolveRelationField(db, rows, fieldName, rel, cache, publishedOn
         cache.set(`${rel.table}:${item["id"]}`, item);
       }
     }
-    for (const row of rows) {
+    for (const row of pending) {
       const fkVal = row[rel.fk_column];
       row[fieldName] = fkVal ? cache.get(`${rel.table}:${fkVal}`) ?? null : null;
+      if (dropFk) delete row[rel.fk_column];
     }
   } else if (rel.type === "junction") {
-    const parentIds = rows.map((r) => r["id"]);
+    const parentIds = batch.map((r) => r["id"]);
     const inList = sql.join(parentIds.map((id) => sql`${id}`), sql`, `);
     const orderBy = rel.order_column ? sql` ORDER BY "order" ASC` : sql``;
     const junctionResult = await db.execute(
@@ -1437,14 +1450,20 @@ async function resolveRelationField(db, rows, fieldName, rel, cache, publishedOn
       }
     }
     const byLeft = groupBy(jRows, rel.left_column);
-    for (const row of rows) {
+    for (const row of batch) {
       const jEntries = byLeft[row["id"]] ?? [];
       row[fieldName] = jEntries.map((jr) => cache.get(`${rel.table}:${jr[rel.right_column]}`)).filter(Boolean);
     }
   } else if (rel.type === "media") {
-    const fkValues = rows.map((r) => r[rel.fk_column]).filter(Boolean);
+    const dropFk = rel.fk_column !== fieldName;
+    const pending = batch.filter((r) => needsFkResolution(r, rel.fk_column, fieldName));
+    if (pending.length === 0) return;
+    const fkValues = pending.map((r) => r[rel.fk_column]).filter(Boolean);
     if (fkValues.length === 0) {
-      for (const row of rows) row[fieldName] = null;
+      for (const row of pending) {
+        row[fieldName] = null;
+        if (dropFk) delete row[rel.fk_column];
+      }
       return;
     }
     const unique = [...new Set(fkValues)];
@@ -1456,9 +1475,10 @@ async function resolveRelationField(db, rows, fieldName, rel, cache, publishedOn
         cache.set(`media:${item["id"]}`, item);
       }
     }
-    for (const row of rows) {
+    for (const row of pending) {
       const fkVal = row[rel.fk_column];
       row[fieldName] = fkVal ? cache.get(`media:${fkVal}`) ?? null : null;
+      if (dropFk) delete row[rel.fk_column];
     }
   }
 }
@@ -1486,6 +1506,46 @@ async function resolveRelationBareIds(db, rows, fieldName, rel) {
     }
   }
 }
+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();
+  for (const f of fields) {
+    if (!isColumnBacked(f)) continue;
+    labelToColumn.set(f.name, f.db_column.column_name);
+    columnToLabel.set(f.db_column.column_name, f.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.`
+      );
+    }
+  }
+  const diverges = [...labelToColumn].some(([label, column]) => label !== column);
+  function remap(input, lookup) {
+    const out = {};
+    for (const key of Object.keys(input)) {
+      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 {
   __require,
@@ -1523,5 +1583,7 @@ export {
   persistJunctionField,
   buildRelationsMap,
   resolveRelationField,
-  resolveRelationBareIds
+  resolveRelationBareIds,
+  isColumnBacked,
+  createFieldKeyMap
 };

package/dist/{handler-CGHZG3J5-TCG6K3FE.js → handler-TPEULQ5W-5VGZ4FJU.js}

@@ -9,8 +9,9 @@ import {
   __toESM,
   buildRelationsMap,
   init_esm_shims,
+  isColumnBacked,
   resolveRelationField
-} from "./chunk-OAUBUE7N.js";
+} from "./chunk-UNBMPHIT.js";
 
 // ../../node_modules/.pnpm/@whatwg-node+fetch@0.10.13/node_modules/@whatwg-node/fetch/dist/shouldSkipPonyfill.js
 var require_shouldSkipPonyfill = __commonJS({
@@ -10785,10 +10786,10 @@ var require_parser = __commonJS({
   }
 });
 
-// ../api/dist/handler-CGHZG3J5.mjs
+// ../api/dist/handler-TPEULQ5W.mjs
 init_esm_shims();
 
-// ../api/dist/chunk-GM55HGWA.mjs
+// ../api/dist/chunk-B5LWIR4U.mjs
 init_esm_shims();
 
 // ../../node_modules/.pnpm/graphql-yoga@5.21.2_graphql@16.14.2/node_modules/graphql-yoga/esm/index.js
@@ -30121,7 +30122,7 @@ function createYoga(options) {
   });
 }
 
-// ../api/dist/chunk-GM55HGWA.mjs
+// ../api/dist/chunk-B5LWIR4U.mjs
 var import_dataloader = __toESM(require_dataloader(), 1);
 
 // ../../node_modules/.pnpm/@escape.tech+graphql-armor@3.2.0_@envelop+core@5.5.1_@escape.tech+graphql-armor-types@0.7.0/node_modules/@escape.tech/graphql-armor/dist/graphql-armor.esm.js
@@ -30879,7 +30880,7 @@ var EnvelopArmor = class {
   }
 };
 
-// ../api/dist/chunk-GM55HGWA.mjs
+// ../api/dist/chunk-B5LWIR4U.mjs
 var DateTimeScalar = new GraphQLScalarType({
   name: "DateTime",
   description: "ISO-8601 date-time string",
@@ -31041,12 +31042,13 @@ function buildFilterInputType(type) {
   if (Object.keys(fields).length === 0) return null;
   return new GraphQLInputObjectType({ name: `${graphqlTypeName(type.name)}Filter`, fields });
 }
-function translateFilters(input, nameMap) {
+function translateFilters(input, nameMap, columnFor) {
   const out = {};
   if (!input) return out;
   for (const [gqlField, raw] of Object.entries(input)) {
     if (raw === null || typeof raw !== "object") continue;
-    const column = nameMap.toSchema(gqlField);
+    const label = nameMap.toSchema(gqlField);
+    const column = columnFor?.(label) ?? label;
     const spec = raw;
     if (spec["eq"] !== void 0) {
       out[column] = spec["eq"];
@@ -31068,29 +31070,34 @@ function codeError(code, message) {
 function isPublished(item) {
   return !!item && item["published"] === true;
 }
-function scalarFieldResolver(schemaName) {
-  return (parent) => parent[schemaName];
+function resolveFieldValue(field, row) {
+  const key = isColumnBacked(field) ? field.db_column.column_name : field.name;
+  return row[key] ?? null;
+}
+function scalarFieldResolver(field) {
+  return (parent) => resolveFieldValue(field, parent);
 }
 function relationFieldResolver(typeName, schemaFieldName) {
   return (parent, _args, ctx) => ctx.loaders.load(typeName, schemaFieldName, parent);
 }
-function programmaticFieldResolver(typeName, schemaFieldName, mediaFieldNames = []) {
+function programmaticFieldResolver(typeName, schemaFieldName, mediaFieldNames = [], fieldKeys) {
   return async (parent, _args, ctx) => {
     let p = ctx.programmaticMemo.get(parent);
     if (!p) {
-      p = resolveProgrammaticRow(typeName, parent, ctx, mediaFieldNames);
+      p = resolveProgrammaticRow(typeName, parent, ctx, mediaFieldNames, fieldKeys);
       ctx.programmaticMemo.set(parent, p);
     }
     return (await p)[schemaFieldName];
   };
 }
-async function resolveProgrammaticRow(typeName, parent, ctx, mediaFieldNames) {
-  if (mediaFieldNames.length === 0) return ctx.resolver.resolveItem(typeName, parent);
+async function resolveProgrammaticRow(typeName, parent, ctx, mediaFieldNames, fieldKeys) {
+  const toLabels = (row) => fieldKeys ? fieldKeys.toLabels(row) : row;
+  if (mediaFieldNames.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, enriched);
+  return ctx.resolver.resolveItem(typeName, toLabels(enriched));
 }
-function collectionResolver(typeName, nameMap) {
+function collectionResolver(typeName, nameMap, fieldKeys) {
   return async (_root, args, ctx) => {
     const page = args.page ?? 1;
     const perPage = args.perPage ?? 10;
@@ -31107,7 +31114,7 @@ function collectionResolver(typeName, nameMap) {
       per_page: perPage,
       sort_by: args.sortBy ?? "created_at",
       sort_order: args.sortOrder ?? "asc",
-      filters: translateFilters(args.filter, nameMap)
+      filters: translateFilters(args.filter, nameMap, fieldKeys?.columnFor)
     });
     return { data: result.data, meta: result.meta };
   };
@@ -31158,7 +31165,7 @@ var MEDIA = new GraphQLObjectType({
     duration: { type: GraphQLInt, resolve: (m) => m.duration }
   }
 });
-function buildGraphQLSchema(registry) {
+function buildGraphQLSchema(registry, fieldKeyMaps = {}) {
   const objectTypes = /* @__PURE__ */ new Map();
   const enumTypes = /* @__PURE__ */ new Map();
   for (const [name, enumType] of Object.entries(registry.enum_types)) {
@@ -31234,11 +31241,16 @@ function buildGraphQLSchema(registry) {
           const outType = outputTypeForField(field);
           let resolve;
           if (field.field_type === "programmatic") {
-            resolve = programmaticFieldResolver(machineName, field.name, mediaFieldNames);
+            resolve = programmaticFieldResolver(
+              machineName,
+              field.name,
+              mediaFieldNames,
+              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.name);
+            resolve = scalarFieldResolver(field);
           }
           fields[gqlName] = { type: outType, resolve };
         }
@@ -31294,7 +31306,7 @@ function buildGraphQLSchema(registry) {
         sortOrder: { type: SortOrderEnum },
         ...filterType ? { filter: { type: filterType } } : {}
       },
-      resolve: collectionResolver(name, nameMap)
+      resolve: collectionResolver(name, nameMap, fieldKeyMaps[name])
     };
     queryFields[singleQueryName(name)] = {
       type: objType,
@@ -31314,7 +31326,7 @@ function buildGraphQLSchema(registry) {
     queryFields[collectionQueryName(name)] = {
       type: new GraphQLNonNull(listType),
       args: { page: { type: GraphQLInt }, perPage: { type: GraphQLInt } },
-      resolve: collectionResolver(name, buildFieldNameMap(tt.fields.map((f) => f.name)))
+      resolve: collectionResolver(name, buildFieldNameMap(tt.fields.map((f) => f.name)), fieldKeyMaps[name])
     };
     queryFields[singleQueryName(name)] = {
       type: objType,
@@ -31393,8 +31405,8 @@ function isClientSafeGraphQLError(error) {
   }
   return false;
 }
-function createGraphQLHandler(registry, repos, resolver, db, options) {
-  const schema = buildGraphQLSchema(registry);
+function createGraphQLHandler(registry, repos, fieldKeyMaps, resolver, db, options) {
+  const schema = buildGraphQLSchema(registry, fieldKeyMaps);
   const { plugins } = buildArmorPlugin({
     maxDepth: options.maxDepth,
     maxComplexity: options.maxComplexity

package/dist/index.js

@@ -21,6 +21,7 @@ import {
   __require,
   __toESM,
   buildRelationsMap,
+  createFieldKeyMap,
   deleteParagraphField,
   entityKind,
   fillPlaceholders,
@@ -28,6 +29,7 @@ import {
   getTableUniqueName,
   init_esm_shims,
   is,
+  isColumnBacked,
   isDriverValueEncoder,
   isSQLWrapper,
   persistJunctionField,
@@ -36,7 +38,7 @@ import {
   resolveRelationField,
   sql,
   tracer
-} from "./chunk-OAUBUE7N.js";
+} from "./chunk-UNBMPHIT.js";
 
 // ../../node_modules/.pnpm/yaml@2.9.0/node_modules/yaml/dist/nodes/identity.js
 var require_identity = __commonJS({
@@ -46557,6 +46559,23 @@ var sign2 = Jwt.sign;
 import { randomBytes } from "crypto";
 import crypto3 from "crypto";
 import crypto22 from "crypto";
+function normalizePrefix(prefix) {
+  if (prefix === void 0) return "/api";
+  const withSlash = prefix.startsWith("/") ? prefix : `/${prefix}`;
+  const trimmed = withSlash.replace(/\/+$/, "");
+  return trimmed === "" ? "/api" : trimmed;
+}
+function createPublicPaths(prefix) {
+  return {
+    collection: (basePath) => `${prefix}/${basePath}`,
+    item: (basePath) => `${prefix}/${basePath}/:slug`,
+    taxonomyCollection: (typeName) => `${prefix}/taxonomy/${typeName}`,
+    taxonomyItem: (typeName) => `${prefix}/taxonomy/${typeName}/:id`,
+    mediaCollection: () => `${prefix}/media`,
+    mediaItem: () => `${prefix}/media/:id`,
+    openapi: () => `${prefix}/openapi.json`
+  };
+}
 function createCorsMiddleware(corsConfig) {
   const allowList = Array.isArray(corsConfig.origin) ? corsConfig.origin : [corsConfig.origin];
   const wildcard = allowList.includes("*");
@@ -47122,28 +47141,31 @@ function parseInclude(includeParam) {
   if (!includeParam) return [];
   return includeParam.split(",").map((s) => s.trim()).filter(Boolean);
 }
-function parseFilters(url2, validFields) {
+function parseFilters(url2, validFields, columnFor) {
   const { searchParams } = new URL(url2);
   const filters = {};
+  const toKey = (label) => columnFor?.(label) ?? label;
   for (const [key, value] of searchParams.entries()) {
     const simpleMatch = /^filter\[([^\]]+)\]$/.exec(key);
     const opMatch = /^filter\[([^\]]+)\]\[([^\]]+)\]$/.exec(key);
     if (simpleMatch) {
       const field = simpleMatch[1];
       if (!validFields.has(field)) return { ok: false, invalidField: field };
-      const existing = filters[field];
+      const storageKey = toKey(field);
+      const existing = filters[storageKey];
       if (existing !== void 0) {
-        filters[field] = Array.isArray(existing) ? [...existing, value] : [existing, value];
+        filters[storageKey] = Array.isArray(existing) ? [...existing, value] : [existing, value];
       } else {
-        filters[field] = value;
+        filters[storageKey] = value;
       }
     } else if (opMatch) {
       const field = opMatch[1];
       const operator = opMatch[2];
       if (!validFields.has(field)) return { ok: false, invalidField: field };
       if (!["gt", "gte", "lt", "lte"].includes(operator)) continue;
-      const existing = filters[field] ?? {};
-      filters[field] = { ...existing, [operator]: value };
+      const storageKey = toKey(field);
+      const existing = filters[storageKey] ?? {};
+      filters[storageKey] = { ...existing, [operator]: value };
     }
   }
   return { ok: true, filters };
@@ -47151,7 +47173,7 @@ function parseFilters(url2, validFields) {
 function isPublished(item) {
   return item["published"] === true;
 }
-function registerPublicContentRoutes(app, registry2, repos, listRateLimit, resolver) {
+function registerPublicContentRoutes(app, registry2, repos, fieldKeyMaps, paths, listRateLimit, resolver) {
   function registerListRoute(path3, handler) {
     if (listRateLimit) {
       app.get(path3, listRateLimit, handler);
@@ -47159,7 +47181,7 @@ function registerPublicContentRoutes(app, registry2, repos, listRateLimit, resol
       app.get(path3, handler);
     }
   }
-  registerListRoute("/api/content", (c) => {
+  registerListRoute(paths.collection("content"), (c) => {
     const data = Object.values(registry2.content_types).map((ct2) => ({
       name: ct2.name,
       label: ct2.label,
@@ -47167,7 +47189,7 @@ function registerPublicContentRoutes(app, registry2, repos, listRateLimit, resol
     }));
     return c.json({ ok: true, data });
   });
-  registerListRoute("/api/taxonomy", (c) => {
+  registerListRoute(paths.collection("taxonomy"), (c) => {
     const data = Object.values(registry2.taxonomy_types).map((tt2) => ({
       name: tt2.name,
       label: tt2.label
@@ -47186,7 +47208,7 @@ function registerPublicContentRoutes(app, registry2, repos, listRateLimit, resol
       ...contentType.system_fields.map((f) => f.name)
     ]);
     if (contentType.only_one) {
-      app.get(`/api/${basePath}`, async (c) => {
+      app.get(paths.collection(basePath), async (c) => {
         const result = await repo.findMany({ published_only: true, page: 1, per_page: 1 });
         if (result.data.length === 0) {
           return c.json(
@@ -47194,12 +47216,13 @@ function registerPublicContentRoutes(app, registry2, repos, listRateLimit, resol
             404
           );
         }
-        let data = result.data[0];
+        let data = fieldKeyMaps[typeName].toLabels(result.data[0]);
         if (resolver?.hasSchema(typeName)) data = await resolver.resolveItem(typeName, data);
         return c.json({ ok: true, data });
       });
     } else {
-      registerListRoute(`/api/${basePath}`, async (c) => {
+      registerListRoute(paths.collection(basePath), async (c) => {
+        const fieldKeys = fieldKeyMaps[typeName];
         const pagination = parsePagination(c.req.query("page"), c.req.query("per_page"));
         if (!pagination.ok) {
           return c.json(
@@ -47239,7 +47262,7 @@ function registerPublicContentRoutes(app, registry2, repos, listRateLimit, resol
             400
           );
         }
-        const filtersResult = parseFilters(c.req.url, filterableFieldNames);
+        const filtersResult = parseFilters(c.req.url, filterableFieldNames, fieldKeys.columnFor);
         if (!filtersResult.ok) {
           return c.json(
             {
@@ -47276,13 +47299,13 @@ function registerPublicContentRoutes(app, registry2, repos, listRateLimit, resol
           filters: filtersResult.filters,
           include
         });
-        if (resolver?.hasSchema(typeName)) {
-          const resolved = await resolver.resolveList(typeName, result.data);
-          return c.json({ ...result, data: resolved });
-        }
-        return c.json(result);
+        const labeled = result.data.map(
+          (row) => fieldKeys.toLabels(row)
+        );
+        const data = resolver?.hasSchema(typeName) ? await resolver.resolveList(typeName, labeled) : labeled;
+        return c.json({ ...result, data });
       });
-      app.get(`/api/${basePath}/:slug`, async (c) => {
+      app.get(paths.item(basePath), async (c) => {
         const slug = c.req.param("slug");
         const include = parseInclude(c.req.query("include"));
         for (const field of include) {
@@ -47309,7 +47332,7 @@ function registerPublicContentRoutes(app, registry2, repos, listRateLimit, resol
             404
           );
         }
-        let data = item;
+        let data = fieldKeyMaps[typeName].toLabels(item);
         if (resolver?.hasSchema(typeName)) data = await resolver.resolveItem(typeName, data);
         return c.json({ ok: true, data });
       });
@@ -47318,7 +47341,7 @@ function registerPublicContentRoutes(app, registry2, repos, listRateLimit, resol
   for (const [typeName] of Object.entries(registry2.taxonomy_types)) {
     const repo = repos[typeName];
     if (!repo) continue;
-    registerListRoute(`/api/taxonomy/${typeName}`, async (c) => {
+    registerListRoute(paths.taxonomyCollection(typeName), async (c) => {
       const pagination = parsePagination(c.req.query("page"), c.req.query("per_page"));
       if (!pagination.ok) {
         return c.json(
@@ -47337,13 +47360,14 @@ function registerPublicContentRoutes(app, registry2, repos, listRateLimit, resol
         page: pagination.page,
         per_page: pagination.per_page
       });
-      if (resolver?.hasSchema(typeName)) {
-        const resolved = await resolver.resolveList(typeName, result.data);
-        return c.json({ ...result, data: resolved });
-      }
-      return c.json(result);
+      const fieldKeys = fieldKeyMaps[typeName];
+      const labeled = result.data.map(
+        (row) => fieldKeys.toLabels(row)
+      );
+      const data = resolver?.hasSchema(typeName) ? await resolver.resolveList(typeName, labeled) : labeled;
+      return c.json({ ...result, data });
     });
-    app.get(`/api/taxonomy/${typeName}/:id`, async (c) => {
+    app.get(paths.taxonomyItem(typeName), async (c) => {
       const id = c.req.param("id");
       const item = await repo.findOne(id);
       if (!item || !isPublished(item)) {
@@ -47355,7 +47379,7 @@ function registerPublicContentRoutes(app, registry2, repos, listRateLimit, resol
           404
         );
       }
-      let data = item;
+      let data = fieldKeyMaps[typeName].toLabels(item);
       if (resolver?.hasSchema(typeName)) data = await resolver.resolveItem(typeName, data);
       return c.json({ ok: true, data });
     });
@@ -47369,7 +47393,7 @@ function parsePagination2(pageStr, perPageStr) {
   if (!Number.isInteger(per_page) || per_page < 1 || per_page > 100) return { ok: false };
   return { ok: true, page, per_page };
 }
-function registerPublicMediaRoutes(app, mediaRepo, listRateLimit) {
+function registerPublicMediaRoutes(app, mediaRepo, paths, listRateLimit) {
   const mediaListHandler = async (c) => {
     const pagination = parsePagination2(c.req.query("page"), c.req.query("per_page"));
     if (!pagination.ok) {
@@ -47408,11 +47432,11 @@ function registerPublicMediaRoutes(app, mediaRepo, listRateLimit) {
     return c.json(result);
   };
   if (listRateLimit) {
-    app.get("/api/media", listRateLimit, mediaListHandler);
+    app.get(paths.mediaCollection(), listRateLimit, mediaListHandler);
   } else {
-    app.get("/api/media", mediaListHandler);
+    app.get(paths.mediaCollection(), mediaListHandler);
   }
-  app.get("/api/media/:id", async (c) => {
+  app.get(paths.mediaItem(), async (c) => {
     const id = c.req.param("id");
     const item = await mediaRepo.findOne(id);
     if (!item) {
@@ -47431,9 +47455,11 @@ function topLevelMediaDelta(mediaFields, before, after) {
   const added = [];
   const removed = [];
   for (const f of mediaFields) {
-    if (after !== null && !(f.name in after)) continue;
-    const oldId = before ? extractMediaId(before[f.name]) : null;
-    const newId = after ? extractMediaId(after[f.name]) : null;
+    const key = f.db_column?.column_name;
+    if (key === void 0 || key === "") continue;
+    if (after !== null && !(key in after)) continue;
+    const oldId = before ? extractMediaId(before[key]) : null;
+    const newId = after ? extractMediaId(after[key]) : null;
     if (newId === oldId) continue;
     if (oldId) removed.push(oldId);
     if (newId) added.push(newId);
@@ -47491,7 +47517,7 @@ function isEmpty(value) {
 function checkRequiredFields(fields, data) {
   return fields.filter((f) => f.required && isEmpty(data[f.name])).map((f) => ({ field: f.name, message: `${f.label} is required` }));
 }
-function parseListQuery(url2, schemaFieldNames, relationFieldNames) {
+function parseListQuery(url2, schemaFieldNames, relationFieldNames, columnFor) {
   const searchParams = new URL(url2).searchParams;
   const pagination = parsePagination(
     searchParams.get("page") ?? void 0,
@@ -47526,7 +47552,7 @@ function parseListQuery(url2, schemaFieldNames, relationFieldNames) {
       status: 400
     };
   }
-  const filtersResult = parseFilters(url2, schemaFieldNames);
+  const filtersResult = parseFilters(url2, schemaFieldNames, columnFor);
   if (!filtersResult.ok) {
     return {
       ok: false,
@@ -47558,7 +47584,7 @@ function parseListQuery(url2, schemaFieldNames, relationFieldNames) {
     search
   };
 }
-function registerAdminContentRoutes(app, registry2, repos, mediaRepo, requirePermission, db) {
+function registerAdminContentRoutes(app, registry2, repos, fieldKeyMaps, mediaRepo, requirePermission, db) {
   for (const [typeName, contentType] of Object.entries(registry2.content_types)) {
     const basePath = `content/${typeName}`;
     const repo = repos[typeName];
@@ -47570,6 +47596,7 @@ function registerAdminContentRoutes(app, registry2, repos, mediaRepo, requirePer
     const relationFieldNames = new Set(
       contentType.fields.filter((f) => RELATION_FIELD_TYPES.has(f.field_type)).map((f) => f.name)
     );
+    const fieldKeys = fieldKeyMaps[typeName];
     const requiredFields = contentType.fields.filter((f) => f.required);
     const mediaFields = contentType.fields.filter(
       (f) => f.field_type === "image" || f.field_type === "video" || f.field_type === "file"
@@ -47583,7 +47610,7 @@ function registerAdminContentRoutes(app, registry2, repos, mediaRepo, requirePer
       `/admin/api/${basePath}`,
       requirePermission("content:read"),
       async (c) => {
-        const parsed = parseListQuery(c.req.url, schemaFieldNames, relationFieldNames);
+        const parsed = parseListQuery(c.req.url, schemaFieldNames, relationFieldNames, fieldKeys.columnFor);
         if (!parsed.ok) {
           return c.json({ ok: false, error: parsed.response }, parsed.status);
         }
@@ -47603,7 +47630,8 @@ function registerAdminContentRoutes(app, registry2, repos, mediaRepo, requirePer
           findOpts.search = { term: parsed.search, columns: searchableColumns };
         }
         const result = await repo.findMany(findOpts);
-        return c.json(result);
+        const data = result.data.map((row) => fieldKeys.toLabels(row));
+        return c.json({ ...result, data });
       }
     );
     app.get(
@@ -47638,7 +47666,8 @@ function registerAdminContentRoutes(app, registry2, repos, mediaRepo, requirePer
             }
           }
         }
-        return c.json({ ok: true, data: item });
+        const data = fieldKeys.toLabels(item);
+        return c.json({ ok: true, data });
       }
     );
     app.post(
@@ -47705,6 +47734,7 @@ function registerAdminContentRoutes(app, registry2, repos, mediaRepo, requirePer
       }
     );
     const writeNewItem = async (c, body) => {
+      const storageBody = fieldKeys.toStorage(body);
       const fieldErrors = checkRequiredFields(requiredFields, body);
       if (fieldErrors.length > 0) {
         return c.json(
@@ -47728,9 +47758,7 @@ function registerAdminContentRoutes(app, registry2, repos, mediaRepo, requirePer
       const junctionFields = contentType.fields.filter(
         (f) => f.db_column !== null && f.db_column.junction !== void 0
       );
-      const columnFields = contentType.fields.filter(
-        (f) => f.db_column !== null && f.db_column.junction === void 0
-      );
+      const columnBackedFields = contentType.fields.filter(isColumnBacked);
       const columnData = {
         published: body["published"] ?? false
       };
@@ -47739,9 +47767,10 @@ function registerAdminContentRoutes(app, registry2, repos, mediaRepo, requirePer
       } else {
         columnData["slug"] = body["slug"];
       }
-      for (const f of columnFields) {
-        const val = body[f.name];
-        columnData[f.db_column.column_name] = val !== void 0 ? val : null;
+      for (const f of columnBackedFields) {
+        const key = f.db_column.column_name;
+        if (!(key in storageBody)) continue;
+        columnData[key] = storageBody[key];
       }
       if (db) {
         const basePathId = await lookupBasePathId(db, contentType.default_base_path);
@@ -47761,7 +47790,7 @@ function registerAdminContentRoutes(app, registry2, repos, mediaRepo, requirePer
       }
       const item = await repo.create(columnData);
       const itemId = item["id"];
-      const mediaDeltas = [topLevelMediaDelta(mediaFields, null, body)];
+      const mediaDeltas = [topLevelMediaDelta(mediaFields, null, storageBody)];
       if (db) {
         for (const f of paragraphFields) {
           const comp = f.ui_component;
@@ -47778,7 +47807,8 @@ function registerAdminContentRoutes(app, registry2, repos, mediaRepo, requirePer
         }
       }
       await applyMediaReferenceDelta(mergeMediaDeltas(...mediaDeltas), mediaRepo);
-      return c.json({ ok: true, data: item }, 201);
+      const data = fieldKeys.toLabels(item);
+      return c.json({ ok: true, data }, 201);
     };
     app.patch(
       `/admin/api/${basePath}/:id`,
@@ -47838,11 +47868,12 @@ function registerAdminContentRoutes(app, registry2, repos, mediaRepo, requirePer
       }
     );
     const writeExistingItem = async (c, id, existing, body) => {
+      const storageBody = fieldKeys.toStorage(body);
       if (body["published"] === true) {
         const publishDeny = await requirePermission("content:edit")(c, async () => {
         });
         if (publishDeny) return publishDeny;
-        const merged = { ...existing, ...body };
+        const merged = { ...fieldKeys.toLabels(existing), ...body };
         const fieldErrors = checkRequiredFields(requiredFields, merged);
         if (fieldErrors.length > 0) {
           return c.json(
@@ -47862,17 +47893,14 @@ function registerAdminContentRoutes(app, registry2, repos, mediaRepo, requirePer
       const patchJunctionFields = contentType.fields.filter(
         (f) => f.db_column !== null && f.db_column.junction !== void 0
       );
-      const patchColumnFields = contentType.fields.filter(
-        (f) => f.db_column !== null && f.db_column.junction === void 0
-      );
+      const patchColumnBackedFields = contentType.fields.filter(isColumnBacked);
       const patchData = {};
       if (!contentType.only_one && "slug" in body) patchData["slug"] = body["slug"];
       if ("published" in body) patchData["published"] = body["published"];
-      for (const f of patchColumnFields) {
-        if (f.name in body) {
-          const val = body[f.name];
-          patchData[f.db_column.column_name] = val !== void 0 ? val : null;
-        }
+      for (const f of patchColumnBackedFields) {
+        const key = f.db_column.column_name;
+        if (!(key in storageBody)) continue;
+        patchData[key] = storageBody[key];
       }
       const updated = await repo.update(id, patchData);
       if (!updated) {
@@ -47882,7 +47910,7 @@ function registerAdminContentRoutes(app, registry2, repos, mediaRepo, requirePer
         );
       }
       const mediaDeltas = [
-        topLevelMediaDelta(mediaFields, existing, body)
+        topLevelMediaDelta(mediaFields, existing, storageBody)
       ];
       if (db) {
         for (const f of patchParagraphFields) {
@@ -47900,7 +47928,8 @@ function registerAdminContentRoutes(app, registry2, repos, mediaRepo, requirePer
         }
       }
       await applyMediaReferenceDelta(mergeMediaDeltas(...mediaDeltas), mediaRepo);
-      return c.json({ ok: true, data: updated });
+      const data = fieldKeys.toLabels(updated);
+      return c.json({ ok: true, data });
     };
     if (contentType.only_one) {
       app.put(
@@ -47960,6 +47989,7 @@ function registerAdminContentRoutes(app, registry2, repos, mediaRepo, requirePer
     const relationFieldNames = new Set(
       taxonomyType.fields.filter((f) => RELATION_FIELD_TYPES.has(f.field_type)).map((f) => f.name)
     );
+    const fieldKeys = fieldKeyMaps[typeName];
     const requiredFields = taxonomyType.fields.filter((f) => f.required);
     const mediaFields = taxonomyType.fields.filter(
       (f) => f.field_type === "image" || f.field_type === "video" || f.field_type === "file"
@@ -47973,7 +48003,7 @@ function registerAdminContentRoutes(app, registry2, repos, mediaRepo, requirePer
       `/admin/api/taxonomy/${typeName}`,
       requirePermission("content:read"),
       async (c) => {
-        const parsed = parseListQuery(c.req.url, schemaFieldNames, relationFieldNames);
+        const parsed = parseListQuery(c.req.url, schemaFieldNames, relationFieldNames, fieldKeys.columnFor);
         if (!parsed.ok) {
           return c.json({ ok: false, error: parsed.response }, parsed.status);
         }
@@ -47993,7 +48023,8 @@ function registerAdminContentRoutes(app, registry2, repos, mediaRepo, requirePer
           findOpts.search = { term: parsed.search, columns: searchableColumns };
         }
         const result = await repo.findMany(findOpts);
-        return c.json(result);
+        const data = result.data.map((row) => fieldKeys.toLabels(row));
+        return c.json({ ...result, data });
       }
     );
     app.get(
@@ -48008,7 +48039,8 @@ function registerAdminContentRoutes(app, registry2, repos, mediaRepo, requirePer
             404
           );
         }
-        return c.json({ ok: true, data: item });
+        const data = fieldKeys.toLabels(item);
+        return c.json({ ok: true, data });
       }
     );
     app.post(
@@ -48016,6 +48048,7 @@ function registerAdminContentRoutes(app, registry2, repos, mediaRepo, requirePer
       requirePermission("content:create"),
       async (c) => {
         const body = await c.req.json();
+        const storageBody = fieldKeys.toStorage(body);
         const fieldErrors = checkRequiredFields(requiredFields, body);
         if (fieldErrors.length > 0) {
           return c.json(
@@ -48035,20 +48068,19 @@ function registerAdminContentRoutes(app, registry2, repos, mediaRepo, requirePer
           });
           if (publishDeny) return publishDeny;
         }
-        const taxColumnFields = taxonomyType.fields.filter(
-          (f) => f.db_column !== null && f.db_column.junction === void 0
-        );
         const taxParagraphFields = taxonomyType.fields.filter((f) => f.db_column === null);
+        const taxColumnBackedFields = taxonomyType.fields.filter(isColumnBacked);
         const taxColumnData = {
           published: body["published"] ?? false
         };
-        for (const f of taxColumnFields) {
-          const val = body[f.name];
-          taxColumnData[f.db_column.column_name] = val !== void 0 ? val : null;
+        for (const f of taxColumnBackedFields) {
+          const key = f.db_column.column_name;
+          if (!(key in storageBody)) continue;
+          taxColumnData[key] = storageBody[key];
         }
         const item = await repo.create(taxColumnData);
         const taxItemId = item["id"];
-        const mediaDeltas = [topLevelMediaDelta(mediaFields, null, body)];
+        const mediaDeltas = [topLevelMediaDelta(mediaFields, null, storageBody)];
         if (db) {
           for (const f of taxParagraphFields) {
             const comp = f.ui_component;
@@ -48060,7 +48092,8 @@ function registerAdminContentRoutes(app, registry2, repos, mediaRepo, requirePer
           }
         }
         await applyMediaReferenceDelta(mergeMediaDeltas(...mediaDeltas), mediaRepo);
-        return c.json({ ok: true, data: item }, 201);
+        const data = fieldKeys.toLabels(item);
+        return c.json({ ok: true, data }, 201);
       }
     );
     app.patch(
@@ -48069,6 +48102,7 @@ function registerAdminContentRoutes(app, registry2, repos, mediaRepo, requirePer
       async (c) => {
         const id = c.req.param("id");
         const body = await c.req.json();
+        const storageBody = fieldKeys.toStorage(body);
         const existing = await repo.findOne(id);
         if (!existing) {
           return c.json(
@@ -48080,7 +48114,7 @@ function registerAdminContentRoutes(app, registry2, repos, mediaRepo, requirePer
           const publishDeny = await requirePermission("content:edit")(c, async () => {
           });
           if (publishDeny) return publishDeny;
-          const merged = { ...existing, ...body };
+          const merged = { ...fieldKeys.toLabels(existing), ...body };
           const fieldErrors = checkRequiredFields(requiredFields, merged);
           if (fieldErrors.length > 0) {
             return c.json(
@@ -48096,17 +48130,14 @@ function registerAdminContentRoutes(app, registry2, repos, mediaRepo, requirePer
             );
           }
         }
-        const taxPatchColumnFields = taxonomyType.fields.filter(
-          (f) => f.db_column !== null && f.db_column.junction === void 0
-        );
         const taxPatchParagraphFields = taxonomyType.fields.filter((f) => f.db_column === null);
+        const taxPatchColumnBackedFields = taxonomyType.fields.filter(isColumnBacked);
         const taxPatchData = {};
         if ("published" in body) taxPatchData["published"] = body["published"];
-        for (const f of taxPatchColumnFields) {
-          if (f.name in body) {
-            const val = body[f.name];
-            taxPatchData[f.db_column.column_name] = val !== void 0 ? val : null;
-          }
+        for (const f of taxPatchColumnBackedFields) {
+          const key = f.db_column.column_name;
+          if (!(key in storageBody)) continue;
+          taxPatchData[key] = storageBody[key];
         }
         const updated = await repo.update(id, taxPatchData);
         if (!updated) {
@@ -48116,7 +48147,7 @@ function registerAdminContentRoutes(app, registry2, repos, mediaRepo, requirePer
           );
         }
         const mediaDeltas = [
-          topLevelMediaDelta(mediaFields, existing, body)
+          topLevelMediaDelta(mediaFields, existing, storageBody)
         ];
         if (db) {
           for (const f of taxPatchParagraphFields) {
@@ -48129,7 +48160,8 @@ function registerAdminContentRoutes(app, registry2, repos, mediaRepo, requirePer
           }
         }
         await applyMediaReferenceDelta(mergeMediaDeltas(...mediaDeltas), mediaRepo);
-        return c.json({ ok: true, data: updated });
+        const data = fieldKeys.toLabels(updated);
+        return c.json({ ok: true, data });
       }
     );
     app.delete(
@@ -49102,7 +49134,7 @@ function registerUserRoutes(app, db, requirePermission, requireHierarchy) {
 }
 var API_VERSION = (() => {
   try {
-    return "0.3.3";
+    return "0.4.0";
   } catch {
     return "0.0.0";
   }
@@ -49500,7 +49532,8 @@ function createCmsApp(options) {
   if (!options.storage) {
     throw new Error(MISSING_STORAGE_ERROR);
   }
-  const prefix = options.prefix ?? "/api";
+  const prefix = normalizePrefix(options.prefix);
+  const publicPaths = createPublicPaths(prefix);
   const { storage, registry: registry2, db, rateLimit, media, cors } = options;
   const cmsName = options.name ?? "Manguito CMS";
   const maxFileSize = media?.max_file_size;
@@ -49580,23 +49613,27 @@ function createCmsApp(options) {
   registerAuthRoutes(app, db);
   app.use("/admin/api/*", authMiddleware);
   app.use("/admin/api/*", mustChangePasswordCheck);
-  app.get("/api/openapi.json", (c) => {
+  app.get(publicPaths.openapi(), (c) => {
     const paths = {};
     for (const ct2 of Object.values(registry2.content_types)) {
       const base = ct2.default_base_path;
       if (ct2.only_one) {
-        paths[`/api/${base}`] = { get: { summary: `Get ${ct2.label}`, tags: [ct2.label] } };
+        paths[publicPaths.collection(base)] = { get: { summary: `Get ${ct2.label}`, tags: [ct2.label] } };
       } else {
-        paths[`/api/${base}`] = { get: { summary: `List published ${ct2.label}`, tags: [ct2.label] } };
-        paths[`/api/${base}/{slug}`] = { get: { summary: `Get ${ct2.label} by slug`, tags: [ct2.label] } };
+        paths[publicPaths.collection(base)] = { get: { summary: `List published ${ct2.label}`, tags: [ct2.label] } };
+        paths[publicPaths.item(base).replace(":slug", "{slug}")] = {
+          get: { summary: `Get ${ct2.label} by slug`, tags: [ct2.label] }
+        };
       }
     }
     for (const tt2 of Object.values(registry2.taxonomy_types)) {
-      paths[`/api/taxonomy/${tt2.name}`] = { get: { summary: `List published ${tt2.label}`, tags: [tt2.label] } };
-      paths[`/api/taxonomy/${tt2.name}/{id}`] = { get: { summary: `Get ${tt2.label} by id`, tags: [tt2.label] } };
+      paths[publicPaths.taxonomyCollection(tt2.name)] = { get: { summary: `List published ${tt2.label}`, tags: [tt2.label] } };
+      paths[publicPaths.taxonomyItem(tt2.name).replace(":id", "{id}")] = {
+        get: { summary: `Get ${tt2.label} by id`, tags: [tt2.label] }
+      };
     }
-    paths["/api/media"] = { get: { summary: "List media items", tags: ["Media"] } };
-    paths["/api/media/{id}"] = { get: { summary: "Get media item by id", tags: ["Media"] } };
+    paths[publicPaths.mediaCollection()] = { get: { summary: "List media items", tags: ["Media"] } };
+    paths[publicPaths.mediaItem().replace(":id", "{id}")] = { get: { summary: "Get media item by id", tags: ["Media"] } };
     return c.json({
       openapi: "3.0.3",
       info: { title: "Manguito CMS Public API", version: "1.0.0" },
@@ -49611,14 +49648,24 @@ function createCmsApp(options) {
       paths: {}
     })
   );
-  registerPublicContentRoutes(app, registry2, publicRepos, listRateLimit, programmaticResolver);
-  registerPublicMediaRoutes(app, mediaRepo, listRateLimit);
+  const fieldKeyMaps = Object.fromEntries([
+    ...Object.entries(registry2.content_types).map(([typeName, ct2]) => [
+      typeName,
+      createFieldKeyMap(ct2.fields)
+    ]),
+    ...Object.entries(registry2.taxonomy_types).map(([typeName, tt2]) => [
+      typeName,
+      createFieldKeyMap(tt2.fields)
+    ])
+  ]);
+  registerPublicContentRoutes(app, registry2, publicRepos, fieldKeyMaps, publicPaths, listRateLimit, programmaticResolver);
+  registerPublicMediaRoutes(app, mediaRepo, publicPaths, listRateLimit);
   if (options.graphql?.enabled) {
     const gqlOptions = options.graphql;
     let gqlHandler = null;
     let initError = null;
-    const ready = import("./handler-CGHZG3J5-TCG6K3FE.js").then(({ createGraphQLHandler }) => {
-      gqlHandler = createGraphQLHandler(registry2, graphqlRepos, programmaticResolver, db, gqlOptions);
+    const ready = import("./handler-TPEULQ5W-5VGZ4FJU.js").then(({ createGraphQLHandler }) => {
+      gqlHandler = createGraphQLHandler(registry2, graphqlRepos, fieldKeyMaps, programmaticResolver, db, gqlOptions);
     }).catch((err) => {
       initError = err;
       const message = err instanceof Error ? err.message : String(err);
@@ -49658,7 +49705,7 @@ function createCmsApp(options) {
   );
   registerSchemaRoute(app, registry2, db);
   registerUserRoutes(app, db, requirePermission, requireHierarchy);
-  registerAdminContentRoutes(app, registry2, repos, mediaRepo, requirePermission, db);
+  registerAdminContentRoutes(app, registry2, repos, fieldKeyMaps, mediaRepo, requirePermission, db);
   registerAdminMediaRoutes(app, mediaRepo, storage, requirePermission, maxFileSize);
   return { prefix, app };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bobbykim/manguito-cms-cli",
-  "version": "0.4.3",
+  "version": "0.4.4",
   "license": "MIT",
   "author": "Bobby Kim <bobby.sihun.kim@gmail.com>",
   "homepage": "https://github.com/bobbykim89/manguito-cms",
@@ -29,10 +29,10 @@
     "tsup": "^8.5.1",
     "typescript": "^6.0.3",
     "vite": "^8.1.3",
-    "@bobbykim/manguito-cms-admin": "0.4.0",
+    "@bobbykim/manguito-cms-api": "0.4.0",
     "@bobbykim/manguito-cms-core": "0.3.0",
-    "@bobbykim/manguito-cms-db": "0.1.3",
-    "@bobbykim/manguito-cms-api": "0.3.3"
+    "@bobbykim/manguito-cms-admin": "0.4.0",
+    "@bobbykim/manguito-cms-db": "0.1.3"
   },
   "devDependencies": {
     "@types/node": "^25.9.5",