@neon/sdk 0.0.0 → 0.2.0

package/dist/neon/resources/projects.d.ts

@@ -0,0 +1,84 @@
+import { ListProjectsData, Project, ProjectCreateRequest, ProjectListItem, ProjectUpdateRequest } from "../../client/types.gen.js";
+import { Outcome } from "../result.js";
+import { CallOptions, RequestContext } from "../context.js";
+import { Paginated } from "../paginate.js";
+
+//#region src/neon/resources/projects.d.ts
+/** Input for {@link Projects.transfer} (org → org). */
+interface TransferProjectsInput {
+  /** Source org. Defaults to the client's `orgId`. */
+  fromOrgId?: string;
+  /** Destination org. */
+  toOrgId: string;
+  projectIds: string[];
+}
+type ListQuery = Omit<NonNullable<ListProjectsData["query"]>, "cursor">;
+type CreateInput = ProjectCreateRequest["project"];
+type UpdateInput = ProjectUpdateRequest["project"];
+/** Per-call options for the connect workflow. */
+interface WorkflowOptions<Throw extends boolean> extends CallOptions<Throw> {
+  /** Return a pooled connection string (default `true`). */
+  pooled?: boolean;
+}
+/** A project with a ready-to-use connection string to its default branch. */
+interface ProjectConnection {
+  project: Project;
+  connectionString: string;
+}
+/** Project resource — one API call per method (`list` is cursor-paginated). */
+declare class Projects<DThrow extends boolean> {
+  #private;
+  constructor(ctx: RequestContext);
+  /**
+   * List projects (cursor-paginated). Returns a lazy list — `await .all()`, `.page()`,
+   * or `for await (… of …)`.
+   *
+   * @apiCall GET /projects
+   */
+  list(query?: ListQuery): Paginated<ProjectListItem>;
+  /** @apiCall GET /projects/{project_id} */
+  get(id: string): Promise<Outcome<Project, DThrow>>;
+  get<Throw extends boolean = DThrow>(id: string, opts: CallOptions<Throw>): Promise<Outcome<Project, Throw>>;
+  /** @apiCall POST /projects */
+  create(input?: CreateInput): Promise<Outcome<Project, DThrow>>;
+  create<Throw extends boolean = DThrow>(input: CreateInput | undefined, opts: CallOptions<Throw>): Promise<Outcome<Project, Throw>>;
+  /**
+   * Create a project and return a ready-to-use connection string to its default branch.
+   * One API call plus readiness polling (the create response already carries the
+   * connection URI).
+   *
+   * @workflow createProject + waitForReadiness
+   */
+  createAndConnect(input?: CreateInput): Promise<Outcome<ProjectConnection, DThrow>>;
+  createAndConnect<Throw extends boolean = DThrow>(input: CreateInput | undefined, opts: WorkflowOptions<Throw>): Promise<Outcome<ProjectConnection, Throw>>;
+  /** @apiCall PATCH /projects/{project_id} */
+  update(id: string, input: UpdateInput): Promise<Outcome<Project, DThrow>>;
+  update<Throw extends boolean = DThrow>(id: string, input: UpdateInput, opts: CallOptions<Throw>): Promise<Outcome<Project, Throw>>;
+  /** @apiCall DELETE /projects/{project_id} */
+  delete(id: string): Promise<Outcome<Project, DThrow>>;
+  delete<Throw extends boolean = DThrow>(id: string, opts: CallOptions<Throw>): Promise<Outcome<Project, Throw>>;
+  /**
+   * Transfer projects from one organization to another (e.g. sponsored → paid). The
+   * source org defaults to the client's `orgId`. Requires a key with access to both orgs.
+   *
+   * @apiCall POST /organizations/{source_org_id}/projects/transfer
+   */
+  transfer(input: TransferProjectsInput): Promise<Outcome<void, DThrow>>;
+  transfer<Throw extends boolean = DThrow>(input: TransferProjectsInput, opts: CallOptions<Throw>): Promise<Outcome<void, Throw>>;
+  /**
+   * Transfer projects from the personal account to an organization.
+   *
+   * @apiCall POST /users/me/projects/transfer
+   */
+  transferFromUser(input: {
+    toOrgId: string;
+    projectIds: string[];
+  }): Promise<Outcome<void, DThrow>>;
+  transferFromUser<Throw extends boolean = DThrow>(input: {
+    toOrgId: string;
+    projectIds: string[];
+  }, opts: CallOptions<Throw>): Promise<Outcome<void, Throw>>;
+}
+//#endregion
+export { ProjectConnection, Projects, TransferProjectsInput };
+//# sourceMappingURL=projects.d.ts.map

package/dist/neon/resources/projects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projects.d.ts","names":[],"sources":["../../../src/neon/resources/projects.ts"],"mappings":";;;;;;;UAuBiB,qBAAA;EAAA;EAQZ,SAAA,CAAA,EAAS,MAAA;EAAA;SAAoB,EAAA,MAAA;YAAZ,EAAA,MAAA,EAAA;;AAAD,KAAhB,SAAA,GAAY,IAAI,CAAC,WAAD,CAAa,gBAAb,CAAA,OAAA,CAAA,CAAA,EAAA,QAAA,CAAA;AAAA,KAChB,WAAA,GAAc,oBAAA,CAAA,SAAA,CAAA;AAAoB,KAClC,WAAA,GAAc,oBAAA,CAAA,SAAA,CAAA;AAAoB;UAG7B,eAAe,CAAA,cAAA,OAAA,CAAA,SAAgC,WAAhC,CAA4C,KAA5C,CAAA,CAAA;;QAAgC,CAAA,EAAA,OAAA;AAAW;AAMpE;AAMa,UANI,iBAAA,CAMI;EAAA,OAAA,EALX,OAKW;kBAGH,EAAA,MAAA;;;AAUQ,cAbb,QAaa,CAAA,eAAA,OAAA,CAAA,CAAA;UAqBQ;aAAS,CAAA,GAAA,EA/BzB,cA+ByB;;;;;;;MAId,CAAA,KAAA,CAAA,EAzBf,SAyBe,CAAA,EAzBH,SAyBG,CAzBO,eAyBP,CAAA;;KAAzB,CAAA,EAAA,EAAA,MAAA,CAAA,EAJc,OAId,CAJsB,OAItB,CAJ8B,OAI9B,EAJuC,MAIvC,CAAA,CAAA;KAkBY,CAAA,cAAA,OAAA,GArBa,MAqBb,CAAA,CAAA,EAAA,EAAA,MAAA,EAAA,IAAA,EAnBR,WAmBQ,CAnBI,KAmBJ,CAAA,CAAA,EAlBZ,OAkBY,CAlBJ,OAkBI,CAlBI,OAkBJ,EAlBa,KAkBb,CAAA,CAAA;;QAAuC,CAAA,KAAA,CAAA,EAAvC,WAAuC,CAAA,EAAzB,OAAyB,CAAjB,OAAiB,CAAT,OAAS,EAAA,MAAA,CAAA,CAAA;QAAjB,CAAA,cAAA,OAAA,GACN,MADM,CAAA,CAAA,KAAA,EAE7B,WAF6B,GAAA,SAAA,EAAA,IAAA,EAG9B,WAH8B,CAGlB,KAHkB,CAAA,CAAA,EAIlC,OAJkC,CAI1B,OAJ0B,CAIlB,OAJkB,EAIT,KAJS,CAAA,CAAA;;;;;;;;kBAI1B,CAAA,KAAA,CAAA,EAgCF,WAhCE,CAAA,EAiCR,OAjCQ,CAiCA,OAjCA,CAiCQ,iBAjCR,EAiC2B,MAjC3B,CAAA,CAAA;kBAAR,CAAA,cAAA,OAAA,GAkCsC,MAlCtC,CAAA,CAAA,KAAA,EAmCK,WAnCL,GAAA,SAAA,EAAA,IAAA,EAoCI,eApCJ,CAoCoB,KApCpB,CAAA,CAAA,EAqCA,OArCA,CAqCQ,OArCR,CAqCgB,iBArChB,EAqCmC,KArCnC,CAAA,CAAA;;QAiCgB,CAAA,EAAA,EAAA,MAAA,EAAA,KAAA,EAyCO,WAzCP,CAAA,EAyCqB,OAzCrB,CAyC6B,OAzC7B,CAyCqC,OAzCrC,EAyC8C,MAzC9C,CAAA,CAAA;QAAmB,CAAA,cAAA,OAAA,GA0CP,MA1CO,CAAA,CAAA,EAAA,EAAA,MAAA,EAAA,KAAA,EA4C9B,WA5C8B,EAAA,IAAA,EA6C/B,WA7C+B,CA6CnB,KA7CmB,CAAA,CAAA,EA8CnC,OA9CmC,CA8C3B,OA9C2B,CA8CnB,OA9CmB,EA8CV,KA9CU,CAAA,CAAA;;QAAnC,CAAA,EAAA,EAAA,MAAA,CAAA,EAkEiB,OAlEjB,CAkEyB,OAlEzB,CAkEiC,OAlEjC,EAkE0C,MAlE1C,CAAA,CAAA;QACsC,CAAA,cAAA,OAAA,GAkEV,MAlEU,CAAA,CAAA,EAAA,EAAA,MAAA,EAAA,IAAA,EAoElC,WApEkC,CAoEtB,KApEsB,CAAA,CAAA,EAqEtC,OArEsC,CAqE9B,OArE8B,CAqEtB,OArEsB,EAqEb,KArEa,CAAA,CAAA;;;;;;;UAGtC,CAAA,KAAA,EAyFa,qBAzFb,CAAA,EAyFqC,OAzFrC,CAyF6C,OAzF7C,CAAA,IAAA,EAyF2D,MAzF3D,CAAA,CAAA;UAqCuB,CAAA,cAAA,OAAA,GAqDO,MArDP,CAAA,CAAA,KAAA,EAsDlB,qBAtDkB,EAAA,IAAA,EAuDnB,WAvDmB,CAuDP,KAvDO,CAAA,CAAA,EAwDvB,OAxDuB,CAwDf,OAxDe,CAAA,IAAA,EAwDD,KAxDC,CAAA,CAAA;;;;;;kBAGlB,CAAA,KAAA,EAAA;IACW,OAAA,EAAA,MAAA;IAAZ,UAAA,EAAA,MAAA,EAAA;MA+FH,OA9Fe,CA8FP,OA9FO,CAAA,IAAA,EA8FO,MA9FP,CAAA,CAAA;kBAAS,CAAA,cAAA,OAAA,GA+Fa,MA/Fb,CAAA,CAAA,KAAA,EAAA;IAAjB,OAAA,EAAA,MAAA;IAAR,UAAA,EAAA,MAAA,EAAA;KAoBiC,IAAA,EA6E7B,WA7E6B,CA6EjB,KA7EiB,CAAA,CAAA,EA8EjC,OA9EiC,CA8EzB,OA9EyB,CAAA,IAAA,EA8EX,KA9EW,CAAA,CAAA"}

