clivly 0.4.0 → 0.4.1

package/README.md

@@ -40,9 +40,10 @@ import { createWorkOSAuthAdapter } from "clivly/auth/workos";
 import { createBetterAuthAdapter } from "clivly/auth/better-auth";
 ```
 
-Provider and framework integrations use optional peer dependencies. Install only
-what your app actually uses, such as `drizzle-orm`, `vite`, `@clerk/backend`, or
-`@workos-inc/node`.
+Provider and framework integrations use optional peer dependencies.
+**Supported auth providers: Clerk, WorkOS, and BetterAuth.** Install only
+what your app actually uses, such as `drizzle-orm`, `vite`, `@clerk/backend`,
+`@workos-inc/node`, or `better-auth`.
 
 `clivly init` detects your framework from `package.json`, locates your Drizzle
 schema, and generates a `clivly.config.ts` that maps likely contact and company

package/index.cjs

@@ -1389,9 +1389,10 @@ function parentDir(dir) {
 	const parent = (0, node_path.dirname)(dir);
 	return parent === dir ? null : parent;
 }
-function findNearestPackageDir(start) {
+function findNearestPackageDir(start, boundary) {
 	let current = (0, node_path.resolve)(start);
 	while (true) {
+		if (current === boundary) return null;
 		if ((0, node_fs.existsSync)((0, node_path.join)(current, "package.json"))) return current;
 		const parent = parentDir(current);
 		if (!parent) return null;
@@ -1423,9 +1424,10 @@ function expandWorkspaceGlob(root, pattern) {
 	const exact = (0, node_path.join)(root, pattern);
 	return (0, node_fs.existsSync)((0, node_path.join)(exact, "package.json")) ? [exact] : [];
 }
-function findWorkspaceRoot(start) {
+function findWorkspaceRoot(start, boundary) {
 	let current = (0, node_path.resolve)(start);
 	while (true) {
+		if (current === boundary) return null;
 		if (readWorkspaceGlobs(current).length > 0) return current;
 		const parent = parentDir(current);
 		if (!parent) return null;
@@ -1444,13 +1446,14 @@ function rankCandidates(paths, start) {
 		return distance(a) - distance(b) || a.localeCompare(b);
 	});
 }
-function resolveTargetApp(start) {
-	const nearestPackageDir = findNearestPackageDir(start);
+function resolveTargetApp(start, boundary = (0, node_os.homedir)()) {
+	const stop = (0, node_path.resolve)(boundary);
+	const nearestPackageDir = findNearestPackageDir(start, stop);
 	if (nearestPackageDir && isDrizzleApp(nearestPackageDir)) return {
 		cwd: nearestPackageDir,
 		reason: "direct"
 	};
-	const workspaceRoot = findWorkspaceRoot(start);
+	const workspaceRoot = findWorkspaceRoot(start, stop);
 	if (!workspaceRoot) return {
 		cwd: nearestPackageDir ?? (0, node_path.resolve)(start),
 		reason: "direct"
@@ -1710,6 +1713,40 @@ function flagValue(argv, flag) {
 	const index = argv.indexOf(flag);
 	return index >= 0 ? argv[index + 1] : void 0;
 }
+const KNOWN_COMMANDS = [
+	"init",
+	"status",
+	"push-schema",
+	"dev",
+	"login",
+	"help"
+];
+function editDistance(a, b) {
+	const m = a.length;
+	const n = b.length;
+	const prev = Array.from({ length: n + 1 }, (_, i) => i);
+	const curr = Array.from({ length: n + 1 }, () => 0);
+	for (let i = 1; i <= m; i++) {
+		curr[0] = i;
+		for (let j = 1; j <= n; j++) {
+			const cost = a[i - 1] === b[j - 1] ? 0 : 1;
+			curr[j] = Math.min(prev[j] + 1, curr[j - 1] + 1, prev[j - 1] + cost);
+		}
+		for (let j = 0; j <= n; j++) prev[j] = curr[j];
+	}
+	return curr[n];
+}
+function nearestCommand(input) {
+	let best;
+	for (const command of KNOWN_COMMANDS) {
+		const distance = editDistance(input, command);
+		if (distance <= 2 && (!best || distance < best.distance)) best = {
+			command,
+			distance
+		};
+	}
+	return best?.command;
+}
 function readDeps(cwd) {
 	const pkgPath = (0, node_path.join)(cwd, "package.json");
 	if (!(0, node_fs.existsSync)(pkgPath)) return {};
@@ -1780,7 +1817,7 @@ async function acquireSchema(options, deps) {
 	const { out } = deps;
 	const appDeps = deps.readDepsFn(options.cwd);
 	if (Object.keys(appDeps).length === 0) {
-		out("No package.json found here. Run `clivly init` from your app root.\n");
+		out(`No package.json found in ${options.cwd}. Run \`clivly init\` from inside an existing app — cd into your project first.\n`);
 		return { code: 1 };
 	}
 	const framework = detectFramework(appDeps);
