create-questpie 2.0.3 → 2.1.0

package/templates/next/src/app/page.tsx

@@ -0,0 +1,74 @@
+import Link from "next/link";
+
+export default function Home() {
+	return (
+		<main className="mx-auto flex min-h-screen max-w-3xl flex-col items-center justify-center px-6 py-16 text-center">
+			<span className="text-muted-foreground mb-4 text-xs font-medium uppercase tracking-widest">
+				Powered by QUESTPIE
+			</span>
+			<h1 className="text-4xl font-bold tracking-tight sm:text-5xl">
+				{"{{projectName}}"}
+			</h1>
+			<p className="text-muted-foreground mt-4 text-lg">
+				Your QUESTPIE app is running. Here is where to go next.
+			</p>
+
+			<div className="mt-12 grid w-full grid-cols-1 gap-4 text-left sm:grid-cols-3">
+				<Link
+					href="/admin"
+					className="group hover:border-primary/30 block rounded-lg border p-5 transition-all hover:shadow-md"
+				>
+					<h2 className="group-hover:text-primary font-semibold transition-colors">
+						Admin panel
+					</h2>
+					<p className="text-muted-foreground mt-1 text-sm">
+						Manage your content and settings.
+					</p>
+					<span className="text-primary mt-3 inline-block text-sm font-medium">
+						Open /admin →
+					</span>
+				</Link>
+
+				<a
+					href="/api/docs"
+					className="group hover:border-primary/30 block rounded-lg border p-5 transition-all hover:shadow-md"
+				>
+					<h2 className="group-hover:text-primary font-semibold transition-colors">
+						API docs
+					</h2>
+					<p className="text-muted-foreground mt-1 text-sm">
+						Explore the REST API in Scalar.
+					</p>
+					<span className="text-primary mt-3 inline-block text-sm font-medium">
+						Open /api/docs →
+					</span>
+				</a>
+
+				<a
+					href="https://questpie.com/docs"
+					target="_blank"
+					rel="noreferrer"
+					className="group hover:border-primary/30 block rounded-lg border p-5 transition-all hover:shadow-md"
+				>
+					<h2 className="group-hover:text-primary font-semibold transition-colors">
+						Documentation
+					</h2>
+					<p className="text-muted-foreground mt-1 text-sm">
+						Learn the framework and patterns.
+					</p>
+					<span className="text-primary mt-3 inline-block text-sm font-medium">
+						questpie.com/docs →
+					</span>
+				</a>
+			</div>
+
+			<p className="text-muted-foreground mt-12 text-sm">
+				Edit{" "}
+				<code className="bg-muted rounded px-1.5 py-0.5 font-mono text-xs">
+					src/app/page.tsx
+				</code>{" "}
+				to change this page.
+			</p>
+		</main>
+	);
+}

package/templates/next/src/app/providers.tsx

@@ -0,0 +1,11 @@
+"use client";
+
+import { QueryClientProvider } from "@tanstack/react-query";
+
+import { queryClient } from "@/lib/query-client";
+
+export function Providers({ children }: { children: React.ReactNode }) {
+	return (
+		<QueryClientProvider client={queryClient}>{children}</QueryClientProvider>
+	);
+}

package/templates/next/src/lib/auth-client.ts

@@ -0,0 +1,12 @@
+import type { AppConfig } from "@/questpie/server/app";
+import { createAdminAuthClient } from "@questpie/admin/client";
+
+export const authClient = createAdminAuthClient<AppConfig>({
+	baseURL:
+		typeof window !== "undefined"
+			? window.location.origin
+			: process.env.APP_URL || "http://localhost:3000",
+	basePath: "/api/auth",
+});
+
+export type AuthClient = typeof authClient;

package/templates/next/src/lib/client.ts

@@ -0,0 +1,13 @@
+import { createClient } from "questpie/client";
+
+import type { AppConfig } from "@/questpie/server/app";
+
+export const client = createClient<AppConfig>({
+	baseURL:
+		typeof window !== "undefined"
+			? window.location.origin
+			: process.env.APP_URL || "http://localhost:3000",
+	basePath: "/api",
+});
+
+export type AppClient = typeof client;

package/templates/next/src/lib/env.ts

