create-questpie 1.0.0 → 2.0.0

package/templates/tanstack-start/src/questpie/server/.generated/factories.ts

@@ -0,0 +1,318 @@
+/* oxlint-disable */
+// AUTO-GENERATED by questpie codegen — DO NOT EDIT
+// Typed factory functions with plugin extensions. Regenerate with: questpie generate
+
+// ── Core Imports ───────────────────────────────────────────
+import {
+	type CollectionAccess,
+	CollectionBuilder,
+	type ContextResolver,
+	createFieldNameProxy,
+	type EmptyCollectionState,
+	type EmptyGlobalState,
+	GlobalBuilder,
+	type GlobalHooksInput,
+	type LocaleConfig,
+	wrapBuilderWithExtensions,
+} from "questpie";
+import type { RegistryProp } from "questpie";
+
+// ── Plugin Imports ─────────────────────────────────────────
+import {
+	type ActionsConfigContext,
+	type AdminCollectionConfig,
+	type AdminConfigContext,
+	type AdminGlobalConfig,
+	type AdminLocaleConfig,
+	createActionCallbackProxy,
+	createComponentCallbackProxy,
+	createViewCallbackProxy,
+	type DashboardContribution,
+	type FilterViewsByKind,
+	type FormViewConfig,
+	type FormViewConfigContext,
+	type ListViewConfig,
+	type ListViewConfigContext,
+	type PreviewConfig,
+	type ServerActionsConfig,
+	type ServerBrandingConfig,
+	type SidebarContribution,
+} from "@questpie/admin/server";
+// ════════════════════════════════════════════════════════════
+// Type extraction from Registry — driven by CategoryDeclaration
+// ════════════════════════════════════════════════════════════
+
+// ── Module import (for type extraction) ──
+import type _modulesArr from "../modules";
+
+type _ViewsNames = (keyof RegistryProp<"views"> & string) | (string & {});
+type _ViewsRecord = RegistryProp<"views">;
+type _ComponentsNames =
+	| (keyof RegistryProp<"components"> & string)
+	| (string & {});
+type _ComponentsNames_Strict = keyof RegistryProp<"components"> & string;
+type _ComponentsRecord = RegistryProp<"components">;
+
+// Field types — extracted from modules
+import type { ExtractModuleProp } from "questpie";
+
+type _AllFieldTypes = ExtractModuleProp<
+	{ modules: typeof _modulesArr },
+	"fields"
+>;
+
+// ════════════════════════════════════════════════════════════
+// Type augmentations — generated from plugin registries
+// ════════════════════════════════════════════════════════════
+
+declare module "questpie" {
+	interface CollectionBuilder<TState> {
+		admin(
+			configFn:
+				| AdminCollectionConfig
+				| ((
+						ctx: AdminConfigContext<_ComponentsRecord>,
+				  ) => AdminCollectionConfig),
+		): CollectionBuilder<TState>;
+		list(
+			configFn: (
+				ctx: ListViewConfigContext<
+					TState extends {
+						fieldDefinitions: infer F extends Record<string, any>;
+					}
+						? F
+						: Record<string, any>,
+					FilterViewsByKind<_ViewsRecord, "list">
+				>,
+			) => ListViewConfig,
+		): CollectionBuilder<TState>;
+		form(
+			configFn: (
+				ctx: FormViewConfigContext<
+					TState extends {
+						fieldDefinitions: infer F extends Record<string, any>;
+					}
+						? F
+						: Record<string, any>,
+					FilterViewsByKind<_ViewsRecord, "form">
+				>,
+			) => FormViewConfig,
+		): CollectionBuilder<TState>;
+		preview(config: PreviewConfig): CollectionBuilder<TState>;
+		actions(
+			configFn: (
+				ctx: ActionsConfigContext<Record<string, unknown>, _ComponentsRecord>,
+			) => ServerActionsConfig,
+		): CollectionBuilder<TState>;
+	}
+	interface GlobalBuilder<TState> {
+		admin(
+			configFn:
+				| AdminGlobalConfig
+				| ((ctx: AdminConfigContext<_ComponentsRecord>) => AdminGlobalConfig),
+		): GlobalBuilder<TState>;
+		form(
+			configFn: (
+				ctx: FormViewConfigContext<
+					TState extends {
+						fieldDefinitions: infer F extends Record<string, any>;
+					}
+						? F
+						: Record<string, any>,
+					FilterViewsByKind<_ViewsRecord, "form">
+				>,
+			) => FormViewConfig,
+		): GlobalBuilder<TState>;
+	}
+}
+
+declare global {
+	namespace Questpie {
+		interface FieldTypeRegistry extends Record<keyof _AllFieldTypes, {}> {}
+	}
+}
+
+declare module "@questpie/admin/server" {
+	interface ComponentTypeRegistry extends Record<_ComponentsNames_Strict, {}> {}
+}
+
+// ════════════════════════════════════════════════════════════
+// Extension registries
+// ════════════════════════════════════════════════════════════
+
+const _collExt: Record<string, { stateKey: string; resolve: (v: any) => any }> =
+	{
+		admin: {
+			stateKey: "admin",
+			resolve(configOrFn: any) {
+				if (typeof configOrFn === "function")
+					return configOrFn({ c: createComponentCallbackProxy() });
+				return configOrFn;
+			},
+		},
+		list: {
+			stateKey: "adminList",
+			resolve(configOrFn: any) {
+				const resolved =
+					typeof configOrFn === "function"
+						? configOrFn({
+								v: createViewCallbackProxy(),
+								f: createFieldNameProxy(),
+								a: createActionCallbackProxy(),
+							})
+						: configOrFn;
+				return {
+					...{
+						view: "collection-table",
+						showSearch: true,
+						showFilters: true,
+						showToolbar: true,
+					},
+					...resolved,
+				};
+			},
+		},
+		form: {
+			stateKey: "adminForm",
+			resolve(configOrFn: any) {
+				const resolved =
+					typeof configOrFn === "function"
+						? configOrFn({
+								v: createViewCallbackProxy(),
+								f: createFieldNameProxy(),
+							})
+						: configOrFn;
+				return { ...{ view: "collection-form", showMeta: true }, ...resolved };
+			},
+		},
+		preview: { stateKey: "adminPreview", resolve: (v: any) => v },
+		actions: {
+			stateKey: "adminActions",
+			resolve(configOrFn: any) {
+				if (typeof configOrFn === "function")
+					return configOrFn({
+						a: createActionCallbackProxy(),
+						c: createComponentCallbackProxy(),
+						f: createFieldNameProxy(),
+					});
+				return configOrFn;
+			},
+		},
+	};
+
+const _globExt: Record<string, { stateKey: string; resolve: (v: any) => any }> =
+	{
+		admin: {
+			stateKey: "admin",
+			resolve(configOrFn: any) {
+				if (typeof configOrFn === "function")
+					return configOrFn({ c: createComponentCallbackProxy() });
+				return configOrFn;
+			},
+		},
+		form: {
+			stateKey: "adminForm",
+			resolve(configOrFn: any) {
+				const resolved =
+					typeof configOrFn === "function"
+						? configOrFn({
+								v: createViewCallbackProxy(),
+								f: createFieldNameProxy(),
+							})
+						: configOrFn;
+				return { ...{ view: "global-form", showMeta: true }, ...resolved };
+			},
+		},
+	};
+
+// ════════════════════════════════════════════════════════════
+// Factory functions
+// ════════════════════════════════════════════════════════════
+
+/**
+ * Create a typed collection builder with plugin extensions.
+ *
+ * @example
+ * ```ts
+ * import { collection } from "#questpie/factories";
+ *
+ * export default collection("posts")
+ *   .fields(({ f }) => ({ title: f.text({ required: true }) }))
+ *   .admin(({ c }) => ({ icon: c.icon("ph:article") }))
+ *   .list(({ v, f }) => v.collectionTable({ columns: [f.title] }))
+ * ```
+ */
+export function collection<TName extends string>(
+	name: TName,
+): CollectionBuilder<EmptyCollectionState<TName, undefined, _AllFieldTypes>> {
+	return wrapBuilderWithExtensions(
+		CollectionBuilder.create<TName, _AllFieldTypes>(name),
+		_collExt,
+		CollectionBuilder,
+	) as any;
+}
+
+/**
+ * Create a typed global builder with plugin extensions.
+ */
+export function global<TName extends string>(
+	name: TName,
+): GlobalBuilder<EmptyGlobalState<TName, undefined, _AllFieldTypes>> {
+	return wrapBuilderWithExtensions(
+		GlobalBuilder.create<TName, _AllFieldTypes>(name),
+		_globExt,
+		GlobalBuilder,
+	) as any;
+}
+
+// ════════════════════════════════════════════════════════════
+// Singleton factory functions
+// ════════════════════════════════════════════════════════════
+
+/** Typed factory for locale config. */
+export function locale<T extends LocaleConfig>(config: T): T {
+	return config;
+}
+
+/** Typed factory for hooks config. */
+export function hooks<T extends GlobalHooksInput>(config: T): T {
+	return config;
+}
+
+/** Typed factory for access config. */
+export function access<T extends CollectionAccess>(config: T): T {
+	return config;
+}
+
+/** Typed factory for context config. */
+export function context<T extends ContextResolver>(config: T): T {
+	return config;
+}
+
+/** Typed factory for branding config. */
+export function branding<T extends ServerBrandingConfig>(config: T): T {
+	return config;
+}
+
+/** Typed factory for adminLocale config. */
+export function adminLocale<T extends AdminLocaleConfig>(config: T): T {
+	return config;
+}
+
+/** Typed factory for sidebar config. Accepts plain config or callback. */
+export function sidebar<T extends SidebarContribution>(config: T): T;
+export function sidebar<T extends (...args: any[]) => SidebarContribution>(
+	cb: T,
+): T;
+export function sidebar(v: any): any {
+	return v;
+}
+
+/** Typed factory for dashboard config. Accepts plain config or callback. */
+export function dashboard<T extends DashboardContribution>(config: T): T;
+export function dashboard<T extends (...args: any[]) => DashboardContribution>(
+	cb: T,
+): T;
+export function dashboard(v: any): any {
+	return v;
+}

