@classytic/arc 2.3.0 → 2.4.2

package/dist/cli/commands/docs.mjs

@@ -1,9 +1,8 @@
-import { t as ResourceRegistry } from "../../ResourceRegistry-7Ic20ZMw.mjs";
-import { t as buildOpenApiSpec } from "../../openapi-9nB_kiuR.mjs";
-import { writeFileSync } from "node:fs";
-import { resolve } from "node:path";
+import { t as ResourceRegistry } from "../../ResourceRegistry-DeCIFlix.mjs";
+import { t as buildOpenApiSpec } from "../../openapi-CBmZ6EQN.mjs";
+import { dirname, resolve } from "node:path";
 import { pathToFileURL } from "node:url";
-
+import { mkdirSync, writeFileSync } from "node:fs";
 //#region src/cli/commands/docs.ts
 /**
 * Arc CLI - Docs Command
@@ -41,12 +40,12 @@ async function exportDocs(args) {
 		description: "Auto-generated from Arc resources"
 	});
 	const fullPath = resolve(process.cwd(), outputPath);
+	mkdirSync(dirname(fullPath), { recursive: true });
 	writeFileSync(fullPath, JSON.stringify(spec, null, 2));
 	console.log(`OpenAPI spec exported to: ${fullPath}`);
 	console.log(`\nResources included: ${resources.length}`);
 	console.log(`Total endpoints: ${Object.keys(spec.paths).length}`);
 }
 var docs_default = { exportDocs };
-
 //#endregion
-export { docs_default as default, exportDocs };
+export { docs_default as default, exportDocs };

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

@@ -0,0 +1,10 @@
+//#region src/cli/commands/doctor.d.ts
+/**
+ * Arc CLI - Doctor Command
+ *
+ * Health check utility that validates the development environment.
+ * Checks Node.js version, dependencies, configuration, and env variables.
+ */
+declare function doctor(_args?: string[]): Promise<void>;
+//#endregion
+export { doctor };

package/dist/cli/commands/doctor.mjs

