@alchemy.run/planetscale 0.0.0-stage → 2.0.0-beta.84

package/lib/MySQL/MySQLDatabase.js

@@ -0,0 +1,294 @@
+import { diffMigrations, migrationsAttrs, migrationsInputOf, stampedOf, } from "@alchemy.run/sql/Migrations";
+import { hashImports } from "@alchemy.run/sql/SqlFile";
+import * as planetscale from "@distilled.cloud/planetscale";
+import { Credentials } from "@distilled.cloud/planetscale/Credentials";
+import { havePropsChanged, isResolved } from "alchemy/Diff";
+import { createPhysicalName } from "alchemy/PhysicalName";
+import * as Provider from "alchemy/Provider";
+import { Resource } from "alchemy/Resource";
+import { recordsEqual } from "alchemy/Util/equal";
+import * as Effect from "effect/Effect";
+import * as Stream from "effect/Stream";
+import { deleteUnprotectedDatabase, PlanetscaleConflict, replaceDatabase, waitForBranchReady, waitForDatabaseReady, } from "../Util.js";
+import { ensureMySQLProductionBranchClusterSize, observeDefaultKeyspaceReplicas, } from "./MySQLClusterSize.js";
+import { runMySQLImports, runMySQLMigrations } from "./MySQLMigrations.js";
+/** @resource */
+export const MySQLDatabase = Resource("Planetscale.MySQLDatabase");
+export const MySQLDatabaseProvider = () => Provider.succeed(MySQLDatabase, {
+    stables: ["id", "organization", "region"],
+    diff: Effect.fn(function* ({ news, olds, output }) {
+        if (!isResolved(news))
+            return undefined;
+        // Database names are rename-mutable (reconcile folds `new_name`
+        // into the settings sync), so `name` cannot live in the
+        // provider-level stables. Almost no update is a rename though —
+        // for those, advertise `name` as stable on the update so
+        // downstream consumers (branches, passwords) still resolve
+        // `database.name` at plan time instead of seeing `undefined` and
+        // falsely planning a replacement. The name only changes when the
+        // `name` prop itself changes: an explicit name renames iff it
+        // differs from the observed name, and an omitted name is
+        // engine-generated deterministically (stable across updates).
+        const nameIsStable = output?.name !== undefined &&
+            (news.name !== undefined ? news.name === output.name : olds?.name === undefined);
+        const stables = nameIsStable ? ["id", "organization", "region", "name"] : undefined;
+        if (news.region?.slug !== undefined &&
+            output?.region?.slug !== undefined &&
+            news.region.slug !== output.region.slug) {
+            return yield* replaceDatabase(news, output, "region");
+        }
+        // Replicas reconcile in place via a keyspace resize — never a
+        // replacement. Diff against the observed keyspace replica count so
+        // an adopted database whose live state already matches plans no-op.
+        if (news.replicas !== undefined && news.replicas !== (output?.replicas ?? olds.replicas)) {
+            return { action: "update", stables };
+        }
+        if (yield* diffMigrations({ news, output })) {
+            return { action: "update", stables };
+        }
+        if (news.importFiles?.length) {
+            const newHashes = yield* hashImports(news.importFiles, yield* rootDir);
+            if (!recordsEqual(newHashes, output?.importHashes ?? {})) {
+                return { action: "update", stables };
+            }
+        }
+        // Remaining prop changes (rename, settings, clusterSize, …) are
+        // in-place updates. Decide them here instead of falling back to
+        // the engine's default deep-compare so the conditional `name`
+        // stable above is attached — the default path uses the
+        // provider-level stables, which strip `name` from downstream plan
+        // resolution.
+        if (havePropsChanged(olds, news)) {
+            return { action: "update", stables };
+        }
+        // Nothing changed. Still advertise the conditional `name` stable so
+        // a `--force` deploy (which upgrades this noop to an update) keeps
+        // `name` resolvable downstream instead of falsely replacing
+        // consumers such as roles and passwords (#1832).
+        return stables ? { action: "noop", stables } : undefined;
+    }),
+    read: Effect.fn(function* ({ id, output, olds }) {
+        const { organization } = yield* yield* Credentials;
+        const databaseName = output?.name ?? (yield* createDatabaseName(id, olds?.name));
+        return yield* planetscale
+            .getDatabase({
+            organization,
+            database: databaseName,
+        })
+            .pipe(Effect.flatMap(Effect.fn(function* (data) {
+            if (data.kind !== "mysql") {
+                return yield* new PlanetscaleConflict({
+                    message: `Planetscale database "${data.name}" has kind "${data.kind}" but this resource ` +
+                        `is a MySQLDatabase. Use Planetscale.${data.kind === "postgresql" ? "PostgresDatabase" : data.kind}() instead, ` +
+                        `or delete the existing database and retry.`,
+                });
+            }
+            // Observe the default keyspace's live replica configuration
+            // so adopted databases diff against reality.
+            const replicas = yield* observeDefaultKeyspaceReplicas(organization, data.name, data.default_branch ?? "main");
+            return {
+                id: data.id,
+                name: data.name,
+                organization,
+                state: data.state,
+                defaultBranch: data.default_branch ?? "main",
+                replicas,
+                plan: data.plan ?? "hobby",
+                createdAt: data.created_at,
+                updatedAt: data.updated_at,
+                htmlUrl: data.html_url,
+                region: { slug: data.region.slug },
+                migrationsDir: output?.migrationsDir ?? (olds && migrationsInputOf(olds))?.dir,
+                migrationsTable: output?.migrationsTable ?? (olds && migrationsInputOf(olds))?.table,
+                migrationsHashes: output?.migrationsHashes ?? {},
+                importHashes: output?.importHashes ?? {},
+                clusterSize: output?.clusterSize ?? "",
+                requireApprovalForDeploy: data.require_approval_for_deploy ?? false,
+                restrictBranchRegion: data.restrict_branch_region ?? false,
+                insightsRawQueries: data.insights_raw_queries ?? false,
+                productionBranchWebConsole: data.production_branch_web_console ?? false,
+                deletionProtection: data.deletion_protected ?? false,
+                automaticMigrations: data.automatic_migrations ?? false,
+                migrationFramework: data.migration_framework ?? undefined,
+                migrationTableName: data.migration_table_name ?? undefined,
+                allowDataBranching: data.allow_data_branching ?? false,
+                allowForeignKeyConstraints: data.foreign_keys_enabled ?? false,
+            };
+        })), Effect.catchTag("NotFound", () => Effect.succeed(undefined)));
+    }),
+    reconcile: Effect.fn(function* ({ id, news, output, session }) {
+        const { organization } = yield* yield* Credentials;
+        const newName = yield* createDatabaseName(id, news.name);
+        const clusterSize = news.clusterSize;
+        // Observe — read live state under either the cached name (rename
+        // / refresh) or the freshly-derived name (greenfield). Observing
+        // unconditionally absorbs the race between `read` and `reconcile`
+        // — if a foreign actor (or a previously-failed-to-persist
+        // create) produced a database under the desired name in the
+        // meantime, we'll find it here and skip the duplicate create.
+        // Adoption routing has already been gated by `read` returning
+        // `Unowned`, so by the time we reach reconcile any observed
+        // database is fair game.
+        const observedName = output?.name ?? newName;
+        let observed = yield* planetscale
+            .getDatabase({
+            organization,
+            database: observedName,
+        })
+            .pipe(Effect.catchTag("NotFound", () => Effect.succeed(undefined)));
+        // Ensure — if missing, create.
+        if (!observed) {
+            yield* session.note("Creating database...");
+            // Note: the API rejects the `replicas` param for mysql databases;
+            // replicas are converged below via the keyspace resize lifecycle.
+            observed = yield* planetscale.createDatabase({
+                organization,
+                name: newName,
+                region: news.region?.slug,
+                kind: "mysql",
+                cluster_size: clusterSize,
+            });
+        }
+        // Wait for the database to finish provisioning before any
+        // downstream sync runs. PlanetScale reports `state: "pending"`
+        // for a while after createDatabase returns, during which branch
+        // operations on this database (including our own settings PATCH)
+        // race against the provisioning fiber.
+        yield* waitForDatabaseReady(organization, observed.name, session);
+        if (observed.kind !== "mysql") {
+            return yield* new PlanetscaleConflict({
+                message: `Planetscale database "${observed.name}" has kind "${observed.kind}" but this resource ` +
+                    `is a MySQLDatabase. Use Planetscale.${observed.kind === "postgresql" ? "PostgresDatabase" : observed.kind}() instead, ` +
+                    `or delete the existing database and retry.`,
+            });
+        }
+        // Sync — ensure a non-`main` default branch exists before
+        // referencing it via `default_branch`. The branch is created
+        // empty (no cluster size yet); we'll size it below.
+        if (news.defaultBranch && news.defaultBranch !== "main") {
+            yield* waitForDatabaseReady(organization, observed.name, session);
+            const branchExists = yield* planetscale
+                .getBranch({
+                organization,
+                database: observed.name,
+                branch: news.defaultBranch,
+            })
+                .pipe(Effect.map(() => true), Effect.catchTag("NotFound", () => Effect.succeed(false)));
+            if (!branchExists) {
+                yield* planetscale.createBranch({
+                    organization,
+                    database: observed.name,
+                    name: news.defaultBranch,
+                    parent_branch: "main",
+                    // create branch with cluster size to skip resizing when promoting the branch
+                    cluster_size: clusterSize,
+                });
+            }
+        }
+        // Sync settings — `updateSettings` is upsert-shaped, so we can
+        // call it with the full desired payload on every reconcile.
+        const updated = yield* planetscale.updateDatabaseSettings({
+            organization,
+            database: observed.name,
+            new_name: newName !== observed.name ? newName : undefined,
+            automatic_migrations: news.automaticMigrations,
+            migration_framework: news.migrationFramework,
+            migration_table_name: news.migrationTableName,
+            allow_foreign_key_constraints: news.allowForeignKeyConstraints,
+            allow_data_branching: news.allowDataBranching,
+            require_approval_for_deploy: news.requireApprovalForDeploy,
+            restrict_branch_region: news.restrictBranchRegion,
+            insights_raw_queries: news.insightsRawQueries,
+            production_branch_web_console: news.productionBranchWebConsole,
+            deletion_protected: news.deletionProtection,
+            default_branch: news.defaultBranch,
+        });
+        // Sync cluster size and replicas on the active default branch —
+        // both converge in place via PlanetScale's keyspace resize
+        // lifecycle, diffed against the observed default keyspace.
+        const branch = news.defaultBranch ?? updated.default_branch ?? "main";
+        const keyspace = yield* ensureMySQLProductionBranchClusterSize(organization, updated.name, branch, news.clusterSize, news.replicas);
+        const migrationTarget = {
+            organization,
+            database: updated.name,
+            branch,
+        };
+        const migrationsInput = migrationsInputOf(news);
+        if (migrationsInput || news.importFiles?.length) {
+            yield* waitForBranchReady(organization, updated.name, branch, session);
+        }
+        const migrations = migrationsInput
+            ? yield* runMySQLMigrations(migrationTarget, migrationsInput, stampedOf(output))
+            : undefined;
+        const importHashes = news.importFiles?.length
+            ? yield* runMySQLImports(migrationTarget, news.importFiles, yield* rootDir, output?.importHashes ?? {})
+            : {};
+        return {
+            id: updated.id,
+            name: updated.name,
+            organization,
+            state: updated.state,
+            defaultBranch: updated.default_branch ?? branch,
+            plan: updated.plan ?? output?.plan ?? "hobby",
+            createdAt: updated.created_at,
+            updatedAt: updated.updated_at,
+            htmlUrl: updated.html_url,
+            region: { slug: updated.region.slug },
+            clusterSize,
+            replicas: keyspace.replicas,
+            ...migrationsAttrs({ input: migrationsInput, run: migrations, output }),
+            importHashes,
+            requireApprovalForDeploy: updated.require_approval_for_deploy ?? false,
+            restrictBranchRegion: updated.restrict_branch_region ?? false,
+            insightsRawQueries: updated.insights_raw_queries ?? false,
+            productionBranchWebConsole: updated.production_branch_web_console ?? false,
+            deletionProtection: updated.deletion_protected ?? false,
+            automaticMigrations: updated.automatic_migrations ?? false,
+            migrationFramework: updated.migration_framework ?? undefined,
+            migrationTableName: updated.migration_table_name ?? undefined,
+            allowDataBranching: updated.allow_data_branching ?? false,
+            allowForeignKeyConstraints: updated.foreign_keys_enabled ?? false,
+        };
+    }),
+    delete: Effect.fn(function* ({ output }) {
+        yield* deleteUnprotectedDatabase(output.organization, output.name);
+    }),
+    list: Effect.fn(function* () {
+        const { organization } = yield* yield* Credentials;
+        return yield* planetscale.listDatabases.pages({ organization }).pipe(Stream.runCollect, Effect.map((chunk) => Array.from(chunk).flatMap((page) => page.data
+            .filter((db) => db.kind === "mysql")
+            .map((data) => ({
+            id: data.id,
+            name: data.name,
+            organization,
+            state: data.state,
+            defaultBranch: data.default_branch ?? "main",
+            plan: data.plan ?? "hobby",
+            createdAt: data.created_at,
+            updatedAt: data.updated_at,
+            htmlUrl: data.html_url,
+            region: { slug: data.region.slug },
+            migrationsDir: undefined,
+            migrationsTable: undefined,
+            migrationsHashes: {},
+            importHashes: {},
+            clusterSize: "",
+            replicas: undefined,
+            requireApprovalForDeploy: data.require_approval_for_deploy ?? false,
+            restrictBranchRegion: data.restrict_branch_region ?? false,
+            insightsRawQueries: data.insights_raw_queries ?? false,
+            productionBranchWebConsole: data.production_branch_web_console ?? false,
+            deletionProtection: data.deletion_protected ?? false,
+            automaticMigrations: data.automatic_migrations ?? false,
+            migrationFramework: data.migration_framework ?? undefined,
+            migrationTableName: data.migration_table_name ?? undefined,
+            allowDataBranching: data.allow_data_branching ?? false,
+            allowForeignKeyConstraints: data.foreign_keys_enabled ?? false,
+        })))));
+    }),
+});
+const createDatabaseName = (id, name) => Effect.gen(function* () {
+    return name ?? (yield* createPhysicalName({ id, lowercase: true, maxLength: 63 }));
+});
+const rootDir = Effect.sync(() => process.cwd());
+//# sourceMappingURL=MySQLDatabase.js.map