package/templates/tanstack-start/src/questpie/server/.generated/index.ts

@@ -0,0 +1,153 @@
+/* oxlint-disable */
+// AUTO-GENERATED by questpie codegen — DO NOT EDIT
+// Regenerate with: questpie generate
+
+import {
+	type AppContext,
+	createApp,
+	createContextFactory,
+	type Questpie,
+	type QuestpieConfig,
+} from "questpie";
+// ── Module type extraction (inline, no recursive types) ───
+import type { UnionToIntersection } from "questpie";
+
+// ── Plugin Singles ─────────────────────────────────────────
+import _branding from "../branding";
+// ── Collections ────────────────────────────────────────────
+import { posts as _coll_posts_collection } from "../collections/posts.collection";
+import _dashboard from "../dashboard";
+// ── Globals ────────────────────────────────────────────────
+import { siteSettings as _glob_siteSettings_global } from "../globals/site-settings.global";
+// ── Modules ────────────────────────────────────────────────
+import _modules from "../modules";
+// ── Runtime ────────────────────────────────────────────────
+import _runtime from "../questpie.config";
+// ════════════════════════════════════════════════════════════
+// TYPES — composed from typeof references (zero inference cost)
+// ════════════════════════════════════════════════════════════
+import _sidebar from "../sidebar";
+
+type _Module = (typeof _modules)[number];
+type _MPRaw<K extends string> = UnionToIntersection<
+	_Module extends infer M ? (M extends Record<K, infer V> ? V : never) : never
+>;
+type _MP<K extends string> = [_MPRaw<K>] extends [never] ? {} : _MPRaw<K>;
+
+type _ModuleCollections = _MP<"collections">;
+type _ModuleGlobals = _MP<"globals">;
+type _ModuleJobs = _MP<"jobs">;
+type _ModuleRoutes = _MP<"routes">;
+type _ModuleServices = _MP<"services">;
+
+/** All collections in the app (modules + user, user overrides) */
+export type AppCollections = _ModuleCollections & {
+	"posts.collection": typeof _coll_posts_collection;
+};
+
+/** All globals in the app (modules + user, user overrides) */
+export type AppGlobals = _ModuleGlobals & {
+	"siteSettings.global": typeof _glob_siteSettings_global;
+};
+
+/** All jobs in the app (modules + user, user overrides) */
+export type AppJobs = _ModuleJobs;
+
+/** All routes in the app (modules + user, user overrides) */
+export type AppRoutes = _ModuleRoutes;
+
+/** All services in the app (modules + user, user overrides). Values are service instances. */
+export type AppServices = _ModuleServices;
+
+/**
+ * The fully-typed app instance type.
+ * Use `typeof app` or this alias when you need to reference the app type.
+ *
+ * **Note:** Do NOT import `app` inside framework-defined files (collections,
+ * globals, routes, hooks, blocks) — it creates circular dependencies with
+ * the generated index. Use the context parameters provided to handlers instead.
+ */
+export type App = Questpie<
+	QuestpieConfig & {
+		collections: AppCollections;
+		globals: AppGlobals;
+		jobs: AppJobs;
+		routes: AppRoutes;
+		services: AppServices;
+	}
+>;
+
+// ── AppContext augmentation — auto-types ALL handlers ──────
+declare module "questpie" {
+	interface AppContext {
+		// Infrastructure
+		db: App["db"];
+		email: App["email"];
+		queue: App["queue"];
+		storage: App["storage"];
+		kv: App["kv"];
+		logger: App["logger"];
+		search: App["search"];
+		realtime: App["realtime"];
+
+		// Entity APIs
+		collections: App["collections"];
+		globals: App["globals"];
+
+		// Request-scoped
+		session: Awaited<ReturnType<App["auth"]["api"]["getSession"]>> | null;
+		t: (
+			key: string,
+			params?: Record<string, unknown>,
+			locale?: string,
+		) => string;
+	}
+}
+
+/**
+ * Flat config type for client APIs.
+ * Use with `createClient<AppConfig>()` and `createAdminAuthClient<AppConfig>()`.
+ * For handler context, use `AppContext` (auto-typed via module augmentation).
+ */
+export type AppConfig = {
+	collections: AppCollections;
+	globals: AppGlobals;
+};
+
+// ════════════════════════════════════════════════════════════
+// RUNTIME — create the app instance
+// ════════════════════════════════════════════════════════════
+
+export const app = (await createApp(
+	{
+		modules: _modules as any,
+		collections: {
+			"posts.collection": _coll_posts_collection,
+		},
+		globals: {
+			"siteSettings.global": _glob_siteSettings_global,
+		},
+		branding: _branding as any,
+		dashboard: _dashboard as any,
+		sidebar: _sidebar as any,
+	},
+	_runtime,
+)) as unknown as AppConfig & {
+	waitForInit(): Promise<void>;
+	destroy(): Promise<void>;
+};
+
+// ── createContext — typed context for scripts ──────────────
+/**
+ * Create a typed AppContext for use in scripts, tests, or standalone code.
+ * Resolves all services and provides flat access to infrastructure.
+ *
+ * @example
+ * ```ts
+ * import { createContext } from "#questpie";
+ *
+ * const ctx = await createContext();
+ * const posts = await ctx.collections.posts.find({});
+ * ```
+ */
+export const createContext = createContextFactory(app);