@@ -0,0 +1,24 @@
+import { createEnv } from "@t3-oss/env-core";
+import { z } from "zod";
+
+export const env = createEnv({
+	server: {
+		DATABASE_URL: z.string().url(),
+		APP_URL: z.string().url().default("http://localhost:3000"),
+		PORT: z
+			.string()
+			.transform(Number)
+			.pipe(z.number().int().positive())
+			.default(3000),
+		BETTER_AUTH_SECRET: z.string().min(1).default("change-me-in-production"),
+		MAIL_ADAPTER: z.enum(["console", "smtp"]).default("console"),
+		SMTP_HOST: z.string().optional(),
+		SMTP_PORT: z
+			.string()
+			.transform(Number)
+			.pipe(z.number().int().positive())
+			.optional(),
+	},
+	runtimeEnv: process.env,
+	emptyStringAsUndefined: true,
+});

package/templates/next/src/lib/query-client.ts

@@ -0,0 +1,18 @@
+import { QueryClient } from "@tanstack/react-query";
+
+const ONE_MINUTE = 60 * 1000;
+const FIVE_MINUTES = 5 * ONE_MINUTE;
+
+export const queryClient = new QueryClient({
+	defaultOptions: {
+		queries: {
+			staleTime: ONE_MINUTE,
+			gcTime: FIVE_MINUTES,
+			refetchOnWindowFocus: false,
+			retry: 1,
+		},
+		mutations: {
+			retry: 0,
+		},
+	},
+});

package/templates/next/src/lib/query.ts

@@ -0,0 +1,18 @@
+import { createQuestpieQueryOptions } from "@questpie/tanstack-query";
+
+import { client } from "@/lib/client";
+
+/**
+ * Typed TanStack Query option builders for this project.
+ *
+ * `q.collections.*`, `q.globals.*`, and `q.routes.*` return `queryOptions()` /
+ * `mutationOptions()` objects you pass straight into `useQuery` / `useMutation`.
+ * Full type inference flows from the server schema via `AppConfig`.
+ *
+ * @example
+ * const { data } = useQuery(q.collections.posts.find({ limit: 10 }));
+ * const create = useMutation(q.collections.posts.create());
+ */
+export const q = createQuestpieQueryOptions(client);
+
+export type QueryOptions = typeof q;

package/templates/next/src/questpie/admin/.generated/client.ts

@@ -0,0 +1,13 @@
+/**
+ * Admin Client Config
+ *
+ * Auto-generated by questpie codegen — do not edit.
+ *
+ * Pass this directly to <AdminLayoutProvider admin={admin} />
+ */
+
+import { default as _modules } from "../modules";
+
+const admin = _modules;
+
+export default admin;

package/templates/next/src/questpie/admin/admin.ts

@@ -0,0 +1,9 @@
+/**
+ * Admin Configuration
+ *
+ * Re-exports the generated admin config.
+ * Import directly from "./.generated/client" in new code.
+ */
+export { default as admin } from "./.generated/client";
+
+export type AdminConfig = typeof import("./.generated/client").default;

package/templates/next/src/questpie/admin/modules.ts

@@ -0,0 +1,3 @@
+import { adminClientModule } from "@questpie/admin/client/modules/admin";
+
+export default [adminClientModule] as const;

package/templates/next/src/questpie/server/.generated/context.gen.ts

