neon-init 0.13.1 → 0.15.0

package/dist/lib/route-command.js

@@ -0,0 +1,195 @@
+import { detectAgent } from "./detect-agent.js";
+//#region src/lib/route-command.ts
+/**
+* Routes neon-init CLI args to the appropriate phase handler directly,
+* without shelling out. This is the in-process equivalent of calling
+* `neon-init <subcommand> <flags>`.
+*/
+function resolveAgent(explicit) {
+	return explicit ?? detectAgent() ?? void 0;
+}
+/** Known short flag aliases (mirrors yargs config in cli.ts) */
+const SHORT_FLAG_MAP = { a: "agent" };
+function parseArgs(args) {
+	const result = {};
+	let i = 0;
+	if (args.length > 0 && !args[0].startsWith("-")) {
+		result._command = args[0];
+		i = 1;
+	}
+	while (i < args.length) {
+		const arg = args[i];
+		if (arg.startsWith("--")) {
+			const key = arg.slice(2).replace(/-([a-z])/g, (_, c) => c.toUpperCase());
+			const nextArg = args[i + 1];
+			if (nextArg !== void 0 && !nextArg.startsWith("-")) {
+				result[key] = nextArg;
+				i += 2;
+			} else {
+				result[key] = true;
+				i += 1;
+			}
+		} else if (arg.startsWith("-") && !arg.startsWith("--") && arg.length === 2) {
+			const shortKey = arg[1];
+			const longKey = SHORT_FLAG_MAP[shortKey] ?? shortKey;
+			const nextArg = args[i + 1];
+			if (nextArg !== void 0 && !nextArg.startsWith("-")) {
+				result[longKey] = nextArg;
+				i += 2;
+			} else {
+				result[longKey] = true;
+				i += 1;
+			}
+		} else i += 1;
+	}
+	return result;
+}
+function toBool(val) {
+	if (val === true || val === "true") return true;
+	if (val === false || val === "false") return false;
+	return null;
+}
+async function routeCommand(args) {
+	const parsed = parseArgs(args);
+	const command = parsed._command;
+	const agent = resolveAgent(parsed.agent);
+	switch (command) {
+		case "finalize": {
+			const { handleCleanup } = await import("./phases/cleanup.js");
+			return handleCleanup();
+		}
+		case "auth": {
+			const { handleAuthPhase } = await import("./phases/auth.js");
+			return handleAuthPhase({
+				agent,
+				method: parsed.method,
+				verify: parsed.verify === true
+			});
+		}
+		case "mcp": {
+			const { handleMcpPhase } = await import("./phases/mcp.js");
+			return handleMcpPhase({
+				agent,
+				status: parsed.status === true,
+				install: parsed.install === true || parsed.update === true,
+				scope: parsed.scope ?? "global",
+				mcpConfigured: toBool(parsed.mcpConfigured)
+			});
+		}
+		case "skills": {
+			const { handleSkillsPhase } = await import("./phases/skills.js");
+			return handleSkillsPhase({
+				agent,
+				status: parsed.status === true,
+				install: parsed.install === true,
+				update: parsed.update === true
+			});
+		}
+		case "setup": {
+			const { handleSetupPhase } = await import("./phases/setup.js");
+			if (typeof parsed.data === "string") {
+				let data;
+				try {
+					data = JSON.parse(parsed.data);
+				} catch {
+					throw new Error("Invalid JSON in --data flag");
+				}
+				for (const key of [
+					"mcpConfigured",
+					"connectionString",
+					"isVscodeIde",
+					"installExtension",
+					"execute"
+				]) if (data[key] === "true") data[key] = true;
+				else if (data[key] === "false") data[key] = false;
+				return handleSetupPhase({
+					agent,
+					...data
+				});
+			}
+			return handleSetupPhase({
+				agent,
+				mcpConfigured: toBool(parsed.mcpConfigured),
+				connectionString: toBool(parsed.connectionString),
+				framework: parsed.framework,
+				orm: parsed.orm,
+				migrationTool: parsed.migrationTool,
+				migrationDir: parsed.migrationDir,
+				isVscodeIde: toBool(parsed.isVscodeIde),
+				mode: parsed.mode,
+				mcpScope: parsed.mcpScope,
+				skillsScope: parsed.skillsScope,
+				installExtension: toBool(parsed.installExtension) === true,
+				execute: parsed.execute === true
+			});
+		}
+		case "getting-started": {
+			const { handleGettingStartedPhase } = await import("./phases/getting-started.js");
+			if (typeof parsed.data === "string") {
+				let data;
+				try {
+					data = JSON.parse(parsed.data);
+				} catch {
+					throw new Error("Invalid JSON in --data flag");
+				}
+				return handleGettingStartedPhase({
+					agent,
+					...data
+				});
+			}
+			return handleGettingStartedPhase({
+				agent,
+				hasConnectionString: parsed.hasConnectionString === true,
+				framework: parsed.framework,
+				orm: parsed.orm,
+				migrationTool: parsed.migrationTool,
+				migrationDir: parsed.migrationDir
+			});
+		}
+		case "db": {
+			const { handleDbPhase } = await import("./phases/db.js");
+			return handleDbPhase({
+				agent,
+				orgId: parsed.orgId,
+				projectId: parsed.projectId,
+				orgsResult: parsed.orgsResult,
+				projectsResult: parsed.projectsResult,
+				framework: parsed.framework,
+				orm: parsed.orm,
+				error: parsed.error
+			});
+		}
+		case "neon-auth": {
+			const { handleNeonAuthPhase } = await import("./phases/neon-auth.js");
+			return handleNeonAuthPhase({
+				agent,
+				setup: parsed.setup === true,
+				info: parsed.info === true,
+				projectId: parsed.projectId
+			});
+		}
+		case "migrations": {
+			const { handleMigrationsPhase } = await import("./phases/migrations.js");
+			return handleMigrationsPhase({
+				agent,
+				tool: parsed.tool,
+				migrationDir: parsed.migrationDir,
+				scaffold: parsed.scaffold,
+				apply: parsed.apply === true
+			});
+		}
+		default: {
+			const { orchestrate } = await import("../v2.js");
+			return orchestrate({
+				agent,
+				skipNeonAuth: parsed.skipNeonAuth === true,
+				skipMigrations: parsed.skipMigrations === true,
+				preview: parsed.preview === true
+			});
+		}
+	}
+}
+//#endregion
+export { routeCommand };
+
+//# sourceMappingURL=route-command.js.map

