@neon/sdk 0.0.0 → 0.2.0

package/dist/neon/connection.js

@@ -0,0 +1,33 @@
+import { NeonError } from "./errors.js";
+import { err, ok } from "./result.js";
+//#region src/neon/connection.ts
+/**
+* Pick a connection string from a create response's `connection_uris`.
+*
+* Neon returns the **direct** URI; the pooled URI is the same string with the host
+* swapped for the `-pooler` host (`connection_parameters.pooler_host`), so we derive it
+* without an extra request. Returns `undefined` when the response carries no connection
+* URI (e.g. a branch created from a parent with multiple roles/databases).
+*/
+function pickConnectionString(uris, pooled) {
+	const details = uris?.[0];
+	if (!details) return void 0;
+	if (!pooled) return details.connection_uri;
+	const { host, pooler_host } = details.connection_parameters;
+	if (!host || !pooler_host) return details.connection_uri;
+	return details.connection_uri.replace(host, pooler_host);
+}
+/**
+* Attach a derived connection string to a create result, returning a `client`-kind
+* {@link NeonError} when the response carries no connection URI.
+*/
+function withConnectionString(result, uris, build, pooled) {
+	if (result.error) return err(result.error);
+	const connectionString = pickConnectionString(uris(result.data), pooled);
+	if (!connectionString) return err(new NeonError("The response did not include a connection URI (the branch or project may have multiple roles or databases). Use `raw.getConnectionUri` with an explicit role and database.", "client"));
+	return ok(build(result.data, connectionString));
+}
+//#endregion
+export { pickConnectionString, withConnectionString };
+
+//# sourceMappingURL=connection.js.map

package/dist/neon/connection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.js","names":[],"sources":["../../src/neon/connection.ts"],"sourcesContent":["import type { ConnectionDetails } from \"../client/types.gen.js\";\nimport { NeonError } from \"./errors.js\";\nimport { err, type NeonResult, ok } from \"./result.js\";\n\n/**\n * Pick a connection string from a create response's `connection_uris`.\n *\n * Neon returns the **direct** URI; the pooled URI is the same string with the host\n * swapped for the `-pooler` host (`connection_parameters.pooler_host`), so we derive it\n * without an extra request. Returns `undefined` when the response carries no connection\n * URI (e.g. a branch created from a parent with multiple roles/databases).\n */\nexport function pickConnectionString(\n\turis: ConnectionDetails[] | undefined,\n\tpooled: boolean,\n): string | undefined {\n\tconst details = uris?.[0];\n\tif (!details) return undefined;\n\tif (!pooled) return details.connection_uri;\n\tconst { host, pooler_host } = details.connection_parameters;\n\tif (!host || !pooler_host) return details.connection_uri;\n\treturn details.connection_uri.replace(host, pooler_host);\n}\n\n/**\n * Attach a derived connection string to a create result, returning a `client`-kind\n * {@link NeonError} when the response carries no connection URI.\n */\nexport function withConnectionString<D, T>(\n\tresult: NeonResult<D>,\n\turis: (data: D) => ConnectionDetails[] | undefined,\n\tbuild: (data: D, connectionString: string) => T,\n\tpooled: boolean,\n): NeonResult<T> {\n\tif (result.error) return err(result.error);\n\tconst connectionString = pickConnectionString(uris(result.data), pooled);\n\tif (!connectionString) {\n\t\treturn err(\n\t\t\tnew NeonError(\n\t\t\t\t\"The response did not include a connection URI (the branch or project may have multiple roles or databases). Use `raw.getConnectionUri` with an explicit role and database.\",\n\t\t\t\t\"client\",\n\t\t\t),\n\t\t);\n\t}\n\treturn ok(build(result.data, connectionString));\n}\n"],"mappings":";;;;;;;;;;;AAYA,SAAgB,qBACf,MACA,QACqB;CACrB,MAAM,UAAU,OAAO;CACvB,IAAI,CAAC,SAAS,OAAO,KAAA;CACrB,IAAI,CAAC,QAAQ,OAAO,QAAQ;CAC5B,MAAM,EAAE,MAAM,gBAAgB,QAAQ;CACtC,IAAI,CAAC,QAAQ,CAAC,aAAa,OAAO,QAAQ;CAC1C,OAAO,QAAQ,eAAe,QAAQ,MAAM,WAAW;AACxD;;;;;AAMA,SAAgB,qBACf,QACA,MACA,OACA,QACgB;CAChB,IAAI,OAAO,OAAO,OAAO,IAAI,OAAO,KAAK;CACzC,MAAM,mBAAmB,qBAAqB,KAAK,OAAO,IAAI,GAAG,MAAM;CACvE,IAAI,CAAC,kBACJ,OAAO,IACN,IAAI,UACH,8KACA,QACD,CACD;CAED,OAAO,GAAG,MAAM,OAAO,MAAM,gBAAgB,CAAC;AAC/C"}

package/dist/neon/context.d.ts

@@ -0,0 +1,50 @@
+import { Client } from "../client/client/types.gen.js";
+import { NeonResult } from "./result.js";
+import { WaitForOptions } from "./wait.js";
+
+//#region src/neon/context.d.ts
+/** Fully-resolved runtime configuration shared by every resource namespace. */
+interface ResolvedConfig {
+  client: Client;
+  throwOnError: boolean;
+  retries: number;
+  waitForReadiness: boolean;
+  waitOptions: WaitForOptions;
+  orgId?: string;
+}
+/** Per-call overrides accepted by every ergonomic method. */
+interface CallOptions<Throw extends boolean = boolean> {
+  /** Override the client's `throwOnError` for this call. */
+  throwOnError?: Throw;
+  /** Override the client's `waitForReadiness` for this call (mutations only). */
+  waitForReadiness?: boolean;
+  signal?: AbortSignal;
+}
+interface RawResult<D> {
+  data?: D | undefined;
+  error?: unknown;
+  response?: Response | undefined;
+}
+/**
+ * Shared execution core: runs a raw client call with retries, maps its envelope to the
+ * ergonomic resource shape, optionally waits for provisioning operations, and applies the
+ * resolved `throwOnError` policy. Returns the bare value (throwing) or a {@link NeonResult}.
+ */
+declare class RequestContext {
+  #private;
+  constructor(config: ResolvedConfig);
+  get client(): Client;
+  get defaults(): ResolvedConfig;
+  /** Run a raw call and map its body; applies the resolved `throwOnError` policy. */
+  run<D, T>(opts: CallOptions | undefined, exec: (client: Client) => Promise<RawResult<D>>, map: (data: D) => T): Promise<T | NeonResult<T>>;
+  /** Like {@link run} but for endpoints that may return an empty (204) body. */
+  runVoid<D>(opts: CallOptions | undefined, exec: (client: Client) => Promise<RawResult<D>>): Promise<void | NeonResult<void>>;
+  /**
+   * Run a raw call and map its body, returning the {@link NeonResult} envelope (no
+   * throw). Used by `run` and by workflows that post-process the result.
+   */
+  execute<D, T>(opts: CallOptions | undefined, exec: (client: Client) => Promise<RawResult<D>>, map: (data: D) => T): Promise<NeonResult<T>>;
+}
+//#endregion
+export { CallOptions, RequestContext, ResolvedConfig };
+//# sourceMappingURL=context.d.ts.map

