@bobbykim/manguito-cms-cli 0.5.0 → 0.6.0

package/dist/{chunk-LFMOJRYP.js → chunk-STFSR5LP.js}

@@ -49,7 +49,7 @@ var init_esm_shims = __esm({
   }
 });
 
-// ../api/dist/chunk-4Y4G564P.mjs
+// ../api/dist/chunk-D5AO4BTL.mjs
 init_esm_shims();
 import crypto from "crypto";
 
@@ -1212,7 +1212,87 @@ Subquery.prototype.getSQL = function() {
   return new SQL([this]);
 };
 
-// ../api/dist/chunk-4Y4G564P.mjs
+// ../api/dist/chunk-D5AO4BTL.mjs
+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 of allLabels) {
+    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) => f.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) => f.name),
+    dropped
+  );
+}
 function quoteIdent(name) {
   if (!/^[a-z][a-z0-9_-]*$/.test(name)) throw new Error(`Unsafe identifier: ${name}`);
   return `"${name}"`;
@@ -1506,58 +1586,6 @@ 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();
-  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 {
   __require,
@@ -1590,12 +1618,13 @@ export {
   Placeholder,
   fillPlaceholders,
   View,
+  isColumnBacked,
+  createFieldKeyMap,
+  createFieldKeyMapFromProjection,
   persistParagraphField,
   deleteParagraphField,
   persistJunctionField,
   buildRelationsMap,
   resolveRelationField,
-  resolveRelationBareIds,
-  isColumnBacked,
-  createFieldKeyMap
+  resolveRelationBareIds
 };

package/dist/{handler-45O5OX2C-OIEJ52PN.js → handler-X7JDHJAL-JEAY3P6W.js}

@@ -11,7 +11,7 @@ import {
   init_esm_shims,
   isColumnBacked,
   resolveRelationField
-} from "./chunk-LFMOJRYP.js";
+} from "./chunk-STFSR5LP.js";
 
 // ../../node_modules/.pnpm/@whatwg-node+fetch@0.10.13/node_modules/@whatwg-node/fetch/dist/shouldSkipPonyfill.js
 var require_shouldSkipPonyfill = __commonJS({
@@ -10786,10 +10786,10 @@ var require_parser = __commonJS({
   }
 });
 
-// ../api/dist/handler-45O5OX2C.mjs
+// ../api/dist/handler-X7JDHJAL.mjs
 init_esm_shims();
 
-// ../api/dist/chunk-HEYT5CH5.mjs
+// ../api/dist/chunk-ARZXLNZS.mjs
 init_esm_shims();
 
 // ../../node_modules/.pnpm/graphql-yoga@5.21.2_graphql@16.14.2/node_modules/graphql-yoga/esm/index.js
@@ -30122,7 +30122,7 @@ function createYoga(options) {
   });
 }
 
-// ../api/dist/chunk-HEYT5CH5.mjs
+// ../api/dist/chunk-ARZXLNZS.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
@@ -30880,7 +30880,7 @@ var EnvelopArmor = class {
   }
 };
 
