@neondatabase/config-runtime 0.0.0 → 0.1.0

package/e2e/conflict.e2e.test.ts

@@ -1,34 +0,0 @@
-import { describe, expect } from "vitest";
-import { defineConfig, pushConfig } from "../src/v1.js";
-import {
-	bootstrapProject,
-	DEFAULT_REGION,
-	detectApiKeyScope,
-	e2eTest,
-	makeRealApi,
-	uniqueProjectName,
-} from "./helpers.js";
-
-describe("e2e — branch-scoped push conflicts", () => {
-	e2eTest(
-		"reports branch drift without updateExisting",
-		async ({ track }) => {
-			const scope = await detectApiKeyScope();
-			if (scope.kind !== "org-or-user") return;
-			const api = makeRealApi();
-			const projectId = await bootstrapProject(api, {
-				name: uniqueProjectName("conflict"),
-				region: DEFAULT_REGION,
-			});
-			track(projectId);
-			const branchId = (await api.listBranches(projectId)).find(
-				(b) => b.isDefault,
-			)?.id;
-			if (!branchId) throw new Error("missing default branch");
-			const config = defineConfig(() => ({ protected: true }));
-			await expect(
-				pushConfig(config, { api, projectId, branchId }),
-			).rejects.toMatchObject({ code: "PLATFORM_PUSH_CONFLICT" });
-		},
-	);
-});

package/e2e/helpers.ts

