alchemy 2.0.0-beta.41 → 2.0.0-beta.43

package/lib/Planetscale/Branch.js

@@ -0,0 +1,287 @@
+import { Credentials } from "@distilled.cloud/planetscale/Credentials";
+import * as ops from "@distilled.cloud/planetscale/Operations";
+import * as Effect from "effect/Effect";
+import { Unowned } from "../AdoptPolicy.js";
+import { isResolved } from "../Diff.js";
+import { createPhysicalName } from "../PhysicalName.js";
+import * as Provider from "../Provider.js";
+import { hashImports, hashMigrations } from "../Sql/SqlFile.js";
+import { ensureMySQLProductionBranchClusterSize } from "./MySQL/MySQLClusterSize.js";
+import { ensurePostgresProductionBranchClusterSize, toPostgresClusterSku, } from "./Postgres/PostgresClusterSize.js";
+import { DEFAULT_MIGRATIONS_TABLE, PlanetscaleConflict, isKnownError, recordsEqual, waitForBranchReady, } from "./Util.js";
+const resolveDatabase = (database) => {
+    const ref = database;
+    if (!ref)
+        return { name: "" };
+    return typeof ref === "string"
+        ? { name: ref }
+        : { name: ref.name, organization: ref.organization };
+};
+const resolveParent = (parent) => {
+    const ref = parent;
+    return !ref ? "main" : typeof ref === "string" ? ref : ref.name;
+};
+const createBranchName = (id, name) => Effect.gen(function* () {
+    return (name ??
+        (yield* createPhysicalName({ id, lowercase: true, maxLength: 63 })));
+});
+/**
+ * Build a branch provider for a specific PlanetScale engine. The
+ * caller supplies the typed `Resource` token and the engine's migration
+ * runners; everything else (observe / ensure / sync / delete) is shared.
+ */
+export const makeBranchProvider = (opts) => Provider.effect(opts.resource, Effect.gen(function* () {
+    const rootDir = yield* Effect.sync(() => process.cwd());
+    const createBranch = yield* ops.createBranch;
+    const getBranch = yield* ops.getBranch;
+    const updateBranch = yield* ops.updateBranch;
+    const deleteBranch = yield* ops.deleteBranch;
+    const promoteBranch = yield* ops.promoteBranch;
+    const demoteBranch = yield* ops.demoteBranch;
+    const enableSafe = yield* ops.enableSafeMigrations;
+    const disableSafe = yield* ops.disableSafeMigrations;
+    const { runMigrations, runImports } = opts.runners;
+    return {
+        stables: ["organization", "database"],
+        diff: Effect.fn(function* ({ news, olds, output }) {
+            if (!isResolved(news))
+                return undefined;
+            const newDb = resolveDatabase(news.database).name;
+            const oldDbRef = output?.database ?? olds.database;
+            if (oldDbRef) {
+                const oldDb = resolveDatabase(oldDbRef).name;
+                if (newDb !== oldDb) {
+                    return { action: "replace" };
+                }
+            }
+            const newParent = resolveParent(news.parentBranch);
+            const oldParent = output?.parentBranch ?? resolveParent(olds.parentBranch);
+            if (newParent !== oldParent) {
+                return { action: "replace" };
+            }
+            if (news.region?.slug &&
+                output?.region?.slug &&
+                news.region.slug !== output.region.slug) {
+                return { action: "replace" };
+            }
+            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, olds, output }) {
+            // If we have neither a cached output nor a usable `olds.database`
+            // there's no way to identify which branch to refresh — most often
+            // this is destroy of a partially-created resource whose props
+            // never got fully persisted. Return `undefined` so the engine
+            // treats it as already-gone and drops the state entry.
+            if (!output && !olds?.database) {
+                return undefined;
+            }
+            const dbInfo = output
+                ? { name: output.database, organization: output.organization }
+                : resolveDatabase(olds.database);
+            const { organization: envOrg } = yield* Credentials;
+            const organization = output?.organization ?? dbInfo.organization ?? envOrg;
+            const databaseName = output?.database ?? dbInfo.name;
+            const branchName = output?.name ?? (yield* createBranchName(id, olds.name));
+            return yield* getBranch({
+                organization,
+                database: databaseName,
+                branch: branchName,
+            }).pipe(Effect.map((data) => {
+                const attrs = {
+                    name: data.name,
+                    organization,
+                    database: databaseName,
+                    parentBranch: data.parent_branch ?? "main",
+                    production: data.production,
+                    createdAt: data.created_at,
+                    updatedAt: data.updated_at,
+                    htmlUrl: data.html_url,
+                    region: { slug: data.region.slug },
+                    migrationsDir: output?.migrationsDir ?? olds?.migrationsDir,
+                    migrationsTable: output?.migrationsTable ?? olds?.migrationsTable,
+                    migrationsHashes: output?.migrationsHashes ?? {},
+                    importHashes: output?.importHashes ?? {},
+                };
+                return output ? attrs : Unowned(attrs);
+            }), Effect.catchTag("NotFound", () => Effect.succeed(undefined)));
+        }),
+        reconcile: Effect.fn(function* ({ id, news, output, session }) {
+            const { organization: envOrg } = yield* Credentials;
+            const dbInfo = resolveDatabase(news.database);
+            const organization = output?.organization ?? dbInfo.organization ?? envOrg;
+            const databaseName = output?.database ?? dbInfo.name;
+            const desiredBranchName = yield* createBranchName(id, news.name);
+            const observedBranchName = output?.name ?? desiredBranchName;
+            const parentBranchName = resolveParent(news.parentBranch);
+            // If parentBranch is a plain string (an unmanaged branch reference),
+            // wait for it to be ready before we touch the child branch. When it
+            // is a Branch resource, Alchemy's resource graph already guarantees
+            // readiness before this resource's inputs are resolved.
+            if (news.parentBranch && typeof news.parentBranch === "string") {
+                yield* waitForBranchReady(organization, databaseName, parentBranchName, session);
+            }
+            // Observe — fetch the live branch state.
+            let current = yield* getBranch({
+                organization,
+                database: databaseName,
+                branch: observedBranchName,
+            }).pipe(Effect.catchTag("NotFound", () => Effect.succeed(undefined)));
+            // Ensure — if missing, create. The parent must be ready before
+            // the child can fork from it. PostgreSQL short cluster sizes need
+            // to be expanded against the parent's region so the API call lands
+            // with a valid sku.
+            if (!current) {
+                const parent = yield* waitForBranchReady(organization, databaseName, parentBranchName, session);
+                const parentClusterSize = news.clusterSize
+                    ? parent.kind === "postgresql"
+                        ? toPostgresClusterSku({
+                            size: news.clusterSize,
+                            region: parent.region.slug,
+                        })
+                        : news.clusterSize
+                    : undefined;
+                yield* session.note("Creating branch...");
+                current = yield* createBranch({
+                    organization,
+                    database: databaseName,
+                    name: desiredBranchName,
+                    parent_branch: parentBranchName,
+                    backup_id: news.backupId,
+                    seed_data: news.seedData,
+                    region: news.region?.slug,
+                    cluster_size: parentClusterSize,
+                });
+            }
+            if (current.kind !== opts.expectedKind) {
+                return yield* Effect.fail(new PlanetscaleConflict({
+                    message: `Planetscale branch "${current.name}" (database "${databaseName}") has kind ` +
+                        `"${current.kind}" but this resource is a ${opts.engineLabel}. ` +
+                        `Use the matching ${current.kind === "mysql" ? "MySQLBranch" : "PostgresBranch"} ` +
+                        `resource instead.`,
+                }));
+            }
+            yield* waitForBranchReady(organization, databaseName, current.name, session);
+            // Sync name — branch names are mutable. Continue subsequent syncs
+            // under the name returned by the API.
+            if (current.name !== desiredBranchName) {
+                current = yield* updateBranch({
+                    organization,
+                    database: databaseName,
+                    branch: current.name,
+                    new_name: desiredBranchName,
+                });
+            }
+            const branchName = current.name;
+            // Sync production status before branch settings that depend on it.
+            // PlanetScale only supports explicit branch promotion/demotion for MySQL.
+            if (opts.expectedKind === "mysql") {
+                const desiredProduction = news.isProduction ?? false;
+                if (current.production !== desiredProduction) {
+                    current = desiredProduction
+                        ? yield* promoteBranch({
+                            organization,
+                            database: databaseName,
+                            branch: branchName,
+                        })
+                        : yield* demoteBranch({
+                            organization,
+                            database: databaseName,
+                            branch: branchName,
+                        });
+                }
+            }
+            // Sync safeMigrations — observed via `current.safe_migrations`,
+            // skip the API call entirely on no-op.
+            if (news.safeMigrations !== undefined &&
+                current.safe_migrations !== news.safeMigrations) {
+                if (news.safeMigrations) {
+                    yield* enableSafe({
+                        organization,
+                        database: databaseName,
+                        branch: branchName,
+                    });
+                }
+                else {
+                    yield* disableSafe({
+                        organization,
+                        database: databaseName,
+                        branch: branchName,
+                    });
+                }
+            }
+            // Sync clusterSize — only meaningful on production branches.
+            if (news.clusterSize) {
+                if (current.kind === "postgresql") {
+                    yield* ensurePostgresProductionBranchClusterSize(organization, databaseName, branchName, news.clusterSize);
+                }
+                else {
+                    yield* ensureMySQLProductionBranchClusterSize(organization, databaseName, branchName, news.clusterSize);
+                }
+            }
+            // Re-read so the returned attributes reflect any mutation.
+            const updated = yield* getBranch({
+                organization,
+                database: databaseName,
+                branch: branchName,
+            });
+            const migrationTarget = {
+                organization,
+                database: databaseName,
+                branch: updated.name,
+            };
+            const migrationsTable = news.migrationsTable ??
+                output?.migrationsTable ??
+                DEFAULT_MIGRATIONS_TABLE;
+            const migrationsHashes = news.migrationsDir
+                ? yield* runMigrations(migrationTarget, news.migrationsDir, migrationsTable)
+                : (output?.migrationsHashes ?? {});
+            const importHashes = news.importFiles?.length
+                ? yield* runImports(migrationTarget, news.importFiles, rootDir, output?.importHashes ?? {})
+                : {};
+            return {
+                name: updated.name,
+                organization,
+                database: databaseName,
+                parentBranch: updated.parent_branch ?? parentBranchName,
+                production: updated.production,
+                createdAt: updated.created_at,
+                updatedAt: updated.updated_at,
+                htmlUrl: updated.html_url,
+                region: { slug: updated.region.slug },
+                migrationsDir: news.migrationsDir,
+                migrationsTable: news.migrationsDir ? migrationsTable : undefined,
+                migrationsHashes,
+                importHashes,
+            };
+        }),
+        delete: Effect.fn(function* ({ output }) {
+            // If `read` returned undefined (e.g. destroy of a partially-
+            // created branch whose props never finished persisting), there
+            // is nothing addressable to delete. Drop the state entry.
+            if (!output)
+                return;
+            yield* deleteBranch({
+                organization: output.organization,
+                database: output.database,
+                branch: output.name,
+            }).pipe(Effect.catchTag("NotFound", () => Effect.void), Effect.catchIf(isKnownError("UnprocessableEntity", "The default branch cannot be deleted."), () => Effect.void));
+        }),
+    };
+}));
+//# sourceMappingURL=Branch.js.map