-// ../api/dist/chunk-HEYT5CH5.mjs
+// ../api/dist/chunk-ARZXLNZS.mjs
 var DateTimeScalar = new GraphQLScalarType({
   name: "DateTime",
   description: "ISO-8601 date-time string",

package/dist/index.js

@@ -22,6 +22,7 @@ import {
   __toESM,
   buildRelationsMap,
   createFieldKeyMap,
+  createFieldKeyMapFromProjection,
   deleteParagraphField,
   entityKind,
   fillPlaceholders,
@@ -38,7 +39,7 @@ import {
   resolveRelationField,
   sql,
   tracer
-} from "./chunk-LFMOJRYP.js";
+} from "./chunk-STFSR5LP.js";
 
 // ../../node_modules/.pnpm/yaml@2.9.0/node_modules/yaml/dist/nodes/identity.js
 var require_identity = __commonJS({
@@ -14469,7 +14470,7 @@ import { Command } from "commander";
 // src/commands/build.ts
 init_esm_shims();
 import { mkdirSync, statSync as statSync2, existsSync as existsSync3, readdirSync as readdirSync3, writeFileSync } from "fs";
-import { resolve as resolve3, join as join8, dirname } from "path";
+import { resolve as resolve4, join as join9, dirname } from "path";
 import { createRequire } from "module";
 import { build as viteBuild } from "vite";
 import { build as tsupBuild } from "tsup";
@@ -34195,7 +34196,7 @@ var PgSelectQueryBuilderBase = class extends TypedQueryBuilder {
       const baseTableName = this.tableName;
       const tableName = getTableLikeName(table);
       for (const item of extractUsedTable(table)) this.usedTables.add(item);
-      if (typeof tableName === "string" && this.config.joins?.some((join14) => join14.alias === tableName)) {
+      if (typeof tableName === "string" && this.config.joins?.some((join15) => join15.alias === tableName)) {
         throw new Error(`Alias "${tableName}" is already used in this query`);
       }
       if (!this.isPartialSelect) {
@@ -35419,7 +35420,7 @@ var PgUpdateBase = class extends QueryPromise {
   createJoin(joinType) {
     return (table, on) => {
       const tableName = getTableLikeName(table);
-      if (typeof tableName === "string" && this.config.joins.some((join14) => join14.alias === tableName)) {
+      if (typeof tableName === "string" && this.config.joins.some((join15) => join15.alias === tableName)) {
         throw new Error(`Alias "${tableName}" is already used in this query`);
       }
       if (typeof on === "function") {
@@ -35515,10 +35516,10 @@ var PgUpdateBase = class extends QueryPromise {
           const fromFields = this.getTableLikeFields(this.config.from);
           fields[tableName] = fromFields;
         }
-        for (const join14 of this.config.joins) {
-          const tableName2 = getTableLikeName(join14.table);
-          if (typeof tableName2 === "string" && !is(join14.table, SQL)) {
-            const fromFields = this.getTableLikeFields(join14.table);
+        for (const join15 of this.config.joins) {
+          const tableName2 = getTableLikeName(join15.table);
+          if (typeof tableName2 === "string" && !is(join15.table, SQL)) {
+            const fromFields = this.getTableLikeFields(join15.table);
             fields[tableName2] = fromFields;
           }
         }
@@ -43617,6 +43618,7 @@ async function generateServerEntries(options, targetDir) {
 function appSetup() {
   return `import config from '../../manguito.config.js'
 import { schemaRegistry } from './schema-registry.js'
+import { versionModel } from './version-model.js'
 import { programmaticResolvers } from './programmatic-registry.js'
 import { createCmsApp } from '@bobbykim/manguito-cms-api'
 import { createPostgresAdapter } from '@bobbykim/manguito-cms-db'
@@ -43627,6 +43629,7 @@ await dbAdapter.connect()
 const { app } = createCmsApp({
   name: config.name,
   registry: schemaRegistry,
+  versions: versionModel,
   db: dbAdapter.getDb(),
   storage: config.storage,
   prefix: config.api.prefix,
@@ -43820,6 +43823,25 @@ ${entries},
   await writeFile5(join7(targetDir, "programmatic-registry.ts"), body, "utf8");
 }
 
+// src/codegen/version-model.ts
+init_esm_shims();
+import { writeFile as writeFile6 } from "fs/promises";
+import { join as join8 } from "path";
+function reduceVersionModel(model) {
+  return { current: model.current, live: model.live, projections: model.projections };
+}
+async function generateVersionModel(model, targetDir) {
+  const reduced = reduceVersionModel(model);
+  const content = [
+    "// GENERATED by manguito build \u2014 do not edit.",
+    "import type { BakedVersionModel } from '@bobbykim/manguito-cms-api'",
+    "",
+    `export const versionModel: BakedVersionModel = ${JSON.stringify(reduced, null, 2)}`,
+    ""
+  ].join("\n");
+  await writeFile6(join8(targetDir, "version-model.ts"), content, "utf8");
+}
+
 // src/utils/config.ts
 init_esm_shims();
 import { existsSync } from "fs";
@@ -43910,6 +43932,16 @@ function isValidConfig(value) {
   return value !== null && typeof value === "object" && "db" in value && "storage" in value && "server" in value && "api" in value && "admin" in value;
 }
 
+// src/utils/schema-config.ts
+init_esm_shims();
+import { resolve as resolve3 } from "path";
+function resolveSchemaConfig(cwd, config3) {
+  return {
+    base_path: resolve3(cwd, config3.schema.base_path),
+    folders: config3.schema.folders
+  };
+}
+
 // src/utils/env.ts
 init_esm_shims();
 import { existsSync as existsSync2 } from "fs";
@@ -43951,7 +43983,7 @@ async function runBuild(options, deps) {
       }
     }
   }
-  const rolesPath = resolve3(cwd, config3.schema.base_path, "roles.json");
+  const rolesPath = resolve4(cwd, config3.schema.base_path, "roles.json");
   const rolesLoadResult = loadSchemaFile(rolesPath);
   let parsedRoles = null;
   if (!rolesLoadResult.ok) {
@@ -43964,7 +43996,7 @@ async function runBuild(options, deps) {
       parsedRoles = rolesParseResult.value;
     }
   }
-  const routesPath = resolve3(cwd, config3.schema.base_path, "routes.json");
+  const routesPath = resolve4(cwd, config3.schema.base_path, "routes.json");
   const routesLoadResult = loadSchemaFile(routesPath);
   let parsedRoutesDef = null;
   if (!routesLoadResult.ok) {
@@ -43995,13 +44027,26 @@ async function runBuild(options, deps) {
   printSuccess(
     `Schemas parsed (${contentCount} content types, ${paragraphCount} paragraph types, ${taxonomyCount} taxonomy types${enumPart})`
   );
-  const generatedDir = resolve3(cwd, "dist/generated");
+  const generatedDir = resolve4(cwd, "dist/generated");
   mkdirSync(generatedDir, { recursive: true });
-  writeFileSync(join8(generatedDir, "schema.ts"), generateSchemaFile(registry2), "utf8");
+  writeFileSync(join9(generatedDir, "schema.ts"), generateSchemaFile(registry2), "utf8");
   await generateSchemaRegistry(registry2, generatedDir);
   await generateRoutes2(registry2, generatedDir);
-  await generateForms(registry2, join8(generatedDir, "forms"));
-  const programmaticDir = resolve3(cwd, config3.programmatic.dir);
+  await generateForms(registry2, join9(generatedDir, "forms"));
+  const schema = resolveSchemaConfig(cwd, config3);
+  const snapshots = loadVersionSnapshots(schema, registry2);
+  if (!snapshots.ok) {
+    printValidationErrors(snapshots.errors, "Snapshot errors", "manguito build");
+    process.exit(1);
+  }
+  const versionModel = computeVersionModel({ current: registry2, snapshots: snapshots.value });
+  if (!versionModel.ok) {
+    printValidationErrors(versionModel.errors, "Version model errors", "manguito build");
+    process.exit(1);
+  }
+  await generateVersionModel(versionModel.value, generatedDir);
+  printSuccess(`Version model baked (live: ${versionModel.value.live.join(", ")})`);
+  const programmaticDir = resolve4(cwd, config3.programmatic.dir);
   const resolverFiles = existsSync3(programmaticDir) ? walkFiles(programmaticDir).filter((f) => /\.(ts|mjs|js)$/.test(f)) : [];
   await generateProgrammaticRegistry(resolverFiles, generatedDir);
   await generateServerEntries(
@@ -44014,7 +44059,7 @@ async function runBuild(options, deps) {
       root: resolveAdminRoot(cwd),
       base: config3.admin.prefix + "/",
       build: {
-        outDir: resolve3(cwd, "dist/admin"),
+        outDir: resolve4(cwd, "dist/admin"),
         emptyOutDir: true
       },
       define: {
@@ -44034,12 +44079,12 @@ async function runBuild(options, deps) {
   try {
     await tsupBuild({
       entry: {
-        server: resolve3(cwd, "dist/generated/server.ts"),
-        handler: resolve3(cwd, "dist/generated/handler.ts"),
-        vercel: resolve3(cwd, "dist/generated/vercel.ts")
+        server: resolve4(cwd, "dist/generated/server.ts"),
+        handler: resolve4(cwd, "dist/generated/handler.ts"),
+        vercel: resolve4(cwd, "dist/generated/vercel.ts")
       },
       format: ["esm"],
-      outDir: resolve3(cwd, "dist"),
+      outDir: resolve4(cwd, "dist"),
       dts: false,
       silent: true,
       // hono/aws-lambda and hono/vercel are optional peer deps — mark external
@@ -44057,24 +44102,24 @@ async function runBuild(options, deps) {
   process.stdout.write("\nBuild complete \u2192 dist/\n");
 }
 async function needsRebuild(cwd) {
-  const sentinel = resolve3(cwd, "dist/generated/schema.ts");
+  const sentinel = resolve4(cwd, "dist/generated/schema.ts");
   if (!existsSync3(sentinel)) return true;
   const sentinelMtime = statSync2(sentinel).mtimeMs;
-  const schemasDir = resolve3(cwd, "schemas");
+  const schemasDir = resolve4(cwd, "schemas");
   if (!existsSync3(schemasDir)) return false;
   return walkFiles(schemasDir).some(
     (file2) => statSync2(file2).mtimeMs > sentinelMtime
   );
 }
 function resolveAdminRoot(cwd) {
-  const cwdRequire = createRequire(join8(cwd, "package.json"));
+  const cwdRequire = createRequire(join9(cwd, "package.json"));
   const adminPkgJson = cwdRequire.resolve("@bobbykim/manguito-cms-admin/package.json");
   return dirname(adminPkgJson);
 }
 function walkFiles(dir) {
   const files = [];
   for (const entry of readdirSync3(dir, { withFileTypes: true })) {
-    const full = join8(dir, entry.name);
+    const full = join9(dir, entry.name);
     if (entry.isDirectory()) {
       files.push(...walkFiles(full));
     } else {
@@ -44088,8 +44133,8 @@ function walkFiles(dir) {
 init_esm_shims();
 import { createServer as createHttpServer } from "http";
 import { existsSync as existsSync5 } from "fs";
-import { resolve as resolve6, join as join12, dirname as dirname2, extname as extname4 } from "path";
-import { mkdir as mkdir2, writeFile as writeFile8, watch, readFile } from "fs/promises";
+import { resolve as resolve7, join as join13, dirname as dirname2, extname as extname4 } from "path";
+import { mkdir as mkdir2, writeFile as writeFile9, watch, readFile } from "fs/promises";
 import { createRequire as createRequire2 } from "module";
 import { createServer as createViteServer, searchForWorkspaceRoot } from "vite";
 
@@ -47009,15 +47054,20 @@ function normalizePrefix(prefix) {
 }
 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 createVersionedPaths(prefix, version3) {
+  const root = version3 === null ? prefix : `${prefix}/${version3}`;
+  return {
+    collection: (basePath) => `${root}/${basePath}`,
+    item: (basePath) => `${root}/${basePath}/:slug`,
+    taxonomyCollection: (typeName) => `${root}/taxonomy/${typeName}`,
+    taxonomyItem: (typeName) => `${root}/taxonomy/${typeName}/:id`
+  };
+}
 function createCorsMiddleware(corsConfig) {
   const allowList = Array.isArray(corsConfig.origin) ? corsConfig.origin : [corsConfig.origin];
   const wildcard = allowList.includes("*");
@@ -47579,7 +47629,7 @@ function nestedTargets(fields) {
   }
   return out;
 }
-function buildProjectors(registry2, fieldKeyMaps) {
+function buildProjectors(registry2, fieldKeyMaps, fallbacks) {
   const projectors = {};
   const sources = [
     registry2.content_types,
@@ -47590,7 +47640,14 @@ function buildProjectors(registry2, fieldKeyMaps) {
     for (const [typeName, type] of Object.entries(source)) {
       const map2 = fieldKeyMaps[typeName];
       if (!map2) continue;
-      projectors[typeName] = { map: map2, nested: nestedTargets(type.fields) };
+      const typeFallbacks = fallbacks?.[typeName];
+      projectors[typeName] = {
+        map: map2,
+        nested: nestedTargets(type.fields),
+        // Spread rather than assign: with exactOptionalPropertyTypes, an optional
+        // property may be ABSENT but not present-and-undefined.
+        ...typeFallbacks !== void 0 && { fallbacks: typeFallbacks }
+      };
     }
   }
   return projectors;
@@ -47599,6 +47656,11 @@ function projectRow(row, typeName, projectors) {
   const p2 = projectors[typeName];
   if (!p2) return row;
   const out = p2.map.toLabels(row);
+  if (p2.fallbacks !== void 0) {
+    for (const [label, value] of Object.entries(p2.fallbacks)) {
+      if (out[label] === null || out[label] === void 0) out[label] = value;
+    }
+  }
   for (const { label, target } of p2.nested) {
     const v2 = out[label];
     if (v2 === null || v2 === void 0) continue;
@@ -47688,13 +47750,24 @@ function registerPublicContentRoutes(app, registry2, repos, projectors, paths, l
     const basePath = contentType.default_base_path;
     const repo = repos[typeName];
     if (!repo) continue;
-    const relationFieldNames = new Set(
-      contentType.fields.filter((f) => RELATION_FIELD_TYPES.has(f.field_type)).map((f) => f.name)
-    );
+    const fieldKeys = projectors[typeName].map;
+    const relationFieldNames = /* @__PURE__ */ new Set();
+    for (const f of contentType.fields) {
+      if (!RELATION_FIELD_TYPES.has(f.field_type)) continue;
+      if (isColumnBacked(f)) {
+        const label = fieldKeys.labelFor(f.db_column.column_name);
+        if (label !== void 0) relationFieldNames.add(label);
+      } else {
+        relationFieldNames.add(f.name);
+      }
+    }
     const filterableFieldNames = /* @__PURE__ */ new Set([
-      ...contentType.fields.filter((f) => f.field_type !== "programmatic").map((f) => f.name),
+      ...fieldKeys.labels,
       ...contentType.system_fields.map((f) => f.name)
     ]);
+    const sortableFieldNames = new Set(
+      [...SORTABLE_FIELDS].filter((f) => filterableFieldNames.has(f))
+    );
     if (contentType.only_one) {
       app.get(paths.collection(basePath), async (c) => {
         const result = await repo.findMany({ published_only: true, page: 1, per_page: 1 });
@@ -47710,8 +47783,6 @@ function registerPublicContentRoutes(app, registry2, repos, projectors, paths, l
       });
     } else {
       registerListRoute(paths.collection(basePath), async (c) => {
-        const projector = projectors[typeName];
-        const fieldKeys = projector.map;
         const pagination = parsePagination(c.req.query("page"), c.req.query("per_page"));
         if (!pagination.ok) {
           return c.json(
@@ -47726,13 +47797,13 @@ function registerPublicContentRoutes(app, registry2, repos, projectors, paths, l
           );
         }
         const sortBy = c.req.query("sort_by") ?? "created_at";
-        if (!SORTABLE_FIELDS.has(sortBy)) {
+        if (!sortableFieldNames.has(sortBy)) {
           return c.json(
             {
               ok: false,
               error: {
                 code: "INVALID_SORT_FIELD",
-                message: `'${sortBy}' is not sortable. Allowed: title, created_at, updated_at`
+                message: `'${sortBy}' is not sortable. Allowed: ${[...sortableFieldNames].join(", ")}`
               }
             },
             400
@@ -47779,7 +47850,7 @@ function registerPublicContentRoutes(app, registry2, repos, projectors, paths, l
             );
           }
         }
-        const sortColumn = fieldKeys.columnFor(sortBy) ?? sortBy;
+        const sortColumn = fieldKeys.labels.includes(sortBy) ? fieldKeys.columnFor(sortBy) : sortBy;
         const result = await repo.findMany({
           published_only: true,
           page: pagination.page,
@@ -49631,7 +49702,7 @@ function registerUserRoutes(app, db, requirePermission, requireHierarchy) {
 }
 var API_VERSION = (() => {
   try {
-    return "0.4.3";
+    return "0.5.0";
   } catch {
     return "0.0.0";
   }
@@ -50020,6 +50091,90 @@ function createMediaRepository(db) {
     }
   };
 }
+var VERSION_SEGMENT = /^v\d+$/;
+function versionNumber2(version3) {
+  return Number.parseInt(version3.slice(1), 10);
+}
+function classifyVersion(segment, model) {
+  if (!VERSION_SEGMENT.test(segment)) return "not-a-version";
+  if (model.live.includes(segment)) return "live";
+  return versionNumber2(segment) < versionNumber2(model.current) ? "retired" : "unknown";
+}
+function fallbacksFor(projection) {
+  const out = {};
+  for (const [typeName, type] of Object.entries(projection.types)) {
+    const perLabel = {};
+    for (const f of type.fields) {
+      if (f.fallback !== void 0) perLabel[f.exposed_as] = f.fallback;
+    }
+    if (Object.keys(perLabel).length > 0) out[typeName] = perLabel;
+  }
+  return out;
+}
+function buildVersionSurface(input2) {
+  const { version: version3, projectionVersion, prefix, registry: registry2, model, makeRepo } = input2;
+  const paths = createVersionedPaths(prefix, version3);
+  const projection = model.projections[projectionVersion];
+  const fieldKeyMaps = {};
+  const sources = [
+    registry2.content_types,
+    registry2.taxonomy_types,
+    registry2.paragraph_types
+  ];
+  for (const source of sources) {
+    for (const [typeName, type] of Object.entries(source)) {
+      const projectionType = projection?.types[typeName];
+      fieldKeyMaps[typeName] = projectionType ? createFieldKeyMapFromProjection(projectionType, type.fields) : createFieldKeyMap(type.fields);
+    }
+  }
+  const fallbacks = projection ? fallbacksFor(projection) : void 0;
+  const projectors = buildProjectors(registry2, fieldKeyMaps, fallbacks);
+  const sortableColumnsFor = (typeName) => {
+    const map2 = fieldKeyMaps[typeName];
+    const type = registry2.content_types[typeName] ?? registry2.taxonomy_types[typeName];
+    const systemFieldNames = new Set((type?.system_fields ?? []).map((f) => f.name));
+    const out = /* @__PURE__ */ new Set();
+    for (const label of SORTABLE_FIELDS) {
+      const column = map2.columnFor(label);
+      if (column !== void 0) out.add(column);
+      else if (systemFieldNames.has(label)) out.add(label);
+    }
+    return out;
+  };
+  const repos = {};
+  for (const [typeName, ct2] of Object.entries(registry2.content_types)) {
+    repos[typeName] = makeRepo(typeName, ct2.db.table_name, sortableColumnsFor(typeName));
+  }
+  for (const [typeName, tt2] of Object.entries(registry2.taxonomy_types)) {
+    repos[typeName] = makeRepo(typeName, tt2.db.table_name, sortableColumnsFor(typeName));
+  }
+  return { paths, fieldKeyMaps, projectors, repos };
+}
+function deprecationHeaders(input2) {
+  const { requested, model, successor } = input2;
+  const link = `<${successor}>; rel="successor-version"`;
+  if (requested === null) {
+    if (model.live.length <= 1) return null;
+    return {
+      Deprecation: "true",
+      Link: link,
+      Warning: `299 - "Unversioned path resolves to the latest version (${model.current}) and will change when a new version is cut. Pin a version."`
+    };
+  }
+  if (requested === model.current) return null;
+  return { Deprecation: "true", Link: link };
+}
+function versionRoutePaths(registry2, paths) {
+  const out = [paths.collection("content"), paths.collection("taxonomy")];
+  for (const ct2 of Object.values(registry2.content_types)) {
+    out.push(paths.collection(ct2.default_base_path));
+    if (!ct2.only_one) out.push(paths.item(ct2.default_base_path));
+  }
+  for (const tt2 of Object.values(registry2.taxonomy_types)) {
+    out.push(paths.taxonomyCollection(tt2.name), paths.taxonomyItem(tt2.name));
+  }
+  return out;
+}
 var MISSING_STORAGE_ERROR = `\u2717 api.storage is required but not configured.
   Add a storage adapter to your manguito.config.ts:
 
@@ -50035,6 +50190,7 @@ function createCmsApp(options) {
   }
   const prefix = normalizePrefix(options.prefix);
   const publicPaths = createPublicPaths(prefix);
+  const versionedPaths = createVersionedPaths(prefix, null);
   const { storage, registry: registry2, db, rateLimit, media, cors } = options;
   const cmsName = options.name ?? "Manguito CMS";
   const maxFileSize = media?.max_file_size;
@@ -50083,9 +50239,18 @@ function createCmsApp(options) {
     ])
   ]);
   const projectors = buildProjectors(registry2, fieldKeyMaps);
-  const sortableColumnsFor = (typeName) => new Set(
-    [...SORTABLE_FIELDS].map((label) => fieldKeyMaps[typeName].columnFor(label) ?? label)
-  );
+  const sortableColumnsFor = (typeName) => {
+    const map2 = fieldKeyMaps[typeName];
+    const type = registry2.content_types[typeName] ?? registry2.taxonomy_types[typeName];
+    const systemFieldNames = new Set((type?.system_fields ?? []).map((f) => f.name));
+    const out = /* @__PURE__ */ new Set();
+    for (const label of SORTABLE_FIELDS) {
+      const column = map2.columnFor(label);
+      if (column !== void 0) out.add(column);
+      else if (systemFieldNames.has(label)) out.add(label);
+    }
+    return out;
+  };
   const contentRepos = Object.fromEntries(
     Object.entries(registry2.content_types).map(([typeName, ct2]) => [
       typeName,
@@ -50104,27 +50269,14 @@ function createCmsApp(options) {
   );
   const repos = { ...contentRepos, ...taxonomyRepos };
   const mediaRepo = createMediaRepository(db);
-  const publicContentRepos = Object.fromEntries(
-    Object.entries(registry2.content_types).map(([typeName, ct2]) => [
-      typeName,
-      createDrizzleContentRepository(db, ct2.db.table_name, {
-        relations: buildRelationsMap(ct2.fields, registry2),
-        publishedRelations: true,
-        sortableColumns: sortableColumnsFor(typeName)
-      })
-    ])
-  );
-  const publicTaxonomyRepos = Object.fromEntries(
-    Object.entries(registry2.taxonomy_types).map(([typeName, tt2]) => [
-      typeName,
-      createDrizzleContentRepository(db, tt2.db.table_name, {
-        relations: buildRelationsMap(tt2.fields, registry2),
-        publishedRelations: true,
-        sortableColumns: sortableColumnsFor(typeName)
-      })
-    ])
-  );
-  const publicRepos = { ...publicContentRepos, ...publicTaxonomyRepos };
+  const makeRepo = (typeName, tableName, sortableColumns) => {
+    const type = registry2.content_types[typeName] ?? registry2.taxonomy_types[typeName];
+    return createDrizzleContentRepository(db, tableName, {
+      relations: buildRelationsMap(type.fields, registry2),
+      publishedRelations: true,
+      sortableColumns
+    });
+  };
   const graphqlRepos = Object.fromEntries([
     ...Object.entries(registry2.content_types).map(([typeName, ct2]) => [
       typeName,
@@ -50147,17 +50299,17 @@ function createCmsApp(options) {
     for (const ct2 of Object.values(registry2.content_types)) {
       const base = ct2.default_base_path;
       if (ct2.only_one) {
-        paths[publicPaths.collection(base)] = { get: { summary: `Get ${ct2.label}`, tags: [ct2.label] } };
+        paths[versionedPaths.collection(base)] = { get: { summary: `Get ${ct2.label}`, tags: [ct2.label] } };
       } else {
-        paths[publicPaths.collection(base)] = { get: { summary: `List published ${ct2.label}`, tags: [ct2.label] } };
-        paths[publicPaths.item(base).replace(":slug", "{slug}")] = {
+        paths[versionedPaths.collection(base)] = { get: { summary: `List published ${ct2.label}`, tags: [ct2.label] } };
+        paths[versionedPaths.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[publicPaths.taxonomyCollection(tt2.name)] = { get: { summary: `List published ${tt2.label}`, tags: [tt2.label] } };
-      paths[publicPaths.taxonomyItem(tt2.name).replace(":id", "{id}")] = {
+      paths[versionedPaths.taxonomyCollection(tt2.name)] = { get: { summary: `List published ${tt2.label}`, tags: [tt2.label] } };
+      paths[versionedPaths.taxonomyItem(tt2.name).replace(":id", "{id}")] = {
         get: { summary: `Get ${tt2.label} by id`, tags: [tt2.label] }
       };
     }
@@ -50177,13 +50329,68 @@ function createCmsApp(options) {
       paths: {}
     })
   );
-  registerPublicContentRoutes(app, registry2, publicRepos, projectors, publicPaths, listRateLimit, programmaticResolver);
+  const model = options.versions ?? {
+    current: "v1",
+    live: ["v1"],
+    projections: {}
+  };
+  const passes = [
+    ...options.versions !== void 0 ? model.live.map((v2) => ({ version: v2, projectionVersion: v2 })) : [],
+    { version: null, projectionVersion: model.current }
+  ];
+  for (const pass of passes) {
+    const surface = buildVersionSurface({ ...pass, prefix, registry: registry2, model, makeRepo });
+    const headers = deprecationHeaders({
+      requested: pass.version,
+      model,
+      // The version root, with no trailing slash — never
+      // createVersionedPaths(prefix, model.current).collection(''), which
+      // would yield `${prefix}/${model.current}/` in every Link header.
+      successor: `${prefix}/${model.current}`
+    });
+    if (headers !== null) {
+      const attachDeprecationHeaders = async (c, next) => {
+        await next();
+        for (const [key, value] of Object.entries(headers)) c.res.headers.set(key, value);
+      };
+      for (const path7 of versionRoutePaths(registry2, surface.paths)) {
+        app.use(path7, attachDeprecationHeaders);
+      }
+    }
+    registerPublicContentRoutes(app, registry2, surface.repos, surface.projectors, surface.paths, listRateLimit, programmaticResolver);
+  }
+  if (options.versions !== void 0) {
+    app.all(`${prefix}/:version/*`, async (c, next) => {
+      const kind = classifyVersion(c.req.param("version"), model);
+      if (kind === "not-a-version" || kind === "live") return next();
+      const live = model.live.join(", ");
+      return kind === "retired" ? c.json(
+        {
+          ok: false,
+          error: {
+            code: "VERSION_RETIRED",
+            message: `Version ${c.req.param("version")} is no longer served. Live versions: ${live}.`
+          }
+        },
+        410
+      ) : c.json(
+        {
+          ok: false,
+          error: {
+            code: "VERSION_NOT_FOUND",
+            message: `No version ${c.req.param("version")} is served. Live versions: ${live}.`
+          }
+        },
+        404
+      );
+    });
+  }
   registerPublicMediaRoutes(app, mediaRepo, publicPaths, listRateLimit);
   if (options.graphql?.enabled) {
     const gqlOptions = options.graphql;
     let gqlHandler = null;
     let initError = null;
-    const ready = import("./handler-45O5OX2C-OIEJ52PN.js").then(({ createGraphQLHandler }) => {
+    const ready = import("./handler-X7JDHJAL-JEAY3P6W.js").then(({ createGraphQLHandler }) => {
       gqlHandler = createGraphQLHandler(registry2, graphqlRepos, fieldKeyMaps, programmaticResolver, db, gqlOptions);
     }).catch((err) => {
       initError = err;
@@ -50231,12 +50438,12 @@ function createCmsApp(options) {
 
 // src/codegen/drizzle-config.ts
 init_esm_shims();
-import { writeFile as writeFile6 } from "fs/promises";
-import { join as join9, relative as relative2, resolve as resolve4 } from "path";
+import { writeFile as writeFile7 } from "fs/promises";
+import { join as join10, relative as relative2, resolve as resolve5 } from "path";
 async function generateDrizzleConfig(config3, targetDir) {
   const migrationsFolder = config3.migrations?.folder ?? "./migrations";
   const migrationsTable = config3.migrations?.table ?? "__manguito_migrations";
-  const outPath = relative2(resolve4(targetDir), resolve4(migrationsFolder)).replace(/\\/g, "/");
+  const outPath = relative2(resolve5(targetDir), resolve5(migrationsFolder)).replace(/\\/g, "/");
   const content = [
     `import { defineConfig } from 'drizzle-kit'`,
     ``,
@@ -50254,13 +50461,13 @@ async function generateDrizzleConfig(config3, targetDir) {
     `  tablesFilter: ['!${migrationsTable}'],`,
     `})`
   ].join("\n");
-  await writeFile6(join9(targetDir, "drizzle.config.ts"), content, "utf8");
+  await writeFile7(join10(targetDir, "drizzle.config.ts"), content, "utf8");
 }
 
 // src/codegen/nav.ts
 init_esm_shims();
-import { writeFile as writeFile7 } from "fs/promises";
-import { join as join10 } from "path";
+import { writeFile as writeFile8 } from "fs/promises";
+import { join as join11 } from "path";
 function schemaBasePath(name) {
   const segment = name.includes("--") ? name.slice(name.indexOf("--") + 2) : name;
   return segment.replace(/_/g, "-");
@@ -50278,7 +50485,7 @@ async function generateNav(registry2, targetDir) {
   })).sort((a2, b2) => a2.label.localeCompare(b2.label));
   const content = `export const nav = ${JSON.stringify({ contentTypes, taxonomyTypes }, null, 2)}
 `;
-  await writeFile7(join10(targetDir, "nav.ts"), content, "utf8");
+  await writeFile8(join11(targetDir, "nav.ts"), content, "utf8");
 }
 
 // src/commands/dev-routing.ts
@@ -50323,7 +50530,7 @@ function createPromptAdapter() {
 init_esm_shims();
 import { existsSync as existsSync4 } from "fs";
 import { readdir } from "fs/promises";
-import { resolve as resolve5, join as join11, extname as extname3 } from "path";
+import { resolve as resolve6, join as join12, extname as extname3 } from "path";
 import { pathToFileURL as pathToFileURL2 } from "url";
 var RESOLVER_EXTENSIONS = /* @__PURE__ */ new Set([".ts", ".mjs", ".js"]);
 function isProgrammaticFieldDefinition(v2) {
@@ -50332,7 +50539,7 @@ function isProgrammaticFieldDefinition(v2) {
 async function walkTsFiles(dir) {
   const out = [];
   for (const entry of await readdir(dir, { withFileTypes: true })) {
-    const full = join11(dir, entry.name);
+    const full = join12(dir, entry.name);
     if (entry.isDirectory()) {
       out.push(...await walkTsFiles(full));
     } else if (RESOLVER_EXTENSIONS.has(extname3(entry.name))) {
@@ -50342,7 +50549,7 @@ async function walkTsFiles(dir) {
   return out;
 }
 async function loadProgrammaticResolvers(cwd, dir) {
-  const abs = resolve5(cwd, dir);
+  const abs = resolve6(cwd, dir);
   const map2 = /* @__PURE__ */ new Map();
   if (!existsSync4(abs)) return map2;
   for (const file2 of (await walkTsFiles(abs)).sort()) {
@@ -50389,13 +50596,13 @@ async function runDev(options, deps) {
   printSuccess("Config loaded");
   const db = await connectDb(config3);
   printSuccess("Database connected");
-  const manguitoDir = resolve6(cwd, ".manguito");
+  const manguitoDir = resolve7(cwd, ".manguito");
   await mkdir2(manguitoDir, { recursive: true });
-  const drizzleConfigPath = resolve6(manguitoDir, "drizzle.config.ts");
+  const drizzleConfigPath = resolve7(manguitoDir, "drizzle.config.ts");
   const needsSeed = !await db.tableExists("users");
   const bootstrapRegistry = await parseAllSchemas(cwd, config3);
   await generateDrizzleConfig(config3, manguitoDir);
-  await writeFile8(join12(manguitoDir, "schema.ts"), generateSchemaFile(bootstrapRegistry), "utf8");
+  await writeFile9(join13(manguitoDir, "schema.ts"), generateSchemaFile(bootstrapRegistry), "utf8");
   await runDevMigration(drizzleConfigPath);
   printSuccess(needsSeed ? "Schema tables created" : "Schema tables up to date");
   if (needsSeed) {
@@ -50441,8 +50648,20 @@ async function runDev(options, deps) {
   );
   await generateSchemaRegistry(registry2, manguitoDir);
   await generateRoutes2(registry2, manguitoDir);
-  await generateForms(registry2, join12(manguitoDir, "forms"));
+  await generateForms(registry2, join13(manguitoDir, "forms"));
   await generateNav(registry2, manguitoDir);
+  const schemaConfig = resolveSchemaConfig(cwd, config3);
+  const snapshotsResult = loadVersionSnapshots(schemaConfig, registry2);
+  if (!snapshotsResult.ok) {
+    printValidationErrors(snapshotsResult.errors, "Version snapshot errors", "manguito version:diff");
+    process.exit(1);
+  }
+  const versionModelResult = computeVersionModel({ current: registry2, snapshots: snapshotsResult.value });
+  if (!versionModelResult.ok) {
+    printValidationErrors(versionModelResult.errors, "Version model errors", "manguito version:diff");
+    process.exit(1);
+  }
+  const versionModel = reduceVersionModel(versionModelResult.value);
   const resolverMap = await loadProgrammaticResolvers(cwd, config3.programmatic.dir);
   const adapter = createCmsApp({
     name: config3.name,
@@ -50450,6 +50669,7 @@ async function runDev(options, deps) {
     db: db.getDb(),
     storage: config3.storage,
     resolvers: resolverMap,
+    versions: versionModel,
     ...config3.api.prefix ? { prefix: config3.api.prefix } : {},
     ...config3.api.media?.max_file_size ? { media: { max_file_size: config3.api.media.max_file_size } } : {},
     ...config3.api.rateLimit ? { rateLimit: config3.api.rateLimit } : {},
@@ -50482,8 +50702,8 @@ async function runDev(options, deps) {
       }
       if (url2.startsWith("/uploads/")) {
         const relativePath = (url2.slice("/uploads/".length).split("?")[0] ?? "").replace(/\.\./g, "");
-        const uploadsDir = resolve6(cwd, "uploads");
-        const filePath = resolve6(uploadsDir, relativePath);
+        const uploadsDir = resolve7(cwd, "uploads");
+        const filePath = resolve7(uploadsDir, relativePath);
         if (!filePath.startsWith(uploadsDir + "/") && filePath !== uploadsDir) {
           res.statusCode = 403;
           res.end("Forbidden");
@@ -50524,7 +50744,7 @@ async function runDev(options, deps) {
     printSuccess(`Dev server running at http://localhost:${port}`);
     printSuccess(`Admin panel at http://localhost:${port}${config3.admin.prefix}`);
   });
-  const schemasDir = resolve6(cwd, config3.schema.base_path);
+  const schemasDir = resolve7(cwd, config3.schema.base_path);
   const watcher = watch(schemasDir, { recursive: true });
   void (async () => {
     for await (const event of watcher) {
@@ -50543,7 +50763,7 @@ async function runDev(options, deps) {
       }
     }
   })();
-  const programmaticDir = resolve6(cwd, config3.programmatic.dir);
+  const programmaticDir = resolve7(cwd, config3.programmatic.dir);
   if (existsSync5(programmaticDir)) {
     const progWatcher = watch(programmaticDir, { recursive: true });
     void (async () => {
@@ -50575,11 +50795,25 @@ async function onSchemaFileChange(args) {
     return;
   }
   await generateDrizzleConfig(config3, manguitoDir);
-  await writeFile8(join12(manguitoDir, "schema.ts"), generateSchemaFile(registry2), "utf8");
+  await writeFile9(join13(manguitoDir, "schema.ts"), generateSchemaFile(registry2), "utf8");
   await generateSchemaRegistry(registry2, manguitoDir);
   await generateRoutes2(registry2, manguitoDir);
-  await generateForms(registry2, join12(manguitoDir, "forms"));
+  await generateForms(registry2, join13(manguitoDir, "forms"));
   await generateNav(registry2, manguitoDir);
+  const schemaConfig = resolveSchemaConfig(cwd, config3);
+  const snapshotsResult = loadVersionSnapshots(schemaConfig, registry2);
+  if (!snapshotsResult.ok) {
+    printValidationErrors(snapshotsResult.errors, "Version snapshot errors", "manguito version:diff");
+    process.stderr.write("\u26A0 Changes not applied.\n");
+    return;
+  }
+  const versionModelResult = computeVersionModel({ current: registry2, snapshots: snapshotsResult.value });
+  if (!versionModelResult.ok) {
+    printValidationErrors(versionModelResult.errors, "Version model errors", "manguito version:diff");
+    process.stderr.write("\u26A0 Changes not applied.\n");
+    return;
+  }
+  const versionModel = reduceVersionModel(versionModelResult.value);
   try {
     await runDevMigration(drizzleConfigPath);
   } catch (err) {
@@ -50594,6 +50828,7 @@ async function onSchemaFileChange(args) {
     db: db.getDb(),
     storage: config3.storage,
     resolvers: resolverMap,
+    versions: versionModel,
     ...config3.api.prefix ? { prefix: config3.api.prefix } : {},
     ...config3.api.media?.max_file_size ? { media: { max_file_size: config3.api.media.max_file_size } } : {},
     ...config3.api.rateLimit ? { rateLimit: config3.api.rateLimit } : {},
@@ -50618,7 +50853,7 @@ async function parseAllSchemas(cwd, config3) {
     }
     parsedSchemas.push(parseResult.schema);
   }
-  const rolesPath = resolve6(cwd, config3.schema.base_path, "roles.json");
+  const rolesPath = resolve7(cwd, config3.schema.base_path, "roles.json");
   const rolesLoad = loadSchemaFile(rolesPath);
   if (!rolesLoad.ok) {
     printGuidedError("Could not read roles.json.");
@@ -50629,7 +50864,7 @@ async function parseAllSchemas(cwd, config3) {
     printGuidedError("roles.json parse errors \u2014 run `manguito validate` for details.");
     process.exit(1);
   }
-  const routesPath = resolve6(cwd, config3.schema.base_path, "routes.json");
+  const routesPath = resolve7(cwd, config3.schema.base_path, "routes.json");
   const routesLoad = loadSchemaFile(routesPath);
   if (!routesLoad.ok) {
     printGuidedError("Could not read routes.json.");
@@ -50643,7 +50878,7 @@ async function parseAllSchemas(cwd, config3) {
   return buildSchemaRegistry(parsedSchemas, routesResult.value, rolesResult.value);
 }
 function resolveAdminRoot2(cwd) {
-  const cwdRequire = createRequire2(join12(cwd, "package.json"));
+  const cwdRequire = createRequire2(join13(cwd, "package.json"));
   const adminPkgJson = cwdRequire.resolve("@bobbykim/manguito-cms-admin/package.json");
   return dirname2(adminPkgJson);
 }
@@ -50689,7 +50924,7 @@ async function bridgeToHono(req, res, honoFetch) {
 
 // src/commands/start.ts
 init_esm_shims();
-import { resolve as resolve7 } from "path";
+import { resolve as resolve8 } from "path";
 import { pathToFileURL as pathToFileURL3 } from "url";
 function registerStart(program2) {
   program2.command("start").description("Start the production server from dist/").option("--env <path>", "path to .env file to load").action(async (options) => {
@@ -50702,7 +50937,7 @@ async function runStart(options, deps) {
   const config3 = await resolveConfig(cwd);
   const db = await connectDb(config3);
   const migrationsTable = config3.migrations?.table ?? "__manguito_migrations";
-  const migrationsFolder = config3.migrations?.folder ? resolve7(cwd, config3.migrations.folder) : resolve7(cwd, "./migrations");
+  const migrationsFolder = config3.migrations?.folder ? resolve8(cwd, config3.migrations.folder) : resolve8(cwd, "./migrations");
   const trackingTableExists = await db.tableExists(migrationsTable);
   if (!trackingTableExists) {
     printGuidedError(
@@ -50737,7 +50972,7 @@ async function runStart(options, deps) {
   } else {
     allErrors.push(...walkResult.errors);
   }
-  const rolesPath = resolve7(cwd, config3.schema.base_path, "roles.json");
+  const rolesPath = resolve8(cwd, config3.schema.base_path, "roles.json");
   const rolesLoad = loadSchemaFile(rolesPath);
   let parsedRoles = null;
   if (rolesLoad.ok) {
@@ -50750,7 +50985,7 @@ async function runStart(options, deps) {
   } else {
     allErrors.push(...rolesLoad.errors);
   }
-  const routesPath = resolve7(cwd, config3.schema.base_path, "routes.json");
+  const routesPath = resolve8(cwd, config3.schema.base_path, "routes.json");
   const routesLoad = loadSchemaFile(routesPath);
   let parsedRoutes = null;
   if (routesLoad.ok) {
@@ -50772,7 +51007,7 @@ async function runStart(options, deps) {
   }
   const registry2 = buildSchemaRegistry(parsedSchemas, parsedRoutes, parsedRoles);
   await seedSystemTables(db.getDb(), registry2);
-  const serverUrl = pathToFileURL3(resolve7(cwd, "dist/server.js")).href;
+  const serverUrl = pathToFileURL3(resolve8(cwd, "dist/server.js")).href;
   await (deps.loadServer ? deps.loadServer(serverUrl) : import(serverUrl));
   const port = Number(process.env["PORT"] ?? 3e3);
   printSuccess(`Server running at http://localhost:${port}`);
@@ -50781,7 +51016,7 @@ async function runStart(options, deps) {
 
 // src/commands/migrate.ts
 init_esm_shims();
-import { resolve as resolve8, join as join13 } from "path";
+import { resolve as resolve9, join as join14 } from "path";
 import { readFile as readFile2 } from "fs/promises";
 function registerMigrate(program2) {
   program2.command("migrate").description("Apply pending database migrations").option("--env <path>", "path to .env file to load").option("--status", "show migration state without applying").option("--dry-run", "preview migrations without writing").option("--force", "skip destructive-change confirmation prompt").action(async (options) => {
@@ -50799,8 +51034,8 @@ function buildDeps(options, cwd) {
     buildRunner: async () => runBuild(options.env ? { env: options.env } : {}, { cwd }),
     needsRebuild: () => needsRebuild(cwd),
     db: createPostgresAdapter(),
-    migrationsFolder: resolve8(cwd, "./migrations"),
-    configPath: resolve8(cwd, "dist/generated/drizzle.config.ts"),
+    migrationsFolder: resolve9(cwd, "./migrations"),
+    configPath: resolve9(cwd, "dist/generated/drizzle.config.ts"),
     prompt: createPromptAdapter()
   };
 }
@@ -50815,7 +51050,7 @@ async function runMigrate(options, deps) {
     }
     const config4 = await resolveConfig(process.cwd());
     const migrationsTable2 = config4.migrations?.table ?? "__manguito_migrations";
-    const migrationsFolder2 = config4.migrations?.folder ? resolve8(process.cwd(), config4.migrations.folder) : deps.migrationsFolder;
+    const migrationsFolder2 = config4.migrations?.folder ? resolve9(process.cwd(), config4.migrations.folder) : deps.migrationsFolder;
     const status = await getMigrationStatus(deps.db.getDb(), { migrationsTable: migrationsTable2, migrationsFolder: migrationsFolder2 });
     if (status.applied.length === 0 && status.pending.length === 0) {
       process.stdout.write(
@@ -50847,7 +51082,7 @@ async function runMigrate(options, deps) {
   loadEnvFile(options.env);
   const cwd = process.cwd();
   const config3 = await resolveConfig(cwd);
-  const migrationsFolder = config3.migrations?.folder ? resolve8(cwd, config3.migrations.folder) : deps.migrationsFolder;
+  const migrationsFolder = config3.migrations?.folder ? resolve9(cwd, config3.migrations.folder) : deps.migrationsFolder;
   const migrationsTable = config3.migrations?.table ?? "__manguito_migrations";
   try {
     await deps.db.connect();
@@ -50867,10 +51102,10 @@ async function runMigrate(options, deps) {
     }
   }
   printSuccess("Build complete");
-  const generatedDir = resolve8(cwd, "dist/generated");
+  const generatedDir = resolve9(cwd, "dist/generated");
   await generateDrizzleConfig(config3, generatedDir);
   const newFileNames = await generateMigration(deps.configPath, migrationsFolder);
-  const newFilePaths = newFileNames.map((f) => join13(migrationsFolder, f));
+  const newFilePaths = newFileNames.map((f) => join14(migrationsFolder, f));
   printSuccess(
     newFileNames.length === 0 ? "No new migration files generated" : `Generated ${newFileNames.length} migration file${newFileNames.length !== 1 ? "s" : ""}: ${newFileNames.join(", ")}`
   );
@@ -50940,7 +51175,7 @@ async function runMigrate(options, deps) {
   } else {
     allErrors.push(...walkResult.errors);
   }
-  const rolesPath = resolve8(cwd, config3.schema.base_path, "roles.json");
+  const rolesPath = resolve9(cwd, config3.schema.base_path, "roles.json");
   const rolesLoad = loadSchemaFile(rolesPath);
   let parsedRoles = null;
   if (rolesLoad.ok) {
@@ -50953,7 +51188,7 @@ async function runMigrate(options, deps) {
   } else {
     allErrors.push(...rolesLoad.errors);
   }
-  const routesPath = resolve8(cwd, config3.schema.base_path, "routes.json");
+  const routesPath = resolve9(cwd, config3.schema.base_path, "routes.json");
   const routesLoad = loadSchemaFile(routesPath);
   let parsedRoutes = null;
   if (routesLoad.ok) {
@@ -50985,7 +51220,7 @@ async function runMigrate(options, deps) {
 
 // src/commands/validate.ts
 init_esm_shims();
-import { resolve as resolve9 } from "path";
+import { resolve as resolve10 } from "path";
 function registerValidate(program2) {
   program2.command("validate").description("Parse and validate all schemas, config, roles, and routes").option("--env <path>", "path to .env file to load").action(async (options) => {
     await runValidate(options, { cwd: process.cwd() });
@@ -51010,7 +51245,7 @@ async function runValidate(options, deps) {
       }
     }
   }
-  const rolesPath = resolve9(cwd, config3.schema.base_path, "roles.json");
+  const rolesPath = resolve10(cwd, config3.schema.base_path, "roles.json");
   const rolesLoadResult = loadSchemaFile(rolesPath);
   let parsedRoles = null;
   if (!rolesLoadResult.ok) {
@@ -51023,7 +51258,7 @@ async function runValidate(options, deps) {
       parsedRoles = rolesParseResult.value;
     }
   }
-  const routesPath = resolve9(cwd, config3.schema.base_path, "routes.json");
+  const routesPath = resolve10(cwd, config3.schema.base_path, "routes.json");
   const routesLoadResult = loadSchemaFile(routesPath);
   let parsedRoutesDef = null;
   if (!routesLoadResult.ok) {
@@ -51306,18 +51541,6 @@ import path6 from "path";
 // src/utils/registry.ts
 init_esm_shims();
 import { resolve as resolve11 } from "path";
-
-// src/utils/schema-config.ts
-init_esm_shims();
-import { resolve as resolve10 } from "path";
-function resolveSchemaConfig(cwd, config3) {
-  return {
-    base_path: resolve10(cwd, config3.schema.base_path),
-    folders: config3.schema.folders
-  };
-}
-
-// src/utils/registry.ts
 function loadWorkingRegistry(cwd, config3, command) {
   const schema = resolveSchemaConfig(cwd, config3);
   const allErrors = [];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bobbykim/manguito-cms-cli",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "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-api": "0.4.3",
-    "@bobbykim/manguito-cms-core": "0.5.0",
     "@bobbykim/manguito-cms-admin": "0.4.2",
-    "@bobbykim/manguito-cms-db": "0.1.5"
+    "@bobbykim/manguito-cms-core": "0.5.0",
+    "@bobbykim/manguito-cms-db": "0.1.5",
+    "@bobbykim/manguito-cms-api": "0.5.0"
   },
   "devDependencies": {
     "@types/node": "^25.9.5",
@@ -43,6 +43,7 @@
     "build": "tsup",
     "dev": "tsup --watch",
     "test": "dotenv -e .env.test -- vitest run",
-    "lint": "eslint src"
+    "lint": "eslint src",
+    "typecheck": "tsc --noEmit"
   }
 }