package/lib/MySQL/MySQLDatabase.js.map

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

package/lib/MySQL/MySQLMigrations.d.ts

@@ -0,0 +1,24 @@
+import { type NormalizedMigrationsInput, type StampedMigrationsState } from "@alchemy.run/sql/Migrations";
+import * as ps from "@distilled.cloud/planetscale";
+import * as Effect from "effect/Effect";
+declare const MySQLMigrationError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "Planetscale::MySQLMigrationError";
+} & Readonly<A>;
+export declare class MySQLMigrationError extends MySQLMigrationError_base<{
+    message: string;
+    cause?: unknown;
+}> {
+}
+export interface MySQLMigrationTarget {
+    organization: string;
+    database: string;
+    branch: string;
+}
+/**
+ * PlanetScale MySQL's migration adaptation is exactly this: the shared
+ * pipeline with a temp-password-scoped mysql2 connection as its executor.
+ */
+export declare const runMySQLMigrations: (target: MySQLMigrationTarget, input: NormalizedMigrationsInput, stamped: StampedMigrationsState) => Effect.Effect<import("@alchemy.run/sql/Migrations").MigrationRun, import("@alchemy.run/sql/Migrations").DrizzleV0LayoutError | MySQLMigrationError | ps.CreatePasswordError | import("@alchemy.run/sql/Migrations").MigrationApplyError, import("effect/FileSystem").FileSystem | import("effect/Path").Path | ps.PlanetScaleOpContext>;
+export declare const runMySQLImports: (target: MySQLMigrationTarget, importFiles: ReadonlyArray<string>, rootDir: string, previous: Record<string, string>) => Effect.Effect<Record<string, string>, MySQLMigrationError | import("effect/PlatformError").PlatformError | ps.CreatePasswordError, import("effect/FileSystem").FileSystem | import("effect/Path").Path | ps.PlanetScaleOpContext>;
+export {};
+//# sourceMappingURL=MySQLMigrations.d.ts.map