package/templates/tanstack-start/src/questpie/server/app.ts

@@ -1,52 +1,10 @@
-import { adminModule, adminRpc } from "@questpie/admin/server";
-import { ConsoleAdapter, q } from "questpie";
-import { env } from "@/lib/env.js";
-import { migrations } from "../../migrations/index.js";
-import { posts } from "./collections/index.js";
-import { configureDashboard } from "./dashboard.js";
-import { siteSettings } from "./globals/index.js";
-import { r } from "./rpc.js";
-import { configureSidebar } from "./sidebar.js";
-
-// ─── CMS Instance ───────────────────────────────────────────────────────────
-// The built CMS application. Standalone — does NOT depend on appRpc.
-
-export const cms = q({ name: "{{projectName}}" })
-	.use(adminModule)
-	.collections({ posts })
-	.globals({ siteSettings })
-	.sidebar(configureSidebar)
-	.branding({ name: "{{projectName}}" })
-	.dashboard(configureDashboard)
-	.auth({
-		emailAndPassword: {
-			enabled: true,
-			requireEmailVerification: false,
-		},
-		baseURL: env.APP_URL,
-		basePath: "/api/cms/auth",
-		secret: env.BETTER_AUTH_SECRET,
-	})
-	.build({
-		app: { url: env.APP_URL },
-		db: { url: env.DATABASE_URL },
-		storage: { basePath: "/api/cms" },
-		migrations,
-		email: {
-			adapter: new ConsoleAdapter({ logHtml: false }),
-		},
-	});
-
-// ─── RPC Router ─────────────────────────────────────────────────────────────
-// Standalone router. Both cms and appRpc are passed to createFetchHandler()
-// in routes/api/cms/$.ts. Add your custom RPC functions here.
-
-export const appRpc = r.router({
-	...adminRpc,
-});
-
-// ─── Type Exports ───────────────────────────────────────────────────────────
-// Used by: rpc.ts (AppCMS for typed handlers), client (AppCMS + AppRpc)
-
-export type AppCMS = typeof cms;
-export type AppRpc = typeof appRpc;
+/**
+ * App Instance
+ *
+ * Re-exports the app from the generated entrypoint.
+ * Run `questpie generate` to regenerate .generated/index.ts.
+ *
+ * If .generated/ does not exist yet, run: bun questpie generate
+ */
+
+export { type App, app } from "./.generated/index";

