alchemy 2.0.0-beta.30 → 2.0.0-beta.31

package/lib/Neon/Migrations.js

@@ -0,0 +1,100 @@
+import * as Data from "effect/Data";
+import * as Effect from "effect/Effect";
+import * as Redacted from "effect/Redacted";
+import { Client } from "pg";
+export class PgError extends Data.TaggedError("PgError") {
+}
+/**
+ * Strip query-string SSL flags from a Neon connection URI. Neon's URIs
+ * include `sslmode=require` and `channel_binding=require`, which trigger
+ * a deprecation warning from `pg-connection-string`:
+ *
+ *   SECURITY WARNING: The SSL modes 'prefer', 'require', and 'verify-ca'
+ *   are treated as aliases for 'verify-full'.
+ *
+ * We control SSL programmatically via the `ssl` option below, so removing
+ * the conflicting query params silences the warning without changing the
+ * effective behavior.
+ */
+const stripSslQueryParams = (uri) => {
+    try {
+        const url = new URL(uri);
+        url.searchParams.delete("sslmode");
+        url.searchParams.delete("channel_binding");
+        return url.toString();
+    }
+    catch {
+        return uri;
+    }
+};
+const withClient = (connectionUri, fn) => Effect.tryPromise({
+    try: async () => {
+        const client = new Client({
+            connectionString: stripSslQueryParams(Redacted.value(connectionUri)),
+            ssl: { rejectUnauthorized: false },
+        });
+        await client.connect();
+        try {
+            return await fn(client);
+        }
+        finally {
+            await client.end().catch(() => { });
+        }
+    },
+    catch: (cause) => new PgError({
+        message: cause instanceof Error ? cause.message : String(cause),
+        cause,
+    }),
+});
+const ensureMigrationsTable = (client, migrationsTable) => client.query(`CREATE TABLE IF NOT EXISTS "${migrationsTable}" (
+       id TEXT PRIMARY KEY,
+       name TEXT NOT NULL,
+       applied_at TIMESTAMPTZ NOT NULL DEFAULT now()
+     );`);
+const getApplied = (client, migrationsTable) => client
+    .query(`SELECT name FROM "${migrationsTable}";`)
+    .then((r) => new Set(r.rows.map((row) => row.name)));
+const getNextSeq = (client, migrationsTable) => client
+    .query(`SELECT id FROM "${migrationsTable}";`)
+    .then((r) => {
+    let max = 0;
+    for (const { id } of r.rows) {
+        if (/^\d+$/.test(id)) {
+            max = Math.max(max, Number.parseInt(id, 10));
+        }
+    }
+    return max + 1;
+});
+/**
+ * Apply pending Postgres migrations in order, tracked in `migrationsTable`.
+ * Each migration runs inside a transaction together with the bookkeeping
+ * INSERT so partial application is impossible.
+ */
+export const applyMigrations = (options) => withClient(options.connectionUri, async (client) => {
+    await ensureMigrationsTable(client, options.migrationsTable);
+    const applied = await getApplied(client, options.migrationsTable);
+    let nextSeq = await getNextSeq(client, options.migrationsTable);
+    for (const file of options.migrationsFiles) {
+        if (applied.has(file.id))
+            continue;
+        const migrationId = nextSeq.toString().padStart(5, "0");
+        nextSeq += 1;
+        await client.query("BEGIN");
+        try {
+            await client.query(file.sql);
+            await client.query(`INSERT INTO "${options.migrationsTable}" (id, name) VALUES ($1, $2);`, [migrationId, file.id]);
+            await client.query("COMMIT");
+        }
+        catch (err) {
+            await client.query("ROLLBACK").catch(() => { });
+            throw err;
+        }
+    }
+});
+/**
+ * Run a single SQL script against the database (used for `importFiles`).
+ */
+export const runSql = (connectionUri, sql) => withClient(connectionUri, async (client) => {
+    await client.query(sql);
+});
+//# sourceMappingURL=Migrations.js.map

package/lib/Neon/Migrations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Migrations.js","sourceRoot":"","sources":["../../src/Neon/Migrations.ts"],"names":[],"mappings":"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"}

package/lib/Neon/NeonEnvironment.d.ts