@@ -2166,19 +2203,29 @@ async function main(argv) {
 			openBrowser: !rest.includes("--no-browser"),
 			deps: defaultLoginDeps()
 		});
+		case "--version":
+		case "-v":
+			process.stdout.write(`${readOwnVersion() ?? "unknown"}\n`);
+			return 0;
 		case void 0:
 		case "help":
 		case "--help":
-			process.stdout.write("clivly — embed a CRM in your app\n\nUsage:\n  clivly init [--force] [--dry-run] [--schema <path>] [--no-login] [--no-browser]   Scaffold Clivly (config, routes, .env) for your app\n  clivly status [--verbose] [--config <path>]   Check your setup, step by step\n  clivly push-schema [--config <path>]   Report your schema to Clivly without deploying\n  clivly dev [--port <n>] [--api-url <url>] [--route-path <path>] [-- <cmd>]   Tunnel localhost for remote sync\n  clivly login [--force] [--rotate] [--api-url <url>] [--no-browser]   Pair this machine and write CLIVLY_API_KEY / CLIVLY_SYNC_TRIGGER_SECRET to .env\n");
+			process.stdout.write("clivly — embed a CRM in your app\n\nUsage:\n  clivly init [--force] [--dry-run] [--schema <path>] [--no-login] [--no-browser]   Scaffold Clivly (config, routes, .env) for your app\n  clivly status [--verbose] [--config <path>]   Check your setup, step by step\n  clivly push-schema [--config <path>]   Report your schema to Clivly without deploying\n  clivly dev [--port <n>] [--api-url <url>] [--route-path <path>] [-- <cmd>]   Tunnel localhost for remote sync\n  clivly login [--force] [--rotate] [--api-url <url>] [--no-browser]   Pair this machine and write CLIVLY_API_KEY / CLIVLY_SYNC_TRIGGER_SECRET to .env\n  clivly --version                Print the installed clivly version\n");
 			return 0;
-		default:
+		default: {
 			process.stdout.write(`Unknown command: ${command}\n`);
+			const suggestion = nearestCommand(command);
+			if (suggestion) process.stdout.write(`Did you mean \`clivly ${suggestion}\`?\n`);
+			process.stdout.write("Run `clivly --help` to see available commands.\n");
 			return 1;
+		}
 	}
 }
 if (isEntrypoint(process.argv[1], require("url").pathToFileURL(__filename).href)) main(process.argv.slice(2)).then((code) => {
 	process.exitCode = code;
 });
 //#endregion
+exports.main = main;
+exports.nearestCommand = nearestCommand;
 exports.runInit = runInit;
 exports.runInitFromArgv = runInitFromArgv;

package/index.d.cts

@@ -36,6 +36,7 @@ interface ProbeHit {
 }
 //#endregion
 //#region src/index.d.ts