@@ -0,0 +1,156 @@
+import { dirname, join, parse, resolve } from "node:path";
+import { existsSync, readFileSync } from "node:fs";
+//#region src/cli/commands/doctor.ts
+/**
+* Arc CLI - Doctor Command
+*
+* Health check utility that validates the development environment.
+* Checks Node.js version, dependencies, configuration, and env variables.
+*/
+async function doctor(_args = []) {
+	console.log("\nArc Doctor\n");
+	const results = [];
+	const cwd = process.cwd();
+	const nodeVersion = process.versions.node;
+	if (parseInt(nodeVersion.split(".")[0] ?? "0", 10) >= 22) results.push({
+		status: "pass",
+		label: `Node.js ${nodeVersion}`,
+		detail: "required: >=22"
+	});
+	else results.push({
+		status: "fail",
+		label: `Node.js ${nodeVersion}`,
+		detail: "required: >=22"
+	});
+	const pkg = findPackageJson(cwd);
+	const allDeps = {
+		...pkg?.dependencies ?? {},
+		...pkg?.devDependencies ?? {}
+	};
+	const arcVersion = allDeps["@classytic/arc"];
+	if (arcVersion) results.push({
+		status: "pass",
+		label: `@classytic/arc ${arcVersion}`
+	});
+	else results.push({
+		status: "warn",
+		label: "@classytic/arc not found in dependencies"
+	});
+	const fastifyVersion = allDeps.fastify;
+	if (fastifyVersion) {
+		const clean = fastifyVersion.replace(/^[\^~>=<]+/, "").split("-")[0] ?? "0.0.0";
+		if (parseInt(clean.split(".")[0] ?? "0", 10) >= 5) results.push({
+			status: "pass",
+			label: `fastify ${fastifyVersion}`,
+			detail: "required: ^5.0.0"
+		});
+		else results.push({
+			status: "fail",
+			label: `fastify ${fastifyVersion}`,
+			detail: "required: ^5.0.0 — Arc requires Fastify 5"
+		});
+	} else results.push({
+		status: "fail",
+		label: "fastify not found in dependencies",
+		detail: "required: ^5.0.0"
+	});
+	const tsconfigPath = resolve(cwd, "tsconfig.json");
+	if (existsSync(tsconfigPath)) try {
+		const stripped = readFileSync(tsconfigPath, "utf-8").replace(/\/\/.*$/gm, "");
+		const moduleRes = JSON.parse(stripped)?.compilerOptions?.moduleResolution;
+		if (moduleRes && ![
+			"nodenext",
+			"node16",
+			"bundler"
+		].includes(moduleRes.toLowerCase())) results.push({
+			status: "warn",
+			label: "tsconfig.json found",
+			detail: `moduleResolution "${moduleRes}" — recommend "NodeNext" or "Bundler"`
+		});
+		else results.push({
+			status: "pass",
+			label: "tsconfig.json found"
+		});
+	} catch {
+		results.push({
+			status: "pass",
+			label: "tsconfig.json found"
+		});
+	}
+	else results.push({
+		status: "warn",
+		label: "tsconfig.json not found"
+	});
+	for (const dep of [
+		{
+			name: "@fastify/rate-limit",
+			purpose: "rate limiting"
+		},
+		{
+			name: "@fastify/helmet",
+			purpose: "security headers"
+		},
+		{
+			name: "@fastify/cors",
+			purpose: "CORS support"
+		}
+	]) if (allDeps[dep.name]) results.push({
+		status: "pass",
+		label: `${dep.name} installed`
+	});
+	else results.push({
+		status: "warn",
+		label: `${dep.name} not installed`,
+		detail: `${dep.purpose} disabled`
+	});
+	if (allDeps["better-auth"]) results.push({
+		status: "pass",
+		label: `better-auth ${allDeps["better-auth"]}`
+	});
+	for (const env of [{
+		name: "MONGO_URI",
+		severity: "warn",
+		detail: "required at runtime for MongoDB"
+	}, {
+		name: "BETTER_AUTH_SECRET",
+		severity: "warn",
+		detail: "required for Better Auth session encryption"
+	}]) if (process.env[env.name]) results.push({
+		status: "pass",
+		label: `${env.name} set`
+	});
+	else results.push({
+		status: env.severity,
+		label: `${env.name} not set`,
+		detail: env.detail
+	});
+	let passCount = 0;
+	let warnCount = 0;
+	let failCount = 0;
+	for (const r of results) {
+		const icon = r.status === "pass" ? "[pass]" : r.status === "warn" ? "[warn]" : "[FAIL]";
+		const detail = r.detail ? ` (${r.detail})` : "";
+		console.log(`  ${icon} ${r.label}${detail}`);
+		if (r.status === "pass") passCount++;
+		else if (r.status === "warn") warnCount++;
+		else failCount++;
+	}
+	console.log(`\n${passCount} passed, ${warnCount} warnings, ${failCount} failures\n`);
+	if (failCount > 0) process.exitCode = 1;
+}
+function findPackageJson(dir) {
+	let current = resolve(dir);
+	const root = parse(current).root;
+	while (current !== root) {
+		const p = join(current, "package.json");
+		try {
+			if (existsSync(p)) return JSON.parse(readFileSync(p, "utf-8"));
+		} catch {}
+		const parent = dirname(current);
+		if (parent === current) break;
+		current = parent;
+	}
+	return null;
+}
+//#endregion
+export { doctor };

package/dist/cli/commands/generate.mjs

@@ -1,7 +1,6 @@
-import { t as pluralize } from "../../pluralize-CM-jZg7p.mjs";
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { t as pluralize } from "../../pluralize-CcT6qF0a.mjs";
 import { join } from "node:path";
