appflare 0.2.5 → 0.2.7

package/cli/templates/dashboard/builders/table-routes/helpers.ts

@@ -0,0 +1,49 @@
+import { DiscoveredTable } from "../../types";
+
+export function resolvePrimaryKey(table: DiscoveredTable): string {
+	return (
+		table.columns.find((column) => column.primaryKey)?.name ||
+		table.columns[0]?.name ||
+		""
+	);
+}
+
+function hasColumnDefault(expression: string): boolean {
+	return /\.default\s*\(/i.test(expression);
+}
+
+export function shouldIncludeCreateField(
+	table: DiscoveredTable,
+	columnName: string,
+): boolean {
+	const column = table.columns.find((item) => item.name === columnName);
+	if (!column) {
+		return false;
+	}
+
+	if (column.autoIncrement) {
+		return false;
+	}
+
+	if (column.primaryKey && hasColumnDefault(column.expression)) {
+		return false;
+	}
+
+	return true;
+}
+
+export function shouldIncludeEditField(
+	table: DiscoveredTable,
+	columnName: string,
+): boolean {
+	const column = table.columns.find((item) => item.name === columnName);
+	if (!column) {
+		return false;
+	}
+
+	if (column.primaryKey || column.autoIncrement) {
+		return false;
+	}
+
+	return true;
+}

package/cli/templates/dashboard/builders/table-routes/index.ts

@@ -0,0 +1,8 @@
+import { DiscoveredSchema } from "../../../../utils/schema-discovery";
+import { buildTableRoute } from "./table-route";
+import { buildUsersRoute } from "./users-route";
+
+export function buildTableRoutes(schema: DiscoveredSchema): string {
+	return `${schema.tables.map((table) => buildTableRoute(table)).join("\n")}
+${buildUsersRoute()}`;
+}

package/cli/templates/dashboard/builders/table-routes/table/actions-cell.ts

@@ -0,0 +1,71 @@
+import { DiscoveredTable } from "../../../types";
+
+/**
+ * Builds the actions cell HTML string (a build-time template string) for a table row.
+ * PocketBase-style with icon-based edit and a ⋯ dropdown for delete.
+ */
+export function buildActionsCell(
+	table: DiscoveredTable,
+	hasPrimaryKey: boolean,
+	primaryKey: string,
+	editInputs: string,
+): string {
+	if (!hasPrimaryKey) {
+		return `<td class="text-right"><span class="text-xs opacity-30">No primary key</span></td>`;
+	}
+
+	return `<td class="text-right">
+\t\t<div class="drawer drawer-end">
+\t\t\t<input id="edit-drawer-${table.exportName}-\${rowIndex}" type="checkbox" class="drawer-toggle" />
+\t\t\t<div class="drawer-content">
+\t\t\t\t<div class="flex items-center justify-end gap-1">
+\t\t\t\t\t<label for="edit-drawer-${table.exportName}-\${rowIndex}" class="btn btn-ghost btn-xs btn-square" title="Edit">
+\t\t\t\t\t\t<iconify-icon icon="mdi:pencil-outline" width="15" height="15" class="opacity-50"></iconify-icon>
+\t\t\t\t\t</label>
+\t\t\t\t\t<button type="button" class="btn btn-ghost btn-xs btn-square" title="Delete" onclick="document.getElementById('delete-dialog-${table.exportName}-\${rowIndex}').showModal()">
+\t\t\t\t\t\t<iconify-icon icon="mdi:delete-outline" width="15" height="15" class="opacity-50 hover:text-error"></iconify-icon>
+\t\t\t\t\t</button>
+\t\t\t\t</div>
+\t\t\t\t<dialog id="delete-dialog-${table.exportName}-\${rowIndex}" class="modal">
+\t\t\t\t\t<div class="modal-box max-w-sm">
+\t\t\t\t\t\t<h3 class="font-semibold text-base">Delete record?</h3>
+\t\t\t\t\t\t<p class="py-3 text-sm text-base-content/60">This action cannot be undone.</p>
+\t\t\t\t\t\t<div class="modal-action">
+\t\t\t\t\t\t\t<form method="dialog">
+\t\t\t\t\t\t\t\t<button class="btn btn-ghost btn-sm">Cancel</button>
+\t\t\t\t\t\t\t</form>
+\t\t\t\t\t\t\t<form hx-post="/admin/table/${table.exportName}/delete" hx-target="#main-content" hx-swap="outerHTML" class="inline">
+\t\t\t\t\t\t\t\t<input type="hidden" name="${primaryKey}" value="\${String((row as any).${primaryKey} ?? '')}" />
+\t\t\t\t\t\t\t\t<input type="hidden" name="sort" value="\${sort}" />
+\t\t\t\t\t\t\t\t<input type="hidden" name="order" value="\${order}" />
+\t\t\t\t\t\t\t\t<input type="hidden" name="search" value="\${search}" />
+\t\t\t\t\t\t\t\t<input type="hidden" name="page" value="\${page}" />
+\t\t\t\t\t\t\t\t<button type="submit" class="btn btn-error btn-sm">Delete</button>
+\t\t\t\t\t\t\t</form>
+\t\t\t\t\t\t</div>
+\t\t\t\t\t</div>
+\t\t\t\t</dialog>
+\t\t\t</div>
+\t\t\t<div class="drawer-side z-50">
+\t\t\t\t<label for="edit-drawer-${table.exportName}-\${rowIndex}" aria-label="close sidebar" class="drawer-overlay"></label>
+\t\t\t\t<div class="w-full max-w-md min-h-full bg-base-100 p-6 border-l border-base-200 overflow-y-auto shadow-lg">
+\t\t\t\t\t<div class="flex justify-between items-center mb-5">
+\t\t\t\t\t\t<h3 class="text-base font-semibold">Edit ${table.tableName}</h3>
+\t\t\t\t\t\t<label for="edit-drawer-${table.exportName}-\${rowIndex}" class="btn btn-sm btn-ghost btn-square">
+\t\t\t\t\t\t\t<iconify-icon icon="mdi:close" width="18" height="18"></iconify-icon>
+\t\t\t\t\t\t</label>
+\t\t\t\t\t</div>
+\t\t\t\t\t<form hx-post="/admin/table/${table.exportName}/edit" hx-target="#main-content" hx-swap="outerHTML" class="flex flex-col gap-4">
+\t\t\t\t\t\t<input type="hidden" name="${primaryKey}" value="\${String((row as any).${primaryKey} ?? '')}" />
+\t\t\t\t\t\t<input type="hidden" name="sort" value="\${sort}" />
+\t\t\t\t\t\t<input type="hidden" name="order" value="\${order}" />
+\t\t\t\t\t\t<input type="hidden" name="search" value="\${search}" />
+\t\t\t\t\t\t<input type="hidden" name="page" value="\${page}" />
+\t\t\t\t\t\t${editInputs}
+\t\t\t\t\t\t<button type="submit" class="btn btn-primary btn-sm mt-2">Save changes</button>
+\t\t\t\t\t</form>
+\t\t\t\t</div>
+\t\t\t</div>
+\t\t</div>
+\t</td>`;
+}

package/cli/templates/dashboard/builders/table-routes/table/get-route.ts

@@ -0,0 +1,166 @@
+import { DiscoveredTable } from "../../../types";
+import { buildColumnHeaders, buildRowCells } from "../fragments";
+import { buildPaginationHtml } from "../common/pagination";
+import { buildSearchBarHtml } from "../common/search-bar";
+import { buildActionsCell } from "./actions-cell";
+import { resolvePrimaryKey } from "../helpers";
+import { buildFieldInput, buildSearchConditions } from "../fragments";
+import { shouldIncludeEditField, shouldIncludeCreateField } from "../helpers";
+
+/**
+ * Builds the GET route handler code string for /admin/table/:tableName
+ * PocketBase-style layout with breadcrumb header, filter bar, and clean table.
+ */
+export function buildTableGetRoute(
+	table: DiscoveredTable,
+	defaultSort: string,
+	columns: string[],
+	searchConditions: string,
+	headers: string,
+	rowCells: string,
+	actionsCell: string,
+	createInputs: string,
+): string {
+	const paginationHtml = buildPaginationHtml(
+		`/admin/table/${table.exportName}`,
+	);
+	const searchBarHtml = buildSearchBarHtml(
+		`/admin/table/${table.exportName}`,
+		"Search term or filter...",
+	);
+
+	return `
+\tadminApp.get('/table/${table.exportName}', async (c) => {
+\t\tconst db = drizzle(c.env[options.databaseBinding], { schema });
+\t\tconst page = parseInt(c.req.query('page') || '1');
+\t\tconst limit = 20;
+\t\tconst offset = (page - 1) * limit;
+\t\tconst sort = c.req.query('sort') || '${defaultSort}';
+\t\tconst order = c.req.query('order') || 'desc';
+\t\tconst search = c.req.query('search') || '';
+
+\t\tlet tableSchema = (schema as any).${table.exportName};
+\t\tif (!tableSchema) return c.text("Table missing", 404);
+
+\t\tlet query = db.select().from(tableSchema);
+\t\tlet countQuery = db.select({ count: sql\`count(*)\` }).from(tableSchema);
+
+\t\tif (search) {
+\t\t\tconst searchConditions = [];
+\t\t\t${searchConditions}
+\t\t\tif (searchConditions.length > 0) {
+\t\t\t\tquery = query.where(or(...searchConditions)) as any;
+\t\t\t\tcountQuery = countQuery.where(or(...searchConditions)) as any;
+\t\t\t}
+\t\t}
+
+\t\tif (sort && tableSchema[sort]) {
+\t\t\tquery = query.orderBy(order === 'asc' ? asc(tableSchema[sort]) : desc(tableSchema[sort])) as any;
+\t\t}
+
+\t\tconst data = await query.limit(limit).offset(offset).execute();
+\t\tconst totalResult = await countQuery.execute();
+\t\tconst total = Number(totalResult[0]?.count || 0);
+\t\tconst totalPages = Math.ceil(total / limit);
+
+\t\tconst tableHtml = html\`
+\t\t\t<div class="bg-base-100 rounded-xl border border-base-200 overflow-hidden">
+\t\t\t\t<div class="overflow-x-auto">
+\t\t\t\t\t<table class="table table-sm md:table-md w-full">
+\t\t\t\t\t\t<thead>
+\t\t\t\t\t\t\t<tr class="border-b border-base-200">
+\t\t\t\t\t\t\t\t<th class="w-10"><input type="checkbox" class="checkbox checkbox-xs opacity-30" disabled /></th>
+\t\t\t\t\t\t\t\t${headers}
+\t\t\t\t\t\t\t\t<th class="w-[100px] text-right">
+\t\t\t\t\t\t\t\t\t<iconify-icon icon="mdi:dots-horizontal" width="16" height="16" class="opacity-30"></iconify-icon>
+\t\t\t\t\t\t\t\t</th>
+\t\t\t\t\t\t\t</tr>
+\t\t\t\t\t\t</thead>
+\t\t\t\t\t\t<tbody>
+\t\t\t\t\t\t\t\${data.map((row, rowIndex) => html\`
+\t\t\t\t\t\t\t<tr class="hover:bg-base-200/30 transition-colors">
+\t\t\t\t\t\t\t\t<td><input type="checkbox" class="checkbox checkbox-xs" /></td>
+\t\t\t\t\t\t\t\t${rowCells}
+\t\t\t\t\t\t\t\t${actionsCell}
+\t\t\t\t\t\t\t</tr>
+\t\t\t\t\t\t\t\`)}
+\t\t\t\t\t\t\t\${data.length === 0 ? html\`
+\t\t\t\t\t\t\t\t<tr>
+\t\t\t\t\t\t\t\t\t<td colspan="${columns.length + 2}" class="text-center py-12">
+\t\t\t\t\t\t\t\t\t\t<div class="flex flex-col items-center gap-3">
+\t\t\t\t\t\t\t\t\t\t\t<iconify-icon icon="mdi:database-off-outline" width="40" height="40" class="opacity-20"></iconify-icon>
+\t\t\t\t\t\t\t\t\t\t\t<p class="text-sm text-base-content/40">No records found.</p>
+\t\t\t\t\t\t\t\t\t\t\t<label for="create-drawer-${table.exportName}" class="btn btn-sm btn-primary gap-1">
+\t\t\t\t\t\t\t\t\t\t\t\t<iconify-icon icon="mdi:plus" width="16" height="16"></iconify-icon>
+\t\t\t\t\t\t\t\t\t\t\t\tNew record
+\t\t\t\t\t\t\t\t\t\t\t</label>
+\t\t\t\t\t\t\t\t\t\t</div>
+\t\t\t\t\t\t\t\t\t</td>
+\t\t\t\t\t\t\t\t</tr>
+\t\t\t\t\t\t\t\` : ''}
+\t\t\t\t\t\t</tbody>
+\t\t\t\t\t</table>
+\t\t\t\t</div>
+\t\t\t\t${paginationHtml}
+\t\t\t</div>
+\t\t\`;
+
+\t\tconst content = html\`
+\t\t\t<div id="main-content">
+\t\t\t\t<div class="drawer drawer-end">
+\t\t\t\t\t<input id="create-drawer-${table.exportName}" type="checkbox" class="drawer-toggle" />
+\t\t\t\t\t<div class="drawer-content">
+\t\t\t\t\t\t<div class="flex flex-col md:flex-row justify-between items-start md:items-center mb-5 gap-3">
+\t\t\t\t\t\t\t<div class="flex items-center gap-2 text-sm">
+\t\t\t\t\t\t\t\t<a href="/admin" class="text-base-content/40 hover:text-primary transition-colors">Collections</a>
+\t\t\t\t\t\t\t\t<iconify-icon icon="mdi:chevron-right" width="14" height="14" class="opacity-30"></iconify-icon>
+\t\t\t\t\t\t\t\t<span class="font-semibold capitalize">${table.tableName}</span>
+\t\t\t\t\t\t\t\t<button class="btn btn-ghost btn-xs btn-square opacity-40 hover:opacity-100" onclick="window.location.reload()">
+\t\t\t\t\t\t\t\t\t<iconify-icon icon="mdi:refresh" width="14" height="14"></iconify-icon>
+\t\t\t\t\t\t\t\t</button>
+\t\t\t\t\t\t\t</div>
+\t\t\t\t\t\t\t<div class="flex items-center gap-2 w-full md:w-auto">
+\t\t\t\t\t\t\t\t<label for="create-drawer-${table.exportName}" class="btn btn-primary btn-sm gap-1">
+\t\t\t\t\t\t\t\t\t<iconify-icon icon="mdi:plus" width="16" height="16"></iconify-icon>
+\t\t\t\t\t\t\t\t\tNew record
+\t\t\t\t\t\t\t\t</label>
+\t\t\t\t\t\t\t</div>
+\t\t\t\t\t\t</div>
+\t\t\t\t\t\t<div class="mb-4">
+\t\t\t\t\t\t\t${searchBarHtml}
+\t\t\t\t\t\t</div>
+\t\t\t\t\t\t\${tableHtml}
+\t\t\t\t\t</div>
+\t\t\t\t\t<div class="drawer-side z-50">
+\t\t\t\t\t\t<label for="create-drawer-${table.exportName}" aria-label="close sidebar" class="drawer-overlay"></label>
+\t\t\t\t\t\t<div class="w-full max-w-md min-h-full bg-base-100 p-6 border-l border-base-200 overflow-y-auto shadow-lg">
+\t\t\t\t\t\t\t<div class="flex justify-between items-center mb-5">
+\t\t\t\t\t\t\t\t<h3 class="text-base font-semibold">Create ${table.tableName}</h3>
+\t\t\t\t\t\t\t\t<label for="create-drawer-${table.exportName}" class="btn btn-sm btn-ghost btn-square">
+\t\t\t\t\t\t\t\t\t<iconify-icon icon="mdi:close" width="18" height="18"></iconify-icon>
+\t\t\t\t\t\t\t\t</label>
+\t\t\t\t\t\t\t</div>
+\t\t\t\t\t\t\t<form hx-post="/admin/table/${table.exportName}/create" hx-target="#main-content" hx-swap="outerHTML" class="flex flex-col gap-4">
+\t\t\t\t\t\t\t\t<input type="hidden" name="sort" value="\${sort}" />
+\t\t\t\t\t\t\t\t<input type="hidden" name="order" value="\${order}" />
+\t\t\t\t\t\t\t\t<input type="hidden" name="search" value="\${search}" />
+\t\t\t\t\t\t\t\t<input type="hidden" name="page" value="\${page}" />
+\t\t\t\t\t\t\t\t${createInputs}
+\t\t\t\t\t\t\t\t<button type="submit" class="btn btn-primary btn-sm mt-2">Create record</button>
+\t\t\t\t\t\t\t</form>
+\t\t\t\t\t\t</div>
+\t\t\t\t\t</div>
+\t\t\t\t</div>
+\t\t\t</div>
+\t\t\`;
+
+\t\tif (c.req.header('hx-request')) {
+\t\t\treturn c.html(content);
+\t\t}
+
+\t\treturn c.html(Layout({
+\t\t\ttitle: "${table.tableName} - Admin Dashboard",
+\t\t\tchildren: content
+\t\t}));
+\t});`;
+}

package/cli/templates/dashboard/builders/table-routes/table/index.ts

@@ -0,0 +1,77 @@
+import { DiscoveredTable } from "../../../types";
+import {
+	buildColumnHeaders,
+	buildFieldInput,
+	buildPayloadAssignments,
+	buildRowCells,
+	buildSearchConditions,
+} from "../fragments";
+import {
+	resolvePrimaryKey,
+	shouldIncludeCreateField,
+	shouldIncludeEditField,
+} from "../helpers";
+import { buildActionsCell } from "./actions-cell";
+import { buildTableGetRoute } from "./get-route";
+import { buildTablePostRoutes } from "./post-routes";
+
+/**
+ * Builds the complete set of Hono route handlers for a discovered table.
+ * Delegates to focused builder functions for GET and POST handlers.
+ */
+export function buildTableRoute(table: DiscoveredTable): string {
+	const primaryKey = resolvePrimaryKey(table);
+	const hasPrimaryKey = Boolean(primaryKey);
+	const columns = table.columns.map((column) => column.name);
+	const createColumns = columns.filter((columnName) =>
+		shouldIncludeCreateField(table, columnName),
+	);
+	const editColumns = columns.filter((columnName) =>
+		shouldIncludeEditField(table, columnName),
+	);
+	const searchConditions = buildSearchConditions(table);
+	const headers = buildColumnHeaders(table, columns);
+	const rowCells = buildRowCells(columns);
+	const createInputs = createColumns
+		.map((columnName) => buildFieldInput(table, columnName, "create"))
+		.join("");
+	const editInputs = editColumns
+		.map((columnName) => buildFieldInput(table, columnName, "edit"))
+		.join("");
+	const createAssignments = buildPayloadAssignments(table, createColumns);
+	const editAssignments = buildPayloadAssignments(table, editColumns);
+	const defaultSort = hasPrimaryKey ? primaryKey : columns[0] || "id";
+	const primaryKeyType = table.columns.find(
+		(column) => column.name === primaryKey,
+	)?.type;
+
+	const actionsCell = buildActionsCell(
+		table,
+		hasPrimaryKey,
+		primaryKey,
+		editInputs,
+	);
+
+	return (
+		buildTableGetRoute(
+			table,
+			defaultSort,
+			columns,
+			searchConditions,
+			headers,
+			rowCells,
+			actionsCell,
+			createInputs,
+		) +
+		"\n" +
+		buildTablePostRoutes(
+			table.exportName,
+			defaultSort,
+			primaryKey,
+			primaryKeyType,
+			hasPrimaryKey,
+			createAssignments,
+			editAssignments,
+		)
+	);
+}

package/cli/templates/dashboard/builders/table-routes/table/post-routes.ts

@@ -0,0 +1,111 @@
+/**
+ * Builds the POST route handlers code string for create/edit/delete operations
+ * on a generic table (/admin/table/:tableName/create|edit|delete).
+ */
+export function buildTablePostRoutes(
+	exportName: string,
+	defaultSort: string,
+	primaryKey: string,
+	primaryKeyType: string | undefined,
+	hasPrimaryKey: boolean,
+	createAssignments: string,
+	editAssignments: string,
+): string {
+	const numericIdGuard =
+		primaryKeyType === "number"
+			? `
+\t\tconst parsedId = Number(rawId);
+\t\tif (Number.isNaN(parsedId)) return c.text('${primaryKey} must be a valid number', 400);
+\t\tidValue = parsedId;
+\t\t`
+			: "";
+
+	const editRoute = hasPrimaryKey
+		? `
+\tadminApp.post('/table/${exportName}/edit', async (c) => {
+\t\tconst db = drizzle(c.env[options.databaseBinding], { schema });
+\t\tconst tableSchema = (schema as any).${exportName};
+\t\tif (!tableSchema) return c.text('Table missing', 404);
+
+\t\tconst body = await c.req.parseBody();
+\t\tconst getValue = (value: unknown) => (typeof value === 'string' ? value : '');
+\t\tconst rawId = getValue(body['${primaryKey}']);
+\t\tif (rawId === '') return c.text('${primaryKey} is required', 400);
+
+\t\tconst payload: Record<string, unknown> = {};
+
+\t\t${editAssignments}
+
+\t\tlet idValue: unknown = rawId;
+\t\t${numericIdGuard}
+
+\t\tif (Object.keys(payload).length > 0) {
+\t\t\tawait db
+\t\t\t\t.update(tableSchema)
+\t\t\t\t.set(payload as any)
+\t\t\t\t.where(eq(tableSchema.${primaryKey}, idValue as any))
+\t\t\t\t.execute();
+\t\t}
+
+\t\tconst query = new URLSearchParams({
+\t\t\tpage: getValue(body.page) || '1',
+\t\t\tsort: getValue(body.sort) || '${defaultSort}',
+\t\t\torder: getValue(body.order) || 'desc',
+\t\t\tsearch: getValue(body.search) || '',
+\t\t});
+\t\treturn c.redirect('/admin/table/${exportName}?' + query.toString());
+\t});
+
+\tadminApp.post('/table/${exportName}/delete', async (c) => {
+\t\tconst db = drizzle(c.env[options.databaseBinding], { schema });
+\t\tconst tableSchema = (schema as any).${exportName};
+\t\tif (!tableSchema) return c.text('Table missing', 404);
+
+\t\tconst body = await c.req.parseBody();
+\t\tconst getValue = (value: unknown) => (typeof value === 'string' ? value : '');
+\t\tconst rawId = getValue(body['${primaryKey}']);
+\t\tif (rawId === '') return c.text('${primaryKey} is required', 400);
+
+\t\tlet idValue: unknown = rawId;
+\t\t${numericIdGuard}
+
+\t\tawait db
+\t\t\t.delete(tableSchema)
+\t\t\t.where(eq(tableSchema.${primaryKey}, idValue as any))
+\t\t\t.execute();
+
+\t\tconst query = new URLSearchParams({
+\t\t\tpage: getValue(body.page) || '1',
+\t\t\tsort: getValue(body.sort) || '${defaultSort}',
+\t\t\torder: getValue(body.order) || 'desc',
+\t\t\tsearch: getValue(body.search) || '',
+\t\t});
+\t\treturn c.redirect('/admin/table/${exportName}?' + query.toString());
+\t});`
+		: "";
+
+	return `
+\tadminApp.post('/table/${exportName}/create', async (c) => {
+\t\tconst db = drizzle(c.env[options.databaseBinding], { schema });
+\t\tconst tableSchema = (schema as any).${exportName};
+\t\tif (!tableSchema) return c.text('Table missing', 404);
+
+\t\tconst body = await c.req.parseBody();
+\t\tconst getValue = (value: unknown) => (typeof value === 'string' ? value : '');
+\t\tconst payload: Record<string, unknown> = {};
+
+\t\t${createAssignments}
+
+\t\tawait db.insert(tableSchema).values(payload as any).execute();
+
+\t\tconst query = new URLSearchParams({
+\t\t\tpage: getValue(body.page) || '1',
+\t\t\tsort: getValue(body.sort) || '${defaultSort}',
+\t\t\torder: getValue(body.order) || 'desc',
+\t\t\tsearch: getValue(body.search) || '',
+\t\t});
+\t\treturn c.redirect('/admin/table/${exportName}?' + query.toString());
+\t});
+${editRoute}
+\t`;
+}

package/cli/templates/dashboard/builders/table-routes/table-route.ts

@@ -0,0 +1,7 @@
+// Re-exported from the modular table/ directory.
+// The actual implementation has been split into focused files:
+//   - table/actions-cell.ts   — edit drawer + delete dialog cell
+//   - table/get-route.ts      — GET /admin/table/:tableName handler
+//   - table/post-routes.ts    — POST create/edit/delete handlers
+//   - table/index.ts          — orchestrating buildTableRoute()
+export { buildTableRoute } from "./table/index";

package/cli/templates/dashboard/builders/table-routes/users/get-route.ts

@@ -0,0 +1,69 @@
+import { buildUsersTableHtml } from "./html/table";
+import { buildUsersPageHtml } from "./html/page";
+
+/**
+ * Builds the GET /admin/users route handler (runtime template string).
+ * Handles search, sort, pagination, and renders the users page.
+ */
+export function buildUsersGetRoute(): string {
+	const tableHtml = buildUsersTableHtml();
+	const pageHtml = buildUsersPageHtml();
+
+	return `
+\tadminApp.get('/users', async (c) => {
+\t\tconst db = drizzle(c.env[options.databaseBinding]);
+\t\tconst auth = createAuth({ DATABASE: c.env[options.databaseBinding] } as any, c.req.raw.cf as any);
+\t\tconst session = await auth.api.getSession({ headers: c.req.raw.headers });
+\t\tconst page = parseInt(c.req.query('page') || '1');
+\t\tconst limit = 20;
+\t\tconst offset = (page - 1) * limit;
+\t\tconst sort = c.req.query('sort') || 'createdAt';
+\t\tconst order = c.req.query('order') || 'desc';
+\t\tconst search = c.req.query('search') || '';
+\t\tconst currentUserId = session?.user?.id || '';
+
+\t\tlet query = db.select().from(users);
+\t\tlet countQuery = db.select({ count: sql\`count(*)\` }).from(users);
+
+\t\tif (search) {
+\t\t\tconst searchConditions = [
+\t\t\t\tlike(users.name, \`%\${search}%\`),
+\t\t\t\tlike(users.email, \`%\${search}%\`),
+\t\t\t\tlike(users.role, \`%\${search}%\`),
+\t\t\t];
+\t\t\tquery = query.where(or(...searchConditions)) as any;
+\t\t\tcountQuery = countQuery.where(or(...searchConditions)) as any;
+\t\t}
+
+\t\tconst sortColumns: Record<string, any> = {
+\t\t\tid: users.id,
+\t\t\tname: users.name,
+\t\t\temail: users.email,
+\t\t\trole: users.role,
+\t\t\tcreatedAt: users.createdAt,
+\t\t\tbanned: users.banned,
+\t\t};
+
+\t\tif (sortColumns[sort]) {
+\t\t\tquery = query.orderBy(order === 'asc' ? asc(sortColumns[sort]) : desc(sortColumns[sort])) as any;
+\t\t}
+
+\t\tconst data = await query.limit(limit).offset(offset).execute();
+\t\tconst totalResult = await countQuery.execute();
+\t\tconst total = Number(totalResult[0]?.count || 0);
+\t\tconst totalPages = Math.ceil(total / limit);
+
+\t\t${tableHtml}
+
+\t\t${pageHtml}
+
+\t\tif (c.req.header('hx-request')) {
+\t\t\treturn c.html(content);
+\t\t}
+
+\t\treturn c.html(Layout({
+\t\t\ttitle: "users - Admin Dashboard",
+\t\t\tchildren: content,
+\t\t}));
+\t});`;
+}

package/cli/templates/dashboard/builders/table-routes/users/html/modals.ts

@@ -0,0 +1,57 @@
+/**
+ * Builds the ban/unban confirmation modal HTML for a users table row.
+ * Clean PocketBase-style modal.
+ */
+export function buildBanUserModal(): string {
+	return `
+\t\t\t\t\t\t\t\${(row as any).id === currentUserId ? '' : html\`
+\t\t\t\t\t\t\t\t<input type="checkbox" id="ban-user-modal-\${String((row as any).id)}" class="modal-toggle" />
+\t\t\t\t\t\t\t\t<div class="modal">
+\t\t\t\t\t\t\t\t\t<div class="modal-box max-w-sm">
+\t\t\t\t\t\t\t\t\t\t<h3 class="font-semibold text-base">\${(row as any).banned ? 'Unban user' : 'Ban user'}</h3>
+\t\t\t\t\t\t\t\t\t\t<p class="py-3 text-sm text-base-content/60">\${(row as any).banned ? 'Restore access for' : 'Disable access for'} <span class="font-semibold">\${String((row as any).email ?? '')}</span>?</p>
+\t\t\t\t\t\t\t\t\t\t<form hx-post="/admin/users/\${(row as any).banned ? 'unban' : 'ban'}" hx-target="#main-content" hx-swap="outerHTML" class="space-y-3">
+\t\t\t\t\t\t\t\t\t\t\t<input type="hidden" name="id" value="\${String((row as any).id)}" />
+\t\t\t\t\t\t\t\t\t\t\t<input type="hidden" name="page" value="\${page}" />
+\t\t\t\t\t\t\t\t\t\t\t<input type="hidden" name="search" value="\${search}" />
+\t\t\t\t\t\t\t\t\t\t\t<input type="hidden" name="sort" value="\${sort}" />
+\t\t\t\t\t\t\t\t\t\t\t<input type="hidden" name="order" value="\${order}" />
+\t\t\t\t\t\t\t\t\t\t\t<div class="modal-action">
+\t\t\t\t\t\t\t\t\t\t\t\t<label for="ban-user-modal-\${String((row as any).id)}" class="btn btn-ghost btn-sm">Cancel</label>
+\t\t\t\t\t\t\t\t\t\t\t\t<button class="btn btn-sm \${(row as any).banned ? 'btn-info' : 'btn-warning'}" type="submit">\${(row as any).banned ? 'Unban' : 'Ban'}</button>
+\t\t\t\t\t\t\t\t\t\t\t</div>
+\t\t\t\t\t\t\t\t\t\t</form>
+\t\t\t\t\t\t\t\t\t</div>
+\t\t\t\t\t\t\t\t\t<label class="modal-backdrop" for="ban-user-modal-\${String((row as any).id)}">Close</label>
+\t\t\t\t\t\t\t\t</div>
+\t\t\t\t\t\t\t\`}`;
+}
+
+/**
+ * Builds the delete confirmation modal HTML for a users table row.
+ * Clean PocketBase-style modal.
+ */
+export function buildDeleteUserModal(): string {
+	return `
+\t\t\t\t\t\t\t\${(row as any).id === currentUserId ? '' : html\`
+\t\t\t\t\t\t\t\t<input type="checkbox" id="delete-user-modal-\${String((row as any).id)}" class="modal-toggle" />
+\t\t\t\t\t\t\t\t<div class="modal">
+\t\t\t\t\t\t\t\t\t<div class="modal-box max-w-sm">
+\t\t\t\t\t\t\t\t\t\t<h3 class="font-semibold text-base text-error">Delete user</h3>
+\t\t\t\t\t\t\t\t\t\t<p class="py-3 text-sm text-base-content/60">Delete user <span class="font-semibold">\${String((row as any).email ?? '')}</span>? This action cannot be undone.</p>
+\t\t\t\t\t\t\t\t\t\t<form hx-post="/admin/users/delete" hx-target="#main-content" hx-swap="outerHTML">
+\t\t\t\t\t\t\t\t\t\t\t<input type="hidden" name="id" value="\${String((row as any).id)}" />
+\t\t\t\t\t\t\t\t\t\t\t<input type="hidden" name="page" value="\${page}" />
+\t\t\t\t\t\t\t\t\t\t\t<input type="hidden" name="search" value="\${search}" />
+\t\t\t\t\t\t\t\t\t\t\t<input type="hidden" name="sort" value="\${sort}" />
+\t\t\t\t\t\t\t\t\t\t\t<input type="hidden" name="order" value="\${order}" />
+\t\t\t\t\t\t\t\t\t\t\t<div class="modal-action">
+\t\t\t\t\t\t\t\t\t\t\t\t<label for="delete-user-modal-\${String((row as any).id)}" class="btn btn-ghost btn-sm">Cancel</label>
+\t\t\t\t\t\t\t\t\t\t\t\t<button class="btn btn-error btn-sm" type="submit">Delete</button>
+\t\t\t\t\t\t\t\t\t\t\t</div>
+\t\t\t\t\t\t\t\t\t\t</form>
+\t\t\t\t\t\t\t\t\t</div>
+\t\t\t\t\t\t\t\t\t<label class="modal-backdrop" for="delete-user-modal-\${String((row as any).id)}">Close</label>
+\t\t\t\t\t\t\t\t</div>
+\t\t\t\t\t\t\t\`}`;
+}

package/cli/templates/dashboard/builders/table-routes/users/html/page.ts

@@ -0,0 +1,27 @@
+import { buildSearchBarHtml } from "../../common/search-bar";
+
+/**
+ * Builds the full page content HTML (runtime template string) for the users management page.
+ * PocketBase-style breadcrumb header with search filter.
+ */
+export function buildUsersPageHtml(): string {
+	const searchBarHtml = buildSearchBarHtml("/admin/users", "Search users...");
+
+	return `
+\t\tconst content = html\`
+\t\t\t<div id="main-content">
+\t\t\t\t<div class="flex flex-col md:flex-row justify-between items-start md:items-center mb-5 gap-3">
+\t\t\t\t\t<div class="flex items-center gap-2 text-sm">
+\t\t\t\t\t\t<a href="/admin" class="text-base-content/40 hover:text-primary transition-colors">Collections</a>
+\t\t\t\t\t\t<iconify-icon icon="mdi:chevron-right" width="14" height="14" class="opacity-30"></iconify-icon>
+\t\t\t\t\t\t<span class="font-semibold">users</span>
+\t\t\t\t\t\t<button class="btn btn-ghost btn-xs btn-square opacity-40 hover:opacity-100" onclick="window.location.reload()">
+\t\t\t\t\t\t\t<iconify-icon icon="mdi:refresh" width="14" height="14"></iconify-icon>
+\t\t\t\t\t\t</button>
+\t\t\t\t\t</div>
+\t\t\t\t\t${searchBarHtml}
+\t\t\t\t</div>
+\t\t\t\t\${tableHtml}
+\t\t\t</div>
+\t\t\`;`;
+}