@@ -0,0 +1,204 @@
+/* oxlint-disable */
+// AUTO-GENERATED by questpie codegen — DO NOT EDIT
+// Regenerate with: questpie generate
+
+// ── Runtime ────────────────────────────────────────────────
+import _runtime from "../questpie.config";
+
+// ── Modules ────────────────────────────────────────────────
+import _modules from "../modules";
+
+// ── Collections ────────────────────────────────────────────
+import { posts as _coll_posts } from "../collections/posts.collection";
+
+// ── Globals ────────────────────────────────────────────────
+import { siteSettings as _glob_siteSettings } from "../globals/site-settings.global";
+
+// ── Core Singles ───────────────────────────────────────────
+import _authConfig from "../config/auth";
+
+// ── Plugin Singles ─────────────────────────────────────────
+import _adminConfig from "../config/admin";
+import _openapi from "../config/openapi";
+
+import type { AppCollections, AppGlobals, AppJobs, _ModuleCollections, _AppDefaultServices, _AppServicesSeam, _AppTopLevelServices, _AppCustomServiceNamespaces, _Registry_Collections, _Registry_Globals, _Registry_Jobs, _Registry_Routes, _Registry_Services, _Registry_Emails, _Registry_FieldTypes, _Registry_Views, _Registry_Components, _Registry_Blocks, _AllModuleFields } from "./entities.gen";
+import type { AnyCollectionOrBuilder, AnyGlobalOrBuilder, CollectionAPI, DrizzleClientFromQuestpieConfig, InferContextExtensionsFromAppConfig, InferSessionFromAuthConfig, MailerService, Questpie, QuestpieConfig, QueueClient, QueueJobType, ServiceInstancesInNamespace, TablesFromConfig, z } from "questpie/types";
+
+type _MPConfigSub<A extends readonly any[], K extends string> = A extends readonly [infer H, ...infer T extends readonly any[]] ? (H extends { config: infer C } ? (C extends Record<K, infer V> ? V : {}) : {}) & _MPConfigSub<T, K> : {};
+type _AppAppConfig = {};
+type _AppContextExtensions = Partial<InferContextExtensionsFromAppConfig<_AppAppConfig>>;
+type _AppAuthConfig = _MPConfigSub<typeof _modules, "auth"> & typeof _authConfig;
+type _AppSessionAuthConfig = _AppAuthConfig;
+type _AppSession = NonNullable<InferSessionFromAuthConfig<_AppSessionAuthConfig>> | null;
+
+type _CollectionsAPI = { [K in keyof AppCollections]: CollectionAPI<AppCollections[K], AppCollections> };
+type _JobHandlerCollections = _ModuleCollections & {
+	posts: typeof _coll_posts;
+};
+type _JobHandlerCollectionsAPI = {
+	posts: CollectionAPI<typeof _coll_posts, _JobHandlerCollections>;
+};
+type _ExecutionContextJob<T> = T extends { name: infer TName extends string; schema: z.ZodSchema<infer TPayload> } ? QueueJobType<TPayload, TName> : never;
+type _ExecutionContextJobs = {};
+type _ExecutionContextServiceDefinitions = {};
+type _ExecutionContextDefaultServices = ServiceInstancesInNamespace<_ExecutionContextServiceDefinitions, "services">;
+type _AppCollectionDefinitions = AppCollections & Record<string, AnyCollectionOrBuilder>;
+type _AppGlobalDefinitions = AppGlobals & Record<string, AnyGlobalOrBuilder>;
+type _AppQuestpieConfig = Omit<QuestpieConfig, "app" | "db" | "collections" | "globals" | "auth" | "~contextExtensions"> & {
+	app: (typeof _runtime)["app"];
+	db: (typeof _runtime)["db"];
+	collections: _AppCollectionDefinitions;
+	globals: _AppGlobalDefinitions;
+	auth: _AppAuthConfig;
+	storage: (typeof _runtime)["storage"];
+	"~contextExtensions": _AppContextExtensions;
+};
+type _AppQuestpieBase = Questpie<_AppQuestpieConfig>;
+type _AppDb = DrizzleClientFromQuestpieConfig<_AppQuestpieConfig>;
+type _AppGlobalsAPI = _AppQuestpieBase["globals"];
+type _AppStorage = _AppQuestpieBase["storage"];
+type _AppTables = TablesFromConfig<_AppQuestpieConfig>;
+export type _AppQuestpie = Omit<_AppQuestpieBase, "collections" | "globals"> & {
+	collections: _CollectionsAPI;
+	globals: _AppGlobalsAPI;
+};
+
+// ── AppContext augmentation — auto-types ALL handlers ──────
+type _AppInfraRecord = {
+	// Infrastructure
+	app: _AppQuestpie;
+	db: _AppDb;
+	email: _AppQuestpie["email"];
+	queue: QueueClient<AppJobs>;
+	storage: _AppStorage;
+	kv: _AppQuestpie["kv"];
+	logger: _AppQuestpie["logger"];
+	search: _AppQuestpie["search"];
+	realtime: _AppQuestpie["realtime"];
+
+	// Entity APIs
+	collections: _CollectionsAPI;
+	globals: _AppGlobalsAPI;
+	tables: _AppTables;
+
+	// Request-scoped
+	session: _AppSession;
+	t: (key: string, params?: Record<string, unknown>, locale?: string) => string;
+
+	// User services
+	services: _AppDefaultServices;
+};
+type _AppInfraContext = _AppInfraRecord & _AppCustomServiceNamespaces;
+type _AppCoreContext = _AppContextExtensions & _AppInfraContext;
+type _ServiceCreateInfra = Omit<_AppInfraRecord, "services"> & { services: Questpie.Services };
+
+declare global {
+	namespace Questpie {
+		interface AppContext extends _AppCoreContext, _AppTopLevelServices {}
+
+		interface JobHandlerContext {
+			// Infrastructure
+			db: _AppDb;
+			email: _AppQuestpie["email"];
+			queue: QueueClient<_ExecutionContextJobs>;
+			storage: _AppStorage;
+			kv: _AppQuestpie["kv"];
+			logger: _AppQuestpie["logger"];
+			search: _AppQuestpie["search"];
+			realtime: _AppQuestpie["realtime"];
+
+			// Entity APIs
+			collections: _JobHandlerCollectionsAPI;
+			globals: _AppGlobalsAPI;
+			tables: _AppTables;
+
+			// Request-scoped
+			session: _AppSession;
+			t: (key: string, params?: Record<string, unknown>, locale?: string) => string;
+
+			// Top-level services (namespace: null)
+			workflows?: _AppTopLevelServices extends { workflows: infer W } ? W : never;
+
+			// User services
+			services: _ExecutionContextDefaultServices;
+		}
+
+		interface WorkflowContext {
+			// Infrastructure
+			db: _AppDb;
+			email: _AppQuestpie["email"];
+			queue: QueueClient<_ExecutionContextJobs>;
+			storage: _AppStorage;
+			kv: _AppQuestpie["kv"];
+			logger: _AppQuestpie["logger"];
+			search: _AppQuestpie["search"];
+			realtime: _AppQuestpie["realtime"];
+
+			// Entity APIs
+			collections: _JobHandlerCollectionsAPI;
+			globals: _AppGlobalsAPI;
+			tables: _AppTables;
+
+			// Request-scoped
+			session: _AppSession;
+			t: (key: string, params?: Record<string, unknown>, locale?: string) => string;
+
+			// Top-level services (namespace: null)
+			workflows?: _AppTopLevelServices extends { workflows: infer W } ? W : never;
+
+			// User services
+			services: _ExecutionContextDefaultServices;
+		}
+
+		interface Services extends _AppServicesSeam {}
+		interface ServiceCreateContext extends _AppContextExtensions, _ServiceCreateInfra {}
+		// Names-only marker — the `ServiceCreateContext` fallback conditional
+		// probes THIS interface's keys instead of the real one (whose base
+		// resolves through module service definitions and would cycle).
+		interface ServiceCreateContextGenerated { generated: unknown }
+
+		// Typed service surface for appConfig({ context }) resolvers.
+		// Excludes _AppContextExtensions — the resolver produces them.
+		interface ContextResolverContext {
+			collections: _CollectionsAPI;
+			globals: _AppGlobalsAPI;
+			logger: _AppQuestpie["logger"];
+			kv: _AppQuestpie["kv"];
+			queue: QueueClient<AppJobs>;
+			t: (key: string, params?: Record<string, unknown>, locale?: string) => string;
+			services: _AppDefaultServices;
+		}
+
+		// App-level hook / default-access ctx infra seams (CL-05).
+		// Filled with the real infra MINUS _AppContextExtensions, so the
+		// app-level hooks/access predicates get precise db/session/
+		// collections/globals/queue WITHOUT re-entering the extensions cycle.
+		interface AppHookContext extends _AppInfraContext {}
+		interface AppDefaultAccessContext extends _AppInfraContext {}
+
+		// appConfig({ context }) resolver session/db — off the cyclic edge.
+		interface ContextResolverBase {
+			session: _AppSession;
+			db: _AppDb;
+		}
+
+		interface Registry {
+			collections: _Registry_Collections;
+			globals: _Registry_Globals;
+			jobs: _Registry_Jobs;
+			routes: _Registry_Routes;
+			services: _Registry_Services;
+			emails: _Registry_Emails;
+			"~fieldTypes": _Registry_FieldTypes & _AllModuleFields;
+			views: _Registry_Views;
+			components: _Registry_Components;
+			blocks: _Registry_Blocks;
+		}
+	}
+}
+
+/** Resolved auth session for this app (`{ user, session } | null`). */
+export type AppSession = _AppSession;
+
+/** Authenticated user shape from the app session. */
+export type AppSessionUser = NonNullable<_AppSession>["user"];