package/templates/tanstack-start/src/questpie/server/collections/posts.collection.ts

@@ -1,68 +1,54 @@
-import { qb } from "@/questpie/server/builder.js";
+import { collection } from "#questpie/factories";
 
-export const posts = qb
-	.collection("posts")
-	.fields((f) => ({
-		title: f.text({
-			label: "Title",
-			required: true,
-			maxLength: 255,
-		}),
-		slug: f.text({
-			label: "Slug",
-			required: true,
-			maxLength: 255,
-			input: "optional",
-			meta: {
-				admin: {
-					compute: {
-						handler: ({
-							data,
-							prev,
-						}: {
-							data: Record<string, unknown>;
-							prev: { data: Record<string, unknown> };
-						}) => {
-							const title = data.title;
-							const currentSlug = data.slug;
-							const prevTitle = prev.data.title;
+export const posts = collection("posts")
+	.fields(({ f }) => ({
+		title: f.text(255).label("Title").required(),
+		slug: f
+			.text(255)
+			.label("Slug")
+			.required()
+			.inputOptional()
+			.admin({
+				compute: {
+					handler: ({
+						data,
+						prev,
+					}: {
+						data: Record<string, unknown>;
+						prev: { data: Record<string, unknown> };
+					}) => {
+						const title = data.title;
+						const currentSlug = data.slug;
+						const prevTitle = prev.data.title;
 
-							if (currentSlug && prevTitle === title) return undefined;
+						if (currentSlug && prevTitle === title) return undefined;
 
-							if (title && typeof title === "string") {
-								return title
-									.toLowerCase()
-									.replace(/[^a-z0-9]+/g, "-")
-									.replace(/^-|-$/g, "");
-							}
-							return undefined;
-						},
-						deps: ({ data }: { data: Record<string, unknown> }) => [
-							data.title,
-							data.slug,
-						],
-						debounce: 300,
+						if (title && typeof title === "string") {
+							return title
+								.toLowerCase()
+								.replace(/[^a-z0-9]+/g, "-")
+								.replace(/^-|-$/g, "");
+						}
+						return undefined;
 					},
+					deps: ({ data }: { data: Record<string, unknown> }) => [
+						data.title,
+						data.slug,
+					],
+					debounce: 300,
 				},
-			},
-		}),
-		content: f.richText({
-			label: "Content",
-		}),
-		published: f.boolean({
-			label: "Published",
-			default: false,
-			required: true,
-		}),
+			}),
+		content: f.richText().label("Content"),
+		published: f.boolean().label("Published").default(false).required(),
 	}))
 	.title(({ f }) => f.title)
 	.admin(({ c }) => ({
 		label: "Posts",
 		icon: c.icon("ph:article"),
 	}))
-	.list(({ v }) => v.table({}))
+	.list(({ v }) => v.collectionTable({}))
 	.form(({ v, f }) =>
-		v.form({
+		v.collectionForm({
 			sidebar: {
 				position: "right",
 				fields: [f.slug, f.published],