@@ -1,204 +0,0 @@
-import { randomUUID } from "node:crypto";
-import { createApiClient } from "@neondatabase/api-client";
-import { createRealNeonApi, type NeonApi } from "@neondatabase/config";
-import { test } from "vitest";
-
-/**
- * Every e2e-created project is named `neon-ts-e2e-<uuid>`. Tests can register
- * `track(id)` to opt into the per-test cleanup hook. The suite-level
- * {@link sweepOrphans} additionally deletes leftovers from a previous failed run.
- */
-const PROJECT_PREFIX = "neon-ts-e2e-";
-
-/**
- * Default Neon region used by every e2e test that creates a project. Override per-test
- * by passing `region` to `defineConfig`.
- */
-export const DEFAULT_REGION = "aws-us-east-2";
-
-/** Generate a project name guaranteed not to collide with anything else in the org. */
-export function uniqueProjectName(suffix?: string): string {
-	const id = randomUUID().slice(0, 8);
-	return suffix
-		? `${PROJECT_PREFIX}${id}-${suffix}`
-		: `${PROJECT_PREFIX}${id}`;
-}
-
-function requireApiKey(): string {
-	const key = process.env.NEON_API_KEY;
-	if (!key || key.trim() === "") {
-		throw new Error(
-			"NEON_API_KEY is not set. Create packages/config/.env (see .env.example) before running test:e2e.",
-		);
-	}
-	return key;
-}
-
-/** The same real NeonApi adapter the SDK uses internally — exercised end-to-end. */
-export function makeRealApi(): NeonApi {
-	return createRealNeonApi({ apiKey: requireApiKey() });
-}
-
-/**
- * Create a real Neon project via the NeonApi adapter directly. `pushConfig` no longer
- * provisions projects (callers are expected to run `neonctl link` first), so every e2e
- * test that needs a fresh project to push against goes through this helper instead.
- */
-export async function bootstrapProject(
-	api: NeonApi,
-	args: { name: string; region: string },
-): Promise<string> {
-	const created = await api.createProject({
-		name: args.name,
-		regionId: args.region,
-	});
-	return created.id;
-}
-
-/** Lower-level Neon client. Used by cleanup and a few setup helpers. */
-function makeRawClient(): ReturnType<typeof createApiClient> {
-	return createApiClient({ apiKey: requireApiKey() });
-}
-
-/**
- * Discriminates the key currently configured. Project-scoped keys can't list projects;
- * org/user-scoped keys can.
- */
-export type ApiKeyScope =
-	| { kind: "org-or-user"; canCreate: true }
-	| { kind: "project"; projectId: string; canCreate: false };
-
-/**
- * Probe the configured API key to find out what it can do. Memoised because we only need
- * to do this once per process.
- */
-let cachedScope: ApiKeyScope | undefined;
-export async function detectApiKeyScope(): Promise<ApiKeyScope> {
-	if (cachedScope) return cachedScope;
-	const client = makeRawClient();
-	try {
-		await client.listProjects({ limit: 1 });
-		cachedScope = { kind: "org-or-user", canCreate: true };
-		return cachedScope;
-	} catch (err) {
-		const status = (err as { response?: { status?: number } } | undefined)
-			?.response?.status;
-		if (status !== 401 && status !== 403) throw err;
-	}
-	const fixedProjectId = process.env.NEON_PROJECT_ID;
-	if (!fixedProjectId || fixedProjectId.trim() === "") {
-		throw new Error(
-			"API key cannot list projects (looks project-scoped) and NEON_PROJECT_ID is not set. " +
-				"Set NEON_PROJECT_ID in packages/config/.env to target a fixed project for the bounded e2e subset.",
-		);
-	}
-	cachedScope = {
-		kind: "project",
-		projectId: fixedProjectId,
-		canCreate: false,
-	};
-	return cachedScope;
-}
-
-/**
- * Delete a project, ignoring "already gone" errors so cleanup is idempotent. Refuses to
- * delete anything that isn't prefixed with {@link PROJECT_PREFIX} so a mis-typed id can
- * never wipe an unrelated project.
- */
-async function deleteProject(projectId: string): Promise<void> {
-	const client = makeRawClient();
-	const project = await client.getProject(projectId).catch((err: unknown) => {
-		const status = (err as { response?: { status?: number } } | undefined)
-			?.response?.status;
-		if (status === 404 || status === 410) return null;
-		throw err;
-	});
-	if (!project) return;
-	if (!project.data.project.name.startsWith(PROJECT_PREFIX)) {
-		throw new Error(
-			`Refusing to delete project ${projectId} ("${project.data.project.name}"): does not match the e2e prefix.`,
-		);
-	}
-	// Retry on 423 (locked while a previous mutation is in flight) so cleanup is robust.
-	const maxAttempts = 12;
-	let delay = 500;
-	for (let attempt = 1; attempt <= maxAttempts; attempt++) {
-		try {
-			await client.deleteProject(projectId);
-			return;
-		} catch (err) {
-			const status = (
-				err as { response?: { status?: number } } | undefined
-			)?.response?.status;
-			if (status === 404 || status === 410) return;
-			if (status !== 423 || attempt === maxAttempts) throw err;
-			await sleep(delay);
-			delay = Math.min(delay * 2, 5_000);
-		}
-	}
-}
-
-/**
- * List every project whose name starts with {@link PROJECT_PREFIX} and delete them.
- * Called once at suite start to mop up orphans from a previous failed run.
- */
-export async function sweepOrphans(): Promise<{ swept: string[] }> {
-	const scope = await detectApiKeyScope();
-	if (scope.kind === "project") return { swept: [] };
-	const client = makeRawClient();
-	const swept: string[] = [];
-	let cursor: string | undefined;
-	while (true) {
-		const res = await client.listProjects({
-			limit: 100,
-			...(cursor ? { cursor } : {}),
-		});
-		for (const project of res.data.projects) {
-			if (project.name.startsWith(PROJECT_PREFIX)) {
-				await deleteProject(project.id);
-				swept.push(project.id);
-			}
-		}
-		const next = (res.data as { pagination?: { next?: string } }).pagination
-			?.next;
-		if (!next || next === cursor) break;
-		cursor = next;
-	}
-	return { swept };
-}
-
-/**
- * A vitest `test.extend` fixture that tracks every project id a test creates and deletes
- * each one in the cleanup phase, even if the test failed mid-way. Use `track(id)` to
- * register ids — cleanup runs regardless of outcome.
- */
-export const e2eTest = test.extend<{
-	track: (projectId: string) => void;
-}>({
-	// biome-ignore lint/correctness/noEmptyPattern: vitest's fixture API requires this exact shape.
-	track: async ({}, use) => {
-		const created: string[] = [];
-		await use((projectId: string) => {
-			created.push(projectId);
-		});
-		for (const projectId of created) {
-			try {
-				await deleteProject(projectId);
-			} catch (err) {
-				// Surface, but don't fail on cleanup errors — the orphan sweep on the next
-				// run will mop up anything we miss.
-				console.error(
-					`[e2e cleanup] failed to delete ${projectId}: ${(err as Error).message}`,
-				);
-			}
-		}
-	},
-});
-
-/**
- * Some Neon operations are eventually consistent (notably branch creation finishing
- * `init` → `ready`). A small wait avoids racing on subsequent reads.
- */
-function sleep(ms: number): Promise<void> {
-	return new Promise((resolve) => setTimeout(resolve, ms));
-}