package/templates/next/src/questpie/server/.generated/entities.gen.ts

@@ -0,0 +1,100 @@
+/* oxlint-disable */
+// AUTO-GENERATED by questpie codegen — DO NOT EDIT
+// Regenerate with: questpie generate
+
+import "./names.gen";
+// ── Runtime ────────────────────────────────────────────────
+import _runtime from "../questpie.config";
+
+// ── Modules ────────────────────────────────────────────────
+import _modules from "../modules";
+
+// ── Collections ────────────────────────────────────────────
+import { posts as _coll_posts } from "../collections/posts.collection";
+
+// ── Globals ────────────────────────────────────────────────
+import { siteSettings as _glob_siteSettings } from "../globals/site-settings.global";
+
+// ── Core Singles ───────────────────────────────────────────
+import _authConfig from "../config/auth";
+
+// ── Plugin Singles ─────────────────────────────────────────
+import _adminConfig from "../config/admin";
+import _openapi from "../config/openapi";
+
+import type { RouteParamsFromKey, RouteWithParams } from "questpie/types";
+
+// ════════════════════════════════════════════════════════════
+// TYPES — composed from typeof references (zero inference cost)
+// ════════════════════════════════════════════════════════════
+
+import type { ExtractModulePropArr, ExtractModulePropArrOverride, ServiceCustomNamespaceInstances, ServiceInstanceOf, ServiceInstancesInNamespace, ServiceTopLevelInstances } from "questpie/types";
+type _RouteDefinitionWithoutHandler<T> = T extends { mode: "raw" } ? Omit<T, "handler"> & { handler: (args: unknown) => Response | Promise<Response> } : Omit<T, "handler"> & { handler: (args: unknown) => unknown | Promise<unknown> };
+export type _ModuleCollections = ExtractModulePropArrOverride<typeof _modules, "collections">;
+export type _ModuleGlobals = ExtractModulePropArr<typeof _modules, "globals">;
+export type _ModuleJobs = ExtractModulePropArr<typeof _modules, "jobs">;
+export type _ModuleRoutes = ExtractModulePropArr<typeof _modules, "routes">;
+export type _ModuleServices = {};
+export type _ModuleFieldTypes = ExtractModulePropArr<typeof _modules, "fieldTypes">;
+export type _ModuleViews = ExtractModulePropArr<typeof _modules, "views">;
+export type _ModuleComponents = ExtractModulePropArr<typeof _modules, "components">;
+export type _ModuleBlocks = ExtractModulePropArr<typeof _modules, "blocks">;
+// Registry category extraction from modules
+export type _Registry_Collections = ExtractModulePropArrOverride<typeof _modules, "collections">;
+export type _Registry_Globals = ExtractModulePropArr<typeof _modules, "globals">;
+export type _Registry_Jobs = ExtractModulePropArr<typeof _modules, "jobs">;
+export type _Registry_Routes = ExtractModulePropArr<typeof _modules, "routes">;
+export type _Registry_Services = {};
+export type _Registry_Emails = ExtractModulePropArr<typeof _modules, "emails">;
+export type _Registry_FieldTypes = ExtractModulePropArr<typeof _modules, "fieldTypes">;
+export type _Registry_Views = ExtractModulePropArr<typeof _modules, "views">;
+export type _Registry_Components = ExtractModulePropArr<typeof _modules, "components">;
+export type _Registry_Blocks = ExtractModulePropArr<typeof _modules, "blocks">;
+
+// Recursive module property extraction (for fields contributed at each level)
+import type { ExtractModuleProp } from "questpie/types";
+
+export type _AllModuleFields = ExtractModuleProp<{ modules: typeof _modules }, "fields">;
+
+/** All collections in the app (modules + user, user overrides) */
+export type AppCollections = _ModuleCollections & {
+	posts: typeof _coll_posts;
+};
+
+/** All globals in the app (modules + user, user overrides) */
+export type AppGlobals = _ModuleGlobals & {
+	siteSettings: typeof _glob_siteSettings;
+};
+
+/** 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 service definitions in the app (modules + user, user overrides). */
+type _AppServiceDefinitions = _ModuleServices;
+
+/** All services in the app as resolved service instances. */
+export type AppServices = {
+	[K in keyof _AppServiceDefinitions]: ServiceInstanceOf<_AppServiceDefinitions[K]>;
+};
+export type _AppDefaultServices = ServiceInstancesInNamespace<_AppServiceDefinitions, "services">;
+export type _AppServicesSeam = { [K in keyof _AppServiceDefinitions]: ServiceInstanceOf<_AppServiceDefinitions[K]> };
+export type _AppTopLevelServices = ServiceTopLevelInstances<_AppServiceDefinitions>;
+export type _AppCustomServiceNamespaces = ServiceCustomNamespaceInstances<_AppServiceDefinitions>;
+
+/** All email templates in the app — use with email.sendTemplate() */
+export type AppEmailTemplates = Record<string, never>;
+
+/** All fieldtypes in the app (modules + user, user overrides) */
+export type AppFieldTypes = _ModuleFieldTypes;
+
+/** All views in the app (modules + user, user overrides) */
+export type AppViews = _ModuleViews;
+
+/** All components in the app (modules + user, user overrides) */
+export type AppComponents = _ModuleComponents;
+
+/** All blocks in the app (modules + user, user overrides) */
+export type AppBlocks = _ModuleBlocks;