@@ -0,0 +1,10 @@
+import * as Config from "effect/Config";
+import * as Context from "effect/Context";
+import * as Layer from "effect/Layer";
+import { type NeonResolvedCredentials } from "./AuthProvider.ts";
+declare const NeonEnvironment_base: Context.ServiceClass<NeonEnvironment, "Neon::NeonEnvironment", NeonResolvedCredentials>;
+export declare class NeonEnvironment extends NeonEnvironment_base {
+}
+export declare const fromProfile: () => Layer.Layer<NeonEnvironment, import("effect/PlatformError").PlatformError | Config.ConfigError | import("../Auth/AuthProvider.ts").AuthError, import("effect/FileSystem").FileSystem | import("../index.ts").AuthProviders>;
+export {};
+//# sourceMappingURL=NeonEnvironment.d.ts.map

package/lib/Neon/NeonEnvironment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NeonEnvironment.d.ts","sourceRoot":"","sources":["../../src/Neon/NeonEnvironment.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAC;AAE1C,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAGtC,OAAO,EAGL,KAAK,uBAAuB,EAC7B,MAAM,mBAAmB,CAAC;;AAE3B,qBAAa,eAAgB,SAAQ,oBAGT;CAAG;AAE/B,eAAO,MAAM,WAAW,mOAarB,CAAC"}

package/lib/Neon/NeonEnvironment.js

@@ -0,0 +1,17 @@
+import * as Config from "effect/Config";
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import { getAuthProvider } from "../Auth/AuthProvider.js";
+import { ALCHEMY_PROFILE, loadOrConfigure } from "../Auth/Profile.js";
+import { NEON_AUTH_PROVIDER_NAME, } from "./AuthProvider.js";
+export class NeonEnvironment extends Context.Service()("Neon::NeonEnvironment") {
+}
+export const fromProfile = () => Layer.effect(NeonEnvironment, Effect.gen(function* () {
+    const auth = yield* getAuthProvider(NEON_AUTH_PROVIDER_NAME);
+    const profileName = yield* ALCHEMY_PROFILE;
+    const ci = yield* Config.boolean("CI").pipe(Config.withDefault(false));
+    const config = yield* loadOrConfigure(auth, profileName, { ci });
+    return yield* auth.read(profileName, config);
+}));
+//# sourceMappingURL=NeonEnvironment.js.map

package/lib/Neon/NeonEnvironment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NeonEnvironment.js","sourceRoot":"","sources":["../../src/Neon/NeonEnvironment.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAC;AAC1C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACtE,OAAO,EACL,uBAAuB,GAGxB,MAAM,mBAAmB,CAAC;AAE3B,MAAM,OAAO,eAAgB,SAAQ,OAAO,CAAC,OAAO,EAGjD,CAAC,uBAAuB,CAAC;CAAG;AAE/B,MAAM,CAAC,MAAM,WAAW,GAAG,GAAG,EAAE,CAC9B,KAAK,CAAC,MAAM,CACV,eAAe,EACf,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,eAAe,CAGjC,uBAAuB,CAAC,CAAC;IAC3B,MAAM,WAAW,GAAG,KAAK,CAAC,CAAC,eAAe,CAAC;IAC3C,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC;IACvE,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,eAAe,CAAC,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;IACjE,OAAO,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,MAAwB,CAAC,CAAC;AACjE,CAAC,CAAC,CACH,CAAC"}

package/lib/Neon/PostgresOrigin.d.ts

@@ -0,0 +1,28 @@
+import * as Redacted from "effect/Redacted";
+/**
+ * The shape `Cloudflare.Hyperdrive` and other Postgres consumers accept
+ * as `origin`. Materialized on `Neon.Project` and `Neon.Branch` so callers
+ * can wire databases into Hyperdrive directly:
+ *
+ * ```typescript
+ * const branch = yield* Neon.Branch("preview", { project });
+ * const hd = yield* Cloudflare.Hyperdrive("preview-hd", {
+ *   origin: branch.origin,
+ * });
+ * ```
+ */
+export type PostgresOrigin = {
+    scheme: "postgres" | "postgresql" | "mysql";
+    host: string;
+    port: number;
+    database: string;
+    user: string;
+    password: Redacted.Redacted<string>;
+};
+/**
+ * Parse a Postgres connection URI into the structured origin shape.
+ * Used to derive `branch.origin` / `project.origin` from the API
+ * response's `connectionUri`.
+ */
+export declare const parsePostgresOrigin: (uri: string) => PostgresOrigin;
+//# sourceMappingURL=PostgresOrigin.d.ts.map