package/lib/Planetscale/Branch.js.map

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

package/lib/Planetscale/Credentials.d.ts

@@ -0,0 +1,35 @@
+import { Credentials } from "@distilled.cloud/planetscale/Credentials";
+import { ConfigError } from "@distilled.cloud/core/errors";
+import * as Config from "effect/Config";
+import * as Layer from "effect/Layer";
+import * as Redacted from "effect/Redacted";
+import { Profile } from "../Auth/Profile.ts";
+export { Credentials, CredentialsFromEnv, DEFAULT_API_BASE_URL, } from "@distilled.cloud/planetscale/Credentials";
+/**
+ * Build a PlanetScale `Credentials` Layer from an explicit token. Useful for
+ * tests or when the caller already has credentials in hand.
+ *
+ * @example
+ * ```ts
+ * Effect.provide(
+ *   Planetscale.fromToken({
+ *     tokenId: "abcd1234",
+ *     token: "api-token-secret",
+ *     organization: "my-org",
+ *   }),
+ * )
+ * ```
+ */
+export declare const fromToken: (input: {
+    tokenId: string | Redacted.Redacted<string>;
+    token: string | Redacted.Redacted<string>;
+    organization: string;
+    apiBaseUrl?: string;
+}) => Layer.Layer<Credentials, never, never>;
+/**
+ * Build a PlanetScale `Credentials` Layer that resolves credentials via the
+ * Alchemy AuthProvider using the configured profile (defaults to "default",
+ * overridable with the `ALCHEMY_PROFILE` env/config value).
+ */
+export declare const fromAuthProvider: () => Layer.Layer<Credentials, Config.ConfigError | import("../Auth/AuthProvider.ts").AuthError | ConfigError, Profile | import("../index.ts").AuthProviders>;
+//# sourceMappingURL=Credentials.d.ts.map