package/dist/lib/route-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-command.js","names":[],"sources":["../../src/lib/route-command.ts"],"sourcesContent":["/**\n * Routes neon-init CLI args to the appropriate phase handler directly,\n * without shelling out. This is the in-process equivalent of calling\n * `neon-init <subcommand> <flags>`.\n */\n\nimport { detectAgent } from \"./detect-agent.js\";\nimport type { PhaseResponse } from \"./types.js\";\n\nfunction resolveAgent(explicit: string | undefined): string | undefined {\n\treturn explicit ?? detectAgent() ?? undefined;\n}\n\n/** Known short flag aliases (mirrors yargs config in cli.ts) */\nconst SHORT_FLAG_MAP: Record<string, string> = {\n\ta: \"agent\",\n};\n\nfunction parseArgs(args: string[]): Record<string, string | boolean> {\n\tconst result: Record<string, string | boolean> = {};\n\tlet i = 0;\n\n\t// First arg may be the subcommand\n\tif (args.length > 0 && !args[0].startsWith(\"-\")) {\n\t\tresult._command = args[0];\n\t\ti = 1;\n\t}\n\n\twhile (i < args.length) {\n\t\tconst arg = args[i];\n\t\tif (arg.startsWith(\"--\")) {\n\t\t\tconst key = arg\n\t\t\t\t.slice(2)\n\t\t\t\t.replace(/-([a-z])/g, (_, c) => c.toUpperCase());\n\t\t\tconst nextArg = args[i + 1];\n\t\t\tif (nextArg !== undefined && !nextArg.startsWith(\"-\")) {\n\t\t\t\tresult[key] = nextArg;\n\t\t\t\ti += 2;\n\t\t\t} else {\n\t\t\t\tresult[key] = true;\n\t\t\t\ti += 1;\n\t\t\t}\n\t\t} else if (\n\t\t\targ.startsWith(\"-\") &&\n\t\t\t!arg.startsWith(\"--\") &&\n\t\t\targ.length === 2\n\t\t) {\n\t\t\tconst shortKey = arg[1];\n\t\t\tconst longKey = SHORT_FLAG_MAP[shortKey] ?? shortKey;\n\t\t\tconst nextArg = args[i + 1];\n\t\t\tif (nextArg !== undefined && !nextArg.startsWith(\"-\")) {\n\t\t\t\tresult[longKey] = nextArg;\n\t\t\t\ti += 2;\n\t\t\t} else {\n\t\t\t\tresult[longKey] = true;\n\t\t\t\ti += 1;\n\t\t\t}\n\t\t} else {\n\t\t\ti += 1;\n\t\t}\n\t}\n\n\treturn result;\n}\n\nfunction toBool(val: string | boolean | undefined): boolean | null {\n\tif (val === true || val === \"true\") return true;\n\tif (val === false || val === \"false\") return false;\n\treturn null;\n}\n\nexport async function routeCommand(args: string[]): Promise<PhaseResponse> {\n\tconst parsed = parseArgs(args);\n\tconst command = parsed._command as string | undefined;\n\tconst agent = resolveAgent(parsed.agent as string | undefined);\n\n\tswitch (command) {\n\t\tcase \"finalize\": {\n\t\t\tconst { handleCleanup } = await import(\"./phases/cleanup.js\");\n\t\t\treturn handleCleanup();\n\t\t}\n\n\t\tcase \"auth\": {\n\t\t\tconst { handleAuthPhase } = await import(\"./phases/auth.js\");\n\t\t\treturn handleAuthPhase({\n\t\t\t\tagent,\n\t\t\t\tmethod: parsed.method as \"existing\" | \"new\" | undefined,\n\t\t\t\tverify: parsed.verify === true,\n\t\t\t});\n\t\t}\n\n\t\tcase \"mcp\": {\n\t\t\tconst { handleMcpPhase } = await import(\"./phases/mcp.js\");\n\t\t\treturn handleMcpPhase({\n\t\t\t\tagent,\n\t\t\t\tstatus: parsed.status === true,\n\t\t\t\tinstall: parsed.install === true || parsed.update === true,\n\t\t\t\tscope: (parsed.scope as \"global\" | \"project\") ?? \"global\",\n\t\t\t\tmcpConfigured: toBool(parsed.mcpConfigured),\n\t\t\t});\n\t\t}\n\n\t\tcase \"skills\": {\n\t\t\tconst { handleSkillsPhase } = await import(\"./phases/skills.js\");\n\t\t\treturn handleSkillsPhase({\n\t\t\t\tagent,\n\t\t\t\tstatus: parsed.status === true,\n\t\t\t\tinstall: parsed.install === true,\n\t\t\t\tupdate: parsed.update === true,\n\t\t\t});\n\t\t}\n\n\t\tcase \"setup\": {\n\t\t\tconst { handleSetupPhase } = await import(\"./phases/setup.js\");\n\n\t\t\t// --data JSON path\n\t\t\tif (typeof parsed.data === \"string\") {\n\t\t\t\tlet data: Record<string, unknown>;\n\t\t\t\ttry {\n\t\t\t\t\tdata = JSON.parse(parsed.data);\n\t\t\t\t} catch {\n\t\t\t\t\tthrow new Error(\"Invalid JSON in --data flag\");\n\t\t\t\t}\n\n\t\t\t\t// Normalize string booleans\n\t\t\t\tfor (const key of [\n\t\t\t\t\t\"mcpConfigured\",\n\t\t\t\t\t\"connectionString\",\n\t\t\t\t\t\"isVscodeIde\",\n\t\t\t\t\t\"installExtension\",\n\t\t\t\t\t\"execute\",\n\t\t\t\t]) {\n\t\t\t\t\tif (data[key] === \"true\") data[key] = true;\n\t\t\t\t\telse if (data[key] === \"false\") data[key] = false;\n\t\t\t\t}\n\n\t\t\t\treturn handleSetupPhase({\n\t\t\t\t\tagent,\n\t\t\t\t\t...data,\n\t\t\t\t} as Parameters<typeof handleSetupPhase>[0]);\n\t\t\t}\n\n\t\t\treturn handleSetupPhase({\n\t\t\t\tagent,\n\t\t\t\tmcpConfigured: toBool(parsed.mcpConfigured),\n\t\t\t\tconnectionString: toBool(parsed.connectionString),\n\t\t\t\tframework: parsed.framework as string | undefined,\n\t\t\t\torm: parsed.orm as string | undefined,\n\t\t\t\tmigrationTool: parsed.migrationTool as string | undefined,\n\t\t\t\tmigrationDir: parsed.migrationDir as string | undefined,\n\t\t\t\tisVscodeIde: toBool(parsed.isVscodeIde),\n\t\t\t\tmode: parsed.mode as \"defaults\" | \"customize\" | undefined,\n\t\t\t\tmcpScope: parsed.mcpScope as \"global\" | \"project\" | undefined,\n\t\t\t\tskillsScope: parsed.skillsScope as\n\t\t\t\t\t| \"global\"\n\t\t\t\t\t| \"project\"\n\t\t\t\t\t| undefined,\n\t\t\t\tinstallExtension: toBool(parsed.installExtension) === true,\n\t\t\t\texecute: parsed.execute === true,\n\t\t\t});\n\t\t}\n\n\t\tcase \"getting-started\": {\n\t\t\tconst { handleGettingStartedPhase } = await import(\n\t\t\t\t\"./phases/getting-started.js\"\n\t\t\t);\n\n\t\t\tif (typeof parsed.data === \"string\") {\n\t\t\t\tlet data: Record<string, unknown>;\n\t\t\t\ttry {\n\t\t\t\t\tdata = JSON.parse(parsed.data);\n\t\t\t\t} catch {\n\t\t\t\t\tthrow new Error(\"Invalid JSON in --data flag\");\n\t\t\t\t}\n\t\t\t\treturn handleGettingStartedPhase({\n\t\t\t\t\tagent,\n\t\t\t\t\t...data,\n\t\t\t\t} as Parameters<typeof handleGettingStartedPhase>[0]);\n\t\t\t}\n\n\t\t\treturn handleGettingStartedPhase({\n\t\t\t\tagent,\n\t\t\t\thasConnectionString: parsed.hasConnectionString === true,\n\t\t\t\tframework: parsed.framework as string | undefined,\n\t\t\t\torm: parsed.orm as string | undefined,\n\t\t\t\tmigrationTool: parsed.migrationTool as string | undefined,\n\t\t\t\tmigrationDir: parsed.migrationDir as string | undefined,\n\t\t\t});\n\t\t}\n\n\t\tcase \"db\": {\n\t\t\tconst { handleDbPhase } = await import(\"./phases/db.js\");\n\t\t\treturn handleDbPhase({\n\t\t\t\tagent,\n\t\t\t\torgId: parsed.orgId as string | undefined,\n\t\t\t\tprojectId: parsed.projectId as string | undefined,\n\t\t\t\torgsResult: parsed.orgsResult as string | undefined,\n\t\t\t\tprojectsResult: parsed.projectsResult as string | undefined,\n\t\t\t\tframework: parsed.framework as string | undefined,\n\t\t\t\torm: parsed.orm as string | undefined,\n\t\t\t\terror: parsed.error as string | undefined,\n\t\t\t});\n\t\t}\n\n\t\tcase \"neon-auth\": {\n\t\t\tconst { handleNeonAuthPhase } = await import(\n\t\t\t\t\"./phases/neon-auth.js\"\n\t\t\t);\n\t\t\treturn handleNeonAuthPhase({\n\t\t\t\tagent,\n\t\t\t\tsetup: parsed.setup === true,\n\t\t\t\tinfo: parsed.info === true,\n\t\t\t\tprojectId: parsed.projectId as string | undefined,\n\t\t\t});\n\t\t}\n\n\t\tcase \"migrations\": {\n\t\t\tconst { handleMigrationsPhase } = await import(\n\t\t\t\t\"./phases/migrations.js\"\n\t\t\t);\n\t\t\treturn handleMigrationsPhase({\n\t\t\t\tagent,\n\t\t\t\ttool: parsed.tool as string | undefined,\n\t\t\t\tmigrationDir: parsed.migrationDir as string | undefined,\n\t\t\t\tscaffold: parsed.scaffold as \"prisma\" | \"drizzle\" | undefined,\n\t\t\t\tapply: parsed.apply === true,\n\t\t\t});\n\t\t}\n\n\t\tdefault: {\n\t\t\t// No subcommand — run the orchestrator\n\t\t\tconst { orchestrate } = await import(\"../v2.js\");\n\t\t\treturn orchestrate({\n\t\t\t\tagent,\n\t\t\t\tskipNeonAuth: parsed.skipNeonAuth === true,\n\t\t\t\tskipMigrations: parsed.skipMigrations === true,\n\t\t\t\tpreview: parsed.preview === true,\n\t\t\t});\n\t\t}\n\t}\n}\n"],"mappings":"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"}