package/dist/neon/resources/projects.js

@@ -0,0 +1,111 @@
+import { NeonError } from "../errors.js";
+import { err, finalize } from "../result.js";
+import { createProject, deleteProject, getProject, listProjects, transferProjectsFromOrgToOrg, transferProjectsFromUserToOrg, updateProject } from "../../client/sdk.gen.js";
+import { withConnectionString } from "../connection.js";
+import { paginate } from "../paginate.js";
+//#region src/neon/resources/projects.ts
+/** Project resource — one API call per method (`list` is cursor-paginated). */
+var Projects = class {
+	#ctx;
+	constructor(ctx) {
+		this.#ctx = ctx;
+	}
+	/**
+	* List projects (cursor-paginated). Returns a lazy list — `await .all()`, `.page()`,
+	* or `for await (… of …)`.
+	*
+	* @apiCall GET /projects
+	*/
+	list(query) {
+		return paginate((cursor, signal) => listProjects({
+			client: this.#ctx.client,
+			query: {
+				org_id: this.#ctx.defaults.orgId,
+				...query,
+				cursor
+			},
+			throwOnError: false,
+			signal
+		}), (data) => ({
+			items: data?.projects ?? [],
+			cursor: data?.pagination?.cursor
+		}));
+	}
+	get(id, opts) {
+		return this.#ctx.run(opts, (client) => getProject({
+			client,
+			path: { project_id: id },
+			throwOnError: false
+		}), (data) => data.project);
+	}
+	create(input, opts) {
+		return this.#ctx.run(opts, (client) => createProject({
+			client,
+			body: { project: {
+				...this.#ctx.defaults.orgId ? { org_id: this.#ctx.defaults.orgId } : {},
+				...input
+			} },
+			throwOnError: false
+		}), (data) => data.project);
+	}
+	async createAndConnect(input, opts) {
+		const shouldThrow = opts?.throwOnError ?? this.#ctx.defaults.throwOnError;
+		return finalize(withConnectionString(await this.#ctx.execute({
+			...opts,
+			waitForReadiness: opts?.waitForReadiness ?? true
+		}, (client) => createProject({
+			client,
+			body: { project: {
+				...this.#ctx.defaults.orgId ? { org_id: this.#ctx.defaults.orgId } : {},
+				...input
+			} },
+			throwOnError: false
+		}), (data) => data), (data) => data.connection_uris, (data, connectionString) => ({
+			project: data.project,
+			connectionString
+		}), opts?.pooled ?? true), shouldThrow);
+	}
+	update(id, input, opts) {
+		return this.#ctx.run(opts, (client) => updateProject({
+			client,
+			path: { project_id: id },
+			body: { project: input },
+			throwOnError: false
+		}), (data) => data.project);
+	}
+	delete(id, opts) {
+		return this.#ctx.run(opts, (client) => deleteProject({
+			client,
+			path: { project_id: id },
+			throwOnError: false
+		}), (data) => data.project);
+	}
+	async transfer(input, opts) {
+		const shouldThrow = opts?.throwOnError ?? this.#ctx.defaults.throwOnError;
+		const fromOrgId = input.fromOrgId ?? this.#ctx.defaults.orgId;
+		if (!fromOrgId) return finalize(err(new NeonError("Pass fromOrgId or set orgId on the client.", "client")), shouldThrow);
+		return this.#ctx.run(opts, (client) => transferProjectsFromOrgToOrg({
+			client,
+			path: { source_org_id: fromOrgId },
+			body: {
+				destination_org_id: input.toOrgId,
+				project_ids: input.projectIds
+			},
+			throwOnError: false
+		}), () => void 0);
+	}
+	transferFromUser(input, opts) {
+		return this.#ctx.run(opts, (client) => transferProjectsFromUserToOrg({
+			client,
+			body: {
+				destination_org_id: input.toOrgId,
+				project_ids: input.projectIds
+			},
+			throwOnError: false
+		}), () => void 0);
+	}
+};
+//#endregion
+export { Projects };
+
+//# sourceMappingURL=projects.js.map

