@nubase/create 0.1.23 → 0.1.25

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nubase/create",
-  "version": "0.1.23",
+  "version": "0.1.25",
   "description": "Create a new Nubase application",
   "type": "module",
   "bin": {

package/templates/backend/src/api/handler-factory.ts

@@ -0,0 +1,34 @@
+import { createHandlerFactory } from "@nubase/backend";
+import { apiEndpoints, type ApiEndpoints } from "schema";
+import type { __PROJECT_NAME_PASCAL__User } from "../auth";
+
+/**
+ * Pre-configured handler factory for __PROJECT_NAME_PASCAL__.
+ *
+ * This factory pre-binds:
+ * - The apiEndpoints object for endpoint schema inference
+ * - The __PROJECT_NAME_PASCAL__User type for authenticated handlers
+ *
+ * @example
+ * ```typescript
+ * // Required auth - user is guaranteed to be __PROJECT_NAME_PASCAL__User
+ * getTickets: createHandler((e) => e.getTickets, {
+ *   auth: "required",
+ *   handler: async ({ params, user, ctx }) => { ... },
+ * }),
+ *
+ * // No auth (default) - no user in handler
+ * loginStart: createHandler((e) => e.loginStart, {
+ *   handler: async ({ body }) => { ... },
+ * }),
+ *
+ * // Optional auth - user may be null
+ * getMe: createHandler((e) => e.getMe, {
+ *   auth: "optional",
+ *   handler: async ({ user }) => { ... },
+ * }),
+ * ```
+ */
+export const createHandler = createHandlerFactory<ApiEndpoints, __PROJECT_NAME_PASCAL__User>({
+	endpoints: apiEndpoints,
+});

package/templates/backend/src/api/routes/auth.ts

@@ -1,20 +1,15 @@
-import {
-	createHttpHandler,
-	getAuthController,
-	HttpError,
-} from "@nubase/backend";
+import { getAuthController, HttpError } from "@nubase/backend";
 import bcrypt from "bcrypt";
 import { and, eq, inArray } from "drizzle-orm";
-import { apiEndpoints } from "schema";
 import jwt from "jsonwebtoken";
 import type { __PROJECT_NAME_PASCAL__User } from "../../auth";
 import { getAdminDb } from "../../db/helpers/drizzle";
 import { users, userWorkspaces, workspaces } from "../../db/schema";
+import { createHandler } from "../handler-factory";
 
 // Short-lived secret for login tokens (in production, use a proper secret)
 const LOGIN_TOKEN_SECRET =
-	process.env.LOGIN_TOKEN_SECRET ||
-	"nubase-login-token-secret-change-in-production";
+	process.env.LOGIN_TOKEN_SECRET || "nubase-login-token-secret-change-in-production";
 const LOGIN_TOKEN_EXPIRY = "5m"; // 5 minutes to complete workspace selection
 
 interface LoginTokenPayload {
@@ -27,8 +22,7 @@ export const authHandlers = {
 	 * Login Start handler - Step 1 of two-step auth.
 	 * Validates credentials and returns list of workspaces.
 	 */
-	loginStart: createHttpHandler({
-		endpoint: apiEndpoints.loginStart,
+	loginStart: createHandler((e) => e.loginStart, {
 		handler: async ({ body }) => {
 			// Find user by email
 			const [user] = await getAdminDb()
@@ -41,10 +35,7 @@ export const authHandlers = {
 			}
 
 			// Verify password
-			const isValidPassword = await bcrypt.compare(
-				body.password,
-				user.passwordHash,
-			);
+			const isValidPassword = await bcrypt.compare(body.password, user.passwordHash);
 			if (!isValidPassword) {
 				throw new HttpError(401, "Invalid email or password");
 			}
@@ -92,18 +83,14 @@ export const authHandlers = {
 	 * Login Complete handler - Step 2 of two-step auth.
 	 * Validates the login token and selected workspace.
 	 */
-	loginComplete: createHttpHandler({
-		endpoint: apiEndpoints.loginComplete,
+	loginComplete: createHandler((e) => e.loginComplete, {
 		handler: async ({ body, ctx }) => {
 			const authController = getAuthController<__PROJECT_NAME_PASCAL__User>(ctx);
 
 			// Verify the login token
 			let decoded: LoginTokenPayload;
 			try {
-				decoded = jwt.verify(
-					body.loginToken,
-					LOGIN_TOKEN_SECRET,
-				) as LoginTokenPayload;
+				decoded = jwt.verify(body.loginToken, LOGIN_TOKEN_SECRET) as LoginTokenPayload;
 			} catch {
 				throw new HttpError(401, "Invalid or expired login token");
 			}
@@ -174,8 +161,7 @@ export const authHandlers = {
 	 * Legacy Login handler - validates credentials and sets HttpOnly cookie.
 	 * @deprecated Use loginStart and loginComplete for two-step flow
 	 */
-	login: createHttpHandler({
-		endpoint: apiEndpoints.login,
+	login: createHandler((e) => e.login, {
 		handler: async ({ body, ctx }) => {
 			const authController = getAuthController<__PROJECT_NAME_PASCAL__User>(ctx);
 
@@ -200,10 +186,7 @@ export const authHandlers = {
 			}
 
 			// Verify password
-			const isValidPassword = await bcrypt.compare(
-				body.password,
-				dbUser.passwordHash,
-			);
+			const isValidPassword = await bcrypt.compare(body.password, dbUser.passwordHash);
 			if (!isValidPassword) {
 				throw new HttpError(401, "Invalid email or password");
 			}
@@ -246,8 +229,7 @@ export const authHandlers = {
 	}),
 
 	/** Logout handler - clears the auth cookie. */
-	logout: createHttpHandler({
-		endpoint: apiEndpoints.logout,
+	logout: createHandler((e) => e.logout, {
 		handler: async ({ ctx }) => {
 			const authController = getAuthController(ctx);
 			authController.clearTokenFromResponse(ctx);
@@ -256,12 +238,7 @@ export const authHandlers = {
 	}),
 
 	/** Get current user handler. */
-	getMe: createHttpHandler<
-		typeof apiEndpoints.getMe,
-		"optional",
-		__PROJECT_NAME_PASCAL__User
-	>({
-		endpoint: apiEndpoints.getMe,
+	getMe: createHandler((e) => e.getMe, {
 		auth: "optional",
 		handler: async ({ user }) => {
 			if (!user) {
@@ -279,8 +256,7 @@ export const authHandlers = {
 	}),
 
 	/** Signup handler - creates a new workspace and admin user. */
-	signup: createHttpHandler({
-		endpoint: apiEndpoints.signup,
+	signup: createHandler((e) => e.signup, {
 		handler: async ({ body, ctx }) => {
 			const authController = getAuthController<__PROJECT_NAME_PASCAL__User>(ctx);
 

package/templates/backend/src/api/routes/dashboard.ts

@@ -1,5 +1,4 @@
-import { createHttpHandler } from "@nubase/backend";
-import { apiEndpoints } from "schema";
+import { createHandler } from "../handler-factory";
 
 /**
  * Dashboard widget endpoints.
@@ -7,8 +6,7 @@ import { apiEndpoints } from "schema";
  */
 export const dashboardHandlers = {
 	/** Revenue chart - returns series data for area/line/bar charts. */
-	getRevenueChart: createHttpHandler({
-		endpoint: apiEndpoints.getRevenueChart,
+	getRevenueChart: createHandler((e) => e.getRevenueChart, {
 		handler: async () => ({
 			type: "series",
 			config: {
@@ -26,8 +24,7 @@ export const dashboardHandlers = {
 	}),
 
 	/** Browser stats - returns proportional data for pie/donut charts. */
-	getBrowserStats: createHttpHandler({
-		endpoint: apiEndpoints.getBrowserStats,
+	getBrowserStats: createHandler((e) => e.getBrowserStats, {
 		handler: async () => ({
 			type: "proportional",
 			data: [
@@ -41,8 +38,7 @@ export const dashboardHandlers = {
 	}),
 
 	/** Total revenue KPI - returns single value with trend. */
-	getTotalRevenue: createHttpHandler({
-		endpoint: apiEndpoints.getTotalRevenue,
+	getTotalRevenue: createHandler((e) => e.getTotalRevenue, {
 		handler: async () => ({
 			type: "kpi",
 			value: "$45,231.89",
@@ -53,8 +49,7 @@ export const dashboardHandlers = {
 	}),
 
 	/** Active users KPI - returns single value with trend. */
-	getActiveUsers: createHttpHandler({
-		endpoint: apiEndpoints.getActiveUsers,
+	getActiveUsers: createHandler((e) => e.getActiveUsers, {
 		handler: async () => ({
 			type: "kpi",
 			value: "+2,350",
@@ -65,8 +60,7 @@ export const dashboardHandlers = {
 	}),
 
 	/** Sales chart - returns series data for bar charts. */
-	getSalesChart: createHttpHandler({
-		endpoint: apiEndpoints.getSalesChart,
+	getSalesChart: createHandler((e) => e.getSalesChart, {
 		handler: async () => ({
 			type: "series",
 			config: {
@@ -85,8 +79,7 @@ export const dashboardHandlers = {
 	}),
 
 	/** Recent activity - returns table data. */
-	getRecentActivity: createHttpHandler({
-		endpoint: apiEndpoints.getRecentActivity,
+	getRecentActivity: createHandler((e) => e.getRecentActivity, {
 		handler: async () => ({
 			type: "table",
 			columns: [

package/templates/backend/src/api/routes/ticket.ts

@@ -1,19 +1,30 @@
-import { createHttpHandler, HttpError } from "@nubase/backend";
+import { HttpError } from "@nubase/backend";
 import type { SQL } from "drizzle-orm";
-import { and, eq, ilike, inArray } from "drizzle-orm";
-import { apiEndpoints } from "schema";
+import { and, eq, ilike, inArray, or } from "drizzle-orm";
 import { getDb } from "../../db/helpers/drizzle";
 import { tickets } from "../../db/schema";
+import { createHandler } from "../handler-factory";
 
 export const ticketHandlers = {
-	getTickets: createHttpHandler({
-		endpoint: apiEndpoints.getTickets,
+	getTickets: createHandler((e) => e.getTickets, {
 		handler: async ({ params }) => {
 			const db = getDb();
 
 			// Build filter conditions
 			const conditions: SQL[] = [];
 
+			// Global text search - OR across searchable text fields
+			if (params.q) {
+				const searchTerm = `%${params.q}%`;
+				const searchCondition = or(
+					ilike(tickets.title, searchTerm),
+					ilike(tickets.description, searchTerm),
+				);
+				if (searchCondition) {
+					conditions.push(searchCondition);
+				}
+			}
+
 			// Filter by title (case-insensitive partial match)
 			if (params.title) {
 				conditions.push(ilike(tickets.title, `%${params.title}%`));
@@ -52,8 +63,7 @@ export const ticketHandlers = {
 		},
 	}),
 
-	getTicket: createHttpHandler({
-		endpoint: apiEndpoints.getTicket,
+	getTicket: createHandler((e) => e.getTicket, {
 		handler: async ({ params }) => {
 			const [ticket] = await getDb()
 				.select()
@@ -73,8 +83,7 @@ export const ticketHandlers = {
 		},
 	}),
 
-	postTicket: createHttpHandler({
-		endpoint: apiEndpoints.postTicket,
+	postTicket: createHandler((e) => e.postTicket, {
 		handler: async ({ body }) => {
 			const [ticket] = await getDb()
 				.insert(tickets)
@@ -99,8 +108,7 @@ export const ticketHandlers = {
 		},
 	}),
 
-	patchTicket: createHttpHandler({
-		endpoint: apiEndpoints.patchTicket,
+	patchTicket: createHandler((e) => e.patchTicket, {
 		handler: async ({ params, body }) => {
 			const updateData: {
 				title?: string;
@@ -140,8 +148,7 @@ export const ticketHandlers = {
 		},
 	}),
 
-	deleteTicket: createHttpHandler({
-		endpoint: apiEndpoints.deleteTicket,
+	deleteTicket: createHandler((e) => e.deleteTicket, {
 		handler: async ({ params }) => {
 			const [deleted] = await getDb()
 				.delete(tickets)

package/templates/backend/src/api/routes/user.ts

@@ -1,20 +1,31 @@
-import { createHttpHandler, HttpError } from "@nubase/backend";
+import { HttpError } from "@nubase/backend";
 import type { SQL } from "drizzle-orm";
-import { and, eq, ilike } from "drizzle-orm";
-import { apiEndpoints } from "schema";
+import { and, eq, ilike, or } from "drizzle-orm";
 import { getDb } from "../../db/helpers/drizzle";
 import { users } from "../../db/schema";
+import { createHandler } from "../handler-factory";
 
 export const userHandlers = {
 	/** Get all users with optional filters. */
-	getUsers: createHttpHandler({
-		endpoint: apiEndpoints.getUsers,
+	getUsers: createHandler((e) => e.getUsers, {
 		handler: async ({ params }) => {
 			const db = getDb();
 
 			// Build filter conditions
 			const conditions: SQL[] = [];
 
+			// Global text search - OR across searchable text fields
+			if (params.q) {
+				const searchTerm = `%${params.q}%`;
+				const searchCondition = or(
+					ilike(users.displayName, searchTerm),
+					ilike(users.email, searchTerm),
+				);
+				if (searchCondition) {
+					conditions.push(searchCondition);
+				}
+			}
+
 			// Filter by displayName (case-insensitive partial match)
 			if (params.displayName) {
 				conditions.push(ilike(users.displayName, `%${params.displayName}%`));
@@ -41,8 +52,7 @@ export const userHandlers = {
 	}),
 
 	/** Get a single user by ID. */
-	getUser: createHttpHandler({
-		endpoint: apiEndpoints.getUser,
+	getUser: createHandler((e) => e.getUser, {
 		handler: async ({ params }) => {
 			const db = getDb();
 			const [user] = await db.select().from(users).where(eq(users.id, params.id));
@@ -60,8 +70,7 @@ export const userHandlers = {
 	}),
 
 	/** Create a new user. */
-	postUser: createHttpHandler({
-		endpoint: apiEndpoints.postUser,
+	postUser: createHandler((e) => e.postUser, {
 		handler: async ({ body }) => {
 			const db = getDb();
 
@@ -94,8 +103,7 @@ export const userHandlers = {
 	}),
 
 	/** Update a user by ID. */
-	patchUser: createHttpHandler({
-		endpoint: apiEndpoints.patchUser,
+	patchUser: createHandler((e) => e.patchUser, {
 		handler: async ({ params, body }) => {
 			const db = getDb();
 
@@ -126,8 +134,7 @@ export const userHandlers = {
 	}),
 
 	/** Delete a user by ID. */
-	deleteUser: createHttpHandler({
-		endpoint: apiEndpoints.deleteUser,
+	deleteUser: createHandler((e) => e.deleteUser, {
 		handler: async ({ params }) => {
 			const db = getDb();
 
@@ -142,8 +149,7 @@ export const userHandlers = {
 	}),
 
 	/** Lookup users for select/autocomplete fields. */
-	lookupUsers: createHttpHandler({
-		endpoint: apiEndpoints.lookupUsers,
+	lookupUsers: createHandler((e) => e.lookupUsers, {
 		handler: async ({ params }) => {
 			const db = getDb();
 

package/templates/frontend/src/resources/user.ts

@@ -100,12 +100,13 @@ export const userResource = createResource("user")
 			id: "search-users",
 			title: "Users",
 			schemaGet: (api) => api.getUsers.responseBody,
+			schemaFilter: (api) => api.getUsers.requestParams,
 			breadcrumbs: () => [{ label: "Users", to: "/r/user/search" }],
 			tableActions: ["delete"],
 			rowActions: ["delete"],
 			onLoad: async ({ context }) => {
 				return context.http.getUsers({
-					params: {},
+					params: context.params || {},
 				});
 			},
 		},

package/templates/schema/src/endpoints/ticket/get-tickets.ts

@@ -1,9 +1,9 @@
-import { nu, type RequestSchema } from "@nubase/core";
+import { nu, type RequestSchema, withSearchParams } from "@nubase/core";
 import { ticketSchema } from "../../resources/ticket";
 
 export const getTicketsSchema = {
 	method: "GET" as const,
 	path: "/tickets",
-	requestParams: ticketSchema.omit("id").partial(),
+	requestParams: withSearchParams(ticketSchema.omit("id").partial()),
 	responseBody: nu.array(ticketSchema),
 } satisfies RequestSchema;

package/templates/schema/src/endpoints/user/get-users.ts

@@ -1,9 +1,9 @@
-import { nu, type RequestSchema } from "@nubase/core";
+import { nu, type RequestSchema, withSearchParams } from "@nubase/core";
 import { userSchema } from "../../resources/user";
 
 export const getUsersSchema = {
 	method: "GET" as const,
 	path: "/users",
-	requestParams: userSchema.omit("id").partial(),
+	requestParams: withSearchParams(userSchema.omit("id").partial()),
 	responseBody: nu.array(userSchema),
 } satisfies RequestSchema;