@kuckit/cli 1.0.1 → 2.0.0

package/dist/discover-module-B7rxN4vq.js

@@ -1,595 +0,0 @@
-import { access, mkdir, readFile, readdir, writeFile } from "node:fs/promises";
-import { join } from "node:path";
-import { execSync } from "node:child_process";
-import { accessSync, constants, existsSync } from "node:fs";
-
-//#region src/commands/generate-module.ts
-function toKebabCase(str) {
-	return str.replace(/([a-z])([A-Z])/g, "$1-$2").replace(/[\s_]+/g, "-").toLowerCase();
-}
-function toPascalCase(str) {
-	return str.split(/[-_\s]+/).map((word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase()).join("");
-}
-function toCamelCase(str) {
-	const pascal = toPascalCase(str);
-	return pascal.charAt(0).toLowerCase() + pascal.slice(1);
-}
-async function generateModule(name, options) {
-	const kebabName = toKebabCase(name);
-	const pascalName = toPascalCase(name);
-	const camelName = toCamelCase(name);
-	const moduleDirName = `${kebabName}-module`;
-	const packageName = options.org ? `@${options.org}/${moduleDirName}` : `@kuckit/${moduleDirName}`;
-	const moduleId = options.org ? `${options.org}.${kebabName}` : `kuckit.${kebabName}`;
-	const targetDir = join(process.cwd(), options.dir, moduleDirName);
-	console.log(`Creating module: ${packageName}`);
-	console.log(`  Directory: ${targetDir}`);
-	await mkdir(join(targetDir, "src", "server", "schema"), { recursive: true });
-	await mkdir(join(targetDir, "src", "client", "components"), { recursive: true });
-	const packageJson = {
-		name: packageName,
-		version: "0.1.0",
-		description: `${pascalName} module for Kuckit`,
-		type: "module",
-		main: "src/server/module.ts",
-		types: "src/server/module.ts",
-		files: ["dist"],
-		exports: {
-			".": {
-				types: "./src/server/module.ts",
-				default: "./src/server/module.ts"
-			},
-			"./client": {
-				types: "./src/client/index.ts",
-				default: "./src/client/index.ts"
-			}
-		},
-		publishConfig: {
-			main: "dist/server/module.js",
-			types: "dist/server/module.d.ts",
-			exports: {
-				".": {
-					types: "./dist/server/module.d.ts",
-					default: "./dist/server/module.js"
-				},
-				"./client": {
-					types: "./dist/client/index.d.ts",
-					default: "./dist/client/index.js"
-				}
-			}
-		},
-		kuckit: {
-			id: moduleId,
-			server: ".",
-			client: "./client",
-			schema: "./src/server/schema/index.ts"
-		},
-		scripts: { build: "tsdown" },
-		peerDependencies: {
-			"@kuckit/sdk": "^0.1.0",
-			"@kuckit/sdk-react": "^0.1.0",
-			"drizzle-orm": "^0.38",
-			typescript: "^5"
-		},
-		devDependencies: { tsdown: "catalog:" }
-	};
-	await writeFile(join(targetDir, "package.json"), JSON.stringify(packageJson, null, "	") + "\n");
-	await writeFile(join(targetDir, "tsconfig.json"), JSON.stringify({
-		extends: "../../tsconfig.base.json",
-		compilerOptions: {
-			outDir: "dist",
-			rootDir: "src"
-		},
-		include: ["src"]
-	}, null, "	") + "\n");
-	const exampleSchema = `import { pgTable, text, timestamp } from 'drizzle-orm/pg-core'
-
-// Example table schema - replace with your module's tables
-export const ${camelName}Table = pgTable('${moduleId.replace(/[.-]/g, "_")}_${camelName}s', {
-	id: text('id').primaryKey(),
-	name: text('name').notNull(),
-	createdAt: timestamp('created_at').notNull().defaultNow(),
-	updatedAt: timestamp('updated_at').notNull().defaultNow(),
-})
-
-// Export inferred types for use in repositories
-export type ${pascalName} = typeof ${camelName}Table.$inferSelect
-export type New${pascalName} = typeof ${camelName}Table.$inferInsert
-`;
-	await writeFile(join(targetDir, "src", "server", "schema", `${kebabName}.ts`), exampleSchema);
-	const schemaIndex = `export * from './${kebabName}.js'
-`;
-	await writeFile(join(targetDir, "src", "server", "schema", "index.ts"), schemaIndex);
-	const serverModule = `import { defineKuckitModule, type KuckitModuleContext } from '@kuckit/sdk'
-import { ${camelName}Table } from './schema/index.js'
-
-export interface ${pascalName}ModuleConfig {
-	// Add your module configuration options here
-}
-
-export const kuckitModule = defineKuckitModule<${pascalName}ModuleConfig>({
-	id: '${moduleId}',
-	displayName: '${pascalName}',
-	description: '${pascalName} module for Kuckit',
-	version: '0.1.0',
-
-	async register(ctx: KuckitModuleContext<${pascalName}ModuleConfig>) {
-		const { container } = ctx
-
-		// Register schemas for this module
-		ctx.registerSchema('${camelName}s', ${camelName}Table)
-
-		// Register your services, repositories, and use cases here
-		// Example:
-		// container.register({
-		//   ${camelName}Repository: asFunction(() => make${pascalName}Repository()).scoped(),
-		//   get${pascalName}: asFunction(({ ${camelName}Repository }) => makeGet${pascalName}({ ${camelName}Repository })).scoped(),
-		// })
-	},
-
-	async onBootstrap(ctx: KuckitModuleContext<${pascalName}ModuleConfig>) {
-		const { container } = ctx
-		const logger = container.resolve('logger')
-		logger.info('${pascalName} module initialized')
-	},
-
-	async onShutdown(ctx: KuckitModuleContext<${pascalName}ModuleConfig>) {
-		const { container } = ctx
-		const logger = container.resolve('logger')
-		logger.info('${pascalName} module shutting down')
-	},
-})
-`;
-	await writeFile(join(targetDir, "src", "server", "module.ts"), serverModule);
-	const clientModule = `import { defineKuckitClientModule, type KuckitClientModuleContext } from '@kuckit/sdk-react'
-import { ${pascalName}Page } from './components/${pascalName}Page.js'
-
-export const kuckitClientModule = defineKuckitClientModule({
-	id: '${moduleId}',
-	displayName: '${pascalName}',
-	version: '0.1.0',
-
-	register(ctx: KuckitClientModuleContext) {
-		// Register components that can be used in the host application
-		ctx.registerComponent('${pascalName}Page', ${pascalName}Page)
-
-		// Register a route for this module
-		ctx.addRoute({
-			id: '${kebabName}',
-			path: '/${kebabName}',
-			component: ${pascalName}Page,
-			meta: {
-				title: '${pascalName}',
-				icon: 'box', // Change to appropriate icon
-				requiresAuth: false,
-			},
-		})
-
-		// Register a navigation item for the sidebar
-		ctx.addNavItem({
-			id: '${kebabName}',
-			label: '${pascalName}',
-			path: '/${kebabName}',
-			icon: 'box', // Change to appropriate icon
-			order: 100, // Adjust order as needed
-		})
-
-		// Register components into host app slots
-		// ctx.registerSlot('dashboard.widgets', ${pascalName}Widget, { order: 50 })
-		// ctx.registerSlot('settings.tabs', ${pascalName}SettingsTab, { order: 100 })
-	},
-})
-`;
-	await writeFile(join(targetDir, "src", "client", "index.ts"), clientModule);
-	const pageComponent = `export function ${pascalName}Page() {
-	return (
-		<div>
-			<h1>${pascalName}</h1>
-			<p>Welcome to the ${pascalName} module.</p>
-		</div>
-	)
-}
-`;
-	await writeFile(join(targetDir, "src", "client", "components", `${pascalName}Page.tsx`), pageComponent);
-	console.log(`
-Module created successfully!
-
-Next steps:
-1. cd ${options.dir}/${moduleDirName}
-2. Add module to apps/server/src/config/modules.ts:
-   { package: '${packageName}' }
-3. Add client module to apps/web (if using frontend components):
-   { package: '${packageName}/client' }
-4. Run 'bun install' from the root to link the new package
-`);
-}
-
-//#endregion
-//#region src/commands/add-module.ts
-const CONFIG_FILES = [
-	"kuckit.config.ts",
-	"kuckit.config.js",
-	"kuckit.config.mjs"
-];
-async function fileExists(path) {
-	try {
-		await access(path, constants.F_OK);
-		return true;
-	} catch {
-		return false;
-	}
-}
-function findConfigFile(cwd) {
-	for (const file of CONFIG_FILES) {
-		const configPath = join(cwd, file);
-		if (existsSync(configPath)) return configPath;
-	}
-	return null;
-}
-function detectPackageManager(cwd) {
-	for (const [file, pm] of Object.entries({
-		"bun.lock": "bun",
-		"bun.lockb": "bun",
-		"package-lock.json": "npm",
-		"yarn.lock": "yarn",
-		"pnpm-lock.yaml": "pnpm"
-	})) try {
-		accessSync(join(cwd, file), constants.F_OK);
-		return pm;
-	} catch {}
-	return "npm";
-}
-async function readPackageKuckitMetadata(packageName, cwd) {
-	const packageJsonPath = join(cwd, "node_modules", packageName, "package.json");
-	try {
-		const content = await readFile(packageJsonPath, "utf-8");
-		return JSON.parse(content).kuckit ?? null;
-	} catch {
-		return null;
-	}
-}
-const MODULES_MARKER_START = "// KUCKIT_MODULES_START";
-const MODULES_MARKER_END = "// KUCKIT_MODULES_END";
-const CLIENT_MODULES_MARKER_START = "// KUCKIT_CLIENT_MODULES_START";
-const CLIENT_MODULES_MARKER_END = "// KUCKIT_CLIENT_MODULES_END";
-/**
-* Add module to unified kuckit.config.ts
-*/
-async function addToUnifiedConfig(packageName, configPath) {
-	let content = await readFile(configPath, "utf-8");
-	if (content.includes(`'${packageName}'`) || content.includes(`"${packageName}"`)) {
-		console.log(`  Module ${packageName} is already in ${configPath}`);
-		return true;
-	}
-	const modulesArrayMatch = content.match(/modules:\s*\[/);
-	if (!modulesArrayMatch) {
-		console.warn(`Warning: Could not find 'modules' array in ${configPath}`);
-		console.log(`  Please manually add: { package: '${packageName}' }`);
-		return false;
-	}
-	const insertPos = modulesArrayMatch.index + modulesArrayMatch[0].length;
-	const newEntry = `\n\t\t{ package: '${packageName}' },`;
-	content = content.slice(0, insertPos) + newEntry + content.slice(insertPos);
-	await writeFile(configPath, content);
-	console.log(`  Added to unified config: ${configPath}`);
-	return true;
-}
-async function addToServerModules(packageName, cwd) {
-	const modulesPath = join(cwd, "apps", "server", "src", "config", "modules.ts");
-	if (!await fileExists(modulesPath)) {
-		console.warn(`Warning: Server modules file not found at ${modulesPath}`);
-		return false;
-	}
-	let content = await readFile(modulesPath, "utf-8");
-	if (content.includes(`package: '${packageName}'`)) {
-		console.log(`  Module ${packageName} is already in server modules`);
-		return true;
-	}
-	if (!content.includes(MODULES_MARKER_START)) {
-		if (content.match(/return modules\s*$/)) {
-			const insertPos = content.lastIndexOf("return modules");
-			const before$1 = content.slice(0, insertPos);
-			const after$1 = content.slice(insertPos);
-			content = before$1 + `\n\t\t${MODULES_MARKER_START}\n\t\t// Modules installed via 'kuckit add' will be added here\n\t\t${MODULES_MARKER_END}\n\n\t\t` + after$1;
-		}
-	}
-	const newEntry = `{ package: '${packageName}' },`;
-	const markerEndPos = content.indexOf(MODULES_MARKER_END);
-	if (markerEndPos === -1) {
-		console.warn(`Warning: Could not find marker in ${modulesPath}`);
-		console.log(`  Please manually add: ${newEntry}`);
-		return false;
-	}
-	const before = content.slice(0, markerEndPos);
-	const after = content.slice(markerEndPos);
-	content = before + `${newEntry}\n\t\t` + after;
-	await writeFile(modulesPath, content);
-	console.log(`  Added to server modules: ${modulesPath}`);
-	return true;
-}
-async function addToClientModules(packageName, clientPath, cwd) {
-	const clientModulesPath = join(cwd, "apps", "web", "src", "modules.client.ts");
-	if (!await fileExists(clientModulesPath)) {
-		await writeFile(clientModulesPath, `import type { ClientModuleSpec } from '@kuckit/sdk-react'
-
-/**
- * Client module specifications
- *
- * Add your Kuckit client modules here. Modules can be:
- * - Direct references: { module: myModule }
- * - Package imports: { package: '@acme/billing-module/client' }
- *
- * The CLI command \`kuckit add <package>\` will automatically update this file.
- */
-export const getClientModuleSpecs = (): ClientModuleSpec[] => [
-	${CLIENT_MODULES_MARKER_START}
-	${CLIENT_MODULES_MARKER_END}
-]
-`);
-		console.log(`  Created client modules file: ${clientModulesPath}`);
-	}
-	let content = await readFile(clientModulesPath, "utf-8");
-	const clientPackagePath = `${packageName}/${clientPath.replace("./", "")}`;
-	if (content.includes(`package: '${clientPackagePath}'`)) {
-		console.log(`  Client module is already registered`);
-		return true;
-	}
-	const newEntry = `{ package: '${clientPackagePath}' },`;
-	const markerEndPos = content.indexOf(CLIENT_MODULES_MARKER_END);
-	if (markerEndPos === -1) {
-		console.warn(`Warning: Could not find marker in ${clientModulesPath}`);
-		console.log(`  Please manually add: ${newEntry}`);
-		return false;
-	}
-	const before = content.slice(0, markerEndPos);
-	const after = content.slice(markerEndPos);
-	content = before + `${newEntry}\n\t` + after;
-	await writeFile(clientModulesPath, content);
-	console.log(`  Added to client modules: ${clientModulesPath}`);
-	return true;
-}
-async function addModule(packageName, options) {
-	const cwd = process.cwd();
-	console.log(`Adding module: ${packageName}`);
-	if (!options.skipInstall) {
-		const pm = detectPackageManager(cwd);
-		const installCmd = pm === "npm" ? `${pm} install ${packageName}` : `${pm} add ${packageName}`;
-		console.log(`  Installing with ${pm}...`);
-		try {
-			execSync(installCmd, {
-				cwd,
-				stdio: "inherit"
-			});
-		} catch {
-			console.error(`Failed to install ${packageName}`);
-			process.exit(1);
-		}
-	}
-	const metadata = await readPackageKuckitMetadata(packageName, cwd);
-	if (!metadata) {
-		console.error(`\nError: ${packageName} is not a valid Kuckit module.`);
-		console.error(`The package.json must contain a "kuckit" field with module metadata.`);
-		console.error(`\nExpected structure:`);
-		console.error(`{
-  "kuckit": {
-    "id": "acme.billing",
-    "server": ".",
-    "client": "./client"
-  }
-}`);
-		process.exit(1);
-	}
-	console.log(`  Found Kuckit module: ${metadata.id}`);
-	const configPath = findConfigFile(cwd);
-	if (configPath) await addToUnifiedConfig(packageName, configPath);
-	else {
-		if (metadata.server) await addToServerModules(packageName, cwd);
-		if (metadata.client) await addToClientModules(packageName, metadata.client, cwd);
-	}
-	console.log(`
-Module ${packageName} added successfully!
-
-Run 'bun run dev' to start the server with the new module.
-`);
-}
-
-//#endregion
-//#region src/lib/sdk-loader.ts
-async function loadTryLoadKuckitConfig() {
-	try {
-		const sdk = await import("@kuckit/sdk");
-		if (!sdk.tryLoadKuckitConfig) throw new Error("Invalid @kuckit/sdk version: tryLoadKuckitConfig not found.");
-		return sdk.tryLoadKuckitConfig;
-	} catch {
-		console.error("Error: This command requires @kuckit/sdk to be installed in your project.");
-		console.error("Install it with one of:");
-		console.error("  npm install -D @kuckit/sdk");
-		console.error("  pnpm add -D @kuckit/sdk");
-		console.error("  bun add -d @kuckit/sdk");
-		process.exit(1);
-	}
-}
-
-//#endregion
-//#region src/commands/discover-module.ts
-async function readKuckitMetadataFromPath(packageJsonPath) {
-	try {
-		const content = await readFile(packageJsonPath, "utf-8");
-		return JSON.parse(content).kuckit ?? null;
-	} catch {
-		return null;
-	}
-}
-async function readPackageName(packageJsonPath) {
-	try {
-		const content = await readFile(packageJsonPath, "utf-8");
-		return JSON.parse(content).name ?? null;
-	} catch {
-		return null;
-	}
-}
-async function scanWorkspacePackages(cwd) {
-	const discovered = [];
-	const packagesDir = join(cwd, "packages");
-	if (!existsSync(packagesDir)) return discovered;
-	try {
-		const entries = await readdir(packagesDir, { withFileTypes: true });
-		for (const entry of entries) {
-			if (!entry.isDirectory()) continue;
-			const packageJsonPath = join(packagesDir, entry.name, "package.json");
-			const metadata = await readKuckitMetadataFromPath(packageJsonPath);
-			if (metadata) {
-				const packageName = await readPackageName(packageJsonPath);
-				if (packageName) discovered.push({
-					package: packageName,
-					id: metadata.id,
-					server: metadata.server,
-					client: metadata.client,
-					enabled: false,
-					local: true
-				});
-			}
-		}
-	} catch {}
-	return discovered;
-}
-async function scanNodeModules(cwd) {
-	const nodeModulesPath = join(cwd, "node_modules");
-	const discovered = [];
-	try {
-		const entries = await readdir(nodeModulesPath, { withFileTypes: true });
-		for (const entry of entries) {
-			if (!entry.isDirectory() && !entry.isSymbolicLink()) continue;
-			if (entry.name.startsWith(".")) continue;
-			if (entry.name.startsWith("@")) {
-				const scopePath = join(nodeModulesPath, entry.name);
-				try {
-					const scopedEntries = await readdir(scopePath, { withFileTypes: true });
-					for (const scopedEntry of scopedEntries) {
-						if (!scopedEntry.isDirectory() && !scopedEntry.isSymbolicLink()) continue;
-						const packageName = `${entry.name}/${scopedEntry.name}`;
-						const metadata = await readKuckitMetadataFromPath(join(nodeModulesPath, packageName, "package.json"));
-						if (metadata) discovered.push({
-							package: packageName,
-							id: metadata.id,
-							server: metadata.server,
-							client: metadata.client,
-							enabled: false
-						});
-					}
-				} catch {}
-			} else {
-				const metadata = await readKuckitMetadataFromPath(join(nodeModulesPath, entry.name, "package.json"));
-				if (metadata) discovered.push({
-					package: entry.name,
-					id: metadata.id,
-					server: metadata.server,
-					client: metadata.client,
-					enabled: false
-				});
-			}
-		}
-	} catch {}
-	return discovered;
-}
-async function addModulesToConfig(packages, configPath) {
-	const content = await readFile(configPath, "utf-8");
-	let updated = content;
-	for (const pkg of packages) {
-		if (updated.includes(`'${pkg}'`) || updated.includes(`"${pkg}"`)) continue;
-		const modulesArrayMatch = updated.match(/modules:\s*\[/);
-		if (!modulesArrayMatch) continue;
-		const insertPos = modulesArrayMatch.index + modulesArrayMatch[0].length;
-		const newEntry = `\n\t\t{ package: '${pkg}' },`;
-		updated = updated.slice(0, insertPos) + newEntry + updated.slice(insertPos);
-	}
-	if (updated !== content) {
-		const { writeFile: writeFile$1 } = await import("node:fs/promises");
-		await writeFile$1(configPath, updated);
-	}
-}
-async function discoverModules(options) {
-	const cwd = process.cwd();
-	if (!options.json) console.log("Scanning for Kuckit modules...\n");
-	const config = await (await loadTryLoadKuckitConfig())(cwd);
-	const configuredPackages = new Set(config?.modules.map((m) => m.package) ?? []);
-	const workspaceModules = await scanWorkspacePackages(cwd);
-	const nodeModules = await scanNodeModules(cwd);
-	const seen = /* @__PURE__ */ new Set();
-	const discovered = [];
-	for (const mod of workspaceModules) {
-		seen.add(mod.package);
-		mod.enabled = configuredPackages.has(mod.package);
-		discovered.push(mod);
-	}
-	for (const mod of nodeModules) if (!seen.has(mod.package)) {
-		mod.enabled = configuredPackages.has(mod.package);
-		discovered.push(mod);
-	}
-	discovered.sort((a, b) => {
-		if (a.enabled !== b.enabled) return a.enabled ? -1 : 1;
-		return a.package.localeCompare(b.package);
-	});
-	const result = {
-		discovered,
-		enabled: discovered.filter((m) => m.enabled).length,
-		unconfigured: discovered.filter((m) => !m.enabled).length
-	};
-	if (options.json) {
-		console.log(JSON.stringify(result, null, 2));
-		return;
-	}
-	if (discovered.length === 0) {
-		console.log("No Kuckit modules found.");
-		console.log("\nInstall modules with: kuckit add <package>");
-		return;
-	}
-	console.log(`Found ${discovered.length} Kuckit module${discovered.length === 1 ? "" : "s"}:`);
-	for (const mod of discovered) {
-		const status = mod.enabled ? "✓" : "○";
-		const label = mod.enabled ? "(enabled)" : "(not configured)";
-		const localLabel = mod.local ? " [local]" : "";
-		console.log(`  ${status} ${mod.package}${localLabel} ${label}`);
-	}
-	const unconfigured = discovered.filter((m) => !m.enabled);
-	if (unconfigured.length === 0) {
-		console.log("\nAll discovered modules are already configured.");
-		return;
-	}
-	if (!options.interactive) {
-		console.log(`\n${unconfigured.length} module${unconfigured.length === 1 ? "" : "s"} not configured.`);
-		console.log("Run without --no-interactive to enable them.");
-		return;
-	}
-	if (!config?._configPath) {
-		console.log("\nNo kuckit.config.ts found. Create one first with:");
-		console.log("  npx create-kuckit-app --init");
-		return;
-	}
-	try {
-		const { checkbox } = await import("@inquirer/prompts");
-		const selected = await checkbox({
-			message: "Enable modules:",
-			choices: unconfigured.map((m) => ({
-				name: m.package,
-				value: m.package,
-				checked: true
-			}))
-		});
-		if (selected.length === 0) {
-			console.log("\nNo modules selected.");
-			return;
-		}
-		await addModulesToConfig(selected, config._configPath);
-		console.log(`\nUpdated kuckit.config.ts with ${selected.length} new module${selected.length === 1 ? "" : "s"}.`);
-	} catch (error) {
-		if (error.name === "ExitPromptError") {
-			console.log("\nCancelled.");
-			return;
-		}
-		throw error;
-	}
-}
-
-//#endregion
-export { generateModule as i, loadTryLoadKuckitConfig as n, addModule as r, discoverModules as t };