package/dist/neon/resources/projects.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projects.js","names":["#ctx"],"sources":["../../../src/neon/resources/projects.ts"],"sourcesContent":["import {\n\tcreateProject,\n\tdeleteProject,\n\tgetProject,\n\tlistProjects,\n\ttransferProjectsFromOrgToOrg,\n\ttransferProjectsFromUserToOrg,\n\tupdateProject,\n} from \"../../client/sdk.gen.js\";\nimport type {\n\tListProjectsData,\n\tProject,\n\tProjectCreateRequest,\n\tProjectListItem,\n\tProjectUpdateRequest,\n} from \"../../client/types.gen.js\";\nimport { withConnectionString } from \"../connection.js\";\nimport type { CallOptions, RequestContext } from \"../context.js\";\nimport { NeonError } from \"../errors.js\";\nimport { type Paginated, paginate } from \"../paginate.js\";\nimport { err, finalize, type NeonResult, type Outcome } from \"../result.js\";\n\n/** Input for {@link Projects.transfer} (org → org). */\nexport interface TransferProjectsInput {\n\t/** Source org. Defaults to the client's `orgId`. */\n\tfromOrgId?: string;\n\t/** Destination org. */\n\ttoOrgId: string;\n\tprojectIds: string[];\n}\n\ntype ListQuery = Omit<NonNullable<ListProjectsData[\"query\"]>, \"cursor\">;\ntype CreateInput = ProjectCreateRequest[\"project\"];\ntype UpdateInput = ProjectUpdateRequest[\"project\"];\n\n/** Per-call options for the connect workflow. */\ninterface WorkflowOptions<Throw extends boolean> extends CallOptions<Throw> {\n\t/** Return a pooled connection string (default `true`). */\n\tpooled?: boolean;\n}\n\n/** A project with a ready-to-use connection string to its default branch. */\nexport interface ProjectConnection {\n\tproject: Project;\n\tconnectionString: string;\n}\n\n/** Project resource — one API call per method (`list` is cursor-paginated). */\nexport class Projects<DThrow extends boolean> {\n\treadonly #ctx: RequestContext;\n\n\tconstructor(ctx: RequestContext) {\n\t\tthis.#ctx = ctx;\n\t}\n\n\t/**\n\t * List projects (cursor-paginated). Returns a lazy list — `await .all()`, `.page()`,\n\t * or `for await (… of …)`.\n\t *\n\t * @apiCall GET /projects\n\t */\n\tlist(query?: ListQuery): Paginated<ProjectListItem> {\n\t\treturn paginate(\n\t\t\t(cursor, signal) =>\n\t\t\t\tlistProjects({\n\t\t\t\t\tclient: this.#ctx.client,\n\t\t\t\t\tquery: {\n\t\t\t\t\t\torg_id: this.#ctx.defaults.orgId,\n\t\t\t\t\t\t...query,\n\t\t\t\t\t\tcursor,\n\t\t\t\t\t},\n\t\t\t\t\tthrowOnError: false,\n\t\t\t\t\tsignal,\n\t\t\t\t}),\n\t\t\t(data) => ({\n\t\t\t\titems: data?.projects ?? [],\n\t\t\t\tcursor: data?.pagination?.cursor,\n\t\t\t}),\n\t\t);\n\t}\n\n\t/** @apiCall GET /projects/{project_id} */\n\tget(id: string): Promise<Outcome<Project, DThrow>>;\n\tget<Throw extends boolean = DThrow>(\n\t\tid: string,\n\t\topts: CallOptions<Throw>,\n\t): Promise<Outcome<Project, Throw>>;\n\tget(\n\t\tid: string,\n\t\topts?: CallOptions,\n\t): Promise<Project | NeonResult<Project>> {\n\t\treturn this.#ctx.run(\n\t\t\topts,\n\t\t\t(client) =>\n\t\t\t\tgetProject({\n\t\t\t\t\tclient,\n\t\t\t\t\tpath: { project_id: id },\n\t\t\t\t\tthrowOnError: false,\n\t\t\t\t}),\n\t\t\t(data) => data.project,\n\t\t);\n\t}\n\n\t/** @apiCall POST /projects */\n\tcreate(input?: CreateInput): Promise<Outcome<Project, DThrow>>;\n\tcreate<Throw extends boolean = DThrow>(\n\t\tinput: CreateInput | undefined,\n\t\topts: CallOptions<Throw>,\n\t): Promise<Outcome<Project, Throw>>;\n\tcreate(\n\t\tinput?: CreateInput,\n\t\topts?: CallOptions,\n\t): Promise<Project | NeonResult<Project>> {\n\t\treturn this.#ctx.run(\n\t\t\topts,\n\t\t\t(client) =>\n\t\t\t\tcreateProject({\n\t\t\t\t\tclient,\n\t\t\t\t\tbody: {\n\t\t\t\t\t\tproject: {\n\t\t\t\t\t\t\t...(this.#ctx.defaults.orgId\n\t\t\t\t\t\t\t\t? { org_id: this.#ctx.defaults.orgId }\n\t\t\t\t\t\t\t\t: {}),\n\t\t\t\t\t\t\t...input,\n\t\t\t\t\t\t},\n\t\t\t\t\t},\n\t\t\t\t\tthrowOnError: false,\n\t\t\t\t}),\n\t\t\t(data) => data.project,\n\t\t);\n\t}\n\n\t/**\n\t * Create a project and return a ready-to-use connection string to its default branch.\n\t * One API call plus readiness polling (the create response already carries the\n\t * connection URI).\n\t *\n\t * @workflow createProject + waitForReadiness\n\t */\n\tcreateAndConnect(\n\t\tinput?: CreateInput,\n\t): Promise<Outcome<ProjectConnection, DThrow>>;\n\tcreateAndConnect<Throw extends boolean = DThrow>(\n\t\tinput: CreateInput | undefined,\n\t\topts: WorkflowOptions<Throw>,\n\t): Promise<Outcome<ProjectConnection, Throw>>;\n\tasync createAndConnect(\n\t\tinput?: CreateInput,\n\t\topts?: WorkflowOptions<boolean>,\n\t): Promise<ProjectConnection | NeonResult<ProjectConnection>> {\n\t\tconst shouldThrow =\n\t\t\topts?.throwOnError ?? this.#ctx.defaults.throwOnError;\n\t\tconst result = await this.#ctx.execute(\n\t\t\t{ ...opts, waitForReadiness: opts?.waitForReadiness ?? true },\n\t\t\t(client) =>\n\t\t\t\tcreateProject({\n\t\t\t\t\tclient,\n\t\t\t\t\tbody: {\n\t\t\t\t\t\tproject: {\n\t\t\t\t\t\t\t...(this.#ctx.defaults.orgId\n\t\t\t\t\t\t\t\t? { org_id: this.#ctx.defaults.orgId }\n\t\t\t\t\t\t\t\t: {}),\n\t\t\t\t\t\t\t...input,\n\t\t\t\t\t\t},\n\t\t\t\t\t},\n\t\t\t\t\tthrowOnError: false,\n\t\t\t\t}),\n\t\t\t(data) => data,\n\t\t);\n\t\tconst out = withConnectionString(\n\t\t\tresult,\n\t\t\t(data) => data.connection_uris,\n\t\t\t(data, connectionString) => ({\n\t\t\t\tproject: data.project,\n\t\t\t\tconnectionString,\n\t\t\t}),\n\t\t\topts?.pooled ?? true,\n\t\t);\n\t\treturn finalize(out, shouldThrow);\n\t}\n\n\t/** @apiCall PATCH /projects/{project_id} */\n\tupdate(id: string, input: UpdateInput): Promise<Outcome<Project, DThrow>>;\n\tupdate<Throw extends boolean = DThrow>(\n\t\tid: string,\n\t\tinput: UpdateInput,\n\t\topts: CallOptions<Throw>,\n\t): Promise<Outcome<Project, Throw>>;\n\tupdate(\n\t\tid: string,\n\t\tinput: UpdateInput,\n\t\topts?: CallOptions,\n\t): Promise<Project | NeonResult<Project>> {\n\t\treturn this.#ctx.run(\n\t\t\topts,\n\t\t\t(client) =>\n\t\t\t\tupdateProject({\n\t\t\t\t\tclient,\n\t\t\t\t\tpath: { project_id: id },\n\t\t\t\t\tbody: { project: input },\n\t\t\t\t\tthrowOnError: false,\n\t\t\t\t}),\n\t\t\t(data) => data.project,\n\t\t);\n\t}\n\n\t/** @apiCall DELETE /projects/{project_id} */\n\tdelete(id: string): Promise<Outcome<Project, DThrow>>;\n\tdelete<Throw extends boolean = DThrow>(\n\t\tid: string,\n\t\topts: CallOptions<Throw>,\n\t): Promise<Outcome<Project, Throw>>;\n\tdelete(\n\t\tid: string,\n\t\topts?: CallOptions,\n\t): Promise<Project | NeonResult<Project>> {\n\t\treturn this.#ctx.run(\n\t\t\topts,\n\t\t\t(client) =>\n\t\t\t\tdeleteProject({\n\t\t\t\t\tclient,\n\t\t\t\t\tpath: { project_id: id },\n\t\t\t\t\tthrowOnError: false,\n\t\t\t\t}),\n\t\t\t(data) => data.project,\n\t\t);\n\t}\n\n\t/**\n\t * Transfer projects from one organization to another (e.g. sponsored → paid). The\n\t * source org defaults to the client's `orgId`. Requires a key with access to both orgs.\n\t *\n\t * @apiCall POST /organizations/{source_org_id}/projects/transfer\n\t */\n\ttransfer(input: TransferProjectsInput): Promise<Outcome<void, DThrow>>;\n\ttransfer<Throw extends boolean = DThrow>(\n\t\tinput: TransferProjectsInput,\n\t\topts: CallOptions<Throw>,\n\t): Promise<Outcome<void, Throw>>;\n\tasync transfer(\n\t\tinput: TransferProjectsInput,\n\t\topts?: CallOptions,\n\t): Promise<void | NeonResult<void>> {\n\t\tconst shouldThrow =\n\t\t\topts?.throwOnError ?? this.#ctx.defaults.throwOnError;\n\t\tconst fromOrgId = input.fromOrgId ?? this.#ctx.defaults.orgId;\n\t\tif (!fromOrgId) {\n\t\t\treturn finalize(\n\t\t\t\terr<void>(\n\t\t\t\t\tnew NeonError(\n\t\t\t\t\t\t\"Pass fromOrgId or set orgId on the client.\",\n\t\t\t\t\t\t\"client\",\n\t\t\t\t\t),\n\t\t\t\t),\n\t\t\t\tshouldThrow,\n\t\t\t);\n\t\t}\n\t\treturn this.#ctx.run(\n\t\t\topts,\n\t\t\t(client) =>\n\t\t\t\ttransferProjectsFromOrgToOrg({\n\t\t\t\t\tclient,\n\t\t\t\t\tpath: { source_org_id: fromOrgId },\n\t\t\t\t\tbody: {\n\t\t\t\t\t\tdestination_org_id: input.toOrgId,\n\t\t\t\t\t\tproject_ids: input.projectIds,\n\t\t\t\t\t},\n\t\t\t\t\tthrowOnError: false,\n\t\t\t\t}),\n\t\t\t() => undefined,\n\t\t);\n\t}\n\n\t/**\n\t * Transfer projects from the personal account to an organization.\n\t *\n\t * @apiCall POST /users/me/projects/transfer\n\t */\n\ttransferFromUser(input: {\n\t\ttoOrgId: string;\n\t\tprojectIds: string[];\n\t}): Promise<Outcome<void, DThrow>>;\n\ttransferFromUser<Throw extends boolean = DThrow>(\n\t\tinput: { toOrgId: string; projectIds: string[] },\n\t\topts: CallOptions<Throw>,\n\t): Promise<Outcome<void, Throw>>;\n\ttransferFromUser(\n\t\tinput: { toOrgId: string; projectIds: string[] },\n\t\topts?: CallOptions,\n\t): Promise<void | NeonResult<void>> {\n\t\treturn this.#ctx.run(\n\t\t\topts,\n\t\t\t(client) =>\n\t\t\t\ttransferProjectsFromUserToOrg({\n\t\t\t\t\tclient,\n\t\t\t\t\tbody: {\n\t\t\t\t\t\tdestination_org_id: input.toOrgId,\n\t\t\t\t\t\tproject_ids: input.projectIds,\n\t\t\t\t\t},\n\t\t\t\t\tthrowOnError: false,\n\t\t\t\t}),\n\t\t\t() => undefined,\n\t\t);\n\t}\n}\n"],"mappings":";;;;;;;AAgDA,IAAa,WAAb,MAA8C;CAC7C;CAEA,YAAY,KAAqB;EAChC,KAAKA,OAAO;CACb;;;;;;;CAQA,KAAK,OAA+C;EACnD,OAAO,UACL,QAAQ,WACR,aAAa;GACZ,QAAQ,KAAKA,KAAK;GAClB,OAAO;IACN,QAAQ,KAAKA,KAAK,SAAS;IAC3B,GAAG;IACH;GACD;GACA,cAAc;GACd;EACD,CAAC,IACD,UAAU;GACV,OAAO,MAAM,YAAY,CAAC;GAC1B,QAAQ,MAAM,YAAY;EAC3B,EACD;CACD;CAQA,IACC,IACA,MACyC;EACzC,OAAO,KAAKA,KAAK,IAChB,OACC,WACA,WAAW;GACV;GACA,MAAM,EAAE,YAAY,GAAG;GACvB,cAAc;EACf,CAAC,IACD,SAAS,KAAK,OAChB;CACD;CAQA,OACC,OACA,MACyC;EACzC,OAAO,KAAKA,KAAK,IAChB,OACC,WACA,cAAc;GACb;GACA,MAAM,EACL,SAAS;IACR,GAAI,KAAKA,KAAK,SAAS,QACpB,EAAE,QAAQ,KAAKA,KAAK,SAAS,MAAM,IACnC,CAAC;IACJ,GAAG;GACJ,EACD;GACA,cAAc;EACf,CAAC,IACD,SAAS,KAAK,OAChB;CACD;CAgBA,MAAM,iBACL,OACA,MAC6D;EAC7D,MAAM,cACL,MAAM,gBAAgB,KAAKA,KAAK,SAAS;EA2B1C,OAAO,SATK,qBACX,MAlBoB,KAAKA,KAAK,QAC9B;GAAE,GAAG;GAAM,kBAAkB,MAAM,oBAAoB;EAAK,IAC3D,WACA,cAAc;GACb;GACA,MAAM,EACL,SAAS;IACR,GAAI,KAAKA,KAAK,SAAS,QACpB,EAAE,QAAQ,KAAKA,KAAK,SAAS,MAAM,IACnC,CAAC;IACJ,GAAG;GACJ,EACD;GACA,cAAc;EACf,CAAC,IACD,SAAS,IACX,IAGE,SAAS,KAAK,kBACd,MAAM,sBAAsB;GAC5B,SAAS,KAAK;GACd;EACD,IACA,MAAM,UAAU,IAEC,GAAG,WAAW;CACjC;CASA,OACC,IACA,OACA,MACyC;EACzC,OAAO,KAAKA,KAAK,IAChB,OACC,WACA,cAAc;GACb;GACA,MAAM,EAAE,YAAY,GAAG;GACvB,MAAM,EAAE,SAAS,MAAM;GACvB,cAAc;EACf,CAAC,IACD,SAAS,KAAK,OAChB;CACD;CAQA,OACC,IACA,MACyC;EACzC,OAAO,KAAKA,KAAK,IAChB,OACC,WACA,cAAc;GACb;GACA,MAAM,EAAE,YAAY,GAAG;GACvB,cAAc;EACf,CAAC,IACD,SAAS,KAAK,OAChB;CACD;CAaA,MAAM,SACL,OACA,MACmC;EACnC,MAAM,cACL,MAAM,gBAAgB,KAAKA,KAAK,SAAS;EAC1C,MAAM,YAAY,MAAM,aAAa,KAAKA,KAAK,SAAS;EACxD,IAAI,CAAC,WACJ,OAAO,SACN,IACC,IAAI,UACH,8CACA,QACD,CACD,GACA,WACD;EAED,OAAO,KAAKA,KAAK,IAChB,OACC,WACA,6BAA6B;GAC5B;GACA,MAAM,EAAE,eAAe,UAAU;GACjC,MAAM;IACL,oBAAoB,MAAM;IAC1B,aAAa,MAAM;GACpB;GACA,cAAc;EACf,CAAC,SACI,KAAA,CACP;CACD;CAeA,iBACC,OACA,MACmC;EACnC,OAAO,KAAKA,KAAK,IAChB,OACC,WACA,8BAA8B;GAC7B;GACA,MAAM;IACL,oBAAoB,MAAM;IAC1B,aAAa,MAAM;GACpB;GACA,cAAc;EACf,CAAC,SACI,KAAA,CACP;CACD;AACD"}