package/dist/neon/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","names":[],"sources":["../../src/neon/context.ts"],"mappings":";;;;;;UAWiB,cAAA;EAAA,MAAA,EACR,MADQ;EAAc,YAAA,EAAA,OAAA;SACtB,EAAA,MAAA;kBAIK,EAAA,OAAA;EAAc,WAAA,EAAd,cAAc;EAKX,KAAA,CAAA,EAAA,MAAW;;;AAKlB,UALO,WAKP,CAAA,cAAA,OAAA,GAAA,OAAA,CAAA,CAAA;EAAW;EAGX,YAAS,CAAA,EANH,KAMG;EAAA;kBACX,CAAA,EAAA,OAAA;QAEI,CAAA,EANF,WAME;AAAQ;AAQpB,UAXU,SAWG,CAAA,CAAc,CAAA,CAAA;EAAA,IAAA,CAAA,EAVnB,CAUmB,GAAA,SAAA;OAGN,CAAA,EAAA,OAAA;UAIN,CAAA,EAfH,QAeG,GAAA,SAAA;;;;;;;AAYD,cAnBD,cAAA,CAmBC;UAAM;aACR,CAAA,MAAA,EAjBS,cAiBT;MAAe,MAAA,CAAA,CAAA,EAbZ,MAaY;MAAX,QAAA,CAAA,CAAA,EATC,cASD;;KAOR,CAAA,CAAA,EAAA,CAAA,CAAA,CAAA,IAAA,EAVA,WAUA,GAAA,SAAA,EAAA,IAAA,EAAA,CAAA,MAAA,EATS,MAST,EAAA,GAToB,OASpB,CAT4B,SAS5B,CATsC,CAStC,CAAA,CAAA,EAAA,GAAA,EAAA,CAAA,IAAA,EARM,CAQN,EAAA,GARY,CAQZ,CAAA,EAPJ,OAOI,CAPI,CAOJ,GAPQ,UAOR,CAPmB,CAOnB,CAAA,CAAA;;SACsC,CAAA,CAAA,CAAA,CAAA,IAAA,EADtC,WACsC,GAAA,SAAA,EAAA,IAAA,EAAA,CAAA,MAAA,EAA7B,MAA6B,EAAA,GAAlB,OAAkB,CAAV,SAAU,CAAA,CAAA,CAAA,CAAA,CAAA,EAC1C,OAD0C,CAAA,IAAA,GAC3B,UAD2B,CAAA,IAAA,CAAA,CAAA;;;;;SAyBtC,CAAA,CAAA,EAAA,CAAA,CAAA,CAAA,IAAA,EAAA,WAAA,GAAA,SAAA,EAAA,IAAA,EAAA,CAAA,MAAA,EACS,MADT,EAAA,GACoB,OADpB,CAC4B,SAD5B,CACsC,CADtC,CAAA,CAAA,EAAA,GAAA,EAAA,CAAA,IAAA,EAEM,CAFN,EAAA,GAEY,CAFZ,CAAA,EAGJ,OAHI,CAGI,UAHJ,CAGe,CAHf,CAAA,CAAA"}

package/dist/neon/context.js