package/dist/lib/skills.d.ts

@@ -1,11 +1,28 @@
 import { Editor } from "./types.js";
 
 //#region src/lib/skills.d.ts
-
+declare const SKILL_REFERENCE_URLS: Record<string, string>;
+/**
+ * Fetches the "Getting Started with Neon" skill content from the public URL.
+ * Returns the markdown content, or null if the fetch fails.
+ */
+declare function fetchSkillContent(): Promise<string | null>;
+interface InstallSkillsOptions {
+  json?: boolean;
+  scope?: "global" | "project";
+}
+/**
+ * Installs Neon agent skills using Vercel's skills CLI.
+ */
+declare function installAgentSkills(selectedEditors: Editor[], options?: InstallSkillsOptions): Promise<boolean>;
 /**
- * Installs Neon agent skills using Vercel's skills CLI
+ * Ensures Neon agent skills are up to date. Runs `skills add` if the skills
+ * haven't been updated within the freshness window (12 hours).
+ *
+ * Designed to be called from any phase handler — cheap to call repeatedly
+ * since it's a no-op when skills are fresh.
  */
-declare function installAgentSkills(selectedEditors: Editor[]): Promise<boolean>;
+declare function ensureSkillsUpToDate(agent: string, scope?: "global" | "project"): Promise<boolean>;
 //#endregion
-export { installAgentSkills };
+export { InstallSkillsOptions, SKILL_REFERENCE_URLS, ensureSkillsUpToDate, fetchSkillContent, installAgentSkills };
 //# sourceMappingURL=skills.d.ts.map

package/dist/lib/skills.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skills.d.ts","names":[],"sources":["../../src/lib/skills.ts"],"sourcesContent":[],"mappings":";;;;;;AAuBA;AAAwC,iBAAlB,kBAAA,CAAkB,eAAA,EACtB,MADsB,EAAA,CAAA,EAErC,OAFqC,CAAA,OAAA,CAAA"}
+{"version":3,"file":"skills.d.ts","names":[],"sources":["../../src/lib/skills.ts"],"mappings":";;;cAWa,sBAAsB;;AAAnC;AAeA;AAiDA;AAQsB,iBAzDA,iBAAA,CAAA,CAyDkB,EAzDG,OAyDH,CAAA,MAAA,GAAA,IAAA,CAAA;AAAA,UARvB,oBAAA,CAQuB;MACtB,CAAA,EAAA,OAAA;OACP,CAAA,EAAA,QAAA,GAAA,SAAA;;AACD;AA8JV;;iBAjKsB,kBAAA,kBACJ,oBACP,uBACR;;;;;;;;iBA8JmB,oBAAA,+CAGnB"}

package/dist/lib/skills.js