package/dist/neon/resources/roles.d.ts

@@ -0,0 +1,40 @@
+import { Role, RoleCreateRequest } from "../../client/types.gen.js";
+import { Outcome } from "../result.js";
+import { CallOptions, RequestContext } from "../context.js";
+
+//#region src/neon/resources/roles.d.ts
+type CreateInput = RoleCreateRequest["role"];
+/** Role resource (branch-scoped). */
+declare class Roles<DThrow extends boolean> {
+  #private;
+  constructor(ctx: RequestContext);
+  /** @apiCall GET /projects/{project_id}/branches/{branch_id}/roles */
+  list(projectId: string, branchId: string): Promise<Outcome<Role[], DThrow>>;
+  list<Throw extends boolean = DThrow>(projectId: string, branchId: string, opts: CallOptions<Throw>): Promise<Outcome<Role[], Throw>>;
+  /** @apiCall GET /projects/{project_id}/branches/{branch_id}/roles/{role_name} */
+  get(projectId: string, branchId: string, name: string): Promise<Outcome<Role, DThrow>>;
+  get<Throw extends boolean = DThrow>(projectId: string, branchId: string, name: string, opts: CallOptions<Throw>): Promise<Outcome<Role, Throw>>;
+  /** @apiCall POST /projects/{project_id}/branches/{branch_id}/roles */
+  create(projectId: string, branchId: string, input: CreateInput): Promise<Outcome<Role, DThrow>>;
+  create<Throw extends boolean = DThrow>(projectId: string, branchId: string, input: CreateInput, opts: CallOptions<Throw>): Promise<Outcome<Role, Throw>>;
+  /** @apiCall DELETE /projects/{project_id}/branches/{branch_id}/roles/{role_name} */
+  delete(projectId: string, branchId: string, name: string): Promise<Outcome<void, DThrow>>;
+  delete<Throw extends boolean = DThrow>(projectId: string, branchId: string, name: string, opts: CallOptions<Throw>): Promise<Outcome<void, Throw>>;
+  /**
+   * Reveal the role's password.
+   *
+   * @apiCall GET /projects/{project_id}/branches/{branch_id}/roles/{role_name}/reveal_password
+   */
+  password(projectId: string, branchId: string, name: string): Promise<Outcome<string, DThrow>>;
+  password<Throw extends boolean = DThrow>(projectId: string, branchId: string, name: string, opts: CallOptions<Throw>): Promise<Outcome<string, Throw>>;
+  /**
+   * Reset the role's password; the returned `Role` carries the new `password`.
+   *
+   * @apiCall POST /projects/{project_id}/branches/{branch_id}/roles/{role_name}/reset_password
+   */
+  resetPassword(projectId: string, branchId: string, name: string): Promise<Outcome<Role, DThrow>>;
+  resetPassword<Throw extends boolean = DThrow>(projectId: string, branchId: string, name: string, opts: CallOptions<Throw>): Promise<Outcome<Role, Throw>>;
+}
+//#endregion
+export { Roles };
+//# sourceMappingURL=roles.d.ts.map

package/dist/neon/resources/roles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"roles.d.ts","names":[],"sources":["../../../src/neon/resources/roles.ts"],"mappings":"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"}

package/dist/neon/resources/roles.js

@@ -0,0 +1,78 @@
+import { createProjectBranchRole, deleteProjectBranchRole, getProjectBranchRole, getProjectBranchRolePassword, listProjectBranchRoles, resetProjectBranchRolePassword } from "../../client/sdk.gen.js";
+//#region src/neon/resources/roles.ts
+/** Role resource (branch-scoped). */
+var Roles = class {
+	#ctx;
+	constructor(ctx) {
+		this.#ctx = ctx;
+	}
+	list(projectId, branchId, opts) {
+		return this.#ctx.run(opts, (client) => listProjectBranchRoles({
+			client,
+			path: {
+				project_id: projectId,
+				branch_id: branchId
+			},
+			throwOnError: false
+		}), (data) => data.roles);
+	}
+	get(projectId, branchId, name, opts) {
+		return this.#ctx.run(opts, (client) => getProjectBranchRole({
+			client,
+			path: {
+				project_id: projectId,
+				branch_id: branchId,
+				role_name: name
+			},
+			throwOnError: false
+		}), (data) => data.role);
+	}
+	create(projectId, branchId, input, opts) {
+		return this.#ctx.run(opts, (client) => createProjectBranchRole({
+			client,
+			path: {
+				project_id: projectId,
+				branch_id: branchId
+			},
+			body: { role: input },
+			throwOnError: false
+		}), (data) => data.role);
+	}
+	delete(projectId, branchId, name, opts) {
+		return this.#ctx.runVoid(opts, (client) => deleteProjectBranchRole({
+			client,
+			path: {
+				project_id: projectId,
+				branch_id: branchId,
+				role_name: name
+			},
+			throwOnError: false
+		}));
+	}
+	password(projectId, branchId, name, opts) {
+		return this.#ctx.run(opts, (client) => getProjectBranchRolePassword({
+			client,
+			path: {
+				project_id: projectId,
+				branch_id: branchId,
+				role_name: name
+			},
+			throwOnError: false
+		}), (data) => data.password);
+	}
+	resetPassword(projectId, branchId, name, opts) {
+		return this.#ctx.run(opts, (client) => resetProjectBranchRolePassword({
+			client,
+			path: {
+				project_id: projectId,
+				branch_id: branchId,
+				role_name: name
+			},
+			throwOnError: false
+		}), (data) => data.role);
+	}
+};
+//#endregion
+export { Roles };
+
+//# sourceMappingURL=roles.js.map