+declare function nearestCommand(input: string): string | undefined;
 interface InstallResult {
   command: string;
   ok: boolean;
@@ -73,5 +74,6 @@ interface RunInitOptions {
 }
 declare function runInit(options: RunInitOptions): Promise<number>;
 declare function runInitFromArgv(argv: string[], cwd: string): Promise<number>;
+declare function main(argv: string[]): Promise<number>;
 //#endregion
-export { RunInitOptions, runInit, runInitFromArgv };
+export { RunInitOptions, main, nearestCommand, runInit, runInitFromArgv };

package/index.d.mts

@@ -36,6 +36,7 @@ interface ProbeHit {
 }
 //#endregion
 //#region src/index.d.ts
+declare function nearestCommand(input: string): string | undefined;
 interface InstallResult {
   command: string;
   ok: boolean;
@@ -73,5 +74,6 @@ interface RunInitOptions {
 }
 declare function runInit(options: RunInitOptions): Promise<number>;
 declare function runInitFromArgv(argv: string[], cwd: string): Promise<number>;
+declare function main(argv: string[]): Promise<number>;
 //#endregion
-export { RunInitOptions, runInit, runInitFromArgv };
+export { RunInitOptions, main, nearestCommand, runInit, runInitFromArgv };

package/index.mjs

@@ -6,7 +6,7 @@ import { t as createClivlySDK } from "./sdk-DdzBxgMx.mjs";
 import { createRequire } from "node:module";
 import { spawn } from "node:child_process";
 import { accessSync, constants, existsSync, mkdirSync, readFileSync, readdirSync, realpathSync, statSync, writeFileSync } from "node:fs";
-import { hostname } from "node:os";
+import { homedir, hostname } from "node:os";
 import { delimiter, dirname, isAbsolute, join, relative, resolve } from "node:path";
 import { createInterface } from "node:readline/promises";
 import { fileURLToPath, pathToFileURL } from "node:url";
@@ -1388,9 +1388,10 @@ function parentDir(dir) {
 	const parent = dirname(dir);
 	return parent === dir ? null : parent;
 }
-function findNearestPackageDir(start) {
+function findNearestPackageDir(start, boundary) {
 	let current = resolve(start);
 	while (true) {
+		if (current === boundary) return null;
 		if (existsSync(join(current, "package.json"))) return current;
 		const parent = parentDir(current);
 		if (!parent) return null;
@@ -1422,9 +1423,10 @@ function expandWorkspaceGlob(root, pattern) {
 	const exact = join(root, pattern);
 	return existsSync(join(exact, "package.json")) ? [exact] : [];
 }
-function findWorkspaceRoot(start) {
+function findWorkspaceRoot(start, boundary) {
 	let current = resolve(start);
 	while (true) {
+		if (current === boundary) return null;
 		if (readWorkspaceGlobs(current).length > 0) return current;
 		const parent = parentDir(current);
 		if (!parent) return null;
@@ -1443,13 +1445,14 @@ function rankCandidates(paths, start) {
 		return distance(a) - distance(b) || a.localeCompare(b);
 	});
 }
-function resolveTargetApp(start) {
-	const nearestPackageDir = findNearestPackageDir(start);
+function resolveTargetApp(start, boundary = homedir()) {
+	const stop = resolve(boundary);
+	const nearestPackageDir = findNearestPackageDir(start, stop);
 	if (nearestPackageDir && isDrizzleApp(nearestPackageDir)) return {
 		cwd: nearestPackageDir,
 		reason: "direct"
 	};
-	const workspaceRoot = findWorkspaceRoot(start);
+	const workspaceRoot = findWorkspaceRoot(start, stop);
 	if (!workspaceRoot) return {
 		cwd: nearestPackageDir ?? resolve(start),
 		reason: "direct"
@@ -1709,6 +1712,40 @@ function flagValue(argv, flag) {
 	const index = argv.indexOf(flag);
 	return index >= 0 ? argv[index + 1] : void 0;
 }
+const KNOWN_COMMANDS = [
+	"init",
+	"status",
+	"push-schema",
+	"dev",
+	"login",
+	"help"
+];
+function editDistance(a, b) {
+	const m = a.length;
+	const n = b.length;
+	const prev = Array.from({ length: n + 1 }, (_, i) => i);
+	const curr = Array.from({ length: n + 1 }, () => 0);
+	for (let i = 1; i <= m; i++) {
+		curr[0] = i;
+		for (let j = 1; j <= n; j++) {
+			const cost = a[i - 1] === b[j - 1] ? 0 : 1;
+			curr[j] = Math.min(prev[j] + 1, curr[j - 1] + 1, prev[j - 1] + cost);
+		}
+		for (let j = 0; j <= n; j++) prev[j] = curr[j];
+	}
+	return curr[n];
+}
+function nearestCommand(input) {
+	let best;
+	for (const command of KNOWN_COMMANDS) {
+		const distance = editDistance(input, command);
+		if (distance <= 2 && (!best || distance < best.distance)) best = {
+			command,
+			distance
+		};
+	}
+	return best?.command;
+}
 function readDeps(cwd) {
 	const pkgPath = join(cwd, "package.json");
 	if (!existsSync(pkgPath)) return {};
@@ -1779,7 +1816,7 @@ async function acquireSchema(options, deps) {
 	const { out } = deps;
 	const appDeps = deps.readDepsFn(options.cwd);
 	if (Object.keys(appDeps).length === 0) {
-		out("No package.json found here. Run `clivly init` from your app root.\n");
+		out(`No package.json found in ${options.cwd}. Run \`clivly init\` from inside an existing app — cd into your project first.\n`);
 		return { code: 1 };
 	}
 	const framework = detectFramework(appDeps);
@@ -2165,18 +2202,26 @@ async function main(argv) {
 			openBrowser: !rest.includes("--no-browser"),
 			deps: defaultLoginDeps()
 		});
+		case "--version":
+		case "-v":
+			process.stdout.write(`${readOwnVersion() ?? "unknown"}\n`);
+			return 0;
 		case void 0:
 		case "help":
 		case "--help":
-			process.stdout.write("clivly — embed a CRM in your app\n\nUsage:\n  clivly init [--force] [--dry-run] [--schema <path>] [--no-login] [--no-browser]   Scaffold Clivly (config, routes, .env) for your app\n  clivly status [--verbose] [--config <path>]   Check your setup, step by step\n  clivly push-schema [--config <path>]   Report your schema to Clivly without deploying\n  clivly dev [--port <n>] [--api-url <url>] [--route-path <path>] [-- <cmd>]   Tunnel localhost for remote sync\n  clivly login [--force] [--rotate] [--api-url <url>] [--no-browser]   Pair this machine and write CLIVLY_API_KEY / CLIVLY_SYNC_TRIGGER_SECRET to .env\n");
+			process.stdout.write("clivly — embed a CRM in your app\n\nUsage:\n  clivly init [--force] [--dry-run] [--schema <path>] [--no-login] [--no-browser]   Scaffold Clivly (config, routes, .env) for your app\n  clivly status [--verbose] [--config <path>]   Check your setup, step by step\n  clivly push-schema [--config <path>]   Report your schema to Clivly without deploying\n  clivly dev [--port <n>] [--api-url <url>] [--route-path <path>] [-- <cmd>]   Tunnel localhost for remote sync\n  clivly login [--force] [--rotate] [--api-url <url>] [--no-browser]   Pair this machine and write CLIVLY_API_KEY / CLIVLY_SYNC_TRIGGER_SECRET to .env\n  clivly --version                Print the installed clivly version\n");
 			return 0;
-		default:
+		default: {
 			process.stdout.write(`Unknown command: ${command}\n`);
+			const suggestion = nearestCommand(command);
+			if (suggestion) process.stdout.write(`Did you mean \`clivly ${suggestion}\`?\n`);
+			process.stdout.write("Run `clivly --help` to see available commands.\n");
 			return 1;
+		}
 	}
 }
 if (isEntrypoint(process.argv[1], import.meta.url)) main(process.argv.slice(2)).then((code) => {
 	process.exitCode = code;
 });
 //#endregion
-export { runInit, runInitFromArgv };
+export { main, nearestCommand, runInit, runInitFromArgv };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clivly",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "private": false,
   "type": "module",
   "description": "Clivly CLI — scaffold a CRM into your app (clivly init).",
@@ -210,7 +210,8 @@
         "types": "./auth-better-auth.d.cts",
         "default": "./auth-better-auth.cjs"
       }
-    }
+    },
+    "./package.json": "./package.json"
   },
   "dependencies": {
     "jiti": "^2.7.0"
@@ -218,6 +219,7 @@
   "peerDependencies": {
     "@clerk/backend": ">=1",
     "@workos-inc/node": ">=7",
+    "better-auth": ">=1",
     "drizzle-orm": ">=0.30",
     "vite": ">=5"
   },
@@ -228,6 +230,9 @@
     "@workos-inc/node": {
       "optional": true
     },
+    "better-auth": {
+      "optional": true
+    },
     "drizzle-orm": {
       "optional": true
     },