neon 4.18.0 → 4.19.0

package/README.md

@@ -610,6 +610,8 @@ export default defineConfig({
 ? Which Neon services should neon.ts declare? (space to toggle, enter to confirm) ›
 ◯   Managed Better Auth
      Authentication with users and sessions stored in Postgres.
+◯   Data API
+     PostgREST-compatible HTTP API. Also declares Auth; the default provider needs it.
 ◯   Functions
      Long-running, without timeouts, and closer to your database.
 ◯   Object Storage
@@ -627,6 +629,9 @@ neon config init
 # Declare services with no prompt
 neon config init --services auth,functions,object-storage,ai-gateway
 
+# Data API also writes auth: true (the default provider requires it)
+neon config init --services data-api
+
 # Repeat the flag instead, and shorten it — every services flag takes all three spellings
 neon config init -s auth -s functions
 

package/dist/analytics.js

@@ -195,6 +195,30 @@ const trackEvent = (event, properties) => {
 	});
 	log.debug("Sent CLI event: %s", event);
 };
+let commandSuccessExtras = {};
+const recordCommandSuccessExtras = (patch) => {
+	commandSuccessExtras = {
+		...commandSuccessExtras,
+		...patch
+	};
+};
+const recordScaffoldedTemplate = (templateId) => {
+	recordCommandSuccessExtras({ template: templateId });
+};
+const takeCommandSuccessExtras = () => {
+	const extras = commandSuccessExtras;
+	commandSuccessExtras = {};
+	return extras;
+};
+const commandSuccessProperties = (args) => ({
+	...getAnalyticsEventProperties(args),
+	projectId: args.projectId,
+	branchId: args.branchId,
+	accountId: args.accountId,
+	authMethod: args.authMethod,
+	authData: args.authData,
+	...takeCommandSuccessExtras()
+});
 const analyticsCommand = (args) => {
 	const command = args._.join(" ");
 	const raw = args._[0] !== "ask" || typeof args.prompt !== "string" ? command : `${command} ${args.prompt}`;
@@ -209,4 +233,4 @@ const getAnalyticsEventProperties = (args) => ({
 	githubEnvVars: getGithubEnvVars(process.env)
 });
 //#endregion
-export { analyticsMiddleware, analyticsUserId, closeAnalytics, getAnalyticsEventProperties, getErrorAnalyticsEventProperties, initAnalyticsClientMiddleware, sendError, storedCredentialAttribution, telemetryCredential, trackEvent };
+export { analyticsMiddleware, analyticsUserId, closeAnalytics, commandSuccessProperties, getAnalyticsEventProperties, getErrorAnalyticsEventProperties, initAnalyticsClientMiddleware, recordCommandSuccessExtras, recordScaffoldedTemplate, sendError, storedCredentialAttribution, takeCommandSuccessExtras, telemetryCredential, trackEvent };

package/dist/commands/bootstrap.js

@@ -1,6 +1,7 @@
 import { t as __exportAll } from "../_chunks/rolldown-runtime-8H4AJuhK.js";
 import { isCi } from "../env.js";
 import { log } from "../log.js";
+import { recordCommandSuccessExtras, recordScaffoldedTemplate } from "../analytics.js";
 import { t as credentialInputs } from "../_chunks/auth_selection-pitMFzDe.js";
 import { getCliName } from "../utils/cli_name.js";
 import { helpCsv, helpEpilogue } from "../utils/help_text.js";
@@ -114,8 +115,11 @@ const handler = async (props) => {
 	const targetDir = await resolveTargetDir(props, interactive, template);
 	ensureTargetUsable(targetDir, props.force);
 	await scaffold(template, targetDir);
+	recordScaffoldedTemplate(template.id);
 	printScaffolded(template, targetDir);
-	return runPostScaffoldSteps(props, targetDir, interactive, template, named);
+	const result = await runPostScaffoldSteps(props, targetDir, interactive, template, named);
+	recordCommandSuccessExtras({ agent_setup: result.agentSetup });
+	return result;
 };
 /**
 * The template list to choose from. When --template is given we try the

package/dist/commands/init.js

@@ -1,6 +1,7 @@
 import { t as __exportAll } from "../_chunks/rolldown-runtime-8H4AJuhK.js";
 import { log } from "../log.js";
 import { contextBranch, readContextFile } from "../context.js";
+import { recordCommandSuccessExtras } from "../analytics.js";
 import { t as credentialInputs } from "../_chunks/auth_selection-pitMFzDe.js";
 import { getCliName } from "../utils/cli_name.js";
 import { deprecatedServiceMessage, parseServices, servicesFlagValue, servicesOption } from "../neon_services.js";
@@ -184,6 +185,12 @@ const noteTemplateKeepsShippedConfig = (config, services) => {
 	if (config === void 0 && services === void 0) return;
 	log.warning(INIT_TEMPLATE_KEEPS_CONFIG);
 };
+const recordInitSuccess = (kind, agentSetup) => {
+	recordCommandSuccessExtras({
+		init_kind: kind,
+		...agentSetup !== void 0 ? { agent_setup: agentSetup } : {}
+	});
+};
 const handler = async (props) => {
 	if (props.output === "json" || props.output === "yaml") throw new Error(`\`${getCliName()} init\` does not support --output. The commands it runs print their own output.`);
 	const cwd = props.cwd ?? process.cwd();
@@ -228,6 +235,7 @@ const handler = async (props) => {
 			...templateChoice.kind === "template" ? { id: templateChoice.id } : {}
 		}, linkInputs));
 		printNestedBootstrapDone(result, cwd, templateChoice.kind === "template" ? templateChoice.id : "default");
+		recordInitSuccess("empty-template", result?.agentSetup);
 		return;
 	}
 	if (templateChoice.kind === "ask") {
@@ -242,6 +250,7 @@ const handler = async (props) => {
 				useDefault: false
 			}, linkInputs));
 			printNestedBootstrapDone(result, cwd, picked.template.id);
+			recordInitSuccess("empty-template", result?.agentSetup);
 			return;
 		}
 	}
@@ -351,6 +360,7 @@ Run \`${getCliName()} env pull\` once resolved.`, message);
 		],
 		next: []
 	}));
+	recordInitSuccess(templateChoice.kind === "existing" ? "existing" : "empty-skip", agentSetup);
 };
 //#endregion
 export { builder, command, describe, handler, initChildEnv, init_exports as t };

package/dist/commands/mcp.js

@@ -1,6 +1,7 @@
 import { t as __exportAll } from "../_chunks/rolldown-runtime-8H4AJuhK.js";
 import { log } from "../log.js";
 import { readContextFile } from "../context.js";
+import { recordCommandSuccessExtras } from "../analytics.js";
 import { getCliName } from "../utils/cli_name.js";
 import { helpCsv, helpEpilogue } from "../utils/help_text.js";
 import { writer } from "../writer.js";
@@ -217,6 +218,7 @@ const handler = async (props) => {
 	if (minted) log.info("Minted API key %s (id %d, %s). Revoke with: %s", minted.name, minted.id, minted.projectId ? "project" : "account", mintedKeyRevokeCommand(minted));
 	if (plan.auth === "oauth") log.info("The agent will prompt for Neon sign-in on first use.");
 	if (failedAgents.length > 0) throw new Error(`Failed to write Neon MCP config for: ${failedAgents.join(", ")}.`);
+	recordCommandSuccessExtras({ scope: plan.scope });
 };
 //#endregion
 export { builder, command, describe, handler, mcp_exports as t };

package/dist/commands/plugins.js

@@ -1,5 +1,6 @@
 import { t as __exportAll } from "../_chunks/rolldown-runtime-8H4AJuhK.js";
 import { log } from "../log.js";
+import { recordCommandSuccessExtras } from "../analytics.js";
 import { helpCsv, helpEpilogue } from "../utils/help_text.js";
 import { writer } from "../writer.js";
 import { noPassthrough } from "../utils/flags.js";
@@ -124,6 +125,7 @@ const handler = async (props) => {
 	});
 	out.end();
 	if (failed.length === 0) {
+		recordCommandSuccessExtras({ scope: plan.scope });
 		log.info(plan.scope === "project" ? "Installed the Neon plugin (project)." : "Installed the Neon plugin (user).");
 		return;
 	}

package/dist/commands/skills.js

@@ -1,5 +1,6 @@
 import { t as __exportAll } from "../_chunks/rolldown-runtime-8H4AJuhK.js";
 import { log } from "../log.js";
+import { recordCommandSuccessExtras } from "../analytics.js";
 import { helpCsv, helpEpilogue } from "../utils/help_text.js";
 import { writer } from "../writer.js";
 import { noPassthrough } from "../utils/flags.js";
@@ -160,6 +161,7 @@ const handler = async (props) => {
 	});
 	out.end();
 	if (failed.length === 0) {
+		recordCommandSuccessExtras({ scope: plan.scope });
 		log.info(plan.scope === "project" ? "Wrote skills in this directory." : "Wrote user-level skills.");
 		return;
 	}

package/dist/commands/triggers.js

@@ -27,17 +27,112 @@ async function withTriggerNotFound(triggerId, branchId, run) {
 		throw err;
 	}
 }
+const TRIGGER_COMMON_FIELDS = [
+	"trigger_id",
+	"name",
+	"function_slug",
+	"function_path",
+	"enabled",
+	"inherited"
+];
 const TRIGGER_FIELDS = [
 	"trigger_id",
 	"name",
+	"type",
 	"function_slug",
 	"function_path",
 	"schedule",
+	"storage",
 	"enabled",
 	"inherited",
 	"next_run_at"
 ];
-const renderColumns = { schedule: (t) => t.schedule?.cron ?? "" };
+function storageMatch(config) {
+	return config.prefix === void 0 ? config.bucket_name : `${config.bucket_name} ${config.prefix}`;
+}
+function triggerTableRow(t) {
+	if (t.type === "schedule") return {
+		trigger_id: t.trigger_id,
+		name: t.name,
+		type: t.type,
+		function_slug: t.function_slug,
+		function_path: t.function_path,
+		schedule: t.schedule.cron,
+		storage: "",
+		enabled: t.enabled,
+		inherited: t.inherited,
+		next_run_at: t.next_run_at ?? ""
+	};
+	return {
+		trigger_id: t.trigger_id,
+		name: t.name,
+		type: t.type,
+		function_slug: t.function_slug,
+		function_path: t.function_path,
+		schedule: "",
+		storage: storageMatch(t.storage_object_created),
+		enabled: t.enabled,
+		inherited: t.inherited,
+		next_run_at: ""
+	};
+}
+function writeTrigger(props, data, extra) {
+	if (props.output !== "table") {
+		writer(props).end(data, {
+			fields: TRIGGER_COMMON_FIELDS,
+			...extra
+		});
+		return;
+	}
+	const rows = Array.isArray(data) ? data.map(triggerTableRow) : triggerTableRow(data);
+	writer(props).end(rows, {
+		fields: TRIGGER_FIELDS,
+		...extra
+	});
+}
+function enabledPatch(type, enabled) {
+	if (type === "schedule") return {
+		type: "schedule",
+		enabled
+	};
+	return {
+		type: "storage_object_created",
+		enabled
+	};
+}
+function updatePatch(type, props) {
+	if (type === "schedule") {
+		const body = { type: "schedule" };
+		if (props["function-slug"] !== void 0) body.function_slug = props["function-slug"];
+		if (props.name !== void 0) body.name = props.name;
+		if (props.cron !== void 0) body.schedule = { cron: props.cron };
+		if (props["function-path"] !== void 0) body.function_path = props["function-path"];
+		if (props.enabled !== void 0) body.enabled = props.enabled;
+		return body;
+	}
+	const body = { type: "storage_object_created" };
+	if (props["function-slug"] !== void 0) body.function_slug = props["function-slug"];
+	if (props.name !== void 0) body.name = props.name;
+	if (props["function-path"] !== void 0) body.function_path = props["function-path"];
+	if (props.enabled !== void 0) body.enabled = props.enabled;
+	return body;
+}
+function noFieldsToUpdateMessage(type) {
+	const flags = type === "schedule" ? [
+		"--function-slug",
+		"--name",
+		"--cron",
+		"--function-path",
+		"--enabled"
+	] : [
+		"--function-slug",
+		"--name",
+		"--function-path",
+		"--enabled"
+	];
+	const last = flags[flags.length - 1];
+	return `No fields to update. Pass at least one of ${flags.slice(0, -1).join(", ")}, or ${last}.`;
+}
 const command = "triggers";
 const describe = "Manage function triggers";
 const aliases = ["trigger"];
@@ -117,19 +212,12 @@ const handler = (args) => {
 const list = async (props) => {
 	const branchId = await branchIdFromProps(props);
 	const { data } = await props.apiClient.listProjectBranchTriggers(props.projectId, branchId);
-	writer(props).end(data.triggers, {
-		fields: TRIGGER_FIELDS,
-		renderColumns,
-		emptyMessage: "No triggers found on this branch."
-	});
+	writeTrigger(props, data.triggers, { emptyMessage: "No triggers found on this branch." });
 };
 const get = async (props) => {
 	const branchId = await branchIdFromProps(props);
 	const { data } = await withTriggerNotFound(props.id, branchId, () => props.apiClient.getProjectBranchTrigger(props.projectId, branchId, props.id));
-	writer(props).end(data.trigger, {
-		fields: TRIGGER_FIELDS,
-		renderColumns
-	});
+	writeTrigger(props, data.trigger);
 };
 const create = async (props) => {
 	const branchId = await branchIdFromProps(props);
@@ -142,36 +230,23 @@ const create = async (props) => {
 	if (props["function-path"] !== void 0) body.function_path = props["function-path"];
 	if (props.enabled !== void 0) body.enabled = props.enabled;
 	const { data } = await retryOnLock(() => props.apiClient.createProjectBranchTrigger(props.projectId, branchId, body));
-	writer(props).end(data.trigger, {
-		fields: TRIGGER_FIELDS,
-		renderColumns
-	});
+	writeTrigger(props, data.trigger);
 };
 const update = async (props) => {
 	const branchId = await branchIdFromProps(props);
-	const body = { type: "schedule" };
-	if (props["function-slug"] !== void 0) body.function_slug = props["function-slug"];
-	if (props.name !== void 0) body.name = props.name;
-	if (props.cron !== void 0) body.schedule = { cron: props.cron };
-	if (props["function-path"] !== void 0) body.function_path = props["function-path"];
-	if (props.enabled !== void 0) body.enabled = props.enabled;
-	if (Object.keys(body).filter((k) => k !== "type").length === 0) throw new Error("No fields to update. Pass at least one of --function-slug, --name, --cron, --function-path, or --enabled.");
+	const { data: existing } = await withTriggerNotFound(props.id, branchId, () => props.apiClient.getProjectBranchTrigger(props.projectId, branchId, props.id));
+	const trigger = existing.trigger;
+	if (props.cron !== void 0 && trigger.type !== "schedule") throw new Error(`Trigger ${props.id} is type ${trigger.type}; --cron applies to schedule triggers.`);
+	const body = updatePatch(trigger.type, props);
+	if (Object.keys(body).filter((k) => k !== "type").length === 0) throw new Error(noFieldsToUpdateMessage(trigger.type));
 	const { data } = await withTriggerNotFound(props.id, branchId, () => retryOnLock(() => props.apiClient.updateProjectBranchTrigger(props.projectId, branchId, props.id, body)));
-	writer(props).end(data.trigger, {
-		fields: TRIGGER_FIELDS,
-		renderColumns
-	});
+	writeTrigger(props, data.trigger);
 };
 const setEnabled = async (props, enabled) => {
 	const branchId = await branchIdFromProps(props);
-	const { data } = await withTriggerNotFound(props.id, branchId, () => retryOnLock(() => props.apiClient.updateProjectBranchTrigger(props.projectId, branchId, props.id, {
-		type: "schedule",
-		enabled
-	})));
-	writer(props).end(data.trigger, {
-		fields: TRIGGER_FIELDS,
-		renderColumns
-	});
+	const { data: existing } = await withTriggerNotFound(props.id, branchId, () => props.apiClient.getProjectBranchTrigger(props.projectId, branchId, props.id));
+	const { data } = await withTriggerNotFound(props.id, branchId, () => retryOnLock(() => props.apiClient.updateProjectBranchTrigger(props.projectId, branchId, props.id, enabledPatch(existing.trigger.type, enabled))));
+	writeTrigger(props, data.trigger);
 };
 const deleteTrigger = async (props) => {
 	const branchId = await branchIdFromProps(props);

package/dist/config_template.js

@@ -15,24 +15,21 @@ const REQUIRED_PACKAGES = [CONFIG_PACKAGE, ENV_PACKAGE];
 /**
 * The services `config init` can declare in the `neon.ts` it scaffolds — the subset of
 * {@link NEON_SERVICES} a policy has a field for. {@link renderNeonConfig} owns the mapping
-* from these names to the `neon.ts` fields (`aiGateway`, `buckets`).
+* from these names to the `neon.ts` fields (`aiGateway`, `buckets`, `dataApi`).
 *
-* Postgres is absent because every branch has it, so there is nothing to declare. `data-api`
-* is absent because enabling it with the default `authProvider: "neon"` requires `auth` — a
-* pairing the picker would have to enforce rather than offer.
+* Postgres is absent because every branch has it, so there is nothing to declare. Selecting
+* `data-api` also writes `auth: true`: the default Data API provider requires Neon Auth, and
+* `defineConfig` type-errors the file without it.
 */
-const CONFIG_INIT_SERVICES = NEON_SERVICES.filter((service) => service !== "postgres" && service !== "data-api");
+const CONFIG_INIT_SERVICES = NEON_SERVICES.filter((service) => service !== "postgres");
 /**
 * What `config init --services none` produces. One constant because it is both the help text
 * and what tells the parser `none` is a value here — passing the literal at each call site
 * lets the two drift into documenting something the parser does not accept.
 */
 const CONFIG_INIT_NONE_MEANS = "the bare starter policy";
-/** Why the two a policy cannot declare are not selectable, for the refusal message. */
-const CONFIG_INIT_UNAVAILABLE = {
-	postgres: "every branch has Postgres, so a policy has nothing to declare for it",
-	"data-api": "enabling it with the default provider requires auth, so declare auth here and turn the Data API on with `neon data-api create`"
-};
+/** Why a policy cannot declare a real Neon service, for the refusal message. */
+const CONFIG_INIT_UNAVAILABLE = { postgres: "every branch has Postgres, so a policy has nothing to declare for it" };
 /** Slug, display name, and source path of the function scaffolded for `functions`. */
 const FUNCTION_SLUG = "hello";
 const FUNCTION_NAME = "Hello World";
@@ -70,13 +67,19 @@ const renderPreview = (services) => {
 * policy — an explicit `auth: false`, no `preview` block, and a `branch` closure that gives
 * new non-default branches a 7-day TTL — so the picker's "skip everything" answer and a
 * non-interactive run produce the identical file.
+*
+* `data-api` writes `dataApi: true` and forces `auth: true`. The default provider is Neon
+* Auth; omitting auth is a `defineConfig` type error rather than a deploy-time surprise.
 */
-const renderNeonConfig = (services) => `import { defineConfig } from "${CONFIG_PACKAGE}/v1";
+const renderNeonConfig = (services) => {
+	const auth = services.includes("auth") || services.includes("data-api");
+	const dataApi = services.includes("data-api") ? "  dataApi: true,\n" : "";
+	return `import { defineConfig } from "${CONFIG_PACKAGE}/v1";
 
 export default defineConfig({
   // Declare your Neon services here
-  auth: ${services.includes("auth")},
-${renderPreview(services)}  // Branch policy: per-branch tuning
+  auth: ${auth},
+${dataApi}${renderPreview(services)}  // Branch policy: per-branch tuning
   branch: (branch) => {
     if (branch.isDefault) {
       // Default branch: no overrides, uses project defaults
@@ -92,6 +95,7 @@ ${renderPreview(services)}  // Branch policy: per-branch tuning
   },
 });
 `;
+};
 /** Render a scalar the way it has to appear in TypeScript source. */
 const renderScalar = (value) => typeof value === "string" ? `"${value}"` : String(value);
 /**

package/dist/index.js

@@ -5,7 +5,7 @@ import { getAuthContext } from "./auth_context.js";
 import { r as defaultDir } from "./_chunks/paths-DMq0Lt7a.js";
 import { ensureConfigDir } from "./config.js";
 import { currentContextFile, enrichFromContext } from "./context.js";
-import { analyticsMiddleware, closeAnalytics, getAnalyticsEventProperties, initAnalyticsClientMiddleware, sendError, trackEvent } from "./analytics.js";
+import { analyticsMiddleware, closeAnalytics, commandSuccessProperties, initAnalyticsClientMiddleware, sendError, takeCommandSuccessExtras, trackEvent } from "./analytics.js";
 import { NETWORK_ERROR_MESSAGE, isNetworkError, matchErrorCode } from "./errors.js";
 import { AuthRefreshError, defaultClientID } from "./auth.js";
 import { ensureAuth } from "./commands/auth.js";
@@ -187,14 +187,7 @@ async function handleError(msg, err, canRetry) {
 	const MAX_ATTEMPTS = 2;
 	while (attempts < MAX_ATTEMPTS) try {
 		const args = await builder.argv;
-		trackEvent("cli_command_success", {
-			...getAnalyticsEventProperties(args),
-			projectId: args.projectId,
-			branchId: args.branchId,
-			accountId: args.accountId,
-			authMethod: args.authMethod,
-			authData: args.authData
-		});
+		trackEvent("cli_command_success", commandSuccessProperties(args));
 		if (args._.length === 0 || args.help) {
 			await showHelp(builder);
 			process.exit(0);
@@ -202,6 +195,7 @@ async function handleError(msg, err, canRetry) {
 		await closeAnalytics();
 		break;
 	} catch (err) {
+		takeCommandSuccessExtras();
 		attempts++;
 		if (!await handleError("", err, attempts < MAX_ATTEMPTS) || attempts >= MAX_ATTEMPTS) {
 			await closeAnalytics();

package/dist/utils/service_picker.js

@@ -12,6 +12,11 @@ const CHOICES = [
 		title: "Managed Better Auth",
 		description: "Authentication with users and sessions stored in Postgres."
 	},
+	{
+		value: "data-api",
+		title: "Data API",
+		description: "PostgREST-compatible HTTP API. Also declares Auth; the default provider needs it."
+	},
 	{
 		value: "functions",
 		title: "Functions",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "neon",
-  "version": "4.18.0",
+  "version": "4.19.0",
   "description": "CLI tool for Neon, the cloud backend primitives built around Lakebase Postgres",
   "keywords": [
     "neon",
@@ -63,9 +63,9 @@
     "yaml": "^2.9.0",
     "yargs": "17.7.2",
     "yoctocolors": "^2.1.2",
-    "@neon/config": "1.5.0",
-    "@neon/sdk": "5.0.0",
-    "@neon/config-runtime": "1.4.0"
+    "@neon/config-runtime": "1.4.1",
+    "@neon/sdk": "6.0.0",
+    "@neon/config": "1.5.1"
   },
   "optionalDependencies": {
     "@napi-rs/keyring": "1.3.0",
@@ -98,9 +98,9 @@
     "typescript": "^5.9.0",
     "vitest": "^3.0.9",
     "@neon-internals/cli-core": "0.0.0",
-    "@neon-internals/env-core": "0.0.16",
+    "@neon-internals/env-core": "0.0.17",
     "@neon/e2e-harness": "0.0.0",
-    "@neon/functions": "0.10.0"
+    "@neon/functions": "0.11.0"
   },
   "publishConfig": {
     "access": "public",