package/dist/neon/resources/roles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"roles.js","names":["#ctx"],"sources":["../../../src/neon/resources/roles.ts"],"sourcesContent":["import {\n\tcreateProjectBranchRole,\n\tdeleteProjectBranchRole,\n\tgetProjectBranchRole,\n\tgetProjectBranchRolePassword,\n\tlistProjectBranchRoles,\n\tresetProjectBranchRolePassword,\n} from \"../../client/sdk.gen.js\";\nimport type { Role, RoleCreateRequest } from \"../../client/types.gen.js\";\nimport type { CallOptions, RequestContext } from \"../context.js\";\nimport type { NeonResult, Outcome } from \"../result.js\";\n\ntype CreateInput = RoleCreateRequest[\"role\"];\n\n/** Role resource (branch-scoped). */\nexport class Roles<DThrow extends boolean> {\n\treadonly #ctx: RequestContext;\n\n\tconstructor(ctx: RequestContext) {\n\t\tthis.#ctx = ctx;\n\t}\n\n\t/** @apiCall GET /projects/{project_id}/branches/{branch_id}/roles */\n\tlist(projectId: string, branchId: string): Promise<Outcome<Role[], DThrow>>;\n\tlist<Throw extends boolean = DThrow>(\n\t\tprojectId: string,\n\t\tbranchId: string,\n\t\topts: CallOptions<Throw>,\n\t): Promise<Outcome<Role[], Throw>>;\n\tlist(\n\t\tprojectId: string,\n\t\tbranchId: string,\n\t\topts?: CallOptions,\n\t): Promise<Role[] | NeonResult<Role[]>> {\n\t\treturn this.#ctx.run(\n\t\t\topts,\n\t\t\t(client) =>\n\t\t\t\tlistProjectBranchRoles({\n\t\t\t\t\tclient,\n\t\t\t\t\tpath: { project_id: projectId, branch_id: branchId },\n\t\t\t\t\tthrowOnError: false,\n\t\t\t\t}),\n\t\t\t(data) => data.roles,\n\t\t);\n\t}\n\n\t/** @apiCall GET /projects/{project_id}/branches/{branch_id}/roles/{role_name} */\n\tget(\n\t\tprojectId: string,\n\t\tbranchId: string,\n\t\tname: string,\n\t): Promise<Outcome<Role, DThrow>>;\n\tget<Throw extends boolean = DThrow>(\n\t\tprojectId: string,\n\t\tbranchId: string,\n\t\tname: string,\n\t\topts: CallOptions<Throw>,\n\t): Promise<Outcome<Role, Throw>>;\n\tget(\n\t\tprojectId: string,\n\t\tbranchId: string,\n\t\tname: string,\n\t\topts?: CallOptions,\n\t): Promise<Role | NeonResult<Role>> {\n\t\treturn this.#ctx.run(\n\t\t\topts,\n\t\t\t(client) =>\n\t\t\t\tgetProjectBranchRole({\n\t\t\t\t\tclient,\n\t\t\t\t\tpath: {\n\t\t\t\t\t\tproject_id: projectId,\n\t\t\t\t\t\tbranch_id: branchId,\n\t\t\t\t\t\trole_name: name,\n\t\t\t\t\t},\n\t\t\t\t\tthrowOnError: false,\n\t\t\t\t}),\n\t\t\t(data) => data.role,\n\t\t);\n\t}\n\n\t/** @apiCall POST /projects/{project_id}/branches/{branch_id}/roles */\n\tcreate(\n\t\tprojectId: string,\n\t\tbranchId: string,\n\t\tinput: CreateInput,\n\t): Promise<Outcome<Role, DThrow>>;\n\tcreate<Throw extends boolean = DThrow>(\n\t\tprojectId: string,\n\t\tbranchId: string,\n\t\tinput: CreateInput,\n\t\topts: CallOptions<Throw>,\n\t): Promise<Outcome<Role, Throw>>;\n\tcreate(\n\t\tprojectId: string,\n\t\tbranchId: string,\n\t\tinput: CreateInput,\n\t\topts?: CallOptions,\n\t): Promise<Role | NeonResult<Role>> {\n\t\treturn this.#ctx.run(\n\t\t\topts,\n\t\t\t(client) =>\n\t\t\t\tcreateProjectBranchRole({\n\t\t\t\t\tclient,\n\t\t\t\t\tpath: { project_id: projectId, branch_id: branchId },\n\t\t\t\t\tbody: { role: input },\n\t\t\t\t\tthrowOnError: false,\n\t\t\t\t}),\n\t\t\t(data) => data.role,\n\t\t);\n\t}\n\n\t/** @apiCall DELETE /projects/{project_id}/branches/{branch_id}/roles/{role_name} */\n\tdelete(\n\t\tprojectId: string,\n\t\tbranchId: string,\n\t\tname: string,\n\t): Promise<Outcome<void, DThrow>>;\n\tdelete<Throw extends boolean = DThrow>(\n\t\tprojectId: string,\n\t\tbranchId: string,\n\t\tname: string,\n\t\topts: CallOptions<Throw>,\n\t): Promise<Outcome<void, Throw>>;\n\tdelete(\n\t\tprojectId: string,\n\t\tbranchId: string,\n\t\tname: string,\n\t\topts?: CallOptions,\n\t): Promise<void | NeonResult<void>> {\n\t\treturn this.#ctx.runVoid(opts, (client) =>\n\t\t\tdeleteProjectBranchRole({\n\t\t\t\tclient,\n\t\t\t\tpath: {\n\t\t\t\t\tproject_id: projectId,\n\t\t\t\t\tbranch_id: branchId,\n\t\t\t\t\trole_name: name,\n\t\t\t\t},\n\t\t\t\tthrowOnError: false,\n\t\t\t}),\n\t\t);\n\t}\n\n\t/**\n\t * Reveal the role's password.\n\t *\n\t * @apiCall GET /projects/{project_id}/branches/{branch_id}/roles/{role_name}/reveal_password\n\t */\n\tpassword(\n\t\tprojectId: string,\n\t\tbranchId: string,\n\t\tname: string,\n\t): Promise<Outcome<string, DThrow>>;\n\tpassword<Throw extends boolean = DThrow>(\n\t\tprojectId: string,\n\t\tbranchId: string,\n\t\tname: string,\n\t\topts: CallOptions<Throw>,\n\t): Promise<Outcome<string, Throw>>;\n\tpassword(\n\t\tprojectId: string,\n\t\tbranchId: string,\n\t\tname: string,\n\t\topts?: CallOptions,\n\t): Promise<string | NeonResult<string>> {\n\t\treturn this.#ctx.run(\n\t\t\topts,\n\t\t\t(client) =>\n\t\t\t\tgetProjectBranchRolePassword({\n\t\t\t\t\tclient,\n\t\t\t\t\tpath: {\n\t\t\t\t\t\tproject_id: projectId,\n\t\t\t\t\t\tbranch_id: branchId,\n\t\t\t\t\t\trole_name: name,\n\t\t\t\t\t},\n\t\t\t\t\tthrowOnError: false,\n\t\t\t\t}),\n\t\t\t(data) => data.password,\n\t\t);\n\t}\n\n\t/**\n\t * Reset the role's password; the returned `Role` carries the new `password`.\n\t *\n\t * @apiCall POST /projects/{project_id}/branches/{branch_id}/roles/{role_name}/reset_password\n\t */\n\tresetPassword(\n\t\tprojectId: string,\n\t\tbranchId: string,\n\t\tname: string,\n\t): Promise<Outcome<Role, DThrow>>;\n\tresetPassword<Throw extends boolean = DThrow>(\n\t\tprojectId: string,\n\t\tbranchId: string,\n\t\tname: string,\n\t\topts: CallOptions<Throw>,\n\t): Promise<Outcome<Role, Throw>>;\n\tresetPassword(\n\t\tprojectId: string,\n\t\tbranchId: string,\n\t\tname: string,\n\t\topts?: CallOptions,\n\t): Promise<Role | NeonResult<Role>> {\n\t\treturn this.#ctx.run(\n\t\t\topts,\n\t\t\t(client) =>\n\t\t\t\tresetProjectBranchRolePassword({\n\t\t\t\t\tclient,\n\t\t\t\t\tpath: {\n\t\t\t\t\t\tproject_id: projectId,\n\t\t\t\t\t\tbranch_id: branchId,\n\t\t\t\t\t\trole_name: name,\n\t\t\t\t\t},\n\t\t\t\t\tthrowOnError: false,\n\t\t\t\t}),\n\t\t\t(data) => data.role,\n\t\t);\n\t}\n}\n"],"mappings":";;;AAeA,IAAa,QAAb,MAA2C;CAC1C;CAEA,YAAY,KAAqB;EAChC,KAAKA,OAAO;CACb;CASA,KACC,WACA,UACA,MACuC;EACvC,OAAO,KAAKA,KAAK,IAChB,OACC,WACA,uBAAuB;GACtB;GACA,MAAM;IAAE,YAAY;IAAW,WAAW;GAAS;GACnD,cAAc;EACf,CAAC,IACD,SAAS,KAAK,KAChB;CACD;CAcA,IACC,WACA,UACA,MACA,MACmC;EACnC,OAAO,KAAKA,KAAK,IAChB,OACC,WACA,qBAAqB;GACpB;GACA,MAAM;IACL,YAAY;IACZ,WAAW;IACX,WAAW;GACZ;GACA,cAAc;EACf,CAAC,IACD,SAAS,KAAK,IAChB;CACD;CAcA,OACC,WACA,UACA,OACA,MACmC;EACnC,OAAO,KAAKA,KAAK,IAChB,OACC,WACA,wBAAwB;GACvB;GACA,MAAM;IAAE,YAAY;IAAW,WAAW;GAAS;GACnD,MAAM,EAAE,MAAM,MAAM;GACpB,cAAc;EACf,CAAC,IACD,SAAS,KAAK,IAChB;CACD;CAcA,OACC,WACA,UACA,MACA,MACmC;EACnC,OAAO,KAAKA,KAAK,QAAQ,OAAO,WAC/B,wBAAwB;GACvB;GACA,MAAM;IACL,YAAY;IACZ,WAAW;IACX,WAAW;GACZ;GACA,cAAc;EACf,CAAC,CACF;CACD;CAkBA,SACC,WACA,UACA,MACA,MACuC;EACvC,OAAO,KAAKA,KAAK,IAChB,OACC,WACA,6BAA6B;GAC5B;GACA,MAAM;IACL,YAAY;IACZ,WAAW;IACX,WAAW;GACZ;GACA,cAAc;EACf,CAAC,IACD,SAAS,KAAK,QAChB;CACD;CAkBA,cACC,WACA,UACA,MACA,MACmC;EACnC,OAAO,KAAKA,KAAK,IAChB,OACC,WACA,+BAA+B;GAC9B;GACA,MAAM;IACL,YAAY;IACZ,WAAW;IACX,WAAW;GACZ;GACA,cAAc;EACf,CAAC,IACD,SAAS,KAAK,IAChB;CACD;AACD"}