package/lib/Neon/PostgresOrigin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PostgresOrigin.d.ts","sourceRoot":"","sources":["../../src/Neon/PostgresOrigin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,iBAAiB,CAAC;AAE5C;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,EAAE,UAAU,GAAG,YAAY,GAAG,OAAO,CAAC;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;CACrC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,GAAI,KAAK,MAAM,KAAG,cAYjD,CAAC"}

package/lib/Neon/PostgresOrigin.js

@@ -0,0 +1,19 @@
+import * as Redacted from "effect/Redacted";
+/**
+ * Parse a Postgres connection URI into the structured origin shape.
+ * Used to derive `branch.origin` / `project.origin` from the API
+ * response's `connectionUri`.
+ */
+export const parsePostgresOrigin = (uri) => {
+    const url = new URL(uri);
+    const scheme = url.protocol === "postgresql:" ? "postgresql" : "postgres";
+    return {
+        scheme,
+        host: url.hostname,
+        port: url.port ? Number(url.port) : 5432,
+        database: url.pathname.replace(/^\//, ""),
+        user: decodeURIComponent(url.username),
+        password: Redacted.make(decodeURIComponent(url.password)),
+    };
+};
+//# sourceMappingURL=PostgresOrigin.js.map

package/lib/Neon/PostgresOrigin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PostgresOrigin.js","sourceRoot":"","sources":["../../src/Neon/PostgresOrigin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,iBAAiB,CAAC;AAuB5C;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,GAAW,EAAkB,EAAE;IACjE,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;IACzB,MAAM,MAAM,GACV,GAAG,CAAC,QAAQ,KAAK,aAAa,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,UAAU,CAAC;IAC7D,OAAO;QACL,MAAM;QACN,IAAI,EAAE,GAAG,CAAC,QAAQ;QAClB,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI;QACxC,QAAQ,EAAE,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;QACzC,IAAI,EAAE,kBAAkB,CAAC,GAAG,CAAC,QAAQ,CAAC;QACtC,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;KAC1D,CAAC;AACJ,CAAC,CAAC"}

package/lib/Neon/Project.d.ts

@@ -0,0 +1,138 @@
+import * as Provider from "../Provider.ts";
+import { Resource } from "../Resource.ts";
+import { type PostgresOrigin } from "./PostgresOrigin.ts";
+import type { Providers } from "./Providers.ts";
+export type NeonRegion = "aws-us-east-1" | "aws-us-east-2" | "aws-us-west-2" | "aws-eu-central-1" | "aws-eu-west-2" | "aws-ap-southeast-1" | "aws-ap-southeast-2" | "aws-sa-east-1" | "azure-eastus2" | "azure-westus3" | "azure-gwc";
+export type NeonPgVersion = 14 | 15 | 16 | 17 | 18;
+export type ProjectProps = {
+    /**
+     * Name of the project. If omitted, a unique name is generated from
+     * `${app}-${stage}-${id}`.
+     */
+    name?: string;
+    /**
+     * Region where the project is provisioned. Cannot be changed after
+     * creation.
+     *
+     * @default "aws-us-east-1"
+     */
+    region?: NeonRegion;
+    /**
+     * Postgres version. Cannot be changed after creation.
+     *
+     * @default 17
+     */
+    pgVersion?: NeonPgVersion;
+    /**
+     * Name of the default branch. Defaults to Neon's default ("main"). Cannot
+     * be changed after creation.
+     */
+    defaultBranchName?: string;
+    /**
+     * Name of the default role created with the project. Defaults to
+     * `neondb_owner`. Cannot be changed after creation.
+     */
+    roleName?: string;
+    /**
+     * Name of the default database created with the project. Defaults to
+     * `neondb`. Cannot be changed after creation.
+     */
+    databaseName?: string;
+    /**
+     * Number of seconds of WAL history retained on the project for
+     * point-in-time branching/restore.
+     *
+     * @default 86400
+     */
+    historyRetentionSeconds?: number;
+    /**
+     * Optional Neon organization ID. Cannot be changed after creation.
+     */
+    orgId?: string;
+    /**
+     * Directory containing `.sql` migration files. Files are sorted by their
+     * numeric prefix (e.g. `0001_init.sql`) and applied in order against the
+     * default branch's primary database.
+     */
+    migrationsDir?: string;
+    /**
+     * Name of the table used to track applied migrations.
+     *
+     * @default "neon_migrations"
+     */
+    migrationsTable?: string;
+    /**
+     * Paths to additional `.sql` files to apply after migrations. Each file
+     * is hashed; only files whose contents change are re-applied on
+     * subsequent deploys.
+     */
+    importFiles?: string[];
+};
+export type Project = Resource<"Neon.Project", ProjectProps, {
+    projectId: string;
+    projectName: string;
+    region: NeonRegion;
+    pgVersion: NeonPgVersion;
+    defaultBranchId: string;
+    defaultBranchName: string;
+    databaseName: string;
+    roleName: string;
+    /** Postgres connection URI for the default branch + database. */
+    connectionUri: string;
+    /** Pooled connection URI (uses pgbouncer). */
+    pooledConnectionUri: string;
+    /**
+     * Parsed connection components ready to feed into a Postgres origin
+     * — e.g. `Cloudflare.Hyperdrive`'s `origin` prop. Points at the
+     * direct (non-pooled) endpoint, which is the recommended target
+     * when fronting Neon with another pooler like Hyperdrive.
+     */
+    origin: PostgresOrigin;
+    historyRetentionSeconds: number;
+    migrationsDir: string | undefined;
+    migrationsTable: string | undefined;
+    migrationsHashes: Record<string, string>;
+    importHashes: Record<string, string>;
+}, never, Providers>;
+/**
+ * A Neon serverless Postgres project.
+ *
+ * Creating a project also provisions the project's default branch (named
+ * "main" by default), an initial role, an initial database, and a
+ * read-write compute endpoint, exposed as `connectionUri`.
+ *
+ * @section Creating a Project
+ * @example Basic project
+ * ```typescript
+ * const project = yield* Neon.Project("my-project");
+ * ```
+ *
+ * @example Project with explicit region and PG version
+ * ```typescript
+ * const project = yield* Neon.Project("my-project", {
+ *   region: "aws-eu-central-1",
+ *   pgVersion: 17,
+ * });
+ * ```
+ *
+ * @section Migrations and seed data
+ * @example Apply migrations and seed files
+ * ```typescript
+ * const project = yield* Neon.Project("my-project", {
+ *   migrationsDir: "./migrations",
+ *   importFiles: ["./seed/users.sql"],
+ * });
+ * ```
+ *
+ * @section Branching
+ * @example Create a branch off the project's default branch
+ * ```typescript
+ * const project = yield* Neon.Project("my-project");
+ * const dev = yield* Neon.Branch("dev-branch", { project });
+ * ```
+ *
+ * @see https://neon.tech/docs/manage/projects/
+ */
+export declare const Project: import("../Resource.ts").ResourceClass<Project>;
+export declare const ProjectProvider: () => import("effect/Layer").Layer<Provider.Provider<Project>, never, import("effect/Path").Path | import("effect/FileSystem").FileSystem | import("effect/unstable/http/HttpClient").HttpClient | import("../Stage.ts").Stage | import("../Stack.ts").Stack | import("@distilled.cloud/neon/Credentials").Credentials>;
+//# sourceMappingURL=Project.d.ts.map

package/lib/Neon/Project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Project.d.ts","sourceRoot":"","sources":["../../src/Neon/Project.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG1C,OAAO,EAAuB,KAAK,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC/E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAGhD,MAAM,MAAM,UAAU,GAClB,eAAe,GACf,eAAe,GACf,eAAe,GACf,kBAAkB,GAClB,eAAe,GACf,oBAAoB,GACpB,oBAAoB,GACpB,eAAe,GACf,eAAe,GACf,eAAe,GACf,WAAW,CAAC;AAEhB,MAAM,MAAM,aAAa,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;AAMnD,MAAM,MAAM,YAAY,GAAG;IACzB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;OAKG;IACH,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB;;;;OAIG;IACH,SAAS,CAAC,EAAE,aAAa,CAAC;IAC1B;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;;OAKG;IACH,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,OAAO,GAAG,QAAQ,CAC5B,cAAc,EACd,YAAY,EACZ;IACE,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,UAAU,CAAC;IACnB,SAAS,EAAE,aAAa,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,iEAAiE;IACjE,aAAa,EAAE,MAAM,CAAC;IACtB,8CAA8C;IAC9C,mBAAmB,EAAE,MAAM,CAAC;IAC5B;;;;;OAKG;IACH,MAAM,EAAE,cAAc,CAAC;IACvB,uBAAuB,EAAE,MAAM,CAAC;IAChC,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,eAAe,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACtC,EACD,KAAK,EACL,SAAS,CACV,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,eAAO,MAAM,OAAO,iDAAoC,CAAC;AAwCzD,eAAO,MAAM,eAAe,yTAsNzB,CAAC"}

package/lib/Neon/Project.js

@@ -0,0 +1,304 @@
+import * as Effect from "effect/Effect";
+import * as Redacted from "effect/Redacted";
+import { isResolved } from "../Diff.js";
+import { createPhysicalName } from "../PhysicalName.js";
+import * as Provider from "../Provider.js";
+import { Resource } from "../Resource.js";
+import * as api from "./api.js";
+import { applyMigrations, runSql } from "./Migrations.js";
+import { parsePostgresOrigin } from "./PostgresOrigin.js";
+import { listSqlFiles, readSqlFile } from "./SqlFile.js";
+const DEFAULT_MIGRATIONS_TABLE = "neon_migrations";
+const DEFAULT_REGION = "aws-us-east-1";
+const DEFAULT_PG_VERSION = 17;
+/**
+ * A Neon serverless Postgres project.
+ *
+ * Creating a project also provisions the project's default branch (named
+ * "main" by default), an initial role, an initial database, and a
+ * read-write compute endpoint, exposed as `connectionUri`.
+ *
+ * @section Creating a Project
+ * @example Basic project
+ * ```typescript
+ * const project = yield* Neon.Project("my-project");
+ * ```
+ *
+ * @example Project with explicit region and PG version
+ * ```typescript
+ * const project = yield* Neon.Project("my-project", {
+ *   region: "aws-eu-central-1",
+ *   pgVersion: 17,
+ * });
+ * ```
+ *
+ * @section Migrations and seed data
+ * @example Apply migrations and seed files
+ * ```typescript
+ * const project = yield* Neon.Project("my-project", {
+ *   migrationsDir: "./migrations",
+ *   importFiles: ["./seed/users.sql"],
+ * });
+ * ```
+ *
+ * @section Branching
+ * @example Create a branch off the project's default branch
+ * ```typescript
+ * const project = yield* Neon.Project("my-project");
+ * const dev = yield* Neon.Branch("dev-branch", { project });
+ * ```
+ *
+ * @see https://neon.tech/docs/manage/projects/
+ */
+export const Project = Resource("Neon.Project");
+const getRoleName = (creation) => creation.roles.find((r) => !r.protected)?.name ?? creation.roles[0]?.name;
+const getDatabaseName = (creation) => creation.databases[0]?.name ?? "neondb";
+const buildConnectionUri = (uri, pooledHost) => {
+    const url = new URL(uri);
+    const pooledUrl = new URL(uri);
+    pooledUrl.host = pooledHost;
+    return { uri: url.toString(), pooled: pooledUrl.toString() };
+};
+const resolveConnection = (projectId, branchId, databaseName, roleName) => Effect.gen(function* () {
+    const direct = yield* api.getConnectionUri(projectId, {
+        branch_id: branchId,
+        database_name: databaseName,
+        role_name: roleName,
+        pooled: false,
+    });
+    const pooled = yield* api.getConnectionUri(projectId, {
+        branch_id: branchId,
+        database_name: databaseName,
+        role_name: roleName,
+        pooled: true,
+    });
+    return { uri: direct.uri, pooled: pooled.uri };
+});
+export const ProjectProvider = () => Provider.effect(Project, Effect.gen(function* () {
+    const rootDir = process.cwd();
+    const createProjectName = (id, name) => Effect.gen(function* () {
+        return name ?? (yield* createPhysicalName({ id }));
+    });
+    return {
+        stables: ["projectId", "defaultBranchId"],
+        diff: Effect.fn(function* ({ id, olds = {}, news = {}, output }) {
+            if (!isResolved(news))
+                return undefined;
+            const name = yield* createProjectName(id, news.name);
+            const oldName = output?.projectName
+                ? output.projectName
+                : yield* createProjectName(id, olds.name);
+            if (oldName !== name ||
+                (news.region ?? DEFAULT_REGION) !==
+                    (output?.region ?? olds.region ?? DEFAULT_REGION) ||
+                (news.pgVersion ?? DEFAULT_PG_VERSION) !==
+                    (output?.pgVersion ?? olds.pgVersion ?? DEFAULT_PG_VERSION) ||
+                (news.defaultBranchName ?? output?.defaultBranchName) !==
+                    output?.defaultBranchName) {
+                return { action: "replace" };
+            }
+            if ((news.historyRetentionSeconds ?? 86400) !==
+                (output?.historyRetentionSeconds ?? 86400)) {
+                return { action: "update" };
+            }
+            if (news.migrationsDir) {
+                const newHashes = yield* hashMigrations(news.migrationsDir);
+                if (!recordsEqual(newHashes, output?.migrationsHashes ?? {})) {
+                    return { action: "update" };
+                }
+                if ((news.migrationsTable ?? DEFAULT_MIGRATIONS_TABLE) !==
+                    (output?.migrationsTable ?? DEFAULT_MIGRATIONS_TABLE)) {
+                    return { action: "update" };
+                }
+            }
+            if (news.importFiles?.length) {
+                const newHashes = yield* hashImports(news.importFiles, rootDir);
+                if (!recordsEqual(newHashes, output?.importHashes ?? {})) {
+                    return { action: "update" };
+                }
+            }
+            return undefined;
+        }),
+        read: Effect.fn(function* ({ id, output, olds }) {
+            if (output?.projectId) {
+                return yield* api.getProject(output.projectId).pipe(Effect.map(({ project }) => ({
+                    ...output,
+                    projectName: project.name,
+                    historyRetentionSeconds: project.history_retention_seconds,
+                })), Effect.catchTag("ProjectNotFound", () => Effect.succeed(undefined)));
+            }
+            const name = yield* createProjectName(id, olds?.name);
+            const matches = yield* api.findProjectByName(name);
+            const match = matches[0];
+            if (!match)
+                return undefined;
+            const branches = yield* api.listProjectBranches(match.id, {
+                search: olds?.defaultBranchName ?? "main",
+            });
+            const defaultBranch = branches.branches.find((b) => b.default) ?? branches.branches[0];
+            if (!defaultBranch)
+                return undefined;
+            const databases = yield* api.listProjectBranchDatabases(match.id, defaultBranch.id);
+            const db = databases.databases[0];
+            if (!db)
+                return undefined;
+            const conn = yield* resolveConnection(match.id, defaultBranch.id, db.name, db.owner_name);
+            return {
+                projectId: match.id,
+                projectName: match.name,
+                region: match.region_id,
+                pgVersion: match.pg_version,
+                defaultBranchId: defaultBranch.id,
+                defaultBranchName: defaultBranch.name,
+                databaseName: db.name,
+                roleName: db.owner_name,
+                connectionUri: conn.uri,
+                pooledConnectionUri: conn.pooled,
+                origin: parsePostgresOrigin(conn.uri),
+                historyRetentionSeconds: match.history_retention_seconds,
+                migrationsDir: olds?.migrationsDir,
+                migrationsTable: olds?.migrationsTable,
+                migrationsHashes: {},
+                importHashes: {},
+            };
+        }),
+        reconcile: Effect.fn(function* ({ id, news = {}, output }) {
+            // Ensure — when no prior output exists we create the project
+            // (and let `read` upstream decide adoption); otherwise update
+            // the mutable scalar fields on the existing project.
+            const projectInfo = output
+                ? yield* api
+                    .updateProject(output.projectId, {
+                    name: news.name,
+                    history_retention_seconds: news.historyRetentionSeconds,
+                })
+                    .pipe(Effect.map((r) => ({
+                    projectId: output.projectId,
+                    projectName: r.project.name,
+                    region: output.region,
+                    pgVersion: output.pgVersion,
+                    defaultBranchId: output.defaultBranchId,
+                    defaultBranchName: output.defaultBranchName,
+                    databaseName: output.databaseName,
+                    roleName: output.roleName,
+                    connectionUri: output.connectionUri,
+                    pooledConnectionUri: output.pooledConnectionUri,
+                    origin: output.origin,
+                    historyRetentionSeconds: r.project.history_retention_seconds ??
+                        output.historyRetentionSeconds,
+                })))
+                : yield* Effect.gen(function* () {
+                    const name = yield* createProjectName(id, news.name);
+                    const created = yield* api.createProject({
+                        name,
+                        region_id: news.region,
+                        pg_version: news.pgVersion,
+                        default_branch: {
+                            name: news.defaultBranchName,
+                            role_name: news.roleName,
+                            database_name: news.databaseName,
+                        },
+                        history_retention_seconds: news.historyRetentionSeconds,
+                        org_id: news.orgId,
+                    });
+                    yield* api.waitForOperations(created.operations);
+                    const branchId = created.branch.id;
+                    const databaseName = getDatabaseName(created);
+                    const roleName = getRoleName(created) ?? "neondb_owner";
+                    const conn = yield* resolveConnection(created.project.id, branchId, databaseName, roleName);
+                    return {
+                        projectId: created.project.id,
+                        projectName: created.project.name,
+                        region: created.project.region_id,
+                        pgVersion: created.project.pg_version,
+                        defaultBranchId: branchId,
+                        defaultBranchName: created.branch.name,
+                        databaseName,
+                        roleName,
+                        connectionUri: conn.uri,
+                        pooledConnectionUri: conn.pooled,
+                        origin: parsePostgresOrigin(conn.uri),
+                        historyRetentionSeconds: created.project.history_retention_seconds ?? 86400,
+                    };
+                });
+            const connectionUri = Redacted.make(projectInfo.connectionUri);
+            const migrationsTable = news.migrationsTable ??
+                output?.migrationsTable ??
+                DEFAULT_MIGRATIONS_TABLE;
+            const migrationsHashes = news.migrationsDir
+                ? yield* runMigrations(connectionUri, news.migrationsDir, migrationsTable)
+                : (output?.migrationsHashes ?? {});
+            const importHashes = news.importFiles?.length
+                ? yield* runImports(connectionUri, news.importFiles, rootDir, output?.importHashes ?? {})
+                : {};
+            return {
+                ...projectInfo,
+                migrationsDir: news.migrationsDir,
+                migrationsTable: news.migrationsDir ? migrationsTable : undefined,
+                migrationsHashes,
+                importHashes,
+            };
+        }),
+        delete: Effect.fn(function* ({ output }) {
+            yield* api.deleteProject(output.projectId);
+        }),
+    };
+}));
+const runMigrations = (connectionUri, migrationsDir, migrationsTable) => Effect.gen(function* () {
+    const files = yield* listSqlFiles(migrationsDir);
+    if (files.length > 0) {
+        yield* applyMigrations({
+            connectionUri,
+            migrationsTable,
+            migrationsFiles: files,
+        });
+    }
+    const hashes = {};
+    for (const file of files)
+        hashes[file.id] = file.hash;
+    return hashes;
+});
+const runImports = (connectionUri, importFiles, rootDir, previous) => Effect.gen(function* () {
+    const hashes = { ...previous };
+    for (const filePath of importFiles) {
+        const file = yield* readSqlFile(rootDir, filePath);
+        if (previous[filePath] === file.hash) {
+            hashes[filePath] = file.hash;
+            continue;
+        }
+        yield* runSql(connectionUri, file.sql);
+        hashes[filePath] = file.hash;
+    }
+    const tracked = new Set(importFiles);
+    for (const key of Object.keys(hashes)) {
+        if (!tracked.has(key))
+            delete hashes[key];
+    }
+    return hashes;
+});
+const hashMigrations = (migrationsDir) => listSqlFiles(migrationsDir).pipe(Effect.map((files) => {
+    const hashes = {};
+    for (const file of files)
+        hashes[file.id] = file.hash;
+    return hashes;
+}));
+const hashImports = (importFiles, rootDir) => Effect.gen(function* () {
+    const hashes = {};
+    for (const filePath of importFiles) {
+        const file = yield* readSqlFile(rootDir, filePath);
+        hashes[filePath] = file.hash;
+    }
+    return hashes;
+});
+const recordsEqual = (a, b) => {
+    const aKeys = Object.keys(a);
+    const bKeys = Object.keys(b);
+    if (aKeys.length !== bKeys.length)
+        return false;
+    for (const k of aKeys) {
+        if (a[k] !== b[k])
+            return false;
+    }
+    return true;
+};
+//# sourceMappingURL=Project.js.map