package/lib/Planetscale/Credentials.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Credentials.d.ts","sourceRoot":"","sources":["../../src/Planetscale/Credentials.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EAEZ,MAAM,0CAA0C,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC3D,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,KAAK,QAAQ,MAAM,iBAAiB,CAAC;AAE5C,OAAO,EAAmB,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAO9D,OAAO,EACL,WAAW,EACX,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,0CAA0C,CAAC;AAElD;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,SAAS,GAAI,OAAO;IAC/B,OAAO,EAAE,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC5C,KAAK,EAAE,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC1C,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,2CAYG,CAAC;AAEL;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,+JAiC1B,CAAC"}

package/lib/Planetscale/Credentials.js

@@ -0,0 +1,56 @@
+import { Credentials, DEFAULT_API_BASE_URL, } from "@distilled.cloud/planetscale/Credentials";
+import { ConfigError } from "@distilled.cloud/core/errors";
+import * as Config from "effect/Config";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Redacted from "effect/Redacted";
+import { getAuthProvider } from "../Auth/AuthProvider.js";
+import { ALCHEMY_PROFILE, Profile } from "../Auth/Profile.js";
+import { PLANETSCALE_AUTH_PROVIDER_NAME, } from "./AuthProvider.js";
+export { Credentials, CredentialsFromEnv, DEFAULT_API_BASE_URL, } from "@distilled.cloud/planetscale/Credentials";
+/**
+ * Build a PlanetScale `Credentials` Layer from an explicit token. Useful for
+ * tests or when the caller already has credentials in hand.
+ *
+ * @example
+ * ```ts
+ * Effect.provide(
+ *   Planetscale.fromToken({
+ *     tokenId: "abcd1234",
+ *     token: "api-token-secret",
+ *     organization: "my-org",
+ *   }),
+ * )
+ * ```
+ */
+export const fromToken = (input) => Layer.succeed(Credentials, {
+    tokenId: typeof input.token === "string"
+        ? Redacted.make(input.token)
+        : input.token,
+    token: typeof input.token === "string"
+        ? Redacted.make(input.token)
+        : input.token,
+    organization: input.organization,
+    apiBaseUrl: input.apiBaseUrl ?? DEFAULT_API_BASE_URL,
+});
+/**
+ * Build a PlanetScale `Credentials` Layer that resolves credentials via the
+ * Alchemy AuthProvider using the configured profile (defaults to "default",
+ * overridable with the `ALCHEMY_PROFILE` env/config value).
+ */
+export const fromAuthProvider = () => Layer.effect(Credentials, Effect.gen(function* () {
+    const profile = yield* Profile;
+    const auth = yield* getAuthProvider(PLANETSCALE_AUTH_PROVIDER_NAME);
+    const profileName = yield* ALCHEMY_PROFILE;
+    const ci = yield* Config.boolean("CI").pipe(Config.withDefault(false));
+    const apiBaseUrl = yield* Config.string("PLANETSCALE_API_BASE_URL").pipe(Config.withDefault(DEFAULT_API_BASE_URL));
+    return yield* profile.loadOrConfigure(auth, profileName, { ci }).pipe(Effect.flatMap((config) => auth.read(profileName, config)), Effect.map((creds) => ({
+        tokenId: creds.tokenId,
+        token: creds.token,
+        organization: creds.organization,
+        apiBaseUrl,
+    })), Effect.mapError((e) => new ConfigError({
+        message: `Failed to resolve Planetscale credentials for profile '${profileName}': ${e.message ?? String(e)}`,
+    })));
+}));
+//# sourceMappingURL=Credentials.js.map