package/dist/neon/resources/snapshots.d.ts

@@ -0,0 +1,86 @@
+import { BackupSchedule, Branch, Snapshot, SnapshotUpdateRequest } from "../../client/types.gen.js";
+import { Outcome } from "../result.js";
+import { CallOptions, RequestContext } from "../context.js";
+
+//#region src/neon/resources/snapshots.d.ts
+type UpdateInput = SnapshotUpdateRequest["snapshot"];
+/**
+ * Inspect a freshly restored (not-yet-finalized) branch and decide whether to commit.
+ * Return `true` to finalize the restore, `false` to abort it.
+ */
+type RestorePreview = (branch: Branch) => boolean | Promise<boolean>;
+/** Options for {@link Snapshots.create} (point-in-time + naming). */
+interface CreateSnapshotInput {
+  /** A name for the snapshot. */
+  name?: string;
+  /** Take the snapshot at this timestamp (ISO 8601). Mutually exclusive with `lsn`. */
+  timestamp?: string;
+  /** Take the snapshot at this LSN. Mutually exclusive with `timestamp`. */
+  lsn?: string;
+  /** When the snapshot is automatically deleted (ISO 8601). */
+  expiresAt?: string;
+}
+/** Input for {@link Snapshots.restore}. */
+interface RestoreSnapshotInput {
+  /** Name for the restored branch. Auto-generated when omitted. */
+  name?: string;
+  /** Branch to restore onto. Defaults to the snapshot's source branch. */
+  targetBranchId?: string;
+  /**
+   * Finalize immediately (move computes onto the restored branch). Defaults to `true`
+   * when restoring as a new branch (nothing to clobber) and `false` when restoring
+   * **onto** an existing branch (`targetBranchId`), so you can preview before the swap.
+   * Ignored when `preview` is set (the preview flow always restores un-finalized first).
+   */
+  finalize?: boolean;
+  /**
+   * Transaction-style restore: receives the restored (un-finalized) branch; return `true`
+   * to finalize (commit) or `false` to abort. On abort the preview branch is deleted
+   * unless `keepOnAbort` is set. Either way `restore` resolves to the restored `Branch`.
+   */
+  preview?: RestorePreview;
+  /** Keep the preview branch when `preview` returns `false` (default: delete it). */
+  keepOnAbort?: boolean;
+}
+/** Snapshot resource. */
+declare class Snapshots<DThrow extends boolean> {
+  #private;
+  constructor(ctx: RequestContext);
+  /** @apiCall GET /projects/{project_id}/snapshots */
+  list(projectId: string): Promise<Outcome<Snapshot[], DThrow>>;
+  list<Throw extends boolean = DThrow>(projectId: string, opts: CallOptions<Throw>): Promise<Outcome<Snapshot[], Throw>>;
+  /** @apiCall POST /projects/{project_id}/branches/{branch_id}/snapshot */
+  create(projectId: string, branchId: string, input?: CreateSnapshotInput): Promise<Outcome<Snapshot, DThrow>>;
+  create<Throw extends boolean = DThrow>(projectId: string, branchId: string, input: CreateSnapshotInput | undefined, opts: CallOptions<Throw>): Promise<Outcome<Snapshot, Throw>>;
+  /** @apiCall PATCH /projects/{project_id}/snapshots/{snapshot_id} */
+  update(projectId: string, snapshotId: string, input: UpdateInput): Promise<Outcome<Snapshot, DThrow>>;
+  update<Throw extends boolean = DThrow>(projectId: string, snapshotId: string, input: UpdateInput, opts: CallOptions<Throw>): Promise<Outcome<Snapshot, Throw>>;
+  /** @apiCall DELETE /projects/{project_id}/snapshots/{snapshot_id} */
+  delete(projectId: string, snapshotId: string): Promise<Outcome<void, DThrow>>;
+  delete<Throw extends boolean = DThrow>(projectId: string, snapshotId: string, opts: CallOptions<Throw>): Promise<Outcome<void, Throw>>;
+  /**
+   * Restore a snapshot into a branch. Returns the restored branch.
+   *
+   * - **As a new branch** (no `targetBranchId`): finalizes by default — ready to use.
+   * - **Onto an existing branch** (`targetBranchId`): does **not** finalize by default,
+   *   so you can preview before the compute swap. Finish later with
+   *   `branches.finalizeRestore`, or pass a `preview` callback to do it transactionally.
+   *
+   * With `preview`, this restores un-finalized, runs your callback against the restored
+   * branch, then finalizes (commit) or deletes the preview branch (abort, unless
+   * `keepOnAbort`). Either way it resolves to the restored `Branch`.
+   *
+   * @apiCall POST /projects/{project_id}/snapshots/{snapshot_id}/restore
+   */
+  restore(projectId: string, snapshotId: string, input?: RestoreSnapshotInput): Promise<Outcome<Branch, DThrow>>;
+  restore<Throw extends boolean = DThrow>(projectId: string, snapshotId: string, input: RestoreSnapshotInput | undefined, opts: CallOptions<Throw>): Promise<Outcome<Branch, Throw>>;
+  /** @apiCall GET /projects/{project_id}/branches/{branch_id}/backup_schedule */
+  getSchedule(projectId: string, branchId: string): Promise<Outcome<BackupSchedule, DThrow>>;
+  getSchedule<Throw extends boolean = DThrow>(projectId: string, branchId: string, opts: CallOptions<Throw>): Promise<Outcome<BackupSchedule, Throw>>;
+  /** @apiCall PUT /projects/{project_id}/branches/{branch_id}/backup_schedule */
+  setSchedule(projectId: string, branchId: string, schedule: BackupSchedule): Promise<Outcome<void, DThrow>>;
+  setSchedule<Throw extends boolean = DThrow>(projectId: string, branchId: string, schedule: BackupSchedule, opts: CallOptions<Throw>): Promise<Outcome<void, Throw>>;
+}
+//#endregion
+export { CreateSnapshotInput, RestorePreview, RestoreSnapshotInput, Snapshots };
+//# sourceMappingURL=snapshots.d.ts.map

package/dist/neon/resources/snapshots.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshots.d.ts","names":[],"sources":["../../../src/neon/resources/snapshots.ts"],"mappings":"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"}

package/dist/neon/resources/snapshots.js