@@ -1,33 +1,69 @@
+import { getSkillsAgentName } from "./agents.js";
+import { existsSync, readFileSync, statSync } from "node:fs";
+import { resolve } from "node:path";
 import { log, spinner } from "@clack/prompts";
 import { execa } from "execa";
-
+import { dim } from "yoctocolors";
 //#region src/lib/skills.ts
+const SKILL_BASE_URL = "https://neon.com/docs/ai/skills/neon-postgres/references";
+const SKILL_REFERENCE_URLS = {
+	gettingStarted: `${SKILL_BASE_URL}/getting-started.md`,
+	connectionMethods: `${SKILL_BASE_URL}/connection-methods.md`,
+	neonAuth: `${SKILL_BASE_URL}/neon-auth.md`,
+	serverlessDriver: `${SKILL_BASE_URL}/neon-serverless.md`,
+	neonCli: `${SKILL_BASE_URL}/neon-cli.md`,
+	devtools: `${SKILL_BASE_URL}/devtools.md`,
+	branching: `${SKILL_BASE_URL}/branching.md`,
+	neonJs: `${SKILL_BASE_URL}/neon-js.md`
+};
+/**
+* Fetches the "Getting Started with Neon" skill content from the public URL.
+* Returns the markdown content, or null if the fetch fails.
+*/
+async function fetchSkillContent() {
+	try {
+		const response = await fetch(SKILL_REFERENCE_URLS.gettingStarted, { signal: AbortSignal.timeout(1e4) });
+		if (!response.ok) return null;
+		return await response.text();
+	} catch {
+		return null;
+	}
+}
 /**
-* Maps editor names to the corresponding agent names used by the skills CLI
+* Maps Editor display names to the skills CLI agent name.
+* Used only by the v1 installAgentSkills function.
 */