package/lib/Planetscale/Credentials.js.map

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

package/lib/Planetscale/Database.d.ts

@@ -0,0 +1,117 @@
+/**
+ * Region selector for a PlanetScale Database.
+ */
+export interface DatabaseRegion {
+    /**
+     * Region slug (e.g. `"us-east"`, `"eu-west"`, `"gcp-us-central1"`).
+     * @see https://planetscale.com/docs/concepts/regions#available-regions
+     */
+    slug: "us-east" | "eu-west" | "gcp-us-central1" | (string & {});
+}
+/**
+ * Properties shared between {@link MySQLDatabase} and
+ * {@link PostgresDatabase}. Engine-specific props live on the per-engine
+ * resource types.
+ */
+export interface BaseDatabaseProps {
+    /**
+     * Database name. Must be lowercase. If omitted, a unique name will be
+     * generated from the stack/stage/logical-id.
+     */
+    name?: string;
+    /**
+     * Region where the database will be created. Cannot be changed after
+     * creation. If omitted, the organization's default region is used.
+     */
+    region?: DatabaseRegion;
+    /**
+     * Number of replicas for the database. `0` for non-HA, `2+` for HA.
+     * Create-only.
+     */
+    replicas?: number;
+    /**
+     * Whether deploy requests must be approved by a database administrator
+     * other than the request creator.
+     */
+    requireApprovalForDeploy?: boolean;
+    /**
+     * Whether to limit branch creation to the same region as the one
+     * selected during database creation.
+     */
+    restrictBranchRegion?: boolean;
+    /**
+     * Whether the web console can be used on the production branch.
+     */
+    productionBranchWebConsole?: boolean;
+    /**
+     * The default branch of the database.
+     * @default "main"
+     */
+    defaultBranch?: string;
+    /**
+     * Directory containing `.sql` migration files. Files are sorted by numeric
+     * prefix (for example `0001_init.sql`) and applied in order against the
+     * default branch.
+     */
+    migrationsDir?: string;
+    /**
+     * Name of the table used to track applied migrations.
+     * @default "planetscale_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 later deploys.
+     */
+    importFiles?: string[];
+}
+/**
+ * Output attributes shared by both database engines.
+ */
+export interface BaseDatabaseAttributes {
+    /** The unique identifier of the database. */
+    id: string;
+    /** The name of the database. */
+    name: string;
+    /** The PlanetScale organization slug that owns the database. */
+    organization: string;
+    /** The current state of the database. */
+    state: string;
+    /** The default branch name. */
+    defaultBranch: string;
+    /** The plan tier (e.g. `"hobby"`, `"scaler"`). */
+    plan: string;
+    /** Time at which the database was created (ISO 8601). */
+    createdAt: string;
+    /** Time at which the database was last updated (ISO 8601). */
+    updatedAt: string;
+    /** HTML URL for accessing the database in the dashboard. */
+    htmlUrl: string;
+    /** The region of the database as reported by PlanetScale. */
+    region: DatabaseRegion;
+    /** The cluster size that was actually applied. */
+    clusterSize: string;
+    /** Directory containing migration files, if configured. */
+    migrationsDir: string | undefined;
+    /** Table used to track applied migrations, if configured. */
+    migrationsTable: string | undefined;
+    /** Content hashes for the last applied migration files. */
+    migrationsHashes: Record<string, string>;
+    /** Content hashes for the last applied import files. */
+    importHashes: Record<string, string>;
+    /**
+     * Whether deploy requests must be approved by a database administrator
+     * other than the request creator.
+     */
+    requireApprovalForDeploy: boolean;
+    /**
+     * Whether to limit branch creation to the same region as the one
+     * selected during database creation.
+     */
+    restrictBranchRegion: boolean;
+    /**
+     * Whether the web console can be used on the production branch.
+     */
+    productionBranchWebConsole: boolean;
+}
+//# sourceMappingURL=Database.d.ts.map

