nitro-graphql 2.0.0-beta.38 → 2.0.0-beta.39

package/README.md

@@ -1,6 +1,6 @@
 <div align="center">
 
-<img src="./.docs/public/logo.svg" alt="Nitro GraphQL Logo" width="120" height="120">
+<img src="./.github/assets/logo.svg" alt="Nitro GraphQL Logo" width="120" height="120">
 
 # Nitro GraphQL
 
@@ -633,7 +633,7 @@ import { defineResolver, defineQuery, defineMutation, defineField, defineDirecti
 | `defineGraphQLConfig` | GraphQL server config | `defineGraphQLConfig({ maskedErrors: {...} })` |
 | `defineSchema` | Schema with Zod integration | `defineSchema({ Book: selectBookSchema })` |
 
-**Additional Utilities** from `nitro-graphql/utils`:
+**Additional Utilities** from `nitro-graphql/core`:
 - `createDefaultMaskError()` - Error handler for ZodError and HTTPError (use in `defineGraphQLConfig`)
 
 ### Type Generation

package/dist/cli/commands/index.mjs

@@ -1,5 +1,5 @@
-import { generateAll, generateClient, generateServer } from "./generate.mjs";
 import { init } from "./init.mjs";
+import { generateAll, generateClient, generateServer } from "./generate.mjs";
 import { validate } from "./validate.mjs";
 
 export { generateAll, generateClient, generateServer, init, validate };

package/dist/cli/commands/init.d.mts

@@ -3,10 +3,41 @@ import { CLIContext } from "../index.mjs";
 //#region src/cli/commands/init.d.ts
 
 /**
- * Initialize project structure
+ * Available templates from the examples directory
+ */
+declare const AVAILABLE_TEMPLATES: readonly [{
+  readonly name: "drizzle-orm";
+  readonly description: "Nitro + GraphQL + Drizzle ORM with PostgreSQL";
+}, {
+  readonly name: "vite";
+  readonly description: "Vite + Nitro GraphQL integration";
+}, {
+  readonly name: "vite-react";
+  readonly description: "Vite + React + Nitro GraphQL";
+}, {
+  readonly name: "vite-vue";
+  readonly description: "Vite + Vue + Nitro GraphQL";
+}, {
+  readonly name: "better-auth";
+  readonly description: "Nitro + GraphQL + Better Auth integration";
+}];
+type TemplateName = typeof AVAILABLE_TEMPLATES[number]['name'];
+/**
+ * List available templates
+ */
+declare function listTemplates(): void;
+/**
+ * Initialize project from template
+ */
+declare function initFromTemplate(projectName: string, templateName: string, options?: {
+  force?: boolean;
+  cwd?: string;
+}): Promise<void>;
+/**
+ * Initialize project structure (basic scaffolding)
  */
 declare function init(ctx: CLIContext, options?: {
   force?: boolean;
 }): Promise<void>;
 //#endregion
-export { init };
+export { AVAILABLE_TEMPLATES, TemplateName, init, initFromTemplate, listTemplates };

package/dist/cli/commands/init.mjs

@@ -1,12 +1,103 @@
 import { LOG_TAG } from "../../core/constants.mjs";
 import consola from "consola";
-import { join, relative } from "pathe";
-import { existsSync, mkdirSync, writeFileSync } from "node:fs";
+import { basename, join, relative, resolve } from "pathe";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { downloadTemplate } from "giget";
 
 //#region src/cli/commands/init.ts
 const logger = consola.withTag(LOG_TAG);
 /**
-* Initialize project structure
+* Available templates from the examples directory
+*/
+const AVAILABLE_TEMPLATES = [
+	{
+		name: "drizzle-orm",
+		description: "Nitro + GraphQL + Drizzle ORM with PostgreSQL"
+	},
+	{
+		name: "vite",
+		description: "Vite + Nitro GraphQL integration"
+	},
+	{
+		name: "vite-react",
+		description: "Vite + React + Nitro GraphQL"
+	},
+	{
+		name: "vite-vue",
+		description: "Vite + Vue + Nitro GraphQL"
+	},
+	{
+		name: "better-auth",
+		description: "Nitro + GraphQL + Better Auth integration"
+	}
+];
+/**
+* Default GitHub template source
+*/
+const DEFAULT_TEMPLATE_REGISTRY = "github:productdevbook/nitro-graphql/examples";
+/**
+* List available templates
+*/
+function listTemplates() {
+	logger.info("Available templates:\n");
+	for (const template of AVAILABLE_TEMPLATES) console.log(`  ${template.name.padEnd(15)} - ${template.description}`);
+	console.log("\nUsage:");
+	console.log("  nitro-graphql init <project-name> --template <template-name>");
+	console.log("  nitro-graphql init my-app -t drizzle-orm");
+	console.log("\nCustom templates:");
+	console.log("  nitro-graphql init my-app -t gh:user/repo");
+	console.log("  nitro-graphql init my-app -t github:user/repo/subdir");
+}
+/**
+* Initialize project from template
+*/
+async function initFromTemplate(projectName, templateName, options = {}) {
+	const { force, cwd = process.cwd() } = options;
+	const targetDir = resolve(cwd, projectName);
+	if (existsSync(targetDir) && !force) {
+		logger.error(`Directory "${projectName}" already exists. Use --force to overwrite.`);
+		process.exit(1);
+	}
+	let templateSource;
+	if (templateName.includes(":") || templateName.includes("/")) templateSource = templateName;
+	else {
+		if (!AVAILABLE_TEMPLATES.find((t) => t.name === templateName)) {
+			logger.error(`Unknown template: "${templateName}"`);
+			logger.info("Use --list to see available templates");
+			process.exit(1);
+		}
+		templateSource = `${DEFAULT_TEMPLATE_REGISTRY}/${templateName}`;
+	}
+	logger.info(`Downloading template: ${templateName}`);
+	logger.debug(`Source: ${templateSource}`);
+	try {
+		const result = await downloadTemplate(templateSource, {
+			dir: targetDir,
+			force
+		});
+		logger.success(`Template downloaded to: ${result.dir}`);
+		const packageJsonPath = join(targetDir, "package.json");
+		if (existsSync(packageJsonPath)) try {
+			const packageJson = JSON.parse(readFileSync(packageJsonPath, "utf-8"));
+			packageJson.name = basename(projectName).replace(/[^a-z0-9-]/gi, "-").replace(/^-+|-+$/g, "").toLowerCase() || "my-graphql-app";
+			writeFileSync(packageJsonPath, `${JSON.stringify(packageJson, null, 2)}\n`, "utf-8");
+			logger.debug(`Updated package.json name to: ${packageJson.name}`);
+		} catch {
+			logger.warn("Could not update package.json name");
+		}
+		console.log("");
+		logger.info("Next steps:");
+		console.log(`  cd ${projectName}`);
+		console.log("  pnpm install");
+		console.log("  pnpm dev");
+		console.log("");
+	} catch (error) {
+		logger.error("Failed to download template:", error);
+		process.exit(1);
+	}
+}
+/**
+* Initialize project structure (basic scaffolding)
 */
 async function init(ctx, options = {}) {
 	const { force } = options;
@@ -97,4 +188,4 @@ export const helloQueries = defineQuery({
 }
 
 //#endregion
-export { init };
+export { AVAILABLE_TEMPLATES, init, initFromTemplate, listTemplates };

package/dist/cli/completions.d.mts

@@ -0,0 +1,7 @@
+import { ArgsDef, CommandDef } from "citty";
+
+//#region src/cli/completions.d.ts
+
+declare function initCompletions<T extends ArgsDef = ArgsDef>(command: CommandDef<T>): Promise<void>;
+//#endregion
+export { initCompletions };

package/dist/cli/completions.mjs

@@ -0,0 +1,34 @@
+import { AVAILABLE_TEMPLATES } from "./commands/init.mjs";
+
+//#region src/cli/completions.ts
+async function initCompletions(command) {
+	const { default: tab } = await import("@bomb.sh/tab/citty");
+	await tab(command, { subCommands: {
+		"init": { options: {
+			template: (complete) => {
+				for (const template of AVAILABLE_TEMPLATES) complete(template.name, template.description);
+				complete("gh:", "GitHub shorthand (gh:user/repo)");
+				complete("github:", "GitHub template (github:user/repo/path)");
+				complete("gitlab:", "GitLab template (gitlab:user/repo)");
+			},
+			cwd: (complete) => {
+				complete(".", "Current directory");
+			}
+		} },
+		"generate": { options: { cwd: (complete) => {
+			complete(".", "Current directory");
+		} } },
+		"generate:server": { options: { cwd: (complete) => {
+			complete(".", "Current directory");
+		} } },
+		"generate:client": { options: { cwd: (complete) => {
+			complete(".", "Current directory");
+		} } },
+		"validate": { options: { cwd: (complete) => {
+			complete(".", "Current directory");
+		} } }
+	} });
+}
+
+//#endregion
+export { initCompletions };

package/dist/cli/index.mjs

@@ -173,9 +173,14 @@ const validateCommand = defineCommand({
 const initCommand = defineCommand({
 	meta: {
 		name: "init",
-		description: "Initialize project structure"
+		description: "Initialize project structure or download a template"
 	},
 	args: {
+		projectName: {
+			type: "positional",
+			description: "Project name (directory to create)",
+			required: false
+		},
 		cwd: {
 			type: "string",
 			description: "Set working directory"
@@ -184,12 +189,36 @@ const initCommand = defineCommand({
 			type: "boolean",
 			alias: "f",
 			description: "Force overwrite existing files"
+		},
+		template: {
+			type: "string",
+			alias: "t",
+			description: "Template to use (e.g., drizzle-orm, vite-react)"
+		},
+		list: {
+			type: "boolean",
+			alias: "l",
+			description: "List available templates"
 		}
 	},
 	async run({ args }) {
+		const { listTemplates, initFromTemplate, init } = await import("./commands/init.mjs");
+		if (args.list) {
+			listTemplates();
+			return;
+		}
+		if (args.template) {
+			const projectName = args.projectName || args.template;
+			logger.info(`Creating project "${projectName}" from template "${args.template}"...`);
+			await initFromTemplate(projectName, args.template, {
+				force: Boolean(args.force),
+				cwd: args.cwd || process.cwd()
+			});
+			logger.success("Project created successfully!");
+			return;
+		}
 		const ctx = await createCLIContext({ cwd: args.cwd });
 		logger.info("Initializing nitro-graphql project...");
-		const { init } = await import("./commands/init.mjs");
 		await init(ctx, { force: Boolean(args.force) });
 		logger.success("Project initialized!");
 	}
@@ -213,7 +242,12 @@ const main = defineCommand({
 		"init": initCommand
 	}
 });
-runMain(main);
+async function run() {
+	const { initCompletions } = await import("./completions.mjs");
+	await initCompletions(main);
+	return runMain(main);
+}
+run();
 
 //#endregion
 export { createCLIContext, defineConfig, loadConfig };

package/dist/core/utils/errors.d.mts

@@ -24,7 +24,7 @@ interface MaskErrorOptions {
  * @example Basic usage
  * ```ts
  * import { defineGraphQLConfig } from 'nitro-graphql/define'
- * import { createDefaultMaskError } from 'nitro-graphql/core/utils'
+ * import { createDefaultMaskError } from 'nitro-graphql/core'
  *
  * export default defineGraphQLConfig({
  *   maskedErrors: {
@@ -36,7 +36,7 @@ interface MaskErrorOptions {
  * @example Custom status codes
  * ```ts
  * import { defineGraphQLConfig } from 'nitro-graphql/define'
- * import { createDefaultMaskError } from 'nitro-graphql/core/utils'
+ * import { createDefaultMaskError } from 'nitro-graphql/core'
  *
  * export default defineGraphQLConfig({
  *   maskedErrors: {
@@ -51,7 +51,7 @@ interface MaskErrorOptions {
  * @example Custom error handling with fallback to default
  * ```ts
  * import { defineGraphQLConfig } from 'nitro-graphql/define'
- * import { createDefaultMaskError } from 'nitro-graphql/core/utils'
+ * import { createDefaultMaskError } from 'nitro-graphql/core'
  *
  * const defaultMaskError = createDefaultMaskError()
  *

package/dist/core/utils/errors.mjs

@@ -14,7 +14,7 @@ import { GraphQLError } from "graphql";
 * @example Basic usage
 * ```ts
 * import { defineGraphQLConfig } from 'nitro-graphql/define'
-* import { createDefaultMaskError } from 'nitro-graphql/core/utils'
+* import { createDefaultMaskError } from 'nitro-graphql/core'
 *
 * export default defineGraphQLConfig({
 *   maskedErrors: {
@@ -26,7 +26,7 @@ import { GraphQLError } from "graphql";
 * @example Custom status codes
 * ```ts
 * import { defineGraphQLConfig } from 'nitro-graphql/define'
-* import { createDefaultMaskError } from 'nitro-graphql/core/utils'
+* import { createDefaultMaskError } from 'nitro-graphql/core'
 *
 * export default defineGraphQLConfig({
 *   maskedErrors: {
@@ -41,7 +41,7 @@ import { GraphQLError } from "graphql";
 * @example Custom error handling with fallback to default
 * ```ts
 * import { defineGraphQLConfig } from 'nitro-graphql/define'
-* import { createDefaultMaskError } from 'nitro-graphql/core/utils'
+* import { createDefaultMaskError } from 'nitro-graphql/core'
 *
 * const defaultMaskError = createDefaultMaskError()
 *

package/dist/define.d.mts

@@ -195,7 +195,7 @@ declare function defineField(resolvers: Resolvers): Resolvers;
  *
  * @example
  * ```typescript
- * import { createDefaultMaskError } from 'nitro-graphql/utils'
+ * import { createDefaultMaskError } from 'nitro-graphql/core'
  *
  * // GraphQL Yoga configuration
  * export default defineGraphQLConfig({

package/dist/define.mjs

@@ -203,7 +203,7 @@ function defineField(resolvers) {
 *
 * @example
 * ```typescript
-* import { createDefaultMaskError } from 'nitro-graphql/utils'
+* import { createDefaultMaskError } from 'nitro-graphql/core'
 *
 * // GraphQL Yoga configuration
 * export default defineGraphQLConfig({

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "nitro-graphql",
   "type": "module",
-  "version": "2.0.0-beta.38",
+  "version": "2.0.0-beta.39",
   "description": "GraphQL integration for Nitro",
   "license": "MIT",
   "repository": {
@@ -85,6 +85,7 @@
   },
   "dependencies": {
     "@apollo/subgraph": "^2.12.2",
+    "@bomb.sh/tab": "^0.0.11",
     "@graphql-codegen/core": "^5.0.0",
     "@graphql-codegen/import-types-preset": "^3.0.1",
     "@graphql-codegen/typed-document-node": "^6.1.5",
@@ -103,6 +104,7 @@
     "citty": "^0.1.6",
     "consola": "^3.4.2",
     "defu": "^6.1.4",
+    "giget": "^2.0.0",
     "graphql-config": "^5.1.5",
     "graphql-scalars": "^1.25.0",
     "knitwork": "^1.3.0",