create-questpie 2.0.4 → 2.1.0

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

@@ -0,0 +1,200 @@
+/* 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 _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, _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;
+		}
+	}
+}
+
+/** 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/hono/src/questpie/server/.generated/entities.gen.ts

@@ -0,0 +1,84 @@
+/* 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 _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">;
+// 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">;
+
+// 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;

package/templates/hono/src/questpie/server/.generated/factories.ts

@@ -0,0 +1,65 @@
+/* oxlint-disable */
+// AUTO-GENERATED by questpie codegen — DO NOT EDIT
+// Typed factory functions with plugin extensions. Regenerate with: questpie generate
+
+// ── Core Imports ───────────────────────────────────────────
+import { CollectionBuilder, GlobalBuilder, builtinFields, type EmptyCollectionState, type EmptyGlobalState, type BuiltinFields } from "questpie/builders";
+
+// Merged field factories — builtins + module-contributed (e.g. richText, blocks) + user fields
+const _rawFieldDefs = { ...builtinFields } as const;
+
+const _allFieldDefs = _rawFieldDefs;
+
+// ── Entity key registry (names only — acyclic by construction) ─────
+declare global {
+	namespace Questpie {
+		interface CollectionKeys { posts: unknown }
+		interface GlobalKeys { siteSettings: unknown }
+	}
+}
+
+// ── Plugin Imports ─────────────────────────────────────────
+import { type AppConfigInput, type AuthConfig } from "questpie/types";
+import { type OpenApiModuleConfig } from "@questpie/openapi";
+
+// Field types — populated by module codegen via Questpie.FieldTypesMap
+type _AllFieldTypes = Questpie.FieldTypesMap;
+
+// ════════════════════════════════════════════════════════════
+// 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(255).required() }))
+ * ```
+ */
+export function collection<TName extends string>(name: TName): CollectionBuilder<EmptyCollectionState<TName, undefined, _AllFieldTypes>> {
+	return CollectionBuilder.create<TName, _AllFieldTypes>(name, _allFieldDefs);
+}
+
+/**
+ * Create a typed global builder with plugin extensions.
+ */
+export function global<TName extends string>(name: TName): GlobalBuilder<EmptyGlobalState<TName, undefined, _AllFieldTypes>> {
+	return GlobalBuilder.create<TName, _AllFieldTypes>(name, _allFieldDefs);
+}
+
+// ════════════════════════════════════════════════════════════
+// Singleton factory functions
+// ════════════════════════════════════════════════════════════
+
+/** Typed factory for appConfig config. */
+export function appConfig<T extends AppConfigInput>(config: T): T { return config; }
+
+/** Typed factory for authConfig config. */
+export function authConfig<T extends AuthConfig>(config: T): T { return config; }
+
+/** Typed factory for openapi config. */
+export function openapi<T extends OpenApiModuleConfig>(config: T): T { return config; }

package/templates/hono/src/questpie/server/.generated/index.ts

@@ -0,0 +1,131 @@
+/* oxlint-disable */
+// AUTO-GENERATED by questpie codegen — DO NOT EDIT
+// Regenerate with: questpie generate
+
+import { createApp, createContextFactory } from "questpie/app";
+import "./names.gen";
+import type { AccessContext, AppDefinition, CollectionSelect, GlobalSelect, HookContext } from "questpie/types";
+import type { AppCollections, AppGlobals, AppRoutes } from "./entities.gen";
+import type { _AppQuestpie, AppSession, AppSessionUser } from "./context.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 _openapi from "../config/openapi";
+
+export type * from "./entities.gen";
+export type * from "./context.gen";
+
+/**
+ * Select/document type for a collection key — prefer over `Record<string, any>` for docs.
+ */
+export type CollectionDoc<K extends keyof AppCollections> = CollectionSelect<AppCollections[K]>;
+
+/**
+ * Select/document type for a global key.
+ */
+export type GlobalDoc<K extends keyof AppGlobals> = GlobalSelect<AppGlobals[K]>;
+
+/**
+ * Access-rule ctx for shared helpers. `K` narrows `data` to that collection's row.
+ *
+ * CYCLE RULE: import these only from files NOT imported by a collection
+ * (routes, services, jobs, scripts). Helpers imported by collections take
+ * the package-level `AccessContext` from "questpie" instead — see the
+ * type-inference reference.
+ *
+ * @example
+ * ```ts
+ * export async function isOwner(ctx: AccessRuleContext<"posts">) {
+ *   return ctx.data?.authorId === ctx.session?.user.id; // ctx.collections typed
+ * }
+ * ```
+ */
+export type AccessRuleContext<K extends keyof AppCollections | unknown = unknown> =
+	AccessContext<K extends keyof AppCollections ? CollectionDoc<K> : unknown>;
+
+/**
+ * Hook ctx for shared helpers. `K` narrows `data` to that collection's row.
+ * Same cycle rule as `AccessRuleContext`.
+ */
+export type HookRuleContext<K extends keyof AppCollections | unknown = unknown> =
+	HookContext<K extends keyof AppCollections ? CollectionDoc<K> : unknown>;
+
+/**
+ * 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;
+	routes: AppRoutes;
+	storage: (typeof _runtime)["storage"];
+	auth: typeof _authConfig;
+};
+
+// ════════════════════════════════════════════════════════════
+// RUNTIME — create the app instance
+// ════════════════════════════════════════════════════════════
+
+var _appPromise: Promise<unknown> | undefined;
+
+_appPromise = createApp(
+	({
+		modules: _modules,
+		collections: {
+			posts: _coll_posts,
+		},
+		globals: {
+			siteSettings: _glob_siteSettings,
+		},
+		config: {
+			auth: _authConfig,
+			openapi: _openapi,
+		},
+	}) satisfies AppDefinition,
+	_runtime,
+);
+
+export const app = (await _appPromise) as unknown as _AppQuestpie;
+
+/** Fully typed QUESTPIE app instance. */
+export type App = typeof app;
+
+// ── 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 async function createContext(
+	options?: Parameters<ReturnType<typeof createContextFactory>>[0],
+) {
+	while (!_appPromise) {
+		await new Promise((resolve) => setTimeout(resolve, 0));
+	}
+
+	return createContextFactory((await _appPromise) as _AppQuestpie)(options);
+}
+
+// Factories: import { collection, global, ... } from '#questpie/factories';

package/templates/hono/src/questpie/server/.generated/names.gen.ts

@@ -0,0 +1,25 @@
+/* oxlint-disable */
+// AUTO-GENERATED by questpie codegen — DO NOT EDIT
+// Regenerate with: questpie generate
+
+// ── Modules ────────────────────────────────────────────────
+import _modules from "../modules";
+
+// ── Module entity-name key sets (distributive `keyof`) ─────
+type _ModuleCollectionsKeyNames = (typeof _modules)[number] extends infer M ? M extends { collections: infer C } ? keyof C & string : never : never;
+type _ModuleGlobalsKeyNames = (typeof _modules)[number] extends infer M ? M extends { globals: infer C } ? keyof C & string : never : never;
+type _ModuleJobsKeyNames = (typeof _modules)[number] extends infer M ? M extends { jobs: infer C } ? keyof C & string : never : never;
+type _ModuleRoutesKeyNames = (typeof _modules)[number] extends infer M ? M extends { routes: infer C } ? keyof C & string : never : never;
+type _ModuleServicesKeyNames = (typeof _modules)[number] extends infer M ? M extends { services: infer C } ? keyof C & string : never : never;
+type _ModuleFieldTypesKeyNames = (typeof _modules)[number] extends infer M ? M extends { fieldTypes: infer C } ? keyof C & string : never : never;
+
+declare global {
+	namespace Questpie {
+		interface CollectionKeys extends Record<_ModuleCollectionsKeyNames, unknown> {}
+		interface GlobalKeys extends Record<_ModuleGlobalsKeyNames, unknown> {}
+		interface JobKeys extends Record<_ModuleJobsKeyNames, unknown> {}
+		interface RouteKeys extends Record<_ModuleRoutesKeyNames, unknown> {}
+		interface ServiceKeys extends Record<_ModuleServicesKeyNames, unknown> {}
+		interface FieldTypeKeys extends Record<_ModuleFieldTypesKeyNames, unknown> {}
+	}
+}

package/templates/hono/src/questpie/server/app.ts

@@ -0,0 +1,10 @@
+/**
+ * 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, type AppConfig, app } from "./.generated/index";

package/templates/hono/src/questpie/server/collections/index.ts

@@ -0,0 +1 @@
+export { posts } from "./posts.collection";

package/templates/hono/src/questpie/server/collections/posts.collection.ts

@@ -0,0 +1,10 @@
+import { collection } from "#questpie/factories";
+
+export const posts = collection("posts")
+	.fields(({ f }) => ({
+		title: f.text(255).label("Title").required(),
+		slug: f.text(255).label("Slug").required(),
+		content: f.textarea().label("Content"),
+		published: f.boolean().label("Published").default(false).required(),
+	}))
+	.title(({ f }) => f.title);

package/templates/hono/src/questpie/server/config/auth.ts

@@ -0,0 +1,8 @@
+import { authConfig } from "questpie/app";
+
+export default authConfig({
+	emailAndPassword: {
+		enabled: true,
+		requireEmailVerification: false,
+	},
+});

package/templates/hono/src/questpie/server/config/openapi.ts

@@ -0,0 +1,10 @@
+import { openApiConfig } from "@questpie/openapi";
+
+export default openApiConfig({
+	info: {
+		title: "{{projectName}} API",
+		version: "1.0.0",
+		description: "QUESTPIE API",
+	},
+	scalar: { theme: "purple" },
+});

package/templates/hono/src/questpie/server/globals/index.ts

@@ -0,0 +1 @@
+export { siteSettings } from "./site-settings.global";

package/templates/hono/src/questpie/server/globals/site-settings.global.ts

@@ -0,0 +1,10 @@
+import { global } from "#questpie/factories";
+
+export const siteSettings = global("siteSettings")
+	.fields(({ f }) => ({
+		siteName: f.text().label("Site Name").required().default("{{projectName}}"),
+		description: f
+			.textarea()
+			.label("Site Description")
+			.default("A QUESTPIE powered site"),
+	}));

package/templates/hono/src/questpie/server/modules.ts

@@ -0,0 +1,8 @@
+/**
+ * Modules — static module dependencies for this project.
+ */
+import { openApiModule } from "@questpie/openapi";
+
+const modules = [openApiModule] as const;
+
+export default modules;

package/templates/hono/src/questpie/server/questpie.config.ts

@@ -0,0 +1,21 @@
+/**
+ * QUESTPIE Runtime Configuration
+ *
+ * Runtime-only configuration: database, adapters, secrets.
+ * Entity definitions (collections, globals, etc.) are codegen-generated.
+ * Admin sidebar, dashboard, and branding live in config/admin.ts.
+ */
+
+import { runtimeConfig } from "questpie/app";
+import { ConsoleAdapter } from "questpie/adapters/console";
+
+import { env } from "@/lib/env";
+
+export default runtimeConfig({
+	app: { url: env.APP_URL },
+	db: { url: env.DATABASE_URL },
+	storage: { basePath: "/api" },
+	email: {
+		adapter: new ConsoleAdapter({ logHtml: false }),
+	},
+});

package/templates/hono/tsconfig.json

@@ -0,0 +1,28 @@
+{
+	"include": ["src/**/*.ts", "*.config.ts"],
+	"exclude": ["node_modules", "dist", "**/*.test.ts"],
+	"compilerOptions": {
+		"target": "ES2022",
+		"module": "ESNext",
+		"lib": ["ES2022", "DOM", "DOM.Iterable"],
+		"types": ["bun-types"],
+		"moduleResolution": "bundler",
+		"resolveJsonModule": true,
+		"allowImportingTsExtensions": true,
+		"verbatimModuleSyntax": false,
+		"noEmit": true,
+		"skipLibCheck": true,
+		"strict": true,
+		"noUnusedLocals": false,
+		"noUnusedParameters": false,
+		"noFallthroughCasesInSwitch": true,
+		"noUncheckedSideEffectImports": true,
+		"baseUrl": ".",
+		"paths": {
+			"@/*": ["./src/*"],
+			"~/*": ["./src/*"],
+			"#questpie": ["./src/questpie/server/.generated/index.ts"],
+			"#questpie/*": ["./src/questpie/server/.generated/*"]
+		}
+	}
+}