package/lib/Planetscale/Database.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Database.d.ts","sourceRoot":"","sources":["../../src/Planetscale/Database.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,IAAI,EAAE,SAAS,GAAG,SAAS,GAAG,iBAAiB,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;CACjE;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,MAAM,CAAC,EAAE,cAAc,CAAC;IAExB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,wBAAwB,CAAC,EAAE,OAAO,CAAC;IAEnC;;;OAGG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAE/B;;OAEG;IACH,0BAA0B,CAAC,EAAE,OAAO,CAAC;IAErC;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,6CAA6C;IAC7C,EAAE,EAAE,MAAM,CAAC;IACX,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,gEAAgE;IAChE,YAAY,EAAE,MAAM,CAAC;IACrB,yCAAyC;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,+BAA+B;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,yDAAyD;IACzD,SAAS,EAAE,MAAM,CAAC;IAClB,8DAA8D;IAC9D,SAAS,EAAE,MAAM,CAAC;IAClB,4DAA4D;IAC5D,OAAO,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,MAAM,EAAE,cAAc,CAAC;IACvB,kDAAkD;IAClD,WAAW,EAAE,MAAM,CAAC;IACpB,2DAA2D;IAC3D,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,6DAA6D;IAC7D,eAAe,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,2DAA2D;IAC3D,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,wDAAwD;IACxD,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC;;;OAGG;IACH,wBAAwB,EAAE,OAAO,CAAC;IAElC;;;OAGG;IACH,oBAAoB,EAAE,OAAO,CAAC;IAE9B;;OAEG;IACH,0BAA0B,EAAE,OAAO,CAAC;CACrC"}