@@ -0,0 +1,125 @@
+import { err, finalize, ok } from "../result.js";
+import { createSnapshot, deleteProjectBranch, deleteSnapshot, finalizeRestoreBranch, getSnapshotSchedule, listSnapshots, restoreSnapshot, setSnapshotSchedule, updateSnapshot } from "../../client/sdk.gen.js";
+//#region src/neon/resources/snapshots.ts
+/** Snapshot resource. */
+var Snapshots = class {
+	#ctx;
+	constructor(ctx) {
+		this.#ctx = ctx;
+	}
+	list(projectId, opts) {
+		return this.#ctx.run(opts, (client) => listSnapshots({
+			client,
+			path: { project_id: projectId },
+			throwOnError: false
+		}), (data) => data.snapshots);
+	}
+	create(projectId, branchId, input, opts) {
+		return this.#ctx.run(opts, (client) => createSnapshot({
+			client,
+			path: {
+				project_id: projectId,
+				branch_id: branchId
+			},
+			query: {
+				name: input?.name,
+				timestamp: input?.timestamp,
+				lsn: input?.lsn,
+				expires_at: input?.expiresAt
+			},
+			throwOnError: false
+		}), (data) => data.snapshot);
+	}
+	update(projectId, snapshotId, input, opts) {
+		return this.#ctx.run(opts, (client) => updateSnapshot({
+			client,
+			path: {
+				project_id: projectId,
+				snapshot_id: snapshotId
+			},
+			body: { snapshot: input },
+			throwOnError: false
+		}), (data) => data.snapshot);
+	}
+	delete(projectId, snapshotId, opts) {
+		return this.#ctx.run(opts, (client) => deleteSnapshot({
+			client,
+			path: {
+				project_id: projectId,
+				snapshot_id: snapshotId
+			},
+			throwOnError: false
+		}), () => void 0);
+	}
+	async restore(projectId, snapshotId, input, opts) {
+		const shouldThrow = opts?.throwOnError ?? this.#ctx.defaults.throwOnError;
+		const preview = input?.preview;
+		const finalizeNow = preview ? false : input?.finalize ?? input?.targetBranchId === void 0;
+		const restored = await this.#ctx.execute({
+			...opts,
+			waitForReadiness: preview ? true : opts?.waitForReadiness
+		}, (client) => restoreSnapshot({
+			client,
+			path: {
+				project_id: projectId,
+				snapshot_id: snapshotId
+			},
+			body: {
+				name: input?.name,
+				target_branch_id: input?.targetBranchId,
+				finalize_restore: finalizeNow
+			},
+			throwOnError: false
+		}), (data) => data.branch);
+		if (restored.error || !preview) return finalize(restored, shouldThrow);
+		const branch = restored.data;
+		const step = await preview(branch) ? await this.#ctx.execute({
+			...opts,
+			waitForReadiness: true
+		}, (client) => finalizeRestoreBranch({
+			client,
+			path: {
+				project_id: projectId,
+				branch_id: branch.id
+			},
+			throwOnError: false
+		}), () => void 0) : input?.keepOnAbort ? ok(void 0) : await this.#ctx.execute({
+			...opts,
+			waitForReadiness: true
+		}, (client) => deleteProjectBranch({
+			client,
+			path: {
+				project_id: projectId,
+				branch_id: branch.id
+			},
+			throwOnError: false
+		}), () => void 0);
+		if (step.error) return finalize(err(step.error), shouldThrow);
+		return finalize(ok(branch), shouldThrow);
+	}
+	getSchedule(projectId, branchId, opts) {
+		return this.#ctx.run(opts, (client) => getSnapshotSchedule({
+			client,
+			path: {
+				project_id: projectId,
+				branch_id: branchId
+			},
+			throwOnError: false
+		}), (data) => data);
+	}
+	setSchedule(projectId, branchId, schedule, opts) {
+		return this.#ctx.run(opts, (client) => setSnapshotSchedule({
+			client,
+			path: {
+				project_id: projectId,
+				branch_id: branchId
+			},
+			body: schedule,
+			throwOnError: false
+		}), () => void 0);
+	}
+};
+//#endregion
+export { Snapshots };
+
+//# sourceMappingURL=snapshots.js.map