package/e2e/lifecycle.e2e.test.ts

@@ -1,50 +0,0 @@
-import { describe, expect } from "vitest";
-import { defineConfig, pushConfig } from "../src/v1.js";
-import {
-	bootstrapProject,
-	DEFAULT_REGION,
-	detectApiKeyScope,
-	e2eTest,
-	makeRealApi,
-	uniqueProjectName,
-} from "./helpers.js";
-
-describe("e2e — branch policy lifecycle", () => {
-	e2eTest(
-		"creates a dev branch and pushes main policy",
-		async ({ track }) => {
-			const scope = await detectApiKeyScope();
-			if (scope.kind !== "org-or-user") return;
-			const api = makeRealApi();
-			const projectId = await bootstrapProject(api, {
-				name: uniqueProjectName("life"),
-				region: DEFAULT_REGION,
-			});
-			track(projectId);
-			const main = (await api.listBranches(projectId)).find(
-				(b) => b.isDefault,
-			);
-			if (!main) throw new Error("missing default branch");
-			const config = defineConfig((b) =>
-				b.name === main.name
-					? { protected: true }
-					: { parent: main.name, ttl: "1h" },
-			);
-			const created = await api.createBranch(projectId, {
-				name: "dev",
-				parentId: main.id,
-			});
-			expect(created.branch.name).toBe("dev");
-			await pushConfig(config, {
-				api,
-				projectId,
-				branchId: main.id,
-				updateExisting: true,
-			});
-			const reread = (await api.listBranches(projectId)).find(
-				(b) => b.id === main.id,
-			);
-			expect(reread?.protected).toBe(true);
-		},
-	);
-});

package/e2e/load-env.ts

@@ -1,29 +0,0 @@
-// Loaded by vitest.e2e.config.ts `setupFiles`; not imported statically.
-// fallow-ignore-file unused-file
-import { existsSync, readFileSync } from "node:fs";
-import { dirname, resolve } from "node:path";
-import { fileURLToPath } from "node:url";
-
-/**
- * Vitest setup file — loads `packages/config/.env` into `process.env` so e2e tests can
- * read `NEON_API_KEY` (and friends). Node 22 has `--env-file` but it's per-process; doing
- * it here keeps the test command short (`pnpm test:e2e`).
- *
- * Lines starting with `#` are treated as comments; everything else is parsed as
- * `KEY=value` (no quoting / interpolation — we keep this minimal on purpose).
- */
-const here = dirname(fileURLToPath(import.meta.url));
-const envPath = resolve(here, "..", ".env");
-
-if (existsSync(envPath)) {
-	const raw = readFileSync(envPath, "utf-8");
-	for (const rawLine of raw.split("\n")) {
-		const line = rawLine.trim();
-		if (line === "" || line.startsWith("#")) continue;
-		const eq = line.indexOf("=");
-		if (eq <= 0) continue;
-		const key = line.slice(0, eq).trim();
-		const value = line.slice(eq + 1).trim();
-		if (process.env[key] === undefined) process.env[key] = value;
-	}
-}

package/e2e/setup.ts

@@ -1,24 +0,0 @@
-// Loaded by vitest.e2e.config.ts `setupFiles`; not imported statically.
-// fallow-ignore-file unused-file
-import { beforeAll } from "vitest";
-import { detectApiKeyScope, sweepOrphans } from "./helpers.js";
-
-/**
- * Suite-level setup. Runs once before any e2e test:
- * 1. Probes the configured API key to detect its scope. We do this here so a misconfigured
- *    environment fails fast with a clear message rather than surfacing as cryptic 403s
- *    inside individual tests.
- * 2. When the key is org/user-scoped, sweep any orphaned `neon-ts-e2e-*` projects
- *    left over from a previous run.
- */
-beforeAll(async () => {
-	const scope = await detectApiKeyScope();
-	if (scope.kind === "org-or-user") {
-		const { swept } = await sweepOrphans();
-		if (swept.length > 0) {
-			console.warn(
-				`[e2e setup] swept ${swept.length} orphaned project(s) from a previous run.`,
-			);
-		}
-	}
-});

package/src/index.ts

@@ -1,5 +0,0 @@
-/**
- * The default entry point re-exports the latest stable version. New consumers should import
- * directly from `@neondatabase/config-runtime/v1` to opt in to a specific major.
- */
-export * from "./v1.js";