-
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 //#region src/cli/commands/generate.ts
 /**
 * Arc CLI - Generate Command
@@ -45,7 +44,7 @@ function toCamelCase(pascalName) {
 function getTemplates(ts, config = {}) {
 	const isMultiTenant = config.tenant === "multi";
 	return {
-		model: (name, fileName) => {
+		model: (name, _fileName) => {
 			const camel = toCamelCase(name);
 			return `/**
  * ${name} Model
@@ -83,6 +82,7 @@ export default ${name};
 		},
 		repository: (name, fileName) => {
 			const camel = toCamelCase(name);
+			const generic = ts ? `<I${name}>` : "";
 			return `/**
  * ${name} Repository
  * Generated by Arc CLI
@@ -94,9 +94,9 @@ import {
   softDeletePlugin,
   mongoOperationsPlugin,
 } from '@classytic/mongokit';
-import ${name} from './${fileName}.model.js';
+import ${name} from './${fileName}.model.js';${ts ? `\nimport type { I${name} } from './${fileName}.model.js';` : ""}
 
-class ${name}Repository extends Repository {
+class ${name}Repository extends Repository${generic} {
   constructor() {
     super(${name}, [
       methodRegistryPlugin(),
@@ -159,8 +159,14 @@ import { buildCrudSchemasFromModel } from '@classytic/mongokit/utils';
 const crudSchemas = buildCrudSchemasFromModel(${name}, {
   strictAdditionalProperties: true,
   fieldRules: {
-    // Mark fields as system-managed (excluded from create/update)
+    // systemManaged: excluded from create/update schemas
     // deletedAt: { systemManaged: true },
+    // immutable: cannot be updated after creation
+    // slug: { immutable: true },
+    // immutableAfterCreate: same as immutable (alias)
+    // organizationId: { immutableAfterCreate: true },
+    // optional: removed from required array
+    // description: { optional: true },
   },
   query: {
     filterableFields: {
@@ -175,7 +181,7 @@ export default crudSchemas;
 		resource: (name, fileName) => {
 			const camel = toCamelCase(name);
 			const useMongoKit = config.adapter === "mongokit" || !config.adapter;
-			const queryParserImport = useMongoKit ? `\nimport { QueryParser } from '@classytic/mongokit';\n\nconst queryParser = new QueryParser();\n` : "";
+			const queryParserImport = useMongoKit ? `\nimport { QueryParser } from '@classytic/mongokit';\n\nconst queryParser = new QueryParser({\n  allowedFilterFields: ['isActive'],\n});\n` : "";
 			const queryParserConfig = useMongoKit ? `\n  queryParser,` : "";
 			return isMultiTenant ? `/**
  * ${name} Resource
@@ -189,7 +195,7 @@ import ${camel}Repository from './${fileName}.repository.js';${queryParserImport
 
 const ${camel}Resource = defineResource${ts ? `<I${name}>` : ""}({
   name: '${fileName}',
-  adapter: createMongooseAdapter(${name}, ${camel}Repository),${queryParserConfig}
+  adapter: createMongooseAdapter({ model: ${name}, repository: ${camel}Repository }),${queryParserConfig}
   presets: ['softDelete'],
   permissions: {
     list: requireAuth(),
@@ -213,7 +219,7 @@ import ${camel}Repository from './${fileName}.repository.js';${queryParserImport
 
 const ${camel}Resource = defineResource${ts ? `<I${name}>` : ""}({
   name: '${fileName}',
-  adapter: createMongooseAdapter(${name}, ${camel}Repository),${queryParserConfig}
+  adapter: createMongooseAdapter({ model: ${name}, repository: ${camel}Repository }),${queryParserConfig}
   presets: ['softDelete'],
   permissions: {
     list: requireAuth(),
@@ -225,6 +231,42 @@ const ${camel}Resource = defineResource${ts ? `<I${name}>` : ""}({
 });
 
 export default ${camel}Resource;
+`;
+		},
+		mcp: (name, fileName) => {
+			const camel = toCamelCase(name);
+			return `/**
+ * ${name} MCP Tools
+ * Generated by Arc CLI
+ *
+ * Custom MCP tools for the ${name} domain.
+ * CRUD tools (list/get/create/update/delete) are auto-generated by mcpPlugin.
+ * Add domain-specific tools here (actions, analytics, workflows).
+ */
+
+import { defineTool } from '@classytic/arc/mcp';
+${ts ? "import { z } from 'zod';\n" : "const { z } = require('zod');\n"}
+// Example: domain-specific action tool
+// export const activate${name}Tool = defineTool('activate_${fileName}', {
+//   description: 'Activate a ${name.toLowerCase()} by ID',
+//   input: { id: z.string().describe('${name} ID') },
+//   annotations: { destructiveHint: true, idempotentHint: true },
+//   handler: async ({ id }, ctx) => {
+//     // Your logic here
+//     return { content: [{ type: 'text', text: \`Activated ${name.toLowerCase()} \${id}\` }] };
+//   },
+// });
+
+// Example: read-only analytics tool
+// export const ${camel}StatsTool = defineTool('${fileName}_stats', {
+//   description: 'Get ${name.toLowerCase()} statistics',
+//   input: { period: z.enum(['7d', '30d', '90d']).optional() },
+//   annotations: { readOnlyHint: true },
+//   handler: async ({ period }) => {
+//     // Your logic here
+//     return { content: [{ type: 'text', text: JSON.stringify({ total: 0, period }) }] };
+//   },
+// });
 `;
 		},
 		test: (name, fileName) => {
@@ -278,7 +320,7 @@ describe('${name} Resource', () => {
 */
 async function generate(type, args) {
 	if (!type) throw new Error("Missing type argument\nUsage: arc generate <resource|controller|model|repository|schemas> <name>");
-	const [name] = args;
+	const [name, ...restArgs] = args;
 	if (!name) throw new Error("Missing name argument\nUsage: arc generate <type> <name>\nExample: arc generate resource product");
 	const capitalizedName = toPascalCase(name);
 	const lowerName = name.toLowerCase();
@@ -290,7 +332,7 @@ async function generate(type, args) {
 	switch (type) {
 		case "resource":
 		case "r":
-			await generateResource(capitalizedName, lowerName, resourcePath, templates, ext);
+			await generateResource(capitalizedName, lowerName, resourcePath, templates, ext, projectConfig.mcp === true || restArgs.includes("--mcp"));
 			break;
 		case "controller":
 		case "c":
@@ -308,13 +350,16 @@ async function generate(type, args) {
 		case "s":
 			await generateFile(capitalizedName, lowerName, resourcePath, "schemas", templates.schemas, ext);
 			break;
-		default: throw new Error(`Unknown type: ${type}\nAvailable types: resource, controller, model, repository, schemas`);
+		case "mcp":
+			await generateFile(capitalizedName, lowerName, resourcePath, "mcp", templates.mcp, ext);
+			break;
+		default: throw new Error(`Unknown type: ${type}\nAvailable types: resource, controller, model, repository, schemas, mcp`);
 	}
 }
 /**
 * Generate a full resource
 */
-async function generateResource(name, lowerName, resourcePath, templates, ext) {
+async function generateResource(name, lowerName, resourcePath, templates, ext, includeMcp = false) {
 	console.log(`\nGenerating resource: ${name}...\n`);
 	if (!existsSync(resourcePath)) {
 		mkdirSync(resourcePath, { recursive: true });
@@ -325,6 +370,7 @@ async function generateResource(name, lowerName, resourcePath, templates, ext) {
 		[`${lowerName}.repository.${ext}`]: templates.repository(name, lowerName),
 		[`${lowerName}.resource.${ext}`]: templates.resource(name, lowerName)
 	};
+	if (includeMcp) files[`${lowerName}.mcp.${ext}`] = templates.mcp(name, lowerName);
 	for (const [filename, content] of Object.entries(files)) {
 		const filepath = join(resourcePath, filename);
 		if (existsSync(filepath)) console.warn(`  ! Skipped: ${filename} (already exists)`);
@@ -367,7 +413,11 @@ ${isMultiTenant ? `   - requireAuth()          → any authenticated user
 
 4. Run tests:
    npm test
-`);
+${includeMcp ? `
+5. MCP tools file created: ${lowerName}.mcp.${ext}
+   Uncomment and customize the example tools.
+   Import and add to extraTools in your mcpPlugin config.
+` : ""}`);
 }
 /**
 * Generate a single file
@@ -384,6 +434,5 @@ async function generateFile(name, lowerName, resourcePath, fileType, template, e
 	writeFileSync(filepath, template(name, lowerName));
 	console.log(`  + Created: ${filename}`);
 }
-
 //#endregion
-export { generate as default, generate };
+export { generate as default, generate };