@@ -0,0 +1,59 @@
+import { toNeonError } from "./errors.js";
+import { err, finalize, ok } from "./result.js";
+import { withRetries } from "./retry.js";
+import { hasOperations, waitForOperations } from "./wait.js";
+//#region src/neon/context.ts
+/**
+* Shared execution core: runs a raw client call with retries, maps its envelope to the
+* ergonomic resource shape, optionally waits for provisioning operations, and applies the
+* resolved `throwOnError` policy. Returns the bare value (throwing) or a {@link NeonResult}.
+*/
+var RequestContext = class {
+	#config;
+	constructor(config) {
+		this.#config = config;
+	}
+	get client() {
+		return this.#config.client;
+	}
+	get defaults() {
+		return this.#config;
+	}
+	/** Run a raw call and map its body; applies the resolved `throwOnError` policy. */
+	async run(opts, exec, map) {
+		const shouldThrow = opts?.throwOnError ?? this.#config.throwOnError;
+		return finalize(await this.execute(opts, exec, map), shouldThrow);
+	}
+	/** Like {@link run} but for endpoints that may return an empty (204) body. */
+	async runVoid(opts, exec) {
+		const shouldThrow = opts?.throwOnError ?? this.#config.throwOnError;
+		const raw = await withRetries(() => exec(this.#config.client), this.#config.retries, opts?.signal);
+		if (raw.error !== void 0) return finalize(err(toNeonError(raw.error, raw.response)), shouldThrow);
+		const readiness = await this.#maybeWait(opts, raw.data);
+		if (readiness?.error) return finalize(err(readiness.error), shouldThrow);
+		return finalize(ok(void 0), shouldThrow);
+	}
+	/**
+	* Run a raw call and map its body, returning the {@link NeonResult} envelope (no
+	* throw). Used by `run` and by workflows that post-process the result.
+	*/
+	async execute(opts, exec, map) {
+		const raw = await withRetries(() => exec(this.#config.client), this.#config.retries, opts?.signal);
+		if (raw.error || raw.data === void 0) return err(toNeonError(raw.error, raw.response));
+		const readiness = await this.#maybeWait(opts, raw.data);
+		if (readiness?.error) return err(readiness.error);
+		return ok(map(raw.data));
+	}
+	/** Poll provisioning operations when `waitForReadiness` is on and the body has any. */
+	async #maybeWait(opts, data) {
+		if (!(opts?.waitForReadiness ?? this.#config.waitForReadiness) || !hasOperations(data)) return void 0;
+		return waitForOperations(this.#config.client, data.operations, {
+			...this.#config.waitOptions,
+			signal: opts?.signal ?? this.#config.waitOptions.signal
+		});
+	}
+};
+//#endregion
+export { RequestContext };
+
+//# sourceMappingURL=context.js.map

package/dist/neon/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","names":["#config","#maybeWait"],"sources":["../../src/neon/context.ts"],"sourcesContent":["import type { Client } from \"../client/client/index.js\";\nimport { toNeonError } from \"./errors.js\";\nimport { err, finalize, type NeonResult, ok } from \"./result.js\";\nimport { withRetries } from \"./retry.js\";\nimport {\n\thasOperations,\n\ttype WaitForOptions,\n\twaitForOperations,\n} from \"./wait.js\";\n\n/** Fully-resolved runtime configuration shared by every resource namespace. */\nexport interface ResolvedConfig {\n\tclient: Client;\n\tthrowOnError: boolean;\n\tretries: number;\n\twaitForReadiness: boolean;\n\twaitOptions: WaitForOptions;\n\torgId?: string;\n}\n\n/** Per-call overrides accepted by every ergonomic method. */\nexport interface CallOptions<Throw extends boolean = boolean> {\n\t/** Override the client's `throwOnError` for this call. */\n\tthrowOnError?: Throw;\n\t/** Override the client's `waitForReadiness` for this call (mutations only). */\n\twaitForReadiness?: boolean;\n\tsignal?: AbortSignal;\n}\n\ninterface RawResult<D> {\n\tdata?: D | undefined;\n\terror?: unknown;\n\tresponse?: Response | undefined;\n}\n\n/**\n * Shared execution core: runs a raw client call with retries, maps its envelope to the\n * ergonomic resource shape, optionally waits for provisioning operations, and applies the\n * resolved `throwOnError` policy. Returns the bare value (throwing) or a {@link NeonResult}.\n */\nexport class RequestContext {\n\treadonly #config: ResolvedConfig;\n\n\tconstructor(config: ResolvedConfig) {\n\t\tthis.#config = config;\n\t}\n\n\tget client(): Client {\n\t\treturn this.#config.client;\n\t}\n\n\tget defaults(): ResolvedConfig {\n\t\treturn this.#config;\n\t}\n\n\t/** Run a raw call and map its body; applies the resolved `throwOnError` policy. */\n\tasync run<D, T>(\n\t\topts: CallOptions | undefined,\n\t\texec: (client: Client) => Promise<RawResult<D>>,\n\t\tmap: (data: D) => T,\n\t): Promise<T | NeonResult<T>> {\n\t\tconst shouldThrow = opts?.throwOnError ?? this.#config.throwOnError;\n\t\treturn finalize(await this.execute(opts, exec, map), shouldThrow);\n\t}\n\n\t/** Like {@link run} but for endpoints that may return an empty (204) body. */\n\tasync runVoid<D>(\n\t\topts: CallOptions | undefined,\n\t\texec: (client: Client) => Promise<RawResult<D>>,\n\t): Promise<void | NeonResult<void>> {\n\t\tconst shouldThrow = opts?.throwOnError ?? this.#config.throwOnError;\n\t\tconst raw = await withRetries(\n\t\t\t() => exec(this.#config.client),\n\t\t\tthis.#config.retries,\n\t\t\topts?.signal,\n\t\t);\n\t\tif (raw.error !== undefined) {\n\t\t\treturn finalize(\n\t\t\t\terr<void>(toNeonError(raw.error, raw.response)),\n\t\t\t\tshouldThrow,\n\t\t\t);\n\t\t}\n\t\tconst readiness = await this.#maybeWait(opts, raw.data);\n\t\tif (readiness?.error)\n\t\t\treturn finalize(err<void>(readiness.error), shouldThrow);\n\t\treturn finalize(ok(undefined), shouldThrow);\n\t}\n\n\t/**\n\t * Run a raw call and map its body, returning the {@link NeonResult} envelope (no\n\t * throw). Used by `run` and by workflows that post-process the result.\n\t */\n\tasync execute<D, T>(\n\t\topts: CallOptions | undefined,\n\t\texec: (client: Client) => Promise<RawResult<D>>,\n\t\tmap: (data: D) => T,\n\t): Promise<NeonResult<T>> {\n\t\tconst raw = await withRetries(\n\t\t\t() => exec(this.#config.client),\n\t\t\tthis.#config.retries,\n\t\t\topts?.signal,\n\t\t);\n\t\tif (raw.error || raw.data === undefined) {\n\t\t\treturn err(toNeonError(raw.error, raw.response));\n\t\t}\n\t\tconst readiness = await this.#maybeWait(opts, raw.data);\n\t\tif (readiness?.error) return err(readiness.error);\n\t\treturn ok(map(raw.data));\n\t}\n\n\t/** Poll provisioning operations when `waitForReadiness` is on and the body has any. */\n\tasync #maybeWait(\n\t\topts: CallOptions | undefined,\n\t\tdata: unknown,\n\t): Promise<NeonResult<void> | undefined> {\n\t\tconst wait = opts?.waitForReadiness ?? this.#config.waitForReadiness;\n\t\tif (!wait || !hasOperations(data)) return undefined;\n\t\treturn waitForOperations(this.#config.client, data.operations, {\n\t\t\t...this.#config.waitOptions,\n\t\t\tsignal: opts?.signal ?? this.#config.waitOptions.signal,\n\t\t});\n\t}\n}\n"],"mappings":";;;;;;;;;;AAwCA,IAAa,iBAAb,MAA4B;CAC3B;CAEA,YAAY,QAAwB;EACnC,KAAKA,UAAU;CAChB;CAEA,IAAI,SAAiB;EACpB,OAAO,KAAKA,QAAQ;CACrB;CAEA,IAAI,WAA2B;EAC9B,OAAO,KAAKA;CACb;;CAGA,MAAM,IACL,MACA,MACA,KAC6B;EAC7B,MAAM,cAAc,MAAM,gBAAgB,KAAKA,QAAQ;EACvD,OAAO,SAAS,MAAM,KAAK,QAAQ,MAAM,MAAM,GAAG,GAAG,WAAW;CACjE;;CAGA,MAAM,QACL,MACA,MACmC;EACnC,MAAM,cAAc,MAAM,gBAAgB,KAAKA,QAAQ;EACvD,MAAM,MAAM,MAAM,kBACX,KAAK,KAAKA,QAAQ,MAAM,GAC9B,KAAKA,QAAQ,SACb,MAAM,MACP;EACA,IAAI,IAAI,UAAU,KAAA,GACjB,OAAO,SACN,IAAU,YAAY,IAAI,OAAO,IAAI,QAAQ,CAAC,GAC9C,WACD;EAED,MAAM,YAAY,MAAM,KAAKC,WAAW,MAAM,IAAI,IAAI;EACtD,IAAI,WAAW,OACd,OAAO,SAAS,IAAU,UAAU,KAAK,GAAG,WAAW;EACxD,OAAO,SAAS,GAAG,KAAA,CAAS,GAAG,WAAW;CAC3C;;;;;CAMA,MAAM,QACL,MACA,MACA,KACyB;EACzB,MAAM,MAAM,MAAM,kBACX,KAAK,KAAKD,QAAQ,MAAM,GAC9B,KAAKA,QAAQ,SACb,MAAM,MACP;EACA,IAAI,IAAI,SAAS,IAAI,SAAS,KAAA,GAC7B,OAAO,IAAI,YAAY,IAAI,OAAO,IAAI,QAAQ,CAAC;EAEhD,MAAM,YAAY,MAAM,KAAKC,WAAW,MAAM,IAAI,IAAI;EACtD,IAAI,WAAW,OAAO,OAAO,IAAI,UAAU,KAAK;EAChD,OAAO,GAAG,IAAI,IAAI,IAAI,CAAC;CACxB;;CAGA,MAAMA,WACL,MACA,MACwC;EAExC,IAAI,EADS,MAAM,oBAAoB,KAAKD,QAAQ,qBACvC,CAAC,cAAc,IAAI,GAAG,OAAO,KAAA;EAC1C,OAAO,kBAAkB,KAAKA,QAAQ,QAAQ,KAAK,YAAY;GAC9D,GAAG,KAAKA,QAAQ;GAChB,QAAQ,MAAM,UAAU,KAAKA,QAAQ,YAAY;EAClD,CAAC;CACF;AACD"}

package/dist/neon/coverage.d.ts

@@ -0,0 +1,26 @@
+//#region src/neon/coverage.d.ts
+/**
+ * Drift guard for the ergonomic layer.
+ *
+ * The raw layer is regenerated from the OpenAPI spec, so it auto-tracks new endpoints.
+ * The ergonomic resource namespaces are hand-authored, so they can silently fall behind.
+ * `coverage.test.ts` compares the generated operation set against {@link EXPECTED_OPERATIONS}
+ * and fails CI when they differ — forcing a conscious decision on every spec change:
+ * either wrap the new operation in a resource (and add it to {@link WRAPPED}) or accept
+ * that it stays raw-only (and add it to the snapshot below).
+ *
+ * Workflow when the test fails after a `pnpm generate`:
+ *   1. Review the `added` / `removed` operations the test reports.
+ *   2. Wrap the ones worth ergonomic treatment (and list them in {@link WRAPPED}).
+ *   3. Update {@link EXPECTED_OPERATIONS} to match the new generated set.
+ */
+/** Operations surfaced by the ergonomic `createNeonClient` namespaces. */
+declare const WRAPPED: ReadonlySet<string>;
+/**
+ * Committed snapshot of every operation the generated client exposes. Update this
+ * deliberately whenever the spec (and thus the generated client) changes.
+ */
+declare const EXPECTED_OPERATIONS: ReadonlySet<string>;
+//#endregion
+export { EXPECTED_OPERATIONS, WRAPPED };
+//# sourceMappingURL=coverage.d.ts.map

package/dist/neon/coverage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coverage.d.ts","names":[],"sources":["../../src/neon/coverage.ts"],"mappings":";;AAiBA;AA0EA;;;;;;;;;;;;;;cA1Ea,SAAS;;;;;cA0ET,qBAAqB"}

package/dist/neon/coverage.js

@@ -0,0 +1,229 @@
+//#region src/neon/coverage.ts
+/**
+* Drift guard for the ergonomic layer.
+*
+* The raw layer is regenerated from the OpenAPI spec, so it auto-tracks new endpoints.
+* The ergonomic resource namespaces are hand-authored, so they can silently fall behind.
+* `coverage.test.ts` compares the generated operation set against {@link EXPECTED_OPERATIONS}
+* and fails CI when they differ — forcing a conscious decision on every spec change:
+* either wrap the new operation in a resource (and add it to {@link WRAPPED}) or accept
+* that it stays raw-only (and add it to the snapshot below).
+*
+* Workflow when the test fails after a `pnpm generate`:
+*   1. Review the `added` / `removed` operations the test reports.
+*   2. Wrap the ones worth ergonomic treatment (and list them in {@link WRAPPED}).
+*   3. Update {@link EXPECTED_OPERATIONS} to match the new generated set.
+*/
+/** Operations surfaced by the ergonomic `createNeonClient` namespaces. */
+const WRAPPED = /* @__PURE__ */ new Set([
+	"listProjects",
+	"getProject",
+	"createProject",
+	"updateProject",
+	"deleteProject",
+	"transferProjectsFromOrgToOrg",
+	"transferProjectsFromUserToOrg",
+	"listProjectBranches",
+	"getProjectBranch",
+	"createProjectBranch",
+	"updateProjectBranch",
+	"deleteProjectBranch",
+	"setDefaultProjectBranch",
+	"finalizeRestoreBranch",
+	"getProjectOperation",
+	"listProjectOperations",
+	"listProjectEndpoints",
+	"getProjectEndpoint",
+	"createProjectEndpoint",
+	"updateProjectEndpoint",
+	"deleteProjectEndpoint",
+	"startProjectEndpoint",
+	"suspendProjectEndpoint",
+	"restartProjectEndpoint",
+	"listProjectBranchDatabases",
+	"getProjectBranchDatabase",
+	"createProjectBranchDatabase",
+	"updateProjectBranchDatabase",
+	"deleteProjectBranchDatabase",
+	"listProjectBranchRoles",
+	"getProjectBranchRole",
+	"createProjectBranchRole",
+	"deleteProjectBranchRole",
+	"getProjectBranchRolePassword",
+	"resetProjectBranchRolePassword",
+	"getConnectionUri",
+	"getProjectBranchDataApi",
+	"createProjectBranchDataApi",
+	"updateProjectBranchDataApi",
+	"deleteProjectBranchDataApi",
+	"listSnapshots",
+	"createSnapshot",
+	"updateSnapshot",
+	"deleteSnapshot",
+	"restoreSnapshot",
+	"getSnapshotSchedule",
+	"setSnapshotSchedule",
+	"getConsumptionHistoryPerProject",
+	"getConsumptionHistoryPerProjectV2",
+	"getConsumptionHistoryPerBranchV2",
+	"getCurrentUserInfo",
+	"getCurrentUserOrganizations",
+	"getActiveRegions",
+	"listApiKeys",
+	"createApiKey",
+	"revokeApiKey"
+]);
+/**
+* Committed snapshot of every operation the generated client exposes. Update this
+* deliberately whenever the spec (and thus the generated client) changes.
+*/
+const EXPECTED_OPERATIONS = /* @__PURE__ */ new Set([
+	"acceptProjectTransferRequest",
+	"addBranchNeonAuthOauthProvider",
+	"addBranchNeonAuthTrustedDomain",
+	"addNeonAuthDomainToRedirectUriWhitelist",
+	"addNeonAuthOauthProvider",
+	"addProjectJwks",
+	"assignOrganizationVpcEndpoint",
+	"assignProjectVpcEndpoint",
+	"countProjectBranches",
+	"createApiKey",
+	"createBranchNeonAuthNewUser",
+	"createNeonAuth",
+	"createNeonAuthIntegration",
+	"createNeonAuthNewUser",
+	"createNeonAuthProviderSdkKeys",
+	"createOrgApiKey",
+	"createOrganizationInvitations",
+	"createProject",
+	"createProjectBranch",
+	"createProjectBranchAnonymized",
+	"createProjectBranchDataApi",
+	"createProjectBranchDatabase",
+	"createProjectBranchRole",
+	"createProjectEndpoint",
+	"createProjectTransferRequest",
+	"createSnapshot",
+	"deleteBranchNeonAuthOauthProvider",
+	"deleteBranchNeonAuthTrustedDomain",
+	"deleteBranchNeonAuthUser",
+	"deleteNeonAuthDomainFromRedirectUriWhitelist",
+	"deleteNeonAuthIntegration",
+	"deleteNeonAuthOauthProvider",
+	"deleteNeonAuthUser",
+	"deleteOrganizationSpendingLimit",
+	"deleteOrganizationVpcEndpoint",
+	"deleteProject",
+	"deleteProjectBranch",
+	"deleteProjectBranchDataApi",
+	"deleteProjectBranchDatabase",
+	"deleteProjectBranchRole",
+	"deleteProjectEndpoint",
+	"deleteProjectJwks",
+	"deleteProjectVpcEndpoint",
+	"deleteSnapshot",
+	"disableNeonAuth",
+	"finalizeRestoreBranch",
+	"getActiveRegions",
+	"getAnonymizedBranchStatus",
+	"getAuthDetails",
+	"getAvailablePreloadLibraries",
+	"getConnectionUri",
+	"getConsumptionHistoryPerBranchV2",
+	"getConsumptionHistoryPerProject",
+	"getConsumptionHistoryPerProjectV2",
+	"getCurrentUserInfo",
+	"getCurrentUserOrganizations",
+	"getMaskingRules",
+	"getNeonAuth",
+	"getNeonAuthAllowLocalhost",
+	"getNeonAuthEmailAndPasswordConfig",
+	"getNeonAuthEmailProvider",
+	"getNeonAuthEmailServer",
+	"getNeonAuthPhoneNumberPlugin",
+	"getNeonAuthPluginConfigs",
+	"getNeonAuthWebhookConfig",
+	"getOrganization",
+	"getOrganizationInvitations",
+	"getOrganizationMember",
+	"getOrganizationMembers",
+	"getOrganizationSpendingLimit",
+	"getOrganizationVpcEndpointDetails",
+	"getProject",
+	"getProjectAdvisorSecurityIssues",
+	"getProjectBranch",
+	"getProjectBranchDataApi",
+	"getProjectBranchDatabase",
+	"getProjectBranchRole",
+	"getProjectBranchRolePassword",
+	"getProjectBranchSchema",
+	"getProjectBranchSchemaComparison",
+	"getProjectEndpoint",
+	"getProjectJwks",
+	"getProjectOperation",
+	"getSnapshotSchedule",
+	"grantPermissionToProject",
+	"listApiKeys",
+	"listBranchNeonAuthOauthProviders",
+	"listBranchNeonAuthTrustedDomains",
+	"listNeonAuthIntegrations",
+	"listNeonAuthOauthProviders",
+	"listNeonAuthRedirectUriWhitelistDomains",
+	"listOrgApiKeys",
+	"listOrganizationVpcEndpoints",
+	"listOrganizationVpcEndpointsAllRegions",
+	"listProjectBranchDatabases",
+	"listProjectBranchEndpoints",
+	"listProjectBranchRoles",
+	"listProjectBranches",
+	"listProjectEndpoints",
+	"listProjectOperations",
+	"listProjectPermissions",
+	"listProjectVpcEndpoints",
+	"listProjects",
+	"listSharedProjects",
+	"listSnapshots",
+	"recoverProject",
+	"removeOrganizationMember",
+	"resetProjectBranchRolePassword",
+	"restartProjectEndpoint",
+	"restoreProjectBranch",
+	"restoreSnapshot",
+	"revokeApiKey",
+	"revokeOrgApiKey",
+	"revokePermissionFromProject",
+	"sendNeonAuthTestEmail",
+	"setDefaultProjectBranch",
+	"setOrganizationSpendingLimit",
+	"setSnapshotSchedule",
+	"startAnonymization",
+	"startProjectEndpoint",
+	"suspendProjectEndpoint",
+	"transferNeonAuthProviderProject",
+	"transferProjectsFromOrgToOrg",
+	"transferProjectsFromUserToOrg",
+	"updateBranchNeonAuthOauthProvider",
+	"updateMaskingRules",
+	"updateNeonAuthAllowLocalhost",
+	"updateNeonAuthConfig",
+	"updateNeonAuthEmailAndPasswordConfig",
+	"updateNeonAuthEmailProvider",
+	"updateNeonAuthEmailServer",
+	"updateNeonAuthMagicLinkPlugin",
+	"updateNeonAuthOauthProvider",
+	"updateNeonAuthOrganizationPlugin",
+	"updateNeonAuthPhoneNumberPlugin",
+	"updateNeonAuthUserRole",
+	"updateNeonAuthWebhookConfig",
+	"updateOrganizationMember",
+	"updateProject",
+	"updateProjectBranch",
+	"updateProjectBranchDataApi",
+	"updateProjectBranchDatabase",
+	"updateProjectEndpoint",
+	"updateSnapshot"
+]);
+//#endregion
+export { EXPECTED_OPERATIONS, WRAPPED };
+
+//# sourceMappingURL=coverage.js.map

package/dist/neon/coverage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coverage.js","names":[],"sources":["../../src/neon/coverage.ts"],"sourcesContent":["/**\n * Drift guard for the ergonomic layer.\n *\n * The raw layer is regenerated from the OpenAPI spec, so it auto-tracks new endpoints.\n * The ergonomic resource namespaces are hand-authored, so they can silently fall behind.\n * `coverage.test.ts` compares the generated operation set against {@link EXPECTED_OPERATIONS}\n * and fails CI when they differ — forcing a conscious decision on every spec change:\n * either wrap the new operation in a resource (and add it to {@link WRAPPED}) or accept\n * that it stays raw-only (and add it to the snapshot below).\n *\n * Workflow when the test fails after a `pnpm generate`:\n *   1. Review the `added` / `removed` operations the test reports.\n *   2. Wrap the ones worth ergonomic treatment (and list them in {@link WRAPPED}).\n *   3. Update {@link EXPECTED_OPERATIONS} to match the new generated set.\n */\n\n/** Operations surfaced by the ergonomic `createNeonClient` namespaces. */\nexport const WRAPPED: ReadonlySet<string> = new Set([\n\t// projects\n\t\"listProjects\",\n\t\"getProject\",\n\t\"createProject\",\n\t\"updateProject\",\n\t\"deleteProject\",\n\t// projects: transfer\n\t\"transferProjectsFromOrgToOrg\",\n\t\"transferProjectsFromUserToOrg\",\n\t// branches\n\t\"listProjectBranches\",\n\t\"getProjectBranch\",\n\t\"createProjectBranch\",\n\t\"updateProjectBranch\",\n\t\"deleteProjectBranch\",\n\t\"setDefaultProjectBranch\",\n\t\"finalizeRestoreBranch\",\n\t// operations\n\t\"getProjectOperation\",\n\t\"listProjectOperations\",\n\t// postgres: endpoints\n\t\"listProjectEndpoints\",\n\t\"getProjectEndpoint\",\n\t\"createProjectEndpoint\",\n\t\"updateProjectEndpoint\",\n\t\"deleteProjectEndpoint\",\n\t\"startProjectEndpoint\",\n\t\"suspendProjectEndpoint\",\n\t\"restartProjectEndpoint\",\n\t// postgres: databases\n\t\"listProjectBranchDatabases\",\n\t\"getProjectBranchDatabase\",\n\t\"createProjectBranchDatabase\",\n\t\"updateProjectBranchDatabase\",\n\t\"deleteProjectBranchDatabase\",\n\t// postgres: roles\n\t\"listProjectBranchRoles\",\n\t\"getProjectBranchRole\",\n\t\"createProjectBranchRole\",\n\t\"deleteProjectBranchRole\",\n\t\"getProjectBranchRolePassword\",\n\t\"resetProjectBranchRolePassword\",\n\t// postgres: connection string + data api\n\t\"getConnectionUri\",\n\t\"getProjectBranchDataApi\",\n\t\"createProjectBranchDataApi\",\n\t\"updateProjectBranchDataApi\",\n\t\"deleteProjectBranchDataApi\",\n\t// snapshots\n\t\"listSnapshots\",\n\t\"createSnapshot\",\n\t\"updateSnapshot\",\n\t\"deleteSnapshot\",\n\t\"restoreSnapshot\",\n\t\"getSnapshotSchedule\",\n\t\"setSnapshotSchedule\",\n\t// consumption\n\t\"getConsumptionHistoryPerProject\",\n\t\"getConsumptionHistoryPerProjectV2\",\n\t\"getConsumptionHistoryPerBranchV2\",\n\t// account\n\t\"getCurrentUserInfo\",\n\t\"getCurrentUserOrganizations\",\n\t\"getActiveRegions\",\n\t\"listApiKeys\",\n\t\"createApiKey\",\n\t\"revokeApiKey\",\n]);\n\n/**\n * Committed snapshot of every operation the generated client exposes. Update this\n * deliberately whenever the spec (and thus the generated client) changes.\n */\nexport const EXPECTED_OPERATIONS: ReadonlySet<string> = new Set([\n\t\"acceptProjectTransferRequest\",\n\t\"addBranchNeonAuthOauthProvider\",\n\t\"addBranchNeonAuthTrustedDomain\",\n\t\"addNeonAuthDomainToRedirectUriWhitelist\",\n\t\"addNeonAuthOauthProvider\",\n\t\"addProjectJwks\",\n\t\"assignOrganizationVpcEndpoint\",\n\t\"assignProjectVpcEndpoint\",\n\t\"countProjectBranches\",\n\t\"createApiKey\",\n\t\"createBranchNeonAuthNewUser\",\n\t\"createNeonAuth\",\n\t\"createNeonAuthIntegration\",\n\t\"createNeonAuthNewUser\",\n\t\"createNeonAuthProviderSdkKeys\",\n\t\"createOrgApiKey\",\n\t\"createOrganizationInvitations\",\n\t\"createProject\",\n\t\"createProjectBranch\",\n\t\"createProjectBranchAnonymized\",\n\t\"createProjectBranchDataApi\",\n\t\"createProjectBranchDatabase\",\n\t\"createProjectBranchRole\",\n\t\"createProjectEndpoint\",\n\t\"createProjectTransferRequest\",\n\t\"createSnapshot\",\n\t\"deleteBranchNeonAuthOauthProvider\",\n\t\"deleteBranchNeonAuthTrustedDomain\",\n\t\"deleteBranchNeonAuthUser\",\n\t\"deleteNeonAuthDomainFromRedirectUriWhitelist\",\n\t\"deleteNeonAuthIntegration\",\n\t\"deleteNeonAuthOauthProvider\",\n\t\"deleteNeonAuthUser\",\n\t\"deleteOrganizationSpendingLimit\",\n\t\"deleteOrganizationVpcEndpoint\",\n\t\"deleteProject\",\n\t\"deleteProjectBranch\",\n\t\"deleteProjectBranchDataApi\",\n\t\"deleteProjectBranchDatabase\",\n\t\"deleteProjectBranchRole\",\n\t\"deleteProjectEndpoint\",\n\t\"deleteProjectJwks\",\n\t\"deleteProjectVpcEndpoint\",\n\t\"deleteSnapshot\",\n\t\"disableNeonAuth\",\n\t\"finalizeRestoreBranch\",\n\t\"getActiveRegions\",\n\t\"getAnonymizedBranchStatus\",\n\t\"getAuthDetails\",\n\t\"getAvailablePreloadLibraries\",\n\t\"getConnectionUri\",\n\t\"getConsumptionHistoryPerBranchV2\",\n\t\"getConsumptionHistoryPerProject\",\n\t\"getConsumptionHistoryPerProjectV2\",\n\t\"getCurrentUserInfo\",\n\t\"getCurrentUserOrganizations\",\n\t\"getMaskingRules\",\n\t\"getNeonAuth\",\n\t\"getNeonAuthAllowLocalhost\",\n\t\"getNeonAuthEmailAndPasswordConfig\",\n\t\"getNeonAuthEmailProvider\",\n\t\"getNeonAuthEmailServer\",\n\t\"getNeonAuthPhoneNumberPlugin\",\n\t\"getNeonAuthPluginConfigs\",\n\t\"getNeonAuthWebhookConfig\",\n\t\"getOrganization\",\n\t\"getOrganizationInvitations\",\n\t\"getOrganizationMember\",\n\t\"getOrganizationMembers\",\n\t\"getOrganizationSpendingLimit\",\n\t\"getOrganizationVpcEndpointDetails\",\n\t\"getProject\",\n\t\"getProjectAdvisorSecurityIssues\",\n\t\"getProjectBranch\",\n\t\"getProjectBranchDataApi\",\n\t\"getProjectBranchDatabase\",\n\t\"getProjectBranchRole\",\n\t\"getProjectBranchRolePassword\",\n\t\"getProjectBranchSchema\",\n\t\"getProjectBranchSchemaComparison\",\n\t\"getProjectEndpoint\",\n\t\"getProjectJwks\",\n\t\"getProjectOperation\",\n\t\"getSnapshotSchedule\",\n\t\"grantPermissionToProject\",\n\t\"listApiKeys\",\n\t\"listBranchNeonAuthOauthProviders\",\n\t\"listBranchNeonAuthTrustedDomains\",\n\t\"listNeonAuthIntegrations\",\n\t\"listNeonAuthOauthProviders\",\n\t\"listNeonAuthRedirectUriWhitelistDomains\",\n\t\"listOrgApiKeys\",\n\t\"listOrganizationVpcEndpoints\",\n\t\"listOrganizationVpcEndpointsAllRegions\",\n\t\"listProjectBranchDatabases\",\n\t\"listProjectBranchEndpoints\",\n\t\"listProjectBranchRoles\",\n\t\"listProjectBranches\",\n\t\"listProjectEndpoints\",\n\t\"listProjectOperations\",\n\t\"listProjectPermissions\",\n\t\"listProjectVpcEndpoints\",\n\t\"listProjects\",\n\t\"listSharedProjects\",\n\t\"listSnapshots\",\n\t\"recoverProject\",\n\t\"removeOrganizationMember\",\n\t\"resetProjectBranchRolePassword\",\n\t\"restartProjectEndpoint\",\n\t\"restoreProjectBranch\",\n\t\"restoreSnapshot\",\n\t\"revokeApiKey\",\n\t\"revokeOrgApiKey\",\n\t\"revokePermissionFromProject\",\n\t\"sendNeonAuthTestEmail\",\n\t\"setDefaultProjectBranch\",\n\t\"setOrganizationSpendingLimit\",\n\t\"setSnapshotSchedule\",\n\t\"startAnonymization\",\n\t\"startProjectEndpoint\",\n\t\"suspendProjectEndpoint\",\n\t\"transferNeonAuthProviderProject\",\n\t\"transferProjectsFromOrgToOrg\",\n\t\"transferProjectsFromUserToOrg\",\n\t\"updateBranchNeonAuthOauthProvider\",\n\t\"updateMaskingRules\",\n\t\"updateNeonAuthAllowLocalhost\",\n\t\"updateNeonAuthConfig\",\n\t\"updateNeonAuthEmailAndPasswordConfig\",\n\t\"updateNeonAuthEmailProvider\",\n\t\"updateNeonAuthEmailServer\",\n\t\"updateNeonAuthMagicLinkPlugin\",\n\t\"updateNeonAuthOauthProvider\",\n\t\"updateNeonAuthOrganizationPlugin\",\n\t\"updateNeonAuthPhoneNumberPlugin\",\n\t\"updateNeonAuthUserRole\",\n\t\"updateNeonAuthWebhookConfig\",\n\t\"updateOrganizationMember\",\n\t\"updateProject\",\n\t\"updateProjectBranch\",\n\t\"updateProjectBranchDataApi\",\n\t\"updateProjectBranchDatabase\",\n\t\"updateProjectEndpoint\",\n\t\"updateSnapshot\",\n]);\n"],"mappings":";;;;;;;;;;;;;;;;;AAiBA,MAAa,0BAA+B,IAAI,IAAI;CAEnD;CACA;CACA;CACA;CACA;CAEA;CACA;CAEA;CACA;CACA;CACA;CACA;CACA;CACA;CAEA;CACA;CAEA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CAEA;CACA;CACA;CACA;CACA;CAEA;CACA;CACA;CACA;CACA;CACA;CAEA;CACA;CACA;CACA;CACA;CAEA;CACA;CACA;CACA;CACA;CACA;CACA;CAEA;CACA;CACA;CAEA;CACA;CACA;CACA;CACA;CACA;AACD,CAAC;;;;;AAMD,MAAa,sCAA2C,IAAI,IAAI;CAC/D;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACD,CAAC"}

package/dist/neon/errors.d.ts

@@ -0,0 +1,78 @@
+//#region src/neon/errors.d.ts
+/**
+ * Typed error hierarchy surfaced on the `error` channel of every ergonomic call (and
+ * thrown when `throwOnError` is set). All are `Error` subclasses with a `kind`
+ * discriminant, so the same value works whether you read it from `{ error }` or `catch`
+ * it.
+ */
+type NeonErrorKind = "api" | "not_found" | "auth" | "rate_limit" | "operation" | "timeout" | "network" | "client";
+/** Base class for every error the ergonomic layer produces. */
+declare class NeonError extends Error {
+  readonly kind: NeonErrorKind;
+  constructor(message: string, kind: NeonErrorKind, options?: {
+    cause?: unknown;
+  });
+}
+/** A non-2xx HTTP response from the Neon API. */
+declare class NeonApiError extends NeonError {
+  /** HTTP status code. */
+  readonly status: number;
+  /** Machine-readable Neon error code (`GeneralError.code`), when present. */
+  readonly code?: string;
+  /** Neon request id (`X-Request-Id` / `GeneralError.request_id`), when present. */
+  readonly requestId?: string;
+  /** The raw response, when one was received. */
+  readonly response?: Response;
+  /** The parsed error body, as returned by the API. */
+  readonly body: unknown;
+  constructor(message: string, init: {
+    kind?: NeonErrorKind;
+    status: number;
+    code?: string;
+    requestId?: string;
+    response?: Response;
+    body?: unknown;
+  });
+}
+/** 404 — the resource does not exist. */
+declare class NeonNotFoundError extends NeonApiError {
+  constructor(message: string, init: ConstructorParameters<typeof NeonApiError>[1]);
+}
+/** 401/403 — the API key is missing, invalid, or lacks permission. */
+declare class NeonAuthError extends NeonApiError {
+  constructor(message: string, init: ConstructorParameters<typeof NeonApiError>[1]);
+}
+/** 429 — rate limited (after retries, if enabled, were exhausted). */
+declare class NeonRateLimitError extends NeonApiError {
+  constructor(message: string, init: ConstructorParameters<typeof NeonApiError>[1]);
+}
+/** An awaited Neon operation ended in a non-success terminal state. */
+declare class NeonOperationError extends NeonError {
+  /** The id of the operation that failed. */
+  readonly operationId: string;
+  /** The terminal status reported by the API (`failed` / `error` / `cancelled`). */
+  readonly status: string;
+  constructor(message: string, init: {
+    operationId: string;
+    status: string;
+  });
+}
+/** Waiting for operations to finish exceeded the configured timeout. */
+declare class NeonTimeoutError extends NeonError {
+  constructor(message: string);
+}
+/** A transport-level failure (DNS, connection, abort) — no HTTP response received. */
+declare class NeonNetworkError extends NeonError {
+  constructor(message: string, options?: {
+    cause?: unknown;
+  });
+}
+/**
+ * Build the right {@link NeonError} subclass from a raw client result. `error` is the
+ * decoded error body (Neon `GeneralError`); `response` is present unless the failure was
+ * transport-level.
+ */
+declare function toNeonError(error: unknown, response: Response | undefined): NeonError;
+//#endregion
+export { NeonApiError, NeonAuthError, NeonError, NeonErrorKind, NeonNetworkError, NeonNotFoundError, NeonOperationError, NeonRateLimitError, NeonTimeoutError, toNeonError };
+//# sourceMappingURL=errors.d.ts.map

package/dist/neon/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","names":[],"sources":["../../src/neon/errors.ts"],"mappings":";;AAOA;AAWA;;;;AAA+B,KAXnB,aAAA,GAWmB,KAAA,GAAA,WAAA,GAAA,MAAA,GAAA,YAAA,GAAA,WAAA,GAAA,SAAA,GAAA,SAAA,GAAA,QAAA;AAAK;AAevB,cAfA,SAAA,SAAkB,KAAA,CAeL;EAAA,SAAA,IAAA,EAdV,aAcU;aAQL,CAAA,OAAA,EAAA,MAAA,EAAA,IAAA,EAlBb,aAkBa,EAAA,QAAA,EAAA;IAOX,KAAA,CAAA,EAAA,OAAA;;;AAfiC;AAiC9B,cAjCA,YAAA,SAAqB,SAAA,CAiCH;EAAA;WAGM,MAAA,EAAA,MAAA;;WAHE,IAAA,CAAA,EAAA,MAAA;EAAY;EAUtC,SAAA,SAAc,CAAA,EAAA,MAAA;EAAA;WAGU,QAAA,CAAA,EAtChB,QAsCgB;;WAHF,IAAA,EAAA,OAAA;EAAY,WAAA,CAAA,OAAA,EAAA,MAAA,EAAA,IAAA,EAAA;IAUlC,IAAA,CAAA,EAtCH,aAsCsB;IAAA,MAAA,EAAA,MAAA;IAGK,IAAA,CAAA,EAAA,MAAA;IAA7B,SAAA,CAAA,EAAA,MAAA;IAHgC,QAAA,CAAA,EAlC1B,QAkC0B;IAAY,IAAA,CAAA,EAAA,OAAA;EAUvC,CAAA;AAiBb;AAOA;AA6BgB,cAnFH,iBAAA,SAA0B,YAAA,CAmFZ;EAAA,WAAA,CAAA,OAAA,EAAA,MAAA,EAAA,IAAA,EAhFnB,qBAgFmB,CAAA,OAhFU,YAgFV,CAAA,CAAA,CAAA,CAAA;;;AAGf,cA5EC,aAAA,SAAsB,YAAA,CA4EvB;qCAzEJ,6BAA6B;;;cAOxB,kBAAA,SAA2B,YAAA;qCAGhC,6BAA6B;;;cAOxB,kBAAA,SAA2B,SAAS;;;;;;;;;;;cAiBpC,gBAAA,SAAyB,SAAS;;;;cAOlC,gBAAA,SAAyB,SAAS;;;;;;;;;;iBA6B/B,WAAA,2BAEL,uBACR"}

package/dist/neon/errors.js

@@ -0,0 +1,116 @@
+//#region src/neon/errors.ts
+/** Base class for every error the ergonomic layer produces. */
+var NeonError = class extends Error {
+	kind;
+	constructor(message, kind, options) {
+		super(message, options);
+		this.name = new.target.name;
+		this.kind = kind;
+	}
+};
+/** A non-2xx HTTP response from the Neon API. */
+var NeonApiError = class extends NeonError {
+	/** HTTP status code. */
+	status;
+	/** Machine-readable Neon error code (`GeneralError.code`), when present. */
+	code;
+	/** Neon request id (`X-Request-Id` / `GeneralError.request_id`), when present. */
+	requestId;
+	/** The raw response, when one was received. */
+	response;
+	/** The parsed error body, as returned by the API. */
+	body;
+	constructor(message, init) {
+		super(message, init.kind ?? "api");
+		this.status = init.status;
+		this.code = init.code;
+		this.requestId = init.requestId;
+		this.response = init.response;
+		this.body = init.body;
+	}
+};
+/** 404 — the resource does not exist. */
+var NeonNotFoundError = class extends NeonApiError {
+	constructor(message, init) {
+		super(message, {
+			...init,
+			kind: "not_found"
+		});
+	}
+};
+/** 401/403 — the API key is missing, invalid, or lacks permission. */
+var NeonAuthError = class extends NeonApiError {
+	constructor(message, init) {
+		super(message, {
+			...init,
+			kind: "auth"
+		});
+	}
+};
+/** 429 — rate limited (after retries, if enabled, were exhausted). */
+var NeonRateLimitError = class extends NeonApiError {
+	constructor(message, init) {
+		super(message, {
+			...init,
+			kind: "rate_limit"
+		});
+	}
+};
+/** An awaited Neon operation ended in a non-success terminal state. */
+var NeonOperationError = class extends NeonError {
+	/** The id of the operation that failed. */
+	operationId;
+	/** The terminal status reported by the API (`failed` / `error` / `cancelled`). */
+	status;
+	constructor(message, init) {
+		super(message, "operation");
+		this.operationId = init.operationId;
+		this.status = init.status;
+	}
+};
+/** Waiting for operations to finish exceeded the configured timeout. */
+var NeonTimeoutError = class extends NeonError {
+	constructor(message) {
+		super(message, "timeout");
+	}
+};
+/** A transport-level failure (DNS, connection, abort) — no HTTP response received. */
+var NeonNetworkError = class extends NeonError {
+	constructor(message, options) {
+		super(message, "network", options);
+	}
+};
+function readApiErrorBody(body) {
+	if (typeof body !== "object" || body === null) return {};
+	const out = {};
+	if ("message" in body && typeof body.message === "string") out.message = body.message;
+	if ("code" in body && typeof body.code === "string") out.code = body.code;
+	if ("request_id" in body && typeof body.request_id === "string") out.request_id = body.request_id;
+	return out;
+}
+/**
+* Build the right {@link NeonError} subclass from a raw client result. `error` is the
+* decoded error body (Neon `GeneralError`); `response` is present unless the failure was
+* transport-level.
+*/
+function toNeonError(error, response) {
+	if (!response) return new NeonNetworkError("Network error: no response received from the Neon API.", { cause: error });
+	const parsed = readApiErrorBody(error);
+	const status = response.status;
+	const message = parsed.message ?? `Neon API request failed with status ${status}.`;
+	const init = {
+		status,
+		code: parsed.code,
+		requestId: parsed.request_id ?? response.headers.get("x-request-id") ?? void 0,
+		response,
+		body: error
+	};
+	if (status === 404) return new NeonNotFoundError(message, init);
+	if (status === 401 || status === 403) return new NeonAuthError(message, init);
+	if (status === 429) return new NeonRateLimitError(message, init);
+	return new NeonApiError(message, init);
+}
+//#endregion
+export { NeonApiError, NeonAuthError, NeonError, NeonNetworkError, NeonNotFoundError, NeonOperationError, NeonRateLimitError, NeonTimeoutError, toNeonError };
+
+//# sourceMappingURL=errors.js.map