@cfast/admin 0.0.1

package/dist/index.js

@@ -0,0 +1,1898 @@
+// src/introspect.ts
+import { getTableConfig } from "drizzle-orm/sqlite-core";
+import { getTableColumns, getTableName } from "drizzle-orm";
+var AUTO_EXCLUDED_TABLES = /* @__PURE__ */ new Set([
+  "session",
+  "account",
+  "verification",
+  "passkey"
+]);
+function tableNameToLabel(name) {
+  const words = name.replace(/([a-z])([A-Z])/g, "$1_$2").split("_").filter(Boolean);
+  if (words.length === 0) return name;
+  const titled = words.map(
+    (w) => w.charAt(0).toUpperCase() + w.slice(1).toLowerCase()
+  );
+  const lastIndex = titled.length - 1;
+  titled[lastIndex] = pluralize(titled[lastIndex]);
+  return titled.join(" ");
+}
+function pluralize(word) {
+  const lower = word.toLowerCase();
+  if (lower.endsWith("es") || lower.endsWith("ies") || lower.endsWith("s") && !lower.endsWith("ss") && !lower.endsWith("us")) {
+    return word;
+  }
+  if (word.endsWith("s") || word.endsWith("x") || word.endsWith("z")) {
+    return word + "es";
+  }
+  if (word.endsWith("sh") || word.endsWith("ch")) {
+    return word + "es";
+  }
+  if (word.endsWith("y") && word.length > 1 && !isVowel(word.charAt(word.length - 2))) {
+    return word.slice(0, -1) + "ies";
+  }
+  return word + "s";
+}
+function isVowel(ch) {
+  return "aeiouAEIOU".includes(ch);
+}
+function columnNameToLabel(name) {
+  const words = name.replace(/([a-z])([A-Z])/g, "$1_$2").split("_").filter(Boolean);
+  return words.map((w) => w.charAt(0).toUpperCase() + w.slice(1).toLowerCase()).join(" ");
+}
+function introspectSchema(schema, tableOverrides) {
+  const result = [];
+  for (const [_key, table] of Object.entries(schema)) {
+    const tableName = getTableName(table);
+    const overrides = tableOverrides?.[tableName] ?? {};
+    if (overrides.exclude === true) {
+      continue;
+    }
+    if (AUTO_EXCLUDED_TABLES.has(tableName) && !tableOverrides?.[tableName]) {
+      continue;
+    }
+    const columns = introspectColumns(table);
+    if (columns.length === 0) continue;
+    const primaryKey = columns.find((c) => c.isPrimaryKey)?.name ?? columns[0].name;
+    const searchableColumns = overrides.searchable ?? defaultSearchableColumns(columns);
+    const listColumns = overrides.listColumns ?? columns.filter((c) => !c.isPrimaryKey).map((c) => c.name);
+    const defaultSort = overrides.defaultSort ?? {
+      column: primaryKey,
+      direction: "desc"
+    };
+    const label = overrides.label ?? tableNameToLabel(tableName);
+    result.push({
+      name: tableName,
+      label,
+      drizzleTable: table,
+      columns,
+      primaryKey,
+      searchableColumns,
+      listColumns,
+      defaultSort,
+      overrides
+    });
+  }
+  result.sort((a, b) => a.name.localeCompare(b.name));
+  return result;
+}
+function introspectColumns(table) {
+  const drizzleColumns = getTableColumns(table);
+  const tableConfig = getTableConfig(table);
+  const foreignKeys = tableConfig.foreignKeys;
+  const refMap = /* @__PURE__ */ new Map();
+  for (const fk of foreignKeys) {
+    const ref = fk.reference();
+    const localColumns = ref.columns;
+    const foreignColumns = ref.foreignColumns;
+    const foreignTable = ref.foreignTable;
+    const foreignTableName = getTableName(foreignTable);
+    for (let i = 0; i < localColumns.length; i++) {
+      const localCol = localColumns[i];
+      const foreignCol = foreignColumns[i];
+      if (localCol && foreignCol) {
+        refMap.set(localCol.name, {
+          table: foreignTableName,
+          column: foreignCol.name
+        });
+      }
+    }
+  }
+  const result = [];
+  for (const [_fieldName, col] of Object.entries(drizzleColumns)) {
+    const ref = refMap.get(col.name);
+    const columnConfig = {
+      name: col.name,
+      label: columnNameToLabel(col.name),
+      dataType: col.dataType,
+      columnType: col.columnType,
+      required: col.notNull && !col.hasDefault,
+      hasDefault: col.hasDefault,
+      isPrimaryKey: col.primary
+    };
+    if (col.enumValues && col.enumValues.length > 0) {
+      columnConfig.enumValues = [...col.enumValues];
+    }
+    if (ref) {
+      columnConfig.referencesTable = ref.table;
+      columnConfig.referencesColumn = ref.column;
+    }
+    result.push(columnConfig);
+  }
+  return result;
+}
+function defaultSearchableColumns(columns) {
+  const textCol = columns.find((c) => c.dataType === "string");
+  return textCol ? [textCol.name] : [];
+}
+
+// src/loader.ts
+import { getTableColumns as getTableColumns2, getTableName as getTableName2, eq, like, or, asc, desc } from "drizzle-orm";
+
+// src/utils.ts
+var USERS_VIEW = "_users";
+function parseAdminParams(url) {
+  const view = url.searchParams.get("view");
+  if (!view || view === "dashboard") {
+    return { kind: "dashboard" };
+  }
+  if (view === USERS_VIEW) {
+    const id2 = url.searchParams.get("id");
+    if (id2) {
+      return { kind: "user-detail", id: id2 };
+    }
+    return {
+      kind: "user-list",
+      page: parsePageParam(url.searchParams.get("page")),
+      search: url.searchParams.get("search") ?? ""
+    };
+  }
+  const table = view;
+  const id = url.searchParams.get("id");
+  const mode = url.searchParams.get("mode");
+  if (mode === "create") {
+    return { kind: "create", table };
+  }
+  if (id && mode === "edit") {
+    return { kind: "edit", table, id };
+  }
+  if (id) {
+    return { kind: "detail", table, id };
+  }
+  const dirParam = url.searchParams.get("dir");
+  const direction = dirParam === "asc" ? "asc" : "desc";
+  return {
+    kind: "list",
+    table,
+    page: parsePageParam(url.searchParams.get("page")),
+    sort: url.searchParams.get("sort"),
+    direction,
+    search: url.searchParams.get("search") ?? ""
+  };
+}
+function buildAdminUrl(params) {
+  const sp = new URLSearchParams();
+  switch (params.kind) {
+    case "dashboard":
+      return "";
+    case "list":
+      sp.set("view", params.table);
+      if (params.page > 1) {
+        sp.set("page", String(params.page));
+      }
+      if (params.sort) {
+        sp.set("sort", params.sort);
+      }
+      if (params.direction !== "desc") {
+        sp.set("dir", params.direction);
+      }
+      if (params.search) {
+        sp.set("search", params.search);
+      }
+      break;
+    case "detail":
+      sp.set("view", params.table);
+      sp.set("id", params.id);
+      break;
+    case "create":
+      sp.set("view", params.table);
+      sp.set("mode", "create");
+      break;
+    case "edit":
+      sp.set("view", params.table);
+      sp.set("id", params.id);
+      sp.set("mode", "edit");
+      break;
+    case "user-list":
+      sp.set("view", USERS_VIEW);
+      if (params.page > 1) {
+        sp.set("page", String(params.page));
+      }
+      if (params.search) {
+        sp.set("search", params.search);
+      }
+      break;
+    case "user-detail":
+      sp.set("view", USERS_VIEW);
+      sp.set("id", params.id);
+      break;
+  }
+  const str = sp.toString();
+  return str ? `?${str}` : "";
+}
+function parsePageParam(value) {
+  if (!value) return 1;
+  const parsed = parseInt(value, 10);
+  return Number.isFinite(parsed) && parsed >= 1 ? parsed : 1;
+}
+
+// src/loader.ts
+var PAGE_SIZE = 20;
+function asRecords(value) {
+  if (!Array.isArray(value)) {
+    throw new TypeError(
+      `Expected an array of records, got ${typeof value}`
+    );
+  }
+  for (let i = 0; i < value.length; i++) {
+    if (typeof value[i] !== "object" || value[i] === null || Array.isArray(value[i])) {
+      throw new TypeError(
+        `Expected record at index ${i}, got ${Array.isArray(value[i]) ? "array" : typeof value[i]}`
+      );
+    }
+  }
+  return value;
+}
+function asRecord(value) {
+  if (value === void 0 || value === null) {
+    return void 0;
+  }
+  if (typeof value !== "object" || Array.isArray(value)) {
+    throw new TypeError(
+      `Expected a record, got ${Array.isArray(value) ? "array" : typeof value}`
+    );
+  }
+  return value;
+}
+function tableList(tableMetas) {
+  return tableMetas.filter((t) => t.name !== "users" && t.name !== "user").map((t) => ({ name: t.name, label: t.label }));
+}
+function findTableMeta(tableMetas, name) {
+  return tableMetas.find((t) => t.name === name);
+}
+function getColumn(drizzleTable, columnName) {
+  const columns = getTableColumns2(drizzleTable);
+  return columns[columnName];
+}
+function findUsersTable(schema) {
+  for (const table of Object.values(schema)) {
+    const name = getTableName2(table);
+    if (name === "user" || name === "users") {
+      return table;
+    }
+  }
+  return void 0;
+}
+function buildSearchWhere(drizzleTable, searchableColumns, search) {
+  if (!search || searchableColumns.length === 0) {
+    return void 0;
+  }
+  const pattern = `%${search}%`;
+  const conditions = searchableColumns.map((colName) => {
+    const col = getColumn(drizzleTable, colName);
+    if (!col) return void 0;
+    return like(col, pattern);
+  }).filter((c) => c != null);
+  if (conditions.length === 0) return void 0;
+  if (conditions.length === 1) return conditions[0];
+  return or(...conditions);
+}
+function buildOrderBy(drizzleTable, sortColumn, direction) {
+  const col = getColumn(drizzleTable, sortColumn);
+  if (!col) return void 0;
+  return direction === "asc" ? asc(col) : desc(col);
+}
+async function loadDashboard(config, db, tableMetas, user) {
+  const tables = tableList(tableMetas);
+  const stats = [];
+  const recentItems = [];
+  if (config.dashboard?.widgets) {
+    for (const widget of config.dashboard.widgets) {
+      const meta = findTableMeta(tableMetas, widget.table);
+      if (!meta) continue;
+      if (widget.type === "count") {
+        const rows = await db.query(meta.drizzleTable).findMany().run({});
+        stats.push({ label: widget.label, value: rows.length });
+      } else if (widget.type === "recent") {
+        const limit = widget.limit ?? 5;
+        const items = asRecords(await db.query(meta.drizzleTable).findMany({
+          limit,
+          orderBy: buildOrderBy(
+            meta.drizzleTable,
+            meta.primaryKey,
+            "desc"
+          )
+        }).run({}));
+        recentItems.push({
+          table: meta.name,
+          label: widget.label,
+          items,
+          columns: meta.listColumns
+        });
+      }
+    }
+  } else {
+    for (const meta of tableMetas) {
+      const rows = await db.query(meta.drizzleTable).findMany().run({});
+      stats.push({ label: meta.label, value: rows.length });
+    }
+    const firstMeta = tableMetas[0];
+    if (firstMeta) {
+      const items = asRecords(await db.query(firstMeta.drizzleTable).findMany({
+        limit: 5,
+        orderBy: buildOrderBy(
+          firstMeta.drizzleTable,
+          firstMeta.primaryKey,
+          "desc"
+        )
+      }).run({}));
+      recentItems.push({
+        table: firstMeta.name,
+        label: firstMeta.label,
+        items,
+        columns: firstMeta.listColumns
+      });
+    }
+  }
+  return {
+    view: "dashboard",
+    user,
+    tables,
+    stats,
+    recentItems
+  };
+}
+async function loadList(db, tableMetas, user, tableName, page, sort, direction, search) {
+  const tables = tableList(tableMetas);
+  const meta = findTableMeta(tableMetas, tableName);
+  if (!meta) {
+    return {
+      view: "error",
+      user,
+      tables,
+      message: `Table "${tableName}" not found.`
+    };
+  }
+  const sortColumn = sort ?? meta.defaultSort.column;
+  const sortDirection = sort ? direction : meta.defaultSort.direction;
+  const where = buildSearchWhere(
+    meta.drizzleTable,
+    meta.searchableColumns,
+    search
+  );
+  const orderBy = buildOrderBy(meta.drizzleTable, sortColumn, sortDirection);
+  const allRows = await db.query(meta.drizzleTable).findMany({ where }).run({});
+  const total = allRows.length;
+  const offset = (page - 1) * PAGE_SIZE;
+  const items = asRecords(await db.query(meta.drizzleTable).findMany({
+    where,
+    orderBy,
+    limit: PAGE_SIZE,
+    offset
+  }).run({}));
+  const totalPages = Math.max(1, Math.ceil(total / PAGE_SIZE));
+  return {
+    view: "list",
+    user,
+    tables,
+    tableName: meta.name,
+    tableLabel: meta.label,
+    items,
+    total,
+    page,
+    totalPages,
+    columns: meta.columns,
+    searchable: meta.searchableColumns,
+    sort: { column: sortColumn, direction: sortDirection },
+    search
+  };
+}
+async function loadDetail(db, tableMetas, user, tableName, id) {
+  const tables = tableList(tableMetas);
+  const meta = findTableMeta(tableMetas, tableName);
+  if (!meta) {
+    return {
+      view: "error",
+      user,
+      tables,
+      message: `Table "${tableName}" not found.`
+    };
+  }
+  const pkCol = getColumn(meta.drizzleTable, meta.primaryKey);
+  if (!pkCol) {
+    return {
+      view: "error",
+      user,
+      tables,
+      message: `Primary key column "${meta.primaryKey}" not found in table "${tableName}".`
+    };
+  }
+  const item = asRecord(await db.query(meta.drizzleTable).findFirst({ where: eq(pkCol, id) }).run({}));
+  if (!item) {
+    return {
+      view: "error",
+      user,
+      tables,
+      message: `Record with id "${id}" not found in table "${tableName}".`
+    };
+  }
+  return {
+    view: "detail",
+    user,
+    tables,
+    tableName: meta.name,
+    tableLabel: meta.label,
+    item,
+    columns: meta.columns
+  };
+}
+function loadCreate(tableMetas, user, tableName) {
+  const tables = tableList(tableMetas);
+  const meta = findTableMeta(tableMetas, tableName);
+  if (!meta) {
+    return {
+      view: "error",
+      user,
+      tables,
+      message: `Table "${tableName}" not found.`
+    };
+  }
+  return {
+    view: "create",
+    user,
+    tables,
+    tableName: meta.name,
+    tableLabel: meta.label,
+    columns: meta.columns
+  };
+}
+async function loadEdit(db, tableMetas, user, tableName, id) {
+  const tables = tableList(tableMetas);
+  const meta = findTableMeta(tableMetas, tableName);
+  if (!meta) {
+    return {
+      view: "error",
+      user,
+      tables,
+      message: `Table "${tableName}" not found.`
+    };
+  }
+  const pkCol = getColumn(meta.drizzleTable, meta.primaryKey);
+  if (!pkCol) {
+    return {
+      view: "error",
+      user,
+      tables,
+      message: `Primary key column "${meta.primaryKey}" not found in table "${tableName}".`
+    };
+  }
+  const item = asRecord(await db.query(meta.drizzleTable).findFirst({ where: eq(pkCol, id) }).run({}));
+  if (!item) {
+    return {
+      view: "error",
+      user,
+      tables,
+      message: `Record with id "${id}" not found in table "${tableName}".`
+    };
+  }
+  return {
+    view: "edit",
+    user,
+    tables,
+    tableName: meta.name,
+    tableLabel: meta.label,
+    item,
+    columns: meta.columns
+  };
+}
+async function loadUserList(config, db, tableMetas, user, page, search) {
+  const tables = tableList(tableMetas);
+  const usersTable = findUsersTable(config.schema);
+  if (!usersTable) {
+    return {
+      view: "error",
+      user,
+      tables,
+      message: "Users table not found in schema."
+    };
+  }
+  const unsafeDb = db.unsafe();
+  const columns = getTableColumns2(usersTable);
+  const searchableUserCols = ["name", "email"].filter((c) => columns[c] != null);
+  const where = buildSearchWhere(usersTable, searchableUserCols, search);
+  const allRows = await unsafeDb.query(usersTable).findMany({ where }).run({});
+  const total = allRows.length;
+  const offset = (page - 1) * PAGE_SIZE;
+  const rawUsers = asRecords(await unsafeDb.query(usersTable).findMany({
+    where,
+    limit: PAGE_SIZE,
+    offset
+  }).run({}));
+  const items = [];
+  for (const raw of rawUsers) {
+    const userId = String(raw["id"] ?? "");
+    const roles = await config.auth.getRoles(userId);
+    items.push({
+      id: userId,
+      email: String(raw["email"] ?? ""),
+      name: String(raw["name"] ?? ""),
+      avatarUrl: raw["avatarUrl"] != null ? String(raw["avatarUrl"]) : raw["avatar_url"] != null ? String(raw["avatar_url"]) : null,
+      roles,
+      createdAt: raw["createdAt"] != null ? String(raw["createdAt"]) : raw["created_at"] != null ? String(raw["created_at"]) : void 0
+    });
+  }
+  const totalPages = Math.max(1, Math.ceil(total / PAGE_SIZE));
+  const assignableRoles = config.users?.assignableRoles ?? [];
+  return {
+    view: "users",
+    user,
+    tables,
+    items,
+    total,
+    page,
+    totalPages,
+    search,
+    assignableRoles
+  };
+}
+async function loadUserDetail(config, db, tableMetas, user, targetId) {
+  const tables = tableList(tableMetas);
+  const usersTable = findUsersTable(config.schema);
+  if (!usersTable) {
+    return {
+      view: "error",
+      user,
+      tables,
+      message: "Users table not found in schema."
+    };
+  }
+  const unsafeDb = db.unsafe();
+  const pkCol = getColumn(usersTable, "id");
+  if (!pkCol) {
+    return {
+      view: "error",
+      user,
+      tables,
+      message: 'Users table has no "id" column.'
+    };
+  }
+  const raw = asRecord(await unsafeDb.query(usersTable).findFirst({ where: eq(pkCol, targetId) }).run({}));
+  if (!raw) {
+    return {
+      view: "error",
+      user,
+      tables,
+      message: `User with id "${targetId}" not found.`
+    };
+  }
+  const roles = await config.auth.getRoles(targetId);
+  const assignableRoles = config.users?.assignableRoles ?? [];
+  const targetUser = {
+    id: String(raw["id"] ?? ""),
+    email: String(raw["email"] ?? ""),
+    name: String(raw["name"] ?? ""),
+    avatarUrl: raw["avatarUrl"] != null ? String(raw["avatarUrl"]) : raw["avatar_url"] != null ? String(raw["avatar_url"]) : null,
+    roles,
+    createdAt: raw["createdAt"] != null ? String(raw["createdAt"]) : raw["created_at"] != null ? String(raw["created_at"]) : void 0
+  };
+  return {
+    view: "user-detail",
+    user,
+    tables,
+    targetUser,
+    assignableRoles
+  };
+}
+function createAdminLoader(config, tableMetas) {
+  const requiredRole = config.requiredRole ?? "admin";
+  return async function adminLoader(request) {
+    const { user, grants } = await config.auth.requireUser(request);
+    if (!config.auth.hasRole(user, requiredRole)) {
+      throw new Response(null, {
+        status: 302,
+        headers: { Location: "/" }
+      });
+    }
+    const db = config.db(grants, user);
+    const url = new URL(request.url);
+    const params = parseAdminParams(url);
+    switch (params.kind) {
+      case "dashboard":
+        return loadDashboard(config, db, tableMetas, user);
+      case "list":
+        return loadList(
+          db,
+          tableMetas,
+          user,
+          params.table,
+          params.page,
+          params.sort,
+          params.direction,
+          params.search
+        );
+      case "detail":
+        return loadDetail(db, tableMetas, user, params.table, params.id);
+      case "create":
+        return loadCreate(tableMetas, user, params.table);
+      case "edit":
+        return loadEdit(db, tableMetas, user, params.table, params.id);
+      case "user-list":
+        return loadUserList(
+          config,
+          db,
+          tableMetas,
+          user,
+          params.page,
+          params.search
+        );
+      case "user-detail":
+        return loadUserDetail(
+          config,
+          db,
+          tableMetas,
+          user,
+          params.id
+        );
+    }
+  };
+}
+
+// src/action.ts
+import { getTableColumns as getTableColumns3, eq as eq2 } from "drizzle-orm";
+var INTERNAL_FIELDS = /* @__PURE__ */ new Set([
+  "_action",
+  "_table",
+  "_id",
+  "_actionName"
+]);
+function getColumn2(drizzleTable, columnName) {
+  const columns = getTableColumns3(drizzleTable);
+  return columns[columnName];
+}
+function findTableMeta2(tableMetas, name) {
+  return tableMetas.find((t) => t.name === name);
+}
+function extractFormValues(formData, columns) {
+  const values = {};
+  for (const col of columns) {
+    if (col.isPrimaryKey) continue;
+    if (!formData.has(col.name)) continue;
+    const rawValue = formData.get(col.name);
+    if (INTERNAL_FIELDS.has(col.name)) continue;
+    if (col.columnType === "SQLiteBoolean") {
+      values[col.name] = rawValue === "true" || rawValue === "on" || rawValue === "1";
+      continue;
+    }
+    const strValue = rawValue != null ? String(rawValue) : "";
+    if (strValue === "" && !col.required) {
+      values[col.name] = null;
+      continue;
+    }
+    if (col.dataType === "number") {
+      const num = Number(strValue);
+      values[col.name] = Number.isFinite(num) ? num : strValue;
+      continue;
+    }
+    values[col.name] = strValue;
+  }
+  return values;
+}
+function createAdminAction(config, tableMetas) {
+  const requiredRole = config.requiredRole ?? "admin";
+  return async function adminAction(request) {
+    const { user, grants } = await config.auth.requireUser(request);
+    if (!config.auth.hasRole(user, requiredRole)) {
+      throw new Response("Forbidden", { status: 403 });
+    }
+    const db = config.db(grants, user);
+    const formData = await request.formData();
+    const action = formData.get("_action");
+    if (typeof action !== "string" || !action) {
+      return { error: "Missing _action field." };
+    }
+    switch (action) {
+      case "create":
+        return handleCreate(db, tableMetas, formData);
+      case "update":
+        return handleUpdate(db, tableMetas, formData);
+      case "delete":
+        return handleDelete(db, tableMetas, formData);
+      case "setRole":
+        return handleSetRole(config, formData);
+      case "removeRole":
+        return handleRemoveRole(config, formData);
+      case "impersonate":
+        if (!config.auth.impersonate) {
+          return { error: "Impersonation is not configured." };
+        }
+        return handleImpersonate(config, user.id, formData, request);
+      case "stopImpersonation":
+        if (!config.auth.stopImpersonation) {
+          return { error: "Impersonation is not configured." };
+        }
+        return config.auth.stopImpersonation(request);
+      case "custom":
+        return handleCustomAction(config, tableMetas, formData);
+      default:
+        return { error: `Unknown action: "${action}".` };
+    }
+  };
+}
+async function handleCreate(db, tableMetas, formData) {
+  const tableName = formData.get("_table");
+  if (typeof tableName !== "string" || !tableName) {
+    return { error: "Missing _table field." };
+  }
+  const meta = findTableMeta2(tableMetas, tableName);
+  if (!meta) {
+    return { error: `Table "${tableName}" not found.` };
+  }
+  const values = extractFormValues(formData, meta.columns);
+  try {
+    await db.insert(meta.drizzleTable).values(values).run({});
+    return { success: `Created new ${meta.label} record.` };
+  } catch (err) {
+    const message = err instanceof Error ? err.message : "Unknown error during create.";
+    return { error: message };
+  }
+}
+async function handleUpdate(db, tableMetas, formData) {
+  const tableName = formData.get("_table");
+  if (typeof tableName !== "string" || !tableName) {
+    return { error: "Missing _table field." };
+  }
+  const id = formData.get("_id");
+  if (typeof id !== "string" || !id) {
+    return { error: "Missing _id field." };
+  }
+  const meta = findTableMeta2(tableMetas, tableName);
+  if (!meta) {
+    return { error: `Table "${tableName}" not found.` };
+  }
+  const pkCol = getColumn2(meta.drizzleTable, meta.primaryKey);
+  if (!pkCol) {
+    return { error: `Primary key column "${meta.primaryKey}" not found.` };
+  }
+  const values = extractFormValues(formData, meta.columns);
+  try {
+    await db.update(meta.drizzleTable).set(values).where(eq2(pkCol, id)).run({});
+    return { success: `Updated ${meta.label} record.` };
+  } catch (err) {
+    const message = err instanceof Error ? err.message : "Unknown error during update.";
+    return { error: message };
+  }
+}
+async function handleDelete(db, tableMetas, formData) {
+  const tableName = formData.get("_table");
+  if (typeof tableName !== "string" || !tableName) {
+    return { error: "Missing _table field." };
+  }
+  const id = formData.get("_id");
+  if (typeof id !== "string" || !id) {
+    return { error: "Missing _id field." };
+  }
+  const meta = findTableMeta2(tableMetas, tableName);
+  if (!meta) {
+    return { error: `Table "${tableName}" not found.` };
+  }
+  const pkCol = getColumn2(meta.drizzleTable, meta.primaryKey);
+  if (!pkCol) {
+    return { error: `Primary key column "${meta.primaryKey}" not found.` };
+  }
+  try {
+    await db.delete(meta.drizzleTable).where(eq2(pkCol, id)).run({});
+    return { success: `Deleted ${meta.label} record.` };
+  } catch (err) {
+    const message = err instanceof Error ? err.message : "Unknown error during delete.";
+    return { error: message };
+  }
+}
+async function handleSetRole(config, formData) {
+  const userId = formData.get("_id");
+  if (typeof userId !== "string" || !userId) {
+    return { error: "Missing _id field." };
+  }
+  const role = formData.get("role");
+  if (typeof role !== "string" || !role) {
+    return { error: "Missing role field." };
+  }
+  try {
+    await config.auth.setRole(userId, role);
+    return { success: `Role "${role}" added to user.` };
+  } catch (err) {
+    const message = err instanceof Error ? err.message : "Unknown error setting role.";
+    return { error: message };
+  }
+}
+async function handleRemoveRole(config, formData) {
+  const userId = formData.get("_id");
+  if (typeof userId !== "string" || !userId) {
+    return { error: "Missing _id field." };
+  }
+  const role = formData.get("role");
+  if (typeof role !== "string" || !role) {
+    return { error: "Missing role field." };
+  }
+  try {
+    await config.auth.removeRole(userId, role);
+    return { success: `Role "${role}" removed from user.` };
+  } catch (err) {
+    const message = err instanceof Error ? err.message : "Unknown error removing role.";
+    return { error: message };
+  }
+}
+async function handleImpersonate(config, adminId, formData, request) {
+  const targetId = formData.get("_id");
+  if (typeof targetId !== "string" || !targetId) {
+    throw new Response("Missing _id for impersonation", { status: 400 });
+  }
+  return config.auth.impersonate(adminId, targetId, request);
+}
+async function handleCustomAction(_config, tableMetas, formData) {
+  const tableName = formData.get("_table");
+  if (typeof tableName !== "string" || !tableName) {
+    return { error: "Missing _table field." };
+  }
+  const actionName = formData.get("_actionName");
+  if (typeof actionName !== "string" || !actionName) {
+    return { error: "Missing _actionName field." };
+  }
+  const id = formData.get("_id");
+  if (typeof id !== "string" || !id) {
+    return { error: "Missing _id field." };
+  }
+  const meta = findTableMeta2(tableMetas, tableName);
+  if (!meta) {
+    return { error: `Table "${tableName}" not found.` };
+  }
+  const rowActions = meta.overrides.actions?.row;
+  if (!rowActions) {
+    return { error: `No custom actions defined for table "${tableName}".` };
+  }
+  const rowAction = rowActions.find((a) => a.label === actionName);
+  if (!rowAction) {
+    return { error: `Action "${actionName}" not found for table "${tableName}".` };
+  }
+  try {
+    await rowAction.action(id, formData);
+    return { success: `Action "${actionName}" completed.` };
+  } catch (err) {
+    const message = err instanceof Error ? err.message : "Unknown error during custom action.";
+    return { error: message };
+  }
+}
+
+// src/components/admin-root.tsx
+import "react";
+import { useLoaderData, useActionData, useSubmit as useSubmit6 } from "react-router";
+import Box8 from "@mui/joy/Box";
+import Button5 from "@mui/joy/Button";
+import Typography8 from "@mui/joy/Typography";
+import { ConfirmProvider } from "@cfast/ui";
+
+// src/components/sidebar.tsx
+import "react";
+import { Link, useSearchParams } from "react-router";
+import Sheet from "@mui/joy/Sheet";
+import List from "@mui/joy/List";
+import ListItem from "@mui/joy/ListItem";
+import ListItemButton from "@mui/joy/ListItemButton";
+import Typography from "@mui/joy/Typography";
+import Divider from "@mui/joy/Divider";
+import { jsx, jsxs } from "react/jsx-runtime";
+function Sidebar({ tables }) {
+  const [searchParams] = useSearchParams();
+  const currentView = searchParams.get("view");
+  return /* @__PURE__ */ jsxs(
+    Sheet,
+    {
+      sx: {
+        width: 240,
+        minHeight: "100vh",
+        borderRight: "1px solid",
+        borderColor: "divider",
+        p: 2
+      },
+      children: [
+        /* @__PURE__ */ jsx(Typography, { level: "h4", sx: { mb: 2 }, children: "Admin" }),
+        /* @__PURE__ */ jsxs(List, { size: "sm", children: [
+          /* @__PURE__ */ jsx(ListItem, { children: /* @__PURE__ */ jsx(
+            ListItemButton,
+            {
+              selected: currentView === null,
+              component: Link,
+              to: buildAdminUrl({ kind: "dashboard" }) || ".",
+              children: "Dashboard"
+            }
+          ) }),
+          /* @__PURE__ */ jsx(Divider, { sx: { my: 1 } }),
+          tables.map((table) => /* @__PURE__ */ jsx(ListItem, { children: /* @__PURE__ */ jsx(
+            ListItemButton,
+            {
+              selected: currentView === table.name,
+              component: Link,
+              to: buildAdminUrl({
+                kind: "list",
+                table: table.name,
+                page: 1,
+                sort: null,
+                direction: "desc",
+                search: ""
+              }),
+              children: table.label
+            }
+          ) }, table.name)),
+          /* @__PURE__ */ jsx(Divider, { sx: { my: 1 } }),
+          /* @__PURE__ */ jsx(ListItem, { children: /* @__PURE__ */ jsx(
+            ListItemButton,
+            {
+              selected: currentView === "_users",
+              component: Link,
+              to: buildAdminUrl({ kind: "user-list", page: 1, search: "" }),
+              children: "Users"
+            }
+          ) })
+        ] })
+      ]
+    }
+  );
+}
+
+// src/components/dashboard.tsx
+import "react";
+import { Link as Link2 } from "react-router";
+import Box from "@mui/joy/Box";
+import Card from "@mui/joy/Card";
+import Typography2 from "@mui/joy/Typography";
+import Table from "@mui/joy/Table";
+import Sheet2 from "@mui/joy/Sheet";
+import { jsx as jsx2, jsxs as jsxs2 } from "react/jsx-runtime";
+function Dashboard({ stats, recentItems }) {
+  return /* @__PURE__ */ jsxs2(Box, { children: [
+    /* @__PURE__ */ jsx2(Typography2, { level: "h2", sx: { mb: 3 }, children: "Dashboard" }),
+    stats.length > 0 && /* @__PURE__ */ jsx2(
+      Box,
+      {
+        sx: {
+          display: "grid",
+          gridTemplateColumns: "repeat(auto-fill, minmax(200px, 1fr))",
+          gap: 2,
+          mb: 4
+        },
+        children: stats.map((stat) => /* @__PURE__ */ jsxs2(Card, { variant: "outlined", children: [
+          /* @__PURE__ */ jsx2(Typography2, { level: "body-sm", textColor: "text.secondary", children: stat.label }),
+          /* @__PURE__ */ jsx2(Typography2, { level: "h3", children: stat.value })
+        ] }, stat.label))
+      }
+    ),
+    recentItems.map((section) => /* @__PURE__ */ jsxs2(Box, { sx: { mb: 4 }, children: [
+      /* @__PURE__ */ jsxs2(Box, { sx: { display: "flex", alignItems: "center", justifyContent: "space-between", mb: 1 }, children: [
+        /* @__PURE__ */ jsx2(Typography2, { level: "title-lg", children: section.label }),
+        /* @__PURE__ */ jsx2(
+          Typography2,
+          {
+            component: Link2,
+            to: buildAdminUrl({
+              kind: "list",
+              table: section.table,
+              page: 1,
+              sort: null,
+              direction: "desc",
+              search: ""
+            }),
+            level: "body-sm",
+            children: "View all"
+          }
+        )
+      ] }),
+      /* @__PURE__ */ jsx2(Sheet2, { variant: "outlined", sx: { borderRadius: "sm", overflow: "auto" }, children: /* @__PURE__ */ jsxs2(Table, { hoverRow: true, children: [
+        /* @__PURE__ */ jsx2("thead", { children: /* @__PURE__ */ jsx2("tr", { children: section.columns.map((col) => /* @__PURE__ */ jsx2("th", { children: col }, col)) }) }),
+        /* @__PURE__ */ jsxs2("tbody", { children: [
+          section.items.map((item, idx) => /* @__PURE__ */ jsx2("tr", { children: section.columns.map((col) => /* @__PURE__ */ jsx2("td", { children: formatCellValue(item[col]) }, col)) }, idx)),
+          section.items.length === 0 && /* @__PURE__ */ jsx2("tr", { children: /* @__PURE__ */ jsx2("td", { colSpan: section.columns.length, children: /* @__PURE__ */ jsx2(Typography2, { level: "body-sm", textAlign: "center", sx: { py: 2 }, children: "No items yet." }) }) })
+        ] })
+      ] }) })
+    ] }, section.table))
+  ] });
+}
+function formatCellValue(value) {
+  if (value === null || value === void 0) return "-";
+  if (typeof value === "boolean") return value ? "Yes" : "No";
+  return String(value);
+}
+
+// src/components/table-list.tsx
+import { useState } from "react";
+import { Link as Link3, useSubmit, useNavigate } from "react-router";
+import Box3 from "@mui/joy/Box";
+import Typography3 from "@mui/joy/Typography";
+import Button from "@mui/joy/Button";
+import Input from "@mui/joy/Input";
+import Table2 from "@mui/joy/Table";
+import Sheet3 from "@mui/joy/Sheet";
+import Stack from "@mui/joy/Stack";
+import { useConfirm } from "@cfast/ui";
+
+// src/components/action-result.tsx
+import "react";
+import Box2 from "@mui/joy/Box";
+import Chip from "@mui/joy/Chip";
+import { jsx as jsx3, jsxs as jsxs3 } from "react/jsx-runtime";
+function ActionResultDisplay({
+  result
+}) {
+  if (!result) return null;
+  if ("success" in result) {
+    return /* @__PURE__ */ jsx3(Chip, { color: "success", variant: "soft", sx: { mb: 2 }, children: result.success });
+  }
+  if ("error" in result) {
+    return /* @__PURE__ */ jsx3(Chip, { color: "danger", variant: "soft", sx: { mb: 2 }, children: result.error });
+  }
+  if ("fieldErrors" in result) {
+    return /* @__PURE__ */ jsx3(Box2, { sx: { mb: 2 }, children: Object.entries(result.fieldErrors).map(([field, error]) => /* @__PURE__ */ jsxs3(Chip, { color: "danger", variant: "soft", sx: { mr: 1, mb: 1 }, children: [
+      field,
+      ": ",
+      error
+    ] }, field)) });
+  }
+  return null;
+}
+
+// src/components/table-list.tsx
+import { jsx as jsx4, jsxs as jsxs4 } from "react/jsx-runtime";
+function TableList({
+  tableName,
+  tableLabel,
+  items,
+  total,
+  page,
+  totalPages,
+  columns,
+  searchable,
+  sort,
+  search,
+  primaryKey,
+  actionResult
+}) {
+  const submit = useSubmit();
+  const navigate = useNavigate();
+  const confirm = useConfirm();
+  const [searchValue, setSearchValue] = useState(search);
+  const listColumns = columns.filter((c) => !c.isPrimaryKey);
+  function sortUrl(columnName) {
+    const isSameColumn = sort.column === columnName;
+    const newDirection = isSameColumn && sort.direction === "asc" ? "desc" : "asc";
+    return buildAdminUrl({
+      kind: "list",
+      table: tableName,
+      page: 1,
+      sort: columnName,
+      direction: newDirection,
+      search
+    });
+  }
+  function handleSearchSubmit(e) {
+    e.preventDefault();
+    const url = buildAdminUrl({
+      kind: "list",
+      table: tableName,
+      page: 1,
+      sort: sort.column,
+      direction: sort.direction,
+      search: searchValue
+    });
+    navigate({ search: url.startsWith("?") ? url : "" });
+  }
+  async function handleDelete2(id) {
+    const confirmed = await confirm({
+      title: "Delete record",
+      description: `Are you sure you want to delete this ${tableLabel} record?`,
+      variant: "danger",
+      confirmLabel: "Delete"
+    });
+    if (!confirmed) return;
+    const formData = new FormData();
+    formData.set("_action", "delete");
+    formData.set("_table", tableName);
+    formData.set("_id", id);
+    submit(formData, { method: "post" });
+  }
+  return /* @__PURE__ */ jsxs4(Box3, { children: [
+    /* @__PURE__ */ jsxs4(Box3, { sx: { display: "flex", alignItems: "center", justifyContent: "space-between", mb: 2 }, children: [
+      /* @__PURE__ */ jsx4(Typography3, { level: "h2", children: tableLabel }),
+      /* @__PURE__ */ jsx4(
+        Button,
+        {
+          component: Link3,
+          to: buildAdminUrl({ kind: "create", table: tableName }),
+          children: "Create"
+        }
+      )
+    ] }),
+    /* @__PURE__ */ jsx4(ActionResultDisplay, { result: actionResult }),
+    searchable.length > 0 && /* @__PURE__ */ jsx4(Box3, { component: "form", onSubmit: handleSearchSubmit, sx: { mb: 2 }, children: /* @__PURE__ */ jsx4(
+      Input,
+      {
+        placeholder: `Search ${tableLabel.toLowerCase()}...`,
+        value: searchValue,
+        onChange: (e) => setSearchValue(e.target.value),
+        endDecorator: /* @__PURE__ */ jsx4(Button, { type: "submit", variant: "soft", size: "sm", children: "Search" })
+      }
+    ) }),
+    /* @__PURE__ */ jsx4(Sheet3, { variant: "outlined", sx: { borderRadius: "sm", overflow: "auto" }, children: /* @__PURE__ */ jsxs4(Table2, { hoverRow: true, children: [
+      /* @__PURE__ */ jsx4("thead", { children: /* @__PURE__ */ jsxs4("tr", { children: [
+        listColumns.map((col) => /* @__PURE__ */ jsx4("th", { children: /* @__PURE__ */ jsxs4(
+          Typography3,
+          {
+            component: Link3,
+            to: sortUrl(col.name),
+            level: "body-sm",
+            fontWeight: "lg",
+            sx: { textDecoration: "none", color: "inherit" },
+            children: [
+              col.label,
+              sort.column === col.name ? sort.direction === "asc" ? " \u2191" : " \u2193" : ""
+            ]
+          }
+        ) }, col.name)),
+        /* @__PURE__ */ jsx4("th", { style: { width: 120 }, children: "Actions" })
+      ] }) }),
+      /* @__PURE__ */ jsxs4("tbody", { children: [
+        items.map((item) => {
+          const id = String(item[primaryKey] ?? "");
+          return /* @__PURE__ */ jsxs4("tr", { children: [
+            listColumns.map((col) => /* @__PURE__ */ jsx4("td", { children: formatCellValue2(item[col.name]) }, col.name)),
+            /* @__PURE__ */ jsx4("td", { children: /* @__PURE__ */ jsxs4(Stack, { direction: "row", spacing: 1, children: [
+              /* @__PURE__ */ jsx4(
+                Button,
+                {
+                  component: Link3,
+                  to: buildAdminUrl({ kind: "detail", table: tableName, id }),
+                  size: "sm",
+                  variant: "plain",
+                  children: "View"
+                }
+              ),
+              /* @__PURE__ */ jsx4(
+                Button,
+                {
+                  size: "sm",
+                  variant: "plain",
+                  color: "danger",
+                  onClick: () => {
+                    void handleDelete2(id);
+                  },
+                  children: "Delete"
+                }
+              )
+            ] }) })
+          ] }, id);
+        }),
+        items.length === 0 && /* @__PURE__ */ jsx4("tr", { children: /* @__PURE__ */ jsx4("td", { colSpan: listColumns.length + 1, children: /* @__PURE__ */ jsx4(Typography3, { level: "body-sm", textAlign: "center", sx: { py: 2 }, children: "No records found." }) }) })
+      ] })
+    ] }) }),
+    totalPages > 1 && /* @__PURE__ */ jsxs4(Stack, { direction: "row", spacing: 1, justifyContent: "center", alignItems: "center", sx: { mt: 2 }, children: [
+      page > 1 && /* @__PURE__ */ jsx4(
+        Button,
+        {
+          component: Link3,
+          to: buildAdminUrl({
+            kind: "list",
+            table: tableName,
+            page: page - 1,
+            sort: sort.column,
+            direction: sort.direction,
+            search
+          }),
+          size: "sm",
+          variant: "outlined",
+          children: "Previous"
+        }
+      ),
+      /* @__PURE__ */ jsxs4(Typography3, { level: "body-sm", children: [
+        "Page ",
+        page,
+        " of ",
+        totalPages,
+        " (",
+        total,
+        " total)"
+      ] }),
+      page < totalPages && /* @__PURE__ */ jsx4(
+        Button,
+        {
+          component: Link3,
+          to: buildAdminUrl({
+            kind: "list",
+            table: tableName,
+            page: page + 1,
+            sort: sort.column,
+            direction: sort.direction,
+            search
+          }),
+          size: "sm",
+          variant: "outlined",
+          children: "Next"
+        }
+      )
+    ] })
+  ] });
+}
+function formatCellValue2(value) {
+  if (value === null || value === void 0) return "-";
+  if (typeof value === "boolean") return value ? "Yes" : "No";
+  return String(value);
+}
+
+// src/components/table-detail.tsx
+import "react";
+import { Link as Link4, useSubmit as useSubmit2 } from "react-router";
+import Box4 from "@mui/joy/Box";
+import Typography4 from "@mui/joy/Typography";
+import Button2 from "@mui/joy/Button";
+import Card2 from "@mui/joy/Card";
+import Stack2 from "@mui/joy/Stack";
+import { useConfirm as useConfirm2 } from "@cfast/ui";
+import { jsx as jsx5, jsxs as jsxs5 } from "react/jsx-runtime";
+function TableDetail({
+  tableName,
+  tableLabel,
+  item,
+  columns,
+  primaryKey
+}) {
+  const submit = useSubmit2();
+  const confirm = useConfirm2();
+  const id = String(item[primaryKey] ?? "");
+  async function handleDelete2() {
+    const confirmed = await confirm({
+      title: "Delete record",
+      description: `Are you sure you want to delete this ${tableLabel} record?`,
+      variant: "danger",
+      confirmLabel: "Delete"
+    });
+    if (!confirmed) return;
+    const formData = new FormData();
+    formData.set("_action", "delete");
+    formData.set("_table", tableName);
+    formData.set("_id", id);
+    submit(formData, { method: "post" });
+  }
+  return /* @__PURE__ */ jsxs5(Box4, { children: [
+    /* @__PURE__ */ jsxs5(Stack2, { direction: "row", spacing: 1, alignItems: "center", sx: { mb: 2 }, children: [
+      /* @__PURE__ */ jsx5(
+        Typography4,
+        {
+          component: Link4,
+          to: buildAdminUrl({
+            kind: "list",
+            table: tableName,
+            page: 1,
+            sort: null,
+            direction: "desc",
+            search: ""
+          }),
+          level: "body-sm",
+          children: tableLabel
+        }
+      ),
+      /* @__PURE__ */ jsx5(Typography4, { level: "body-sm", children: "/" }),
+      /* @__PURE__ */ jsx5(Typography4, { level: "body-sm", children: id })
+    ] }),
+    /* @__PURE__ */ jsxs5(Box4, { sx: { display: "flex", alignItems: "center", justifyContent: "space-between", mb: 3 }, children: [
+      /* @__PURE__ */ jsxs5(Typography4, { level: "h2", children: [
+        tableLabel,
+        " Detail"
+      ] }),
+      /* @__PURE__ */ jsxs5(Stack2, { direction: "row", spacing: 1, children: [
+        /* @__PURE__ */ jsx5(
+          Button2,
+          {
+            component: Link4,
+            to: buildAdminUrl({ kind: "edit", table: tableName, id }),
+            variant: "outlined",
+            children: "Edit"
+          }
+        ),
+        /* @__PURE__ */ jsx5(
+          Button2,
+          {
+            variant: "outlined",
+            color: "danger",
+            onClick: () => {
+              void handleDelete2();
+            },
+            children: "Delete"
+          }
+        )
+      ] })
+    ] }),
+    /* @__PURE__ */ jsx5(Card2, { variant: "outlined", children: /* @__PURE__ */ jsx5(
+      Box4,
+      {
+        sx: {
+          display: "grid",
+          gridTemplateColumns: { xs: "1fr", md: "1fr 1fr" },
+          gap: 2
+        },
+        children: columns.map((col) => /* @__PURE__ */ jsxs5(Box4, { children: [
+          /* @__PURE__ */ jsx5(Typography4, { level: "body-xs", textColor: "text.secondary", fontWeight: "lg", children: col.label }),
+          /* @__PURE__ */ jsx5(Typography4, { level: "body-md", children: formatFieldValue(item[col.name]) })
+        ] }, col.name))
+      }
+    ) })
+  ] });
+}
+function formatFieldValue(value) {
+  if (value === null || value === void 0) return "-";
+  if (typeof value === "boolean") return value ? "Yes" : "No";
+  if (value instanceof Date) return value.toLocaleString();
+  return String(value);
+}
+
+// src/components/table-form.tsx
+import "react";
+import { Link as Link5, useSubmit as useSubmit3 } from "react-router";
+import Box5 from "@mui/joy/Box";
+import Typography5 from "@mui/joy/Typography";
+import Stack3 from "@mui/joy/Stack";
+import { AutoForm } from "@cfast/forms/joy";
+import { Fragment, jsx as jsx6, jsxs as jsxs6 } from "react/jsx-runtime";
+var AUTO_TIMESTAMP_NAMES = /* @__PURE__ */ new Set([
+  "created_at",
+  "createdAt",
+  "updated_at",
+  "updatedAt"
+]);
+function TableForm({
+  tableName,
+  tableLabel,
+  mode,
+  drizzleTable,
+  item,
+  columns,
+  primaryKey,
+  actionResult
+}) {
+  const submit = useSubmit3();
+  const id = item ? String(item[primaryKey] ?? "") : void 0;
+  const excludeFields = columns.filter((c) => c.isPrimaryKey || AUTO_TIMESTAMP_NAMES.has(c.name)).map((c) => c.name);
+  function handleSubmit(values) {
+    const formData = new FormData();
+    formData.set("_action", mode === "create" ? "create" : "update");
+    formData.set("_table", tableName);
+    if (id) {
+      formData.set("_id", id);
+    }
+    for (const [key, value] of Object.entries(values)) {
+      if (value !== null && value !== void 0) {
+        formData.set(key, String(value));
+      }
+    }
+    submit(formData, { method: "post" });
+  }
+  const listUrl = buildAdminUrl({
+    kind: "list",
+    table: tableName,
+    page: 1,
+    sort: null,
+    direction: "desc",
+    search: ""
+  });
+  return /* @__PURE__ */ jsxs6(Box5, { children: [
+    /* @__PURE__ */ jsxs6(Stack3, { direction: "row", spacing: 1, alignItems: "center", sx: { mb: 2 }, children: [
+      /* @__PURE__ */ jsx6(Typography5, { component: Link5, to: listUrl, level: "body-sm", children: tableLabel }),
+      /* @__PURE__ */ jsx6(Typography5, { level: "body-sm", children: "/" }),
+      mode === "edit" && id ? /* @__PURE__ */ jsxs6(Fragment, { children: [
+        /* @__PURE__ */ jsx6(
+          Typography5,
+          {
+            component: Link5,
+            to: buildAdminUrl({ kind: "detail", table: tableName, id }),
+            level: "body-sm",
+            children: id
+          }
+        ),
+        /* @__PURE__ */ jsx6(Typography5, { level: "body-sm", children: "/" }),
+        /* @__PURE__ */ jsx6(Typography5, { level: "body-sm", children: "Edit" })
+      ] }) : /* @__PURE__ */ jsx6(Typography5, { level: "body-sm", children: "Create" })
+    ] }),
+    /* @__PURE__ */ jsx6(Typography5, { level: "h2", sx: { mb: 3 }, children: mode === "create" ? `Create ${tableLabel}` : `Edit ${tableLabel}` }),
+    /* @__PURE__ */ jsx6(ActionResultDisplay, { result: actionResult }),
+    /* @__PURE__ */ jsx6(
+      AutoForm,
+      {
+        table: drizzleTable,
+        mode,
+        data: item,
+        onSubmit: handleSubmit,
+        exclude: excludeFields
+      }
+    )
+  ] });
+}
+
+// src/components/user-list.tsx
+import { useState as useState2 } from "react";
+import { Link as Link6, useSubmit as useSubmit4, useNavigate as useNavigate2 } from "react-router";
+import Box6 from "@mui/joy/Box";
+import Typography6 from "@mui/joy/Typography";
+import Button3 from "@mui/joy/Button";
+import Input2 from "@mui/joy/Input";
+import Table3 from "@mui/joy/Table";
+import Sheet4 from "@mui/joy/Sheet";
+import Stack4 from "@mui/joy/Stack";
+import { RoleBadge } from "@cfast/ui/joy";
+import { jsx as jsx7, jsxs as jsxs7 } from "react/jsx-runtime";
+function UserList({
+  items,
+  total,
+  page,
+  totalPages,
+  search,
+  currentUser,
+  actionResult
+}) {
+  const submit = useSubmit4();
+  const navigate = useNavigate2();
+  const [searchValue, setSearchValue] = useState2(search);
+  function handleSearchSubmit(e) {
+    e.preventDefault();
+    const url = buildAdminUrl({
+      kind: "user-list",
+      page: 1,
+      search: searchValue
+    });
+    navigate({ search: url.startsWith("?") ? url : "" });
+  }
+  function handleImpersonate2(userId) {
+    const formData = new FormData();
+    formData.set("_action", "impersonate");
+    formData.set("_id", userId);
+    submit(formData, { method: "post" });
+  }
+  return /* @__PURE__ */ jsxs7(Box6, { children: [
+    /* @__PURE__ */ jsx7(Typography6, { level: "h2", sx: { mb: 2 }, children: "Users" }),
+    /* @__PURE__ */ jsx7(ActionResultDisplay, { result: actionResult }),
+    /* @__PURE__ */ jsx7(Box6, { component: "form", onSubmit: handleSearchSubmit, sx: { mb: 2 }, children: /* @__PURE__ */ jsx7(
+      Input2,
+      {
+        placeholder: "Search users...",
+        value: searchValue,
+        onChange: (e) => setSearchValue(e.target.value),
+        endDecorator: /* @__PURE__ */ jsx7(Button3, { type: "submit", variant: "soft", size: "sm", children: "Search" })
+      }
+    ) }),
+    /* @__PURE__ */ jsx7(Sheet4, { variant: "outlined", sx: { borderRadius: "sm", overflow: "auto" }, children: /* @__PURE__ */ jsxs7(Table3, { hoverRow: true, children: [
+      /* @__PURE__ */ jsx7("thead", { children: /* @__PURE__ */ jsxs7("tr", { children: [
+        /* @__PURE__ */ jsx7("th", { children: "Name" }),
+        /* @__PURE__ */ jsx7("th", { children: "Email" }),
+        /* @__PURE__ */ jsx7("th", { children: "Roles" }),
+        /* @__PURE__ */ jsx7("th", { children: "Joined" }),
+        /* @__PURE__ */ jsx7("th", { style: { width: 160 }, children: "Actions" })
+      ] }) }),
+      /* @__PURE__ */ jsxs7("tbody", { children: [
+        items.map((user) => /* @__PURE__ */ jsxs7("tr", { children: [
+          /* @__PURE__ */ jsx7("td", { children: user.name }),
+          /* @__PURE__ */ jsx7("td", { children: user.email }),
+          /* @__PURE__ */ jsx7("td", { children: /* @__PURE__ */ jsxs7(Stack4, { direction: "row", spacing: 0.5, flexWrap: "wrap", children: [
+            user.roles.map((role) => /* @__PURE__ */ jsx7(RoleBadge, { role }, role)),
+            user.roles.length === 0 && /* @__PURE__ */ jsx7(Typography6, { level: "body-xs", textColor: "text.tertiary", children: "No roles" })
+          ] }) }),
+          /* @__PURE__ */ jsx7("td", { children: user.createdAt ?? "-" }),
+          /* @__PURE__ */ jsx7("td", { children: /* @__PURE__ */ jsxs7(Stack4, { direction: "row", spacing: 1, children: [
+            /* @__PURE__ */ jsx7(
+              Button3,
+              {
+                component: Link6,
+                to: buildAdminUrl({ kind: "user-detail", id: user.id }),
+                size: "sm",
+                variant: "plain",
+                children: "View"
+              }
+            ),
+            user.id !== currentUser.id && /* @__PURE__ */ jsx7(
+              Button3,
+              {
+                size: "sm",
+                variant: "plain",
+                color: "warning",
+                onClick: () => handleImpersonate2(user.id),
+                children: "Impersonate"
+              }
+            )
+          ] }) })
+        ] }, user.id)),
+        items.length === 0 && /* @__PURE__ */ jsx7("tr", { children: /* @__PURE__ */ jsx7("td", { colSpan: 5, children: /* @__PURE__ */ jsx7(Typography6, { level: "body-sm", textAlign: "center", sx: { py: 2 }, children: "No users found." }) }) })
+      ] })
+    ] }) }),
+    totalPages > 1 && /* @__PURE__ */ jsxs7(Stack4, { direction: "row", spacing: 1, justifyContent: "center", alignItems: "center", sx: { mt: 2 }, children: [
+      page > 1 && /* @__PURE__ */ jsx7(
+        Button3,
+        {
+          component: Link6,
+          to: buildAdminUrl({
+            kind: "user-list",
+            page: page - 1,
+            search
+          }),
+          size: "sm",
+          variant: "outlined",
+          children: "Previous"
+        }
+      ),
+      /* @__PURE__ */ jsxs7(Typography6, { level: "body-sm", children: [
+        "Page ",
+        page,
+        " of ",
+        totalPages,
+        " (",
+        total,
+        " total)"
+      ] }),
+      page < totalPages && /* @__PURE__ */ jsx7(
+        Button3,
+        {
+          component: Link6,
+          to: buildAdminUrl({
+            kind: "user-list",
+            page: page + 1,
+            search
+          }),
+          size: "sm",
+          variant: "outlined",
+          children: "Next"
+        }
+      )
+    ] })
+  ] });
+}
+
+// src/components/user-detail.tsx
+import { useState as useState3 } from "react";
+import { Link as Link7, useSubmit as useSubmit5 } from "react-router";
+import Box7 from "@mui/joy/Box";
+import Typography7 from "@mui/joy/Typography";
+import Button4 from "@mui/joy/Button";
+import Card3 from "@mui/joy/Card";
+import Stack5 from "@mui/joy/Stack";
+import Chip2 from "@mui/joy/Chip";
+import Select from "@mui/joy/Select";
+import Option from "@mui/joy/Option";
+import Divider2 from "@mui/joy/Divider";
+import { RoleBadge as RoleBadge2, AvatarWithInitials } from "@cfast/ui/joy";
+import { Fragment as Fragment2, jsx as jsx8, jsxs as jsxs8 } from "react/jsx-runtime";
+function UserDetail({
+  targetUser,
+  assignableRoles,
+  currentUser,
+  actionResult
+}) {
+  const submit = useSubmit5();
+  const [selectedRole, setSelectedRole] = useState3(null);
+  const availableRoles = assignableRoles.filter(
+    (role) => !targetUser.roles.includes(role)
+  );
+  function handleAddRole() {
+    if (!selectedRole) return;
+    const formData = new FormData();
+    formData.set("_action", "setRole");
+    formData.set("_id", targetUser.id);
+    formData.set("role", selectedRole);
+    submit(formData, { method: "post" });
+    setSelectedRole(null);
+  }
+  function handleRemoveRole2(role) {
+    const formData = new FormData();
+    formData.set("_action", "removeRole");
+    formData.set("_id", targetUser.id);
+    formData.set("role", role);
+    submit(formData, { method: "post" });
+  }
+  function handleImpersonate2() {
+    const formData = new FormData();
+    formData.set("_action", "impersonate");
+    formData.set("_id", targetUser.id);
+    submit(formData, { method: "post" });
+  }
+  return /* @__PURE__ */ jsxs8(Box7, { children: [
+    /* @__PURE__ */ jsxs8(Stack5, { direction: "row", spacing: 1, alignItems: "center", sx: { mb: 2 }, children: [
+      /* @__PURE__ */ jsx8(
+        Typography7,
+        {
+          component: Link7,
+          to: buildAdminUrl({ kind: "user-list", page: 1, search: "" }),
+          level: "body-sm",
+          children: "Users"
+        }
+      ),
+      /* @__PURE__ */ jsx8(Typography7, { level: "body-sm", children: "/" }),
+      /* @__PURE__ */ jsx8(Typography7, { level: "body-sm", children: targetUser.name })
+    ] }),
+    /* @__PURE__ */ jsx8(ActionResultDisplay, { result: actionResult }),
+    /* @__PURE__ */ jsx8(Card3, { variant: "outlined", sx: { mb: 3 }, children: /* @__PURE__ */ jsxs8(Stack5, { direction: "row", spacing: 2, alignItems: "center", children: [
+      /* @__PURE__ */ jsx8(
+        AvatarWithInitials,
+        {
+          src: targetUser.avatarUrl,
+          name: targetUser.name,
+          size: "lg"
+        }
+      ),
+      /* @__PURE__ */ jsxs8(Box7, { children: [
+        /* @__PURE__ */ jsx8(Typography7, { level: "h3", children: targetUser.name }),
+        /* @__PURE__ */ jsx8(Typography7, { level: "body-md", textColor: "text.secondary", children: targetUser.email }),
+        targetUser.createdAt && /* @__PURE__ */ jsxs8(Typography7, { level: "body-xs", textColor: "text.tertiary", children: [
+          "Joined ",
+          targetUser.createdAt
+        ] })
+      ] }),
+      targetUser.id !== currentUser.id && /* @__PURE__ */ jsx8(Box7, { sx: { ml: "auto" }, children: /* @__PURE__ */ jsx8(
+        Button4,
+        {
+          variant: "outlined",
+          color: "warning",
+          onClick: handleImpersonate2,
+          children: "Impersonate"
+        }
+      ) })
+    ] }) }),
+    /* @__PURE__ */ jsxs8(Card3, { variant: "outlined", children: [
+      /* @__PURE__ */ jsx8(Typography7, { level: "title-lg", sx: { mb: 2 }, children: "Roles" }),
+      /* @__PURE__ */ jsxs8(Stack5, { direction: "row", spacing: 1, flexWrap: "wrap", sx: { mb: 2 }, children: [
+        targetUser.roles.map((role) => /* @__PURE__ */ jsx8(
+          Chip2,
+          {
+            variant: "soft",
+            endDecorator: /* @__PURE__ */ jsx8(
+              Button4,
+              {
+                size: "sm",
+                variant: "plain",
+                color: "danger",
+                sx: { minWidth: 0, px: 0.5 },
+                onClick: () => handleRemoveRole2(role),
+                children: "x"
+              }
+            ),
+            children: /* @__PURE__ */ jsx8(RoleBadge2, { role })
+          },
+          role
+        )),
+        targetUser.roles.length === 0 && /* @__PURE__ */ jsx8(Typography7, { level: "body-sm", textColor: "text.tertiary", children: "No roles assigned." })
+      ] }),
+      availableRoles.length > 0 && /* @__PURE__ */ jsxs8(Fragment2, { children: [
+        /* @__PURE__ */ jsx8(Divider2, { sx: { my: 2 } }),
+        /* @__PURE__ */ jsxs8(Stack5, { direction: "row", spacing: 1, alignItems: "center", children: [
+          /* @__PURE__ */ jsx8(
+            Select,
+            {
+              placeholder: "Select role...",
+              value: selectedRole,
+              onChange: (_e, value) => setSelectedRole(value),
+              sx: { minWidth: 200 },
+              children: availableRoles.map((role) => /* @__PURE__ */ jsx8(Option, { value: role, children: role }, role))
+            }
+          ),
+          /* @__PURE__ */ jsx8(
+            Button4,
+            {
+              onClick: handleAddRole,
+              disabled: !selectedRole,
+              size: "sm",
+              children: "Add Role"
+            }
+          )
+        ] })
+      ] })
+    ] })
+  ] });
+}
+
+// src/components/admin-root.tsx
+import { jsx as jsx9, jsxs as jsxs9 } from "react/jsx-runtime";
+function createAdminComponent(tableMetas) {
+  const tableMetaMap = new Map(tableMetas.map((m) => [m.name, m]));
+  function AdminRoot() {
+    const data = useLoaderData();
+    const actionData = useActionData();
+    return /* @__PURE__ */ jsxs9(ConfirmProvider, { children: [
+      data.user.isImpersonating && /* @__PURE__ */ jsx9(ImpersonationBar, { user: data.user }),
+      /* @__PURE__ */ jsxs9(Box8, { sx: { display: "flex", minHeight: "100vh" }, children: [
+        /* @__PURE__ */ jsx9(Sidebar, { tables: data.tables }),
+        /* @__PURE__ */ jsx9(Box8, { sx: { flex: 1, p: 3, overflow: "auto" }, children: /* @__PURE__ */ jsx9(
+          AdminContent,
+          {
+            data,
+            actionResult: actionData,
+            tableMetaMap
+          }
+        ) })
+      ] })
+    ] });
+  }
+  return AdminRoot;
+}
+function AdminContent({ data, actionResult, tableMetaMap }) {
+  switch (data.view) {
+    case "dashboard":
+      return /* @__PURE__ */ jsx9(Dashboard, { stats: data.stats, recentItems: data.recentItems });
+    case "list": {
+      const meta = tableMetaMap.get(data.tableName);
+      const primaryKey = meta?.primaryKey ?? "id";
+      return /* @__PURE__ */ jsx9(
+        TableList,
+        {
+          tableName: data.tableName,
+          tableLabel: data.tableLabel,
+          items: data.items,
+          total: data.total,
+          page: data.page,
+          totalPages: data.totalPages,
+          columns: data.columns,
+          searchable: data.searchable,
+          sort: data.sort,
+          search: data.search,
+          primaryKey,
+          actionResult
+        }
+      );
+    }
+    case "detail": {
+      const meta = tableMetaMap.get(data.tableName);
+      const primaryKey = meta?.primaryKey ?? "id";
+      return /* @__PURE__ */ jsx9(
+        TableDetail,
+        {
+          tableName: data.tableName,
+          tableLabel: data.tableLabel,
+          item: data.item,
+          columns: data.columns,
+          primaryKey
+        }
+      );
+    }
+    case "create": {
+      const meta = tableMetaMap.get(data.tableName);
+      if (!meta) {
+        return /* @__PURE__ */ jsx9(Box8, { sx: { p: 4 }, children: /* @__PURE__ */ jsxs9(Typography8, { color: "danger", children: [
+          "Table \u201C",
+          data.tableName,
+          "\u201D not found in schema."
+        ] }) });
+      }
+      return /* @__PURE__ */ jsx9(
+        TableForm,
+        {
+          tableName: data.tableName,
+          tableLabel: data.tableLabel,
+          mode: "create",
+          drizzleTable: meta.drizzleTable,
+          columns: data.columns,
+          primaryKey: meta.primaryKey,
+          actionResult
+        }
+      );
+    }
+    case "edit": {
+      const meta = tableMetaMap.get(data.tableName);
+      if (!meta) {
+        return /* @__PURE__ */ jsx9(Box8, { sx: { p: 4 }, children: /* @__PURE__ */ jsxs9(Typography8, { color: "danger", children: [
+          "Table \u201C",
+          data.tableName,
+          "\u201D not found in schema."
+        ] }) });
+      }
+      return /* @__PURE__ */ jsx9(
+        TableForm,
+        {
+          tableName: data.tableName,
+          tableLabel: data.tableLabel,
+          mode: "edit",
+          drizzleTable: meta.drizzleTable,
+          item: data.item,
+          columns: data.columns,
+          primaryKey: meta.primaryKey,
+          actionResult
+        }
+      );
+    }
+    case "users":
+      return /* @__PURE__ */ jsx9(
+        UserList,
+        {
+          items: data.items,
+          total: data.total,
+          page: data.page,
+          totalPages: data.totalPages,
+          search: data.search,
+          currentUser: data.user,
+          actionResult
+        }
+      );
+    case "user-detail":
+      return /* @__PURE__ */ jsx9(
+        UserDetail,
+        {
+          targetUser: data.targetUser,
+          assignableRoles: data.assignableRoles,
+          currentUser: data.user,
+          actionResult
+        }
+      );
+    case "error":
+      return /* @__PURE__ */ jsxs9(Box8, { sx: { p: 4, textAlign: "center" }, children: [
+        /* @__PURE__ */ jsx9(Typography8, { level: "h3", color: "danger", children: "Error" }),
+        /* @__PURE__ */ jsx9(Typography8, { level: "body-md", sx: { mt: 1 }, children: data.message })
+      ] });
+  }
+}
+function ImpersonationBar({ user }) {
+  const submit = useSubmit6();
+  function handleStopImpersonation() {
+    const formData = new FormData();
+    formData.set("_action", "stopImpersonation");
+    submit(formData, { method: "post" });
+  }
+  return /* @__PURE__ */ jsxs9(
+    Box8,
+    {
+      sx: {
+        bgcolor: "warning.softBg",
+        color: "warning.softColor",
+        py: 1,
+        px: 3,
+        display: "flex",
+        alignItems: "center",
+        justifyContent: "center",
+        gap: 2
+      },
+      children: [
+        /* @__PURE__ */ jsxs9(Typography8, { level: "body-sm", fontWeight: "lg", children: [
+          "Impersonating ",
+          user.name,
+          " (",
+          user.email,
+          ")",
+          user.realUser && ` \u2014 logged in as ${user.realUser.name}`
+        ] }),
+        /* @__PURE__ */ jsx9(
+          Button5,
+          {
+            size: "sm",
+            variant: "solid",
+            color: "warning",
+            onClick: handleStopImpersonation,
+            children: "Stop Impersonation"
+          }
+        )
+      ]
+    }
+  );
+}
+
+// src/create-admin.ts
+function createAdmin(config) {
+  const tableMetas = introspectSchema(config.schema, config.tables);
+  const loader = createAdminLoader(config, tableMetas);
+  const action = createAdminAction(config, tableMetas);
+  const Component = createAdminComponent(tableMetas);
+  return { loader, action, Component };
+}
+export {
+  createAdmin,
+  createAdminAction,
+  createAdminComponent,
+  createAdminLoader,
+  introspectSchema
+};