package/lib/MySQL/MySQLMigrations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MySQLMigrations.d.ts","sourceRoot":"","sources":["../../src/MySQL/MySQLMigrations.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,yBAAyB,EAC9B,KAAK,sBAAsB,EAC5B,MAAM,6BAA6B,CAAC;AAErC,OAAO,KAAK,EAAE,MAAM,8BAA8B,CAAC;AAEnD,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;;;;AAiBxC,qBAAa,mBAAoB,SAAQ,yBAAqD;IAC5F,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,CAAC;CAAG;AAEL,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,eAAO,MAAM,kBAAkB,WACrB,oBAAoB,SACrB,yBAAyB,WACvB,sBAAsB,4UAO7B,CAAC;AAEL,eAAO,MAAM,eAAe,WAClB,oBAAoB,eACf,aAAa,CAAC,MAAM,CAAC,WACzB,MAAM,YACL,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,sOAkB9B,CAAC"}

package/lib/MySQL/MySQLMigrations.js

@@ -0,0 +1,106 @@
+import { makeMySQLMigrationExecutor, runMigrations, } from "@alchemy.run/sql/Migrations";
+import { readSqlFile, splitSqlStatements } from "@alchemy.run/sql/SqlFile";
+import * as ps from "@distilled.cloud/planetscale";
+import * as Data from "effect/Data";
+import * as Effect from "effect/Effect";
+import * as Redacted from "effect/Redacted";
+import * as Schedule from "effect/Schedule";
+const MIGRATION_PASSWORD_TTL_SECONDS = 600;
+// `mysql2` is an optional peer dependency — loaded lazily so importing the
+// Planetscale provider never requires the driver unless migrations run.
+const importMysql = () => import("mysql2/promise").catch((cause) => {
+    throw new Error("Failed to load the 'mysql2' driver. Install the optional peer dependency 'mysql2' to run Planetscale MySQL migrations.", { cause });
+});
+export class MySQLMigrationError extends Data.TaggedError("Planetscale::MySQLMigrationError") {
+}
+/**
+ * PlanetScale MySQL's migration adaptation is exactly this: the shared
+ * pipeline with a temp-password-scoped mysql2 connection as its executor.
+ */
+export const runMySQLMigrations = (target, input, stamped) => runMigrations({
+    input,
+    stamped,
+    withExecutor: (apply) => withMySQLConnection(target, (connection) => apply(makeMySQLMigrationExecutor(connection))),
+});
+export const runMySQLImports = (target, 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* runMySQLSql(target, 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 runMySQLSql = (target, sql) => withMySQLConnection(target, (connection) => Effect.gen(function* () {
+    for (const statement of splitSqlStatements(sql)) {
+        yield* mysqlQuery(connection, statement);
+    }
+}));
+const withMySQLConnection = (target, use) => withTemporaryMySQLPassword(target, (password) => Effect.acquireUseRelease(Effect.tryPromise({
+    try: async () => {
+        const { createConnection } = await importMysql();
+        return createConnection({
+            host: password.host,
+            user: password.username,
+            password: Redacted.value(password.password),
+            database: target.database,
+            multipleStatements: true,
+            ssl: { rejectUnauthorized: true },
+        });
+    },
+    catch: toMigrationError,
+}), use, (connection) => Effect.tryPromise({
+    try: () => connection.end(),
+    catch: toMigrationError,
+}).pipe(Effect.ignore)));
+const withTemporaryMySQLPassword = (target, use) => Effect.acquireUseRelease(Effect.gen(function* () {
+    const created = yield* ps.createPassword({
+        organization: target.organization,
+        database: target.database,
+        branch: target.branch,
+        role: "admin",
+        ttl: MIGRATION_PASSWORD_TTL_SECONDS,
+    });
+    return {
+        id: created.id,
+        host: created.access_host_url,
+        username: created.username,
+        password: created.plain_text,
+    };
+}), use, (password) => ps
+    .deletePassword({
+    organization: target.organization,
+    database: target.database,
+    branch: target.branch,
+    id: password.id,
+})
+    .pipe(
+// Already-deleted passwords are a success: nothing to clean up.
+Effect.catchTag("NotFound", () => Effect.void), Effect.retry({
+    schedule: Schedule.max([Schedule.exponential("500 millis"), Schedule.recurs(5)]),
+}), 
+// Migrations succeeded; don't fail the parent over a release-step
+// hiccup. The password's TTL bounds the orphan window; log loudly
+// so an operator can clean it up manually if needed.
+Effect.catch((cause) => Effect.logWarning(`Failed to delete temporary Planetscale migration password after retries. ` +
+    `It will expire via TTL (~${MIGRATION_PASSWORD_TTL_SECONDS}s). ` +
+    `organization=${target.organization} database=${target.database} ` +
+    `branch=${target.branch} id=${password.id}`, cause))));
+const mysqlQuery = (connection, sql) => Effect.tryPromise({
+    try: () => connection.query(sql).then(() => undefined),
+    catch: toMigrationError,
+});
+const toMigrationError = (cause) => new MySQLMigrationError({
+    message: cause instanceof Error ? cause.message : String(cause),
+    cause,
+});
+//# sourceMappingURL=MySQLMigrations.js.map

package/lib/MySQL/MySQLMigrations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MySQLMigrations.js","sourceRoot":"","sources":["../../src/MySQL/MySQLMigrations.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,0BAA0B,EAC1B,aAAa,GAGd,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC3E,OAAO,KAAK,EAAE,MAAM,8BAA8B,CAAC;AACnD,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AACpC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,QAAQ,MAAM,iBAAiB,CAAC;AAC5C,OAAO,KAAK,QAAQ,MAAM,iBAAiB,CAAC;AAG5C,MAAM,8BAA8B,GAAG,GAAG,CAAC;AAE3C,2EAA2E;AAC3E,wEAAwE;AACxE,MAAM,WAAW,GAAG,GAAG,EAAE,CACvB,MAAM,CAAC,gBAAgB,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACvC,MAAM,IAAI,KAAK,CACb,wHAAwH,EACxH,EAAE,KAAK,EAAE,CACV,CAAC;AACJ,CAAC,CAAC,CAAC;AAEL,MAAM,OAAO,mBAAoB,SAAQ,IAAI,CAAC,WAAW,CAAC,kCAAkC,CAG1F;CAAG;AAQL;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAChC,MAA4B,EAC5B,KAAgC,EAChC,OAA+B,EAC/B,EAAE,CACF,aAAa,CAAC;IACZ,KAAK;IACL,OAAO;IACP,YAAY,EAAE,CAAC,KAAK,EAAE,EAAE,CACtB,mBAAmB,CAAC,MAAM,EAAE,CAAC,UAAU,EAAE,EAAE,CAAC,KAAK,CAAC,0BAA0B,CAAC,UAAU,CAAC,CAAC,CAAC;CAC7F,CAAC,CAAC;AAEL,MAAM,CAAC,MAAM,eAAe,GAAG,CAC7B,MAA4B,EAC5B,WAAkC,EAClC,OAAe,EACf,QAAgC,EAChC,EAAE,CACF,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,MAAM,GAA2B,EAAE,GAAG,QAAQ,EAAE,CAAC;IACvD,KAAK,MAAM,QAAQ,IAAI,WAAW,EAAE,CAAC;QACnC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,WAAW,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QACnD,IAAI,QAAQ,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC,IAAI,EAAE,CAAC;YACrC,MAAM,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC;YAC7B,SAAS;QACX,CAAC;QACD,KAAK,CAAC,CAAC,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;QACrC,MAAM,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC;IAC/B,CAAC;IACD,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,CAAC;IACrC,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACtC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;IAC5C,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC,CAAC;AAEL,MAAM,WAAW,GAAG,CAAC,MAA4B,EAAE,GAAW,EAAE,EAAE,CAChE,mBAAmB,CAAC,MAAM,EAAE,CAAC,UAAU,EAAE,EAAE,CACzC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,KAAK,MAAM,SAAS,IAAI,kBAAkB,CAAC,GAAG,CAAC,EAAE,CAAC;QAChD,KAAK,CAAC,CAAC,UAAU,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;IAC3C,CAAC;AACH,CAAC,CAAC,CACH,CAAC;AAEJ,MAAM,mBAAmB,GAAG,CAC1B,MAA4B,EAC5B,GAAuD,EACvD,EAAE,CACF,0BAA0B,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,CAC9C,MAAM,CAAC,iBAAiB,CACtB,MAAM,CAAC,UAAU,CAAC;IAChB,GAAG,EAAE,KAAK,IAAI,EAAE;QACd,MAAM,EAAE,gBAAgB,EAAE,GAAG,MAAM,WAAW,EAAE,CAAC;QACjD,OAAO,gBAAgB,CAAC;YACtB,IAAI,EAAE,QAAQ,CAAC,IAAI;YACnB,IAAI,EAAE,QAAQ,CAAC,QAAQ;YACvB,QAAQ,EAAE,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC;YAC3C,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,kBAAkB,EAAE,IAAI;YACxB,GAAG,EAAE,EAAE,kBAAkB,EAAE,IAAI,EAAE;SAClC,CAAC,CAAC;IACL,CAAC;IACD,KAAK,EAAE,gBAAgB;CACxB,CAAC,EACF,GAAG,EACH,CAAC,UAAU,EAAE,EAAE,CACb,MAAM,CAAC,UAAU,CAAC;IAChB,GAAG,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE;IAC3B,KAAK,EAAE,gBAAgB;CACxB,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CACzB,CACF,CAAC;AAEJ,MAAM,0BAA0B,GAAG,CACjC,MAA4B,EAC5B,GAK4B,EAC5B,EAAE,CACF,MAAM,CAAC,iBAAiB,CACtB,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC,cAAc,CAAC;QACvC,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,IAAI,EAAE,OAAO;QACb,GAAG,EAAE,8BAA8B;KACpC,CAAC,CAAC;IAEH,OAAO;QACL,EAAE,EAAE,OAAO,CAAC,EAAE;QACd,IAAI,EAAE,OAAO,CAAC,eAAe;QAC7B,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,QAAQ,EAAE,OAAO,CAAC,UAAU;KAC7B,CAAC;AACJ,CAAC,CAAC,EACF,GAAG,EACH,CAAC,QAAQ,EAAE,EAAE,CACX,EAAE;KACC,cAAc,CAAC;IACd,YAAY,EAAE,MAAM,CAAC,YAAY;IACjC,QAAQ,EAAE,MAAM,CAAC,QAAQ;IACzB,MAAM,EAAE,MAAM,CAAC,MAAM;IACrB,EAAE,EAAE,QAAQ,CAAC,EAAE;CAChB,CAAC;KACD,IAAI;AACH,gEAAgE;AAChE,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,EAC9C,MAAM,CAAC,KAAK,CAAC;IACX,QAAQ,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,YAAY,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;CACjF,CAAC;AACF,kEAAkE;AAClE,kEAAkE;AAClE,qDAAqD;AACrD,MAAM,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE,CAC9B,MAAM,CAAC,UAAU,CACf,2EAA2E;IACzE,4BAA4B,8BAA8B,MAAM;IAChE,gBAAgB,MAAM,CAAC,YAAY,aAAa,MAAM,CAAC,QAAQ,GAAG;IAClE,UAAU,MAAM,CAAC,MAAM,OAAO,QAAQ,CAAC,EAAE,EAAE,EAC7C,KAAK,CACN,CACF,CACF,CACN,CAAC;AAEJ,MAAM,UAAU,GAAG,CAAC,UAAsB,EAAE,GAAW,EAAE,EAAE,CACzD,MAAM,CAAC,UAAU,CAAC;IAChB,GAAG,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC;IACtD,KAAK,EAAE,gBAAgB;CACxB,CAAC,CAAC;AAEL,MAAM,gBAAgB,GAAG,CAAC,KAAc,EAAE,EAAE,CAC1C,IAAI,mBAAmB,CAAC;IACtB,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;IAC/D,KAAK;CACN,CAAC,CAAC"}

package/lib/MySQL/MySQLOrigin.d.ts

@@ -0,0 +1,15 @@
+import * as Redacted from "effect/Redacted";
+/**
+ * The shape `Cloudflare.Hyperdrive` and other MySQL consumers accept as an
+ * origin. Materialized on `Planetscale.MySQLPassword` so callers can wire
+ * password credentials into Hyperdrive directly.
+ */
+export type MySQLOrigin = {
+    scheme: "mysql";
+    host: string;
+    port: number;
+    database: string;
+    user: string;
+    password: Redacted.Redacted<string>;
+};
+//# sourceMappingURL=MySQLOrigin.d.ts.map

package/lib/MySQL/MySQLOrigin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MySQLOrigin.d.ts","sourceRoot":"","sources":["../../src/MySQL/MySQLOrigin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,iBAAiB,CAAC;AAE5C;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,MAAM,EAAE,OAAO,CAAC;IAChB,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"}

package/lib/MySQL/MySQLOrigin.js

@@ -0,0 +1,2 @@
+import * as Redacted from "effect/Redacted";
+//# sourceMappingURL=MySQLOrigin.js.map

package/lib/MySQL/MySQLOrigin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MySQLOrigin.js","sourceRoot":"","sources":["../../src/MySQL/MySQLOrigin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,iBAAiB,CAAC"}

package/lib/MySQL/MySQLPassword.d.ts

@@ -0,0 +1,116 @@
+import * as planetscale from "@distilled.cloud/planetscale";
+import * as Provider from "alchemy/Provider";
+import { Resource } from "alchemy/Resource";
+import * as Redacted from "effect/Redacted";
+import type { Providers } from "../Providers.ts";
+import type { MySQLBranch } from "./MySQLBranch.ts";
+import type { MySQLDatabase } from "./MySQLDatabase.ts";
+import type { MySQLOrigin } from "./MySQLOrigin.ts";
+/**
+ * Properties for creating or updating a PlanetScale MySQL password.
+ *
+ * Passwords are only meant for MySQL databases. For PostgreSQL,
+ * use {@link PostgresRole} instead.
+ */
+export interface MySQLPasswordProps {
+    /**
+     * Password name. If omitted, a unique name is generated from
+     * `${app}-${stage}-${id}`.
+     */
+    name?: string;
+    /**
+     * MySQL database — string name or {@link MySQLDatabase} resource.
+     */
+    database: string | MySQLDatabase;
+    /**
+     * Branch — string name or {@link MySQLBranch} resource.
+     * @default "main"
+     */
+    branch?: string | MySQLBranch;
+    /**
+     * The MySQL role granted to the password.
+     */
+    role: "reader" | "writer" | "admin" | "readwriter";
+    /**
+     * Whether the password is for a read replica.
+     */
+    replica?: boolean;
+    /**
+     * Time to live (seconds). The password is invalidated after this period.
+     */
+    ttl?: number;
+    /**
+     * IP CIDR ranges allowed to use this password.
+     */
+    cidrs?: string[];
+}
+/**
+ * Output attributes of a deployed PlanetScale password.
+ */
+export interface MySQLPasswordAttributes {
+    /** Unique identifier for the password (stable). */
+    id: string;
+    /** Password name. If omitted, a unique name is generated from `${app}-${stage}-${id}`. */
+    name: string;
+    /** ISO 8601 timestamp at which the password expires. `null` if no TTL. */
+    expiresAt: string | null;
+    /** Hostname for the database connection. */
+    host: string;
+    /** Username for database authentication. */
+    username: string;
+    /** Password for database authentication (Redacted). */
+    password: Redacted.Redacted<string>;
+    /** Parsed connection components ready to feed into Cloudflare Hyperdrive. */
+    origin: MySQLOrigin;
+    /** Resolved organization slug. */
+    organization: string;
+    /** Resolved database name. */
+    database: string;
+    /** Resolved branch name. */
+    branch: string;
+    /** The role granted. */
+    role: "reader" | "writer" | "admin" | "readwriter" | (string & {});
+    /** Whether this password is for a read replica. */
+    replica: boolean | undefined;
+    /** TTL in seconds (if set). */
+    ttl: number | undefined;
+    /** IP CIDR ranges allowed to use this password. */
+    cidrs: readonly string[] | undefined;
+}
+/**
+ * A PlanetScale password for accessing a MySQL database branch.
+ *
+ * For PostgreSQL databases, use {@link PostgresRole} instead.
+ *
+ * ### Creating a Password
+ * **Example:** Reader password
+ * ```typescript
+ * const reader = yield* Planetscale.MySQLPassword("AppReader", {
+ *   database: "my-db",
+ *   role: "reader",
+ * });
+ * ```
+ *
+ * **Example:** Writer password with TTL
+ * ```typescript
+ * const writer = yield* Planetscale.MySQLPassword("AppWriter", {
+ *   database: "my-db",
+ *   role: "writer",
+ *   ttl: 86400,
+ * });
+ * ```
+ *
+ * **Example:** Admin password with IP allowlist
+ * ```typescript
+ * const admin = yield* Planetscale.MySQLPassword("Admin", {
+ *   database: "my-db",
+ *   role: "admin",
+ *   cidrs: ["203.0.113.0/24", "198.51.100.0/24"],
+ * });
+ * ```
+ */
+export type MySQLPassword = Resource<"Planetscale.MySQLPassword", MySQLPasswordProps, MySQLPasswordAttributes, never, Providers>;
+/** @resource */
+export declare const MySQLPassword: import("alchemy/Resource").ResourceClass<MySQLPassword>;
+export declare const MySQLPasswordProvider: () => import("effect/Layer").Layer<Provider.Provider<MySQLPassword>, never, import("alchemy/Stack").Stack | import("alchemy/Stage").Stage | planetscale.PlanetScaleOpContext>;
+//# sourceMappingURL=MySQLPassword.d.ts.map

package/lib/MySQL/MySQLPassword.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MySQLPassword.d.ts","sourceRoot":"","sources":["../../src/MySQL/MySQLPassword.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,WAAW,MAAM,8BAA8B,CAAC;AAI5D,OAAO,KAAK,QAAQ,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,OAAO,KAAK,QAAQ,MAAM,iBAAiB,CAAC;AAE5C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,QAAQ,EAAE,MAAM,GAAG,aAAa,CAAC;IAEjC;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;IAE9B;;OAEG;IACH,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,YAAY,CAAC;IAEnD;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,mDAAmD;IACnD,EAAE,EAAE,MAAM,CAAC;IACX,0FAA0F;IAC1F,IAAI,EAAE,MAAM,CAAC;IACb,0EAA0E;IAC1E,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,uDAAuD;IACvD,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACpC,6EAA6E;IAC7E,MAAM,EAAE,WAAW,CAAC;IACpB,kCAAkC;IAClC,YAAY,EAAE,MAAM,CAAC;IACrB,8BAA8B;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,4BAA4B;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,wBAAwB;IACxB,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,YAAY,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;IACnE,mDAAmD;IACnD,OAAO,EAAE,OAAO,GAAG,SAAS,CAAC;IAC7B,+BAA+B;IAC/B,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IACxB,mDAAmD;IACnD,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;CACtC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,MAAM,aAAa,GAAG,QAAQ,CAClC,2BAA2B,EAC3B,kBAAkB,EAClB,uBAAuB,EACvB,KAAK,EACL,SAAS,CACV,CAAC;AAEF,gBAAgB;AAChB,eAAO,MAAM,aAAa,yDAAuD,CAAC;AAElF,eAAO,MAAM,qBAAqB,+KAsN9B,CAAC"}