@bobbykim/manguito-cms-cli 0.2.2 → 0.3.0

package/dist/index.js

@@ -7530,13 +7530,13 @@ var require_bcrypt = __commonJS({
             throw Error("Illegal callback: " + typeof callback);
           _async(callback);
         } else
-          return new Promise(function(resolve9, reject) {
+          return new Promise(function(resolve10, reject) {
             _async(function(err, res) {
               if (err) {
                 reject(err);
                 return;
               }
-              resolve9(res);
+              resolve10(res);
             });
           });
       };
@@ -7565,13 +7565,13 @@ var require_bcrypt = __commonJS({
             throw Error("Illegal callback: " + typeof callback);
           _async(callback);
         } else
-          return new Promise(function(resolve9, reject) {
+          return new Promise(function(resolve10, reject) {
             _async(function(err, res) {
               if (err) {
                 reject(err);
                 return;
               }
-              resolve9(res);
+              resolve10(res);
             });
           });
       };
@@ -7616,13 +7616,13 @@ var require_bcrypt = __commonJS({
             throw Error("Illegal callback: " + typeof callback);
           _async(callback);
         } else
-          return new Promise(function(resolve9, reject) {
+          return new Promise(function(resolve10, reject) {
             _async(function(err, res) {
               if (err) {
                 reject(err);
                 return;
               }
-              resolve9(res);
+              resolve10(res);
             });
           });
       };
@@ -12343,7 +12343,7 @@ var require_dist2 = __commonJS({
     function parse4(stream, callback) {
       const parser = new parser_1.Parser();
       stream.on("data", (buffer) => parser.parse(buffer, callback));
-      return new Promise((resolve9) => stream.on("end", () => resolve9()));
+      return new Promise((resolve10) => stream.on("end", () => resolve10()));
     }
   }
 });
@@ -13112,12 +13112,12 @@ var require_client = __commonJS({
           this._connect(callback);
           return;
         }
-        return new this._Promise((resolve9, reject) => {
+        return new this._Promise((resolve10, reject) => {
           this._connect((error51) => {
             if (error51) {
               reject(error51);
             } else {
-              resolve9(this);
+              resolve10(this);
             }
           });
         });
@@ -13464,8 +13464,8 @@ var require_client = __commonJS({
         } else {
           query = new Query2(config3, values, callback);
           if (!query.callback) {
-            result = new this._Promise((resolve9, reject) => {
-              query.callback = (err, res) => err ? reject(err) : resolve9(res);
+            result = new this._Promise((resolve10, reject) => {
+              query.callback = (err, res) => err ? reject(err) : resolve10(res);
             }).catch((err) => {
               Error.captureStackTrace(err);
               throw err;
@@ -13549,8 +13549,8 @@ var require_client = __commonJS({
         if (cb) {
           this.connection.once("end", cb);
         } else {
-          return new this._Promise((resolve9) => {
-            this.connection.once("end", resolve9);
+          return new this._Promise((resolve10) => {
+            this.connection.once("end", resolve10);
           });
         }
       }
@@ -13600,8 +13600,8 @@ var require_pg_pool = __commonJS({
       const cb = function(err, client) {
         err ? rej(err) : res(client);
       };
-      const result = new Promise2(function(resolve9, reject) {
-        res = resolve9;
+      const result = new Promise2(function(resolve10, reject) {
+        res = resolve10;
         rej = reject;
       }).catch((err) => {
         Error.captureStackTrace(err);
@@ -13662,7 +13662,7 @@ var require_pg_pool = __commonJS({
         if (typeof Promise2.try === "function") {
           return Promise2.try(f);
         }
-        return new Promise2((resolve9) => resolve9(f()));
+        return new Promise2((resolve10) => resolve10(f()));
       }
       _isFull() {
         return this._clients.length >= this.options.max;
@@ -14056,8 +14056,8 @@ var require_query2 = __commonJS({
     NativeQuery.prototype._getPromise = function() {
       if (this._promise) return this._promise;
       this._promise = new Promise(
-        function(resolve9, reject) {
-          this._once("end", resolve9);
+        function(resolve10, reject) {
+          this._once("end", resolve10);
           this._once("error", reject);
         }.bind(this)
       );
@@ -14236,12 +14236,12 @@ var require_client2 = __commonJS({
         this._connect(callback);
         return;
       }
-      return new this._Promise((resolve9, reject) => {
+      return new this._Promise((resolve10, reject) => {
         this._connect((error51) => {
           if (error51) {
             reject(error51);
           } else {
-            resolve9(this);
+            resolve10(this);
           }
         });
       });
@@ -14265,8 +14265,8 @@ var require_client2 = __commonJS({
         query = new NativeQuery(config3, values, callback);
         if (!query.callback) {
           let resolveOut, rejectOut;
-          result = new this._Promise((resolve9, reject) => {
-            resolveOut = resolve9;
+          result = new this._Promise((resolve10, reject) => {
+            resolveOut = resolve10;
             rejectOut = reject;
           }).catch((err) => {
             Error.captureStackTrace(err);
@@ -14329,8 +14329,8 @@ var require_client2 = __commonJS({
       }
       let result;
       if (!cb) {
-        result = new this._Promise(function(resolve9, reject) {
-          cb = (err) => err ? reject(err) : resolve9();
+        result = new this._Promise(function(resolve10, reject) {
+          cb = (err) => err ? reject(err) : resolve10();
         });
       }
       this.native.end(function() {
@@ -14478,7 +14478,7 @@ import { Command } from "commander";
 // src/commands/build.ts
 init_esm_shims();
 import { mkdirSync, statSync as statSync2, existsSync as existsSync3, readdirSync as readdirSync2, writeFileSync } from "fs";
-import { resolve as resolve3, join as join6, dirname } from "path";
+import { resolve as resolve3, join as join7, dirname } from "path";
 import { createRequire } from "module";
 import { build as viteBuild } from "vite";
 import { build as tsupBuild } from "tsup";
@@ -29155,6 +29155,10 @@ var RawBooleanFieldSchema = RawFieldBase.extend({
 var RawDateFieldSchema = RawFieldBase.extend({
   type: external_exports.literal("date")
 });
+var RawProgrammaticFieldSchema = RawFieldBase.extend({
+  type: external_exports.literal("programmatic"),
+  required: external_exports.boolean().optional()
+});
 var RawImageFieldSchema = RawFieldBase.extend({
   type: external_exports.literal("image"),
   max_size: maxSizeString.optional(),
@@ -29201,7 +29205,8 @@ var RawNonEnumFieldSchema = external_exports.discriminatedUnion("type", [
   RawVideoFieldSchema,
   RawFileFieldSchema,
   RawParagraphFieldSchema,
-  RawReferenceFieldSchema
+  RawReferenceFieldSchema,
+  RawProgrammaticFieldSchema
 ]);
 var RawFieldSchema = external_exports.union([RawNonEnumFieldSchema, RawEnumFieldSchema]);
 var RawTabSchema = external_exports.object({
@@ -29786,7 +29791,14 @@ var fieldTypeRegistry = {
       db_column,
       ui_component: { component: "typeahead-select", ref: raw2.target, rel: raw2.rel }
     };
-  }
+  },
+  // ── Programmatic — computed at read time, no column ─────────────────────────
+  // Inert marker: the value is produced by a user resolver in the api layer.
+  programmatic: () => ({
+    validation: { required: false },
+    db_column: null,
+    ui_component: { component: "computed-display" }
+  })
 };
 var CONTENT_SYSTEM_FIELDS = [
   { name: "id", db_type: "uuid", primary_key: true, default: "gen_random_uuid()", nullable: false },
@@ -29867,8 +29879,9 @@ function buildParsedField(rawField, order, sourceFile, ownerTableName) {
       }]
     };
   }
-  const { name, label, required: required2 } = rawField;
+  const { name, label } = rawField;
   const { validation, db_column, ui_component } = build(rawField, { ownerTableName });
+  const required2 = validation.required;
   return {
     ok: true,
     value: {
@@ -31220,7 +31233,7 @@ function sql(strings, ...params) {
     return new SQL([new StringChunk(str2)]);
   }
   sql2.raw = raw2;
-  function join11(chunks, separator) {
+  function join13(chunks, separator) {
     const result = [];
     for (const [i, chunk] of chunks.entries()) {
       if (i > 0 && separator !== void 0) {
@@ -31230,7 +31243,7 @@ function sql(strings, ...params) {
     }
     return new SQL(result);
   }
-  sql2.join = join11;
+  sql2.join = join13;
   function identifier(value) {
     return new Name(value);
   }
@@ -34912,7 +34925,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((join11) => join11.alias === tableName)) {
+      if (typeof tableName === "string" && this.config.joins?.some((join13) => join13.alias === tableName)) {
         throw new Error(`Alias "${tableName}" is already used in this query`);
       }
       if (!this.isPartialSelect) {
@@ -36136,7 +36149,7 @@ var PgUpdateBase = class extends QueryPromise {
   createJoin(joinType) {
     return (table, on) => {
       const tableName = getTableLikeName(table);
-      if (typeof tableName === "string" && this.config.joins.some((join11) => join11.alias === tableName)) {
+      if (typeof tableName === "string" && this.config.joins.some((join13) => join13.alias === tableName)) {
         throw new Error(`Alias "${tableName}" is already used in this query`);
       }
       if (typeof on === "function") {
@@ -36232,10 +36245,10 @@ var PgUpdateBase = class extends QueryPromise {
           const fromFields = this.getTableLikeFields(this.config.from);
           fields[tableName] = fromFields;
         }
-        for (const join11 of this.config.joins) {
-          const tableName2 = getTableLikeName(join11.table);
-          if (typeof tableName2 === "string" && !is(join11.table, SQL)) {
-            const fromFields = this.getTableLikeFields(join11.table);
+        for (const join13 of this.config.joins) {
+          const tableName2 = getTableLikeName(join13.table);
+          if (typeof tableName2 === "string" && !is(join13.table, SQL)) {
+            const fromFields = this.getTableLikeFields(join13.table);
             fields[tableName2] = fromFields;
           }
         }
@@ -44162,7 +44175,8 @@ var COMPONENT_NAME = {
   "file-upload": "MediaUpload",
   select: "EnumSelect",
   "typeahead-select": "ReferenceSelect",
-  "paragraph-embed": "ParagraphEmbed"
+  "paragraph-embed": "ParagraphEmbed",
+  "computed-display": "ComputedDisplay"
 };
 var COMPONENT_IMPORT = {
   TextInput: `${ADMIN_PKG}/src/components/fields/TextInput.vue`,
@@ -44173,7 +44187,8 @@ var COMPONENT_IMPORT = {
   MediaUpload: `${ADMIN_PKG}/src/components/fields/MediaUpload.vue`,
   EnumSelect: `${ADMIN_PKG}/src/components/fields/EnumSelect.vue`,
   ReferenceSelect: `${ADMIN_PKG}/src/components/fields/ReferenceSelect.vue`,
-  ParagraphEmbed: `${ADMIN_PKG}/src/components/fields/ParagraphEmbed.vue`
+  ParagraphEmbed: `${ADMIN_PKG}/src/components/fields/ParagraphEmbed.vue`,
+  ComputedDisplay: `${ADMIN_PKG}/src/components/fields/ComputedDisplay.vue`
 };
 function esc2(s) {
   return s.replace(/\\/g, "\\\\").replace(/'/g, "\\'");
@@ -44220,6 +44235,9 @@ function renderField(field, indent) {
   const compName = COMPONENT_NAME[field.ui_component.component];
   const fieldObj = buildFieldObject(field);
   const attr = indent + "  ";
+  if (field.ui_component.component === "computed-display") {
+    return [`${indent}<${compName}`, `${attr}:field="${fieldObj}"`, `${indent}/>`].join("\n");
+  }
   const lines = [`${indent}<${compName}`];
   lines.push(`${attr}:field="${fieldObj}"`);
   if (field.ui_component.component === "paragraph-embed") {
@@ -44327,6 +44345,7 @@ async function generateServerEntries(options, targetDir) {
 function appSetup() {
   return `import config from '../../manguito.config.js'
 import { schemaRegistry } from './schema-registry.js'
+import { programmaticResolvers } from './programmatic-registry.js'
 import { createCmsApp } from '@bobbykim/manguito-cms-api'
 import { createPostgresAdapter } from '@bobbykim/manguito-cms-db'
 
@@ -44339,6 +44358,7 @@ const { app } = createCmsApp({
   db: dbAdapter.getDb(),
   storage: config.storage,
   prefix: config.api.prefix,
+  resolvers: programmaticResolvers,
   ...(config.api.media ? { media: config.api.media } : {}),
   ...(config.api.rateLimit ? { rateLimit: config.api.rateLimit } : {}),
   ...(config.server.cors ? { cors: config.server.cors } : {}),
@@ -44499,6 +44519,34 @@ export default handle(app)
 `;
 }
 
+// src/codegen/programmatic-registry.ts
+init_esm_shims();
+import { writeFile as writeFile5 } from "fs/promises";
+import { join as join6, relative } from "path";
+function importSpecifier(targetDir, file2) {
+  let rel = relative(targetDir, file2).replace(/\\/g, "/");
+  if (!rel.startsWith(".")) rel = `./${rel}`;
+  return rel.replace(/\.ts$/, ".js");
+}
+async function generateProgrammaticRegistry(files, targetDir) {
+  const sorted = [...files].sort();
+  const imports = sorted.map((file2, i) => `import def${i} from '${importSpecifier(targetDir, file2)}'`).join("\n");
+  const defs = sorted.map((_f, i) => `def${i}`);
+  const entries = defs.map((d2) => `  [\`\${${d2}.schema}::\${${d2}.field}\`, ${d2}] as const`).join(",\n");
+  const typeImport = "import type { ProgrammaticFieldDefinition } from '@bobbykim/manguito-cms-core'";
+  const body = sorted.length === 0 ? `${typeImport}
+
+export const programmaticResolvers = new Map<string, ProgrammaticFieldDefinition>()
+` : `${typeImport}
+${imports}
+
+export const programmaticResolvers = new Map<string, ProgrammaticFieldDefinition>([
+${entries},
+])
+`;
+  await writeFile5(join6(targetDir, "programmatic-registry.ts"), body, "utf8");
+}
+
 // src/utils/config.ts
 init_esm_shims();
 import { existsSync } from "fs";
@@ -44676,10 +44724,13 @@ async function runBuild(options, deps) {
   );
   const generatedDir = resolve3(cwd, "dist/generated");
   mkdirSync(generatedDir, { recursive: true });
-  writeFileSync(join6(generatedDir, "schema.ts"), generateSchemaFile(registry2), "utf8");
+  writeFileSync(join7(generatedDir, "schema.ts"), generateSchemaFile(registry2), "utf8");
   await generateSchemaRegistry(registry2, generatedDir);
   await generateRoutes2(registry2, generatedDir);
-  await generateForms(registry2, join6(generatedDir, "forms"));
+  await generateForms(registry2, join7(generatedDir, "forms"));
+  const programmaticDir = resolve3(cwd, config3.programmatic.dir);
+  const resolverFiles = existsSync3(programmaticDir) ? walkFiles(programmaticDir).filter((f) => /\.(ts|mjs|js)$/.test(f)) : [];
+  await generateProgrammaticRegistry(resolverFiles, generatedDir);
   await generateServerEntries(
     { adminPrefix: config3.admin.prefix, apiPrefix: config3.api.prefix },
     generatedDir
@@ -44743,14 +44794,14 @@ async function needsRebuild(cwd) {
   );
 }
 function resolveAdminRoot(cwd) {
-  const cwdRequire = createRequire(join6(cwd, "package.json"));
+  const cwdRequire = createRequire(join7(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 readdirSync2(dir, { withFileTypes: true })) {
-    const full = join6(dir, entry.name);
+    const full = join7(dir, entry.name);
     if (entry.isDirectory()) {
       files.push(...walkFiles(full));
     } else {
@@ -44763,8 +44814,9 @@ function walkFiles(dir) {
 // src/commands/dev.ts
 init_esm_shims();
 import { createServer as createHttpServer } from "http";
-import { resolve as resolve5, join as join9, dirname as dirname2, extname as extname2 } from "path";
-import { mkdir as mkdir2, writeFile as writeFile7, watch, readFile } from "fs/promises";
+import { existsSync as existsSync5 } from "fs";
+import { resolve as resolve6, join as join11, dirname as dirname2, extname as extname3 } from "path";
+import { mkdir as mkdir2, writeFile as writeFile8, watch, readFile } from "fs/promises";
 import { createRequire as createRequire2 } from "module";
 import { createServer as createViteServer, searchForWorkspaceRoot } from "vite";
 
@@ -48074,6 +48126,138 @@ function buildRolesRegistry(roles2) {
   validateRoles(roles2);
   return Object.fromEntries(roles2.map((r) => [r.name, r]));
 }
+var DEFAULT_TIMEOUT_MS = 5e3;
+var LIST_CONCURRENCY = 10;
+function resolverKey(schema, field) {
+  return `${schema}::${field}`;
+}
+function validateResolverBindings(registry2, resolvers) {
+  const declared = /* @__PURE__ */ new Set();
+  const schemas = [
+    ...Object.values(registry2.content_types),
+    ...Object.values(registry2.taxonomy_types)
+  ];
+  for (const schema of schemas) {
+    for (const field of schema.fields) {
+      if (field.field_type === "programmatic") {
+        declared.add(resolverKey(schema.name, field.name));
+      }
+    }
+  }
+  const missing = [];
+  for (const key of declared) if (!resolvers.has(key)) missing.push(key);
+  const orphans = [];
+  for (const key of resolvers.keys()) if (!declared.has(key)) orphans.push(key);
+  if (missing.length === 0 && orphans.length === 0) return;
+  const lines = ["\u2717 Programmatic field resolver bindings are invalid."];
+  if (missing.length > 0) {
+    lines.push("", '  Declared as `type: "programmatic"` but no resolver found:');
+    for (const k of missing) lines.push(`    - ${k}  (add a programmaticField in src/programmatic)`);
+  }
+  if (orphans.length > 0) {
+    lines.push("", "  Resolver has no matching programmatic field in the schema:");
+    for (const k of orphans) lines.push(`    - ${k}`);
+  }
+  lines.push("", "Exiting.");
+  throw new Error(lines.join("\n"));
+}
+function buildContext(row) {
+  return {
+    get: (name) => row[name],
+    record: row
+  };
+}
+async function withTimeout(p2, ms2) {
+  let timer;
+  const timeout = new Promise((_, reject) => {
+    timer = setTimeout(() => reject(new Error("resolver timeout")), ms2);
+  });
+  try {
+    return await Promise.race([p2, timeout]);
+  } finally {
+    clearTimeout(timer);
+  }
+}
+async function runOne(def, row, onError) {
+  const fallback = def.fallback ?? null;
+  try {
+    const result = await withTimeout(
+      Promise.resolve(def.resolve(buildContext(row))),
+      def.timeout ?? DEFAULT_TIMEOUT_MS
+    );
+    return { value: result === void 0 ? null : result, failed: false };
+  } catch (err) {
+    onError(
+      `\u26A0 programmatic field ${resolverKey(def.schema, def.field)} failed: ${err instanceof Error ? err.message : String(err)}`
+    );
+    return { value: fallback, failed: true };
+  }
+}
+async function runPool(items, limit, fn) {
+  let i = 0;
+  async function worker() {
+    while (i < items.length) {
+      const idx = i++;
+      await fn(items[idx]);
+    }
+  }
+  const workers = Array.from({ length: Math.min(limit, items.length) }, worker);
+  await Promise.all(workers);
+}
+function createProgrammaticResolver(resolvers, options) {
+  const onError = options?.onError ?? ((message) => {
+    process.stderr.write(message + "\n");
+  });
+  const bySchema = /* @__PURE__ */ new Map();
+  for (const def of resolvers.values()) {
+    const arr = bySchema.get(def.schema) ?? [];
+    arr.push(def);
+    bySchema.set(def.schema, arr);
+  }
+  const cache = /* @__PURE__ */ new Map();
+  async function resolveField(def, row) {
+    const itemId = row["id"] !== void 0 ? String(row["id"]) : "";
+    if (def.cache && itemId) {
+      const key = `${resolverKey(def.schema, def.field)}::${itemId}`;
+      const now = Date.now();
+      const hit = cache.get(key);
+      if (hit && hit.expires > now) return hit.value;
+      const { value: value2, failed } = await runOne(def, row, onError);
+      if (!failed) cache.set(key, { value: value2, expires: now + def.cache.ttl * 1e3 });
+      return value2;
+    }
+    const { value } = await runOne(def, row, onError);
+    return value;
+  }
+  async function resolveItem(schema, row) {
+    const defs = bySchema.get(schema);
+    if (!defs || defs.length === 0) return { ...row };
+    const out = { ...row };
+    await Promise.all(
+      defs.map(async (def) => {
+        out[def.field] = await resolveField(def, row);
+      })
+    );
+    return out;
+  }
+  async function resolveList(schema, rows) {
+    const defs = (bySchema.get(schema) ?? []).filter((d2) => d2.on_list === true);
+    if (defs.length === 0) return rows.map((r) => ({ ...r }));
+    const out = rows.map((r) => ({ ...r }));
+    const tasks = [];
+    for (let i = 0; i < rows.length; i++) {
+      for (const def of defs) tasks.push({ rowIndex: i, def });
+    }
+    await runPool(tasks, LIST_CONCURRENCY, async ({ rowIndex, def }) => {
+      out[rowIndex][def.field] = await resolveField(def, rows[rowIndex]);
+    });
+    return out;
+  }
+  function hasSchema(schema) {
+    return bySchema.has(schema);
+  }
+  return { resolveItem, resolveList, hasSchema };
+}
 var SORTABLE_FIELDS = /* @__PURE__ */ new Set(["title", "created_at", "updated_at"]);
 var RELATION_FIELD_TYPES = /* @__PURE__ */ new Set([
   "paragraph",
@@ -48122,7 +48306,7 @@ function parseFilters(url2, validFields) {
 function isPublished(item) {
   return item["published"] === true;
 }
-function registerPublicContentRoutes(app, registry2, repos, listRateLimit) {
+function registerPublicContentRoutes(app, registry2, repos, listRateLimit, resolver) {
   function registerListRoute(path4, handler) {
     if (listRateLimit) {
       app.get(path4, listRateLimit, handler);
@@ -48149,13 +48333,13 @@ function registerPublicContentRoutes(app, registry2, repos, listRateLimit) {
     const basePath = contentType.default_base_path;
     const repo = repos[typeName];
     if (!repo) continue;
-    const schemaFieldNames = /* @__PURE__ */ new Set([
-      ...contentType.fields.map((f) => f.name),
-      ...contentType.system_fields.map((f) => f.name)
-    ]);
     const relationFieldNames = new Set(
       contentType.fields.filter((f) => RELATION_FIELD_TYPES.has(f.field_type)).map((f) => f.name)
     );
+    const filterableFieldNames = /* @__PURE__ */ new Set([
+      ...contentType.fields.filter((f) => f.field_type !== "programmatic").map((f) => f.name),
+      ...contentType.system_fields.map((f) => f.name)
+    ]);
     if (contentType.only_one) {
       app.get(`/api/${basePath}`, async (c) => {
         const result = await repo.findMany({ published_only: true, page: 1, per_page: 1 });
@@ -48165,7 +48349,9 @@ function registerPublicContentRoutes(app, registry2, repos, listRateLimit) {
             404
           );
         }
-        return c.json({ ok: true, data: result.data[0] });
+        let data = 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) => {
@@ -48208,7 +48394,7 @@ function registerPublicContentRoutes(app, registry2, repos, listRateLimit) {
             400
           );
         }
-        const filtersResult = parseFilters(c.req.url, schemaFieldNames);
+        const filtersResult = parseFilters(c.req.url, filterableFieldNames);
         if (!filtersResult.ok) {
           return c.json(
             {
@@ -48245,6 +48431,10 @@ function registerPublicContentRoutes(app, registry2, repos, listRateLimit) {
           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);
       });
       app.get(`/api/${basePath}/:slug`, async (c) => {
@@ -48274,7 +48464,9 @@ function registerPublicContentRoutes(app, registry2, repos, listRateLimit) {
             404
           );
         }
-        return c.json({ ok: true, data: item });
+        let data = item;
+        if (resolver?.hasSchema(typeName)) data = await resolver.resolveItem(typeName, data);
+        return c.json({ ok: true, data });
       });
     }
   }
@@ -48300,6 +48492,10 @@ function registerPublicContentRoutes(app, registry2, repos, listRateLimit) {
         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);
     });
     app.get(`/api/taxonomy/${typeName}/:id`, async (c) => {
@@ -48314,7 +48510,9 @@ function registerPublicContentRoutes(app, registry2, repos, listRateLimit) {
           404
         );
       }
-      return c.json({ ok: true, data: item });
+      let data = item;
+      if (resolver?.hasSchema(typeName)) data = await resolver.resolveItem(typeName, data);
+      return c.json({ ok: true, data });
     });
   }
 }
@@ -50238,7 +50436,7 @@ function registerUserRoutes(app, db, requirePermission, requireHierarchy) {
 }
 var API_VERSION = (() => {
   try {
-    return "0.1.1";
+    return "0.2.0";
   } catch {
     return "0.0.0";
   }
@@ -50641,6 +50839,9 @@ function createCmsApp(options) {
   const cmsName = options.name ?? "Manguito CMS";
   const maxFileSize = media?.max_file_size;
   const rolesRegistry = buildRolesRegistry(registry2.roles.roles);
+  const resolverMap = options.resolvers ?? /* @__PURE__ */ new Map();
+  validateResolverBindings(registry2, resolverMap);
+  const programmaticResolver = createProgrammaticResolver(resolverMap);
   const app = new Hono2();
   const uploadOrigins = storage.getUploadOrigins?.() ?? [];
   app.use("*", createSecurityHeadersMiddleware({ connectSrc: uploadOrigins }));
@@ -50725,7 +50926,7 @@ function createCmsApp(options) {
       paths: {}
     })
   );
-  registerPublicContentRoutes(app, registry2, publicRepos, listRateLimit);
+  registerPublicContentRoutes(app, registry2, publicRepos, listRateLimit, programmaticResolver);
   registerPublicMediaRoutes(app, mediaRepo, listRateLimit);
   registerConfigRoute(
     app,
@@ -50750,12 +50951,12 @@ function createCmsApp(options) {
 
 // src/codegen/drizzle-config.ts
 init_esm_shims();
-import { writeFile as writeFile5 } from "fs/promises";
-import { join as join7, relative, resolve as resolve4 } from "path";
+import { writeFile as writeFile6 } from "fs/promises";
+import { join as join8, relative as relative2, resolve as resolve4 } from "path";
 async function generateDrizzleConfig(config3, targetDir) {
   const migrationsFolder = config3.migrations?.folder ?? "./migrations";
   const migrationsTable = config3.migrations?.table ?? "__manguito_migrations";
-  const outPath = relative(resolve4(targetDir), resolve4(migrationsFolder)).replace(/\\/g, "/");
+  const outPath = relative2(resolve4(targetDir), resolve4(migrationsFolder)).replace(/\\/g, "/");
   const content = [
     `import { defineConfig } from 'drizzle-kit'`,
     ``,
@@ -50773,13 +50974,13 @@ async function generateDrizzleConfig(config3, targetDir) {
     `  tablesFilter: ['!${migrationsTable}'],`,
     `})`
   ].join("\n");
-  await writeFile5(join7(targetDir, "drizzle.config.ts"), content, "utf8");
+  await writeFile6(join8(targetDir, "drizzle.config.ts"), content, "utf8");
 }
 
 // src/codegen/nav.ts
 init_esm_shims();
-import { writeFile as writeFile6 } from "fs/promises";
-import { join as join8 } from "path";
+import { writeFile as writeFile7 } from "fs/promises";
+import { join as join9 } from "path";
 function schemaBasePath(name) {
   const segment = name.includes("--") ? name.slice(name.indexOf("--") + 2) : name;
   return segment.replace(/_/g, "-");
@@ -50797,7 +50998,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 writeFile6(join8(targetDir, "nav.ts"), content, "utf8");
+  await writeFile7(join9(targetDir, "nav.ts"), content, "utf8");
 }
 
 // src/utils/db.ts
@@ -50828,6 +51029,49 @@ function createPromptAdapter() {
   };
 }
 
+// src/utils/programmatic-loader.ts
+init_esm_shims();
+import { existsSync as existsSync4 } from "fs";
+import { readdir } from "fs/promises";
+import { resolve as resolve5, join as join10, extname as extname2 } from "path";
+import { pathToFileURL as pathToFileURL2 } from "url";
+var RESOLVER_EXTENSIONS = /* @__PURE__ */ new Set([".ts", ".mjs", ".js"]);
+function isProgrammaticFieldDefinition(v2) {
+  return v2 !== null && typeof v2 === "object" && v2.__manguito_programmatic === true && typeof v2.schema === "string" && typeof v2.field === "string" && typeof v2.resolve === "function";
+}
+async function walkTsFiles(dir) {
+  const out = [];
+  for (const entry of await readdir(dir, { withFileTypes: true })) {
+    const full = join10(dir, entry.name);
+    if (entry.isDirectory()) {
+      out.push(...await walkTsFiles(full));
+    } else if (RESOLVER_EXTENSIONS.has(extname2(entry.name))) {
+      out.push(full);
+    }
+  }
+  return out;
+}
+async function loadProgrammaticResolvers(cwd, dir) {
+  const abs = resolve5(cwd, dir);
+  const map2 = /* @__PURE__ */ new Map();
+  if (!existsSync4(abs)) return map2;
+  for (const file2 of (await walkTsFiles(abs)).sort()) {
+    const mod = await import(pathToFileURL2(file2).href);
+    const def = mod.default;
+    if (!isProgrammaticFieldDefinition(def)) {
+      throw new Error(
+        `\u2717 ${file2} does not default-export a programmaticField(). Each resolver file must \`export default programmaticField({ schema, field }, resolver)\`.`
+      );
+    }
+    const key = resolverKey(def.schema, def.field);
+    if (map2.has(key)) {
+      throw new Error(`\u2717 Duplicate programmatic resolver for ${key} (found again in ${file2}).`);
+    }
+    map2.set(key, def);
+  }
+  return map2;
+}
+
 // src/commands/dev.ts
 var UPLOAD_MIME_MAP = {
   jpg: "image/jpeg",
@@ -50855,13 +51099,13 @@ async function runDev(options, deps) {
   printSuccess("Config loaded");
   const db = await connectDb(config3);
   printSuccess("Database connected");
-  const manguitoDir = resolve5(cwd, ".manguito");
+  const manguitoDir = resolve6(cwd, ".manguito");
   await mkdir2(manguitoDir, { recursive: true });
-  const drizzleConfigPath = resolve5(manguitoDir, "drizzle.config.ts");
+  const drizzleConfigPath = resolve6(manguitoDir, "drizzle.config.ts");
   const needsSeed = !await db.tableExists("users");
   const bootstrapRegistry = await parseAllSchemas(cwd, config3);
   await generateDrizzleConfig(config3, manguitoDir);
-  await writeFile7(join9(manguitoDir, "schema.ts"), generateSchemaFile(bootstrapRegistry), "utf8");
+  await writeFile8(join11(manguitoDir, "schema.ts"), generateSchemaFile(bootstrapRegistry), "utf8");
   await runDevMigration(drizzleConfigPath);
   printSuccess(needsSeed ? "Schema tables created" : "Schema tables up to date");
   if (needsSeed) {
@@ -50907,13 +51151,15 @@ async function runDev(options, deps) {
   );
   await generateSchemaRegistry(registry2, manguitoDir);
   await generateRoutes2(registry2, manguitoDir);
-  await generateForms(registry2, join9(manguitoDir, "forms"));
+  await generateForms(registry2, join11(manguitoDir, "forms"));
   await generateNav(registry2, manguitoDir);
+  const resolverMap = await loadProgrammaticResolvers(cwd, config3.programmatic.dir);
   const adapter = createCmsApp({
     name: config3.name,
     registry: registry2,
     db: db.getDb(),
     storage: config3.storage,
+    resolvers: resolverMap,
     ...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 } : {},
@@ -50945,8 +51191,8 @@ async function runDev(options, deps) {
       }
       if (url2.startsWith("/uploads/")) {
         const relativePath = (url2.slice("/uploads/".length).split("?")[0] ?? "").replace(/\.\./g, "");
-        const uploadsDir = resolve5(cwd, "uploads");
-        const filePath = resolve5(uploadsDir, relativePath);
+        const uploadsDir = resolve6(cwd, "uploads");
+        const filePath = resolve6(uploadsDir, relativePath);
         if (!filePath.startsWith(uploadsDir + "/") && filePath !== uploadsDir) {
           res.statusCode = 403;
           res.end("Forbidden");
@@ -50954,7 +51200,7 @@ async function runDev(options, deps) {
         }
         try {
           const data = await readFile(filePath);
-          const ext = extname2(filePath).slice(1).toLowerCase();
+          const ext = extname3(filePath).slice(1).toLowerCase();
           const mime = UPLOAD_MIME_MAP[ext] ?? "application/octet-stream";
           res.setHeader("Content-Type", mime);
           res.setHeader("X-Content-Type-Options", "nosniff");
@@ -50987,7 +51233,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 = resolve5(cwd, config3.schema.base_path);
+  const schemasDir = resolve6(cwd, config3.schema.base_path);
   const watcher = watch(schemasDir, { recursive: true });
   void (async () => {
     for await (const event of watcher) {
@@ -51000,14 +51246,36 @@ async function runDev(options, deps) {
           db,
           updateFetch: (fetch2) => {
             honoFetch = fetch2;
-          }
+          },
+          getResolvers: () => loadProgrammaticResolvers(cwd, config3.programmatic.dir)
         });
       }
     }
   })();
+  const programmaticDir = resolve6(cwd, config3.programmatic.dir);
+  if (existsSync5(programmaticDir)) {
+    const progWatcher = watch(programmaticDir, { recursive: true });
+    void (async () => {
+      for await (const event of progWatcher) {
+        if (event.filename && /\.(ts|mjs|js)$/.test(event.filename)) {
+          await onSchemaFileChange({
+            cwd,
+            config: config3,
+            manguitoDir,
+            drizzleConfigPath,
+            db,
+            updateFetch: (fetch2) => {
+              honoFetch = fetch2;
+            },
+            getResolvers: () => loadProgrammaticResolvers(cwd, config3.programmatic.dir)
+          });
+        }
+      }
+    })();
+  }
 }
 async function onSchemaFileChange(args) {
-  const { cwd, config: config3, manguitoDir, drizzleConfigPath, db, updateFetch } = args;
+  const { cwd, config: config3, manguitoDir, drizzleConfigPath, db, updateFetch, getResolvers } = args;
   let registry2;
   try {
     registry2 = await parseAllSchemas(cwd, config3);
@@ -51016,10 +51284,10 @@ async function onSchemaFileChange(args) {
     return;
   }
   await generateDrizzleConfig(config3, manguitoDir);
-  await writeFile7(join9(manguitoDir, "schema.ts"), generateSchemaFile(registry2), "utf8");
+  await writeFile8(join11(manguitoDir, "schema.ts"), generateSchemaFile(registry2), "utf8");
   await generateSchemaRegistry(registry2, manguitoDir);
   await generateRoutes2(registry2, manguitoDir);
-  await generateForms(registry2, join9(manguitoDir, "forms"));
+  await generateForms(registry2, join11(manguitoDir, "forms"));
   await generateNav(registry2, manguitoDir);
   try {
     await runDevMigration(drizzleConfigPath);
@@ -51028,11 +51296,13 @@ async function onSchemaFileChange(args) {
 `);
     return;
   }
+  const resolverMap = await getResolvers();
   const newAdapter = createCmsApp({
     name: config3.name,
     registry: registry2,
     db: db.getDb(),
     storage: config3.storage,
+    resolvers: resolverMap,
     ...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 } : {},
@@ -51056,7 +51326,7 @@ async function parseAllSchemas(cwd, config3) {
     }
     parsedSchemas.push(parseResult.schema);
   }
-  const rolesPath = resolve5(cwd, config3.schema.base_path, "roles.json");
+  const rolesPath = resolve6(cwd, config3.schema.base_path, "roles.json");
   const rolesLoad = loadSchemaFile(rolesPath);
   if (!rolesLoad.ok) {
     printGuidedError("Could not read roles.json.");
@@ -51067,7 +51337,7 @@ async function parseAllSchemas(cwd, config3) {
     printGuidedError("roles.json parse errors \u2014 run `manguito validate` for details.");
     process.exit(1);
   }
-  const routesPath = resolve5(cwd, config3.schema.base_path, "routes.json");
+  const routesPath = resolve6(cwd, config3.schema.base_path, "routes.json");
   const routesLoad = loadSchemaFile(routesPath);
   if (!routesLoad.ok) {
     printGuidedError("Could not read routes.json.");
@@ -51081,7 +51351,7 @@ async function parseAllSchemas(cwd, config3) {
   return buildSchemaRegistry(parsedSchemas, routesResult.value, rolesResult.value);
 }
 function resolveAdminRoot2(cwd) {
-  const cwdRequire = createRequire2(join9(cwd, "package.json"));
+  const cwdRequire = createRequire2(join11(cwd, "package.json"));
   const adminPkgJson = cwdRequire.resolve("@bobbykim/manguito-cms-admin/package.json");
   return dirname2(adminPkgJson);
 }
@@ -51127,8 +51397,8 @@ async function bridgeToHono(req, res, honoFetch) {
 
 // src/commands/start.ts
 init_esm_shims();
-import { resolve as resolve6 } from "path";
-import { pathToFileURL as pathToFileURL2 } from "url";
+import { resolve as resolve7 } 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) => {
     await runStart(options, { cwd: process.cwd() });
@@ -51140,7 +51410,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 ? resolve6(cwd, config3.migrations.folder) : resolve6(cwd, "./migrations");
+  const migrationsFolder = config3.migrations?.folder ? resolve7(cwd, config3.migrations.folder) : resolve7(cwd, "./migrations");
   const trackingTableExists = await db.tableExists(migrationsTable);
   if (!trackingTableExists) {
     printGuidedError(
@@ -51175,7 +51445,7 @@ async function runStart(options, deps) {
   } else {
     allErrors.push(...walkResult.errors);
   }
-  const rolesPath = resolve6(cwd, config3.schema.base_path, "roles.json");
+  const rolesPath = resolve7(cwd, config3.schema.base_path, "roles.json");
   const rolesLoad = loadSchemaFile(rolesPath);
   let parsedRoles = null;
   if (rolesLoad.ok) {
@@ -51188,7 +51458,7 @@ async function runStart(options, deps) {
   } else {
     allErrors.push(...rolesLoad.errors);
   }
-  const routesPath = resolve6(cwd, config3.schema.base_path, "routes.json");
+  const routesPath = resolve7(cwd, config3.schema.base_path, "routes.json");
   const routesLoad = loadSchemaFile(routesPath);
   let parsedRoutes = null;
   if (routesLoad.ok) {
@@ -51210,7 +51480,7 @@ async function runStart(options, deps) {
   }
   const registry2 = buildSchemaRegistry(parsedSchemas, parsedRoutes, parsedRoles);
   await seedSystemTables(db.getDb(), registry2);
-  const serverUrl = pathToFileURL2(resolve6(cwd, "dist/server.js")).href;
+  const serverUrl = pathToFileURL3(resolve7(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}`);
@@ -51219,7 +51489,7 @@ async function runStart(options, deps) {
 
 // src/commands/migrate.ts
 init_esm_shims();
-import { resolve as resolve7, join as join10 } from "path";
+import { resolve as resolve8, join as join12 } 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) => {
@@ -51237,8 +51507,8 @@ function buildDeps(options, cwd) {
     buildRunner: async () => runBuild(options.env ? { env: options.env } : {}, { cwd }),
     needsRebuild: () => needsRebuild(cwd),
     db: createPostgresAdapter(),
-    migrationsFolder: resolve7(cwd, "./migrations"),
-    configPath: resolve7(cwd, "dist/generated/drizzle.config.ts"),
+    migrationsFolder: resolve8(cwd, "./migrations"),
+    configPath: resolve8(cwd, "dist/generated/drizzle.config.ts"),
     prompt: createPromptAdapter()
   };
 }
@@ -51253,7 +51523,7 @@ async function runMigrate(options, deps) {
     }
     const config4 = await resolveConfig(process.cwd());
     const migrationsTable2 = config4.migrations?.table ?? "__manguito_migrations";
-    const migrationsFolder2 = config4.migrations?.folder ? resolve7(process.cwd(), config4.migrations.folder) : deps.migrationsFolder;
+    const migrationsFolder2 = config4.migrations?.folder ? resolve8(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(
@@ -51285,7 +51555,7 @@ async function runMigrate(options, deps) {
   loadEnvFile(options.env);
   const cwd = process.cwd();
   const config3 = await resolveConfig(cwd);
-  const migrationsFolder = config3.migrations?.folder ? resolve7(cwd, config3.migrations.folder) : deps.migrationsFolder;
+  const migrationsFolder = config3.migrations?.folder ? resolve8(cwd, config3.migrations.folder) : deps.migrationsFolder;
   const migrationsTable = config3.migrations?.table ?? "__manguito_migrations";
   try {
     await deps.db.connect();
@@ -51305,10 +51575,10 @@ async function runMigrate(options, deps) {
     }
   }
   printSuccess("Build complete");
-  const generatedDir = resolve7(cwd, "dist/generated");
+  const generatedDir = resolve8(cwd, "dist/generated");
   await generateDrizzleConfig(config3, generatedDir);
   const newFileNames = await generateMigration(deps.configPath, migrationsFolder);
-  const newFilePaths = newFileNames.map((f) => join10(migrationsFolder, f));
+  const newFilePaths = newFileNames.map((f) => join12(migrationsFolder, f));
   printSuccess(
     newFileNames.length === 0 ? "No new migration files generated" : `Generated ${newFileNames.length} migration file${newFileNames.length !== 1 ? "s" : ""}: ${newFileNames.join(", ")}`
   );
@@ -51378,7 +51648,7 @@ async function runMigrate(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) {
@@ -51391,7 +51661,7 @@ async function runMigrate(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) {
@@ -51423,7 +51693,7 @@ async function runMigrate(options, deps) {
 
 // src/commands/validate.ts
 init_esm_shims();
-import { resolve as resolve8 } from "path";
+import { resolve as resolve9 } 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() });
@@ -51448,7 +51718,7 @@ async function runValidate(options, deps) {
       }
     }
   }
-  const rolesPath = resolve8(cwd, config3.schema.base_path, "roles.json");
+  const rolesPath = resolve9(cwd, config3.schema.base_path, "roles.json");
   const rolesLoadResult = loadSchemaFile(rolesPath);
   let parsedRoles = null;
   if (!rolesLoadResult.ok) {
@@ -51461,7 +51731,7 @@ async function runValidate(options, deps) {
       parsedRoles = rolesParseResult.value;
     }
   }
-  const routesPath = resolve8(cwd, config3.schema.base_path, "routes.json");
+  const routesPath = resolve9(cwd, config3.schema.base_path, "routes.json");
   const routesLoadResult = loadSchemaFile(routesPath);
   let parsedRoutesDef = null;
   if (!routesLoadResult.ok) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bobbykim/manguito-cms-cli",
-  "version": "0.2.2",
+  "version": "0.3.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-admin": "0.2.0",
-    "@bobbykim/manguito-cms-api": "0.1.1",
-    "@bobbykim/manguito-cms-db": "0.1.1",
-    "@bobbykim/manguito-cms-core": "0.1.1"
+    "@bobbykim/manguito-cms-core": "0.2.0",
+    "@bobbykim/manguito-cms-admin": "0.3.0",
+    "@bobbykim/manguito-cms-db": "0.1.2",
+    "@bobbykim/manguito-cms-api": "0.2.0"
   },
   "devDependencies": {
     "@types/node": "^25.9.5",