package/lib/Planetscale/Database.js

@@ -0,0 +1 @@
+//# sourceMappingURL=Database.js.map

package/lib/Planetscale/Database.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Database.js","sourceRoot":"","sources":["../../src/Planetscale/Database.ts"],"names":[],"mappings":""}

package/lib/Planetscale/MySQL/MySQLBranch.d.ts

@@ -0,0 +1,86 @@
+import { Resource } from "../../Resource.ts";
+import { type BaseBranchAttributes, type BaseBranchProps } from "../Branch.ts";
+import type { Providers } from "../Providers.ts";
+import type { MySQLClusterSize } from "./MySQLClusterSize.ts";
+import type { MySQLDatabase } from "./MySQLDatabase.ts";
+/**
+ * Properties for creating or updating a {@link MySQLBranch}.
+ */
+export interface MySQLBranchProps extends BaseBranchProps {
+    /**
+     * Whether the branch should be a production branch.
+     */
+    isProduction: boolean;
+    /**
+     * The MySQL database. Either a string database name or a
+     * {@link MySQLDatabase} resource.
+     */
+    database: string | MySQLDatabase;
+    /**
+     * MySQL cluster size for the branch. Required if `backupId` is provided.
+     * For non-production branches must be `"PS_DEV"`.
+     */
+    clusterSize?: MySQLClusterSize;
+    /**
+     * Parent branch — either a string name or another {@link MySQLBranch}.
+     * @default "main"
+     */
+    parentBranch?: string | MySQLBranch;
+}
+/**
+ * Output attributes of a deployed {@link MySQLBranch}.
+ */
+export interface MySQLBranchAttributes extends BaseBranchAttributes {
+}
+/**
+ * A PlanetScale branch of a {@link MySQLDatabase}. For PostgreSQL branches
+ * use {@link PostgresBranch} instead.
+ *
+ * @section Creating a Branch
+ * @example Branch from main
+ * ```typescript
+ * const branch = yield* Planetscale.MySQLBranch("Feature123", {
+ *   database: "my-db",
+ *   parentBranch: "main",
+ *   isProduction: false,
+ * });
+ * ```
+ *
+ * @example Branch from a MySQLDatabase resource
+ * ```typescript
+ * const db = yield* Planetscale.MySQLDatabase("MyDb", { clusterSize: "PS_10" });
+ * const branch = yield* Planetscale.MySQLBranch("Feature456", {
+ *   database: db,
+ *   parentBranch: "main",
+ *   isProduction: false,
+ * });
+ * ```
+ *
+ * @section Restoring from Backup
+ * @example Branch restored from a backup
+ * ```typescript
+ * const branch = yield* Planetscale.MySQLBranch("Restored", {
+ *   database: "my-db",
+ *   parentBranch: "main",
+ *   isProduction: true,
+ *   backupId: "backup-123",
+ *   clusterSize: "PS_10",
+ * });
+ * ```
+ *
+ * @section Migrations and seed data
+ * @example Apply migrations on a branch
+ * ```typescript
+ * const branch = yield* Planetscale.MySQLBranch("Feature123", {
+ *   database: db,
+ *   parentBranch: "main",
+ *   isProduction: false,
+ *   migrationsDir: "./migrations",
+ *   importFiles: ["./seed.sql"],
+ * });
+ * ```
+ */
+export type MySQLBranch = Resource<"Planetscale.MySQLBranch", MySQLBranchProps, MySQLBranchAttributes, never, Providers>;
+export declare const MySQLBranch: import("../../Resource.ts").ResourceClass<MySQLBranch>;
+export declare const MySQLBranchProvider: () => import("effect/Layer").Layer<import("../../Provider.ts").Provider<MySQLBranch>, never, import("@distilled.cloud/planetscale/Credentials").Credentials>;
+//# sourceMappingURL=MySQLBranch.d.ts.map