-function getSkillsAgentName(editor) {
+function editorToSkillsAgent(editor) {
 	switch (editor) {
 		case "Cursor": return "cursor";
-		case "VS Code": return "github-copilot";
+		case "VS Code":
+		case "GitHub Copilot CLI": return "github-copilot";
 		case "Claude CLI": return "claude-code";
+		case "Codex": return "codex";
+		case "OpenCode": return "opencode";
+		case "Antigravity": return "antigravity";
+		case "Cline":
+		case "Cline CLI": return "cline";
+		case "Gemini CLI": return "gemini-cli";
+		case "Goose": return "goose";
+		case "Claude Desktop": return "claude-code";
+		case "MCPorter": return "mcporter";
+		case "Zed": return "zed";
 		default: return "";
 	}
 }
 /**
-* Installs Neon agent skills using Vercel's skills CLI
+* Installs Neon agent skills using Vercel's skills CLI.
 */
-async function installAgentSkills(selectedEditors) {
-	if (selectedEditors.length === 0) return true;
-	const skillsSpinner = spinner();
-	skillsSpinner.start("Installing agent skills for Neon...");
+async function installAgentSkills(selectedEditors, options) {
+	const quiet = options?.json === true;
+	const editorsWithSkills = selectedEditors.filter((e) => editorToSkillsAgent(e) !== "");
+	if (editorsWithSkills.length === 0) return true;
+	const skillsSpinner = quiet ? null : spinner();
+	skillsSpinner?.start("Installing agent skills for Neon in this project...");
 	let anyFailed = false;
-	for (const editor of selectedEditors) {
-		const agentName = getSkillsAgentName(editor);
-		if (agentName === "") {
-			log.error(`Unsupported editor: ${editor}`);
-			anyFailed = true;
-			continue;
-		}
+	for (const editor of editorsWithSkills) {
+		const agentName = editorToSkillsAgent(editor);
 		try {
 			await execa("npx", [
 				"skills",
@@ -37,25 +73,96 @@ async function installAgentSkills(selectedEditors) {
 				"neon-postgres",
 				"--agent",
 				agentName,
+				...options?.scope === "global" ? ["-g"] : [],
 				"-y"
 			], {
 				stdio: "pipe",
 				timeout: 1e4
 			});
 		} catch (error) {
-			log.error(`Failed to install agent skills for ${editor}: ${error instanceof Error ? error.message : "Unknown error"}`);
+			if (!quiet) log.error(`Failed to install agent skills for ${editor}: ${error instanceof Error ? error.message : "Unknown error"}`);
 			anyFailed = true;
 		}
 	}
 	if (anyFailed) {
-		skillsSpinner.stop("Agent skills installation completed with errors");
-		log.info("You can manually install skills by running: npx skills add neondatabase/agent-skills --skill neon-postgres");
+		skillsSpinner?.stop("Agent skills installation for this project completed with errors");
+		if (!quiet) log.info("You can manually install skills by running: npx skills add neondatabase/agent-skills --skill neon-postgres");
 		return false;
 	}
-	skillsSpinner.stop("Agent skills installed ✓");
+	skillsSpinner?.stop(dim("Agent skills installed ✓"));
 	return true;
 }
-
+const SKILLS_FRESHNESS_MS = 720 * 60 * 1e3;
+/**
+* Agent skills directory paths by agent, keyed by scope.
+* These are the directories that `skills add` writes to.
+*/
+const GLOBAL_SKILLS_DIRS = (() => {
+	const home = process.env.HOME || process.env.USERPROFILE || "";
+	return {
+		cursor: [resolve(home, ".cursor", "skills")],
+		"claude-code": [resolve(home, ".claude", "skills")],
+		"github-copilot": [resolve(home, ".vscode", "skills")],
+		codex: [resolve(home, ".codex", "skills")],
+		cline: [resolve(home, ".cline", "skills")]
+	};
+})();
+/**
+* Checks whether skills were recently updated (within the freshness window).
+* Checks both project-level (skills-lock.json mtime) and global (skills dir mtime).
+*/
+function skillsAreFresh(agent) {
+	const now = Date.now();
+	const cwd = process.cwd();
+	const lockPath = resolve(cwd, "skills-lock.json");
+	if (existsSync(lockPath)) try {
+		if (readFileSync(lockPath, "utf-8").includes("neon-postgres")) {
+			if (existsSync(resolve(cwd, ".agents", "skills", "neon-postgres", "SKILL.md")) || existsSync(resolve(cwd, ".cursor", "skills", "neon-postgres", "SKILL.md")) || existsSync(resolve(cwd, ".claude", "skills", "neon-postgres", "SKILL.md"))) {
+				if (now - statSync(lockPath).mtimeMs < SKILLS_FRESHNESS_MS) return true;
+			}
+		}
+	} catch {}
+	const globalDirs = GLOBAL_SKILLS_DIRS[getSkillsAgentName(agent)] ?? [];
+	for (const dir of globalDirs) {
+		const neonSkillMd = resolve(dir, "neon-postgres", "SKILL.md");
+		if (existsSync(neonSkillMd)) try {
+			if (now - statSync(neonSkillMd).mtimeMs < SKILLS_FRESHNESS_MS) return true;
+		} catch {}
+	}
+	return false;
+}
+/**
+* Ensures Neon agent skills are up to date. Runs `skills add` if the skills
+* haven't been updated within the freshness window (12 hours).
+*
+* Designed to be called from any phase handler — cheap to call repeatedly
+* since it's a no-op when skills are fresh.
+*/
+async function ensureSkillsUpToDate(agent, scope) {
+	if (skillsAreFresh(agent)) return true;
+	const agentName = getSkillsAgentName(agent);
+	try {
+		await execa("npx", [
+			"-y",
+			"skills",
+			"add",
+			"neondatabase/agent-skills",
+			"--skill",
+			"neon-postgres",
+			"--agent",
+			agentName,
+			...scope === "global" ? ["-g"] : [],
+			"-y"
+		], {
+			stdio: "pipe",
+			timeout: 6e4
+		});
+		return true;
+	} catch {
+		return false;
+	}
+}
 //#endregion
-export { installAgentSkills };
+export { SKILL_REFERENCE_URLS, ensureSkillsUpToDate, fetchSkillContent, installAgentSkills };
+
 //# sourceMappingURL=skills.js.map

package/dist/lib/skills.js.map

@@ -1 +1 @@
-{"version":3,"file":"skills.js","names":[],"sources":["../../src/lib/skills.ts"],"sourcesContent":["import { log, spinner } from \"@clack/prompts\";\nimport { execa } from \"execa\";\nimport type { Editor } from \"./types.js\";\n\n/**\n * Maps editor names to the corresponding agent names used by the skills CLI\n */\nfunction getSkillsAgentName(editor: Editor): string {\n\tswitch (editor) {\n\t\tcase \"Cursor\":\n\t\t\treturn \"cursor\";\n\t\tcase \"VS Code\":\n\t\t\treturn \"github-copilot\";\n\t\tcase \"Claude CLI\":\n\t\t\treturn \"claude-code\";\n\t\tdefault:\n\t\t\treturn \"\";\n\t}\n}\n\n/**\n * Installs Neon agent skills using Vercel's skills CLI\n */\nexport async function installAgentSkills(\n\tselectedEditors: Editor[],\n): Promise<boolean> {\n\tif (selectedEditors.length === 0) {\n\t\treturn true;\n\t}\n\n\tconst skillsSpinner = spinner();\n\tskillsSpinner.start(\"Installing agent skills for Neon...\");\n\n\tlet anyFailed = false;\n\n\t// Run skills add for each selected editor/agent\n\tfor (const editor of selectedEditors) {\n\t\tconst agentName = getSkillsAgentName(editor);\n\n\t\tif (agentName === \"\") {\n\t\t\tlog.error(`Unsupported editor: ${editor}`);\n\t\t\tanyFailed = true;\n\t\t\tcontinue;\n\t\t}\n\n\t\ttry {\n\t\t\tawait execa(\n\t\t\t\t\"npx\",\n\t\t\t\t[\n\t\t\t\t\t\"skills\",\n\t\t\t\t\t\"add\",\n\t\t\t\t\t\"neondatabase/agent-skills\",\n\t\t\t\t\t\"--skill\",\n\t\t\t\t\t\"neon-postgres\",\n\t\t\t\t\t\"--agent\",\n\t\t\t\t\tagentName,\n\t\t\t\t\t\"-y\",\n\t\t\t\t],\n\t\t\t\t{\n\t\t\t\t\tstdio: \"pipe\",\n\t\t\t\t\ttimeout: 10000,\n\t\t\t\t},\n\t\t\t);\n\t\t} catch (error) {\n\t\t\tlog.error(\n\t\t\t\t`Failed to install agent skills for ${editor}: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n\t\t\t);\n\t\t\tanyFailed = true;\n\t\t}\n\t}\n\n\tif (anyFailed) {\n\t\tskillsSpinner.stop(\"Agent skills installation completed with errors\");\n\t\tlog.info(\n\t\t\t\"You can manually install skills by running: npx skills add neondatabase/agent-skills --skill neon-postgres\",\n\t\t);\n\t\treturn false;\n\t}\n\n\tskillsSpinner.stop(\"Agent skills installed ✓\");\n\treturn true;\n}\n"],"mappings":";;;;;;;AAOA,SAAS,mBAAmB,QAAwB;AACnD,SAAQ,QAAR;EACC,KAAK,SACJ,QAAO;EACR,KAAK,UACJ,QAAO;EACR,KAAK,aACJ,QAAO;EACR,QACC,QAAO;;;;;;AAOV,eAAsB,mBACrB,iBACmB;AACnB,KAAI,gBAAgB,WAAW,EAC9B,QAAO;CAGR,MAAM,gBAAgB,SAAS;AAC/B,eAAc,MAAM,sCAAsC;CAE1D,IAAI,YAAY;AAGhB,MAAK,MAAM,UAAU,iBAAiB;EACrC,MAAM,YAAY,mBAAmB,OAAO;AAE5C,MAAI,cAAc,IAAI;AACrB,OAAI,MAAM,uBAAuB,SAAS;AAC1C,eAAY;AACZ;;AAGD,MAAI;AACH,SAAM,MACL,OACA;IACC;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA,EACD;IACC,OAAO;IACP,SAAS;IACT,CACD;WACO,OAAO;AACf,OAAI,MACH,sCAAsC,OAAO,IAAI,iBAAiB,QAAQ,MAAM,UAAU,kBAC1F;AACD,eAAY;;;AAId,KAAI,WAAW;AACd,gBAAc,KAAK,kDAAkD;AACrE,MAAI,KACH,6GACA;AACD,SAAO;;AAGR,eAAc,KAAK,2BAA2B;AAC9C,QAAO"}
+{"version":3,"file":"skills.js","names":["getSkillsAgentNameFromId"],"sources":["../../src/lib/skills.ts"],"sourcesContent":["import { existsSync, readFileSync, statSync } from \"node:fs\";\nimport { resolve } from \"node:path\";\nimport { log, spinner } from \"@clack/prompts\";\nimport { execa } from \"execa\";\nimport { dim } from \"yoctocolors\";\nimport { getSkillsAgentName as getSkillsAgentNameFromId } from \"./agents.js\";\nimport type { Editor } from \"./types.js\";\n\nconst SKILL_BASE_URL =\n\t\"https://neon.com/docs/ai/skills/neon-postgres/references\";\n\nexport const SKILL_REFERENCE_URLS: Record<string, string> = {\n\tgettingStarted: `${SKILL_BASE_URL}/getting-started.md`,\n\tconnectionMethods: `${SKILL_BASE_URL}/connection-methods.md`,\n\tneonAuth: `${SKILL_BASE_URL}/neon-auth.md`,\n\tserverlessDriver: `${SKILL_BASE_URL}/neon-serverless.md`,\n\tneonCli: `${SKILL_BASE_URL}/neon-cli.md`,\n\tdevtools: `${SKILL_BASE_URL}/devtools.md`,\n\tbranching: `${SKILL_BASE_URL}/branching.md`,\n\tneonJs: `${SKILL_BASE_URL}/neon-js.md`,\n};\n\n/**\n * Fetches the \"Getting Started with Neon\" skill content from the public URL.\n * Returns the markdown content, or null if the fetch fails.\n */\nexport async function fetchSkillContent(): Promise<string | null> {\n\ttry {\n\t\tconst response = await fetch(SKILL_REFERENCE_URLS.gettingStarted, {\n\t\t\tsignal: AbortSignal.timeout(10000),\n\t\t});\n\t\tif (!response.ok) return null;\n\t\treturn await response.text();\n\t} catch {\n\t\treturn null;\n\t}\n}\n\n/**\n * Maps Editor display names to the skills CLI agent name.\n * Used only by the v1 installAgentSkills function.\n */\nfunction editorToSkillsAgent(editor: Editor): string {\n\tswitch (editor) {\n\t\tcase \"Cursor\":\n\t\t\treturn \"cursor\";\n\t\tcase \"VS Code\":\n\t\tcase \"GitHub Copilot CLI\":\n\t\t\treturn \"github-copilot\";\n\t\tcase \"Claude CLI\":\n\t\t\treturn \"claude-code\";\n\t\tcase \"Codex\":\n\t\t\treturn \"codex\";\n\t\tcase \"OpenCode\":\n\t\t\treturn \"opencode\";\n\t\tcase \"Antigravity\":\n\t\t\treturn \"antigravity\";\n\t\tcase \"Cline\":\n\t\tcase \"Cline CLI\":\n\t\t\treturn \"cline\";\n\t\tcase \"Gemini CLI\":\n\t\t\treturn \"gemini-cli\";\n\t\tcase \"Goose\":\n\t\t\treturn \"goose\";\n\t\tcase \"Claude Desktop\":\n\t\t\treturn \"claude-code\";\n\t\tcase \"MCPorter\":\n\t\t\treturn \"mcporter\";\n\t\tcase \"Zed\":\n\t\t\treturn \"zed\";\n\t\tdefault:\n\t\t\treturn \"\";\n\t}\n}\n\nexport interface InstallSkillsOptions {\n\tjson?: boolean;\n\tscope?: \"global\" | \"project\";\n}\n\n/**\n * Installs Neon agent skills using Vercel's skills CLI.\n */\nexport async function installAgentSkills(\n\tselectedEditors: Editor[],\n\toptions?: InstallSkillsOptions,\n): Promise<boolean> {\n\tconst quiet = options?.json === true;\n\n\tconst editorsWithSkills = selectedEditors.filter(\n\t\t(e) => editorToSkillsAgent(e) !== \"\",\n\t);\n\n\tif (editorsWithSkills.length === 0) {\n\t\treturn true;\n\t}\n\n\tconst skillsSpinner = quiet ? null : spinner();\n\tskillsSpinner?.start(\"Installing agent skills for Neon in this project...\");\n\n\tlet anyFailed = false;\n\n\tfor (const editor of editorsWithSkills) {\n\t\tconst agentName = editorToSkillsAgent(editor);\n\n\t\ttry {\n\t\t\tawait execa(\n\t\t\t\t\"npx\",\n\t\t\t\t[\n\t\t\t\t\t\"skills\",\n\t\t\t\t\t\"add\",\n\t\t\t\t\t\"neondatabase/agent-skills\",\n\t\t\t\t\t\"--skill\",\n\t\t\t\t\t\"neon-postgres\",\n\t\t\t\t\t\"--agent\",\n\t\t\t\t\tagentName,\n\t\t\t\t\t...(options?.scope === \"global\" ? [\"-g\"] : []),\n\t\t\t\t\t\"-y\",\n\t\t\t\t],\n\t\t\t\t{\n\t\t\t\t\tstdio: \"pipe\",\n\t\t\t\t\ttimeout: 10000,\n\t\t\t\t},\n\t\t\t);\n\t\t} catch (error) {\n\t\t\tif (!quiet)\n\t\t\t\tlog.error(\n\t\t\t\t\t`Failed to install agent skills for ${editor}: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n\t\t\t\t);\n\t\t\tanyFailed = true;\n\t\t}\n\t}\n\n\tif (anyFailed) {\n\t\tskillsSpinner?.stop(\n\t\t\t\"Agent skills installation for this project completed with errors\",\n\t\t);\n\t\tif (!quiet)\n\t\t\tlog.info(\n\t\t\t\t\"You can manually install skills by running: npx skills add neondatabase/agent-skills --skill neon-postgres\",\n\t\t\t);\n\t\treturn false;\n\t}\n\n\tskillsSpinner?.stop(dim(\"Agent skills installed ✓\"));\n\treturn true;\n}\n\n// ---------------------------------------------------------------------------\n// Evergreen skills: ensure skills are up to date (at most once per 12 hours)\n// ---------------------------------------------------------------------------\n\nconst SKILLS_FRESHNESS_MS = 12 * 60 * 60 * 1000; // 12 hours\n\n/**\n * Agent skills directory paths by agent, keyed by scope.\n * These are the directories that `skills add` writes to.\n */\nconst GLOBAL_SKILLS_DIRS: Record<string, string[]> = (() => {\n\tconst home = process.env.HOME || process.env.USERPROFILE || \"\";\n\treturn {\n\t\tcursor: [resolve(home, \".cursor\", \"skills\")],\n\t\t\"claude-code\": [resolve(home, \".claude\", \"skills\")],\n\t\t\"github-copilot\": [resolve(home, \".vscode\", \"skills\")],\n\t\tcodex: [resolve(home, \".codex\", \"skills\")],\n\t\tcline: [resolve(home, \".cline\", \"skills\")],\n\t};\n})();\n\n/**\n * Checks whether skills were recently updated (within the freshness window).\n * Checks both project-level (skills-lock.json mtime) and global (skills dir mtime).\n */\nfunction skillsAreFresh(agent: string): boolean {\n\tconst now = Date.now();\n\tconst cwd = process.cwd();\n\n\t// Check project-level: skills-lock.json must reference neon-postgres\n\t// AND the skill file must actually exist on disk\n\tconst lockPath = resolve(cwd, \"skills-lock.json\");\n\tif (existsSync(lockPath)) {\n\t\ttry {\n\t\t\tconst content = readFileSync(lockPath, \"utf-8\");\n\t\t\tif (content.includes(\"neon-postgres\")) {\n\t\t\t\t// Verify the actual skill file exists (lock file can be stale)\n\t\t\t\tconst skillExists =\n\t\t\t\t\texistsSync(\n\t\t\t\t\t\tresolve(\n\t\t\t\t\t\t\tcwd,\n\t\t\t\t\t\t\t\".agents\",\n\t\t\t\t\t\t\t\"skills\",\n\t\t\t\t\t\t\t\"neon-postgres\",\n\t\t\t\t\t\t\t\"SKILL.md\",\n\t\t\t\t\t\t),\n\t\t\t\t\t) ||\n\t\t\t\t\texistsSync(\n\t\t\t\t\t\tresolve(\n\t\t\t\t\t\t\tcwd,\n\t\t\t\t\t\t\t\".cursor\",\n\t\t\t\t\t\t\t\"skills\",\n\t\t\t\t\t\t\t\"neon-postgres\",\n\t\t\t\t\t\t\t\"SKILL.md\",\n\t\t\t\t\t\t),\n\t\t\t\t\t) ||\n\t\t\t\t\texistsSync(\n\t\t\t\t\t\tresolve(\n\t\t\t\t\t\t\tcwd,\n\t\t\t\t\t\t\t\".claude\",\n\t\t\t\t\t\t\t\"skills\",\n\t\t\t\t\t\t\t\"neon-postgres\",\n\t\t\t\t\t\t\t\"SKILL.md\",\n\t\t\t\t\t\t),\n\t\t\t\t\t);\n\t\t\t\tif (skillExists) {\n\t\t\t\t\tconst mtime = statSync(lockPath).mtimeMs;\n\t\t\t\t\tif (now - mtime < SKILLS_FRESHNESS_MS) return true;\n\t\t\t\t}\n\t\t\t}\n\t\t} catch {}\n\t}\n\n\t// Check global: neon-postgres SKILL.md inside agent-specific skills directories\n\tconst agentName = getSkillsAgentNameFromId(agent);\n\tconst globalDirs = GLOBAL_SKILLS_DIRS[agentName] ?? [];\n\tfor (const dir of globalDirs) {\n\t\tconst neonSkillMd = resolve(dir, \"neon-postgres\", \"SKILL.md\");\n\t\tif (existsSync(neonSkillMd)) {\n\t\t\ttry {\n\t\t\t\tconst mtime = statSync(neonSkillMd).mtimeMs;\n\t\t\t\tif (now - mtime < SKILLS_FRESHNESS_MS) return true;\n\t\t\t} catch {}\n\t\t}\n\t}\n\n\treturn false;\n}\n\n/**\n * Ensures Neon agent skills are up to date. Runs `skills add` if the skills\n * haven't been updated within the freshness window (12 hours).\n *\n * Designed to be called from any phase handler — cheap to call repeatedly\n * since it's a no-op when skills are fresh.\n */\nexport async function ensureSkillsUpToDate(\n\tagent: string,\n\tscope?: \"global\" | \"project\",\n): Promise<boolean> {\n\tif (skillsAreFresh(agent)) return true;\n\n\tconst agentName = getSkillsAgentNameFromId(agent);\n\ttry {\n\t\tawait execa(\n\t\t\t\"npx\",\n\t\t\t[\n\t\t\t\t\"-y\",\n\t\t\t\t\"skills\",\n\t\t\t\t\"add\",\n\t\t\t\t\"neondatabase/agent-skills\",\n\t\t\t\t\"--skill\",\n\t\t\t\t\"neon-postgres\",\n\t\t\t\t\"--agent\",\n\t\t\t\tagentName,\n\t\t\t\t...(scope === \"global\" ? [\"-g\"] : []),\n\t\t\t\t\"-y\",\n\t\t\t],\n\t\t\t{ stdio: \"pipe\", timeout: 60000 },\n\t\t);\n\t\treturn true;\n\t} catch {\n\t\treturn false;\n\t}\n}\n"],"mappings":"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"}

package/dist/lib/types.d.ts

@@ -1,22 +1,155 @@
 //#region src/lib/types.d.ts
-type Editor = "Cursor" | "VS Code" | "Claude CLI";
+type Editor = "Cursor" | "VS Code" | "Claude CLI" | "Claude Desktop" | "Codex" | "OpenCode" | "Antigravity" | "Cline" | "Cline CLI" | "Gemini CLI" | "GitHub Copilot CLI" | "Goose" | "MCPorter" | "Zed";
 type InstallStatus = "success" | "failed";
-interface MCPConfig {
-  mcpServers?: {
-    [key: string]: {
-      type?: string;
-      url: string;
-      headers?: Record<string, string>;
+interface InitResult {
+  success: boolean;
+  auth: boolean;
+  authRequired?: boolean;
+  authInstructions?: string;
+  agentInstructions?: string;
+  editors: {
+    editor: Editor;
+    status: InstallStatus;
+    type: "mcp" | "extension";
+  }[];
+  skills: {
+    installed: boolean;
+    gettingStarted: string | null;
+    references: Record<string, string>;
+  };
+  neonctl: {
+    authenticated: boolean;
+    commands: {
+      listOrgs: string;
+      listProjects: string;
+      createProject: string;
+      getConnectionString: string;
     };
   };
-  servers?: {
-    [key: string]: {
-      type?: string;
-      url: string;
-      headers?: Record<string, string>;
+  mcpServer: {
+    configured: boolean;
+    requiresRestart: boolean;
+  };
+}
+type Phase = "auth" | "tooling" | "setup" | "db" | "neon_auth" | "migrations";
+type NextAction = AskUserAction | RunCommandAction | RunNeonInitAction | AgentCheckAction | AgentActionAction | RestartRequiredAction | CompleteAction;
+interface AskUserAction {
+  type: "ask_user";
+  question: string;
+  options: (string | {
+    value: string;
+    label: string;
+  })[];
+  context?: string;
+  /** Maps each option value to the next CLI invocation args, or an inline action to execute directly */
+  responseMapping: Record<string, {
+    args: string[];
+  } | {
+    action: NextAction;
+  }>;
+}
+interface RunCommandAction {
+  type: "run_command";
+  command: string;
+  description?: string;
+  timeout?: number;
+  onSuccess: RunNeonInitAction;
+  onFailure?: Record<string, NextAction>;
+}
+interface RunNeonInitAction {
+  type: "run_neon_init";
+  args: string[];
+}
+interface AgentCheck {
+  id: string;
+  description: string;
+  lookFor: string[];
+}
+interface AgentCheckAction {
+  type: "agent_check";
+  /** Step-by-step workflow for the agent describing the exact order of operations */
+  instructions?: string;
+  checks: AgentCheck[];
+  /** Questions to ask the user — respect the phase field for ordering relative to checks */
+  userPreferences?: UserPreference[];
+  reportBack: RunNeonInitAction;
+}
+interface UserPreference {
+  id: string;
+  question: string;
+  options: (string | {
+    value: string;
+    label: string;
+  })[];
+  context?: string;
+  default?: string;
+  /** Only present this preference if another preference was answered with the specified value */
+  condition?: {
+    preferenceId: string;
+    equals: string;
+  };
+  /** When to ask this preference relative to the inspection checks */
+  phase?: "before_checks" | "after_checks";
+  /** Preferences with the same group should be presented together as a single form */
+  group?: string;
+}
+interface AgentStep {
+  id: string;
+  description: string;
+  command?: string;
+}
+interface AgentActionAction {
+  type: "agent_action";
+  prerequisite?: string;
+  steps: AgentStep[];
+  onComplete: RunNeonInitAction | CompleteAction;
+}
+interface RestartRequiredAction {
+  type: "restart_required";
+  reason: string;
+  resumeCommand: string;
+}
+interface CompleteAction {
+  type: "complete";
+  message: string;
+}
+interface PhaseResponse {
+  phase: Phase;
+  status: string;
+  nextAction: NextAction;
+  [key: string]: unknown;
+}
+interface StatusResponse {
+  auth: {
+    authenticated: boolean;
+    user?: string;
+  };
+  tooling: {
+    mcpServer: {
+      configured: boolean | null;
+      location?: string;
+    };
+    skills: {
+      installed: boolean;
     };
+    extension?: {
+      installed: boolean;
+      editor: string;
+    } | null;
+  };
+  project: {
+    databaseUrl: boolean;
+  };
+  migrations: {
+    tool: string | null;
+    hasMigrations: boolean;
   };
+  recommendations: {
+    priority: string;
+    message: string;
+    command: string;
+  }[];
 }
 //#endregion
-export { Editor, InstallStatus, MCPConfig };
+export { AgentActionAction, AgentCheck, AgentCheckAction, AgentStep, AskUserAction, CompleteAction, Editor, InitResult, InstallStatus, NextAction, Phase, PhaseResponse, RestartRequiredAction, RunCommandAction, RunNeonInitAction, StatusResponse, UserPreference };
 //# sourceMappingURL=types.d.ts.map

package/dist/lib/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","names":[],"sources":["../../src/lib/types.ts"],"sourcesContent":[],"mappings":";KAAY,MAAA;AAAA,KAEA,aAAA,GAFM,SAAA,GAAA,QAAA;AAEN,UAEK,SAAA,CAFQ;EAER,UAAA,CAAA,EAAS;IAAA,CAAA,GAAA,EAAA,MAAA,CAAA,EAAA;MAKb,IAAA,CAAA,EAAA,MAAA;MAOA,GAAA,EAAA,MAAA;MAAM,OAAA,CAAA,EAPN,MAOM,CAAA,MAAA,EAAA,MAAA,CAAA;;;;;;;gBAAN"}
+{"version":3,"file":"types.d.ts","names":[],"sources":["../../src/lib/types.ts"],"mappings":";KAAY,MAAA;AAAA,KAgBA,aAAA,GAhBM,SAAA,GAAA,QAAA;AAgBN,UAMK,UAAA,CANQ;EAMR,OAAA,EAAA,OAAU;EAAA,IAAA,EAAA,OAAA;cAOjB,CAAA,EAAA,OAAA;kBACA,CAAA,EAAA,MAAA;mBAMI,CAAA,EAAA,MAAA;EAAM,OAAA,EAAA;IAqBR,MAAK,EA5BP,MA4BO;IAUL,MAAA,EArCF,aAqCY;IAAA,IAAA,EAAA,KAAA,GAAA,WAAA;KACnB;QACA,EAAA;IACA,SAAA,EAAA,OAAA;IACA,cAAA,EAAA,MAAA,GAAA,IAAA;IACA,UAAA,EApCW,MAoCX,CAAA,MAAA,EAAA,MAAA,CAAA;;SAEA,EAAA;IAAc,aAAA,EAAA,OAAA;IAEA,QAAA,EAAA;MAAa,QAAA,EAAA,MAAA;MAQG,YAAA,EAAA,MAAA;MAFf,aAAA,EAAA,MAAA;MAAM,mBAAA,EAAA,MAAA;IAMP,CAAA;EAAgB,CAAA;WAKrB,EAAA;IACgB,UAAA,EAAA,OAAA;IAAf,eAAA,EAAA,OAAA;EAAM,CAAA;AAGnB;AAKiB,KA7CL,KAAA,GA6Ce,MAAA,GAAA,SAAA,GAAA,OAAA,GAAA,IAAA,GAAA,WAAA,GAAA,YAAA;AAMV,KAzCL,UAAA,GACT,aAwC8B,GAvC9B,gBAuC8B,GAtC9B,iBAsC8B,GArC9B,gBAqC8B,GApC9B,iBAoC8B,GAnC9B,qBAmC8B,GAlC9B,cAkC8B;AAAA,UAhChB,aAAA,CAgCgB;MAIxB,EAAA,UAAA;UAEU,EAAA,MAAA;SACN,EAAA,CAAA,MAAA,GAAA;IAAiB,KAAA,EAAA,MAAA;IAGb,KAAA,EAAA,MAAc;EAiBd,CAAA,CAAA,EAAA;EAMA,OAAA,CAAA,EAAA,MAAA;EAAiB;iBAG1B,EA9DU,MA8DV,CAAA,MAAA,EAAA;IACK,IAAA,EAAA,MAAA,EAAA;MAAoB;IAAc,MAAA,EA7Dd,UA6Dc;EAG9B,CAAA,CAAA;AAMjB;AAOiB,UAzEA,gBAAA,CAyEa;EAAA,IAAA,EAAA,aAAA;SACtB,EAAA,MAAA;aAEK,CAAA,EAAA,MAAA;EAAU,OAAA,CAAA,EAAA,MAAA;EAMN,SAAA,EA7EL,iBA6EmB;cA5ElB,eAAe;;UAGX,iBAAA;;;;UAKA,UAAA;;;;;UAMA,gBAAA;;;;UAIR;;oBAEU;cACN;;UAGI,cAAA;;;;;;;;;;;;;;;;;;;UAiBA,SAAA;;;;;UAMA,iBAAA;;;SAGT;cACK,oBAAoB;;UAGhB,qBAAA;;;;;UAMA,cAAA;;;;UAOA,aAAA;SACT;;cAEK;;;UAMI,cAAA"}

package/dist/lib/types.js

@@ -1 +1 @@
-export {  };
+export {};