@neon/sdk 1.4.1 → 2.0.0

package/dist/neon/context.js

@@ -1,12 +1,14 @@
 import { toNeonError } from "./errors.js";
+import { cancelled, createDeadline, resolveTimeoutMs, runBounded } from "./deadline.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}.
+* Shared execution core: runs a raw client call under a deadline and 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;
@@ -19,6 +21,17 @@ var RequestContext = class {
 	get defaults() {
 		return this.#config;
 	}
+	/**
+	* The deadline for one call: the per-call timeout if given, else the client's.
+	*
+	* A per-call value is validated the same way the client's was. Skipping that left
+	* `requestTimeoutMs: NaN` meaning *unbounded* and a value past `setTimeout`'s range
+	* meaning *1ms*, both silently.
+	*/
+	deadlineFor(opts) {
+		const timeoutMs = opts?.requestTimeoutMs === void 0 ? this.#config.requestTimeoutMs : resolveTimeoutMs(opts.requestTimeoutMs);
+		return createDeadline(timeoutMs, opts?.signal);
+	}
 	/** 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;
@@ -27,9 +40,9 @@ var RequestContext = class {
 	/** 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);
+		const requested = await this.#request(opts, exec);
+		if (!requested.ok) return finalize(err(requested.error), shouldThrow);
+		const readiness = await this.#maybeWait(opts, requested.data);
 		if (readiness?.error) return finalize(err(readiness.error), shouldThrow);
 		return finalize(ok(void 0), shouldThrow);
 	}
@@ -38,11 +51,48 @@ var RequestContext = class {
 	* 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);
+		const requested = await this.#request(opts, exec);
+		if (!requested.ok) return err(requested.error);
+		if (requested.data === void 0) return err(toNeonError(void 0, requested.response));
+		const readiness = await this.#maybeWait(opts, requested.data);
 		if (readiness?.error) return err(readiness.error);
-		return ok(map(raw.data));
+		return ok(map(requested.data));
+	}
+	/**
+	* The request phase: bounded by the call's deadline, retried, and never allowed to
+	* reject. The deadline is disposed before readiness polling begins, so a request
+	* budget cannot cut short the separate `wait` budget.
+	*/
+	async #request(opts, exec) {
+		const deadline = this.deadlineFor(opts);
+		try {
+			const raw = await runBounded(deadline, () => withRetries(() => exec(this.#config.client, deadline.signal), this.#config.retries, deadline));
+			const cancellation = cancelled(deadline);
+			if (cancellation) return {
+				ok: false,
+				error: cancellation
+			};
+			if (raw === void 0) return {
+				ok: false,
+				error: toNeonError(void 0, void 0)
+			};
+			if (raw.error !== void 0) return {
+				ok: false,
+				error: toNeonError(raw.error, raw.response)
+			};
+			return {
+				ok: true,
+				data: raw.data,
+				response: raw.response
+			};
+		} catch (error) {
+			return {
+				ok: false,
+				error: cancelled(deadline) ?? toNeonError(error, void 0)
+			};
+		} finally {
+			deadline.dispose();
+		}
 	}
 	/** Poll provisioning operations when `waitForReadiness` is on and the body has any. */
 	async #maybeWait(opts, data) {

package/dist/neon/context.js.map

@@ -1 +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"}
+{"version":3,"file":"context.js","names":["#config","#request","#maybeWait"],"sources":["../../src/neon/context.ts"],"sourcesContent":["import type { Client } from \"../client/client/index.js\";\nimport {\n\tcancelled,\n\tcreateDeadline,\n\ttype Deadline,\n\tresolveTimeoutMs,\n\trunBounded,\n} from \"./deadline.js\";\nimport { type NeonError, 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\t/** `Infinity` when calls are unbounded, which is the default. */\n\trequestTimeoutMs: 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\t/**\n\t * Deadline for this request and its retries. `Infinity` opts out of a client-wide\n\t * value; readiness polling keeps its own `wait` budget either way.\n\t */\n\trequestTimeoutMs?: number;\n\t/** Cancel the call. Surfaces as a `NeonAbortError` (`kind: \"aborted\"`). */\n\tsignal?: AbortSignal;\n}\n\ninterface RawResult<D> {\n\tdata?: D | undefined;\n\terror?: unknown;\n\tresponse?: Response | undefined;\n}\n\n/** Every generated call the ergonomic layer makes, given the client and the call's signal. */\ntype Exec<D> = (\n\tclient: Client,\n\tsignal: AbortSignal | undefined,\n) => Promise<RawResult<D>>;\n\n/** The request phase's outcome, before readiness polling is considered. */\ntype Requested<D> =\n\t| { ok: true; data: D | undefined; response: Response | undefined }\n\t| { ok: false; error: NeonError };\n\n/**\n * Shared execution core: runs a raw client call under a deadline and with retries, maps\n * its envelope to the ergonomic resource shape, optionally waits for provisioning\n * operations, and applies the resolved `throwOnError` policy. Returns the bare value\n * (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/**\n\t * The deadline for one call: the per-call timeout if given, else the client's.\n\t *\n\t * A per-call value is validated the same way the client's was. Skipping that left\n\t * `requestTimeoutMs: NaN` meaning *unbounded* and a value past `setTimeout`'s range\n\t * meaning *1ms*, both silently.\n\t */\n\tdeadlineFor(opts: CallOptions | undefined): Deadline {\n\t\tconst timeoutMs =\n\t\t\topts?.requestTimeoutMs === undefined\n\t\t\t\t? this.#config.requestTimeoutMs\n\t\t\t\t: resolveTimeoutMs(opts.requestTimeoutMs);\n\t\treturn createDeadline(timeoutMs, opts?.signal);\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: Exec<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: Exec<D>,\n\t): Promise<void | NeonResult<void>> {\n\t\tconst shouldThrow = opts?.throwOnError ?? this.#config.throwOnError;\n\t\tconst requested = await this.#request(opts, exec);\n\t\tif (!requested.ok)\n\t\t\treturn finalize(err<void>(requested.error), shouldThrow);\n\t\tconst readiness = await this.#maybeWait(opts, requested.data);\n\t\tif (readiness?.error) {\n\t\t\treturn finalize(err<void>(readiness.error), shouldThrow);\n\t\t}\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: Exec<D>,\n\t\tmap: (data: D) => T,\n\t): Promise<NeonResult<T>> {\n\t\tconst requested = await this.#request(opts, exec);\n\t\tif (!requested.ok) return err(requested.error);\n\t\tif (requested.data === undefined) {\n\t\t\treturn err(toNeonError(undefined, requested.response));\n\t\t}\n\t\tconst readiness = await this.#maybeWait(opts, requested.data);\n\t\tif (readiness?.error) return err(readiness.error);\n\t\treturn ok(map(requested.data));\n\t}\n\n\t/**\n\t * The request phase: bounded by the call's deadline, retried, and never allowed to\n\t * reject. The deadline is disposed before readiness polling begins, so a request\n\t * budget cannot cut short the separate `wait` budget.\n\t */\n\tasync #request<D>(\n\t\topts: CallOptions | undefined,\n\t\texec: Exec<D>,\n\t): Promise<Requested<D>> {\n\t\tconst deadline = this.deadlineFor(opts);\n\t\ttry {\n\t\t\tconst raw = await runBounded(deadline, () =>\n\t\t\t\twithRetries(\n\t\t\t\t\t() => exec(this.#config.client, deadline.signal),\n\t\t\t\t\tthis.#config.retries,\n\t\t\t\t\tdeadline,\n\t\t\t\t),\n\t\t\t);\n\t\t\tconst cancellation = cancelled(deadline);\n\t\t\tif (cancellation) return { ok: false, error: cancellation };\n\t\t\tif (raw === undefined) {\n\t\t\t\treturn { ok: false, error: toNeonError(undefined, undefined) };\n\t\t\t}\n\t\t\tif (raw.error !== undefined) {\n\t\t\t\treturn {\n\t\t\t\t\tok: false,\n\t\t\t\t\terror: toNeonError(raw.error, raw.response),\n\t\t\t\t};\n\t\t\t}\n\t\t\treturn { ok: true, data: raw.data, response: raw.response };\n\t\t} catch (error) {\n\t\t\treturn {\n\t\t\t\tok: false,\n\t\t\t\terror: cancelled(deadline) ?? toNeonError(error, undefined),\n\t\t\t};\n\t\t} finally {\n\t\t\tdeadline.dispose();\n\t\t}\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":";;;;;;;;;;;;AAmEA,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;;;;;;;;CASA,YAAY,MAAyC;EACpD,MAAM,YACL,MAAM,qBAAqB,KAAA,IACxB,KAAKA,QAAQ,mBACb,iBAAiB,KAAK,gBAAgB;EAC1C,OAAO,eAAe,WAAW,MAAM,MAAM;CAC9C;;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,YAAY,MAAM,KAAKC,SAAS,MAAM,IAAI;EAChD,IAAI,CAAC,UAAU,IACd,OAAO,SAAS,IAAU,UAAU,KAAK,GAAG,WAAW;EACxD,MAAM,YAAY,MAAM,KAAKC,WAAW,MAAM,UAAU,IAAI;EAC5D,IAAI,WAAW,OACd,OAAO,SAAS,IAAU,UAAU,KAAK,GAAG,WAAW;EAExD,OAAO,SAAS,GAAG,KAAA,CAAS,GAAG,WAAW;CAC3C;;;;;CAMA,MAAM,QACL,MACA,MACA,KACyB;EACzB,MAAM,YAAY,MAAM,KAAKD,SAAS,MAAM,IAAI;EAChD,IAAI,CAAC,UAAU,IAAI,OAAO,IAAI,UAAU,KAAK;EAC7C,IAAI,UAAU,SAAS,KAAA,GACtB,OAAO,IAAI,YAAY,KAAA,GAAW,UAAU,QAAQ,CAAC;EAEtD,MAAM,YAAY,MAAM,KAAKC,WAAW,MAAM,UAAU,IAAI;EAC5D,IAAI,WAAW,OAAO,OAAO,IAAI,UAAU,KAAK;EAChD,OAAO,GAAG,IAAI,UAAU,IAAI,CAAC;CAC9B;;;;;;CAOA,MAAMD,SACL,MACA,MACwB;EACxB,MAAM,WAAW,KAAK,YAAY,IAAI;EACtC,IAAI;GACH,MAAM,MAAM,MAAM,WAAW,gBAC5B,kBACO,KAAK,KAAKD,QAAQ,QAAQ,SAAS,MAAM,GAC/C,KAAKA,QAAQ,SACb,QACD,CACD;GACA,MAAM,eAAe,UAAU,QAAQ;GACvC,IAAI,cAAc,OAAO;IAAE,IAAI;IAAO,OAAO;GAAa;GAC1D,IAAI,QAAQ,KAAA,GACX,OAAO;IAAE,IAAI;IAAO,OAAO,YAAY,KAAA,GAAW,KAAA,CAAS;GAAE;GAE9D,IAAI,IAAI,UAAU,KAAA,GACjB,OAAO;IACN,IAAI;IACJ,OAAO,YAAY,IAAI,OAAO,IAAI,QAAQ;GAC3C;GAED,OAAO;IAAE,IAAI;IAAM,MAAM,IAAI;IAAM,UAAU,IAAI;GAAS;EAC3D,SAAS,OAAO;GACf,OAAO;IACN,IAAI;IACJ,OAAO,UAAU,QAAQ,KAAK,YAAY,OAAO,KAAA,CAAS;GAC3D;EACD,UAAU;GACT,SAAS,QAAQ;EAClB;CACD;;CAGA,MAAME,WACL,MACA,MACwC;EAExC,IAAI,EADS,MAAM,oBAAoB,KAAKF,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.map

@@ -1 +1 @@
-{"version":3,"file":"coverage.d.ts","names":[],"sources":["../../src/neon/coverage.ts"],"mappings":";;AAiBA;AAsHA;;;;;;;;;;;;;;cAtHa,SAAS;;;;;cAsHT,qBAAqB"}
+{"version":3,"file":"coverage.d.ts","names":[],"sources":["../../src/neon/coverage.ts"],"mappings":";;AAiBA;AA6HA;;;;;;;;;;;;;;cA7Ha,SAAS;;;;;cA6HT,qBAAqB"}

package/dist/neon/coverage.js

@@ -27,6 +27,9 @@ const WRAPPED = /* @__PURE__ */ new Set([
 	"listProjectPermissions",
 	"grantPermissionToProject",
 	"revokePermissionFromProject",
+	"listProjectMembers",
+	"setProjectMemberRole",
+	"removeProjectMemberRole",
 	"listProjectBranches",
 	"getProjectBranch",
 	"createProjectBranch",
@@ -34,7 +37,9 @@ const WRAPPED = /* @__PURE__ */ new Set([
 	"deleteProjectBranch",
 	"setDefaultProjectBranch",
 	"finalizeRestoreBranch",
-	"recoverProjectBranch",
+	"queryProjectBranchLogs",
+	"listProjectBranchLogFields",
+	"listProjectBranchLogFieldValues",
 	"getNeonAuth",
 	"createNeonAuth",
 	"disableNeonAuth",
@@ -228,8 +233,11 @@ const EXPECTED_OPERATIONS = /* @__PURE__ */ new Set([
 	"listProjectBranchEndpoints",
 	"listProjectBranchRoles",
 	"listProjectBranchFunctions",
+	"listProjectBranchLogFields",
+	"listProjectBranchLogFieldValues",
 	"listProjectBranches",
 	"listProjectEndpoints",
+	"listProjectMembers",
 	"listProjectOperations",
 	"listProjectPermissions",
 	"listProjectVpcEndpoints",
@@ -237,9 +245,10 @@ const EXPECTED_OPERATIONS = /* @__PURE__ */ new Set([
 	"listSharedProjects",
 	"listSnapshots",
 	"presignProjectBranchBucketObject",
+	"queryProjectBranchLogs",
 	"recoverProject",
-	"recoverProjectBranch",
 	"removeOrganizationMember",
+	"removeProjectMemberRole",
 	"resetProjectBranchRolePassword",
 	"restartProjectEndpoint",
 	"restoreProjectBranch",
@@ -251,6 +260,7 @@ const EXPECTED_OPERATIONS = /* @__PURE__ */ new Set([
 	"sendNeonAuthTestEmail",
 	"setDefaultProjectBranch",
 	"setOrganizationSpendingLimit",
+	"setProjectMemberRole",
 	"setSnapshotSchedule",
 	"startAnonymization",
 	"startProjectEndpoint",

package/dist/neon/coverage.js.map

@@ -1 +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// projects: recover + permissions\n\t\"recoverProject\",\n\t\"listProjectPermissions\",\n\t\"grantPermissionToProject\",\n\t\"revokePermissionFromProject\",\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\"recoverProjectBranch\",\n\t// neon auth (branch-scoped)\n\t\"getNeonAuth\",\n\t\"createNeonAuth\",\n\t\"disableNeonAuth\",\n\t\"updateNeonAuthConfig\",\n\t\"listBranchNeonAuthOauthProviders\",\n\t\"addBranchNeonAuthOauthProvider\",\n\t\"updateBranchNeonAuthOauthProvider\",\n\t\"deleteBranchNeonAuthOauthProvider\",\n\t\"listBranchNeonAuthTrustedDomains\",\n\t\"addBranchNeonAuthTrustedDomain\",\n\t\"deleteBranchNeonAuthTrustedDomain\",\n\t\"createBranchNeonAuthNewUser\",\n\t\"deleteBranchNeonAuthUser\",\n\t\"updateNeonAuthUserRole\",\n\t// storage\n\t\"getProjectBranchStorage\",\n\t\"listProjectBranchBuckets\",\n\t\"createProjectBranchBucket\",\n\t\"deleteProjectBranchBucket\",\n\t\"listProjectBranchBucketObjects\",\n\t\"getProjectBranchBucketObject\",\n\t\"deleteProjectBranchBucketObject\",\n\t\"deleteProjectBranchBucketObjectsByPrefix\",\n\t\"presignProjectBranchBucketObject\",\n\t// ai gateway\n\t\"getProjectBranchAiGateway\",\n\t// credentials\n\t\"listCredentials\",\n\t\"createCredential\",\n\t\"revokeCredential\",\n\t// functions\n\t\"listProjectBranchFunctions\",\n\t\"getProjectBranchFunction\",\n\t\"updateProjectBranchFunction\",\n\t\"deleteProjectBranchFunction\",\n\t\"createProjectBranchFunctionDeployment\",\n\t// operations\n\t\"getProjectOperation\",\n\t\"listProjectOperations\",\n\t// postgres: endpoints\n\t\"listProjectEndpoints\",\n\t\"listProjectBranchEndpoints\",\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\"createCredential\",\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\"createProjectBranchBucket\",\n\t\"createProjectBranchAnonymized\",\n\t\"createProjectBranchDataApi\",\n\t\"createProjectBranchDatabase\",\n\t\"createProjectBranchFunctionDeployment\",\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\"deleteProjectBranchBucket\",\n\t\"deleteProjectBranchBucketObject\",\n\t\"deleteProjectBranchBucketObjectsByPrefix\",\n\t\"deleteProjectBranchDataApi\",\n\t\"deleteProjectBranchDatabase\",\n\t\"deleteProjectBranchFunction\",\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\"getProjectBranchAiGateway\",\n\t\"getProjectBranchBucketObject\",\n\t\"getProjectBranchDataApi\",\n\t\"getProjectBranchDatabase\",\n\t\"getProjectBranchFunction\",\n\t\"getProjectBranchRole\",\n\t\"getProjectBranchRolePassword\",\n\t\"getProjectBranchSchema\",\n\t\"getProjectBranchSchemaComparison\",\n\t\"getProjectBranchStorage\",\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\"listCredentials\",\n\t\"listNeonAuthIntegrations\",\n\t\"listNeonAuthOauthProviders\",\n\t\"listNeonAuthRedirectUriWhitelistDomains\",\n\t\"listOrgApiKeys\",\n\t\"listOrganizationVpcEndpoints\",\n\t\"listOrganizationVpcEndpointsAllRegions\",\n\t\"listProjectBranchDatabases\",\n\t\"listProjectBranchBucketObjects\",\n\t\"listProjectBranchBuckets\",\n\t\"listProjectBranchEndpoints\",\n\t\"listProjectBranchRoles\",\n\t\"listProjectBranchFunctions\",\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\"presignProjectBranchBucketObject\",\n\t\"recoverProject\",\n\t\"recoverProjectBranch\",\n\t\"removeOrganizationMember\",\n\t\"resetProjectBranchRolePassword\",\n\t\"restartProjectEndpoint\",\n\t\"restoreProjectBranch\",\n\t\"restoreSnapshot\",\n\t\"revokeApiKey\",\n\t\"revokeCredential\",\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\"updateProjectBranchFunction\",\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;CAEA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CAEA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CAEA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CAEA;CAEA;CACA;CACA;CAEA;CACA;CACA;CACA;CACA;CAEA;CACA;CAEA;CACA;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;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACD,CAAC"}
+{"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// projects: recover + permissions\n\t\"recoverProject\",\n\t\"listProjectPermissions\",\n\t\"grantPermissionToProject\",\n\t\"revokePermissionFromProject\",\n\t// projects: org member roles\n\t\"listProjectMembers\",\n\t\"setProjectMemberRole\",\n\t\"removeProjectMemberRole\",\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// logs (branch-scoped)\n\t\"queryProjectBranchLogs\",\n\t\"listProjectBranchLogFields\",\n\t\"listProjectBranchLogFieldValues\",\n\t// neon auth (branch-scoped)\n\t\"getNeonAuth\",\n\t\"createNeonAuth\",\n\t\"disableNeonAuth\",\n\t\"updateNeonAuthConfig\",\n\t\"listBranchNeonAuthOauthProviders\",\n\t\"addBranchNeonAuthOauthProvider\",\n\t\"updateBranchNeonAuthOauthProvider\",\n\t\"deleteBranchNeonAuthOauthProvider\",\n\t\"listBranchNeonAuthTrustedDomains\",\n\t\"addBranchNeonAuthTrustedDomain\",\n\t\"deleteBranchNeonAuthTrustedDomain\",\n\t\"createBranchNeonAuthNewUser\",\n\t\"deleteBranchNeonAuthUser\",\n\t\"updateNeonAuthUserRole\",\n\t// storage\n\t\"getProjectBranchStorage\",\n\t\"listProjectBranchBuckets\",\n\t\"createProjectBranchBucket\",\n\t\"deleteProjectBranchBucket\",\n\t\"listProjectBranchBucketObjects\",\n\t\"getProjectBranchBucketObject\",\n\t\"deleteProjectBranchBucketObject\",\n\t\"deleteProjectBranchBucketObjectsByPrefix\",\n\t\"presignProjectBranchBucketObject\",\n\t// ai gateway\n\t\"getProjectBranchAiGateway\",\n\t// credentials\n\t\"listCredentials\",\n\t\"createCredential\",\n\t\"revokeCredential\",\n\t// functions\n\t\"listProjectBranchFunctions\",\n\t\"getProjectBranchFunction\",\n\t\"updateProjectBranchFunction\",\n\t\"deleteProjectBranchFunction\",\n\t\"createProjectBranchFunctionDeployment\",\n\t// operations\n\t\"getProjectOperation\",\n\t\"listProjectOperations\",\n\t// postgres: endpoints\n\t\"listProjectEndpoints\",\n\t\"listProjectBranchEndpoints\",\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\"createCredential\",\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\"createProjectBranchBucket\",\n\t\"createProjectBranchAnonymized\",\n\t\"createProjectBranchDataApi\",\n\t\"createProjectBranchDatabase\",\n\t\"createProjectBranchFunctionDeployment\",\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\"deleteProjectBranchBucket\",\n\t\"deleteProjectBranchBucketObject\",\n\t\"deleteProjectBranchBucketObjectsByPrefix\",\n\t\"deleteProjectBranchDataApi\",\n\t\"deleteProjectBranchDatabase\",\n\t\"deleteProjectBranchFunction\",\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\"getProjectBranchAiGateway\",\n\t\"getProjectBranchBucketObject\",\n\t\"getProjectBranchDataApi\",\n\t\"getProjectBranchDatabase\",\n\t\"getProjectBranchFunction\",\n\t\"getProjectBranchRole\",\n\t\"getProjectBranchRolePassword\",\n\t\"getProjectBranchSchema\",\n\t\"getProjectBranchSchemaComparison\",\n\t\"getProjectBranchStorage\",\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\"listCredentials\",\n\t\"listNeonAuthIntegrations\",\n\t\"listNeonAuthOauthProviders\",\n\t\"listNeonAuthRedirectUriWhitelistDomains\",\n\t\"listOrgApiKeys\",\n\t\"listOrganizationVpcEndpoints\",\n\t\"listOrganizationVpcEndpointsAllRegions\",\n\t\"listProjectBranchDatabases\",\n\t\"listProjectBranchBucketObjects\",\n\t\"listProjectBranchBuckets\",\n\t\"listProjectBranchEndpoints\",\n\t\"listProjectBranchRoles\",\n\t\"listProjectBranchFunctions\",\n\t\"listProjectBranchLogFields\",\n\t\"listProjectBranchLogFieldValues\",\n\t\"listProjectBranches\",\n\t\"listProjectEndpoints\",\n\t\"listProjectMembers\",\n\t\"listProjectOperations\",\n\t\"listProjectPermissions\",\n\t\"listProjectVpcEndpoints\",\n\t\"listProjects\",\n\t\"listSharedProjects\",\n\t\"listSnapshots\",\n\t\"presignProjectBranchBucketObject\",\n\t\"queryProjectBranchLogs\",\n\t\"recoverProject\",\n\t\"removeOrganizationMember\",\n\t\"removeProjectMemberRole\",\n\t\"resetProjectBranchRolePassword\",\n\t\"restartProjectEndpoint\",\n\t\"restoreProjectBranch\",\n\t\"restoreSnapshot\",\n\t\"revokeApiKey\",\n\t\"revokeCredential\",\n\t\"revokeOrgApiKey\",\n\t\"revokePermissionFromProject\",\n\t\"sendNeonAuthTestEmail\",\n\t\"setDefaultProjectBranch\",\n\t\"setOrganizationSpendingLimit\",\n\t\"setProjectMemberRole\",\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\"updateProjectBranchFunction\",\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;CAEA;CACA;CACA;CAEA;CACA;CACA;CACA;CACA;CACA;CACA;CAEA;CACA;CACA;CAEA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CAEA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CAEA;CAEA;CACA;CACA;CAEA;CACA;CACA;CACA;CACA;CAEA;CACA;CAEA;CACA;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;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/deadline.d.ts

@@ -0,0 +1,81 @@
+import { NeonError } from "./errors.js";
+
+//#region src/neon/deadline.d.ts
+
+/** Why a bounded wait ended. */
+type DelayOutcome = "elapsed" | "cancelled";
+/** What ended a call: the caller's own signal, or the request-timeout budget. */
+type DeadlineSource = "caller" | "timeout";
+interface Deadline {
+  /**
+   * Attach to every request the call makes. `undefined` when the call is unbounded and
+   * the caller passed no signal, so nothing extra is allocated for the common case.
+   */
+  readonly signal: AbortSignal | undefined;
+  /** Budget left in milliseconds; `Infinity` when no request timeout applies. */
+  remainingMs(): number;
+  /**
+   * What ended the call, or `undefined` while it may still proceed.
+   *
+   * Reads the clock rather than trusting the timer to have run, and trips the deadline
+   * itself if the budget is already spent. A loop that only ever awaits
+   * already-resolved promises — paginating a cursor the API keeps repeating, say —
+   * yields to the microtask queue but never to the timer phase, so a timer-only
+   * deadline would never fire and the call would spin forever.
+   */
+  source(): DeadlineSource | undefined;
+  /**
+   * Resolves when the deadline fires, and otherwise never settles. Used to bound the
+   * phases a request signal cannot reach. Never rejects.
+   */
+  fired(): Promise<void>;
+  /** Release the timer and the caller-signal listener. Safe to call more than once. */
+  dispose(): void;
+}
+/**
+ * Normalize a `requestTimeoutMs`, rejecting values `setTimeout` would mistreat.
+ *
+ * Shared by the client config and by per-call overrides — validating only at construction
+ * left `requestTimeoutMs: NaN` on a call silently meaning *unbounded*, and a value past
+ * {@link MAX_TIMER_MS} silently meaning *1ms*. Both are worse than an error, because the
+ * call still returns a plausible-looking result.
+ *
+ * `undefined` and `Infinity` both mean unbounded; `Infinity` is the documented way to opt
+ * a single call out of a client-wide deadline.
+ */
+declare function resolveTimeoutMs(value: number | undefined): number;
+/**
+ * The typed error for a deadline that has fired, or `undefined` if it has not.
+ *
+ * Cancellation is classified from the deadline's own state rather than from the shape of
+ * the error that came back. The generated client funnels authentication, serialization,
+ * interceptor, transport and parsing faults through one channel, so an error merely named
+ * `AbortError` is not evidence that the caller cancelled.
+ */
+declare function cancelled(deadline: Deadline): NeonError | undefined;
+/**
+ * Race `run()` against the deadline, resolving `undefined` when the deadline wins.
+ *
+ * The signal alone does not bound a call. The generated client awaits authentication and
+ * request interceptors before it constructs the `Request`, and a caller-supplied `fetch`
+ * need not honour a signal at all, so an `apiKey` function that never resolves would
+ * otherwise hang forever even with a deadline set.
+ */
+declare function runBounded<T>(deadline: Deadline, run: () => Promise<T>): Promise<T | undefined>;
+/**
+ * Wait `ms`, or stop early when `signal` aborts. Resolves either way — an abort is
+ * reported as `"cancelled"` rather than thrown, and the listener is always removed so a
+ * long-lived caller signal doesn't accumulate one per wait.
+ */
+declare function delay(ms: number, signal?: AbortSignal): Promise<DelayOutcome>;
+/**
+ * Build the deadline for one call.
+ *
+ * `timeoutMs` is `Infinity` when no request timeout applies. With no timeout and no caller
+ * signal there is nothing to cancel, so a shared no-op deadline is returned and no timer
+ * or controller is allocated.
+ */
+declare function createDeadline(timeoutMs: number, callerSignal?: AbortSignal): Deadline;
+//#endregion
+export { Deadline, DeadlineSource, DelayOutcome, cancelled, createDeadline, delay, resolveTimeoutMs, runBounded };
+//# sourceMappingURL=deadline.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"deadline.d.ts","names":[],"sources":["../../src/neon/deadline.ts"],"mappings":";;;;AAsGoC;AAAW,KA9EnC,YAAA,GA8EmC,SAAA,GAAA,WAAA;AAAS;AAqBlC,KAhGV,cAAA,GAgGoB,QAAA,GAAA,SAAA;AAAA,UA9Ff,QAAA,CA8Fe;EACrB;AACS;AAAR;AACD;EAAR,SAAA,MAAA,EA5Fe,WA4Ff,GAAA,SAAA;EAAO;EAcM,WAAK,EAAA,EAAA,MAAA;EAAA;AAAsB;AAAsB;AAAR;AAAO;AAsBhE;AAA8B;AAEd;AACb;EAAQ,MAAA,EAAA,EAvHA,cAuHA,GAAA,SAAA;;;;;WAlHD;;;;;;;;;;;;;;;iBAwBM,gBAAA;;;;;;;;;iBA2BA,SAAA,WAAoB,WAAW;;;;;;;;;iBAqBzB,wBACX,qBACC,QAAQ,KACjB,QAAQ;;;;;;iBAcK,KAAA,sBAA2B,cAAc,QAAQ;;;;;;;;iBAsBjD,cAAA,mCAEA,cACb"}

package/dist/neon/deadline.js

@@ -0,0 +1,143 @@
+import { NeonAbortError, NeonError, NeonTimeoutError } from "./errors.js";
+//#region src/neon/deadline.ts
+/**
+* Cancellation and deadline plumbing shared by the ergonomic layer.
+*
+* Two facts shape this module. Handing a signal to `fetch` does **not** bound a call: the
+* generated client awaits authentication and request interceptors before it constructs the
+* `Request` (see `client/client/client.gen.ts`), and a caller-supplied `fetch` may ignore
+* the signal entirely. So a deadline both carries a signal *and* offers {@link Deadline.fired}
+* to race the whole execution against.
+*
+* And a cancelled call must still speak the result contract. Anything that waits here
+* reports cancellation as a value rather than rejecting, so a `DOMException` never escapes
+* to a caller who was promised `{ data, error }`.
+*/
+/**
+* The largest delay `setTimeout` can represent. Beyond it Node warns
+* (`TimeoutOverflowWarning`) and fires after 1ms instead, which would turn a deliberately
+* generous deadline into an instant timeout.
+*/
+const MAX_TIMER_MS = 2 ** 31 - 1;
+const UNBOUNDED = {
+	signal: void 0,
+	remainingMs: () => Number.POSITIVE_INFINITY,
+	source: () => void 0,
+	fired: () => new Promise(() => {}),
+	dispose: () => {}
+};
+/**
+* Normalize a `requestTimeoutMs`, rejecting values `setTimeout` would mistreat.
+*
+* Shared by the client config and by per-call overrides — validating only at construction
+* left `requestTimeoutMs: NaN` on a call silently meaning *unbounded*, and a value past
+* {@link MAX_TIMER_MS} silently meaning *1ms*. Both are worse than an error, because the
+* call still returns a plausible-looking result.
+*
+* `undefined` and `Infinity` both mean unbounded; `Infinity` is the documented way to opt
+* a single call out of a client-wide deadline.
+*/
+function resolveTimeoutMs(value) {
+	if (value === void 0 || value === Number.POSITIVE_INFINITY) return Number.POSITIVE_INFINITY;
+	if (typeof value !== "number" || Number.isNaN(value) || value <= 0) throw new NeonError(`requestTimeoutMs must be a positive number of milliseconds, or Infinity to disable; received ${String(value)}.`, "client");
+	if (value > MAX_TIMER_MS) throw new NeonError(`requestTimeoutMs must be at most ${MAX_TIMER_MS}ms (about 24.8 days); received ${value}. Pass Infinity for no deadline.`, "client");
+	return value;
+}
+/**
+* The typed error for a deadline that has fired, or `undefined` if it has not.
+*
+* Cancellation is classified from the deadline's own state rather than from the shape of
+* the error that came back. The generated client funnels authentication, serialization,
+* interceptor, transport and parsing faults through one channel, so an error merely named
+* `AbortError` is not evidence that the caller cancelled.
+*/
+function cancelled(deadline) {
+	const source = deadline.source();
+	if (source === "caller") return new NeonAbortError("The request was aborted by its signal.");
+	if (source === "timeout") return new NeonTimeoutError("Timed out waiting for the Neon API to respond (requestTimeoutMs).");
+}
+/**
+* Race `run()` against the deadline, resolving `undefined` when the deadline wins.
+*
+* The signal alone does not bound a call. The generated client awaits authentication and
+* request interceptors before it constructs the `Request`, and a caller-supplied `fetch`
+* need not honour a signal at all, so an `apiKey` function that never resolves would
+* otherwise hang forever even with a deadline set.
+*/
+async function runBounded(deadline, run) {
+	if (!deadline.signal) return run();
+	const execution = run();
+	execution.catch(() => {});
+	return Promise.race([execution, deadline.fired().then(() => void 0)]);
+}
+/**
+* Wait `ms`, or stop early when `signal` aborts. Resolves either way — an abort is
+* reported as `"cancelled"` rather than thrown, and the listener is always removed so a
+* long-lived caller signal doesn't accumulate one per wait.
+*/
+function delay(ms, signal) {
+	if (signal?.aborted) return Promise.resolve("cancelled");
+	return new Promise((resolve) => {
+		const onAbort = () => {
+			clearTimeout(timer);
+			resolve("cancelled");
+		};
+		const timer = setTimeout(() => {
+			signal?.removeEventListener("abort", onAbort);
+			resolve("elapsed");
+		}, ms);
+		signal?.addEventListener("abort", onAbort, { once: true });
+	});
+}
+/**
+* Build the deadline for one call.
+*
+* `timeoutMs` is `Infinity` when no request timeout applies. With no timeout and no caller
+* signal there is nothing to cancel, so a shared no-op deadline is returned and no timer
+* or controller is allocated.
+*/
+function createDeadline(timeoutMs, callerSignal) {
+	const bounded = Number.isFinite(timeoutMs);
+	if (!bounded && !callerSignal) return UNBOUNDED;
+	const startedAt = performance.now();
+	const controller = new AbortController();
+	let source;
+	let notify;
+	const fired = new Promise((resolve) => {
+		notify = resolve;
+	});
+	const trip = (reason) => {
+		if (source) return;
+		source = reason;
+		controller.abort();
+		notify?.();
+	};
+	if (callerSignal?.aborted) trip("caller");
+	const onCallerAbort = () => trip("caller");
+	const remainingMs = () => bounded ? Math.max(0, timeoutMs - (performance.now() - startedAt)) : Number.POSITIVE_INFINITY;
+	let timer;
+	const arm = () => {
+		const left = remainingMs();
+		if (left === 0) return trip("timeout");
+		timer = setTimeout(left > MAX_TIMER_MS ? arm : () => trip("timeout"), Math.min(left, MAX_TIMER_MS));
+	};
+	if (bounded) arm();
+	callerSignal?.addEventListener("abort", onCallerAbort, { once: true });
+	return {
+		signal: controller.signal,
+		remainingMs,
+		source: () => {
+			if (!source && remainingMs() === 0) trip("timeout");
+			return source;
+		},
+		fired: () => fired,
+		dispose: () => {
+			clearTimeout(timer);
+			callerSignal?.removeEventListener("abort", onCallerAbort);
+		}
+	};
+}
+//#endregion
+export { cancelled, createDeadline, delay, resolveTimeoutMs, runBounded };
+
+//# sourceMappingURL=deadline.js.map

package/dist/neon/deadline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deadline.js","names":[],"sources":["../../src/neon/deadline.ts"],"sourcesContent":["/**\n * Cancellation and deadline plumbing shared by the ergonomic layer.\n *\n * Two facts shape this module. Handing a signal to `fetch` does **not** bound a call: the\n * generated client awaits authentication and request interceptors before it constructs the\n * `Request` (see `client/client/client.gen.ts`), and a caller-supplied `fetch` may ignore\n * the signal entirely. So a deadline both carries a signal *and* offers {@link Deadline.fired}\n * to race the whole execution against.\n *\n * And a cancelled call must still speak the result contract. Anything that waits here\n * reports cancellation as a value rather than rejecting, so a `DOMException` never escapes\n * to a caller who was promised `{ data, error }`.\n */\n\nimport { NeonAbortError, NeonError, NeonTimeoutError } from \"./errors.js\";\n\n/**\n * The largest delay `setTimeout` can represent. Beyond it Node warns\n * (`TimeoutOverflowWarning`) and fires after 1ms instead, which would turn a deliberately\n * generous deadline into an instant timeout.\n */\nconst MAX_TIMER_MS = 2 ** 31 - 1;\n\n/** Why a bounded wait ended. */\nexport type DelayOutcome = \"elapsed\" | \"cancelled\";\n\n/** What ended a call: the caller's own signal, or the request-timeout budget. */\nexport type DeadlineSource = \"caller\" | \"timeout\";\n\nexport interface Deadline {\n\t/**\n\t * Attach to every request the call makes. `undefined` when the call is unbounded and\n\t * the caller passed no signal, so nothing extra is allocated for the common case.\n\t */\n\treadonly signal: AbortSignal | undefined;\n\t/** Budget left in milliseconds; `Infinity` when no request timeout applies. */\n\tremainingMs(): number;\n\t/**\n\t * What ended the call, or `undefined` while it may still proceed.\n\t *\n\t * Reads the clock rather than trusting the timer to have run, and trips the deadline\n\t * itself if the budget is already spent. A loop that only ever awaits\n\t * already-resolved promises — paginating a cursor the API keeps repeating, say —\n\t * yields to the microtask queue but never to the timer phase, so a timer-only\n\t * deadline would never fire and the call would spin forever.\n\t */\n\tsource(): DeadlineSource | undefined;\n\t/**\n\t * Resolves when the deadline fires, and otherwise never settles. Used to bound the\n\t * phases a request signal cannot reach. Never rejects.\n\t */\n\tfired(): Promise<void>;\n\t/** Release the timer and the caller-signal listener. Safe to call more than once. */\n\tdispose(): void;\n}\n\nconst UNBOUNDED: Deadline = {\n\tsignal: undefined,\n\tremainingMs: () => Number.POSITIVE_INFINITY,\n\tsource: () => undefined,\n\tfired: () => new Promise<void>(() => {}),\n\tdispose: () => {},\n};\n\n/**\n * Normalize a `requestTimeoutMs`, rejecting values `setTimeout` would mistreat.\n *\n * Shared by the client config and by per-call overrides — validating only at construction\n * left `requestTimeoutMs: NaN` on a call silently meaning *unbounded*, and a value past\n * {@link MAX_TIMER_MS} silently meaning *1ms*. Both are worse than an error, because the\n * call still returns a plausible-looking result.\n *\n * `undefined` and `Infinity` both mean unbounded; `Infinity` is the documented way to opt\n * a single call out of a client-wide deadline.\n */\nexport function resolveTimeoutMs(value: number | undefined): number {\n\tif (value === undefined || value === Number.POSITIVE_INFINITY) {\n\t\treturn Number.POSITIVE_INFINITY;\n\t}\n\tif (typeof value !== \"number\" || Number.isNaN(value) || value <= 0) {\n\t\tthrow new NeonError(\n\t\t\t`requestTimeoutMs must be a positive number of milliseconds, or Infinity to disable; received ${String(value)}.`,\n\t\t\t\"client\",\n\t\t);\n\t}\n\tif (value > MAX_TIMER_MS) {\n\t\tthrow new NeonError(\n\t\t\t`requestTimeoutMs must be at most ${MAX_TIMER_MS}ms (about 24.8 days); received ${value}. Pass Infinity for no deadline.`,\n\t\t\t\"client\",\n\t\t);\n\t}\n\treturn value;\n}\n\n/**\n * The typed error for a deadline that has fired, or `undefined` if it has not.\n *\n * Cancellation is classified from the deadline's own state rather than from the shape of\n * the error that came back. The generated client funnels authentication, serialization,\n * interceptor, transport and parsing faults through one channel, so an error merely named\n * `AbortError` is not evidence that the caller cancelled.\n */\nexport function cancelled(deadline: Deadline): NeonError | undefined {\n\tconst source = deadline.source();\n\tif (source === \"caller\") {\n\t\treturn new NeonAbortError(\"The request was aborted by its signal.\");\n\t}\n\tif (source === \"timeout\") {\n\t\treturn new NeonTimeoutError(\n\t\t\t\"Timed out waiting for the Neon API to respond (requestTimeoutMs).\",\n\t\t);\n\t}\n\treturn undefined;\n}\n\n/**\n * Race `run()` against the deadline, resolving `undefined` when the deadline wins.\n *\n * The signal alone does not bound a call. The generated client awaits authentication and\n * request interceptors before it constructs the `Request`, and a caller-supplied `fetch`\n * need not honour a signal at all, so an `apiKey` function that never resolves would\n * otherwise hang forever even with a deadline set.\n */\nexport async function runBounded<T>(\n\tdeadline: Deadline,\n\trun: () => Promise<T>,\n): Promise<T | undefined> {\n\tif (!deadline.signal) return run();\n\tconst execution = run();\n\t// The losing arm still settles later. Without a handler, its rejection is reported as\n\t// unhandled once the deadline has already answered the caller.\n\texecution.catch(() => {});\n\treturn Promise.race([execution, deadline.fired().then(() => undefined)]);\n}\n\n/**\n * Wait `ms`, or stop early when `signal` aborts. Resolves either way — an abort is\n * reported as `\"cancelled\"` rather than thrown, and the listener is always removed so a\n * long-lived caller signal doesn't accumulate one per wait.\n */\nexport function delay(ms: number, signal?: AbortSignal): Promise<DelayOutcome> {\n\tif (signal?.aborted) return Promise.resolve(\"cancelled\");\n\treturn new Promise<DelayOutcome>((resolve) => {\n\t\tconst onAbort = () => {\n\t\t\tclearTimeout(timer);\n\t\t\tresolve(\"cancelled\");\n\t\t};\n\t\tconst timer = setTimeout(() => {\n\t\t\tsignal?.removeEventListener(\"abort\", onAbort);\n\t\t\tresolve(\"elapsed\");\n\t\t}, ms);\n\t\tsignal?.addEventListener(\"abort\", onAbort, { once: true });\n\t});\n}\n\n/**\n * Build the deadline for one call.\n *\n * `timeoutMs` is `Infinity` when no request timeout applies. With no timeout and no caller\n * signal there is nothing to cancel, so a shared no-op deadline is returned and no timer\n * or controller is allocated.\n */\nexport function createDeadline(\n\ttimeoutMs: number,\n\tcallerSignal?: AbortSignal,\n): Deadline {\n\tconst bounded = Number.isFinite(timeoutMs);\n\tif (!bounded && !callerSignal) return UNBOUNDED;\n\n\t// Monotonic: a wall-clock jump (NTP correction, manual change) would otherwise expire\n\t// a deadline early or extend one whose timer is being starved.\n\tconst startedAt = performance.now();\n\tconst controller = new AbortController();\n\tlet source: DeadlineSource | undefined;\n\tlet notify: (() => void) | undefined;\n\tconst fired = new Promise<void>((resolve) => {\n\t\tnotify = resolve;\n\t});\n\n\tconst trip = (reason: DeadlineSource) => {\n\t\tif (source) return;\n\t\tsource = reason;\n\t\tcontroller.abort();\n\t\tnotify?.();\n\t};\n\n\tif (callerSignal?.aborted) trip(\"caller\");\n\n\tconst onCallerAbort = () => trip(\"caller\");\n\tconst remainingMs = () =>\n\t\tbounded\n\t\t\t? Math.max(0, timeoutMs - (performance.now() - startedAt))\n\t\t\t: Number.POSITIVE_INFINITY;\n\n\t// Deliberately not `unref`ed: every deadline is disposed in a `finally`, so it cannot\n\t// outlive its call, and an unref'd timer is invisible to the event loop's liveness\n\t// accounting — a call whose only pending work is the deadline would starve instead of\n\t// timing out.\n\t//\n\t// Re-armed in chunks rather than scheduled once, because `setTimeout` silently\n\t// collapses any delay above MAX_TIMER_MS to 1ms. `wait.timeoutMs` has always accepted\n\t// arbitrarily large budgets, and a single timer would have turned one into an instant\n\t// timeout.\n\tlet timer: ReturnType<typeof setTimeout> | undefined;\n\tconst arm = () => {\n\t\tconst left = remainingMs();\n\t\tif (left === 0) return trip(\"timeout\");\n\t\ttimer = setTimeout(\n\t\t\tleft > MAX_TIMER_MS ? arm : () => trip(\"timeout\"),\n\t\t\tMath.min(left, MAX_TIMER_MS),\n\t\t);\n\t};\n\tif (bounded) arm();\n\tcallerSignal?.addEventListener(\"abort\", onCallerAbort, { once: true });\n\n\treturn {\n\t\tsignal: controller.signal,\n\t\tremainingMs,\n\t\tsource: () => {\n\t\t\tif (!source && remainingMs() === 0) trip(\"timeout\");\n\t\t\treturn source;\n\t\t},\n\t\tfired: () => fired,\n\t\tdispose: () => {\n\t\t\tclearTimeout(timer);\n\t\t\tcallerSignal?.removeEventListener(\"abort\", onCallerAbort);\n\t\t},\n\t};\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAqBA,MAAM,eAAe,KAAK,KAAK;AAmC/B,MAAM,YAAsB;CAC3B,QAAQ,KAAA;CACR,mBAAmB,OAAO;CAC1B,cAAc,KAAA;CACd,aAAa,IAAI,cAAoB,CAAC,CAAC;CACvC,eAAe,CAAC;AACjB;;;;;;;;;;;;AAaA,SAAgB,iBAAiB,OAAmC;CACnE,IAAI,UAAU,KAAA,KAAa,UAAU,OAAO,mBAC3C,OAAO,OAAO;CAEf,IAAI,OAAO,UAAU,YAAY,OAAO,MAAM,KAAK,KAAK,SAAS,GAChE,MAAM,IAAI,UACT,gGAAgG,OAAO,KAAK,EAAE,IAC9G,QACD;CAED,IAAI,QAAQ,cACX,MAAM,IAAI,UACT,oCAAoC,aAAa,iCAAiC,MAAM,mCACxF,QACD;CAED,OAAO;AACR;;;;;;;;;AAUA,SAAgB,UAAU,UAA2C;CACpE,MAAM,SAAS,SAAS,OAAO;CAC/B,IAAI,WAAW,UACd,OAAO,IAAI,eAAe,wCAAwC;CAEnE,IAAI,WAAW,WACd,OAAO,IAAI,iBACV,mEACD;AAGF;;;;;;;;;AAUA,eAAsB,WACrB,UACA,KACyB;CACzB,IAAI,CAAC,SAAS,QAAQ,OAAO,IAAI;CACjC,MAAM,YAAY,IAAI;CAGtB,UAAU,YAAY,CAAC,CAAC;CACxB,OAAO,QAAQ,KAAK,CAAC,WAAW,SAAS,MAAM,CAAC,CAAC,WAAW,KAAA,CAAS,CAAC,CAAC;AACxE;;;;;;AAOA,SAAgB,MAAM,IAAY,QAA6C;CAC9E,IAAI,QAAQ,SAAS,OAAO,QAAQ,QAAQ,WAAW;CACvD,OAAO,IAAI,SAAuB,YAAY;EAC7C,MAAM,gBAAgB;GACrB,aAAa,KAAK;GAClB,QAAQ,WAAW;EACpB;EACA,MAAM,QAAQ,iBAAiB;GAC9B,QAAQ,oBAAoB,SAAS,OAAO;GAC5C,QAAQ,SAAS;EAClB,GAAG,EAAE;EACL,QAAQ,iBAAiB,SAAS,SAAS,EAAE,MAAM,KAAK,CAAC;CAC1D,CAAC;AACF;;;;;;;;AASA,SAAgB,eACf,WACA,cACW;CACX,MAAM,UAAU,OAAO,SAAS,SAAS;CACzC,IAAI,CAAC,WAAW,CAAC,cAAc,OAAO;CAItC,MAAM,YAAY,YAAY,IAAI;CAClC,MAAM,aAAa,IAAI,gBAAgB;CACvC,IAAI;CACJ,IAAI;CACJ,MAAM,QAAQ,IAAI,SAAe,YAAY;EAC5C,SAAS;CACV,CAAC;CAED,MAAM,QAAQ,WAA2B;EACxC,IAAI,QAAQ;EACZ,SAAS;EACT,WAAW,MAAM;EACjB,SAAS;CACV;CAEA,IAAI,cAAc,SAAS,KAAK,QAAQ;CAExC,MAAM,sBAAsB,KAAK,QAAQ;CACzC,MAAM,oBACL,UACG,KAAK,IAAI,GAAG,aAAa,YAAY,IAAI,IAAI,UAAU,IACvD,OAAO;CAWX,IAAI;CACJ,MAAM,YAAY;EACjB,MAAM,OAAO,YAAY;EACzB,IAAI,SAAS,GAAG,OAAO,KAAK,SAAS;EACrC,QAAQ,WACP,OAAO,eAAe,YAAY,KAAK,SAAS,GAChD,KAAK,IAAI,MAAM,YAAY,CAC5B;CACD;CACA,IAAI,SAAS,IAAI;CACjB,cAAc,iBAAiB,SAAS,eAAe,EAAE,MAAM,KAAK,CAAC;CAErE,OAAO;EACN,QAAQ,WAAW;EACnB;EACA,cAAc;GACb,IAAI,CAAC,UAAU,YAAY,MAAM,GAAG,KAAK,SAAS;GAClD,OAAO;EACR;EACA,aAAa;EACb,eAAe;GACd,aAAa,KAAK;GAClB,cAAc,oBAAoB,SAAS,aAAa;EACzD;CACD;AACD"}

package/dist/neon/errors.d.ts

@@ -5,7 +5,7 @@
  * 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";
+type NeonErrorKind = "api" | "not_found" | "auth" | "rate_limit" | "operation" | "timeout" | "aborted" | "network" | "client";
 /**
  * Base class for every error the ergonomic layer produces.
  *
@@ -64,10 +64,29 @@ declare class NeonOperationError extends NeonError {
     status: string;
   });
 }
-/** Waiting for operations to finish exceeded the configured timeout. */
+/**
+ * A deadline was exceeded — either `requestTimeoutMs` for a request and its retries, or
+ * the `wait` budget while polling operations for readiness.
+ */
 declare class NeonTimeoutError extends NeonError {
   constructor(message: string);
 }
+/**
+ * The caller's `AbortSignal` fired. Distinct from {@link NeonTimeoutError} because nothing
+ * went wrong: the caller asked for the work to stop, and the two call for different
+ * handling (retry a timeout, don't retry a cancellation).
+ *
+ * Raised only where the SDK knows the caller cancelled — the call's own deadline, or an
+ * already-aborted `signal` on a raw call. A transport failure that merely looks like an
+ * abort stays a {@link NeonNetworkError}, since the generated client reports auth,
+ * serialization, interceptor and parsing faults through the same channel and an error's
+ * name is not evidence about which one occurred.
+ */
+declare class NeonAbortError extends NeonError {
+  constructor(message: string, options?: {
+    cause?: unknown;
+  });
+}
 /** A transport-level failure (DNS, connection, abort) — no HTTP response received. */
 declare class NeonNetworkError extends NeonError {
   /**
@@ -97,5 +116,5 @@ declare function describeTransportFailure(error: unknown): string;
  */
 declare function toNeonError(error: unknown, response: Response | undefined): NeonError;
 //#endregion
-export { NeonApiError, NeonAuthError, NeonError, NeonErrorKind, NeonNetworkError, NeonNotFoundError, NeonOperationError, NeonRateLimitError, NeonTimeoutError, describeTransportFailure, toNeonError };
+export { NeonAbortError, NeonApiError, NeonAuthError, NeonError, NeonErrorKind, NeonNetworkError, NeonNotFoundError, NeonOperationError, NeonRateLimitError, NeonTimeoutError, describeTransportFailure, toNeonError };
 //# sourceMappingURL=errors.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","names":[],"sources":["../../src/neon/errors.ts"],"mappings":";;AAUA;AAkBA;AAAuB;AACP;AAIR;AALuB,KAlBnB,aAAA,GAkBmB,KAAA,GAAA,WAAA,GAAA,MAAA,GAAA,YAAA,GAAA,WAAA,GAAA,SAAA,GAAA,SAAA,GAAA,QAAA;AAAK;AAepC;AAA0B;AAQL;AAOX;AAII;AAnBoB;AAAS;AAkC9B,cAjDA,SAAA,SAAkB,KAAA,CAiDA;EAAA,SAAA,IAAA,EAhDf,aAgDe;EAGM,WAAA,CAAA,OAAA,EAAA,MAAA,EAAA,IAAA,EA/C7B,aA+C6B,EAAA,OAHE,CAGF,EAAA;IAA7B,KAAA,CAAA,EAAA,OAAA;EAH+B,CAAA;AAAY;AAWnD;AAA2B,cA7Cd,YAAA,SAAqB,SAAA,CA6CP;EAGU;EAA7B,SAAA,MAAA,EAAA,MAAA;EAH2B;EAAY,SAAA,IAAA,CAAA,EAAA,MAAA;EAWlC;EAAmB,SAAA,SAAA,CAAA,EAAA,MAAA;EAGK;EAA7B,SAAA,QAAA,CAAA,EAnDa,QAmDb;EAHgC;EAAY,SAAA,IAAA,EAAA,OAAA;EAWvC,WAAA,CAAA,OAAA,EAAmB,MAAA,EAAA,IAAA,EAAQ;IAkB3B,IAAA,CAAA,EAtEH,aAsEoB;IAQjB,MAAA,EAAA,MAAA;IA4CG,IAAA,CAAA,EAAA,MAAA;IAsBA,SAAA,CAAW,EAAA,MAAA;IAAA,QAAA,CAAA,EA5Ib,QA4Ia;IAEhB,IAAA,CAAA,EAAA,OAAA;EACR,CAAA;AAAS;;cAhIC,iBAAA,SAA0B,YAAA;qCAG/B,6BAA6B;;;cAQxB,aAAA,SAAsB,YAAA;qCAG3B,6BAA6B;;;cAQxB,kBAAA,SAA2B,YAAA;qCAGhC,6BAA6B;;;cAQxB,kBAAA,SAA2B,SAAS;;;;;;;;;;;cAkBpC,gBAAA,SAAyB,SAAS;;;;cAQlC,gBAAA,SAAyB,SAAS;;;;;;;;;;;;;;;;;;;;iBA4C/B,wBAAA;;;;;;iBAsBA,WAAA,2BAEL,uBACR"}
+{"version":3,"file":"errors.d.ts","names":[],"sources":["../../src/neon/errors.ts"],"mappings":";;AAUA;AAmBA;AAAuB;AACP;AAIR;AALuB,KAnBnB,aAAA,GAmBmB,KAAA,GAAA,WAAA,GAAA,MAAA,GAAA,YAAA,GAAA,WAAA,GAAA,SAAA,GAAA,SAAA,GAAA,SAAA,GAAA,QAAA;AAAK;AAepC;AAA0B;AAQL;AAOX;AAII;AAnBoB;AAAS;AAkC9B,cAjDA,SAAA,SAAkB,KAAA,CAiDA;EAAA,SAAA,IAAA,EAhDf,aAgDe;EAGM,WAAA,CAAA,OAAA,EAAA,MAAA,EAAA,IAAA,EA/C7B,aA+C6B,EAAA,OAHE,CAGF,EAAA;IAA7B,KAAA,CAAA,EAAA,OAAA;EAH+B,CAAA;AAAY;AAWnD;AAA2B,cA7Cd,YAAA,SAAqB,SAAA,CA6CP;EAGU;EAA7B,SAAA,MAAA,EAAA,MAAA;EAH2B;EAAY,SAAA,IAAA,CAAA,EAAA,MAAA;EAWlC;EAAmB,SAAA,SAAA,CAAA,EAAA,MAAA;EAGK;EAA7B,SAAA,QAAA,CAAA,EAnDa,QAmDb;EAHgC;EAAY,SAAA,IAAA,EAAA,OAAA;EAWvC,WAAA,CAAA,OAAA,EAAmB,MAAA,EAAA,IAAA,EAAQ;IAqB3B,IAAA,CAAA,EAzEH,aAyEoB;IAkBjB,MAAA,EAAA,MAAe;IAQf,IAAA,CAAA,EAAA,MAAA;IA4CG,SAAA,CAAA,EAAA,MAAA;IAsBA,QAAA,CAAA,EAjKF,QAiKa;IAAA,IAAA,CAAA,EAAA,OAAA;EAEhB,CAAA;AACR;AAAS;cArJC,iBAAA,SAA0B,YAAA;qCAG/B,6BAA6B;;;cAQxB,aAAA,SAAsB,YAAA;qCAG3B,6BAA6B;;;cAQxB,kBAAA,SAA2B,YAAA;qCAGhC,6BAA6B;;;cAQxB,kBAAA,SAA2B,SAAS;;;;;;;;;;;;;;cAqBpC,gBAAA,SAAyB,SAAS;;;;;;;;;;;;;;cAkBlC,cAAA,SAAuB,SAAS;;;;;;cAQhC,gBAAA,SAAyB,SAAS;;;;;;;;;;;;;;;;;;;;iBA4C/B,wBAAA;;;;;;iBAsBA,WAAA,2BAEL,uBACR"}

package/dist/neon/errors.js

@@ -88,13 +88,33 @@ var NeonOperationError = class extends NeonError {
 		this.status = init.status;
 	}
 };
-/** Waiting for operations to finish exceeded the configured timeout. */
+/**
+* A deadline was exceeded — either `requestTimeoutMs` for a request and its retries, or
+* the `wait` budget while polling operations for readiness.
+*/
 var NeonTimeoutError = class extends NeonError {
 	constructor(message) {
 		super(message, "timeout");
 		this.name = "NeonTimeoutError";
 	}
 };
+/**
+* The caller's `AbortSignal` fired. Distinct from {@link NeonTimeoutError} because nothing
+* went wrong: the caller asked for the work to stop, and the two call for different
+* handling (retry a timeout, don't retry a cancellation).
+*
+* Raised only where the SDK knows the caller cancelled — the call's own deadline, or an
+* already-aborted `signal` on a raw call. A transport failure that merely looks like an
+* abort stays a {@link NeonNetworkError}, since the generated client reports auth,
+* serialization, interceptor and parsing faults through the same channel and an error's
+* name is not evidence about which one occurred.
+*/
+var NeonAbortError = class extends NeonError {
+	constructor(message, options) {
+		super(message, "aborted", options);
+		this.name = "NeonAbortError";
+	}
+};
 /** A transport-level failure (DNS, connection, abort) — no HTTP response received. */
 var NeonNetworkError = class extends NeonError {
 	/**
@@ -166,6 +186,6 @@ function toNeonError(error, response) {
 	return new NeonApiError(message, init);
 }
 //#endregion
-export { NeonApiError, NeonAuthError, NeonError, NeonNetworkError, NeonNotFoundError, NeonOperationError, NeonRateLimitError, NeonTimeoutError, describeTransportFailure, toNeonError };
+export { NeonAbortError, NeonApiError, NeonAuthError, NeonError, NeonNetworkError, NeonNotFoundError, NeonOperationError, NeonRateLimitError, NeonTimeoutError, describeTransportFailure, toNeonError };
 
 //# sourceMappingURL=errors.js.map