package/lib/Planetscale/MySQL/MySQLBranch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MySQLBranch.d.ts","sourceRoot":"","sources":["../../../src/Planetscale/MySQL/MySQLBranch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,eAAe,EAErB,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD;;GAEG;AACH,MAAM,WAAW,gBAAiB,SAAQ,eAAe;IACvD;;OAEG;IACH,YAAY,EAAE,OAAO,CAAC;IAEtB;;;OAGG;IACH,QAAQ,EAAE,MAAM,GAAG,aAAa,CAAC;IAEjC;;;OAGG;IACH,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAE/B;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,qBAAsB,SAAQ,oBAAoB;CAAG;AAEtE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AACH,MAAM,MAAM,WAAW,GAAG,QAAQ,CAChC,yBAAyB,EACzB,gBAAgB,EAChB,qBAAqB,EACrB,KAAK,EACL,SAAS,CACV,CAAC;AAEF,eAAO,MAAM,WAAW,wDAAmD,CAAC;AAE5E,eAAO,MAAM,mBAAmB,8JAS5B,CAAC"}

package/lib/Planetscale/MySQL/MySQLBranch.js

@@ -0,0 +1,14 @@
+import { Resource } from "../../Resource.js";
+import { makeBranchProvider, } from "../Branch.js";
+import { runMySQLImports, runMySQLMigrations } from "./MySQLMigrations.js";
+export const MySQLBranch = Resource("Planetscale.MySQLBranch");
+export const MySQLBranchProvider = () => makeBranchProvider({
+    resource: MySQLBranch,
+    expectedKind: "mysql",
+    engineLabel: "MySQLBranch",
+    runners: {
+        runMigrations: runMySQLMigrations,
+        runImports: runMySQLImports,
+    },
+});
+//# sourceMappingURL=MySQLBranch.js.map

package/lib/Planetscale/MySQL/MySQLBranch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MySQLBranch.js","sourceRoot":"","sources":["../../../src/Planetscale/MySQL/MySQLBranch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAGL,kBAAkB,GACnB,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AA4F3E,MAAM,CAAC,MAAM,WAAW,GAAG,QAAQ,CAAc,yBAAyB,CAAC,CAAC;AAE5E,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAG,EAAE,CACtC,kBAAkB,CAAC;IACjB,QAAQ,EAAE,WAAW;IACrB,YAAY,EAAE,OAAO;IACrB,WAAW,EAAE,aAAa;IAC1B,OAAO,EAAE;QACP,aAAa,EAAE,kBAAkB;QACjC,UAAU,EAAE,eAAe;KAC5B;CACF,CAAC,CAAC"}