package/dist/neon/resources/snapshots.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshots.js","names":["#ctx"],"sources":["../../../src/neon/resources/snapshots.ts"],"sourcesContent":["import {\n\tcreateSnapshot,\n\tdeleteProjectBranch,\n\tdeleteSnapshot,\n\tfinalizeRestoreBranch,\n\tgetSnapshotSchedule,\n\tlistSnapshots,\n\trestoreSnapshot,\n\tsetSnapshotSchedule,\n\tupdateSnapshot,\n} from \"../../client/sdk.gen.js\";\nimport type {\n\tBackupSchedule,\n\tBranch,\n\tSnapshot,\n\tSnapshotUpdateRequest,\n} from \"../../client/types.gen.js\";\nimport type { CallOptions, RequestContext } from \"../context.js\";\nimport { err, finalize, type NeonResult, type Outcome, ok } from \"../result.js\";\n\ntype UpdateInput = SnapshotUpdateRequest[\"snapshot\"];\n\n/**\n * Inspect a freshly restored (not-yet-finalized) branch and decide whether to commit.\n * Return `true` to finalize the restore, `false` to abort it.\n */\nexport type RestorePreview = (branch: Branch) => boolean | Promise<boolean>;\n\n/** Options for {@link Snapshots.create} (point-in-time + naming). */\nexport interface CreateSnapshotInput {\n\t/** A name for the snapshot. */\n\tname?: string;\n\t/** Take the snapshot at this timestamp (ISO 8601). Mutually exclusive with `lsn`. */\n\ttimestamp?: string;\n\t/** Take the snapshot at this LSN. Mutually exclusive with `timestamp`. */\n\tlsn?: string;\n\t/** When the snapshot is automatically deleted (ISO 8601). */\n\texpiresAt?: string;\n}\n\n/** Input for {@link Snapshots.restore}. */\nexport interface RestoreSnapshotInput {\n\t/** Name for the restored branch. Auto-generated when omitted. */\n\tname?: string;\n\t/** Branch to restore onto. Defaults to the snapshot's source branch. */\n\ttargetBranchId?: string;\n\t/**\n\t * Finalize immediately (move computes onto the restored branch). Defaults to `true`\n\t * when restoring as a new branch (nothing to clobber) and `false` when restoring\n\t * **onto** an existing branch (`targetBranchId`), so you can preview before the swap.\n\t * Ignored when `preview` is set (the preview flow always restores un-finalized first).\n\t */\n\tfinalize?: boolean;\n\t/**\n\t * Transaction-style restore: receives the restored (un-finalized) branch; return `true`\n\t * to finalize (commit) or `false` to abort. On abort the preview branch is deleted\n\t * unless `keepOnAbort` is set. Either way `restore` resolves to the restored `Branch`.\n\t */\n\tpreview?: RestorePreview;\n\t/** Keep the preview branch when `preview` returns `false` (default: delete it). */\n\tkeepOnAbort?: boolean;\n}\n\n/** Snapshot resource. */\nexport class Snapshots<DThrow extends boolean> {\n\treadonly #ctx: RequestContext;\n\n\tconstructor(ctx: RequestContext) {\n\t\tthis.#ctx = ctx;\n\t}\n\n\t/** @apiCall GET /projects/{project_id}/snapshots */\n\tlist(projectId: string): Promise<Outcome<Snapshot[], DThrow>>;\n\tlist<Throw extends boolean = DThrow>(\n\t\tprojectId: string,\n\t\topts: CallOptions<Throw>,\n\t): Promise<Outcome<Snapshot[], Throw>>;\n\tlist(\n\t\tprojectId: string,\n\t\topts?: CallOptions,\n\t): Promise<Snapshot[] | NeonResult<Snapshot[]>> {\n\t\treturn this.#ctx.run(\n\t\t\topts,\n\t\t\t(client) =>\n\t\t\t\tlistSnapshots({\n\t\t\t\t\tclient,\n\t\t\t\t\tpath: { project_id: projectId },\n\t\t\t\t\tthrowOnError: false,\n\t\t\t\t}),\n\t\t\t(data) => data.snapshots,\n\t\t);\n\t}\n\n\t/** @apiCall POST /projects/{project_id}/branches/{branch_id}/snapshot */\n\tcreate(\n\t\tprojectId: string,\n\t\tbranchId: string,\n\t\tinput?: CreateSnapshotInput,\n\t): Promise<Outcome<Snapshot, DThrow>>;\n\tcreate<Throw extends boolean = DThrow>(\n\t\tprojectId: string,\n\t\tbranchId: string,\n\t\tinput: CreateSnapshotInput | undefined,\n\t\topts: CallOptions<Throw>,\n\t): Promise<Outcome<Snapshot, Throw>>;\n\tcreate(\n\t\tprojectId: string,\n\t\tbranchId: string,\n\t\tinput?: CreateSnapshotInput,\n\t\topts?: CallOptions,\n\t): Promise<Snapshot | NeonResult<Snapshot>> {\n\t\treturn this.#ctx.run(\n\t\t\topts,\n\t\t\t(client) =>\n\t\t\t\tcreateSnapshot({\n\t\t\t\t\tclient,\n\t\t\t\t\tpath: { project_id: projectId, branch_id: branchId },\n\t\t\t\t\tquery: {\n\t\t\t\t\t\tname: input?.name,\n\t\t\t\t\t\ttimestamp: input?.timestamp,\n\t\t\t\t\t\tlsn: input?.lsn,\n\t\t\t\t\t\texpires_at: input?.expiresAt,\n\t\t\t\t\t},\n\t\t\t\t\tthrowOnError: false,\n\t\t\t\t}),\n\t\t\t(data) => data.snapshot,\n\t\t);\n\t}\n\n\t/** @apiCall PATCH /projects/{project_id}/snapshots/{snapshot_id} */\n\tupdate(\n\t\tprojectId: string,\n\t\tsnapshotId: string,\n\t\tinput: UpdateInput,\n\t): Promise<Outcome<Snapshot, DThrow>>;\n\tupdate<Throw extends boolean = DThrow>(\n\t\tprojectId: string,\n\t\tsnapshotId: string,\n\t\tinput: UpdateInput,\n\t\topts: CallOptions<Throw>,\n\t): Promise<Outcome<Snapshot, Throw>>;\n\tupdate(\n\t\tprojectId: string,\n\t\tsnapshotId: string,\n\t\tinput: UpdateInput,\n\t\topts?: CallOptions,\n\t): Promise<Snapshot | NeonResult<Snapshot>> {\n\t\treturn this.#ctx.run(\n\t\t\topts,\n\t\t\t(client) =>\n\t\t\t\tupdateSnapshot({\n\t\t\t\t\tclient,\n\t\t\t\t\tpath: { project_id: projectId, snapshot_id: snapshotId },\n\t\t\t\t\tbody: { snapshot: input },\n\t\t\t\t\tthrowOnError: false,\n\t\t\t\t}),\n\t\t\t(data) => data.snapshot,\n\t\t);\n\t}\n\n\t/** @apiCall DELETE /projects/{project_id}/snapshots/{snapshot_id} */\n\tdelete(\n\t\tprojectId: string,\n\t\tsnapshotId: string,\n\t): Promise<Outcome<void, DThrow>>;\n\tdelete<Throw extends boolean = DThrow>(\n\t\tprojectId: string,\n\t\tsnapshotId: string,\n\t\topts: CallOptions<Throw>,\n\t): Promise<Outcome<void, Throw>>;\n\tdelete(\n\t\tprojectId: string,\n\t\tsnapshotId: string,\n\t\topts?: CallOptions,\n\t): Promise<void | NeonResult<void>> {\n\t\treturn this.#ctx.run(\n\t\t\topts,\n\t\t\t(client) =>\n\t\t\t\tdeleteSnapshot({\n\t\t\t\t\tclient,\n\t\t\t\t\tpath: { project_id: projectId, snapshot_id: snapshotId },\n\t\t\t\t\tthrowOnError: false,\n\t\t\t\t}),\n\t\t\t() => undefined,\n\t\t);\n\t}\n\n\t/**\n\t * Restore a snapshot into a branch. Returns the restored branch.\n\t *\n\t * - **As a new branch** (no `targetBranchId`): finalizes by default — ready to use.\n\t * - **Onto an existing branch** (`targetBranchId`): does **not** finalize by default,\n\t *   so you can preview before the compute swap. Finish later with\n\t *   `branches.finalizeRestore`, or pass a `preview` callback to do it transactionally.\n\t *\n\t * With `preview`, this restores un-finalized, runs your callback against the restored\n\t * branch, then finalizes (commit) or deletes the preview branch (abort, unless\n\t * `keepOnAbort`). Either way it resolves to the restored `Branch`.\n\t *\n\t * @apiCall POST /projects/{project_id}/snapshots/{snapshot_id}/restore\n\t */\n\trestore(\n\t\tprojectId: string,\n\t\tsnapshotId: string,\n\t\tinput?: RestoreSnapshotInput,\n\t): Promise<Outcome<Branch, DThrow>>;\n\trestore<Throw extends boolean = DThrow>(\n\t\tprojectId: string,\n\t\tsnapshotId: string,\n\t\tinput: RestoreSnapshotInput | undefined,\n\t\topts: CallOptions<Throw>,\n\t): Promise<Outcome<Branch, Throw>>;\n\tasync restore(\n\t\tprojectId: string,\n\t\tsnapshotId: string,\n\t\tinput?: RestoreSnapshotInput,\n\t\topts?: CallOptions,\n\t): Promise<Branch | NeonResult<Branch>> {\n\t\tconst shouldThrow =\n\t\t\topts?.throwOnError ?? this.#ctx.defaults.throwOnError;\n\t\tconst preview = input?.preview;\n\t\t// New branch → finalize by default; onto existing → preview-first by default.\n\t\t// The preview flow always restores un-finalized so it can inspect first.\n\t\tconst finalizeNow = preview\n\t\t\t? false\n\t\t\t: (input?.finalize ?? input?.targetBranchId === undefined);\n\n\t\tconst restored = await this.#ctx.execute(\n\t\t\t{\n\t\t\t\t...opts,\n\t\t\t\twaitForReadiness: preview ? true : opts?.waitForReadiness,\n\t\t\t},\n\t\t\t(client) =>\n\t\t\t\trestoreSnapshot({\n\t\t\t\t\tclient,\n\t\t\t\t\tpath: { project_id: projectId, snapshot_id: snapshotId },\n\t\t\t\t\tbody: {\n\t\t\t\t\t\tname: input?.name,\n\t\t\t\t\t\ttarget_branch_id: input?.targetBranchId,\n\t\t\t\t\t\tfinalize_restore: finalizeNow,\n\t\t\t\t\t},\n\t\t\t\t\tthrowOnError: false,\n\t\t\t\t}),\n\t\t\t(data) => data.branch,\n\t\t);\n\t\tif (restored.error || !preview) {\n\t\t\treturn finalize(restored, shouldThrow);\n\t\t}\n\n\t\tconst branch = restored.data;\n\t\tconst commit = await preview(branch);\n\t\tconst step = commit\n\t\t\t? await this.#ctx.execute(\n\t\t\t\t\t{ ...opts, waitForReadiness: true },\n\t\t\t\t\t(client) =>\n\t\t\t\t\t\tfinalizeRestoreBranch({\n\t\t\t\t\t\t\tclient,\n\t\t\t\t\t\t\tpath: {\n\t\t\t\t\t\t\t\tproject_id: projectId,\n\t\t\t\t\t\t\t\tbranch_id: branch.id,\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\tthrowOnError: false,\n\t\t\t\t\t\t}),\n\t\t\t\t\t() => undefined,\n\t\t\t\t)\n\t\t\t: input?.keepOnAbort\n\t\t\t\t? ok(undefined)\n\t\t\t\t: await this.#ctx.execute(\n\t\t\t\t\t\t{ ...opts, waitForReadiness: true },\n\t\t\t\t\t\t(client) =>\n\t\t\t\t\t\t\tdeleteProjectBranch({\n\t\t\t\t\t\t\t\tclient,\n\t\t\t\t\t\t\t\tpath: {\n\t\t\t\t\t\t\t\t\tproject_id: projectId,\n\t\t\t\t\t\t\t\t\tbranch_id: branch.id,\n\t\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t\tthrowOnError: false,\n\t\t\t\t\t\t\t}),\n\t\t\t\t\t\t() => undefined,\n\t\t\t\t\t);\n\n\t\tif (step.error) return finalize(err<Branch>(step.error), shouldThrow);\n\t\treturn finalize(ok(branch), shouldThrow);\n\t}\n\n\t/** @apiCall GET /projects/{project_id}/branches/{branch_id}/backup_schedule */\n\tgetSchedule(\n\t\tprojectId: string,\n\t\tbranchId: string,\n\t): Promise<Outcome<BackupSchedule, DThrow>>;\n\tgetSchedule<Throw extends boolean = DThrow>(\n\t\tprojectId: string,\n\t\tbranchId: string,\n\t\topts: CallOptions<Throw>,\n\t): Promise<Outcome<BackupSchedule, Throw>>;\n\tgetSchedule(\n\t\tprojectId: string,\n\t\tbranchId: string,\n\t\topts?: CallOptions,\n\t): Promise<BackupSchedule | NeonResult<BackupSchedule>> {\n\t\treturn this.#ctx.run(\n\t\t\topts,\n\t\t\t(client) =>\n\t\t\t\tgetSnapshotSchedule({\n\t\t\t\t\tclient,\n\t\t\t\t\tpath: { project_id: projectId, branch_id: branchId },\n\t\t\t\t\tthrowOnError: false,\n\t\t\t\t}),\n\t\t\t(data) => data,\n\t\t);\n\t}\n\n\t/** @apiCall PUT /projects/{project_id}/branches/{branch_id}/backup_schedule */\n\tsetSchedule(\n\t\tprojectId: string,\n\t\tbranchId: string,\n\t\tschedule: BackupSchedule,\n\t): Promise<Outcome<void, DThrow>>;\n\tsetSchedule<Throw extends boolean = DThrow>(\n\t\tprojectId: string,\n\t\tbranchId: string,\n\t\tschedule: BackupSchedule,\n\t\topts: CallOptions<Throw>,\n\t): Promise<Outcome<void, Throw>>;\n\tsetSchedule(\n\t\tprojectId: string,\n\t\tbranchId: string,\n\t\tschedule: BackupSchedule,\n\t\topts?: CallOptions,\n\t): Promise<void | NeonResult<void>> {\n\t\treturn this.#ctx.run(\n\t\t\topts,\n\t\t\t(client) =>\n\t\t\t\tsetSnapshotSchedule({\n\t\t\t\t\tclient,\n\t\t\t\t\tpath: { project_id: projectId, branch_id: branchId },\n\t\t\t\t\tbody: schedule,\n\t\t\t\t\tthrowOnError: false,\n\t\t\t\t}),\n\t\t\t() => undefined,\n\t\t);\n\t}\n}\n"],"mappings":"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"}